refactor: 原型迁移 .superpowers/prototype → design/prototype(与 CONTRACT 同目录)
Design Source Checks / design-source (push) Failing after 14m23s

- git mv 全目录(历史保留);.gitignore 收敛为整个 .superpowers/ 忽略
- 全仓 16 处引用同步(CI checks.yml / l1-sync / screens.mjs / hooks /
  CLAUDE.md / CONTRACT / SSR 模板注释 / docs / web 注释)
- 修 pre-commit 路径正则残留;5180 评审服务已切新路径
- 验证:check-ds 12 道 / l1-sync 6 道 / fidelity 抽查全过

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
This commit is contained in:
wangjia
2026-07-07 18:47:31 +08:00
parent d1b7e8e2e9
commit 05203a9b5b
79 changed files with 46 additions and 48 deletions
+2 -2
View File
@@ -274,7 +274,7 @@
</div>
<h3>3.3 ds 设计系统(单一真相源)</h3>
<p class="gdesc">UI 的真相源是原型 <code>.superpowers/prototype/</code>tokens + <code>atoms.css</code>);Flutter 侧一对一镜像,屏只组合 ds 组件、不自己堆样式。令牌层由 <code>lib/core/theme/token_source/tokens.css</code> codegen 生成 <code>app_tokens.g.dart / app_dims.g.dart / app_chrome.g.dart</code>——改样式改源后重跑脚本,<b>禁止手改 .g 文件、禁止硬编码色值</b></p>
<p class="gdesc">UI 的真相源是原型 <code>design/prototype/</code>tokens + <code>atoms.css</code>);Flutter 侧一对一镜像,屏只组合 ds 组件、不自己堆样式。令牌层由 <code>lib/core/theme/token_source/tokens.css</code> codegen 生成 <code>app_tokens.g.dart / app_dims.g.dart / app_chrome.g.dart</code>——改样式改源后重跑脚本,<b>禁止手改 .g 文件、禁止硬编码色值</b></p>
<div class="card"><table>
<thead><tr><th style="width:30%">widgets/ds/ 文件</th><th>镜像对象</th></tr></thead>
<tbody>
@@ -292,7 +292,7 @@
<h3>3.4 golden × 3 主题 + fidelity 像素闸</h3>
<ul style="font-size:13px">
<li><b>golden</b><code>client/test/golden/*_golden_test.dart</code> 对每屏 × 三主题(a/b/c)出基准图 <code>test/golden/goldens/&lt;prefix&gt;_&lt;theme&gt;.png</code>;更新用 <code>flutter test --update-goldens</code></li>
<li><b>闸机 2 — fidelity</b><code>tools/fidelity.mjs</code><b>原型截图当基准</b>Playwright 截 <code>.superpowers/prototype/screens/*.html</code>,注入 Noto Sans SC 统一字体)与 Flutter golden 做 pixelmatch diff,超逐屏校准阈值即 exit 1;支持 zones 分区阈值抓局部错位。屏注册表在 <code>tools/screens.mjs</code>fidelity 与人工目检 <code>tools/ds-compare.mjs</code> 共用)。</li>
<li><b>闸机 2 — fidelity</b><code>tools/fidelity.mjs</code><b>原型截图当基准</b>Playwright 截 <code>design/prototype/screens/*.html</code>,注入 Noto Sans SC 统一字体)与 Flutter golden 做 pixelmatch diff,超逐屏校准阈值即 exit 1;支持 zones 分区阈值抓局部错位。屏注册表在 <code>tools/screens.mjs</code>fidelity 与人工目检 <code>tools/ds-compare.mjs</code> 共用)。</li>
</ul>
<pre><code>cd client && flutter test --update-goldens test/golden/inventory_list_golden_test.dart
node tools/fidelity.mjs inventory # 仓库根运行;--themes a,b,c--update 刷新原型基准</code></pre>