349 lines
15 KiB
Markdown
349 lines
15 KiB
Markdown
# PERLER LAB 设计规范(DESIGN.md)
|
||
|
||
> 版本: 2.0 | 适用: 全站(首页/AI专区/豆仓/图纸库/弹窗)
|
||
> 风格: 温暖手作(warm craft):纸张质感 + 琥珀主色 + 圆润触感 + 克制动效
|
||
> v2.0 变更: 字体真实加载、字号上调、动效令牌、八态交互、无障碍修复、签名质感
|
||
> 依据: design-taste skill(Emil Kowalski 动效工艺 + impeccable 反AI味 + taste-skill 预检)
|
||
|
||
---
|
||
|
||
## 0. 设计判读(Design Read)
|
||
|
||
- **产品**: 拼豆图纸生成器,创意手工工具
|
||
- **受众**: 拼豆手工爱好者(休闲、耐心、注重成品美感)
|
||
- **气质关键词**: 温暖、纸张、手作、像素颗粒感、亲切不幼稚
|
||
- **签名元素**: 拼豆底板(pegboard)圆点阵列 —— 唯一允许的装饰纹理,仅用于 Hero 与上传区
|
||
- **强度拨盘**: DESIGN_VARIANCE 4 / MOTION_INTENSITY 4 / VISUAL_DENSITY 4
|
||
|
||
---
|
||
|
||
## 1. 设计令牌 (Design Tokens)
|
||
|
||
### 1.1 色彩系统
|
||
```css
|
||
:root {
|
||
/* 背景层级(暖纸) */
|
||
--bg-page: #f4f3ef; /* 页面底色:米白纸张 */
|
||
--bg-card: #fffefa; /* 卡片:暖白(不用纯白) */
|
||
--bg-subtle: #f0ede4; /* 次级底色:标签/计数 */
|
||
--bg-hover: #faf9f4; /* 悬停底色 */
|
||
|
||
/* 文字层级(暖墨) */
|
||
--text-primary: #1f1d17; /* 主文字:暖墨黑 */
|
||
--text-secondary: #615e54;
|
||
--text-tertiary: #8a877d;
|
||
--text-disabled: #b0aca0;
|
||
--text-on-dark: #fffefa;
|
||
|
||
/* 功能色 */
|
||
--accent: #edb045; /* 琥珀:CTA 底色/选中态 */
|
||
--accent-hover: #e3a335; /* CTA 悬停 */
|
||
--accent-strong: #d18f1f; /* CTA 按下/描边加深 */
|
||
--accent-ink: #8a5c08; /* 亮底上的琥珀文字(≥4.5:1):链接/强调字 */
|
||
--accent-soft: #f7e3bb; /* 琥珀浅底:选中项背景/焦点光晕 */
|
||
--success: #2f9e77;
|
||
--danger: #d94848;
|
||
--danger-soft: #fbeaea;
|
||
--info: #3677d2;
|
||
|
||
/* 边框 */
|
||
--border: #e6e3d9;
|
||
--border-strong: #d2cec4;
|
||
--border-dashed: #ddd8c8;
|
||
|
||
/* 网格线(图纸导出专用,不改) */
|
||
--grid-strong: rgba(20,20,18,.78);
|
||
--grid-medium: rgba(30,30,28,.45);
|
||
--grid-light: rgba(30,30,28,.16);
|
||
}
|
||
```
|
||
|
||
**对比度硬规则(v2 无障碍修复)**:
|
||
- 琥珀底 `--accent` 上的文字一律用 `--text-primary`(约 9:1),**禁止白字**(仅 1.9:1,v1 历史错误)
|
||
- 亮底上的琥珀色**文字**(hero 强调字/链接)用 `--accent-ink`,禁止 `--accent` 直接作字色
|
||
- 正文对比度 ≥4.5:1;大字(≥18px bold)≥3:1;placeholder 同样 ≥4.5:1
|
||
|
||
### 1.2 字体系统
|
||
```html
|
||
<!-- index.html(v2 起真实加载,不再裸 fallback) -->
|
||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||
<link href="https://fonts.googleapis.com/css2?family=Nunito:wght@400;600;700;800&display=swap" rel="stylesheet">
|
||
```
|
||
```css
|
||
:root {
|
||
/* Nunito(圆端人文 sans,拉丁/数字)+ 系统 CJK。圆端字形呼应"圆润豆子" */
|
||
--font-sans: "Nunito", "PingFang SC", "Microsoft YaHei", system-ui, sans-serif;
|
||
--font-mono: ui-monospace, "Cascadia Code", Consolas, monospace; /* 色号/尺寸值 */
|
||
|
||
--text-xs: 12px; /* 辅助标签(v1 11px 上调) */
|
||
--text-sm: 13px; /* 次要说明 */
|
||
--text-md: 14px; /* 正文(v1 13px 上调) */
|
||
--text-lg: 18px; /* 卡片标题/弹窗标题 */
|
||
--text-xl: 22px; /* 区块标题 */
|
||
--text-hero: clamp(30px, 4.5vw, 42px); /* Hero H1,响应式 */
|
||
|
||
--weight-regular: 400;
|
||
--weight-medium: 600; /* Nunito 用 600(其 500 存在感弱) */
|
||
--weight-bold: 700;
|
||
--weight-black: 800; /* 仅 Hero H1 与价格数字 */
|
||
}
|
||
```
|
||
- 标题行高 1.15-1.25;正文 1.55-1.65;h1-h3 加 `text-wrap: balance`
|
||
- 中文禁用斜体;hero `<em>` 强调改用 `--accent-ink` + 加粗(v1 的斜体是硬伤)
|
||
|
||
### 1.3 间距 / 圆角 / 阴影
|
||
```css
|
||
:root {
|
||
--space-1: 4px; --space-2: 8px; --space-3: 12px;
|
||
--space-4: 16px; --space-5: 24px; --space-6: 32px; --space-7: 48px;
|
||
|
||
--radius-sm: 8px;
|
||
--radius-md: 10px;
|
||
--radius-lg: 14px; /* 面板/弹窗(更圆润,上限 16 内) */
|
||
--radius-full: 999px;
|
||
|
||
/* 暖调分层阴影(阴影模糊 ≤12px;禁边框+大阴影组合) */
|
||
--shadow-card: 0 1px 2px rgba(31,29,23,.05), 0 2px 8px rgba(31,29,23,.04);
|
||
--shadow-modal: 0 12px 40px rgba(31,29,23,.18), 0 2px 8px rgba(31,29,23,.08);
|
||
--shadow-float: 0 2px 10px rgba(31,29,23,.10);
|
||
}
|
||
```
|
||
|
||
### 1.4 触控 / 焦点 / 动效令牌(v2 新增)
|
||
```css
|
||
:root {
|
||
--touch-min: 44px; /* v1 40 上调(WCAG) */
|
||
--touch-min-sm: 36px;
|
||
|
||
/* 焦点环:所有可交互元素统一 */
|
||
--focus-ring: 0 0 0 3px rgba(237,176,69,.45);
|
||
|
||
/* 动效:只动 transform/opacity;UI 全部 <300ms */
|
||
--ease-out: cubic-bezier(0.23, 1, 0.32, 1);
|
||
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);
|
||
--dur-fast: 150ms; /* 按压/悬停反馈 */
|
||
--dur-med: 220ms; /* 弹窗/下拉进出场 */
|
||
--dur-slow: 300ms; /* 大面板/页面级过渡 */
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 签名质感(v2 新增)
|
||
|
||
### 2.1 Pegboard 圆点纹理(唯一装饰纹理)
|
||
```css
|
||
/* 仅 Hero 区与上传区使用。圆点 = 拼豆底板,产品符号而非随机装饰 */
|
||
.hero {
|
||
background:
|
||
radial-gradient(rgba(209,143,31,0.10) 1.5px, transparent 1.5px) 0 0 / 22px 22px,
|
||
var(--bg-page);
|
||
}
|
||
.upload-zone:hover {
|
||
background:
|
||
radial-gradient(rgba(209,143,31,0.12) 1.5px, transparent 1.5px) 0 0 / 22px 22px,
|
||
var(--bg-hover);
|
||
}
|
||
```
|
||
- 全站其余区域禁止任何纹理/渐变条纹/装饰网格线
|
||
- 图标一律 SVG 图标集(Lucide/Phosphor),禁止 emoji 作图标、禁止手绘涂鸦 SVG
|
||
|
||
---
|
||
|
||
## 3. 交互规范(八态完整版)
|
||
|
||
### 3.0 通用规则
|
||
1. **每个可交互元素必须设计八态**:default / hover / focus / active / disabled / loading / error / success
|
||
2. **焦点环**:`:focus { outline: none }` 必须搭配 `:focus-visible { box-shadow: var(--focus-ring) }`,全站统一
|
||
3. **按压反馈**:所有可按压元素 `:active { transform: scale(0.97) }`
|
||
4. **悬停门控**:hover 效果一律包在 `@media (hover: hover) { ... }` 内(防触屏误触发)
|
||
5. **进出场**:从 `opacity:0 + scale(0.95)` 进入,禁止 `scale(0)`;退场比进场快
|
||
6. **减动效**:全局 `@media (prefers-reduced-motion: reduce)` 下动画/过渡时长归近零
|
||
7. **表单**:label 永远在输入框上方;失焦校验;错误在字段下方并 `aria-describedby` 关联
|
||
8. **弹窗**:ESC + 点遮罩可关;打开时锁 body 滚动;关闭按钮用 SVG 图标(不用文字 ✕)
|
||
|
||
### 3.1 按钮
|
||
```css
|
||
/* 主按钮:琥珀底 + 暖墨字(对比度修复,v1 白字废弃) */
|
||
.btn-primary {
|
||
min-height: var(--touch-min);
|
||
padding: 0 var(--space-5);
|
||
border-radius: var(--radius-md);
|
||
background: var(--accent);
|
||
color: var(--text-primary);
|
||
font-size: var(--text-md); font-weight: var(--weight-bold);
|
||
transition: transform var(--dur-fast) var(--ease-out),
|
||
background var(--dur-fast) ease,
|
||
box-shadow var(--dur-fast) ease;
|
||
}
|
||
@media (hover: hover) {
|
||
.btn-primary:hover:not(:disabled) { background: var(--accent-hover); box-shadow: var(--shadow-float); }
|
||
}
|
||
.btn-primary:active:not(:disabled) { transform: scale(0.97); background: var(--accent-strong); }
|
||
.btn-primary:focus-visible { outline: none; box-shadow: var(--focus-ring); }
|
||
.btn-primary:disabled { background: var(--bg-subtle); color: var(--text-disabled); cursor: not-allowed; }
|
||
```
|
||
- 变体:`.btn-secondary`(暖白底+边框,hover 边框转琥珀)/ `.btn-ghost`(无底无框,hover 背景 subtle)/ `.btn-danger`(--danger 底白字)
|
||
- loading 态:14px 双边框 spinner 旋转 0.7s linear,文字保持
|
||
- 按钮文案 = 动词 + 宾语("登录豆仓"/"生成图纸"/"去支付")
|
||
|
||
### 3.2 输入框
|
||
```css
|
||
.input {
|
||
width: 100%; min-height: var(--touch-min);
|
||
padding: 0 var(--space-4);
|
||
border: 1.5px solid var(--border-strong);
|
||
border-radius: var(--radius-md);
|
||
background: var(--bg-card);
|
||
font-size: var(--text-md); color: var(--text-primary);
|
||
transition: border-color var(--dur-fast) ease, box-shadow var(--dur-fast) ease;
|
||
}
|
||
.input::placeholder { color: var(--text-disabled); }
|
||
.input:focus { outline: none; border-color: var(--accent); box-shadow: var(--focus-ring); }
|
||
.input--error { border-color: var(--danger); background: var(--danger-soft); }
|
||
```
|
||
|
||
### 3.3 弹窗
|
||
```css
|
||
.modal-mask {
|
||
position: fixed; inset: 0; z-index: 200;
|
||
background: rgba(31,29,23,.45);
|
||
display: grid; place-items: center; padding: var(--space-4);
|
||
animation: mask-in var(--dur-med) ease both;
|
||
}
|
||
.modal {
|
||
width: 100%; max-width: 400px;
|
||
background: var(--bg-card);
|
||
border-radius: var(--radius-lg);
|
||
box-shadow: var(--shadow-modal);
|
||
padding: var(--space-6) var(--space-5) var(--space-5);
|
||
transform-origin: center; /* 弹窗保持中心缩放 */
|
||
animation: modal-in var(--dur-med) var(--ease-out) both;
|
||
}
|
||
@keyframes mask-in { from { opacity: 0; } }
|
||
@keyframes modal-in { from { opacity: 0; transform: scale(0.95) translateY(8px); } }
|
||
```
|
||
- 结构:标题(lg bold)→ 说明(sm secondary)→ 表单 → 主按钮(通栏)→ 切换链接
|
||
- 登录/注册切换用 150ms 淡入淡出,不做滑动
|
||
|
||
### 3.4 上传框
|
||
| 状态 | 样式 |
|
||
|---|---|
|
||
| idle | 1.5px 虚线边框 + pegboard 纹理 + `+`(SVG 图标) |
|
||
| hover | 边框琥珀 + 纹理加深 + `translateY(-1px)` |
|
||
| loading | spinner + `图片处理中…` |
|
||
| error | 红边 + 错误文案 |
|
||
| 成功 | 缩略图 + 文件名 + 重置按钮 |
|
||
|
||
### 3.5 Toggle 开关
|
||
- 轨道 40x22,knob 16px;开启 `--accent` 底
|
||
- `transition: transform 180ms var(--ease-out), background 180ms ease`
|
||
|
||
### 3.6 导航
|
||
- 高 60px sticky,暖白底 + 底边框
|
||
- 链接 hover:颜色加深 + 底部 2px 琥珀短线 `scaleX(0)→1` 淡入
|
||
- 激活态:`--accent-ink` 字色 + 短线常驻
|
||
- 品牌块 `P`:琥珀底暖墨字(对比度同步修复)
|
||
|
||
### 3.7 卡片(套餐/作品)
|
||
- 暖白底 1px 边框 + `--shadow-card`
|
||
- hover(门控内):`translateY(-2px)` + `--shadow-float`
|
||
- 推荐卡:2px `--accent` 边框 + 角标;禁止第三种强调手段叠加
|
||
- 圆角 ≤14px;**禁止嵌套卡片**
|
||
|
||
### 3.8 列表进场(豆仓/图纸库/Showcase)
|
||
- 卡片 stagger 进场:`opacity 0→1 + translateY(8px)→0`,每项延迟 40ms,单项 ≤300ms
|
||
- 仅首次挂载播放;翻页/筛选不重播
|
||
|
||
### 3.9 反AI味禁令(本项目落地)
|
||
- 禁:侧边色条卡片、渐变文字、玻璃拟态、三等分同构卡片阵列、每节 eyebrow、01/02 编号脚手架
|
||
- 禁:`—`(em-dash)出现在任何 UI 文案;分隔用空格/竖线/换行
|
||
- 禁:纯黑 `#000`/纯白 `#fff`(用暖墨/暖白)
|
||
- 禁:`border-radius: 24px+` 的过度圆角;卡片上限 14px
|
||
- 禁:边框+大阴影(≥16px 模糊)同时出现在一个元素上
|
||
|
||
---
|
||
|
||
## 4. 落地映射(v2 实施指引)
|
||
|
||
| 现有类 | 处置 |
|
||
|---|---|
|
||
| `styles.css :root` | 按 §1 全量替换 token(保留 --grid-* 不动) |
|
||
| `.pass-cta / .regen-btn / .download-btn / .redeem-btn / .mobile-cta-btn` | 统一收敛到 `.btn-primary` 规格(琥珀底暖墨字) |
|
||
| `.modal / .modal-mask` | 按 §3.3 加进出场动画 |
|
||
| `AuthModal.tsx`(bd-* + 内联样式) | 重写:换用设计系统类,去内联样式/紫色 fallback,加 loading spinner + SVG 关闭图标 |
|
||
| `index.html` | 加 Nunito 字体链接 |
|
||
| `.hero` | 加 pegboard 纹理;`<em>` 去斜体改 `--accent-ink` 加粗 |
|
||
| `.nav-link` | hover 短线 scaleX 动效 |
|
||
| 全局 | 追加 focus-visible 环、prefers-reduced-motion、hover 门控 |
|
||
|
||
**范围外(保持不动)**:图纸导出规范(§5 v1 文档)、后端、i18n 文案键名、路由结构。
|
||
|
||
---
|
||
|
||
## 5. 首页布局骨架(承接 v1 §2,未变更)
|
||
|
||
```
|
||
┌────────────────────────────────────────────┐
|
||
│ NAV: [P] PERLER LAB | 图片转拼豆 | AI拼豆专区[PRO] | 色号表 | 我的豆仓 | 语言 | 代理合作 | 状态徽标 │
|
||
├────────────────────────────────────────────┤
|
||
│ HERO: IMAGE TO BEADS(pegboard 圆点纹理底) │
|
||
│ 把喜欢的图片,变成一颗颗拼豆。 │
|
||
├────────────────────────────────────────────┤
|
||
│ DOWNLOAD PASS: AI生成权益 | 3档套餐卡片 + CTA │
|
||
├───────────────────┬──────────┬─────────────┤
|
||
│ 01 生成设置 │ 02 实时预览│ 03 MARD备料 │
|
||
├───────────────────┴──────────┴─────────────┤
|
||
│ FOOTER │
|
||
└────────────────────────────────────────────┘
|
||
```
|
||
- 页面最大宽 1280px 居中;桌面三栏 `320px 1fr 280px; gap 16px`
|
||
- 768-1023px 两栏(备料下移);≤767px 单栏 + 底部固定 CTA 条
|
||
- NAV 高 60px(v2)、sticky、暖白底 + 底边框
|
||
|
||
## 6. AI 专区页骨架(承接 v1 §4,未变更)
|
||
|
||
```
|
||
NAV (chibi 版) → BEAD HERO → BEAD BUILDER:
|
||
01 选择拼豆大类[风景/人物/宠物/物品/食物] + 细分三选一
|
||
02 图纸格数 48/64/80/96 03 最大颜色数 16/24/32/40
|
||
04 主体构图(三选一) 05 细节提示词(标签多选≤5 + 文本域 + 参考图)
|
||
→ 生成前确认 → PROMISE → FOOTER
|
||
```
|
||
- 选中态:琥珀底暖墨字(v2 对比度规则);未选:暖白底边框
|
||
|
||
## 7. 图纸导出规范(承接 v1 §5,逐字未变更 —— drawPattern.ts 维护依据)
|
||
|
||
### 7.1 画布布局
|
||
```
|
||
标题: {作品名} · {N}×{N} · MARD 拼豆图纸 (24px bold, 左边距 80px)
|
||
网格: N×N, gridSize≥96 用 22px/格 否则 28px/格, 起点 (80,80)
|
||
每格: 豆圆(半径0.42格) + 色号
|
||
标尺: 每10格粗线+数字, 每5格中粗线
|
||
MARD 备豆清单: 共{总}颗 · {颜色数}种 · 建议多备10% (约{1.1×总}颗)
|
||
[色块]{色号}{颗数} 每行3-4个(>1800px 用3列否则4列)
|
||
```
|
||
|
||
### 7.2 网格线(对应 token --grid-*)
|
||
| 类型 | 颜色 | 线宽 |
|
||
|---|---|---|
|
||
| 每 10 格 | `rgba(20,20,18,.78)` | 2.6px + 粗体标号 |
|
||
| 每 5 格 | `rgba(30,30,28,.45)` | 1.7px |
|
||
| 其余 | `rgba(30,30,28,.16)` | 1px |
|
||
|
||
### 7.3 色号文字对比度
|
||
- `lab[0] < 52`(深色底)→ 白字 `#fff`;否则 → 深字 `#171713`(导出画布专用,不受 UI token 影响)
|
||
- 字号:`max(7px, 0.28 × 单元格)`,加粗居中
|
||
|
||
### 7.4 文件名
|
||
`{作品名}-{N}x{N}-MARD拼豆图纸.png`
|
||
|
||
## 8. 响应式断点(承接 v1 §6,未变更)
|
||
|
||
| 断点 | 行为 |
|
||
|---|---|
|
||
| ≥ 1024px | 桌面三栏布局 |
|
||
| 768–1023px | 两栏(设置+预览),备料清单下移 |
|
||
| ≤ 767px | 单栏纵向;NAV 简化;底部固定购买/兑换 CTA;触控 ≥ 44px(v2 上调) |
|