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

13 KiB
Raw Blame History

PERLER LAB 设计规范(DESIGN.md)

版本: 1.0 | 适用: 首页(图片转拼豆) + AI专区(/chibi) + 弹窗 参考竞品: xylpindou.com(已逆向)· 风格: 温暖纸张质感 + 高级极简


1. 设计令牌 (Design Tokens)

1.1 色彩系统

: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 字体系统

: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 间距 / 圆角 / 阴影

: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 触控目标

/* 移动端最小触控区域 */
--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