Commit Graph

9 Commits (3404d7874fe1ff457f3d70bb7ccddcb2fa33b852)

Author SHA1 Message Date
mula.liu be07d9d712 闸门跟着 antd 布局层重新校准:三处检查不再说假话
症状:布局层搬进 antd(Flex / Drawer actions / Tag)之后,四道闸里冒出一批
      「查的是老口径」的误报,逼得人想给闸门加豁免——那是要把闸门关掉的前兆。
      ① visualcheck 侧栏探针只认 .ant-menu-item-selected,可菜单折叠时高亮的是
         父级 SubMenu 标题,antd 给它的是透明底 + colorPrimary(正确长相),
         拿选中项的 controlItemBgActive 去比就必然红:430 档
         projects/13/{delivery,dispatch,timeline} 三页连续报假故障。
      ② 同一支脚本把「行高为 0」当塌陷,而 antd 的图标复位本来就把 .anticon
         写成 line-height:0(盒子由 font-size 撑开),图标一旦带上 text-* 就中枪。
      ③ classaudit 第 4 条用 \b(actions|footer)=\{ 找浮层底部动作条,
         PageHead actions(页头视图开关)和 Toolbar actions(勾选后的批量条)
         名字撞车被一起吞进来,「最后一颗必须是主行动」判到了不该管的地方。
      ④ Tailwind 词表没有 Flex 的 wrap / space-between 与 cursor 的 not-allowed,
         这三个 props 值天天出现,逐行切词分不清引号内外,只能点名放行。
做法:①探针多输出一个 kind(item / submenu),Python 侧只在 kind=item 时比色板,
        submenu 交给原有的浮层复核分支;②行高断言排除 .anticon;
      ③先定位 prop 挂在哪个元素上,只有 Drawer / Modal(含 kit 转发的 AntDrawer /
        AntModal)才算底部动作条——实测全站 25 处里受管 12 处,另 12 处归 §7 控件栏;
      ④三个词进白名单,并在注释里写清「当类名写出来仍是笔误」;
      顺带删掉临时探针 nexprobe.cjs / nexprobe.tsx(能力已并进 visualcheck),
      新增 scripts/ui/helpshots.py:手册的 12 张插图是静态 PNG,不参与构建,
      UI 每换一次皮肤就整批过期,拍摄口径(视口/dpr/主题/主角项目/先收概况)写进脚本头。
为什么:闸门报一次假,人就多写一次豁免;豁免写满,真故障就混在里面没人看。
      所以这一轮修的是检查本身的口径,而不是给页面加特例。
2026-11-03 17:02:03 +08:00
mula.liu 5ce8f4a207 检查点:布局层迁入 antd 原生(Panel/Controls/grid/Input + app.css 清理) 2026-11-03 14:37:22 +08:00
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 85a95a9ba3 登录页接入常驻探针并改用 kit 用词:「页签」一词收口到页面内部
产品口径落地复查(内容页不做多 Tab / 菜单只到两级 / 页签=页面内部页面)时发现两处该修的:

1) 常驻探针压根量不到登录页:登录之后再访问 /login 会被守卫回落首页,
   第 4 条的 URL 比对只能报「路由不存在」(实测退出码 1),而默认路由表里
   干脆没有 /login。改成**登录之前**先按 逐档宽度 × 明暗把 chromeless 的
   登录页量一遍并截图,尺子检查从主循环抽成 audit() 由两处共用(同一份断言,
   不给登录页开第二条口径);/login 进默认路由表,主循环跳过它。
   实测 430 / 768 / 1440 × 明暗:断言 0、console 0、HTTP 失败 0。
2) 登录页还留着手写用词:两个 <label><span> 字段换成 FieldBlock(标签在上,
   与全站同尺),三条自己拼「描边 + 底色」的提示条换成 Notice。截图逐像素对过,
   版面没动,只是不再各写一份。

顺带把词收口:ProjectDetail 注释里的「各业务页签」改成「各业务子页」——
「页签」从本轮起只指页面内部页签(§6.4),外壳没有页签条(§6.1);
§6 表格里 Header 那一行按真实三块(折叠开关+品牌簇 / PipelineConsole / 状态+手册+主题+UserMenu)重写,
§15.2 登记探针的登录前置一趟。
2026-11-03 12:52:42 +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
mula.liu 4521c9f926 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。
用户连着三轮指出「字段标题、控件不对齐」「下拉控件的样式不对」,最后点名技术栈。真正的病不在
antd 还是 Radix,而在同一件事有三千种写法:左导航内边距一页 11px 一页 12px,白名单要从页面
className 上抄切片才能命中。上一轮 Radix 只外包了行为,皮肤仍由 30 多个页面自己拼,且没有任何
机制阻止分叉长回来。这一轮改的是词汇表:页面只准说业务,控件怎么长由 kit 层 + 一份令牌说了算。

底座(读数见报告 26.2):react 19.3.1→18.3.1、react-router-dom 7.18.5→6.30.6(点名为 18/6,是
降级,代价见 26.6)、新增 antd 5.29.3 + @ant-design/icons 6.3.4,@radix-ui/* 5 包与
class-variance-authority 清零;zustand/vite/tailwindcss 4.3.3 不变,Tailwind 留作皮肤 utility。
删 components/primitives/(11 文件 1133 行)与 styles/{base,tokens}.css;净 +488 行不是「少一千行」,
是同样面积的代码从三十个页面挪进两个目录——省的不是字节,是分叉次数。

新增:
- app/providers.tsx:ConfigProvider + <App> 唯一入口(主题、zh_CN、button.autoInsertSpace:false、cssVar),
  命令式 message/notification/modal 挂 antdApi 供 stores/ 使用;React Router 的 v7 future flag 一处收口。
- theme/{palette,antd,css-vars,metrics}.ts:数字只有一个来源 metrics.ts → 同时喂 antd ThemeConfig 与
  --ctl-h-*/--radius-*/--text-*,antd 控件与自绘区读同一把尺子,结构上长不歪了。
- components/ui/{Input,Checkbox,Menu,Rail,Tile,Overlay,field-labels};lib/layers.ts(Esc 先看有没有 antd
  浮层压着,否则分镜检查器里关一个下拉整层抽屉一起没)、lib/ref.ts、hooks/use-narrow.ts(触摸档必须
  同时喂给 antd 的 JS 数字,否则 560/430 一屏混着 31/38 与 36/40 两把尺子——首跑量出的 61 项就这么来的)。
- styles/app.css 接替 base+tokens,只留元素默认值与三处必须靠 CSS 的 antd 集成。
- scripts/ui/ 三件套首次入库:audit.py 七项机器判据 × 14 视图、vocab.py 六条源码词汇表闸、metrics.py。

修掉四个探针全绿也看不见的静默 bug:
1) 探针会假绿:浮层用例找不到抽屉时兜底 scope=main 把页面重量一遍,分镜「检查器」29 字段/57 输入
   /35 按钮(在 main 外面的 aside 里)一条都没测过。
2) Select 选中 null 回显成灰色 placeholder:antd 把 null 当无值,而「不绑定/无台词/未指定」的真实值
   就是 null(接口收 null,10 处)。kit 内折哨兵 nex-null,出入口各折一次,页面 API 一字未改。
3) JSX 子节点上的 /* */ 不是注释而是文本,挂在应用外壳之上把整站下推约 30px;移到 JSX 外并立词汇表规则 6。
4) 抽屉可以整块开在屏幕外面:Overlay 用 getContainer={false} 让 antd 就地渲染,rootStyle 的 absolute
   于是相对文档定位——入口按钮在折叠线以下时抽屉 y=-scrollY(1440 lib_edit 只剩 201px,430 assets_gen
   完全不可见,用户点了「AI 生成」像没反应)。改 fixed 后四档 10 个浮层全部 y=0 完整可见。为此给 audit
   加第 7 项判据 surface(浮层完整落在视口内 + 中心点 elementFromPoint 命中自己),反向验证:改回
   absolute 后 430 下 4 红 exit=1;判据取「有交集」太松(42px 也算过),收紧为「完整在视口内」才对。

验收(复跑读数):audit --only page 1440/1280/900 × 明暗 6 组 84 行视图全 0、exit=0;--only overlay
1440/900/560/430 × 明暗 8 组 exit=0,surface 80/80 绿,72 个下拉样本 popW==trigW、inViewport、
optClipped=false、popOnTop=false 计 0;vocab 85 文件/皮肤常量 79(账实相符)exit=0;
npm run build(tsc+vite)exit=0(ui chunk 881.94 kB / gzip 278.63);probe_nullopt CLEAN、probe_secretref PASS。

文档同步:UI规范 §8 判据清单五项→七项(补 surface)、§1.3 新增「抽屉可以整块开在屏幕外面」;
工程规范 §1.1 体检器职责改为 10 浮层 × 4 宽度 × 七项;README 六项→七项判据;报告补第二十六章
26.1–26.9(选型换向、版本读数、四条根因、改法、逐项验收、降级代价、注释泄漏、仍未做、抽屉开在屏外)。
2026-11-02 21:57:13 +08:00
mula.liu 20e8f19eca 前端统一收尾:图文手册从 public/help.html 搬成站内 React+Tailwind 页面 /help,SPA 深链回落与未知接口 404 拆成纯函数补自检,新增 ErrorBoundary 兜住分包加载失败 2026-11-01 19:25:47 +08:00
mula.liu 816cdc25b7 修复 media/ 忽略规则误伤前端组件:补回 components/media 六个组件、部署体检增加前端源码完整性计数 2026-11-01 18:59:46 +08:00
mula.liu 9467e1bb97 v 0.1.0 2026-11-01 16:18:07 +08:00