Files
Sisyphus (主代理) 02762400fb chore: 项目基线提交 - 拼豆图纸生成器 V1.0 核心代码
- 前端: React+Vite 首页/AI专区, 算法库(MARD色板/量化/背景去除), API对接
- 后端: Express+SQLite, 兑换码/订单/支付/chibi生成, 风控+云端同步
- CI/CD: GitHub Actions + Docker + nginx 配置
- 文档: PRD/DESIGN/LAUNCH/ROADMAP/E2E/竞品对照等 15 份
- 工程: 任务看板(taskboard) + 健康巡检(agent-health) + Git流程(gitflow)
2026-08-13 21:40:27 +08:00

22 KiB
Raw Permalink Blame History

PERLER LAB 拼豆图纸生成器 · 产品需求文档(PRD)

项目 内容
文档版本 v1.0
编写日期 2026-08-13
编写角色 产品经理(PM-Agent)
产品名称 PERLER LAB(拼豆)
竞品基线 https://xylpindou.com/(已完成逆向分析)
文档状态 评审中

1. 产品概述

1.1 产品背景

拼豆(Perler Beads / Fuse Beads)是近年流行的手工 DIY 品类:用户将彩色塑料豆按图纸排列在钉板上,熨烫后成型。拼豆图纸的质量直接决定作品成败,而市面现有工具多为英文、功能简陋、图纸精度差。竞品 xylpindou.com 通过「图片一键转图纸 + AI 生成拼豆画」切入该市场,并采用「预览免费、兑换码解锁下载」的付费模式,已跑通完整商业链路。

PERLER LAB 以竞品为基线进行复刻与优化,目标是在中国区提供体验更顺滑、图纸更专业、付费链路更清晰的拼豆图纸生成工具。

1.2 产品定位

一句话定位:用户上传任意图片,几秒内生成可下载、可照做的专业拼豆图纸;另设 AI 拼豆专区,输入一句话即可生成专属图案。

平台形态:Web 应用(桌面端优先,移动端适配),无 App。

1.3 核心价值主张

价值点 说明
一键成图 上传图片 → 自动降采样、量化、匹配专业色板 → 输出带色号和备料清单的图纸
专业色板 内置 MARD 色板(A~H+M 共 8 系 200+ 色),CIE LAB 色差匹配,颜色还原度高
免费预览 解锁前可完整预览图纸效果,确认满意再付费,降低决策门槛
AI 拼豆 5 大类 × 3 细分共 15 种风格,免去找图烦恼,输入描述即可生成
代理分销 面向微商/手工博主的高性价比大额套餐,支持二次分发

1.4 竞品参考(xylpindou.com)

逆向分析结论(作为唯一事实来源,详见 competitor-analysis/ 与 TEAM.md):

  • 技术栈:Next.js 19(App Router,纯前端 canvas 算法),无重型依赖
  • 核心算法:4× 采样 → 4×4 像素块众数量化 → k-means++(5 轮)→ MARD 色板 LAB 匹配 → canvas 绘制
  • 商业模式:预览免费,兑换码解锁高清图纸;体验/常用/进阶三档套餐 + 代理三档套餐
  • 已还原接口 5 个:/api/codes/redeem、/api/orders(POST/GET)、/api/codes/consume、/api/chibi/generate

1.5 产品目标

目标 指标
验证付费意愿 首月访问 → 兑换码解锁转化率 ≥ 3%
验证 AI 功能吸引力 首月 chibi 生成次数占全站权益消耗 ≥ 30%
跑通完整商业闭环 支付对接(可先模拟)→ 兑换码 → 权益扣减 → 下载全链路无断裂

2. 目标用户画像

2.1 核心画像

画像 特征 需求 付费意愿
手工爱好者(主画像) 25~40 岁女性为主,小红书/抖音手工博主关注者,日常做拼豆、十字绣、羊毛毡等手工;手机/电脑混合使用 把喜欢的图(宠物、风景、动漫截图)变成能照做的图纸,图纸要清晰、色号准确 高,愿为成品效果买单
亲子家长 30~45 岁,为孩子做手工启蒙,常在周末操作 生成简单、引导清晰、图纸适合儿童操作(大格、少色) 中高,单价敏感
手工博主/代理 有粉丝基础,需要批量图纸做内容,或代理分销赚差价 大额套餐、批量生成、可转赠/二次分发的权益 高,走代理套餐
尝鲜用户 偶然看到分享/广告,想试试 AI 生成 低门槛体验,最好免费或极低价试一次 低,靠体验包转化

2.2 典型使用场景

  1. 用户看到好看的宠物照片,上传后生成图纸,预览满意,用体验包兑换高清图纸下载,照着拼出作品发小红书。
  2. 亲子家长带孩子选一张卡通图,选 48 格小图纸、16 色,30 分钟内完成一个简单作品。
  3. 手工博主一次性生成 10 张主题图纸囤稿,用于连续多期内容更新。
  4. 代理采购 500 次套餐,把兑换码发给旗下学员/客户,赚取差价。

3. 功能清单与优先级

优先级定义:P0 = 第一期必须上线(MVP);P1 = 第二期上线;P2 = 观察数据后迭代。

3.1 功能总表

模块 功能 说明 优先级
图纸生成 图片上传 支持 JPG/PNG/WebP,≤10MB,拖拽 + 点击上传 P0
参数设置 格数(如 48/64/80/96)、色数(16/24/32/40)、是否去背景、背景色 P0
图纸生成 4× 采样 → 众数量化 → k-means++ → MARD 色板匹配 P0
图纸预览 画布渲染豆圆 + 色号;网格每 5 格加粗、每 10 格标号;可缩放 P0
备料清单 总颗数、色数、每色用量、多备 10% 建议 P0
下载解锁 高清图纸下载 未解锁时下载按钮进入兑换弹窗;解锁后输出 PNG(含图纸 + 备料单) P0
免费预览策略 预览不消耗权益,仅下载消耗 P0
权益体系 兑换码兑换 输入兑换码 → 绑定权益次数到当前设备(localStorage) P0
权益扣减 每次解锁下载 / 每次 AI 生成消耗 1 次权益 P0
权益展示 顶部常驻显示剩余次数、已用次数 P0
订单支付 套餐下单 5 档套餐(见第 4 章),MVP 阶段支付流程可模拟 P0
订单查询 查询订单状态,支付成功后自动完成兑换 P1
AI 拼豆 分类选择 5 大类 × 3 细分(见第 5 章) P0
AI 生成 输入描述词 + 参考图 + 参数 → 返回拼豆图纸 P0
风格预览 每类展示「原图 VS 像素成品」对比样例 P1
代理/分销 兑换码管理 代理查看名下兑换码、剩余库存、核销记录 P2
兑换码分发 生成可分发的兑换码/口令 P2
账号体系 登录注册 手机号/微信登录,权益跨设备同步 P2(MVP 不做,权益存本地)
历史记录 我的生成/下载记录 P2

3.2 核心链路(P0)

上传图片 → 设置参数 → 生成预览(免费) → 满意?→ 兑换码解锁 → 高清下载
                                        ↓ 不满意
                                  调整参数重新生成(预览免费)
AI 拼豆:选择分类/细分 → 输入描述 → 生成(消耗 1 次权益)→ 预览 → 解锁下载

4. 权益体系设计

4.1 套餐定价(对齐竞品)

套餐 价格 次数 单次成本 目标用户 适用场景
体验包 ¥4.9 3 次 ¥1.63 尝鲜用户 首次体验,降低决策门槛
常用包 ¥12.9 10 次 ¥1.29 手工爱好者 个人日常使用
进阶包 ¥29.9 30 次 ¥1.00 深度用户 高频玩家
代理套餐 A ¥139 200 次 ¥0.70 手工博主/代理 内容囤稿 + 分销
代理套餐 B ¥299 500 次 ¥0.60 中小代理 批量分发
代理套餐 C ¥499 1000 次 ¥0.50 大代理 规模化分销

定价策略说明:

  • 单价随购买量递减,引导用户向上购买大套餐。
  • 代理套餐与个人套餐的边界在于「次数量级」与「分发属性」,代理套餐支持兑换码批量生成(P2)。
  • 权益按「次」计,不区分用途:解锁下载 1 次与 AI 生成 1 次等价,统一扣减。

4.2 预览免费 / 兑换解锁策略

环节 是否免费 说明
图片上传 + 参数调整 ✅ 免费 可反复调整,不限次数
图纸预览(含缩放) ✅ 免费 完整预览,水印或低清示意,不提供色号明细下载
备料清单查看 ✅ 免费 展示总颗数/色数,具体分色明细在解锁后给出
高清图纸下载(PNG) ❌ 消耗 1 次权益 无权益时弹出兑换引导
AI 拼豆生成 ❌ 消耗 1 次权益 生成即消耗(生成结果含图纸与下载权限)

解锁引导策略:

  • 用户点击「下载高清图纸」且无有效权益时,弹出兑换弹窗(见 6.4)。
  • 弹窗内展示三档个人套餐 + 兑换码输入框,突出「¥4.9 体验 3 次」作为首单钩子。
  • 已解锁图纸下载不重复扣费(同一图纸在同一权益周期内可重复下载)。

4.3 兑换码 / 订单 / 权益流转

依据竞品逆向的接口链设计,完整流转如下:

┌─────────┐   POST /api/orders    ┌─────────┐  GET /api/orders?orderNo=  ┌─────────┐
│ 用户下单 │ ───────────────────→ │ 后端创建 │ ──────────────────────────→ │ 支付回调 │
└─────────┘                      └─────────┘   (status=paid 后自动兑换)  └─────────┘
                                                                              │
                                                    POST /api/codes/redeem     │ 返回兑换码
┌─────────┐   POST /api/codes/redeem   ┌─────────┐  ◄─────────────────────────┘
│ 输入兑换码│ ─────────────────────────→ │ 兑换成功 │
└─────────┘   {code}                   └─────────┘  ← access: {code, usesLeft}
                                              │ 写入 localStorage (perler-download-code)
                                              ▼
┌─────────┐  POST /api/codes/consume  ┌─────────┐
│ 解锁下载 │ ─────────────────────────→ │ 扣减 1 次│ ← access + freeDownload
└─────────┘  {code,fileName,downloadGrant} └─────────┘
                                              ▼
┌─────────┐  POST /api/chibi/generate ┌─────────┐
│ AI 生成 │ ─────────────────────────→ │ 扣减 1 次│ ← image(base64) + access + downloadGrant
└─────────┘                            └─────────┘

关键规则:

场景 规则
兑换 兑换码需未过期、未耗尽;兑换成功即写入本地权益,返回剩余次数
支付 → 兑换 订单支付成功后自动完成 redeem,用户无需手动输入兑换码
扣减(下载) 每次高清下载消耗 1 次;同一图纸重复下载不重复扣(凭 downloadGrant 判定)
扣减(AI) 每次 AI 生成消耗 1 次,返回的 downloadGrant 允许该图纸解锁下载
核销 权益次数用尽后,再次下载/生成回到兑换弹窗
本地存储 MVP 阶段权益存 localStorage(键 perler-download-code),无账号体系
防滥用 兑换码单设备绑定;服务端记录核销日志,异常频率触发风控(P1)

5. AI 拼豆专区(chibi)

5.1 分类体系

5 大类 × 3 细分 = 15 种风格,每类配「原图 VS 像素成品」参考对(素材已抓取,见 competitor-analysis/assets_chibi_*)。

大类 细分(3 种) 典型描述词示例
风景 日出/星空/森林、海边/沙滩、城市/街道 「童话森林,晨雾中的小屋」
人物 头像、半身、全身 「Q 版少女,双马尾,微笑」
宠物 猫、狗、其他小动物 「橘猫趴着打哈欠」
物品 美食周边、文具、日常小物 「马克杯,上面有星星图案」
食物 甜品、主食、水果 「草莓蛋糕切面,多汁」

5.2 生成参数

参数 可选值 默认 说明
gridSize(格数) 48 / 64 / 80 / 96 64 格数越大越精细,用豆越多
colorCount(色数) 16 / 24 / 32 / 40 24 色数越多还原度越高,备料越复杂
composition(构图) 见细分规则 居中 控制主体在画面中的位置/大小
detailTags(细节标签) 每类 6 个提示词标签 - 追加细节增强 prompt
customPrompt(自定义描述) 自由文本 空 用户补充描述
referenceImage(参考图) 可上传 空 提供风格参考,可选

5.3 生成流程

  1. 用户进入 /chibi 页,选择大类 → 细分。
  2. 可选:上传参考图、填写自定义描述。
  3. 选择格数、色数。
  4. 点击生成 → 校验权益 → POST /api/chibi/generate → 返回图纸 base64。
  5. 预览生成结果,满意则解锁下载(downloadGrant 已随生成返回),不满意可调整参数重新生成(重新扣减)。

生成消耗 1 次权益,与下载解锁同等定价。该策略对齐竞品,避免 AI 生成被滥用。


6. 页面地图

6.1 站点结构

/            首页(图纸生成主流程)
/chibi       AI 拼豆专区
弹窗(全局,非独立页面):
  · 兑换弹窗(兑换码输入 + 套餐购买入口)
  · 订单弹窗(套餐选择 + 支付)
  · 订单结果弹窗(支付成功/失败 → 自动兑换)

6.2 首页(/)

区块 内容 说明
顶部导航 Logo、权益状态(剩余次数)、AI 专区入口、兑换入口 权益状态常驻,引导转化
上传区 拖拽/点击上传,支持 JPG/PNG/WebP 主 CTA
参数面板 格数、色数、去背景开关、背景色 默认值 64 格 / 24 色
预览画布 图纸渲染(豆圆 + 色号 + 网格标号),缩放控件 免费完整预览
备料清单 总颗数、色数、分色用量、多备 10% 解锁后展示分色明细
操作区 「下载高清图纸」按钮 未解锁时触发兑换弹窗

6.3 /chibi 页(AI 拼豆专区)

区块 内容
分类选择 5 大类图标/卡片,选中后展开 3 细分
风格预览 当前细分的「原图 VS 像素成品」对比图
生成表单 自定义描述、参考图上传、格数、色数
生成结果 图纸预览 + 下载按钮
引导 未登录/无权益时展示套餐入口

6.4 弹窗

弹窗 触发时机 内容
兑换弹窗 点击下载/生成且无权益 兑换码输入框 + 三档个人套餐卡 + 代理套餐入口(P2)
订单弹窗 点击套餐「立即购买」 套餐确认、价格、支付方式选择(MVP 为模拟支付)
订单结果弹窗 支付回调返回 成功:展示兑换码 + 剩余次数,自动 redeem;失败:重试/更换支付方式

7. 用户故事

# 角色 用户故事 验收要点 优先级
US-01 手工爱好者 我想把宠物照片变成拼豆图纸,下载高清版照着拼 上传 → 生成 → 预览 → 兑换 → 下载全链路 ≤ 30 秒(不含支付);图纸含色号与备料清单 P0
US-02 尝鲜用户 我想花最少的钱先试一次,确定图纸质量再决定是否复购 首次兑换引导 ¥4.9 体验包;下载后图纸完整可用;无强制注册 P0
US-03 手工爱好者 我想调整格数和色数,找到袋子里豆子够用的方案 参数修改后重新生成 ≤ 5 秒;备料清单实时反映用量 P0
US-04 亲子家长 我想带孩子做一张简单图纸,不想太复杂 48 格 / 16 色一键预设;图纸大格清晰易读 P0
US-05 深度用户 我想要一张星空主题的 AI 拼豆图,不用自己找图 进入 /chibi → 选风景/星空 → 生成 → 下载,全程 ≤ 2 分钟 P0
US-06 手工博主 我想分批次少量购买生成次数,控制成本 常用包/进阶包按需购买;剩余次数常驻可见 P1
US-07 代理 我想批量采购次数并分发给学员,赚差价 代理套餐下单;名下兑换码生成、库存、核销记录(P2);分发链接/口令(P2) P2
US-08 全部用户 我想换设备后还能用已购权益 账号登录后权益云端同步(P2);MVP 阶段权益仅存本地,需在购买设备使用 P2

8. 成功指标

8.1 北极星指标

周有效解锁次数(每周成功解锁下载 + AI 生成的权益消费次数),衡量产品核心价值被实际使用的频率。

8.2 指标体系

类别 指标 目标值(首月) 说明
转化 访问 → 生成转化率 ≥ 40% 上传后成功生成图纸的访客占比
转化 生成 → 兑换码解锁转化率 ≥ 3% 核心商业指标
转化 兑换码 → 再次消费转化率 ≥ 20% 复购率,验证体验包钩子
下载 高清下载成功率 ≥ 99% 解锁后下载 PNG 无失败
AI chibi 生成占权益消耗比 ≥ 30% 验证 AI 功能吸引力
质量 图纸平均色差 ≤ 2.0(ΔE,LAB) MARD 色板匹配精度
性能 图纸生成耗时(P50) ≤ 5 秒 桌面端;移动端 ≤ 8 秒
体验 兑换全流程成功率 ≥ 95% 支付(模拟)→ redeem → 扣减 → 下载无断点
稳定性 全链路无致命错误率 100% 无阻断性 Bug

8.3 埋点需求(P1)

事件 时机
upload_start / upload_success 上传开始/成功
generate_click / generate_success 点击生成 / 生成成功
preview_seen 预览渲染完成
download_click 点击下载(含未解锁)
redeem_popup_seen / redeem_submit / redeem_success 兑换弹窗曝光 / 提交 / 成功
order_submit / order_paid / order_fail 下单 / 支付成功 / 失败
chibi_category_select / chibi_generate AI 分类选择 / 生成

9. MVP 范围定义

9.1 第一期(P0)做什么

范围 内容
图纸生成 图片上传、参数设置(格数/色数/去背景)、核心算法(4× 采样 → 众数量化 → k-means++ → MARD 匹配)、预览、备料清单、PNG 下载
权益体系 预览免费;兑换码兑换(/api/codes/redeem);下载扣减(/api/codes/consume);权益本地存储
订单支付 三档个人套餐下单(/api/orders);支付流程模拟(不接真实支付渠道,返回模拟支付成功);支付成功后自动 redeem
AI 拼豆 5 大类 × 3 细分;格数 48/64/80/96;色数 16/24/32/40;/api/chibi/generate;生成即扣 1 次权益
页面 首页(上传→生成→预览→下载)、/chibi 页、兑换弹窗、订单弹窗、订单结果弹窗
数据 核心埋点(见 8.3 中 P0 部分)、基础访问统计

9.2 第一期(P0)不做什么

不做项 原因/替代方案
真实支付对接(微信/支付宝) 先模拟支付跑通全链路,验证转化后再接入真实渠道
账号体系/登录注册 权益存 localStorage(perler-download-code),与竞品一致;换设备丢失问题后置
权益云端同步 依赖账号体系,后置到 P2
代理套餐购买与兑换码管理 代理三档套餐 ¥139/¥299/¥499 仅做展示与下单入口(可模拟),批量分发/核销记录后置 P2
历史记录/我的生成 后置 P2
移动端深度优化 保证基本可用,重点优化桌面端
兑换码风控/防刷 仅做基础核销日志,风控规则后置 P1
多语言 仅中文

9.3 里程碑

阶段 内容 出口标准
M1 核心算法 + 首页生成链路 上传→预览→下载全通,算法单测通过
M2 权益体系 + 模拟支付 + 兑换弹窗 兑换→扣减→下载闭环无断点
M3 AI 拼豆专区 15 种风格生成可用,权益扣减正确
M4 埋点 + 联调 + 走查 全链路测试通过,达标 8.2 指标基线
M5 上线 部署完成,监控就绪

10. 附录:接口契约参考(逆向基线)

以下为竞品逆向还原的接口形态,作为后端设计与联调基线。MVP 阶段需保证请求/响应字段与前端契约一致,具体 Schema 以架构文档为准。

接口 方法 请求关键字段 响应关键字段 用途
/api/codes/redeem POST {code} access: {code, usesLeft, ...} 兑换码兑换
/api/orders POST {packageName, paymentMethod} order: {orderNo, status, ...} 创建订单
/api/orders?orderNo= GET orderNo order.status(paid 后自动 redeem) 查询订单
/api/codes/consume POST {code, fileName, downloadGrant} access + freeDownload 下载扣减
/api/chibi/generate POST {code, image, referenceImage, category, subtype, gridSize, colorCount, composition, detailTags, customPrompt} image(base64) + access + downloadGrant AI 生成

算法链路(全前端,MVP 可原样落地):预处理缩放到 4×格数 → 每格 4×4 块 /24 量化取众数均值 → 可选背景去除(4-连通 BFS + CIE LAB 阈值 20)→ k-means++ 量化(5 轮)→ MARD 色板 LAB 匹配 → canvas 绘制(豆圆 + 色号 + 每 5 格加粗 + 每 10 格标号 + 备料清单)。


11. 风险与开放问题

# 风险/问题 影响 应对
1 竞品算法未完全实测(接口真实响应待验证) 参数细节可能偏差 P0.5 阶段完成 5 接口实测后回填 PRD 附录
2 AI 生成依赖外部模型,成本与稳定性未知 单次成本可能超套餐定价 MVP 先接简单模型代理,验证后优化;生成前明确提示将扣 1 次权益
3 localStorage 权益可被清除,用户投诉换设备丢失 客诉风险 兑换弹窗与 FAQ 明示「权益保存在当前设备」;P2 引入账号同步
4 模拟支付与真实支付的差异 上线前需二次改版 后端订单接口按真实支付形态设计,仅支付网关可替换
5 图纸版权风险(用户上传他人图片) 合规风险 用户协议声明责任归属(P1 补)