15 KiB
15 KiB
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 色彩系统
: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 字体系统
<!-- 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">
: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 间距 / 圆角 / 阴影
: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 新增)
: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 圆点纹理(唯一装饰纹理)
/* 仅 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 通用规则
- 每个可交互元素必须设计八态:default / hover / focus / active / disabled / loading / error / success
- 焦点环:
:focus { outline: none }必须搭配:focus-visible { box-shadow: var(--focus-ring) },全站统一 - 按压反馈:所有可按压元素
:active { transform: scale(0.97) } - 悬停门控:hover 效果一律包在
@media (hover: hover) { ... }内(防触屏误触发) - 进出场:从
opacity:0 + scale(0.95)进入,禁止scale(0);退场比进场快 - 减动效:全局
@media (prefers-reduced-motion: reduce)下动画/过渡时长归近零 - 表单:label 永远在输入框上方;失焦校验;错误在字段下方并
aria-describedby关联 - 弹窗:ESC + 点遮罩可关;打开时锁 body 滚动;关闭按钮用 SVG 图标(不用文字 ✕)
3.1 按钮
/* 主按钮:琥珀底 + 暖墨字(对比度修复,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 输入框
.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 弹窗
.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 上调) |