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)
This commit is contained in:
commit
02762400fb
174 files changed
+28059
No files matched your search
+286
@@ -0,0 +1,286 @@
|
||||
# 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 |
|
||||
Reference in new issue
Block a user