Commit Graph

89 Commits (98ea70d74f571f7f66c656aee69c9fbfb22bbf49)

Author SHA1 Message Date
mula.liu 98ea70d74f docs(规范): 阶段 8.5 六处落点 + 常驻探针计数与代码对齐(12 → 13 道)
批准书 §1 的 DEFERRED 要求「先梳理组织关系、只在可复现缺陷处局部修」,§9 要求
「设计规范更新」,所以规范层落了六处,且**不新建第二份规范**(尺子仍只在 UI规范.md):

`docs/UI规范.md`(+316/−11)
· §1.1.2 全站样式组织现状 + CSS Layer 迁移的 DEFERRED 决策:分层/未分层清点口径、
  当前层叠优先级怎么成立(Tailwind layers → antd → 未分层 .nex-* 覆盖层)、
  `@layer` 声明 0 条 / `!important` 4 条全在 reduced-motion 内、唯一那条压过
  `max-md:hidden` 的未分层规则(=L-1)、以及为什么真要迁就要连 preflight 一起想清楚
· §6.2.1 导航的两个状态与「故意不同的生命周期」(折叠=偏好走 localStorage /
  抽屉=一次性动作走 useState)+ 当前页对辅助技术可见(aria-current)的暴露规则与折叠档边界
· §6.5 「窄屏不许把入口弄丢」后补三通道:Hover / Focus / Touch,只在真的截断时弹,
  触屏档按 `matchMedia('(hover: hover)')` 能力收口(不弹),并登记 N-3 待真机复测
· §13.2.1 窄屏表格两套列档位:`useNarrowTable()` 口径、九张表各自方案表、
  「换列定义不换 DOM」的辅助技术理由、数据完整性对账方法(token 级失踪计数)
· §15 标题与 §15.12/§15.13:十三道常驻探针 + 一道反向验证,新增 semanticcheck 那条判据说明
· §16 第 9 / 第 12 步:改尺子的回归清单补上 `gateprobe` 十四条判据与 semanticcheck

`docs/NEX-对照与例外.md`(+8/−3):§8 响应式那行补本项目走的第四条路(窄档换 columns,
建议 NEX 补进 04 §8.2 → N17);§2/§3/§5 新增一行「验收手段」判定 = COMPLIANT(阶段 8.5
起有机器证据),并记下 NEX 08 只列要求不给证明方式;HEAD↔工作树语义读数改成本轮实测口径。

`AGENTS.md`(+2/−2):两处「12 道常驻探针」→ 13 道。这是 semanticcheck 加进来之后
文档与代码对不上的最后一处,现已全站 grep 无残留旧计数。
2026-11-08 14:50:30 +08:00
mula.liu 434370206c NEX 阶段 8.5·第6项:chunk 归属测量脚本(分析完实施 0 处)
批准书 §6 是「先分析,再实施低风险优化」。分析需要一个能回答「这一段字节是谁的」的尺子:
`build --sourcemap` 之后按每个 chunk 的 mapping 区间把模块字节归到文件,
得到组成 / 前十大依赖 / raw·gzip·brotli / 首屏闭包,全部实测、不抄构建器口径。

实测结论(详见 reports/NEX阶段8.5 §6):13 条路由**已经全部** `lazy()`,首屏闭包 7 个文件
在 before/after 完全同构(`ui-*.js` 1187.8 kB 是 rolldown 自动分组,不是本项目的手工分包决策);
首屏 raw 1486.24 → 1487.42 kB、gzip 453.87 → 454.33 kB、brotli 370.90 → 371.37 kB
(三次构建抖动 ≤0.25 kB,增量来自第 3 项的两套列定义);全部产物 +11 kB 全落在换页才拉的
lazy chunk。所以按批准书三条禁令:不抬 `chunkSizeWarningLimit`(警告仍在=C-1)、
不做没依据的全局分包、不改首屏结构 ⇒ **本轮实施 0 处**,只留下这把尺子。
2026-11-08 14:50:17 +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 5a10bfbfa6 docs(reports): 阶段 8 报告自查——改前那一下 ⌥↓ 不是「没反应」,是做了另一件事
收尾复核截图时发现报告把改前行为写轻了:§4.2 / §4.6 写的是「什么都不发生」,
而 shots-before 那张图上是**检查器被撑起来盖住了看板**。补采两棵树的 stdout 定性:

· HEAD:28 29 30 31 32 33 34 → 一字未变,吐司空,DOM 焦点仍在原卡(29);
  window 那条监听不判 altKey,Alt+↓ 被当成普通 ↓ 走 goShot(+1),此时没有选中态
  (shotIndex = -1),落点算到第 1 镜,select() 顺手把检查器打开。
· 最终树:→ 28 30 29 31 32 33 34,吐司「镜头 2 已后移到第 3 位」,焦点 29(跟着卡片走)。

所以改前的真实缺陷比「键盘做不到」更糟一点:这一下按键会**替用户做另一个决定**。
而 ⌥↑ 那一行确实是「什么都不发生」——goShot(-1) 在 shotIndex = -1 时取不到落点直接返回,
界面上没有任何一处回答「按过了吗」,两行分开写清了。

顺带把第一次只留图没留读数的缺口补上:shots-HEAD-transcript.txt / shots-final-transcript.txt。
证据目录本身按既有口径 gitignore(reports/*evidence/)。
2026-11-08 00:21:39 +08:00
mula.liu 8e3e4980cf docs(reports): 阶段 8 实施报告——四项批准决策的落点、实测读数与未解决清单
四项各一次提交(D16 1227003 · N16 0b9ea0a · D17/N7 ae4dd7f · N14 687bf5a)+ 插图收尾
7d844a9;NEX 子仓库反向落地两笔(63e36ec 的 04 §8.1/§8.2、c703f14 的 08 §2)。
报告按七小节交付:文件清单 / 前后差异 / 原因 / 规范符合性 / 命令与实测读数 / 前后截图 /
未解决项,并附全部执行过的命令(含 11 道常驻探针、九道 classaudit 闸、120 状态 visualcheck、
四支专项探针与两处 HEAD 反证)。

本轮把三件「写进规范但没人管」的事变成可对账的:断点登记(第 9 闸)、标签皮肤能写什么
(§1.1.1 实测能力矩阵)、拖拽排序的键盘替代(08 §2 新条款)。
另有两处刻意保留的不对称已在文档里说明理由:拖拽不报吐司而键盘必报(判据是「用户能不能
自己看见落点」),以及 <768 抽屉不持久化而 ≥768 折叠持久化。

未解决 7 条汇总在 §7,其中三条需要单独授权:.nex-* 自绘表面整体在 @layer 之外(属大规模
CSS 重写)、430 档顶栏读不出完整项目名、表格窄屏排布剩余 6 条 tableaudit 违规;
另有 N14 的读屏真机复核(VoiceOver/NVDA)缺位,属人工验证而非代码缺口。
2026-11-08 00:19:01 +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
mula.liu 0b9ea0a430 NEX 阶段 8·N16:断点治理装上机器闸,登记从「两份人写的表」变成一条可对账的规矩
阶段 7 把页面里 5 把裸 max-[1240px] 之类的私档改名成 --breakpoint-* 命名变体,
归名之后留下的问题是:「登记」这件事只剩两份人写的表(styles/index.css 的 @theme
和 UI规范 §4 那张表)加一句 grep。下一轮谁再写一个 max-[900px]:flex,编译得过、
像素也对,只有人眼能发现;反过来说,往 @theme 加一档却忘了同步 visualcheck.py 的
BP 表更糟——wantDisplay 会对这一档静默返回 null,断言悄悄不跑了,比报错更难查。

classaudit.mjs 新增第 9 闸 BP:尺子的唯一真相是 @theme 里的 --breakpoint-*,其余
四处(页面用词 / UI规范 §4 表 / 探针的 BP·BPORDER / 尺子自己的使用面)全部由这条
闸向它对账,五条判据——① 裸 max-[…]/min-[…];② 用了没登记的变体名(写错名字
Tailwind 不报错,只是这一档压根不生成规则);③ 登记尺子必须有且仅有一个使用者、
不得 0 使用者、必须被 §4 表收录(§4 那三条口径的机器化);④ 每档都要出现在探针的
BP 与 BPORDER 里且同名同值同序(顺序错了会挑错赢家);⑤ .css 里 @media
(max|min)-width: Npx 的 N 必须是登记值,否则页面归了名、样式表里再开一批私档白干。
主阶梯「该不该在这一档换排布」是 R9 的语义判断,机器量不出来,这条闸不管。

闸按 §15.1 的口径反证过 10 例(写坏→红且点名→还原复绿),含一条反向的反向:agent
这把尺子的口径是「一个使用者」不是「一次使用」,同文件第 11 处复用必须放行,否则
闸就成了数次数的假判据。产物 reports/ui_evidence/nex-p8/n16/scripts/gate_bp_proof.py。

顺带修一处本轮写闸时踩到的自伤:新增第 9 闸时把 process.exit 表达式里的 dead.length
顶掉了(第一道闸从此不影响退出码),已还原——这类「闸门静默失效」正是这条闸自己要
防的毛病,写闸的人也一样会犯。

规范侧:NEX 04-layout-system.md 新增 §8.1 命名断点登记出口(有名字/有唯一使用者/
有实测/有对账四条)与 §8.2 专业工作区窄屏降级范式(<768 导航只留一个入口),已在
nex_design_system 子仓库单独提交 63e36ec;UI规范 §4 复核口径从「grep 必须为 0」
改为五条判据 + 指向第 9 闸,§15.1 闸表 8→9 并补基线输出;nex.config.yaml 补
breakpoints_registered 五档、ui_gates 注释改 9 道子闸、custom_breakpoints 从
forbidden 改 registered_only(原注释「禁止私档断点」已与阶段 7 的登记出口不一致)。

验证:classaudit 九道全绿(10 档在册 / 5 把登记尺子 / 0 命中,exit 0)·
反证 BP_PROBE_OK 10/10 · typecheck 通过。页面与样式文件零改动,像素不受影响。
2026-11-07 22:39:17 +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 a8348d9edd v 0.1.2 2026-11-07 13:03:58 +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 01606b2949 模型配置数据包进仓库:同步代码与同步模型配置走同一条通道
开发机 16:42 重新 export 的部署数据集,按「git 同步到服务器」的口径显式纳入版本控制。
这三个 JSON 是 scripts/seed.py export 的产物,一直被 .gitignore 第 62 行挡着(历来只随
deploy.sh 的部署包 rsync 过去),这次用 git add -f 落进仓库,让服务器 git pull 之后
直接 python scripts/seed.py install 就能把模型配置刷进库,不必再单独传一次文件。

- model_specs.json 8 条(4 个真实模型 + 4 条 mock):默认位 image=comfyui/qwen-image-2.1-turbo、
  llm=qwen/qwen3.7-plus、tts=comfyui/indextts2、video=comfyui/minimax-h3;ComfyUI 三条的
  base_url 是算力机内网地址 10.100.53.199:9200,服务器换网段要在模型管理中心改;
- model_secret_keys.json 是**机密**:那行 key_value 能解开全部 API Key 密文,与密文同级,
  仓库必须保持私有;
- users.json 只有 admin,口令是 PBKDF2 哈希,install 对已存在的账号不改口令。

验证
- seed.py doctor --src scripts/seed → 判定通过(error 0 · warn 0):带 Key 1 条
  (qwen/qwen3.7-plus)主密钥解密通过 · 主密钥 1 条 · 管理员 admin · 每类能力恰好一个默认。
2026-11-06 16:46:59 +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 27f3656d6b 依赖下载点全部配国内源,并修掉「镜像里没有中文字体」这个字幕坑
用户诉求是「镜像已有,其它依赖考虑国内加速」。先把全链路的外部下载点摸了一遍,
结论:**构建镜像不需要 huggingface**——唯一的 HF 地址在 scripts/server.sh,
只在裸机 install 的 fetch_asr_model() 里用到,而且容器里根本没有 whisper-cli,
那条 curl 在 Docker 路径下永远不会执行;requirements.txt 只有 8 个包(没有任何
whisper/hub 依赖),models/ 也被 .dockerignore 排掉。构建期真正的下载点只有
npm / apt / pip 三个,此前 npm 与 pip 已是国内源,只有 apt 还默认 deb.debian.org
(实测这一层要 200+ 秒,清华 0.24 秒拿到 Release)。

改动:
- Dockerfile:APT_MIRROR 默认改清华(境外显式传回 deb.debian.org);apt 清单
  ffmpeg → ffmpeg fontconfig fonts-noto-cjk。后两个是真 bug 修复——slim +
  --no-install-recommends 连 DejaVu 都不带,libass 找不到中文字形**不报错**,
  直接把烧的字幕画成一片豆腐块;services/ffmpeg.py 又要靠 fc-list/fc-scan
  按 charset 反查字体,所以 fontconfig 也一并装上。装完代码零改动:
  _FONT_FILE_CANDIDATES 里已写着 fonts-noto-cjk 的落盘路径。嫌 +120MB 可换
  fonts-wqy-microhei(+10MB)。
- server.sh / dev.sh:新增 PIP_INDEX_URL / NPM_REGISTRY / ASR_DOWNLOAD_URL 三组
  可覆盖变量,优先级 环境变量 > .env > 内置默认,键名与 Dockerfile 的 --build-arg
  完全一致(容器和裸机同一套口径);pip 一律带 -i、npm 一律带 --registry;
  ASR 权重默认走 hf-mirror(huggingface.co 国内实测 0.04s 直接连接重置)。
- server.sh install 新增中文字体探测:复用 app.services.ffmpeg.cjk_font_catalog(),
  查不到就 warn,别等出片了才发现字幕是方块。
- 四处默认值对齐(Dockerfile / docker-compose.yml / server.sh / dev.sh)。
- README §3.2 新增「依赖下载点与国内源」表:五个下载点各自发生在什么时候、
  用哪个键、默认值是什么,并点明浏览器侧 Google Fonts 是最后一处外部依赖
  (只影响访问者,要彻底离线需自托管);工程规范 §5 补一条「依赖源只有一套键、
  默认即国内,判据是新机器零配置能装起来」。

验证:bash -n 两个脚本通过;字体探针正反向都跑过(本机 49 个中文字体 → exit 0);
docker compose config 服务仍只有 app、args 渲染出新默认值;deploy.sh --check 19 项全绿;
pytest -k "ffmpeg or subtitle or font or asr or speech or quality" 35 passed 1 skipped
(未改后端代码,故未跑全量)。docker build 本机验证不了(Docker daemon 没起),
需在服务器上构建确认。
2026-11-05 19:36:32 +08:00
mula.liu c048a3bc2c v 0.1.1 2026-11-05 19:04:25 +08:00
mula.liu 1a886beca6 端口按形态分键:HOST_PORT 只管部署对外,BACKEND_PORT/FRONTEND_PORT 只管开发;.env.example 与 compose 去噪音
一、端口三个键,各管一种形态,键名自带场景
上一轮我把它收敛成单一的 PORT,方向收得太狠:一个键被三种形态共用,等于把「这是给谁看的」
又塞回 README 里——同一个 HOST_PORT 在 Docker 下指对外映射、在裸机下指监听、在开发下指后端,
不翻文档的人分不出来。按形态分回去,判据从来不是键的个数,而是含义的唯一性:
一个键只能有一种含义、同一个 socket 不能有两个键。

  HOST_PORT      部署形态对外暴露的端口:compose 拿它插值做端口映射,server.sh 回读它做监听端口
  BACKEND_PORT   开发形态的后端 uvicorn(dev.sh 回读,并同步 Vite 代理目标)
  FRONTEND_PORT  开发形态的前端 Vite(独立进程,必须与后端错开)

compose 的 ports 回到 "${HOST_PORT:-8000}:8000",并删掉上一轮为兼容 PORT 加的 environment.PORT="8000"
钉子(键名分开之后没有歧义要钉了)。server.sh 的取值链改成
命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000,
旧键 PORT 留一版兼容;dev.sh 只认 BACKEND_PORT/FRONTEND_PORT(PORT 作旧键回退)。
实测:.env 写 HOST_PORT=8010 → compose published=8010、server.sh status 打 :8010;
HOST_PORT=9301 环境变量覆盖 → :9301;BACKEND_PORT=8000/FRONTEND_PORT=5173 → dev.sh 两个进程端口正确。

二、.env.example 按 .env 的样式重写,噪音清掉
它是运维唯一被要求编辑的文件,之前 100 行里 65 行是注释与说明,还有一批在 Docker 形态下
根本没人读的键。现在 32 个生效键 / 11 行注释,键位与本机 .env 一一对应,只放配置本身:
- 删掉 compose 覆盖掉的那几行的误导(SERVE_FRONTEND 不再列;DATABASE_URL/MEDIA_ROOT 只留一行说明
  「Docker 形态 compose 会指到挂载点」),长篇「为什么不在这里」全部搬到 README §3 与工程规范 §5,
  .env 头部三行指路。
- 删掉只在叠加 scale.yml 时才有人读的 POSTGRES_*/REDIS_URL/CELERY_*(默认值写在 scale.yml 里)。
- 删掉与代码默认值同值的长尾键(上传白名单、COOKIE_NAME、FRONTEND_DIST_DIR、QC 细项等),
  需要的人按 Settings 字段名加一行即可(文件头写明键名 = 字段大写下划线)。
- 默认值改成单容器真相:SQLite + inline,不再是 postgresql+…@db:5432 + celery。
本机 .env 同步精简成 11 键 / 8 行注释,并把容器对外端口定成 HOST_PORT=8010(8000 坐着开发后端)。

三、docker-compose.yml 114 行 → 77 行
头部 34 行的架构论证压成 16 行只留「常用命令 + 配置来源 + 四个挂载点 + 指路 README」,
正文注释每条最多一行;为什么单容器、模型配置为什么不在这份文件里、扩容层怎么叠,
都指向 README §3.2 / §4.0。顺手把上一轮的教训留住:改 .env 之后必须重跑 up -d,
restart 沿用旧容器配置、不换端口映射,这条写进了命令清单。
env_value() 补上「去随行注释与尾部空白」:三种解析器(python-dotenv、compose env_file、
本仓的 sed 回读)里只有前者会剥行内注释,漏了它 server.sh 会把
「HOST_PORT=8010  # 本机跑容器…」整串当端口用。

四、文档同步:README §3.2 加端口三键表与「改了没反应的四个键」,§3.1 前端代理、§3.2 命令、
常用改动表、§3.4 server.sh 注释全部改口径;docs/工程规范.md §5 把规则从「端口只有一个键」
改写成「按形态分键 + 含义唯一」,并把两次反复的教训写进正文。

验证:bash -n 两个脚本通过;docker compose config --services 仍只有 app,published 随 HOST_PORT 变化,
容器内四个覆盖值仍是挂载点那套;deploy.sh --check 全绿(19 项入口齐全);
两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 19:01:32 +08:00
mula.liu 24978e9843 把「服务器上那份 .env 到底管什么」写死:模板默认改成单容器真相,compose 覆盖的键逐条点名
部署前必问的三个问题,答案以前都藏在别的文件里,这次直接写进 .env.example 与 README §3.2。

一、.env 不是「开发用的那份」,是「每台机器一份的那份」
它 gitignored、不在部署包里(deploy.sh 的「不随包走」清单里就有它),仓库根这份是开发机的
(SQLite、Vite 端口、本机口令),服务器上那份由 cp .env.example .env 生成,两份互不影响。
之前 .env.example 头部没交代这件事,于是「根目录 .env 是配置开发的?那服务器上改哪」这个问题
只能靠人脑补答案。补上四行说明。

二、对外端口配在哪:服务器那份 .env 的 PORT 一行,不在 compose 里
compose 只是引用它(ports: "${PORT:-${HOST_PORT:-8000}}:8000"),读 .env 读两遍:
先替 ${PORT} 插值得到端口映射,再整份注入容器当环境变量。
顺手填掉一个真坑:compose 的 environment 覆盖 DATABASE_URL / MEDIA_ROOT / SERVE_FRONTEND /
TASK_EXECUTOR / 容器内 PORT 这五个键,运维在 .env 里改前四个是**完全没反应**的——
这正是本仓最忌讳的「写了不生效」,而 .env.example 作为模板恰恰把它们写成生效态。
现在逐个点名:前四个标注「Docker 形态被 APP_* 覆盖」,容器内落点改 APP_DATABASE_URL /
APP_MEDIA_ROOT 那两行。

三、.env.example 的默认值改成单容器形态(原来那套会让人以为在用 Postgres)
模板里原先是 DATABASE_URL=postgresql+…@db:5432、TASK_EXECUTOR=celery、SERVE_FRONTEND=off、
POSTGRES_*/REDIS_URL 全生效,而 §3.2 又让你 cp 它去部署 Docker——照做之后文件说「Postgres +
Celery + 不托管前端」,实际跑的是「SQLite + inline + 托管前端」,读文件的人被指错方向。
现在默认 SQLite / inline / on(与 compose 强制的那套一致),Postgres/Redis/Celery 七个键
整段注释掉并注明「只在 -f docker-compose.scale.yml 时生效」。生效键从 45 降到 40:
留下的每一个都有读取方。
连带修掉 README §3.4 那句「模板里那套是 Postgres + Celery,cp 会起不来」——现在 cp 也能起来,
两条路径等价,这个矛盾说法本身就成了误导。

四、compose 里的 comfyui 服务:默认不参与,README 说明白
它带 profiles: ["comfy"],docker compose config --services 只有 app,不 --profile comfy 就
不会起,GPU 预留也不生效。算力在远端(模型中心里那三条 base_url)时它就是死代码,
只是给「算力恰好装在本机、想用容器跑一份 ComfyUI」留的开关。§3.2 与常用改动表各补一句。

验证:docker compose config --services 仍只有 app,published 仍随 PORT 变化,
容器内 DATABASE_URL/MEDIA_ROOT/SERVE_FRONTEND/TASK_EXECUTOR 仍是挂载点内那套;
deploy.sh --check 全绿(215 文件/7.5M,数据包 8 条模型配置体检通过);
两份 env 0 未知键 0 模型键;backend 全量 502 passed / 1 skipped。
2026-11-05 18:52:45 +08:00
mula.liu 1934fb8bcc 端口收成一个键 PORT,.env 里的模型说明清零,apt 源也能换
一、端口:HOST_PORT / PORT / BACKEND_PORT 三个键砍成一个

上一轮把端口小节加回 .env.example 时,我按「三种部署形态」列了三个键:
Docker 用 HOST_PORT、裸机 server.sh 用 PORT、开发 dev.sh 用 BACKEND_PORT+FRONTEND_PORT。
听起来各管一摊,实际上它们指的是同一件事——「这个应用对外听在哪个端口」。
一份要交给运维编辑的文件里出现三个同义键,他的第一反应必然是「我该改哪个」,
而改错那个的表现还是「服务起来了但端口没变」,跟没改一样。所以这次收到一个:

  PORT = 应用对外端口。Docker 对外的映射读它、裸机 server.sh 的监听端口读它、
         开发态的后端也读它。

- docker-compose.yml:ports 改成 "${PORT:-${HOST_PORT:-8000}}:8000",旧键留一版回退;
  另外在 environment 里显式写死 PORT: "8000",因为容器内永远监听 8000
  (EXPOSE 与健康检查都按 8000 写死),宿主 .env 注进来的那份不能让它漂——
  今天应用不读 PORT 没事,将来谁加一行 os.environ["PORT"] 就会变成
  「映射 9000:8000 但进程监听 9000」,容器直接不通。
- server.sh / dev.sh:加 env_value() 回读仓库根 .env(上一轮删掉过,是倒退)。
  取值优先级统一 命令行 > 环境变量 > .env > 默认值;旧键 HOST_PORT / BACKEND_PORT
  只作兼容回退。回读 .env 是有意的:.env 是运维唯一被要求编辑的文件,
  写进去的键必须真的生效,否则就是本仓最忌讳的「写了不生效」。
- 开发态仍保留 FRONTEND_PORT,这不是同义键:Vite 是独立进程,必须和后端错开端口。
- 实测:.env 写 PORT=8211 → server.sh status 打印 server :8211、dev.sh status 打印
  backend :8211;PORT=9000 docker compose config 的 published 变 9000 而容器内
  PORT 仍是 8000;HOST_PORT=9100(.env 无 PORT 时)仍能回退到 9100。

二、.env / .env.example:只留配置本身

模型相关的配置和说明全部删净——现在两份文件里 VIDEO_* / COMFYUI_* / TTS_* / IMAGE_* / LLM_*
一个键都没有,原先三段「模型配置为什么不在这里」的长说明压成头部两行指引
(去页面「调度中心 → 模型中心」改,服务器初值随 scripts/seed/ 导入)。
.env.example 55 行注释对 45 个生效键,每条最多两行;本机 .env 10 键 10 行注释。
顺带确认:本机 .env 没被删过,它是 gitignored 的,所以从来不出现在提交里。
APP_DATABASE_URL / APP_MEDIA_ROOT 归到 Docker 小节(它们只在容器里成立)。
键名逐个对过 Settings 字段:两份文件 0 个未知键(多余键本身会被 extra="ignore" 吞掉,
但写错字得能立刻看出来)。

三、ffmpeg:镜像里装了,而且源现在可换

回答提问:装了。Dockerfile 运行阶段(python:3.12-slim 没有 ffmpeg)apt 装它,
时间线合成、抽帧、时长/码率质检全调它(app/services/ffmpeg.py);
缺它的表现是「导出成片一路 500」而不是起不来,所以没做成可选层。
实测容器 /health 报 ffmpeg=true(/usr/bin/ffmpeg 5.1.9-0+deb12u1,
libass/xfade/subtitles/loudnorm 全 true)。
但这一段以前是唯一没做国内镜像的装包层,README 却写着「三段都走公网镜像源」——
名不副实,且上次该层在构建机上跑了约 221 s。补上 ARG APT_MIRROR(默认 deb.debian.org,
不传参等于原行为),bookworm 的 /debian 与 /debian-security 同在 deb.debian.org 下,
一次 sed 覆盖 deb822 与老式 sources.list 两种文件;compose 侧透出同名 build-arg。

四、文档同步:README §3.2 端口行与构建源行、§3.4、前端代理那条;
docs/工程规范.md §5 补「一件事只有一个键」,并把三键同义列为回归。

backend/tests 全量 502 passed / 1 skipped;bash -n 两个脚本通过;
docker compose config 只有一个服务 app,端口映射与 APT_MIRROR 注入均已核对。
2026-11-05 18:44:30 +08:00
mula.liu 890f1ee589 模型配置全部交给数据库,.env 只管进程参数;media 从库里搬出来单独一个挂载点
上一版把容器收成一个之后,剩下的口径不一致是「模型配在哪」有两处说法:
.env 里能写 COMFYUI_BASE_URL / VIDEO_PROVIDER / TTS_*,模型中心页面也能改,
而运行时 config_json 优先——于是"改了没生效"和"到底哪条说了算"变成日常问题。
搬家的判据写成一句话放进工程规范:**换模型要不要重启进程**。要,就说明它站错了队。
另外三条理由:① 换 GPU 机是日常操作,不该要求改 .env 再 up --force-recreate;
② API / worker / beat 三个进程必须读同一份模型事实,写 .env 就是三份;
③ 地址与 Key 进库才有审计(谁改的、什么时候)与探测记录。
media 分家是同一批的诉求:产物只涨不跌,会长到几十上百 GB,迟早要单独挪大盘、
做增量备份、被 rsync 与剪辑软件直接读,和"一个不能写坏的 SQLite"绑在同一个挂载点
就得整目录停服拷走。代价说清楚:备份清单从一条变两条。

改动
   · 划界:.env / .env.example 里 VIDEO_* / COMFYUI_* / TTS_* 一律清零(脚本核对过,
     43 个键全部对应 Settings 字段或 compose 插值键,无未知键、无模型键),模板头部
     写明"为什么这里没有模型配置"与新的排障口径(先去页面点 🔌 探测)。补回四个
     原本漏在模板外的进程参数 FFMPEG_BIN/FFPROBE_BIN/QC_VISUAL_*/QC_ASR_ENABLED。
   · Dockerfile / docker-compose.yml / docker-compose.scale.yml:MEDIA_ROOT 从
     /app/data/media 改成 /app/media 并新增 ./media 挂载;worker 同步挂两个目录
     (否则「worker 写完了页面看不到」),beat 不读写产物所以不挂;compose 里删掉
     COMFYUI_BASE_URL 透传,注释说明"去模型中心改 base_url,改完即生效"。
   · 后端三处悄悄降级要一起清掉,否则 env 一空就把真实默认位打回 Mock:
     api/system.py 不再用 settings.video_provider/tts_provider 覆盖页面默认位;
     services/audio.py 的 resolve_tts_spec 候选去掉 settings.tts_provider(未设供应商的
     声线会静默 Mock 配音,只有听成片才发现);providers/registry.py 的 _dedupe_defaults
     改按「真实模型 > 启用 > 登记顺序」裁决,两条 mock 行的 is_default 交给
     _has_real_spec 闸门而不是 env。config.py 的模型字段保留为代码级兜底并写明两个用处。
   · 两个启停脚本原来都是 curl .env 里的 COMFYUI_BASE_URL 探活——现在探的是废弃地址,
     绿字反而误导:dev.sh / server.sh 的 status 改成登录取 /api/providers,
     把库里在册且启用的 base_url 去重后逐个探(comfy 探 /system_stats)。
     dev.sh 顺带修两处历史问题:/api/providers 在 AUTH_ENABLED=true 下 401 被打印成
     "模型注册表读取失败"(现在先登录);非 2xx 被 urllib 当异常抛,LLM 根路径 404
     会误判 unreachable(有 HTTP 应答即算机器活着,真可用性以页面探测为准)。env_value
     随之无人引用,两个脚本各删一份。
   · 文档:README §3.2 挂载表 3 行→4 行(含"少挂 media 会怎样")+ 备份清单两条、
     「常用改动」表把 ComfyUI 一行改成页面操作、§4.0 重写(事实源 + 三条理由 +
     三种接入路径 + COMFYUI_BASE_URL 逃生门 + 排障顺序);工程规范 §5 加"配置分两层"、
     硬约束 #3 与数据边界表同步;deploy.sh / dev.sh 提示语同步。

验证(真跑)
   · 全量后端用例 502 passed / 1 skipped;conftest 新增钉住 COMFYUI_BASE_URL,
     否则 comfyui 三条不登记,断言会跟着开发机 .env 漂(这正是删完 .env 才暴露的隐性污染)。
   · HOST_PORT=8010 docker compose up -d --build → 12 秒 healthy;容器里没有任何模型 env,
     /api/providers 仍是 8 条、默认位四条全真(comfyui/minimax-h3 · qwen-image-2.1-turbo ·
     indextts2 · qwen/qwen3.7-plus),默认位是 entrypoint 从 ./scripts/seed 灌进去的。
   · media 挂载双向实测:容器内写 /app/media/_mount_probe.txt → 宿主 media/ 立即可见;
     宿主已有 1.8G 产物经容器读回 200(/media/1/generated/shot-02-task2.mp4 2.8MB video/mp4);
     走真实接口 POST /api/projects/1/assets 上传,落盘 media/1/reference/*.png 并能在页面直出。
   · ./scripts/deploy.sh --check 19 项全绿;seed.py doctor/boundary 通过;
     dev.sh status 与 server.sh status 均正确报出 http://10.100.53.199:9200 reachable、
     dashscope 报 HTTP 404(有应答)。冒烟产生的 media 两个探针文件与 ./data 移入
     .trash/2026-11-05/smoke-media-mount/,宿主库与产物未留垃圾。
2026-11-05 18:18:00 +08:00
mula.liu 517720cf62 打成 Docker 只留一个容器:前端产物与后端同进程同端口,Postgres/Redis/Celery 收成可选扩容层
compose 原本是六个容器(db/redis/api/worker/beat/web),那是「前后端分离 + 独立 broker」
时代的遗产。这个项目实际跑的是 SQLite + TASK_EXECUTOR=inline(进程内线程池,周期派发交给
app/services/daemon.py 的守护线程),前端产物由 SERVE_FRONTEND=on 让后端一并托管——
就是 scripts/server.sh 在裸机上跑的那套形态。多出来的三个组件在这里只增加故障面:
连不上的 db、没人消费的 broker、「api 起来了 worker 没起所以任务永远 pending」。

新增
   · Dockerfile:两段式。node 阶段 npm ci && npm run build(tsc --noEmit 不过就地失败,
     比在服务器上炸便宜);运行阶段 python:3.12-slim + apt ffmpeg(时间线合成/抽帧/质检的
     硬依赖,缺它的表现是「导出成片一路 500」而不是起不来)。镜像内保持仓库布局
     backend/ + scripts/ + frontend/dist:app/config.py 与 scripts/seed.py 都靠 parents[N]
     反推根目录,布局一改就是「.env 找不到」「数据集看不见」两类静默失灵。
     BASE_IMAGE/NODE_IMAGE/PIP_INDEX_URL/NPM_REGISTRY 全部可 --build-arg 覆盖。
   · .dockerignore:刻意排除 scripts/seed —— 加密主密钥不能烘进镜像层,谁拉镜像谁拿到它。
   · scripts/docker-entrypoint.sh:首启把挂载进来的部署数据包灌进库(AUTO_SEED=
     only-missing|force|off),灌失败只告警不拦启动(缺的只是几条模型配置,页面和 API 是好的);
     末尾 exec 让 uvicorn 当 PID 1,docker stop 的 SIGTERM 才传得进去。根目录从脚本自身位置
     反推而不是写死 /app:写死会让「数据集存在与否」的判断在换目录时静默变成 False。
   · docker-compose.scale.yml:真要多机/多 GPU 才叠这层切回 Postgres + Redis + worker + beat,
     页面仍由 app 这一个容器提供(SERVE_FRONTEND 没被动过)。

改动
   · docker-compose.yml 重写成单 service:对外只有 HOST_PORT 一个端口(容器内固定 8000,
     与 EXPOSE/HEALTHCHECK 对齐),数据三处 bind mount——./data(库+media)、
     ./scripts/seed:ro(机密)、./models:ro;comfyui 降级成 profile。
   · seed.py install 的「目标库已有业务数据」两档模式分开报:覆盖式保持黄色告警,
     --only-missing 一行都不动已有数据,而容器每次重启都会走到这里——跑了几天的服务器上
     必然有 event_logs,每次都黄一条等于训练运维无视黄条,降级成一行普通提示。
   · deploy.sh 必带清单加四个 Docker 文件(现 19 项)、包内排除新增的 /data/;
     server.sh 注释里的 docker-compose 指向改成 scale 层;.env.example 新增「Docker 部署」一节;
     README §3.2 整段重写(含挂载表、AUTO_SEED 三档、扩容叠加、国内 registry 实测命令)、
     §3.4 补「同一份部署包也能直接跑 docker」;工程规范 §1 根目录白名单与 §2 脚本表同步。

验证(真跑,不是纸面推演)
   · docker compose config --services = app(默认一个);叠 scale 层 = db redis beat worker app。
   · docker build 成功(685MB,本机直连不到 docker.io,改用 swr 镜像源的
     python:3.12-slim + node:22-alpine 走通,npm ci 34.8s / vite build 12.7s / ffmpeg 221s)。
   · HOST_PORT=8010 docker compose up -d 12 秒到 healthy;首启日志「模型配置:新增 8」
     「前端产物已托管:/app/frontend/dist」「执行后端=inline ffmpeg=True」。
   · / 与 /projects/3/storyboard 回落同一 index.html;/assets/index-*.js 200/216KB;
     /api/nope 是 401 JSON 而不是被 SPA 兜底成 HTML;登录后 /api/providers 返回 8 条配置 +
     四个默认位;/app/scripts/seed 确认 Read-only file system。
   · 把 tts 默认位手工改成 mock 后 restart:日志「保留本机默认位不改」,重启后仍是 mock;
     AUTO_SEED=force 时按包覆盖回 comfyui/indextts2。celery 入口与 AUTO_SEED=off 都不灌数据。
   · 优雅停止:SIGTERM 后 0s 走完「Shutting down → 内联调度守护线程已停止 → shutdown complete」。
   · 开发库 nex_animation.db mtime 纹丝没动;down 之后 ./data 完好;deploy.sh --check 全绿(19 项)。
2026-11-05 17:39:12 +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 71fbaf0a94 规范补上 R18 与 §6.5「四级信息层次」,并纠正 §6.2 里那条与代码不符的侧栏描述
症状:这一轮的改动是**结构性**的——项目身份从三处收成一处、页头升成一层独立面板、
外壳退出可见层。规范里原本没有任何一条规定「哪一级的话该在哪一层说」,下一轮只要有人
觉得「概览页再放一颗归档按钮挺方便」,R18 要清的东西就会原样长回来。另一处是真错:
§6.2 写着一级分组叫「当前项目」、项目名挪到侧栏底部的状态块(Divider +「当前项目」+
两行省略的段落 + 当前节点摘要),而代码里那个状态块早就删了、分组现在叫「项目环节」
(`AppSider.tsx` 第 14~21 行的注释就是这么写的)——照着规范改代码会把它加回去。

做法:①§0 标题从「十七条硬规则」改成「十八条」,新增 **R18 每一级的身份与动作只在该级
说一遍**,右侧写上立规依据(用户第 11 轮原话 + 当时同一条项目身份说三遍的现场);
②新增 **§6.5 四级信息层次**:一张四行表把「① 项目入口 `PipelineConsole` / ② 项目层
`ProjectBriefDrawer` / ③ 环节层 `NodeHead` / ④ 内容层 `Panel`」各自的唯一载体、只允许
说什么、明确不许说写死,并补四条口头禅容易踩的坑——外壳 `ProjectDetail.tsx` 除兜底外
不渲染任何可见块(别把项目名/状态 Tag/指标卡加回来)、`NodeHead` 只是 `PageHead` 的一层
皮肤(属性同 `PageHead`,皮肤只有 `app.css` 一处,七站眉标算法只有一份)、抽屉里的跳转
是七站列表而不是流程条(轨道已改成容器自适应网格且整段不可点)、窄屏不许把入口弄丢
(控制台在 375 也渲染,实测 174×32 不撞折叠键);③§6 的 AppHeader 一行标明「它是全站
唯一的项目身份入口,点击展开 §6.5 的概况抽屉」;④§6.2 按代码改写:一级分组叫
「项目环节」、`title` 不拼项目名、侧栏不出现任何当前项目信息,并写明历史上那个状态块
为什么被删;⑤§7 控件档位那条把「PageHead actions」改成「`PageHead`·`NodeHead` 的
actions」,页头新增的那一层不能漏在档位规则外面;⑥README 的条目数同步到十八条
(只提这一行,其余 README 内容归并行的后端改动)。

为什么写成表格而不是散文:这四层的边界是「谁不许说话」,比「谁该说什么」更容易被破;
每层给一句明确的禁止项,下一轮评审能直接指着那一格说这条越界了,不用先争论语义。
2026-11-03 21:27:50 +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 7e784b5303 规范补到十七条并把探针升到「六道 + 一道反向验证」:行高、栅格、纵向节奏、标签底色全部有闸
症状:这一轮改的每一类毛病里,有四类靠人眼复查根本守不住——表格行被内容撑高(实测最高
255px)、该用栅格的地方用自然排列(窄屏两种坏画面:一行右边缘参差不齐、折行点随内容
漂移)、纵向节奏断(底边不齐 / 收缩错位)、标签自带彩色底纹(§2.1 要求中性底);而卡头
`right` 长起来把标题压成竖排(430 档标题 291×145)也没有任何闸门会报。更麻烦的是
rhythmcheck 的判据原先读像素,豁免写宽一格就永远安静地返回 0——14 条命中里混着探针
自己的假警报,没人敢信它的红。

做法:①`docs/UI规范.md` 新增 R17 表格行高纪律(§13.2)与 R16 信息块三件套的落地口径
(§13.1),§9.3 补卡头折行那条(含「折行样式要挂在 `.ant-card-head-wrapper` 而不是
`.ant-card-head`」这个陷阱与 430/1440 的实测数据),§15 扩成 15.1–15.7 六道常驻探针
加一道反向验证,§16 提交清单插入第 9 步「动过布局跑三张像素闸、改过判据跑 gateprobe」;
②新增 `tableaudit.py`(逐表报容器宽/可视宽/行数/最高行/列宽,超行高点名)、
`gridcheck.py`、`rhythmcheck.py`(GAP + RAG,四条写法级豁免逐条写明为什么豁免)、
`tagcheck.py`(扫标签 tinted 底);③`gateprobe.py` 用「坏 fixture 必须被点名、合法形态
必须被放行」两组用例反向验证三张像素闸,共 4/4 全对,不碰源码不触发 HMR;
④`rhythmcheck.py` 的判据改成只读写法不读像素(`isPin` 认 mt-auto / inline margin-top /
justify-content;RAG 侧放行子块自带 max-width、align-self 与整行居中的胶囊组),
`classaudit.mjs` 把 `<Flex align="flex-start">` 的取值加进 PROSE 白名单(它天天作为
props 值出现,逐行切词分不清引号内外);⑤`visualcheck.py` 的项目子页改成量「镜头最多」
的项目并支持 NEX_PROJECT_ID 覆盖——列表第一个常是空项目,空态下溢出与截断两类断言等于
没测;⑥README 的规范条目数同步到十七条(只提这一行,其余内容归并行的后端改动)。

为什么:这类毛病全是「看起来挺整齐、量一下才知道差 200px」,只有把它们变成退出码才能
防止下一轮又漏回去;而像素闸一旦可能悄悄失灵,就必须配一道反向验证——先证明闸门坏了
会响,它的绿才有意义。
2026-11-03 20:21:39 +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 d65a78ce59 规范补到十六条:R15「按钮一律图标按钮」、R16「信息块一律带底纹」
症状:文档还停在十四条,而这一轮真正拦人的是四件没写进规矩的事——
      筛选条字段没规定必须 inline(所以「标签在上」被混进行内栏,一行散成两行)、
      按钮没规定必须带图标(所以整站是纯文字按钮)、
      统计/回显块没规定必须有底纹(所以每个页面自己涂一次白底描边)、
      重点色没规定「一个容器只留一颗」(所以三颗 blue primary 并排)。
      规矩没写=下一轮一定长回来,用户同一句抱怨会再说第三遍。
做法:R1/R2 补上「控件栏字段必须 <Field inline>,宽度落控件列 --nex-ctl-w」,
      新增 R15(图标按钮,含 FilePick/RecordAudio 也走 icon 槽)、
      R16(底纹走 fill-tertiary,禁止手涂 bg-[#...]);
      新增 §5.1.1「一颗按钮一只语义图标」、§5.1.2「关键动作才有重点色」;
      §2.1 记下状态色的新口径(浅色删掉自造档回到出厂,深色只抬亮一档,
      并写清深色会再走一遍 darkAlgorithm、字面量不是最终值);
      §7 示例改成 inline 写法,并登记现网实测「19 条 Ctlbar / 27 个字段,0 例外」;
      §9 补「标签在上只属于抽屉/弹窗/长表单」;
      §15.2 写清闸门的两处口径修正(浮层底部只查 Drawer/Modal;侧栏探针
      kind=item 才比色板、`.anticon` 不参与行高断言);README 索引同步到 R1–R16。
为什么:这四条不是审美偏好,是用户两次截图里的原话;写进硬规则并被 classaudit /
      visualcheck 管住,比在代码里留十条注释更能防止下一次回潮。
2026-11-03 17:03:34 +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