feat(design): design/ 真相源 + 防漂移静态闸(#25)

真相源整固:
- design/index.html 登记簿:token 色板(var() 实时渲染)/ 组件登记卡 /
  图标与跨端映射 / guidelines / ui_kits 单一入口,check-ds 强制登记
- design/icons.js 图标单源(Lucide 线条)+ icon-map.json 跨端映射表
  (web/iOS/Android 三列,iOS 12 个 SF Symbol 全部收编登记)
- components/core/Icon.jsx 单源图标渲染器;MicBar/RecognitionOverlay 接入
- tokens 新增 --brand-wechat(-press)(微信官方绿)与 --overlay-wave
- fonts.css 弃 Google Fonts CDN,Outfit 可变字体自托管
  (assets/outfit-latin.woff2,40KB;中国网络下 CDN 不可用会卡字体)
- design/serve.mjs 零依赖预览服务器(登记簿与原型评审入口)

codegen 强化(export-tokens.mjs):
- 产物直写消费位置:ios/dudu/Shared/DuduTheme.swift、
  android/.../design/DuduTheme.kt——删除 design-pipeline/generated/
  中间拷贝层(此前 app 内是手工拷贝,--check 守不到真实消费文件已漂移)
- 新增 web/tokens.css 产物(custom props 透传 + Outfit data URI 内嵌)
- tokens 文件遍历排序,产物确定性

存量收编:
- desktop:三个窗口内联 SVG → Icon 组件;tray 裸 rgba → token+opacity
- Android:LoginScreen 微信绿常量 → DuduPalette.brandWechat(Press),
  Color.White → textOnAccent
- 官网 web/index.html:接入 tokens.css,34 处硬编码 hex 全部 var() 化;
  深色板块(metrics/cta/footer)改挂 data-theme="dark" 复用 dark 令牌;
  移除 Google Fonts CDN
- design 包内 8 处裸色:微信绿 token 化、装饰色 ds-ignore 白名单、
  同值色改 var() 引用

防漂移闸(零依赖 Node):
- design-pipeline/check-ds.mjs:真相源自检 7 道(dark⊆light / var 链 /
  裸色∈tokens 值集 / 组件登记 / icons 唯一 / icon-map 双向同集 / 禁 emoji)
- design-pipeline/check-code.mjs:代码侧单源(desktop 禁字面色+内联 path /
  iOS 禁字面色+SF Symbol 同集 / Android 禁 Color(0x / web 禁字面色),
  ds-ignore 行级豁免制
- .githooks/pre-commit(启用:git config core.hooksPath .githooks)
- CI design job 扩展为三道闸全绿
- 反向验证通过:注入裸色/孤儿 token/未登记组件/未登记 symbol 均被拦截

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-11 00:05:22 +08:00
parent 4aec0ef6e9
commit 208d0cda12
36 changed files with 1014 additions and 494 deletions
+37 -6
View File
@@ -3,9 +3,11 @@
* export-tokens.mjs — 设计令牌导出管线(零依赖,Node >= 18
*
* 解析 design/tokens/*.css 的 CSS 自定义属性(:root = light[data-theme="dark"] = dark),
* 生成移动端原生主题文件,保证三端令牌单一来源
* generated/ios/DuduTheme.swift — Color(light/dark 动态) + 尺寸/字号常量
* generated/android/DuduTheme.kt — Compose Color/Dp/Sp 常量(Light/Dark 两组
* 生成各端主题产物并直写消费位置(无中间拷贝层,--check 守的即真实消费文件)
* ios/dudu/Shared/DuduTheme.swift — Color(light/dark 动态) + 尺寸常量
* android/app/src/main/java/app/dudu/design/DuduTheme.kt — Compose Color/Dp 常量(Light/Dark
* web/tokens.css — 官网令牌层(custom props 原样透传 +
* Outfit 字体 data URI 内嵌,单文件自包含)
*
* 用法:node design-pipeline/export-tokens.mjs [--check]
* --check CI 校验模式:重新生成并与已提交产物比对,不一致退出 1
@@ -17,8 +19,10 @@ import { fileURLToPath } from 'node:url';
const __dir = dirname(fileURLToPath(import.meta.url));
const TOKENS_DIR = resolve(__dir, '../design/tokens');
const OUT_IOS = resolve(__dir, 'generated/ios/DuduTheme.swift');
const OUT_ANDROID = resolve(__dir, 'generated/android/DuduTheme.kt');
const OUT_IOS = resolve(__dir, '../ios/dudu/Shared/DuduTheme.swift');
const OUT_ANDROID = resolve(__dir, '../android/app/src/main/java/app/dudu/design/DuduTheme.kt');
const OUT_WEB = resolve(__dir, '../web/tokens.css');
const FONT_WOFF2 = resolve(__dir, '../design/assets/outfit-latin.woff2');
// ─── 解析 ────────────────────────────────────────────────────────────────────
@@ -37,7 +41,7 @@ function parseBlock(css, selector) {
return out;
}
const files = readdirSync(TOKENS_DIR).filter((f) => f.endsWith('.css'));
const files = readdirSync(TOKENS_DIR).filter((f) => f.endsWith('.css')).sort();
let light = {}, dark = {};
for (const f of files) {
const css = readFileSync(resolve(TOKENS_DIR, f), 'utf8');
@@ -166,11 +170,38 @@ ${dims}
`;
}
// ─── 生成 Web(官网令牌层)───────────────────────────────────────────────────
function web() {
const props = (scope) =>
Object.entries(scope).map(([k, v]) => ` --${k}: ${v};`).join('\n');
const fontB64 = readFileSync(FONT_WOFF2).toString('base64');
return `/* 自动生成 — 请勿手改。来源 design/tokens/*.css + assets/outfit-latin.woff2
重新生成:node design-pipeline/export-tokens.mjs */
@font-face {
font-family: 'Outfit';
font-style: normal;
font-weight: 400 700;
font-display: swap;
src: url(data:font/woff2;base64,${fontB64}) format('woff2');
}
:root {
${props(light)}
}
[data-theme="dark"] {
${props(dark)}
}
`;
}
// ─── 输出 / 校验 ─────────────────────────────────────────────────────────────
const outputs = [
[OUT_IOS, swift()],
[OUT_ANDROID, kotlin()],
[OUT_WEB, web()],
];
const check = process.argv.includes('--check');