Files

15 KiB
Raw Permalink 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 文案键名、路由结构。


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 上调)