Files

349 lines
15 KiB
Markdown
Raw Permalink 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)
> 版本: 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 上调) |