- 前端: 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)
5.9 KiB
5.9 KiB
PERLER LAB 复刻项目 · 团队架构与作战计划
主代理:Sisyphus(监督 + 调度,不亲自写代码) 竞品基线:https://xylpindou.com/(已完成逆向分析,见
competitor-analysis/)
一、团队分工表
| 角色 | 对应代理/能力 | 核心职责 | 本项目中具体任务 | 产出物 |
|---|---|---|---|---|
| 总架构工程师 | Oracle + 主代理决策 | 技术选型、系统设计、接口契约、架构评审 | 1. 确定前后端技术栈 2. 设计 5 个 API 契约 3. 定义数据模型(兑换码/订单/权益) 4. 算法模块化设计 | 架构文档、API 契约 |
| 产品经理 | Metis(需求分析) | 需求拆解、功能清单、商业模式、定价策略 | 1. 竞品功能对照表 2. MVP 范围定义 3. 权益体系设计(体验/常用/进阶包) 4. 用户故事 | PRD 文档、功能清单 |
| UI/UX 页面设计师 | visual-engineering + frontend | 页面设计、视觉规范、交互、响应式 | 1. 首页:上传区/参数面板/预览画布/备料清单 2. AI 专区页:分类选择/生成确认 3. 弹窗:兑换码/订单/支付 4. 设计令牌(色板/字体/圆角) | Figma 规范、CSS 设计令牌 |
| 前端工程师 | visual-engineering + frontend | React 组件实现、canvas 算法工程化、状态管理 | 1. 图片→图纸核心算法(4x采样/k-means++/LAB匹配) 2. MARD 色板数据 3. 图纸绘制与 PNG 下载 4. 页面组件与交互 | 前端代码、算法单元测试 |
| 后端工程师 | unspecified-high / deep | API 实现、数据库、支付对接、权益核销 | 1. POST /api/codes/redeem 2. POST /api/orders + GET /api/orders 3. POST /api/codes/consume 4. POST /api/chibi/generate(AI 代理) 5. 兑换码生成/库存/核销 | 后端服务、数据库 Schema |
| 测试工程师 | unspecified-high + playwright | 功能测试、UI 走查、接口测试、回归 | 1. 上传→生成→预览链路 2. 兑换码全流程 3. 下载授权拦截 4. 移动端适配 5. 竞品行为对照 | 测试用例、测试报告 |
| 爬虫专家 | 主代理直接执行 + librarian | 站点全量抓取、静态资源采集、接口实测、素材库建设、持续监控 | 1. ✅ 已抓取:全部 JS chunk、CSS、示例图 2. 待办:实测 5 个接口真实响应 3. 待办:下载 chibi 五类对比图素材 4. 待办:建立持续监控(版本变化检测) | 原始抓取数据、接口实测报告 |
| 数据分析师(竞品) | explore / librarian | 竞品逆向、资料检索 | ✅ 已完成:接口清单、算法还原、色板提取、商业链路 | 分析报告(本目录) |
二、已完成的竞品逆向成果(团队需求基线)
技术栈
- Next.js 19(Turbopack 构建,App Router,全客户端渲染)
- React 19.3-canary,纯前端 canvas 算法,无重型依赖
已还原的 5 个接口
| 接口 | 方法 | 请求 | 响应关键字段 |
|---|---|---|---|
/api/codes/redeem |
POST | {code} |
access: {code, usesLeft, ...} |
/api/orders |
POST | {packageName, paymentMethod} |
order: {orderNo, status, ...} |
/api/orders?orderNo= |
GET | - | order.status(paid 后自动 redeem) |
/api/codes/consume |
POST | {code, fileName, downloadGrant} |
access + freeDownload |
/api/chibi/generate |
POST | {code, image(base64), referenceImage, category, subtype, gridSize, colorCount, composition, detailTags, customPrompt} |
image(base64) + access + downloadGrant |
核心算法(全前端,已还原)
- 预处理:缩放到 4×格数,白底 contain 居中,
imageSmoothingQuality=high - 降采样:每格 4×4 像素块内按
/24量化取桶,取众数桶均值(抗噪) - 背景去除(可选):边缘像素主色为背景色 → 4-连通 BFS 泛洪 → CIE LAB 色差 > 阈值(默认20) 剔除
- 颜色量化:k-means++ 初始化(最远点采样)→ 迭代 5 轮 → 聚类中心
- 色板匹配:CIE LAB 欧氏距离匹配 MARD 色板(A~H+M 共 8 系 200+ 色,已完整提取)
- 图纸绘制:canvas 画豆圆+色号,网格每 5 格加粗每 10 格标号,底部备料清单(总颗数/色数/多备 10%)
商业模式
- 预览免费,兑换码解锁高清图纸(
perler-download-code存 localStorage) - 套餐:体验 ¥4.9/3次 · 常用 ¥12.9/10次 · 进阶 ¥29.9/30次(AI 生成按次扣权益)
- 代理套餐:¥139/200次 · ¥299/500次 · ¥499/1000次
- chibi AI:5 大类(风景/人物/宠物/物品/食物)× 3 细分 × 6 提示词标签,格数 48/64/80/96,色数 16/24/32/40
三、作战阶段
| 阶段 | 内容 | 负责人 | 状态 |
|---|---|---|---|
| P0 竞品逆向 | 接口/算法/色板/商业模式提取 | 数据分析师 + 爬虫专家 | ✅ 完成(素材采集待补) |
| P0.5 接口实测 | 5 个接口真实响应验证、chibi 素材补齐 | 爬虫专家 | ⏳ |
| P1 架构设计 | 技术栈决策、API 契约、数据模型 | 总架构工程师 | ⏳ |
| P2 产品设计 | PRD、功能范围、权益体系 | 产品经理 | ⏳ |
| P3 UI 设计 | 设计令牌、页面设计 | UI/UX 设计师 | ⏳ |
| P4 前端开发 | 算法 + 页面 + 下载 | 前端工程师 | ⏳ |
| P5 后端开发 | API + 兑换码 + 支付 + AI 代理 | 后端工程师 | ⏳ |
| P6 联调测试 | 全链路测试 + 走查 | 测试工程师 | ⏳ |
| P7 上线 | 部署、监控 | 主代理 | ⏳ |
四、主代理调度规则(Sisyphus)
- 并行优先:无依赖任务同时派发(后台运行)
- 契约先行:任何开发前必须先有 API 契约(架构师产出,全员遵守)
- 验证兜底:每阶段交付物经主代理验收,不合格打回(
task_id续派同代理) - 禁止越权:UI 设计师不写业务逻辑,后端不碰样式,人人只做自己的活
- 参考答案:竞品分析文档为唯一事实来源,偏差需主代理裁决