Files
perler-lab/TEAM.md
T
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

5.9 KiB
Raw Blame History

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

核心算法(全前端,已还原)

  1. 预处理:缩放到 4×格数,白底 contain 居中,imageSmoothingQuality=high
  2. 降采样:每格 4×4 像素块内按 /24 量化取桶,取众数桶均值(抗噪)
  3. 背景去除(可选):边缘像素主色为背景色 → 4-连通 BFS 泛洪 → CIE LAB 色差 > 阈值(默认20) 剔除
  4. 颜色量化:k-means++ 初始化(最远点采样)→ 迭代 5 轮 → 聚类中心
  5. 色板匹配:CIE LAB 欧氏距离匹配 MARD 色板(A~H+M 共 8 系 200+ 色,已完整提取)
  6. 图纸绘制: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)

  1. 并行优先:无依赖任务同时派发(后台运行)
  2. 契约先行:任何开发前必须先有 API 契约(架构师产出,全员遵守)
  3. 验证兜底:每阶段交付物经主代理验收,不合格打回(task_id 续派同代理)
  4. 禁止越权:UI 设计师不写业务逻辑,后端不碰样式,人人只做自己的活
  5. 参考答案:竞品分析文档为唯一事实来源,偏差需主代理裁决