# PERLER LAB 拼豆图纸生成器 · 产品版本路线图(ROADMAP) | 项目 | 内容 | |---|---| | 文档版本 | v1.0 | | 编写日期 | 2026-08-13 | | 编写角色 | PM-Agent | | 关联文档 | PRD.md(功能与优先级唯一事实来源)、LAUNCH.md(运营/SEO 基线) | | 当前状态 | V1.0 前后端已完成开发、联调中;Docker/CI 就绪;QA 验收通过 18+ 任务 | --- ## 0. 版本总览 | 版本 | 时间 | 主题 | 核心交付 | |---|---|---|---| | **V1.0 上线版** | 当前(2026-08) | 跑通 MVP 商业闭环 | PRD P0 全量上线:生成 + 权益 + 模拟支付 + AI 专区 | | **V1.1 增长版** | 1 个月内 | 流量与留存 | /palette SEO 页、历史记录、批量生成、导出优化、埋点看板、P1 补全 | | **V1.2 账号版** | 2~3 个月 | 用户资产与生态 | 账号体系 + 云端同步、素材社区、代理管理系统 | | **V2.0 平台版** | 半年 | 商业平台化 | 图纸交易市场、PWA 移动端、多语言、真实支付 | 优先级定义沿用 PRD:**P0** = 本版本必须上线;**P1** = 本版本内争取;**P2** = 观察数据后进入后续版本。 --- ## 1. V1.0 上线版(当前) ### 1.1 目标 把 PRD 第 9 章定义的 MVP(P0)完整落地上线,验证三件事:图纸质量够不够好、付费意愿存不存在、AI 功能有没有吸引力。上线即可开始积累真实转化数据,为 V1.1 决策提供依据。 ### 1.2 范围确认清单(对齐 PRD 9.1) **已就绪(开发 + QA 已验收,18+ 任务通过)** | 模块 | 验收项 | 状态 | |---|---|---| | 图纸生成 | 图片上传(JPG/PNG/WebP,≤10MB,拖拽 + 点击) | ✅ | | | 参数设置(格数 48/64/80/96、色数 16/24/32/40、去背景、背景色) | ✅ | | | 核心算法(4× 采样 → 众数量化 → k-means++ → MARD 色板 LAB 匹配) | ✅ | | | 图纸预览(豆圆 + 色号 + 每 5 格加粗 + 每 10 格标号 + 缩放) | ✅ | | | 备料清单(总颗数、色数、分色用量、多备 10%) | ✅ | | 下载解锁 | 未解锁拦截进入兑换弹窗;解锁后输出 PNG(图纸 + 备料单) | ✅ | | | 预览免费、仅下载消耗权益;同一图纸凭 downloadGrant 重复下载不扣费 | ✅ | | 权益体系 | 兑换码兑换 `/api/codes/redeem`、下载扣减 `/api/codes/consume`、AI 扣减 `/api/chibi/generate` | ✅ | | | 权益存 localStorage(键 `perler-download-code`)、顶部常驻剩余次数 | ✅ | | 订单支付 | 三档个人套餐下单 `/api/orders`、模拟支付回调、支付成功自动 redeem | ✅ | | | 支付回调幂等、耗尽返回 402、无效码返回 404 | ✅ | | AI 拼豆 | 5 大类 × 3 细分、格数/色数参数、生成即扣 1 次权益 | ✅ | | 页面 | 首页、/chibi 页、兑换弹窗、订单弹窗、订单结果弹窗 | ✅ | | 工程 | Docker 化部署、CI 就绪、CORS 白名单、`tsc --noEmit` 通过、单测 36/36 | ✅ | **剩余阻塞项(上线前必须清空)** | # | 阻塞项 | 说明 | 责任方 | |---|---|---|---| | 1 | AI 生成接入真实模型 | E2E 报告显示 `/api/chibi/generate` 当前返回 mock 占位 PNG(长度 262);需接入真实图片生成模型代理,并保留失败不扣费逻辑 | 后端 | | 2 | 前端联调收尾 | 前端真实场景全链路走查:上传 → 生成 → 预览 → 兑换 → 下载;含移动端基本可用 | 前端 | | 3 | 上线部署验证 | Docker Compose 全量冷启动、健康检查、自动重启、数据库备份、监控告警生效 | 后端/运维 | | 4 | 埋点 P0 事件确认 | PRD 8.3 中 P0 事件(上传/生成/预览/下载/兑换/订单/AI 选择与生成)真实上报可用 | 前端 | | 5 | 用户协议与版权声明 | PRD 风险 #5:用户协议声明上传图片责任归属、图纸仅供个人手作参考 | PM/法务 | | 6 | 生成接口并发压测 | 桌面端 P50 ≤ 5s、移动端 ≤ 8s;确认压测下接口稳定性与超时兜底 | 后端 | | 7 | 首屏性能确认 | LCP < 2.5s(算法库代码分割 + 静态资源强缓存) | 前端 | ### 1.3 上线标准 Checklist **验收** - [ ] 两条核心链路全通:图片生成链路(上传 → 参数 → 预览免费 → 兑换解锁 → 高清下载)与 AI 链路(选类 → 描述 → 生成扣 1 次 → 预览 → 解锁下载) - [ ] QA 回归 18+ 任务全绿,无 P0/P1 级缺陷残留 - [ ] 错误路径全通:无效兑换码 404、次数耗尽 402、支付回调幂等、重复下载不重复扣费 - [ ] 单测与类型检查通过(`tsc --noEmit`、单测 36/36) **性能** - [ ] 图纸生成耗时 P50 ≤ 5s(桌面端)、≤ 8s(移动端) - [ ] 首页首屏 LCP < 2.5s - [ ] 高清下载成功率 ≥ 99% - [ ] 压测结论记录:并发下单/兑换/生成无 DB 锁死、无 5xx 雪崩 **安全** - [ ] 全站 HTTPS,CORS 白名单(非 `*`)且带 `Vary: Origin` - [ ] 兑换码不可枚举:输入校验 + 服务端核销日志 + 高频 redeem 风控阈值 - [ ] 输入注入防护(图片格式/大小校验、API 参数白名单) - [ ] 密钥与数据库不落仓库,Docker 环境变量注入 ### 1.4 成功指标(对齐 PRD 8.2,首月基线) | 类别 | 指标 | 目标值 | |---|---|---| | 北极星 | 周有效解锁次数 | 每周 ≥ 30 次(首月爬坡) | | 转化 | 访问 → 生成转化率 | ≥ 40% | | 转化 | 生成 → 兑换解锁转化率 | ≥ 3% | | 转化 | 兑换 → 再次消费转化率 | ≥ 20% | | 下载 | 高清下载成功率 | ≥ 99% | | AI | chibi 生成占权益消耗比 | ≥ 30% | | 质量 | 图纸平均色差 | ≤ 2.0(ΔE,LAB) | | 体验 | 兑换全流程成功率(模拟支付 → redeem → 扣减 → 下载) | ≥ 95% | | 稳定性 | 全链路无致命错误率 | 100% | ### 1.5 依赖项 无外部依赖。V1.0 全部建立在现有前后端 + Docker/CI 之上,仅剩第 1.2 节阻塞项收尾。 --- ## 2. V1.1 增长版(1 个月内) ### 2.1 目标 用 SEO 长尾页和留存功能放大 V1.0 验证过的核心链路,把埋点数据变成可看的运营看板。不做账号,所有新功能保持本地优先。 ### 2.2 核心功能列表 | # | 功能 | 说明 | 优先级 | |---|---|---|---| | 1 | 色号对照页 /palette | 纯内容页:MARD 8 系色板全景、每色 HEX/色名/近似实拍、色号换算说明。吃「拼豆色号表」长尾搜索词(LAUNCH 2.1),挂 JSON-LD `WebPage` schema | P0 | | 2 | 埋点看板上线 | 埋点事件(PRD 8.3 全部)上报可用;搭建看板:转化漏斗(访问 → 上传 → 生成 → 兑换 → 下载)、渠道来源、套餐分布、AI 分类分布;T+1 数据可用 | P0 | | 3 | 历史记录(本地版) | 生成/下载记录存 localStorage(含参数、缩略图、downloadGrant),支持重新下载与复用参数。无需登录,与 V1.2 账号同步无缝衔接 | P0 | | 4 | 批量生成 | 一次上传多图或一个图片文件夹,批量出图并打包下载 ZIP;含批量失败重试与单张进度展示 | P1 | | 5 | 图纸导出优化 | 导出选项:纸张尺寸(A4/A3 等)、网格开关、色号标注开关、纯备料单、无水印版本;ZIP 批量导出 | P1 | | 6 | P1 功能补全 | 订单查询(`GET /api/orders?orderNo=` 在订单弹窗内展示支付状态轮询)、AI 风格预览对比图、兑换码高频风控规则落地 | P1 | | 7 | 兑换引导优化 | 根据看板数据优化兑换弹窗:首单体验包钩子位置、未解锁用户回访提醒 | P2 | ### 2.3 成功指标 | 指标 | 目标值(V1.1 内) | |---|---| | /palette 页自然搜索月 UV | ≥ 2000,占全站自然流量 ≥ 20% | | /palette 页 → 首页跳转率 | ≥ 15%(验证 SEO 长尾导流) | | 埋点事件上报成功率 | ≥ 99%,看板 T+1 可用率 ≥ 95% | | 历史记录使用率 | 回访用户中点击历史记录 ≥ 30% | | 次日回访率 | 较 V1.0 提升 ≥ 5pp(历史记录 + 看板驱动的留存优化) | | 批量生成成功率 | ≥ 98%,单张平均耗时 ≤ 5s | | 导出优化后下载成功率 | ≥ 99.5%(导出选项不引入新失败) | ### 2.4 依赖项 - V1.0 上线并积累至少 2 周真实数据(埋点看板据此校准漏斗基线) - /palette 依赖已内置的 MARD 色板数据源(前端算法已有),需补充色名/HEX/实拍素材 - 批量生成依赖后端新增 ZIP 打包接口或前端纯前端打包(jszip 类方案) - 埋点看板需确认存储方案(自建轻量统计表 vs 第三方,倾向自建,复用现有 SQLite/Postgres) --- ## 3. V1.2 账号版(2~3 个月) ### 3.1 目标 把本地权益升级为云端资产,把一次性用户沉淀为可识别用户;开启素材社区和代理两条生态线。核心解决 PRD 风险 #3(换设备丢权益客诉)与 P2 代理需求。 ### 3.2 核心功能列表 | # | 功能 | 说明 | 优先级 | |---|---|---|---| | 1 | 账号体系 | 手机号验证码登录(短信服务);Token 会话;登录后权益自动合并(云端为准) | P0 | | 2 | 云端同步 | 权益、历史记录、收藏同步到服务端;换设备登录即恢复;跨设备权益使用实时扣减 | P0 | | 3 | 素材社区 | 用户上传自用图纸公开分享:图纸页 + 作者页 + 分类/搜索 + 收藏;社区页挂 SEO 关键词「拼豆模板」(LAUNCH 2.1 高难度词) | P0 | | 4 | 代理管理系统 | 代理自助充值(代理三档套餐 ¥139/¥299/¥499)、订单查询、名下兑换码库存与核销记录、批量生成兑换码/口令(PRD P2 补全) | P0 | | 5 | 内容安全 | 社区上传图片审核(敏感内容过滤 + 人工抽检)、用户举报与下架 | P1 | | 6 | 移动端体验强化 | 基于 V1.1 埋点数据优化移动端布局、上传压缩、弱网兜底 | P1 | ### 3.3 成功指标 | 指标 | 目标值(V1.2 内) | |---|---| | 手机号登录转化率 | 老用户(兑换过权益)≥ 30%,新用户 ≥ 8% | | 云端同步成功率 | ≥ 99.5%;「换设备丢权益」类客诉降为 0 | | 跨设备权益恢复满意度 | 同步后权益无损率 100%(以服务端账本为准) | | 社区内容量 | 月新增分享图纸 ≥ 500 张,活跃分享用户 ≥ 100 人 | | 社区引流 | 社区带来的自然访问占全站 ≥ 15%(吃「拼豆模板」搜索词) | | 代理自助转化 | 代理下单自助完成率 ≥ 80%;代理渠道营收占总营收 ≥ 30% | | 代理管理 | 兑换码库存查询/批量生成的代理使用率 ≥ 70% | ### 3.4 依赖项 - 账号体系依赖短信服务商接入与实名合规;Token 安全设计(刷新 + 风控) - 云端同步依赖数据库迁移(用户表、同步账本表、历史记录表)与既有 localStorage 数据升级路径 - 素材社区依赖对象存储/CDN、图片缩略图处理、内容审核通道 - 代理管理依赖订单系统扩展(代理套餐下单)与兑换码批量生成能力 - V1.1 的本地历史记录需设计向上兼容的数据迁移 --- ## 4. V2.0 平台版(半年) ### 4.1 目标 从「工具」升级为「平台」:图纸可交易、移动端可触及、语言可扩展。接入真实支付,把 V1.0 的模拟支付替换为正式渠道。平台化意味着用户既是消费者也是创作者。 ### 4.2 核心功能列表 | # | 功能 | 说明 | 优先级 | |---|---|---|---| | 1 | 拼豆图纸交易市场 | 图纸商城:作者定价上架、买家按图纸或按权益购买、作者分润结算;接真实支付(微信/支付宝官方商户) | P0 | | 2 | 移动端 App(PWA 先行) | 先做 PWA(离线缓存核心算法、可安装、推送预告);验证移动端数据后再评估原生壳 | P0 | | 3 | 真实支付对接 | 替换模拟支付:微信/支付宝官方商户、退款、对账;保留兑换码链路不变 | P0 | | 4 | 多语言 | i18n 重构 + 英文站;英文版投放海外(拼豆在欧美是成熟品类,SEO 词与中文市场几乎无竞争) | P1 | | 5 | 创作者体系 | 作者认证、粉丝关注、作品集、数据看板(曝光/销量/收益) | P1 | | 6 | 平台治理 | 侵权/盗图投诉处理、交易仲裁、作者保证金与评分 | P1 | ### 4.3 成功指标 | 指标 | 目标值(V2.0 上线 2 个月内) | |---|---| | 交易市场 | 月 GMV ≥ ¥10,000;图纸商品数 ≥ 300;交易转化率 ≥ 2% | | 创作者 | 月活作者 ≥ 30 人;头部作者月收益 ≥ ¥500 | | PWA | 移动端访问占比 ≥ 40%;PWA 安装率(可安装曝光 → 安装)≥ 5% | | 真实支付 | 支付成功率 ≥ 95%;退款/对账差错率为 0 | | 多语言 | 英文站自然访问占全站 ≥ 10%;英文版兑换转化 ≥ 1% | | 整体 | 周有效解锁次数较 V1.0 增长 ≥ 5 倍(作为北极星收敛验证) | ### 4.4 依赖项 - 交易市场依赖 V1.2 账号体系(卖家身份)与素材社区内容沉淀,以及真实支付渠道完成签约 - PWA 依赖 service worker 离线策略设计、算法库体积优化 - 多语言依赖 i18n 重构完成,英文内容(说明文案、FAQ、SEO)准备 - 平台治理依赖投诉与仲裁流程设计,涉及客服人力 --- ## 5. 时间线 ``` 2026-08 2026-09 2026-10~11 2027-02 ┌───────────┐ ┌────────────┐ ┌─────────────────────┐ ┌──────────────┐ │ V1.0 │ │ V1.1 │ │ V1.2 │ │ V2.0 │ │ 上线版 │ │ 增长版 │ │ 账号版 │ │ 平台版 │ │ │ │ │ │ │ │ │ │ 生成+权益 │ │ /palette │ │ 手机号登录+云端同步 │ │ 图纸交易市场 │ │ 模拟支付 │ │ 历史记录 │ │ 素材社区 │ │ PWA+移动端 │ │ AI专区 │ │ 批量生成 │ │ 代理管理系统 │ │ 真实支付 │ │ 埋点P0 │ │ 导出优化 │ │ 内容安全 │ │ 多语言 │ │ │ │ 埋点看板 │ │ 移动端体验强化 │ │ 创作者体系 │ │ │ │ P1补全 │ │ │ │ │ └───────────┘ └────────────┘ └─────────────────────┘ └──────────────┘ ▲ ▲ ▲ ▲ │ │ │ │ 清空7项阻塞 依赖首月数据校准 依赖账号+存储+审核 依赖账号+社区+支付签约 18+QA任务全绿 漏斗基线 与本地数据迁移 与i18n重构 里程碑出口(Gate): V1.0 → V1.1:QA 全绿 + 上线后≥2周真实数据(访问→生成≥40% 确认) V1.1 → V1.2:看板漏斗稳定 + /palette 流量验证 SEO 有效 + 复购≥20% 确认 V1.2 → V2.0:账号渗透≥30% + 社区内容月增≥500 + 代理渠道跑通 ``` **版本节奏说明**:四个版本为先后依赖关系,但每版内部功能按优先级弹性裁剪。若 V1.0 数据未达转化基线(访问 → 生成 < 40% 或兑换率 < 3%),优先在 V1.1 投入流量与转化优化而非机械推进功能排期;若 V1.1 埋点看板显示 AI 占比低于 30%,V1.2 需加投 AI 专区运营。指标数据是版本间推进与回退的唯一裁决依据。 --- ## 6. 附:与 PRD 优先级映射 | 路线图版本 | 承接的 PRD 优先级 | 说明 | |---|---|---| | V1.0 | P0 全量 | 即 PRD 9.1 MVP 范围 | | V1.1 | P1 全量 + P2 局部(历史记录本地版先行) | 埋点、订单查询、风格预览、风控、本地历史 | | V1.2 | P2 全量 | 账号体系、云端同步、历史记录云端化、代理管理、素材社区 | | V2.0 | 新增范围(PRD 未覆盖) | 交易市场、PWA、多语言、真实支付,PRD 需在进入前增补章节 |