- 前端: 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)
77 lines
5.9 KiB
Markdown
77 lines
5.9 KiB
Markdown
# 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. **参考答案**:竞品分析文档为唯一事实来源,偏差需主代理裁决
|