Commit Graph

2 Commits (5ce8f4a207c920e736989aaa31f9a67355fb7bc6)

Author SHA1 Message Date
mula.liu 5f294c9ccb 补上 R8 这道闸并让文档说真话:classaudit 第五道检查 + README/工程规范回到 antd 版现状
症状:README 还在讲 metrics.ts / palette.ts / css-vars.ts 三把尺子、33 组 ComponentToken、
--ctl-h* 变量、ToolButton/IconSpot/MenuRow 这些本轮已经删掉的东西;R8「谁可以 import 'antd'」
只写在文档里,没有任何机器拦着——文档一漂,规范就退化成建议。

做法:
- classaudit.mjs 加第 5 道闸:`from 'antd'` 逐行扫,白名单只有 theme/ · app/ ·
  components/{ui,forms} · stores/notice.ts,退出码并入违规总数;已反向验证
  (pages/Account.tsx 临时插一行 import 后探针点名并报 exit=1,撤掉复绿)。
- README 分层表与两段口径重写:theme/ 只剩 antd.ts(buildAntdTheme + applyRootVars + HEADER_HEIGHT)、
  styles/ 的 --radius-* 只是 --ant-* 的别名、裸 <button> 白名单换成 CUSTOM_SURFACES 真实的 7 个文件、
  两道探针的描述换成它们各自真正查的东西(五道 / 八类)。
- 工程规范:theme/ 目录行、--ctl-h 档位、§0.5 与「§6 自绘区边界」这些失效指针改到
  R8 / §1 四层分工 / §5.2 自定义表面族;stores 补 recording;app/ 行写明 nav.tsx 是两级菜单唯一来源。
- kit 注释里的 §0.6 指针改指 R8 与 §5.2(那一节已随手写规范退场)。

验收:typecheck + build 通过;classaudit 五道全绿 exit=0;visualcheck 1440/768/430 × dark/light
(含登录页在登录前先量一趟)console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 12:59:59 +08:00
mula.liu 62c356952c UI 规范与两道常驻探针同步到 antd 版:classaudit.mjs + visualcheck.py,旧探针归档
docs/UI规范.md 按 antd 重写(16 章 / 十四条硬规矩 R1–R14):
- §6 外壳(Header 56 + 两级 Sider + Content)、内容页不做多页签、页签只在页面内部,
  Tabs vs ViewSwitch 的判据;§9.3 值型控件的宽度归控件而非「标签+控件」+ nex-prose-value 豁免登记;
  §10 下拉面板「至少同宽」与折行、标记类全集 18 只;§5.1 按钮上的字必须整颗放得下;
- §15 两道闸的判定口径写死,退出码都必须为 0。

scripts/ui/classaudit.mjs:四道判定(死类名 / 绕过登记表的图标 import / 裸 <button> /
浮层底部动作口径),基线 3912 个候选,必须在仓库根跑。
scripts/ui/visualcheck.py:登录 → 逐路由 × 逐档宽度 × 明暗截图,钉死八件事——
:root 尺子、行高、侧栏选中态(窄屏折叠时展开浮层复核二级项)、路由没被 path:'*' 静默吞掉、
display utility 被组件样式盖掉(R13 闸门)、横向溢出与切字、
控件标签**含下拉当前值**不许被省略号截断(散文型选项值按 nex-prose-value 放行)、
4xx/5xx 按 URL 分诊(素材缺文件单独计数,接口 404 点名发出它的路由)。
新增的 4xx/5xx 一条顺带治好了时间线 / 交付页「空状态对、代价是两条 404」的假绿。

旧的 audit.py / metrics.py / vocab.py 量的是已删的那套自造尺子,移进 scripts/ui/legacy/ 并标注作废。
README 与 docs/工程规范.md 同步:theme/ 只剩 antd.ts 一把尺子,导航与页签口径改为两级菜单 + 内部页签。

本轮验证:tsc 0 错 / classaudit 四道全 0 / vite build 通过 /
visualcheck 两轮各 104 张(1440·992·768·430 × dark·light,空项目与数据齐全项目各一轮)
console 0 条、HTTP 失败 0 条、断言 0 条。
2026-11-03 12:42:28 +08:00