Files
perler-lab/docs/DESIGN.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

287 lines
13 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 设计规范(DESIGN.md)
> 版本: 1.0 | 适用: 首页(图片转拼豆) + AI专区(/chibi) + 弹窗
> 参考竞品: xylpindou.com(已逆向)· 风格: 温暖纸张质感 + 高级极简
---
## 1. 设计令牌 (Design Tokens)
### 1.1 色彩系统
```css
:root {
/* 背景层级 */
--bg-page: #f4f3ef; /* 页面底色:米白纸张 */
--bg-card: #ffffff; /* 卡片底色 */
--bg-subtle: #f0ede4; /* 次级底色:标签/计数 */
--bg-hover: #faf9f4; /* 悬停底色 */
/* 文字层级 */
--text-primary: #171713; /* 主文字:墨黑 */
--text-secondary: #66645d; /* 次文字 */
--text-tertiary: #8a877d; /* 辅助文字 */
--text-disabled: #b0aca0; /* 禁用文字 */
--text-on-dark: #ffffff; /* 深色底上的白字 */
/* 功能色 */
--accent: #edb045; /* 强调橙:CTA/推荐标签 */
--success: #3daf80; /* 成功绿:通过/已支付 */
--danger: #e04f4f; /* 危险红:错误/不合格 */
--info: #3677d2; /* 信息蓝:链接/进行中 */
/* 边框 */
--border: #e6e3d9; /* 卡片边框 */
--border-strong: #d2cec4; /* 强调边框 */
--border-dashed: #e0dccd; /* 虚线分隔 */
/* 网格线(图纸) */
--grid-strong: rgba(20,20,18,.78);
--grid-medium: rgba(30,30,28,.45);
--grid-light: rgba(30,30,28,.16);
}
```
### 1.2 字体系统
```css
:root {
--font-sans: "Geist", system-ui, -apple-system, "Segoe UI", "PingFang SC",
"Microsoft YaHei", sans-serif;
--font-mono: "Geist Mono", ui-monospace, "Cascadia Code", Consolas, monospace;
--text-xs: 11px; /* 辅助/标签 */
--text-sm: 12px; /* 次要 */
--text-md: 13px; /* 正文 */
--text-lg: 17px; /* 卡片标题/按钮 */
--text-xl: 20px; /* 区块标题 */
--text-hero: 32px; /* Hero H1 */
--weight-regular: 400;
--weight-medium: 500;
--weight-bold: 700;
}
```
### 1.3 间距 / 圆角 / 阴影
```css
:root {
--space-1: 4px; --space-2: 8px; --space-3: 12px;
--space-4: 16px; --space-5: 24px; --space-6: 32px;
--radius-sm: 8px; /* 小控件/标签 */
--radius-md: 10px; /* 卡片 */
--radius-lg: 12px; /* 面板/弹窗 */
--radius-full: 999px; /* 胶囊/圆形 */
--shadow-card: 0 1px 2px rgba(0,0,0,.04);
--shadow-modal: 0 8px 32px rgba(23,23,19,.14);
--shadow-float: 0 2px 12px rgba(23,23,19,.08);
}
```
### 1.4 触控目标
```css
/* 移动端最小触控区域 */
--touch-min: 40px; /* 按钮 */
--touch-min-sm: 34px; /* 标签按钮/导航 */
```
---
## 2. 首页布局(图片转拼豆)
### 2.1 页面骨架
```
┌────────────────────────────────────────────┐
│ NAV: [P] PERLER LAB | 图片转拼豆 | AI拼豆专区[PRO] | 代理合作 | ● 普通预览免费·AI生成按次付费 │
├────────────────────────────────────────────┤
│ HERO: IMAGE TO BEADS │
│ 把喜欢的图片,变成一颗颗拼豆。 │
│ 免费上传、生成和调整图纸… │
│ [0 颗拼豆] [0 种颜色] │
├────────────────────────────────────────────┤
│ DOWNLOAD PASS: AI生成权益 | 3档套餐卡片 + CTA │
├───────────────────┬──────────┬─────────────┤
│ 01 生成设置 │ 02 实时预览│ 03 MARD备料 │
│ 上传框 │ canvas │ 清单(锁定) │
│ 尺寸滑杆 │ 标尺 │ 色号清单 │
│ 颜色滑杆 │ 下载按钮 │ 10%备豆建议 │
│ 背景去除/网格开关 │ │ │
│ [↻ 重新生成图纸] │ │ │
├───────────────────┴──────────┴─────────────┤
│ FOOTER: PERLER LAB · 让每一颗颜色都有位置 │
└────────────────────────────────────────────┘
```
### 2.2 布局规格
| 区域 | 规格 |
|---|---|
| 页面最大宽 | 1280px 居中,两侧留白 24px |
| 桌面三栏 | `grid-template-columns: 320px 1fr 280px; gap: 16px` |
| Hero | 上 64px 下 48px,左对齐 |
| NAV 高度 | 56px,sticky 顶部,白底+细边框 |
| 移动端 | 单列纵向:Hero → 套餐 → 生成设置 → 预览 → 备料清单;NAV 收起为汉堡/底部 CTA 条 |
### 2.3 NAV 组件
- 品牌:`P` 字母方块(品牌色底)+ "PERLER **LAB**"
- 链接:`图片转拼豆`(激活态:下划线/加粗)、`AI拼豆专区`(带 PRO 标签:橙底白字小胶囊)
- 右侧:`代理合作`(text 按钮)、状态徽标 `● 普通预览免费 · AI生成按次付费`(11px,灰字,绿点)
### 2.4 Hero
- Eyebrow:11px 大写字母间距 `IMAGE TO BEADS`,橙色
- H1:32px bold,关键短语 `变成一颗颗拼豆` 用 `<em>` 橙色斜体
- 副标题:14px 灰字
- 统计:`<strong>0</strong>` 大数字 + 小字标签,竖线分隔
### 2.5 套餐卡片(Download Pass)
| 卡片 | 状态 | 规格 |
|---|---|---|
| 体验包 ¥4.9 3次 | 默认 | 白底+边框 |
| 常用包 ¥12.9 10次 | **推荐**(选中)| 橙边框 + `推荐` 角标 + 橙色 CTA |
| 进阶包 ¥29.9 30次 | 默认 | 白底+边框 |
卡片结构:`套餐名 → 价格(¥X.X 大号) → N 次生成 → [购买]`
CTA 按钮:`购买 / 兑换 →`,主按钮橙底白字,圆角 10px,hover 加深。
### 2.6 工作区三栏
- **01 生成设置**(左):上传框 → 文件行 → 尺寸滑杆 → 颜色滑杆 → 背景开关 → 网格开关 → 主按钮
- **02 实时预览**(中):标题栏(`● 实时预览` 绿点 + `每5格加粗·每10格标号`)+ canvas + 底部(名称/尺寸/实际颗数 + 下载按钮)
- **03 MARD 备料清单**(右):`🔒 受保护` 标签 → 遮罩统计(•••• 实际总颗数 / •• 使用颜色)→ 4 行灰色色块行(`完整色号已隐藏`)→ 锁定卡(🔒 + `完整备料清单已锁定` + [输入兑换码解锁])→ `建议多备 10% · 约 •••• 颗`
---
## 3. 交互规范
### 3.1 上传框
| 状态 | 样式 |
|---|---|
| idle | 虚线边框,`+` 大图标,`上传一张图片` + `支持 JPG、PNG、WEBP` |
| hover | 边框橙色,背景 `--bg-hover` |
| loading | 转圈 spinner,文字 `图片处理中…` |
| error | 红边 + 错误文案(如 `图片读取失败,请换一张`) |
| 成功 | 显示缩略图 + 文件名,出现 `重置` 按钮 |
### 3.2 滑杆(Range)
- 尺寸:min 16 / max 128 / step 8,刻度标签 16/48/80/128 + 快捷按钮 32/64/96/128
- 颜色:min 8 / max 48 / step 4,提示 `颜色越多还原度越高;默认推荐 24 色`
- 实时值显示在右侧 `<strong>32 × 32</strong>`
- 进度条已填充部分用橙色,thumb 白色带橙色描边
### 3.3 Toggle 开关
- 开:橙色背景,圆形滑块右移;关:灰底滑块左移
- 行内结构:`[标签] [说明小字] ... [开关]`
- 背景去除开关默认关;辅助网格开关默认开
### 3.4 锁定清单(未兑换状态)
- 统计数字用 `••••` 遮罩(真实值隐藏)
- 色号行显示 `完整色号已隐藏` + 灰色色块
- 锁定卡:🔒 图标 + `完整备料清单已锁定` + 小字说明 + `输入兑换码解锁` 按钮(次级按钮)
### 3.5 弹窗
| 弹窗 | 触发 | 内容 | 规格 |
|---|---|---|---|
| 兑换码 | 点 `输入兑换码解锁` | 输入框 + `兑换` 按钮 + 错误提示 | 居中 modal,圆角 12px,阴影 modal |
| 订单 | 点套餐 CTA | 套餐信息 + 支付方式选择(微信/支付宝 tab) + `去支付` | 同上 |
| 支付 | 订单确认 | 支付二维码/链接 + `我已支付` + `支付失败?` | 同上 |
弹窗通用:遮罩 rgba(23,23,19,.4),内容卡 max-width 380px,右上角 `×` 关闭。
---
## 4. AI 专区页(/chibi)
### 4.1 页面骨架
```
NAV (chibi 版): [← 普通拼豆] PERLER LAB | ● 每次生成消耗 1 次权益
BEAD HERO: IMAGE TO PERLER | 先选大类,再定细节,生成结果先保存。
BEAD BUILDER:
01 选择拼豆大类 [风景][人物][宠物]✓[物品][食物]
└ 大类对比图 (原图 → 像素拼豆效果)
└ 细分选择 (如宠物: 猫咪头像✓/狗狗全身/双宠互动)
02 图纸格数 48简单 / 64推荐✓ / 80精细 / 96高清
03 最大颜色数 16省豆 / 24均衡✓ / 32细腻 / 40高还原
04 主体构图 主体特写✓ / 半幅构图 / 完整构图
05 细节提示词 标签多选(最多5) + 补充文本域(160字) + 参考图上传
生成前确认:
选中示例图 | 规格摘要(类别/细分/图纸/预计颗数) | [上传原图] | 付费说明 | [兑换后生成→]
PROMISE: 分类更准确 / 生成按次计费 / 结果防丢失
FOOTER
```
### 4.2 分类 Tabs
- 5 个分类:风景(山川、城市和旅行纪念) / 人物(五官、发型和穿搭清楚) / 宠物(毛色、表情和品种特征) / 物品(手办、礼物和纪念物) / 食物(甜品、饮品和特色美食)
- 选中态:橙底白字;默认:白底边框
- 每个分类下方:对比图区(原图 → 像素图)+ 3 个细分按钮
### 4.3 细分与标签
- 每类 3 细分,如宠物:`猫咪头像`(圆润脸型与花纹) / `狗狗全身`(耳朵、四肢和毛色) / `双宠互动`(两只宠物同框)
- 提示词标签:`✓ 眼睛更有神`(已选,橙勾)`+ 保留项圈配饰`(未选,加号)
- 最多选 5 个,超出置灰提示 `最多选 5 项`
### 4.4 参数选项行
- 格数:48简单 / **64推荐** / 80精细 / 96高清(4 等分按钮组)
- 颜色:16省豆 / **24均衡** / 32细腻 / 40高还原
- 构图:主体特写 / 半幅构图 / 完整构图(3 等分)
- 选中态:橙底白字圆角 8px
### 4.5 生成按钮
- 未兑换:`兑换后生成 →`(disabled 灰底),点击弹兑换码窗
- 已兑换:`生成 →`(橙底白字)
- 生成中:spinner + `AI 生成中…`
- 文案提示:`每次 AI 成功生成扣 1 次;本作品转图纸和首次下载免费,失败不扣`
---
## 5. 图纸导出规范(PNG)
### 5.1 画布布局
```
┌──────────────────────────────────────────┐
│ 标题: {作品名} · {N}×{N} · MARD 拼豆图纸 │ (24px bold, 左边距 80px)
├──────────────────────────────────────────┤
│ ┌──────────────────────────────────┐ │
│ │ 拼豆网格 (N×N, 每格 28px/22px) │ │ ← 顶部+左侧 80px 边距
│ │ 每格: 豆圆(半径0.42格) + 色号 │ │
│ └──────────────────────────────────┘ │
│ 标尺: 每10格粗线+数字, 每5格中粗线 │
├──────────────────────────────────────────┤
│ MARD 备豆清单 │ (28px bold)
│ 共 {总颗数} 颗 · {颜色数} 种颜色 · 建议多备 10% (约 {1.1×总} 颗) │
│ [色块] {色号} {颗数} [色块] {色号} {颗数} ... (每行 3-4 个) │
└──────────────────────────────────────────┘
```
### 5.2 尺寸规则
| 项目 | 值 |
|---|---|
| 单元格 | gridSize ≥ 96 用 22px,否则 28px |
| 画布宽 | `gridSize × 28/22 + 160` |
| 画布高 | 标题区 80 + 网格 + 清单区(每行 44px + 留白) |
| 网格起点 | (80, 80) |
| 豆圆半径 | 0.42 × 单元格 |
### 5.3 网格线
| 类型 | 颜色 | 线宽 |
|---|---|---|
| 每 10 格 | `rgba(20,20,18,.78)` | 2.6px + 标号(粗体 14px) |
| 每 5 格 | `rgba(30,30,28,.45)` | 1.7px |
| 其余 | `rgba(30,30,28,.16)` | 1px |
### 5.4 色号文字对比度
- 规则:`lab[0] < 52`(深色底)→ 白字 `#fff`;否则 → 深字 `#171713`
- 字号:`max(7px, 0.28 × 单元格)`,加粗,居中
### 5.5 备豆清单
- 色块:圆形 12px 半径,外圈 `#d2cec4` 描边
- 布局:`[色块] {色号}(17px bold 左对齐) {颗数} 颗(15px 灰)`
- 每行 3-4 个(依据总宽度:>1800px 用 3 列,否则 4 列)
### 5.6 文件名
`{作品名}-{N}x{N}-MARD拼豆图纸.png`
---
## 6. 响应式断点
| 断点 | 行为 |
|---|---|
| ≥ 1024px | 桌面三栏布局 |
| 768–1023px | 两栏(设置+预览),备料清单下移 |
| ≤ 767px | 单栏纵向;NAV 简化;底部固定 `购买/兑换` CTA 条;分页按钮触控 ≥ 40px |