- 前端: 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)
13 KiB
13 KiB
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 |