Files
perler-lab/docs/DESIGN.md
T
Sisyphus b7e94d8a91 ui: DESIGN.md v2.0 温暖手作重构第一阶段
- token 升级: Nunito 字体真实加载、字号上调、暖调分层阴影、动效/焦点环令牌
- 无障碍修复: 琥珀底白字全部改暖墨字(1.9:1→9:1)、focus-visible 焦点环、44px 触控
- AuthModal 重写: 去内联样式/bd-*/紫色fallback,接入设计系统,加 spinner/SVG关闭/ESC
- 弹窗进出场动画、按钮八态收敛、hover 门控、prefers-reduced-motion
- Hero pegboard 纹理(签名元素)、导航琥珀短线动效
- pages.css 移除 .pl-page 作用域旧 token 重定义(修复豆仓/展示页 token 漂移)
2026-08-25 11:32:55 +08:00

12 KiB
Raw Blame History

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 通用规则

  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 按钮

/* 主按钮:琥珀底 + 暖墨字(对比度修复,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 文案键名、路由结构。