# 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 ``` ```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 `` 强调改用 `--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 纹理;`` 去斜体改 `--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 上调) |