Commit Graph

70 Commits (main)

Author SHA1 Message Date
mula.liu ee17358182 feat(前端): 阶段 9–45 呈现层落地——环节资产同构、图标两级表、kit 分包与四处交互收口
这一提交是 NEX 阶段 9–45 里所有**业务呈现层**的落地(不含探针与文档)。
三把尺子里只碰了 `styles/index.css`/`styles/app.css`,`theme/antd.ts` 一字未动;
不升级、不换库、不引入第二套 UI 组件包,业务页仍然不直接 import antd(R8)。

主线:
- 环节「资产管理」与平台资产库呈现层同构(阶段 44):`pages/project/Library.tsx`
  换成与 `pages/AssetLibrary.tsx` 同一套 kit 骨架——PageHead / StatGrid /
  Tabs+counts / Panel / Ctlbar `cols={5}` / ChipBar / Grid+Tile pick / MediaThumb /
  Drawer;摘要尺上收为 `Tile.TILE_SUMMARY` 一处定义,两页共用,不再各写各的。
  在册偏离见 `docs/NEX-对照与例外.md` E11(本页接口不收 `page`/`page_size`,
  硬造前端切片是假分页;筛选条缺平台那两颗「状态」「排序」下拉,因为环节接口
  根本不收 `status`/`sort`,补它们属于功能改动——待授权)。
- 项目总控台去掉「展开/收拢执行过程」那颗文字胶囊(阶段 44):折叠行本身
  就是可点的语义元素,胶囊是同一动作的第二入口。口径写进 `UI规范.md` §13.14。
- 卡片动作收口(阶段 45):项目总览 / 环节资产 / 模型中心三处卡片上的动作
  按钮按 `§5.1.2.1` 的尺子归位(32 档只属于页头与工具条独立动作,卡片内不再
  混挂实底),`Ctlbar` 与 `Fields` 配套。
- 图标:登记表两级拆分落地(阶段 25)——`components/icons/core.ts`
  (首屏外壳可达 54 只)/ `extra.ts`(只有懒页面要 24 只)/ `_kit.ts`(不含图形)/
  `index.ts` 退化为只转发 core 的桶;边界由 `classaudit` 附三守。
  `@ant-design/icons` 按嵌套包定价回落到 `^5.6.1`(阶段 26、27)。
- 分包:`vite.config.ts` 一条 `codeSplitting.groups` 只圈我们自己的四个目录
  (components/lib/stores/api),`includeDependenciesRecursively: false` 是关键,
  第三方怎么分块一个字不动。同一把 churn 实验:只改 `Input.tsx` 一个字符串,
  改前 21 块里 20 块改名(用户多下 1 276 kB/gzip 390 kB),改后第三方大块
  1 217 164 B 哈希不变,只有 `kit-*`/`index-*` 换名。
  `frontend/chunk-budget.mjs` 的产物级预算基线 `chunk-budget.json` 随仓库走。
- S-2/S-3/T-1 的收口:图标默认为装饰 + 控件补自然中文名称、antd 语言包根因、
  表单 id 关联新增 `ui/fieldId.ts`、离线告警宿主、交付面与窄屏表等(阶段 9–43 报告逐条)。
- `public/help/*.png` 是 `helpshots.py` 重新拍的 12 张手册插图(此前与实现漂移)。

提交前当场复跑静态四闸:`npm run typecheck` 0、`npm run build` 0(产物哈希与阶段 44
收工读数一字不差:`Library-0Ke7LMGG.js`/`AssetLibrary-DiALYoDN.js`)、
`node scripts/ui/classaudit.mjs` FAMILY 12 族全 0、`node scripts/ui/chunkbudget.mjs` 全 `ok`。
2026-11-12 10:21:29 +08:00
mula.liu cbc645c4e1 perf(交付面): 按 media type 压缩 + 哈希产物长期缓存,后端与 nginx 同一套口径
Bundle 那十几轮量的是**文件字节**(`chunkinfo`),但线上真正过网的是这一层的响应头:
首屏闭包 1 469 kB 里 1 144 kB 是一个带哈希的 JS chunk,不压就是按 raw 发,量好的
gzip 450 kB 白量。补上缺的另一半(阶段 29、30)。

backend/app/main.py:
- `gzip_eligible()` 是唯一的权威名单,只认 media type 不认路径前缀(只压文本,
  mp4 与已压过的图片挡在外面);`ContentTypeGZipMiddleware` 按它决定是否压,
  小于阈值的响应不压(压完加头比原文还大,还多一个 `Vary` 命中率)。
- 中间件顺序是有条件的:压缩层必须**最先**注册,否则 `add_middleware` 把自己插到
  最外层之后,压缩跑到了鉴权外面。
- 交付面缓存:`/assets` 带内容哈希 ⇒ `public, max-age=31536000, immutable`;
  `index.html` 与 history 回落出去的壳 ⇒ `no-cache` 每次回源校验,否则发版后老标签页
  拿着旧壳去引已经不存在的哈希文件,用户看到白屏。

frontend/nginx.conf:反代这一层写同一套口径(注释里点名「权威名单在后端
`app.main.gzip_eligible`,这里这份是兜底」),并补 `gzip_proxied any`——
它管的是**带 `Via` 请求头的请求**(nginx 站在 CDN 后面时),默认 `off` 下直连浏览器
照样压;挂 CDN 时这套压缩不能整块失效。三组合 A/B/C 的实测对账在
`reports/ui_evidence/nex-p30/nginx-ab.log`:后端已压时 nginx 透传不叠第二层,
后端没压时这里兜底压上(A 组合 `/api/projects` 341 909 → 53 333 B 是 nginx 自己压的)。

测试:新增 `backend/tests/test_api_content_gzip.py`,`test_spa_history_fallback.py`
补 `test_asset_delivery_cache_and_gzip`,三条断言各自钉住一个会真实发生的事故
(不压 / 壳不回源 / 小文件也压)。
2026-11-12 10:21:17 +08:00
mula.liu 4adf77b848 fix(可访问性): 图标默认为装饰 · 4 处控件补自然中文名称
@ant-design/icons 每只字形自带 role=img + aria-label=英文字形码,挂在已有文字的
控件里会让读屏把同一个控件报两遍(「upload 导入脚本」「down 导出」)。

- components/icons/index.ts:79 条出口一律套新增的 decorative(),默认 aria-hidden;
  调用方显式给非空 aria-label 时保留 role=img(第 ② 档),显式 aria-hidden={false}
  时尊重调用方(第 ③ 档)。两头都不一刀切。新增 IconClear。
- kit 一处收口给 4 处「图标就是全部语义」的控件补自然中文名,页面 0 改动:
  Tabs more.icon → 更多页签 / SecretInput iconRender → 显示·隐藏密码 /
  Pager itemRender → 上一页·下一页 / SearchInput enterButton+clearIcon → 搜索·清空搜索。
- Select/Dropdown/Collapse 的下拉箭头本就被 antd 包在 aria-hidden 里,InputNumber
  上下键宿主自带 antd 硬编码英文名,两类都不动(动它要改 antd 内部 DOM 或全站 locale)。
- styles/app.css:唯一一处样式。传 enterButton 元素后 antd 给外层加
  .ant-input-search-with-button 并把悬停 z-index 从 1 降到 0,补回 1,悬停像素与改前一致。

DOM 结构、类名、尺寸、颜色、.anticon 选择器一字不变;R15 不受影响。

阶段 8.5.1 · S-2
2026-11-08 17:24:06 +08:00
mula.liu 2821475eac NEX 阶段 8.5·第5项:导航两状态入册 + 当前页对辅助技术可见(aria-current)
批准书 §5 的决策是「保持现有分离设计」,所以**两条状态本身一行代码都没改**:
桌面折叠走 `useLocalStorage`(reload 后 `ls="true"`、侧栏 63 px,实测守住),
移动端抽屉开合走 `useState`(`localStorage` 键集为空、reload 后 `open:false`)。
为什么不合并成一条 Boolean,理由写进 `docs/UI规范.md` §6.2.1:折叠是**偏好**
(用户按住的那把尺子,跨会话有效,丢了每次开机都要重展开),抽屉是**一次性动作**
(读完当前这条就该关掉,持久化会让下次进站内先撞一块挡住正文的板子);
两者生命周期不同,共用一条状态等于让手机用户替桌面用户付账。

顺手关掉本轮实测抓到的真实缺口 AT-2:选中项只有 `.ant-menu-item-selected` 这个类,
`li[role=menuitem]` 上没有 aria-current / aria-selected(rc-menu 只在 role=option 分支写
aria-selected),VoiceOver 因此只报「菜单」不报「当前页面」。补 `currentMark(key)` 给
当前路由那一项写 `aria-current="page"`,并把 `useMemo` 依赖补上 `pathname`
(少一项就会在换页后把标记留在旧项上,选中态与标记同源才谈得上「一致」)。
文件头那句「可达性 Menu 自带,不必再自证」是错的,一并改成实测结论 + 证据路径。

验证:三条路由 + 抽屉内**有且只有当前项**带 `aria-current`,菜单宽度 207 未变(没挤出
新视觉);折叠成图标轨时二级项不渲染 → 折叠档 AT 仍读不到当前页,弹层展开后恢复,
这条边界写进规范并登记 S-4。VoiceOver 是否真播报「当前页面」未复听 → AT-2′。
2026-11-08 14:50:16 +08:00
mula.liu 357942ba2e NEX 阶段 8.5·第4项:第 9 闸升级为语义与行为检查(semanticcheck 1062 行)+ 咬出的 4 类真缺陷就地修复
为什么要新闸:此前所有检查(含 classaudit 的 9 道子闸)量的是**源码字符串**——
aria-label 写没写、tabIndex 写没写。字符串会骗人:`aria-label=" "`、指向不存在 id 的
aria-labelledby、常年写着的 `aria-expanded="true"`、给了 `role=button` 却没 tabIndex、
被 CSS `outline:none` 吃掉的焦点环——源码看着齐全,辅助技术什么都读不到。
批准书 §4 要求「优先用实际浏览器行为与辅助技术语义验证」,所以全部换成真东西:
CDP `Accessibility.getFullAXTree` 读 AT 实际拿到的角色与名称、`getComputedStyle` 读算出来的
焦点环、真按 Tab / Space / Escape 看键盘走到哪儿。

七条判据(退出码 = offender 条数):NAME(AT 可读名称,硬/软两档)· HOTSPOT(pointer 可点
但键盘到不了)· TAB(走位与焦点掉出文档)· FOCUS(焦点环可见性,聚焦前后实测对比)·
ARIA(声明的状态与运行时一致)· LIVE(状态通知)· STATES(空/错误/加载六态)。
旋钮:NEX_WIDTH / NEX_THEME / NEX_ROUTES / NEX_TABS / NEX_NAMESTRICT / NEX_HOTSPOTSTRICT /
NEX_FOCUS_DWELL。软档默认不进退出码(当前 20 颗/主题属「补一句 aria-label 就干净」的历史欠账,
登记为 S-1,按路由分批转硬),不为了让灯变绿而调口径。

它第一天咬到的 4 类 58 条真缺陷,全部就地修好:
· AudioPlay 进度条:可点可拖却键盘到不了、role=slider 没有值 → 补 `tabIndex` +
  `valuemin/max/text` + ←→↑↓ 5% / Shift 20% / Home / End,并 stopPropagation(不抢页面滚动)
· MediaLightbox 只读进度:假 slider 是 ARIA 谎报 → 改 `role=progressbar`
· AssetLibrary 三处图标按钮无 AT 名称 → 补 aria-label(选择素材 / 母版)
· `input.nex-file-input` 焦点环被全局 `:where(...):focus-visible{outline:none}` 吃掉
  → `app.css` 唯一一处 +11 行,把环画在**看得见的按钮**上
  (`.ant-btn:has(> .nex-file-input:focus-visible)`)——这是本轮唯一动 CSS 的地方

反向验证:`gateprobe` 加 3 条语义判据的反例(人造坏控件必须红、撤掉必须复绿),
常驻出口从 11/11 升到 `GATEPROBE_OK 14/14`;闸登记进 `nex.config.yaml → ui_gates`
(13 → 14 条命令),并把 authority 注释里写死的「12 道探针」改成「§15 探针清单」,
免得规范与代码又对不上一次。

验证:HEAD `semanticcheck` 1440 与 430 均 **EXIT=58**(NAME 20 / HOTSPOT 16 / TAB 16 /
FOCUS 6)→ 工作树两档均 **EXIT=0**;账号侧四条 chromeless 路由另跑 EXIT=0(硬档 0);
最终代码 14:25→14:36 干净复跑 430 档 0 条违规。规范落点 docs/UI规范.md §15.13、§16 第 9 步。
2026-11-08 14:50:07 +08:00
mula.liu 6334a4a894 NEX 阶段 8.5·第3项:六张窄屏违规表逐表响应式(useNarrowTable + 九套窄档列,宽档一字未改)
症状:tableaudit @430 违规 6 张表(最大横向溢出 546 px),@576/@768 同样违规。
根因不是「容器太窄」,是列宽预算按 1440 那把尺子算的(全宽表容器 1118),
窄屏容器只剩 356 / 462 / 502,定宽列合计 400–902 把长文列挤成 0 宽。
768 比 576 还窄(侧栏没折叠,正文 462),所以三档窄屏共用一套精简列。

做法:`components/ui/Table.tsx` 新增 `useNarrowTable()`(<992 = antd/tailwind 的 lg);
页面按档位交两套 columns——宽档那份**一字未改**,窄档把次要列并进主列的第二、三行
(数据换位置,不失踪)。用 `Grid.useBreakpoint` 换列定义而不是 CSS `max-lg:hidden`
显隐 DOM:只有一份 columns 在渲染,表头与单元格的辅助技术朗读才不会读到藏起来的列。

九张表各按数据特点选方案,不是一套模板套到底:
① 项目列表:卡片/表格分界 max-sm → max-lg(八列里有封面图/进度条/成本三种形状,
   并进两列读不动;窄档换**已验证过的那张项目卡**,字段一个不少,不新增组件)
②③ 派工:主列并「· 状态 · stage」,次要列合并
④⑤ 质检 / 时间线:优先级列保留、次要列并入主列
⑥⑦⑧⑨ 交付:窄档 `#id 名称` 并列、成本/时间并一格
长文本一律保留完整内容提示(Tooltip / aria-label),不靠截断蒙混。

红线自证(批准书 §3 六条):没有统一方案 · 没隐藏重要业务数据(另写 dataintegrity
探针按 token 对账:⑥失踪 3→0,③失踪 9→2 且两次复跑读到的都是实时计时器漂移)·
没靠扩容器宽度糊弄(容器实测 356/462/502 未变)· **tableaudit.py 阈值一字未改**
(ROW_H_MAX 仍是 84,⑥窄档行高实测正好 84,已登记 T-2)· 键盘与操作反馈未动。

验证:tableaudit 430 HEAD 违规 6 张 → 工作树 0 张;576/768 同 0;
@1440 日志去掉时间戳后与 HEAD **逐字节相同**;最终代码 14:44 再跑 430/1440 均 EXIT=0;
visualcheck-120(15 路由 × 4 档 × 2 主题)HTTP 0 / 断言 0;semanticcheck @430 0 条违规。
规范落点 docs/UI规范.md §13.2.1。
2026-11-08 14:49:55 +08:00
mula.liu a851eca71f NEX 阶段 8.5·第2项:430 顶栏项目名——省略号 + 完整名称三通道(Hover/Focus/Touch,按悬停能力收口)
症状:430 档项目名被 ellipsis 截断后,键盘档没有任何一条路能读到完整名称;
触屏档点胶囊另有出口(概况抽屉标题就是完整名),但鼠标档只剩一份看不全的字。

做法(只动这颗已有的 project switcher 胶囊,不新建提示层、不碰 AppHeader):
· `Typography.Text ellipsis={{tooltip}}` → 受控 `Tooltip`:`trigger=[hover,focus]`;
· 只在悬停/聚焦那一刻现量 `scrollWidth - clientWidth > 1`,名字读得完就不弹;
· Focus 只认 `:focus-visible`,鼠标点开抽屉时背后不挂提示;`Blur`/`Escape` 关闭;
· Touch 通道 = 点胶囊 → 概况抽屉标题(本来就是完整名),写成注释里的契约;
· 触屏档根本不弹:`canHover()` 用 `matchMedia("(hover: hover)")` 按能力收口——
  实测事件序列 pointerover(touch)→…→click 之后 antd 的 mouseEnterDelay(0.1s)
  仍会在抽屉背后点出气泡,手指不会 leave,气泡就一直挂着(复跑咬出来的)。

验证:430 `truncated:true` 且 CDP AX 名称=完整名;Hover 与 `:focus-visible`
各自 `tip_visible:true`;430 触屏 `tip_visible:false`、抽屉标题=完整名;
768/640/900/1440 `truncated:false` ⇒ 不弹;`stray_tooltips` 1→[];
顶栏四颗子元素 x 区间未变(操作区没被挤压);tableaudit/visualcheck/
semanticcheck 全绿。规范落点 docs/UI规范.md §6.5。
2026-11-08 14:49:45 +08:00
mula.liu 7d844a9155 docs(帮助页): 重拍 12 张手册插图,跟上门禁与外壳的当前样子
frontend/public/help/*.png 是 <img> 直出的静态截图,不参与构建:UI 每换一次皮肤,
这 12 张就整批过期,正文说的和图里对不上。阶段 8 动了外壳(<768 导航抽屉)与标签皮肤
(D16 那枚此前根本看不见的角标),按 helpshots.py 的既有口径重拍一遍。

口径未变:视口 1600×1000、dsf=2 拍完 LANCZOS 缩回 1600;主题锁 light(12 张彼此要一致);
拍摄主角仍是已交付的项目 12。产物先落临时目录,人工过一眼后才覆盖进 public/help。

单独一笔提交,方便与代码回滚解耦(阶段 8 起沿用同一做法)。
验证:12 张全部产出,尺寸逐项 1600×1000;storyboard 一张可见分镜卡缩略图左下的
「已生成」角标——那正是 D16 修好之后第一次真的落进画面。
2026-11-08 00:18:12 +08:00
mula.liu 687bf5a64d NEX 阶段 8·N14:分镜排序补上键盘替代 ⌥↑/⌥↓,改镜序不再是鼠标专属
阶段 2 把分镜卡做到「点得开」,但排序仍然只有两条鼠标路(HTML5 拖拽 + 分镜表两颗按钮):
键盘能走到卡片,却走不动卡片。用户批准 N14 后按「不加新控件」的口径补齐第二条路。

实现(frontend/src/pages/project/Storyboard.tsx):
- move() 回传 Promise<boolean>(越界 false,其余走 run() 的既有返回值)。三个
  void move(...) 调用点一字未改,行为不变——run() 本来就返回布尔,只是没人接。
- 新增 moveByKey():越界报「镜头 N 已经在第 M 位,无法继续前移/后移」,成功报
  「已后移到第 M 位」;随后 refocusShotCard()(rAF 最多 8 帧找回 [data-shot-card])
  把焦点还给同一张卡——列表整体重排会把卡片重挂、焦点掉回 <body>,
  不归还的话第二下按键根本没有落点,等于「只能移一格」。拿不到就不抢焦点。
- ShotCard.onKeyDown 先接 Alt+↑/↓(preventDefault + stopPropagation)再走 Enter/Space:
  卡片正处在 window 那条「方向键切镜」监听的冒泡路径上,不拦一次按键会既移镜又切镜;
  window 侧同步加 if (ev.altKey && Arrow) return 兜底,焦点不在卡上时宁可不响应。
- 可达性:aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown" + 全站一份 sr-only 说明
  (卡片用 aria-describedby 指过去)。不给整块热区加 title——原生 tooltip 会盖住
  卡内每一处;也不给每张卡的 aria-label 各念一遍——30 张卡念 30 遍同样的话。
  aria-label 逐字未改,阶段 2 的口径与探针定位都不受影响。
- 反馈的不对称是刻意的,写进 UI规范.md §13.3 ⑤ 第 3 条:拖拽时卡片跟着手走、落点
  由卡片自己说,键盘时手没在版面上、必须由文字说出「成到哪」;判据从「输入方式一致」
  改成「用户能不能自己看见落点」。播报走 notify()(Toast 容器本身是常驻 aria-live),
  不另起第二条 live region(R19)。
- 不新增卡脚按钮:224 档实测那一行会劈成 2+1(正是 btnclustercheck 拦的形状),
  补按钮就得缩控件或加行,两者都属本轮排除的视觉改动。看板/表格像素零变化,
  新插入的 sr-only <p> 放 grid 外面,不参与列宽计算。

帮助页同步:pages/Help.tsx 的分镜步骤与快捷键清单加 ⌥↑ / ⌥↓(注明 Win/Linux 用 Alt)。
G3 补「热区不是按钮时快捷键挂在哪」;对照文档 §2.8 更新证据、§5 N14 ⏸→✅、§7 变更记录。

验证:npm run typecheck 通过(中途抓到一处真实 TS1005:普通注释搬进 JSX 子节点)·
npm run build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道闸全 0 EXIT=0 ·
新写专项探针 sortcheck(明暗各 6 组:顺序变了 / 焦点没丢 / 有播报 / 边界会说话且顺序不动 /
不 Alt 的方向键行为不变 / Enter 仍打开检查器)PASS 0 条,对 HEAD 反证 FAIL 14 条 ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11,含 feedbackcheck 与 gridcheck)·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)断言 0 / HTTP 0 / console 0,
另跑 1440 单档 30 状态同样全 0。证据 reports/ui_evidence/nex-p8/n14/。

上游:NEX 08 §2 新增「可排序条目的键盘移动方式」五条(子仓库单独提交)。
2026-11-08 00:16:30 +08:00
mula.liu ae4dd7f68e NEX 阶段 8·D17/N7:<768 导航改左抽屉,同一屏只剩一个导航入口,顶栏胶囊溢出归零
用户批准「移动端导航采用抽屉式 Drawer」。改前三条实测决定了必须怎么改:
① Sider 的 breakpoint="md" 把侧栏自动收成 64px 图标轨,而汉堡同时还在,
   label 写着「展开导航菜单」——点它只把图标轨撑回 224,随即又被 breakpoint 收回,
   同一屏两个导航入口且行为自相矛盾(NEX 04 §8.2 明令消掉的状态);
② 那 64px 是真金白银的正文宽度:430 实测正文盒 366(可用 342)、576 实测 512;
③ D17 那 33–38px 溢出正是被它逼出来的:流水线台那颗 Button 内容居中,
   装不下就两端一起往外溢——430 胶囊盒子 x=100 w=172、内容 sw 203,
   项目名从 x=63 起画(比胶囊左沿还偏左 37px),箭头画到 x=305(胶囊右沿 272)。

实现:
- kit Drawer 加 placement(默认 right,站内既有 10 处调用点一个都不传,行为逐字不变)
  与 flushBody。flushBody 只能是 prop:.ant-drawer-body 的 padding 是 antd CSS-in-JS 的
  未层声明,页面写 p-0 在 @layer utilities 里,层外压层内(同 §1.1.1 的 .nex-tag 实测)。
  左右默认宽分档(左 min(288px,100vw−48px) / 右 DRAWER_WIDE):抽屉宽度取决于它是
  「替换主内容的位置」还是「压在主内容上的一块面板」。
- AppSider 拆三导出:AppNavMenu(菜单本体)/ AppSider(≥768 常驻,撤 breakpoint)/
  AppNavDrawer(<768 左抽屉,宽 = SIDER_WIDTH 224 + flushBody)。抽屉宽不取 antd 默认 378:
  里面是同一份菜单,宽度一换折行、缩进、选中底色宽度全都换,等于凭空多出第二个导航形态。
- App 测一次 narrow(Grid.useBreakpoint().md === false,undefined 当桌面否则 1440 会闪一帧
  「没侧栏只有汉堡」)往下传:侧栏在不在、汉堡点哪儿,两处必须同一个答案。navOpen 换页自动关。
- 同一颗汉堡换语义:≥768 折叠侧栏(原文案),<768 开合抽屉(打开/关闭导航菜单),
  aria-expanded 只在抽屉形态给(折叠侧栏是布局尺寸,不是被展开的面板);图标改按
  「导航现在露没露」选,≥768 时 navShown === !collapsed 与改前逐字同值,<768 抽屉关着时
  画的正是改前那颗 Expand → 顶栏像素没动。
- PipelineConsole 的项目名只在 <768 恢复收缩权(max-md:min-w-0 max-md:flex-[0_1_auto])。
  第十三轮给的 flex-none 是为了「名字不许被散文吃掉」,那条在 ≥768 依然成立;手机档没有
  散文可吃(cur <lg 隐、rail <xl 隐、status <md 隐),只剩「名字 vs 百分比+箭头」一道减法,
  折出来的是省略号 + tooltip(§15.2 第 7 条:省略号可以,残字不行)。

探针:visualcheck 补 probe.sider;菜单断言先问侧栏在不在,<768 真点一下汉堡,量
.ant-drawer-content-wrapper(外层 .ant-drawer 是 inset:0 的遮罩容器,宽恒等视口,拿它比 224
会全线误报)并断言左贴边 / 宽 224 / 选中态底色等于桌面同一份 token / Esc 必须关。
顺手修掉一处从阶段 0 就存在的失配:menu_required 用 `path in NAV_ROUTES` 比的是**模板**
(/projects/{id}/overview),主循环早已换成真实 id,七条项目路由从没进过菜单断言——
新增 in_nav() 后覆盖 3 → 10 条路由。

未做(授权 §六):卡片没扩大、栅格没改、56/224/64 与控件三档一字未动、430 的表格仍横向
滚动而没有顺手改堆叠单栏。

验证:typecheck 通过 · build 通过(仅既有 chunk>1200kB 告警)· classaudit 九道全 0 exit 0 ·
visualcheck 120 状态(15 路由 × 4 视口 × 明暗)0 断言 / 0 HTTP / 0 console ·
常驻 11 道探针 EXIT=0 ×11(GATEPROBE_OK 11/11)· 第 9 闸反证 BP_PROBE_OK 10/10 ·
navprobe 几何 FAIL 4/10 → PASS 0/10(430 溢出 33→0、正文 366→430)·
drawercheck 行为账 after PASS 0 条,对 HEAD 反证 FAIL 10 条 ·
tableaudit 逐视口前后:1440 两态 0 违规、768 两态逐字相同、576 溢出量各 −64、430 违规 9→6 ·
≥768 像素疑点定性为 Noto Sans SC 异步 swap 竞态 + 活动角标漂移:document.fonts.ready 后
before/after 顶栏强差 0(1440 与 768),1440 两态 DOM 几何逐字相同。
证据 reports/ui_evidence/nex-p8/d17/。

规范同步:UI规范 §6 外壳表补 AppNavMenu/AppNavDrawer 两行并写清撤 breakpoint 的理由、
§15 第 3 条改抽屉口径 + 登记 NAV_ROUTES 事故、§4 insp-sm 同步复核结论;
NEX-对照与例外 §2.4 <768 DEFERRED → ADOPTED、§5 N7 → 已采纳、§6 D17 → 已修、§7 变更记录;
nex.config.yaml shell 段加 sidebar_narrow: drawer 并校正四条尺寸的实现行号。
2026-11-07 23:36:48 +08:00
Codex 1227003173 NEX 阶段 8·D16:kit 的 Tag 不再吞 className,顺带量清「页面到底能给它写什么」
Status.tsx::Tag 的形参收了 className 却没并进 cn(),全站 10 处站点从写下去那天起就是空转。
并进 cn() 末位(学同文件 Badge 的写法,tailwind-merge 保留后写者)之后逐站点实测,
结论与最初的推测不一样,两半都得记下来:
· 真的一半:styles/index.css:55 的 @import "./app.css" 不带 layer,未层声明高于任何
  @layer,所以 .nex-tag.ant-tag 独占的 13 族属性页面 utility 压不动(display/底/色/圆角/
  内距/字号/行高/min-height/gap/max-width/white-space/overflow/margin-inline-end);
· 假的一半:.ant-tag 带 transition:all .2s,改完类名立刻 getComputedStyle 读到的是过渡
  起始值,margin/flex/font-weight 曾被集体误判成「输了」(700ms 后再读就对了)。
明暗两档逐属性量出能力矩阵,写进 UI规范 §1.1.1,并给 classaudit 加第 8 闸 TAGSKIN:
给 kit 的 Tag/Status 写皮肤类 = 判违规(该走 tone,或把 display 留在 wrapper 上)。

站点回归:ModelCenter「默认」只留 font-bold(皮肤族点不亮,§2.1 也早已废止语义铺底);
Review 的视觉模型名改走 tone="mono";分镜卡撤掉 flex-none 那层 wrapper,
缩略图角标的 absolute 第一次真的生效(此前掉出 overflow-hidden 盒子,探针 visible=False);
PipelineConsole 的 wrapper 保留,注释改成实情:它只为 display 族存在,撤它得先降 .nex-tag 皮肤入层。

验证:typecheck / build 通过;classaudit 8 道闸全 0;常驻 11 道探针 EXIT=0;
visualcheck 15 路由 × 4 视口 × 明暗 = 120 状态全绿(断言 0 / HTTP 0 / console 0);
932 颗标签 before/after 逐站点 diff,46 处差异全部落在预期站点,且无一处皮肤字段改动。
证据与元素级前后截图:reports/ui_evidence/nex-p8/d16/。
2026-11-07 22:35:11 +08:00
mula.liu 5753177616 NEX 阶段 7 断点归一:五把实测尺子登记成命名断点,页面里裸 max-[...] 归零
改的是尺子的名字,不是尺子的刻度。审计字面方案(620→576、720→768、
1080/1240/1400→992/1200)逐条实测后全部不采纳,走审计自己留的出口条款
R9:登记为项目断点。

- styles/index.css:--breakpoint-* 主阶梯后面补 5 条登记档位
  insp-lg=1400 / board=1240 / insp-md=1080 / insp-sm=720 / agent=620,
  每条注明唯一使用者;口径写进注释(一把尺子一个使用者、名字即表面、
  加档要带视口测量、删档要连带删掉唯一使用者)
- Storyboard.tsx / AgentConsole.tsx:15 处 max-[Npx] 换成 max-<name>:,
  并把「为什么不能并到邻居档位」的实测读数写进就地注释
  (agent 并到 576:指令列 415→150、行高 71→90;board 并到 xl:
  1204–1239 由 4 列 224 退回 3 列 301;insp-sm 并到 md:721–767 整屏盖住图标轨)
- scripts/ui/visualcheck.py:wantDisplay 的断点表同步这 5 个名字。
  归一之前凡含 [ 的类名被直接跳过,这轮起 max-board:flex /
  max-agent:order-5 才真的按档位算期望 display 与顺序
- docs/UI规范.md §4:断点登记表落地(档位 ↔ px ↔ 使用者 ↔ 采用理由)
- docs/NEX-对照与例外.md:新增缺口 N16 —— NEX 没有「主阶梯放不下时
  的命名登记出口」这一条

验证(最终代码态,全部 EXIT 0):typecheck / build 430ms / classaudit
0 死类名 4088 候选 / 11 道常驻探针 + GATEPROBE_OK 11/11 /
visualcheck 120 状态(15 路由 × 4 宽度 × 明暗,新增 576 档)+ 36 张边界档
断言 0 console 0 HTTP 0 / grep -rn "max-\[" frontend/src = 0 /
sbprobe 16 档与 agentprobe 10 档改前改后 JSON sha256 相同 /
dist CSS 五个断点块声明体逐字节相同 / 9 对前后帧 Header 以下 0 显著差异像素、
总控台两对 PNG 逐字节相同 / 阶段 1 tagw、阶段 2 kbd(1440 与 576)、
阶段 3 zorder5 跨阶段复跑全绿

报告 reports/NEX阶段4-7实施-2026-11-07.md(§4 与 §7 为本轮)
2026-11-07 18:54:24 +08:00
mula.liu 3e86b282e0 NEX 阶段 6 拆 kit 与清死代码:Panel/Controls 按职责分成五份、删 7 个 0 调用导出与 2 个死 hook、R8 承认 app 为外壳层 2026-11-07 18:21:47 +08:00
mula.liu bc5d1bcc90 NEX 阶段 5 定一次操作的反馈预算:Library 5 处原生对话框收口、录音链 3 颗吐司并成 1 颗、模型中心开关补结果反馈、430 统计卡改两列 2026-11-07 17:51:40 +08:00
mula.liu 24513a976e NEX 阶段 4 补齐状态表面:首屏骨架、抽屉骨架、权限不足与地址不存在兜底页 2026-11-07 17:14:37 +08:00
mula.liu 4411d222fa NEX 阶段 0–3 落地:规范对齐、状态标签截断兜底、三处热区键盘可达、浮层层级表
阶段 0(0 行业务代码):根 nex.config.yaml 把本项目实测值写死(Header 56 / Sider 224·64 /
Content 24·1680),AGENTS.md 的 NEX 路径统一加 nex_design_system/ 前缀并声明
docs/UI规范.md 为项目级权威;新增 docs/NEX-对照与例外.md 逐条判定 81 行
(COMPLIANT 49 / ADAPTED 17 / ADOPTED 13 / DEFERRED 7 / N-A 10)+ 例外 E1–E10
+ 别名表(不新增 --nex-* 命名空间)+ 反向清单 N1–N15。
阶段 1:ui/Status.tsx 的 Tag 自己兜 title(flatText 取正文),分镜卡标题 min-w-0、
状态标签 flex-none,顶栏流水线台 max-md:hidden 收口;visualcheck 新增 tagtitle 断言,
「截断却没兜底」从此进闸门。修掉分镜卡标签压到 35px、顶栏胶囊塌成 7px 两处实测病灶。
阶段 2:三处非语义热区可键盘化——顶栏品牌区改真实 <Link>(头像与平台名合成一个焦点站)、
分镜卡 <article> 加 tabIndex/aria-label/aria-current + Enter/Space(不套 role=button,
免抹掉卡内勾选框与三颗按钮)、Rows::LogRow 只在真有 onClick 时进 Tab 序列。
阶段 3:lib/layers.ts 建立 9 档层级表并被 7 处浮层引用;顺带修掉两条实测遮挡——
素材抽屉里点缩略图灯箱看不见(220 < 抽屉 1000)、声线抽屉里录音面板点不着(260),
确认框第一次拥有自己的数(1190)以免灯箱抬升后压不住。

验证:typecheck / classaudit / build 全部 EXIT 0;visualcheck 84 状态(14 路由 × 3 视口 ×
2 主题)console 0 · HTTP 0 · 断言 0;11 道常驻探针 GATEPROBE_OK 11/11。
详细取证见 reports/NEX阶段0-3实施-2026-11-07.md。
2026-11-07 16:49:14 +08:00
mula.liu 2d58807478 v 0.1.2 2026-11-07 02:55:35 +08:00
mula.liu ce91173a6c v 0.1.2 2026-11-07 00:48:17 +08:00
mula.liu a73ce504c9 用户管理按其它模块的口径重做,卡头不再复读页签与角标
用户这一轮两条,其实是同一句话:**同一个信息在一屏里只许说一次,同一类操作在任何模块里必须是同一个动作**。

**1)用户管理:从「左右两栏 + 常驻表单」改成「列表 + 抽屉 + 行内动作」(UI规范新增 §13.5)**
它是站内唯一一个没跟上口径的模块:左列表 + 右详情面板各占一半、页面顶部常驻一张新建表单(还自带一套
`formDirty` / `keepForms` / `syncEdit` 脏检查)、表格没有操作列、五张统计卡只有数字不能点、
抽屉里那颗「允许登录」`Check` 与列表上的「停用」是同一件事的两种写法。逐条对齐资产库 / 模型管理中心:
- 整行点开抽屉(`Table onPick`),**新建与编辑共用同一张 Drawer**(980px,与资产库编辑抽屉同宽)——
  关掉即放弃,于是压根不需要脏检查:Kit 没有的那层状态不再自己造;
- 操作列四颗纯图标(编辑 / 重置密码 / 注销会话 / 停用⇄启用),逐个 `aria-label`,0 会话与停用自己分别
  disabled,整列 `stopPropagation`,免得点图标连带打开压在底下的抽屉;
- 四张统计卡**全部是筛选入口**(AS-7 同一口径),删掉第五张「活跃会话」:它不是入口,数字还被探针登录污染成四位数;
- 后端 `GET /api/users` 新增 `status`(`active` / `disabled` / `pending`,非法值 400),与既有 `q` `role`
  可叠加,`counts` 恒为全库数——统计卡点下去不会把自己的数字点没。「管理员」那张必须筛
  `role=admin&status=active` 才与卡上的数一致(`counts.admins` 只数启用中的),`pending` 同理写
  `must_change_password && is_active`:停用的账号本来就登不进去,不该再算「待改初始密码」;
- 搜索 320ms 防抖(与资产库同一个值);`useAutoRefresh` 第 4 参带上「任一浮层开着」,30 秒轮询不再冲掉敲了一半的表单;
- **停用与重置密码不能共用一张底部**:§10 那条动作条只许一颗 `type="primary"`,而停用确认是
  `primary danger`。于是停用留在行内走 `confirmAction`,重置密码独立一张 Modal(新密码 + 两颗 Check)。

**2)卡头去掉重复的二级标题(§13.6)**
资产库卡头写「人物母版 / 共 10 个母版」,头顶页签写「人物母版 10」,卡底 `Pager` 写「共 10 条」,
第一张统计卡的 `hint` 再写一遍「人物 10 · 场景 6 · 声线 3」——同一句话在一屏里出现四遍。
卡头的 `title` 与 `sub` 整块删掉,只留右端视图切换器;数量交还 `Pager` 与页签角标;`hint` 换成
「点下去清空筛选,回到这一类母版的网格视图」这种只在这里才有的信息。模型管理中心是同一形状
(左栏已经选中「大模型」,卡头再来一句「大模型」):删 `title`,能力说明挂到计数的原生 `title` 上(G2)。

**3)顺着这次改动发现闸门自己有两个洞,一并补上**
- `aligncheck` 与 `symmetrycheck` 的 BASE 写死 `localhost:5173`,而那台端口上跑着**另一个项目**:
  十三页一个门牌都没量到,三个跨页集合全是空集、「最大跳动 0」,两把尺于是**空跑成绿**。
  现在两把都认 `NEX_BASE` 并且自报样本数(`ALIGN_PROBED` 底线 40、`SYM_HEADS n/13` 底线 10),
  掉到地板一律退出码 2——凡是「0 = 通过」的尺都必须报样本数,和 `FOOTER_PROBED` 同一条规矩。
- `feedbackcheck` 的 B 项靠 /users 页面上那颗常驻「保存」触发,保存搬进抽屉后它点不到东西直接抛异常
  (而 `| tail` 把非零吞了,看上去还是绿的)。改成整行点开抽屉再点抽屉底部「保存账号」;
  **点完必须把指针挪开**——那颗主按钮正对着吐司的落位带,手留在那儿就等于一直 hover,C 永远读到 `paused`。
- `footercheck` 加进 `/users` 三张浮层;行内图标按钮没有可见文案,触发器新增 `@无障碍名` 写法按 `aria-label` 找。

验证(dev 跑在 :5199 / :8010,8000 与 5173 被 nex_buddy 占着)
- 前端闸门:`classaudit.mjs` 六项全 0;`tsc --noEmit`、`npm run build` 通过。
- 探针全绿:aligncheck `ALIGN_PROBED 181` / 0 处(明暗两档)、symmetrycheck `SYM_HEADS 13/13`
  三集合单值 {273}/{109}/{1391}(明暗两档)、tableaudit 0、gridcheck 0、rhythmcheck 0、
  tagcheck 0(明暗)、btnrowcheck 413 组 0、btnclustercheck 154 簇 0、footercheck
  `FOOTER_PROBED 39 FOOTER_BAD_TOTAL 0`(加 /users 前 30)、feedbackcheck 明暗两套全过、
  gateprobe 11/11、visualcheck 0 断言 0 HTTP 失败。
- 后端 `pytest -q` 全量 **503 passed / 1 skipped**(新增 `test_user_list_filters_are_server_side`:
  三档状态筛选、`role`+`status`+`q` 叠加、counts 不随筛选变化、非法值 400)。
- 重启 dev 之后实测:点「管理员」卡 → 角色=管理员 状态=正常 → 表里 1 行 = 卡上 1、卡头「筛选出 1 / 3 个账号」;
  点「待改初始密码」(0)→ 空态「没有匹配的账号,换个关键词或清空筛选。」;`status=nope` → 400。
- 手册 12 张插图整批重拍(`helpshots.py`):上一轮删掉的开发期说明还留在插图里——
  插图是静态 PNG、不参与构建,UI 每换一次皮肤这 12 张就整批过期。
2026-11-06 01:12:21 +08:00
mula.liu b504e31628 前端四项调整:输入框去掉光晕、账号菜单收口、逐页删开发期说明书、登录页重做成左右分栏
用户这一轮提了四条,其中三条是同一件事的三个面——**界面上残留着写给开发者自己的话**。
逐条落地的口径与取舍:

**1)所有输入框聚焦时的蓝色外框**
量出来其实是三层叠在一起:antd 组件 token 的 `activeShadow`(2px 主色光晕)、
`genFocusStyle` 画的 `outline`、站内 `app.css` 给自绘表面准备的全站 `:focus-visible` 兜底。
第二层没有独立 token,而它依赖的 `lineWidthFocus` 还被 Upload 拖拽区复用,动 token 会连带改上传框,
所以分两刀收:`theme/antd.ts` 关 token(`Input`/`InputNumber` 的 `activeShadow` = `none`、
`Select.activeOutlineColor` = `transparent`),`styles/app.css` 用
`:where(...):focus-visible { outline: none }` 关那圈 outline——用 `:where()` 是为了把特异度归零,
它只是一份选择器清单而不是新加一层优先级,将来谁要恢复焦点环不必先赢过一条 `!important`
(app.css 本身不在 `@layer` 里,压得住被 Tailwind 放进 `@layer antd` 的那份,本来就不需要 `!important`)。
**焦点指示没有被删**:antd 的 `activeBorderColor` + 加粗边框仍在,键盘用户看得见焦点;
自绘表面继续吃全站那条兜底。实测聚焦 `#login-user`:`box-shadow: none`、`outline: none 3px`、
`border-color` 浅 rgb(22,119,255) / 深 rgb(22,104,220)。

**2)账号胶囊:菜单去重、项上不留副标题**
「设置新密码」和「我的账号」是同一件事,且首启时登录页已经直接把人的带到 `/account?must=1`,
重复排队只让菜单变长——删掉,待办语义留着头像上的 Badge 红点。
菜单项不再写「账号信息 · 密码 · 登录设备」这类预演式说明;顺手把胶囊第二行的
`第 N 次登录` 也去了:那是「用户管理」表格里逐人登记的数据,挂在人人都要看的顶栏里等于把统计搬进导航。
现在菜单就是三项:我的账号 / 用户管理 / 退出登录。

**3)逐页去开发时冗余说明**(`Dashboard` / `AssetLibrary` / `ModelCenter` / `AgentConsole` /
`project/{Library,Overview,Storyboard,Timeline,Review,Delivery}` / `ProjectBriefDrawer`)
三类处置,已写进 UI规范 §14 G2:
- 常驻说明书删掉可见文字,信息进 `title`/`desc`:IndexTTS2 那四行论文式介绍(两处重复,
  含「下面这条预告会说清楚:」)、总控台「期间页面不会推进,属正常现象」;
- 开发者口径翻成「会怎样」:ffmpeg libass 提示只留降级后果,`FFMPEG_BIN` / `brew install ffmpeg-full` /
  当前探测路径收进 `title`;`Delivery` 卡头「媒体由后端 `/media` 直出,下载走 `/api/exports/:id/download`」整条删;
  「每一站的汇总状态由它覆盖的那几个节点折算而来」→「点一行直接跳到对应环节」;
- 内部词不许漏到版面:`mock/Mock` → 站内既有的**演练通道**(四处)、「未匹配的列在 `unmatched_images`」
  → 翻成人话;**一个物件只有一个名字**,`/models` 曾同时叫「模型中心 / 模型控制台 / 调度中心 → 模型中心」,
  全站统一成侧栏那一项的写法 **模型管理中心**(含 `.env` 注释、`dev.sh`/`server.sh`/`seed.py` 的引导语、
  后端四条给用户的报错文案、README、docs、探针页面名),并修掉不存在的入口路径「调度中心 → 模型中心」。
有意保留:单位与取值口径的括号(`(秒)(毫秒)(可选)(0=自动)(dB)`——读数不该依赖悬停)、
条件出现的 `Notice`/`LineHint`/`ErrorText`、`confirmAction` 的 `desc`、`Stat hint`、`nav.hint`、
`PageHead sub`(kit 既定槽位的一句话职责说明)、`Help.tsx` 整页(登记在册的产品手册)。
配套给 `OptionGrid` 单开 `labelTitle`,让组标签的括号补充有地方去而不额外占一行。

**4)登录页重做**(UI规范新增 §13.4)
左右分栏:左栏 `w-[46%] max-w-[620px]` 写平台自述(品牌行 →「把一条长视频,做成一条流水线」+
三条能力点 → 角色可见范围),底色用 `color-mix` 把主色掺进 `color-bg-layout`,**零新 hex**;
右栏卡片保留原生 `<form>` 包在 `<Panel>` 外(Enter 提交与密码自动填充都挂在 form 上)。
窄于 `lg` 左栏整列收起,品牌行回到卡片顶部,任何宽度都认得出登的是哪个系统。
去掉后端下发的种子账号预填(`login_hint` 字段本身保留,`test_auth.py` 与 `e2e_selfcheck.py` 还在用它判首启),
placeholder 回到「用户名」「密码」;新增**记住我**:键 `nex-login`,账号+口令一起记一起清
(只清口令留账号的话勾选框就不算数了),只在登录成功后落盘,取消勾选当场 `writeLocal(key, null)`,
默认不勾(本机明文口令)。

文档同步:UI规范 §8.4(`labelTitle`)、§9.3(焦点轮廓三层口径)、§13.4(登录页)、
§14 G2(三类处置 + 一个物件一个名字)与 §14 例外登记(登录页左栏、`Help.tsx` 整页豁免);
README 鉴权一节补登录页与记住我;命名统一顺带扫了 `.env.example` / 三个脚本 / 后端文案。

验证:`npx tsc --noEmit`、`npm run build` 全绿;`node scripts/ui/classaudit.mjs` 七道闸门 0/0/0/0/0/0/0;
后端 + 前端起在 :8010/:5199 后跑完 §15 全部探针,退出码全 0——visualcheck 1440×明暗 15 路由
(console 0 / HTTP 失败 0 / 断言 0)、tableaudit 0、gridcheck 0、rhythmcheck 0、tagcheck 0/0、
btnrowcheck 0(413 组)、aligncheck 0、symmetrycheck 0、feedbackcheck 通过、footercheck 0(30 处吸底条)、
btnclustercheck 0(159 簇);gateprobe 11/11 反向验证;`pytest -q` 全量 502 passed 1 skipped
(后端改了四条用户可见文案,对应 3 处断言同步更新)。记住我三条路径(勾上存 / 不勾清空 / 取消即清)实测过。
2026-11-05 22:09:16 +08:00
mula.liu 9614b2d225 v 0.1.1 2026-11-05 16:53:24 +08:00
mula.liu 9d62b88b05 规范与闸门收口:R19 反馈四级、R20 标题前不挂图形写进硬规则,探针补到十道
这一笔只动文档、审计与闸门,代码一行没改——前三笔(b6a1df6 反馈表面、552b6b0 门牌图形)
把事做完了,但规范和闸门还停在第十八条 / 六道探针的状态:新规矩没进 §0 那张硬规则表就
等于没立;探针不落地,下一轮改动照样能悄悄长出第五套反馈皮肤。

补进去的规矩(§0 从 18 条到 20 条):
   · R19 反馈只有四级表面,各有唯一实现:行内 `ErrorText`/`LineHint` → 页面 `Notice` →
     结果 `notify*`(自绘吐司)→ 确认 `confirmAction`(自绘确认框);`window.confirm` /
     `window.alert` / `Modal.confirm` / antd `message` / `notification` / 裸 `<Alert>`
     全站清零,也不许再给它们打样式补丁。新增 §13.3 一整节写四级的分工、吐司的四件事
     (右下角堆叠 / 倒计时条与 JS 同源 / 同句去重成 ×N / 一屏最多 5 颗)和确认框的键盘映射。
   · R20 标题前面不挂图形:门牌与卡头的一级标题左侧不许出现图标、色块、头像。
   · 旧口径逐条纠正(10 处锚点全部命中才落盘):R16 ③ 与 §13.1 那张表里 `Notice`=antd
     `Alert`、§13.1 正文「图标由 Alert 自带」、§6.5 外壳表里 `App.tsx` 的「系统异常
     `Alert` → 页面」、§6.1「Content 里除了异常 Alert 就是 `<Outlet />`」、§15.6 tagcheck
     的豁免语「整段 Notice / Alert 保留 antd 语义底」、§13.3 症状里那个被真实换行截断的
     code span。站内已经没有 `Alert` 这个名字了,文档留着它就是在教人写回旧写法。
   · `docs/工程规范.md`:目录职责图与「谁可以 `import 'antd'`」那段摘掉 `stores/notice.ts`
     ——吐司自绘之后它不再 import antd,白名单从四处收成三处。
   · README:闸门命令块补 `aligncheck` / `symmetrycheck` / `feedbackcheck` 三行,硬规则
     摘要补第 6、7 两条审计的说明。

闸门:
   · `classaudit.mjs` 从五条判据加到七条。第 6 条静态禁反馈默认件(`window.confirm(` /
     `window.alert(` / `Modal.confirm(` / `message.xxx(` / `notification.xxx(` / 裸
     `<Alert`),实现本体白名单只有 `components/ui/{Toast,Confirm,Panel,Button,tone}.tsx`
     与 `stores/{notice,confirm}.ts`;第 7 条钉住 R20——门牌与卡头标题里不许再挂前置图形。
     同时把第 5 条 R8 的白名单里那第四处 `stores/notice.ts` 删掉:留着它就等于给「以后
     谁想在 store 里 import 组件库」开后门。
   · 新增第 9 道 `scripts/ui/feedbackcheck.py`:静态审计查不出两件事实——运行时是否真有
     某条老路径弹出过原生对话框、自绘吐司是否真的**显示出来了**(`ToastHost` 挂错位、
     provider 没渲染、store 被引成第二份实例,都会让 `notify()` 静默返回而静态审计照样
     是 0)。它按真实路径逐项验 A~F:全站零 `dialog`、/users 保存后吐司落在右下角且
     `.ant-message` 一个不许有、悬停时 `animation-play-state` 必须 paused、同句去重成 ×2、
     连推 7 句只留 5 颗、关闭键生效、/ 上点删除出确认框(两层文案 + 恰好一颗 dangerous
     primary)、Esc 关掉后项目数不变。
   · 实测(明暗两档):`classaudit` 七条全 0 · `feedbackcheck` 通过 · `btnrowcheck`
     `BTNROWS_TOTAL 0` / `HEAD_BREAK_TOTAL 0`(413 组动作排 / 59 处竖排豁免)·
     `footercheck` `FOOTER_PROBED 30` / `FOOTER_BAD_TOTAL 0` · `aligncheck` 0 ·
     `symmetrycheck` `SYM_TOTAL 0` · `tsc --noEmit` 与 `npm run build` 绿。

手册 12 张插图按「改完 UI 必须重跑 `helpshots.py`」的口径整批重拍(1600×1000@2x →
LANCZOS、锁 light、主角项目 12):旧图还是带主色方块门牌与卡头品牌 N 的那一版。
2026-11-03 23:58:44 +08:00
mula.liu 552b6b0163 门牌与卡头标题前的图形全部摘掉,跨页页头改成同一把尺量
症状(用户原话「1、不要图标 2、垂直居中对齐,和其它子页面要一致。请检查。」+ 两张截图:
门牌上那枚主色方块、调度中心那一排浮在卡头顶部的只读胶囊):
   ① 上一笔刚给门牌接上「菜单同款图标」,用户看了还是不要。那枚方块的语义是「图形 =
      这一站」,可这句话左栏高亮项、顶栏流程条、项目概况抽屉已经各说一遍(R18),门牌
      再摆一次就是给同一条信息配第二个视觉锚点;它还和顶栏的品牌 N、统计卡的色块同形状
      同圆角,一屏三颗方块互相抢注意力。
   ② 标题前挂着 42px 的方块,门牌标题的左缘就比下面每一张卡正文的左缘右移 42px,
      「门牌与正文同一条竖线」这件事在有图标的情况下做不到。
   ③ 跨页从来没人量过:aligncheck 量的是**同一个容器内**同一行的中线,逐页看都不算错,
      连着切页就是晃。总控台卡头把 `<Mark>N</Mark>` 和标题拼进同一个标题槽,方块的
      自然高度决定那一行的行高,22px 的文字跟着整排错位。
   ④ 调度中心那一排只读胶囊(任务执行 / 已取消 / 失败 / 已跳过 / 已完成)套在卡头标题
      槽外面那个**行内 span** 里,块级 div 装进行内先撑出一段匿名行盒,实测整排浮到卡头
      中线上方 6.5px,同页其它单行卡头只偏 0.5px——肉眼就是「这排贴顶、下面空一截」。

做法:
   · `components/ui/Page.tsx`:`PageHead` 删掉 `icon` 形参与 `navItemAt()` 反查、标题行
     只剩 `Title level=3`——菜单图形那一层整层撤掉,不是传 `icon={null}` 豁免;不在菜单
     里的账号页 / 手册页也不再自己补 `IconUser` / `IconBook`。窄屏那一档换法:
     `HEAD_ACTIONS = 'max-lg:w-full'`,不再写 `[&>button]:flex-1`——`useAutoStack()` 的
     自然宽度只在「子项都按内容定尺」时量得到,等分一挂上自动档就永远认为量不到,
     三颗主操作在窄屏折成 2 + 1,正是 `btnrowcheck.BTNROWS` 点名的破法。
   · `pages/project/AgentConsole.tsx`:卡头标题去掉 `<Mark>N</Mark>`,标题槽只留文字
     (`Mark` 组件本身留着——登录页的品牌方牌还在用,那一处是品牌不是导航)。
   · 跨页这把尺:新增 `scripts/ui/symmetrycheck.py`(站内第 10 道常驻像素闸)。它收齐
     13 个页面同一个量的实测值,要求每个量**收敛到单值**:门牌标题左缘、标题行中线、
     主操作右缘三个集合的 `len` 必须 == 1,另加三条页内判定(标题行高 >= controlHeight、
     标题里不许再有 svg / `*-mark` / `ant-avatar`、卡头标题与 extra 同心 + 正文卡左缘 ==
     门牌标题左缘)。`aligncheck.py` 补上它原来漏掉的卡头 extra 与匿名行盒这一类。
   · `components/ui/{Controls,grid}.tsx` 一并落地(见下方记账):门牌的窄屏方案现在直接
     踩在 `ActionGroup` 的自动档上——量「整组的自然宽 vs 能给它的最窄祖先」,放不下整组
     就整组竖排等宽。少了这一半,本笔的门牌在窄屏会退回 2 + 1。

实测:明暗两档各 13 页 `SYM_TOTAL 0`、`aligncheck` 0 处不同心;三个跨页集合实测都是单值
——门牌左缘 {273}、标题行中线 {109}、主操作右缘 {1391},跨页最大跳动 0.0,主操作中线与
标题中线 Δ 全 0.0,controlHeight 32 == 32。反向验证两发都响:往标题里塞一枚
`nex-stat-mark` → `SYM_TOTAL 13`(全页点名「标题前不许有图形」);把 `actions` 从第一行
挪进说明行 → `SYM_TOTAL 10` 并点名「⚠主操作不在标题那一行(中线 153.0 vs 标题 109.0)」。
探针自己修过两处漏判:`'max-w-full'.includes('w-full')` 的子串误伤(改
`:scope > .nex-action-group`)和「动作离开第一行被当成这一页没动作」(改抓游离的
`.nex-action-group`)。

⚠ 记账两笔:
   ① `Controls.tsx`(`ActionGroup` 自动档 + `Ctlbar` 栅格末格贴右缘)与 `grid.tsx`
     (`FILL_AT`)是并行会话在途的按钮行收口,本轮门牌依赖它才自洽,所以提前落地;顺带
     把 `e5ccbe0` 遗留的那条 tsc 红修好了——那一笔提交了用 `<ActionGroup auto={false}>`
     的 `Page.tsx` 却没提交带 `auto` 的 `Controls.tsx`,`e5ccbe0` 与本分支上一笔 b6a1df6
     的树都是红的(`npm run typecheck` 在 `src/components/ui/Page.tsx:169` 报 TS2322),
     到这一笔才绿;`auto` 这个开关在本笔里连同它的豁免一起删掉了,窄屏怎么排只留一个答案。
   ② 上一笔 b6a1df6 的 `app.css` 是整文件提交的,里面已经删掉了 `.nex-pagehead-mark`
     那条尺,而它那一笔的 `Page.tsx` 还在挂色块:两笔之间那一格的门牌色块是没有皮肤的。
2026-11-03 23:49:31 +08:00
mula.liu b6a1df6dfd 反馈四级表面全部自绘:吐司、确认框、提示条、Tooltip 不再用出厂件
症状(用户原话「整体修改系统中的所以提示窗、完成后的反馈 tips 等。不要使用默认组件」):
   ① 55 处 `notify()` 落的是 antd 出厂 `<message>`——页面顶部正中一颗纯黑药丸,只有
      「一个图形 + 一行白字」:说完了「保存成功」却说不完后果(哪个版本、几个镜头、
      能不能撤销);3 秒准时消失且**悬停不停**,错误里那句长文案根本读不完;同一次
      批量操作连点五次就在原地叠五颗一模一样的胶囊;站内每一张卡、每一个信息块都有
      描边、圆角、色块图标,只有它是另一家的长相。
   ② 12 处 `window.confirm()` 弹的是**操作系统**的窗口:主题、字号、按钮、层级、语言
      全由 Chrome/macOS 决定,「会删掉什么、影响哪些产物」整段挤成一行灰字,不可恢复
      的删除和有代价但可逆的切换长得一模一样,用户只能条件反射点确定;它还是同步阻塞
      的,页面脚本停在原地,动画和轮询全冻住。
   ③ 页面里的提示条是 antd `Alert` 直封装,跟 R16.3 那把唯一的语义底纹尺(`BLOCK_TONE`)
      是两套皮肤,同页并存;而且它没有 action 位——App.tsx 那条「后端连接异常」要挂
      「重试」,只能绕过 kit 直接 import antd 的 Alert,R8 那道墙就是这么被自己的兜底
      页凿穿的。
   ④ 纯图标按钮的说明(R11 的唯一出口)仍是 antd 出厂 Tooltip:`colorBgSpotlight` 走
      反色文字基准,浅色下是一块死黑、深色下比正文还亮,跟站内浮层没有共同语言。

做法(四级从同一张语义表出发,`components/ui/tone.tsx` 是唯一的色调与图形来源):
   · 语气表 `tone.tsx`:`ok/bad/warn/info/loading` 五档 → 底纹 `TONE_TINT`、图形
     `TONE_ICON`、朗读名 `TONE_LABEL`、antd 词汇映射 `NOTICE_TONE`,色值全部取 antd
     语义 token,页面里不出现新色。
   · 吐司:状态留在 `stores/notice.ts`(**55 处调用点一个都没改**),皮肤换到
     `components/ui/Toast.tsx`——右下角堆叠卡片、语义色块、标题 + 明细两层、底部倒计
     时条、悬停/聚焦时动画与计时器同时暂停、同文案同语气去重成「×N」、同屏最多 5 颗
     (超出挤掉最旧);`notifyLoading()` 改成 `startLoading()` 返回 `done()` 句柄,
     进行中的那颗原地换语气换文案,不再「消失一下再弹一颗」。
   · 确认框:新增 `stores/confirm.ts` 的 `confirmAction(): Promise<boolean>` +
     `components/ui/Confirm.tsx`(浮层唯一实现 kit `Modal` + 语义色块 + 两层文案 +
     图标按钮)。12 处原生调用清零,问话只留一句、后果写进 `desc`、主按钮把动作写成
     动词(「删除 / 继续切换 / 仍然关闭 / 归档」),`danger` 给红描边。外层函数本来就
     全是 `async`,一行 `await` 读起来和原来的 `if` 一样顺。已有一张开着时后来的请求
     直接判取消——连按 Esc 不会排出一串窗口。
   · 提示条:`Notice` 不再借 `Alert` 的皮肤,改读 `BLOCK_TONE`(与 `<Block>` 同一把
     尺),左 20px 档色块、两行文案,新增 `action` 位与标准图标按钮关闭键;props 与
     原来完全一致(含 antd 词汇的 `type`),32 处调用点零改动。App.tsx 的系统异常条与
     ErrorBoundary 的兜底条从裸 antd `Alert` 收回 kit,并补上「重试」按钮。
   · Tooltip:`theme/antd.ts` 只换两个 token(`colorBgElevated` 底 + `colorTextBase`
     字),明暗自动跟主题、不引入新色值,描边与阴影那一圈在 `app.css` 的
     `.ant-tooltip-inner` 补。不换自绘件:定位、延迟、触屏、aria-describedby 是它的
     本职,「不要用默认组件」指的是那几张**反馈表面**。
   · 两个宿主 `<ToastHost/>` / `<ConfirmHost/>` 挂在 `app/providers.tsx` 而不是
     App.tsx:反馈队列是跨页面的全局状态(换页要清空、灯箱与抽屉之上也要显示),而
     App.tsx 只画工作台,登录页走另一棵子树——挂在 Provider 层两边才是同一个长相。
   · `app.css` 新增 38 条规则(`.nex-toast*` 17 / `.nex-confirm*` 12 / `.nex-notice*`
     9),尺寸全部读 `--ant-*`;确认框的描边用 `:has([data-tone=…])` 落在 `.ant-modal`
     上,为此给 kit `Modal` 加了 `className` 形参。抽屉/弹窗的吸底动作条交给
     `ActionGroup`(同一套自动竖排量法),窄屏不再折成 2 + 1。

验证:`npm run typecheck` / `build` 绿;`scripts/ui/feedbackcheck.py`(本轮起的反馈表面
探针)明暗两档 0 违规——出厂 `message`/`Alert`/`window.confirm` 在 DOM 里已全部查不到,
吐司只有右下角一个 region、每颗都有色块与倒计时。反向验证:临时把一颗吐司换回
`message.success`,探针当场点名。

⚠ 本笔同时携带并行会话在途的改动,如实记账:`styles/app.css` 是整文件提交的,其中
`nex-head-stack`(4 行,配套 `Panel.tsx` 的 `<576` 卡头换行,本轮一起才自洽)、
`nex-steps` / `nex-opt-cell` / `nex-tag-text`(5 行,选择器暂时悬空,调用方在
`components/ui/{Steps,Status}.tsx`,那些文件留在他们那笔)共 9 行不是本轮主题。
2026-11-03 23:43:48 +08:00
mula.liu e5ccbe0651 内容页页头只剩一个实现:门牌卡改成「菜单同款图标 + 一级标题 + 主操作同排」,眉标删掉
症状:用户第 12 轮原话「内容页 Header 重写,只保留节点名(1 级标题)+ 描述说明。
标题前一个和左侧菜单一致的图标。右侧的主功能入口要对齐」。当时站内有两套页头
(`PageHead` 给全局页、`NodeHead` 给项目七站),七站门牌上还压着一行眉标
「项目环节 · 第 N / 7 站 · 名称」——这句话侧栏当前项、顶栏控制台、概况抽屉已经各说
一遍(R18);图标是环节名首字符自拼的色块,和侧栏那只图形只是「碰巧同类」;主操作
挂在**整块页头**的垂直中线上,而七站的职责说明有的两行有的一行,实测同一颗主按钮
在七页的 y 坐标各不相同,概览页没有动作时中线还空着一截。

做法:①`app/layout/nav.tsx` 新增 `navItemAt(pathname)`——先查 `globalNav` 精确路径、
再查 `projectModules`,把菜单项那个 ReactNode 原样交给页头,菜单与门牌读同一份图形,
物理上不可能不一致;②`components/ui/Page.tsx` 删掉 `NodeHead` 与它自带的 `moduleAt`,
`PageHead` 成为全站唯一实现:第一行 `.nex-pagehead-title`(色块图标 + `Title level=3`)
与 `ActionGroup auto={false}` 同排两端对齐,第二行 `w-full` 的 `meta` + `sub`;新增
`icon` 属性(缺省反查菜单、`null` 明确不放),不在菜单里的三页(账号 / 用户管理 /
手册)显式补 `IconUser` / `IconTeam` / `IconBook`;③`app.css` 的 `.nex-nodehead` 改名
`.nex-pagehead`,新增 `.nex-pagehead-title { min-block-size: var(--ant-control-height) }`
——主按钮的 y 由这条几何保证,不靠页面垫 margin;色块从单类扩成一族
`.nex-stat-mark` / `.nex-pagehead-mark` / `.nex-brief-mark`(32 / 32 / 20 共用一套配色
与圆角,`--nex-stat-tint` 缺省落回主色),概况抽屉那七行同步降到 20 档;④七站与规范
(R18 行、§6.5 的四层表 ③ 与那条「`NodeHead` 是 `PageHead` 的一层皮肤」)一起改写。

为什么把「对齐」写成 CSS 而不是逐个页面调:只要中线还挂在整块页头上,任何一句说明
文案变长都会把七页的按钮重新错开;第一行定高之后,改文案只会长第二行。
1440 实测 13 个内容页:门牌唯一、标题行高恒为 32、图标 32×32、主操作右缘一律 1391、
中线一律 109.0(含无动作的概览与账号);430 档主操作折到下方、无 console error。
2026-11-03 22:40:16 +08:00
mula.liu 19bc63ba44 工作台外壳让位:ProjectDetail 一个可见块都不渲染,七站页头全部换成 NodeHead
症状(2026-11 第十一轮 · 用户「要进一步把各级的信息归拢并提供交互的层次清晰」):项目身份
在外壳被说了两遍——那条面包屑工具条写着项目名 + 镜头/合格/任务/成本 + 「展开概况」+
「删除项目」,展开后的 4 张指标卡加 12 节点流程条坐在正文上方,每一站都要先滚过这两屏
才看到自己真正的内容;「分镜与脚本」正文最重(看板 + 编辑抽屉),以前只能靠
`useBriefStore` 把概况折起来,等于用一个偏好去补层次划分的漏洞。概览页页头上还坐着一颗
「归档项目」——那是**项目级**动作,却出现在**环节级**位置上。

做法:①`pages/ProjectDetail.tsx` 重写成纯数据壳:按路由 `loadProject` + `startPolling`
(卸载必停,否则离开工作台后每 6 秒还在请求上一个项目)、三种兜底
(`Loading` / `Empty` / `ErrorText`)、`<Outlet />`,其余全部删掉——面包屑工具条、
「展开概况」按钮、`StatGrid`、流程进度 Panel、删除二次确认都不再渲染。
②`stores/project.ts` 删掉 `useBriefStore`(连同 `BRIEF_KEY` 与 `initialBrief()`):
概况整块搬进了顶栏控制台展开的抽屉,「折叠概况」这个偏好本身不再成立。
③七站(流程概览 / 资产管理 / 分镜与脚本 / 任务调度中心 / 质检与审核 / 时间线合成 /
导出与成本)把 `<PageHead>` 换成 `<NodeHead>`,属性一律不动,只改组件名与注释里的名字;
`Overview.tsx` 额外删掉页头那颗「归档项目」按钮和它的 `setArchived`(`isArchived`
还被流程状态文案用着,留着),流程概览这一页从此只回答「流程走到哪、下一节点缺什么、
在总控台下什么指令」。

为什么数据装载还留在外壳而不是搬进抽屉:workflow 与 stats 同时被顶栏控制台、七站正文、
概况抽屉三处读,读的是同一份 `stores/project.ts`;轮询放在路由壳层一次就够,抽屉关掉
也不该停止刷新项目状态。层级于是变成干净的四层——顶栏胶囊(项目入口)→ 抽屉(项目层)
→ NodeHead(环节层)→ Panel(内容层),每一级只在属于自己的那一处发言(R18)。
2026-11-03 21:27:30 +08:00
mula.liu 787a687238 顶栏那颗胶囊改成全站唯一的「项目概况」入口:点开右侧抽屉,项目层只在这一处说话
症状(2026-11 第十一轮 · 用户第 2 条原话「上面那个项目总览、展开、归档(删除)和顶部
系统 Header 的项目总览应该整合到一处(要不保留最顶部作为入口,点击展开侧面的面板,把
项目概况、操作按钮都放到那个对应的面板中)」):同一条项目身份在一屏里说了三遍——顶栏
流程控制台(名称·状态·进度·当前节点)、工作台外壳那条面包屑工具条(项目名 + 镜头/合格/
任务/成本 + 展开概况 + 删除项目)、概览页页头(归档项目);而它点下去是「跳流程概览」,
既不是看项目详情也不是做项目操作,语义含混。另外控制台以前只在 `wide` 才渲染,
900~991 与手机档整块消失,窄屏根本够不到归档与删除。

做法:①新增 `app/layout/ProjectBriefDrawer.tsx`(约 207 行)= 项目层唯一载体。
`Drawer` 宽 `min(620px, calc(100vw - 32px))`,标题是项目名、副标题「状态 · 流程 83% ·
720p / 16:9」;正文自上而下:`ErrorText` → 「项目身份」Panel(`Info` 回显画幅/分辨率/
题材/时长/默认模型/创建时间/简介)→ `StatGrid cols={2}` 四张指标(镜头合格、时长、
任务、成本)→ 「流程进度」Panel(`WorkflowBar compact`,容器自适应网格)→ 「项目环节」
Panel 七行 `.nex-brief-row`(图标 + 序号 + 站名 + 右端汇总状态 Tag,当前站标「当前」)
→ footer「返回项目总览(text, mr-auto)| 归档/取消归档 | 删除项目(全站唯一一颗
primary + danger,点第一次变「确认删除」并在正文里出一条 danger Notice 说明会连带清除
分镜、任务与素材)」。数据一律读 `stores/project.ts` 那份 6 秒轮询,抽屉不发第二个请求;
认「加载成功的那份数据自己的 id」而不是路由号,项目 404 时不会残留上一个项目。
列数跟着视口降档(`Grid.useBreakpoint()`:sm 以下 `Info` 收单列、简介那条 span 同步降),
否则 `Descriptions` 会报「Sum of column span in a line not match column」。
②`app/App.tsx` 把开合状态记在外壳(`briefOpen`),抽屉挂在 `MediaLightbox` 旁边而不是
任何路由里——它是跨七站的常驻面板,离开某一站不该关掉。
③`PipelineConsole` 从 `NavLink` 改成 kit 的 `<Button type="text" className="nex-console">`
(它是展开/收起一段内容,不是导航;R8/R15),带 `aria-haspopup="dialog"` +
`aria-expanded` + 尾部随开合翻转的下箭头;`AppHeader` 的渲染条件从 `projectId && wide`
放宽成 `projectId`——窄屏不许把唯一入口弄丢,轨道与状态由它自己的断点隐件(实测 375
整块 174×32,与右侧工具簇留 16px,Header 无横向滚动)。同一处还改了项目名的收缩份额:
原先 `flex-[0_1_auto]` 让「当前节点:…」那段散文先把名字吃到只剩 30px,现在名字
`max-w-[200px] flex-none` 不给收缩份额,额度不够先让散文缩到 0(1440 实测名字 149→178
可整条读完)。

为什么用右侧抽屉而不是弹窗:这是「随时查一眼项目全局」的辅助面板,遮罩之下正文还在原地,
关掉就回到刚才那一站,不需要重新载入;跳转型入口(七站列表)也放在同一块里,看完顺手就过去。
项目级的归档/删除只出现在 footer,与它们的作用域(整个项目)对齐,而不是散在页面级位置上。
2026-11-03 21:27:17 +08:00
mula.liu 401deb84ea 项目七站的页头坐进自己那张有底纹描边的面板:新增 NodeHead,页头不再裸浮在正文上
症状(2026-11 第十一轮 · 用户第 1 条原话「项目中切到每个节点应该是其对应的 Header,
这部分应该放入一个有样式的单独面板中」):环节页的页头是一行裸浮在页面底色上的字
(标题 + 一句说明 + 右端按钮),它和正文第一张卡之间只有 16px 空白,读起来像「正文上面
漏了半句话」;上面还压着外壳那条同样裸着的面包屑工具条,两层没有边界的东西贴在一起,
分不清哪句说项目、哪句说这一站。另外这一站在整条流程里的位置在页面上从来没有出现过
——侧栏只有七个名字,没有序号,读者不知道自己走到第几步。

做法:①`components/ui/Page.tsx` 新增 `NodeHead`,它是 `PageHead` 的一层皮肤而不是新组件:
属性完全同 `PageHead`(title/sub/meta/actions),内部就是 `<Panel size="small"
className="nex-nodehead">` 包一个 `PageHead className="!mb-0"`,所以七站换过去只改一个
组件名;眉标「项目环节 · 第 N / 7 站 · 名称」由 `useLocation` 拿 `nav.tsx` 的
`projectModules` 反查路由算出,页面不参与计算,七站的算法只有一份,全局页算不出站次
就自动不出现眉标;顺手给页头的 `ActionGroup` 传 `auto={false}`——页头自带窄屏方案
(整组满宽 + 按钮等分),不需要再被翻成竖排一列。
②`styles/app.css` 落三条皮肤:`.nex-panel.nex-nodehead` = 主色 7%(深色 14%)斜向渐变
收进卡底色 + `colorPrimaryBorder` 描边 + 体 12/24 内边距,它是全站唯一带主色描边的卡,
主次不再靠字号硬撑;`.nex-nodehead-mark` = 眉标左端那枚 20px 主色块(与统计卡那只 32px
色块同族);另把 `.nex-console`(顶栏项目胶囊)与 `.nex-brief-row`(概况抽屉里的环节行)
两条皮肤一起放在这里,让下一笔的组件只带逻辑不带样式。`.ant-*` 只出现在 app.css(R8)。
③`lib/pipeline.ts` 补 `NODE_MODULE`(12 节点 → 七个环节页)与 `moduleState()`:顶栏那条
轨道回答「12 个节点走到哪」,环节页与概况抽屉回答「这一站算什么状态」,两者必须用同一
张表换算,否则侧栏加一个环节、状态汇总还在说旧话。

为什么做成皮肤而不是七个页面各写一张卡:七站是同一个层级,底纹、描边、眉标算法必须
一模一样,页面只该决定标题、说明和主按钮;算法一旦散在七个文件里,下一轮加第八站就
有七处会漏。站次信息放在眉标而不是标题里,是因为标题那一行已经承担「这一站叫什么」,
再挤进序号会把主操作挤到第二行(违反「能一行放完绝不分两行」)。
2026-11-03 21:26:55 +08:00
mula.liu ad4cdcb52b 八个项目子页逐页改完:主操作提进页头、只读计数改回显块、表格行高按内容定额
症状(用户第 1、2、6、7 条 + R17):①各页的主操作散在卡头或工具条里——出片藏在
「合成导出」表末尾、入队藏在「分镜任务清单」卡头、三个批量动作和六个只读计数挤在同一
张卡头;「+ 新建人物」挂在页签条右端把标签压扁。②成本预估那四个数不能点却穿了可点
chip 的皮肤,还裸浮在两张卡之间的页面底色上。③表格行被内容撑高:项目概况节点表 81px、
调度清单 125px、质检结论表 255px(一条长说明在 464px 列里折 13 行)、生成记录 227px。
④审核页主信息在右,左栏却和右栏等宽(第 7 条点名的那张截图)。

做法:①八个页面统一加上 PageHead(24px 环节名 + 12px 职责说明 + 图标主按钮),
卡头只留这一张卡自己的动作;Library 的页签条独占一行,新建按钮从
tabBarExtraContent.right 提进页头,执行中的忙态降进搜索条右端;②不能点的数字一律
走 Info 回显(label 带底纹),Delivery 那组再套进 Toolbar 让它落在卡片里而不是页面
底色上,概览/调度的设定回显同样换成 Info;③列宽按内容定额:短列收到 40/72/84/140,
长文列吃剩余宽度并配 Clamp 封顶一到两行、全文挂 title,行高回到内容本身(实测三张
超标表最高行分别降到 61 / 55 / 49px,tableaudit 违规 0 张);④Review 的左右栏改
spans={[9, 15]},430 档把审核结论的 Segmented 标签缩成「合格 · 进时间线」不再截断;
⑤卡内回显固定 column={2}(Library)或 column={1}(Overview):antd Descriptions 的
span 不跟断点走,窄屏降到 1 列时空白项当场报 Sum of column `span` in a line not match。

为什么:一屏的「这一页能干什么」只有页头一个答案,主操作混在卡头里就得逐个卡片找;
回显与控件共用皮肤会让用户去点不能点的东西;而定宽列 + 封顶行数是把行高从「内容
随机决定」变成「设计决定」的唯一办法,宽度不够就交给 title。
2026-11-03 20:21:09 +08:00
mula.liu 3404d7874f 全局五个页面换成 kit 的信息块:统计卡配色块图标、只读回显改 Info、项目层压成一条面包屑
症状(用户第 1、2、7、8 条):①Dashboard 与 UserAdmin 的统计卡还是光秃秃的文字,
五张卡排成 3+2 右下角缺一张;项目表「项目」列三行 79px 把整表撑高(R17)。
②Account 把登录名、角色塞进 disabled 输入框,灰盒让人以为能改。③Help 整站只有
开头那块 primary 底纹封面是彩色的,读者把它当成提示条。④ProjectDetail 页头写着
「← 项目总览 + 已交付 + 当前节点」再加 24px 项目名,这四样在顶栏流程控制台全都有,
八个子页每一页首屏都要先读一遍重复信息。

做法:①两个总览页的 Stat 全部配上传递语义的色块图标,StatGrid 去掉写死的 cols
交给 grid 的 flex 档(≥1200 一排放完),项目表的片名列与规格行各封顶一行、全文挂
title,删掉 cellWrap 让行高回到内容本身;②Account 的只读身份项改成 Info 回显
(column=2、卡内加 nex-info-in-card),可编辑的显示名与邮箱才留在 FormRow 里;
③Help 的封面卡换成与其他 11 页同一把尺子的 PageHead(24px 标题 + 12px sub),
四张能力标签降为页头眉标,底纹与描边一并删掉;④项目外壳改为一条 Toolbar 面包屑
(左端只回答「我在哪个项目里」,右端放收放概况与删除项目),状态/进度/当前节点交还
顶栏,briefLine 只在概况折叠时出现且只剩顶栏没有的四项;⑤五个页面的外层 div 统一
换 PageStack,ErrorText 去掉自带的外边距(间距归 stack 管)。

为什么:信息块的底纹、色块、图标在 kit 里只定义一次,页面负责的是「给哪个数、配哪个
图标」;重复的项目身份同屏出现两遍就是第 8 条要清掉的东西,而只读回显用禁用输入框
会发出「这里可以改」的错误邀请。
2026-11-03 20:20:43 +08:00
mula.liu 50e0da3b31 侧栏二级菜单去掉「当前项目」这一层:项目身份全程只在顶栏控制台说一遍
症状:侧栏一级分组叫「当前项目」、title 拼项目名,底部还挂一块「当前节点」状态条,
      而顶栏的流程控制台从进项目到交付一直在显示同一份「项目名 + 当前节点 + 进度」——
      同一份状态两个出处,两边刷新时机不同就出现「侧栏还在讲上一个节点」的错位;
      菜单也因此看着像三级(分组标题 → 项 → 子项)。
做法:① 一级分组改成中性词「项目环节」,title 不再拼项目名;AppSider 删掉底部
         状态块与 useCurrentStageNote,App.tsx 不再为侧栏去读 project store
         (连带省掉「项目 404 时残留上一个项目名」那处补丁)。
      ② nav.tsx 的注释跟着改口径,四枚图标的换图理由同步(资产管理不再与父级同图)。
      ③ 流程控制台的状态标签改用 kit 的 Tag(中性底 + 语义圆点):它原本写 antd
         预设色名 color="success",渲染出 #f6ffed 一块浅绿——顶栏上「已交付」的项目
         长期顶着这块绿,正是用户要退役的那批浅绿标签的最后一个来源。
为什么:菜单只到两级是产品口径;「谁显示项目身份」只需要一个答案——顶栏控制台
      跨路由常驻,侧栏只回答「这个项目的七个环节我在哪一步」。
2026-11-03 20:19:17 +08:00
mula.liu 69bd8937ca 组件层补齐信息块三件套:统计卡配色块、回显改用 Descriptions、卡头不再被压成竖排
症状(用户第 6/7 条:「统计使用的信息块都加入底纹」「大的统计卡片…每个页面逐个优化」
      以及 430 档实测):
      ① 回显有两种假象——灰底圆角盒 + label 在上(长得就是禁用输入框,旁边真输入框
         时分不清哪个能填)、只读值外面再套一圈描边 Tag;同一屏「这块是信息」靠脑补。
      ② 统计卡与页面底色同色,四张并排时先看到四块同色灰、数字反而最弱。
      ③ 标签把语义色铺成底:满屏「完成 / 已交付 / 合格」各一块浅绿,绿色从语义色
         变成第二个品牌色,还把数字压住。
      ④ 430 档卡头:right 那句「下一步:时间线合成 + 配音/字幕/混音 — …」要 400px+,
         而 antd 的卡头是不换行的 flex,标题只剩 15px ⇒「流程进度」一个字一行。
      ⑤ 768 档 /assets 筛选条:Col 的断点量视口,正文 = 视口 − 侧栏 224 − 内边距 32,
         5 等分在 md 给 3 列时每格 158,选中值「全部类型」77px 被裁成 53px。
做法:① 新增 Info(antd Descriptions):label 列降一档字号 + text-tertiary +
         --nex-info-label-w 定列宽,值列 overflow-wrap:anywhere;卡内回显挂
         nex-info-in-card 去掉双层描边;配套 Value(title) / Count / Clamp 三只小件。
         统计卡 Stat = Card + Statistic,识别度交给数字左侧 32px 语义色块
         (color-mix 12%,深色档提到 18%),卡面回到 antd 自己的 colorBgContainer。
      ② 标签底一律中性 fill-tertiary(深色 8%),语义只由头部 6px 圆点承载
         (--nex-tag-tint 由 tone 映射到 --ant-color-*);Notice/Alert 保留 antd 语义底。
      ③ .nex-panel .ant-card-head-wrapper{flex-wrap:wrap} + .ant-card-extra
         {flex-shrink:0;max-width:100%}:宽屏同排读完,窄屏整句掉到第二行
         (实测 430 标题 292×24、1440 一字未动)。
      ④ Controls 的 ROW_STEPS 按正文宽整体降一档(5 等分改 ≤1600 四列 / ≤1200 三列 /
         ≤992 两列 / ≤576 单列),新增 OptionGrid;.nex-ctlbar-grid 里 --nex-ctl-w
         让位给列宽,同一行控件右缘必然对齐;新增 colSpans(cols,oneAt,steps) 支持逐档列数。
      ⑤ Table 补动作列与行高纪律需要的口子;RecordAudio 的麦克风状态条改中性底。
为什么:页面不准 import antd(R8)、.ant-* 只准出现在 styles/app.css、#hex 只准
      theme/antd.ts——皮肤集中在这一层,19 个页面才共用同一把尺子;
      antd Descriptions 的 span 不跟断点走,所以项里写 span 的回显 column 必须是定值
      (已在 §13.1 登记)。色值一律由语义变量比例混合,明暗两档自动跟主题。
2026-11-03 20:18:59 +08:00
mula.liu 8c930cc1ef 19 个页面按 antd 口径重排:一行放完、按钮带图标、信息块带底纹、重点色只给关键动作
症状(用户三轮截图指向同一件事:控件换成 antd 了,版面还是手写的):
      ① 该一行的排成两行——项目列表把「搜索 + 状态」塞在卡头右端,两个带标签
         的字段折成一竖列,右边空出半张卡;筛选条里所有字段标签在上,
         一次横向扫读被排成填表。
      ② 按钮全是纯文字——AI 生成、上传、引入项目、清除筛选、下达指令、执行计划
         ……读者只能逐字读,一排按钮长得完全一样,扫不出主次。
      ③ 统计块和页面底色同色——项目总览四张指标卡、质检页的计数、抽屉里的回显块
         全是「白底白框」,看不出哪块是信息。
      ④ 重点色滥用——一个容器里三颗 blue primary 并排,等于没有主次。
      另有一批残留:裸 <h2> 当页头、页签条独立一行漂在底色上、全选条是列表上方
      一整个只装一颗勾选框的虚线盒、侧栏里的指标卡按整页宽度选了 4 列、
      档位写成「≤1600 三列」结果 1440 上 5 张卡排成 3+2、手册 31 遍自绘卡片。
做法:① 筛选/工具条一律 Ctlbar + <Field inline>(标签在左、控件在右、同一行,
        放不下整条折行),全站 19 条 Ctlbar 内 27 个字段全部 inline,0 例外;
        筛选条按 antd 列表页口径从卡头右端移到卡头下方的正文里,卡头只留计数。
      ② 每颗按钮一只语义图标(icon={<IconX/>}),FilePick / RecordAudio 这类
        自绘控件也走 icon 槽;扫描脚本 inv2 复扫,页面侧 0 处纯文字按钮。
      ③ 统计与回显块统一带底纹(Stat / Block 默认档 / 中性 Tag),
        漂在底色上的裸标题、裸页签条收进 Card 的 title / sub / extra。
      ④ 一个容器只留一颗 primary:AI 生成、入队所选、保存资料、修改密码、
        新建长视频项目;其余降级为默认/text,危险动作用 text danger。
      ⑤ 版式残留逐页清:页头交还 PageHead/Toolbar,手册 31 处自绘卡改用
        Panel size="small" + Typography.Title(仍留在本页——规范:被第二个页面
        用到才提上 kit),指标卡按所在栏宽度选列(侧栏 2 列),
        栅格档位改到 1440 这一档,全选条并进卡头右端。
      ⑥ 手册 12 张插图用 helpshots.py 重拍:旧图还是上一套绿色皮肤,
        正文里写的「浅绿色标签」在插图上字面成立。
为什么:控件同价不等于版面同价——同一颗 antd Button,摆在哪儿、有没有图标、
      是不是这一片唯一的重点,才是读者判断「下一步点它」的依据。
      这四条写成规矩容易,只有逐页改完并由扫描脚本兜住,才不会下一轮又长回去。
2026-11-03 17:03:20 +08:00
mula.liu 5383954184 组件层收口到 antd 原生形态:骨架、表格、抽屉、统计块一律不再自绘
症状:前两轮只换了「卡片里面的控件」,容器这一层还是手写的——页头自己拼
      div + 私有字号阶,表格自己写 TableBox/WideTable 与滚动容器,抽屉挂
      getContainer={false}(结果遮罩压不住侧边菜单),标题在站内有四套尺子
      (手册自带 TAG_H1/H2/H3 + 页面各写各的),两栏版式有三套折列宽度。
      另两条是用户直接看出来的:统计块/回显块和页面底色一个颜色,
      「这块是信息」全靠脑补;筛选条两个字段的标签排到了控件上面,
      一条横向扫读的活被排成两行表单。
做法:① 骨架交给 antd——PageHead = Flex + Typography.Title,新增 Heading /
        Paragraph / Code 只留 level 一个参数,字号行高颜色全走 antd 排版档;
        Toolbar 明确「工具条也是一张只有卡头的卡」,左端坐 title 槽;
        Layout/Stack 的两栏换算统一到 grid.splitSpans(主 15 / 侧 9,
        ≤xl 折单列),页面不再各写各的 grid-cols。
      ② Table 改回 antd 标准用法 columns + dataSource,删掉 TableBox /
        WideTable——滚动、吸顶、空态本来就是它的内建能力。
      ③ 抽屉回到 antd 默认形态(portal 到 body),遮罩自然盖住整个视口。
      ④ 统计/回显一律带底纹:Stat 坐在 bg-fill-tertiary 的 Card 上,
        Block 默认档与无色调 Tag/Status 落 --ant-color-fill-tertiary;
        色值仍只在 theme/antd.ts 出现。
      ⑤ Ctlbar 从「贴底」改「垂直居中」,Field 新增 inline(antd horizontal
        布局:标签在左、控件同一行),narrow/wide 的宽度改交给控件列
        --nex-ctl-w——原先写在字段盒子上时,inline 的标签 nowrap + 控件列
        flex:none 一旦大于盒子就把控件捅出工具条(430 档 dispatch 溢出 54px)。
        新增 ActionGroup:按整组 max-content 决定落在哪一行,窄容器给 stack
        竖排等宽,治「一排里少一颗」。
      ⑥ 状态色不再抄派生档:浅色整套删掉,深色只抬亮一档;页面底色导出成
        SHELL_BG 供 index.html 的 theme-color 用,字面量不再抄第二遍。
      ⑦ 图标登记表补 IconTag / IconDragHandle(antd 拖拽排序示例的标准把手),
        media 下四只自绘控件改走 icon 槽。
为什么:容器自绘一处,全站就要为它写一套排版、一套断点、一套深色补偿;
      换到 antd 原生形态后这些补偿可以整段删掉,闸门也才有统一口径可查。
2026-11-03 17:02:27 +08:00
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 d853560fa7 前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场
外壳三段交还 antd:Layout.Header(56) / Layout.Sider 两级 Menu / Content。
全局多页签条(PageTabs + stores/tabs)删掉——内容页不做多 Tab,菜单只到两级,
指定项目的二级挂在「当前项目」下;页签回到页面内部:
资产 3 类、项目资产 4 面板、模型 4 能力、分镜 4 检查器。
Tabs(换看不同内容)与 ViewSwitch(同一批数据换排法)的判据写在 components/ui/Tabs.tsx。

删:theme/{metrics,palette,css-vars}.ts、icons/{Icon,glyphs}.ts、hooks/use-narrow.ts、
app/layout/{AppBar,SideNav,PageTabs,NoticeToast}.tsx、nav.ts、components/ui/Rail.tsx。
尺子只改三类(品牌色 / 表面色 / 少量结构性 token),几何、字阶、圆角、间距、断点
一律等于 antd 默认;图标全站唯一入口 components/icons/index.ts(语义登记表)。

一并收进本轮与并行线程查出的静默故障(tsc/build 全绿但页面是坏的):
- frontend/package.json 结尾的字面量 \n;line-height 被写成 px 让全站文字塌陷;
  Tailwind v4 @layer 层叠反转(preflight 与 antd 收进同一层,R13)
- 值型控件的宽度预算错给了「标签 + 控件」整字段,23 处下拉当前值被省略号咬
  (91>70 / 77>70 / 77>46)::has 规则把 flex-basis 交回内容 + 面板按内容加宽折行;
  整句型选项值(时间线字幕/语音来源/原声策略、交付字幕)挂 nex-prose-value 显式登记
- ViewSwitch 传 block 把「全部素材」最后一个字裁掉半格;AgentConsole 一键指令双重省略号;
  总览「下一步建议」按钮在 430 档捅出视口
- 时间线 / 交付页在没有版本时白调 /timeline 与 /timeline/report,两条 404 换来一片假绿
  (先拿版本清单,清单为空就别问)

注:并行线程「迁移前端到React+Tailwind」在同一份工作区落了下拉档宽、下拉面板加宽折行、
上述时间线 404 闸门与浮层底部动作口径(R14),本 commit 一并收进,不代表那条任务已收尾。
2026-11-03 12:42:16 +08:00
mula.liu c90a2c4446 检查点:保留手写图标体系与尺子,作为 antd 重写的对照 2026-11-03 10:15:14 +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 b0086fb487 审核台两列统一成「标签在上」,立第 7 条硬规则 R7:同一个容器只用一种字段形态。
症状:/review 人工审核那列,审核人 的输入框比 问题描述 的文本框右移 47.3px,同一列量出三种控件左缘
(1353/1425/1472)。根因不在 CSS——那一列本身混了两种形态:审核人/任务优先级 走行内 Field(标签在左,
标签 66px 或 190px),问题描述/覆盖提示词 走 FieldBlock(标签在上),两种形态的控件左缘天生差整个标签列宽,
谁都对不齐谁;标签宽还随字数漂(覆盖负面提示词(可选)实测 113.3px)。

改法:合格 / 不合格 两列 4 处 FormRow 全部加 stack,容器级统一到底,不再逐字段挑形态。
豁免两类并由探针按 role 跳过:滑杆行与勾选行——Temperature 这种「标签即说明、轨道即整行」,
本来就没有「控件左缘」这个概念,混排判据对它们是误报(第一轮 nex_align4 就把 models 抽屉报成混用)。
2026-11-02 16:17:20 +08:00
mula.liu 670f4973e5 控件行为层选型落地:Radix primitives(headless)+ 自有皮肤,原生控件清零,字段标题同时被对齐。
用户问「要不要换一套标准控件组」。答:要,但只买行为不买皮肤——antd/MUI/Arco 自带 token(控件高 32px)
与我们的 --ctl-h-main(38px)并存就是两套尺子,再加一份 preflight 跟 Tailwind v4 base 层抢深浅主题,
而深色 studio 视觉本来就得覆盖八成,省下的工时会全数还回去。选定 Radix primitives + CVA 皮肤
(即 shadcn 架构,源码 vendored 在 components/primitives/),Radix 管 portal/定位/翻边/视口避让/焦点圈定与归还/
键盘/Esc 分层/锁滚动,尺寸配色仍只来自 tokens.css。

症状一:字段标题与控件不对齐,/review 同一列里控件左缘出现 1353/1425/1472 三种,最大右移 47.3px。
根因不是排版:Field 同时带 [&>*]:min-w-0(让长控件能收缩)与 min-w-(--label-w)(撑住标签列),
两条特指度都是 0-1-0,Tailwind 把 min-w-0 排在自定义值之后 → 66px 下限被无声清零,控件左缘跟着中文标签字数漂。
改法:下限换到压得住的选择器 [&>span:first-child]:min-w-(--label-w)(0-2-0),hint 栅格的标签列
从 auto 换成 minmax(var(--label-w),max-content);尺子补 --field-label-w:66px(全站 193 个行内标签的 p90)
与 --label-w 作用域开关(FormRow 抬起、Ctlbar/ChipBar/CardActions/Pager 压回 0,工具条不参与表单对齐;
≤560px 一行一个字段没有对齐对象,直接归 0)。

症状二:勾选框是 macOS 系统绿圆角块、滑杆是系统 range、分页还有个裸 select,深浅两版主题各长一个样;
「按一次 Esc,下拉连背后的抽屉一起没了」。改法:checkbox/range/menu/dialog 全部接进 primitives
(Checkbox 尺寸收成 --check-size 14px、触摸档 18px),每层浮层带 data-nex-layer,
页面级快捷键第一行 if (floatingLayerOpen()) return,层级只用一套(遮罩 100/抽屉 101/模态 111/下拉 400);
手写的 use-outside-click 删掉,外点关闭交给 Radix。依赖清单同步等于实际 import:卸载 8 个装了没在用的
@radix-ui/*(tabs/tooltip/label/separator/progress/radio-group/switch/visually-hidden),
顺带删掉这条死链上唯一消费它们的 ui/Toggle.tsx(0 个用户),现在 5 个 radix 包全部有 import。

实测:nex_align4.py 全站 30 个表单字段,五项判据(同列控件左缘不一致 / 标签压控件 / 控件溢出字段盒 /
行内标签与控件中心不齐 / 同列 stack-inline 混用)全 0 组、0 console error;nex_ctl4.py 31 项控件行为回归
31/31(抽屉+下拉叠加、Esc 只关一层、锁滚动不横跳、点文字切勾选、滑杆键盘可调、菜单方向键与焦点归还、
真实鼠标开关抽屉滚动全程守恒 101→101→101);源码里裸 select/checkbox/range 残留 0(grep 仅剩 3 条注释);
tsc --noEmit 与 npm run build 均 EXIT=0。
2026-11-02 16:17:09 +08:00
mula.liu e70c508044 修掉下拉浮层被自己 layer 上的 fixed 废掉避让:Radix 的 translate 在它外层 wrapper 上,面板再写 position:fixed 就脱离文档流、wrapper 量到的高度是 0,flip/size 全按 0 高算——1280x720 贴近视口底边的下拉要么该翻不翻被压成 35px,要么翻了不减高度掉出屏幕 125px,右侧还会溢出视口 45px;去掉 fixed 后 19 个下半屏下拉全部完整落在视口内、三个宽度下无横向裁切。顺手把 /account 两列与三列两张卡也接进 FormGrid 基准栅格,多栅格容器错位归零。 2026-11-02 15:20:16 +08:00
mula.liu 139db20320 新增 FormGrid 表单级 12 列基准栅格:列边界从每条 FormRow 上收到表单作用域统一定义一次,FormRow 的 cols 退化为「这行几个字段」= 每字段跨 12/cols 格,横向间距也归表单管(基准栅格里换列间距会让整条列线漂 1.7px),一行一项与 width=full 用 :only-child/data-full 铺满;模型抽屉、分镜检视器、素材抽屉等 7 个多行表单容器接入,字段标题错位从 110px 降到 0;Slider 标签并入 LABEL_CLS 与 Field 同尺;孤立 FormRow 保留原 auto-fit 路径零改动。 2026-11-02 14:59:35 +08:00
mula.liu c5edd65d82 下拉控件迁入 Radix primitives:新建 components/primitives(Popup + CVA 尺子 + 共用 listbox 键盘 hook),Select/MultiSelect 全部改由 Radix Popover 接管浮层行为——面板宽度至少等于触发器、按最长选项展开到 440px 不再换行,两档触发器同字号同圆角,翻边/滚动/外点关闭交给 Radix;顺手修掉「点触发器自身关不掉面板」的 anchor 误判(Radix 把 handler 挂在真实被点元素上,原先的 currentTarget 比较恒真),并补上多选的首字母定位。表单公共 API 一字未改,页面 87 处调用零改动;旧的 use-popup/parts 手工定位已归档。 2026-11-02 14:46:44 +08:00
mula.liu 7fcfd2932b 标签统一收尾:调度中心页头的队列计数与总控台的镜头状态计数不再借 Chip 的 31px 胶囊皮肤,改成和旁边标签同档的 TagGroup,只读回显全部归到标签族 2026-11-02 10:50:56 +08:00
mula.liu 19db4ef3a0 我的账号与用户管理:表单改成明确的列栅格、规则说明落到字段下方而不是塞进 placeholder,登录设备标题把原始 UA 解析成「Chrome 155 · macOS」并限高滚动,用户管理的筛选条从面板头挪回列表上方、详情字段竖排、允许登录独立成行 2026-11-02 10:33:11 +08:00
mula.liu 72afec93fc 标签统一:Tag/Status/Badge 合并成一个壳(同一份度量 + 同一张色板),尺寸改成挂在容器上的 --tag-* 两档令牌(表格自动降 sm),新增 TagGroup 管住组内 6px / 组下 12px,只读回显不再用 31px 胶囊、页面手抄的标签皮肤全部收编;Field 的 hint 真正落地、FormRow 子项贴顶对齐 2026-11-02 10:32:48 +08:00
mula.liu 8614360ab7 控件几何统一:字段不再被 flex 拉伸、表单容器独占主尺寸档位、多行文本按 --ctl-h 倒推 padding、数字框去 UA spinner、裸 select 补主题化箭头、密钥眼睛贴回右缘 2026-11-02 10:04:57 +08:00