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

77 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. **参考答案**:竞品分析文档为唯一事实来源,偏差需主代理裁决