diff --git a/reports/NEX阶段10-S2复验与整名判据-2026-11-08.md b/reports/NEX阶段10-S2复验与整名判据-2026-11-08.md new file mode 100644 index 0000000..5ea06fe --- /dev/null +++ b/reports/NEX阶段10-S2复验与整名判据-2026-11-08.md @@ -0,0 +1,410 @@ +# NEX Design System · 阶段 10 实施报告(S-2 收尾 · 整名判据 + 真机复验) + +- 日期:2026-11-08(Asia/Shanghai) +- 授权范围:**只做 S-2**(图标字形名混入可访问名称),不自动开 S-3 / T-1 / Bundle 优化 +- 上游:`reports/NEX阶段8.5.1-S-2图标可访问名称-2026-11-08.md`(S-2 本体)、`reports/NEX阶段9-S3T1Bundle收口-2026-11-08.md` +- 本轮性质:**app 代码 0 改动**。补的是判据覆盖层与文档口径,加一次真机复验 + +--- + +## 0. 结论摘要 + +1. **S-2 本体已经落地并在册**(三个已提交:`4adf77b` 改法 / `05434ad` 两道闸 + 反例 / `418fb6b` 规范入册)。 + 全站唯一图标出口 `frontend/src/components/icons/index.ts` 的 79 条一律走 `decorative()`, + 默认 `aria-hidden`;4 处「图标就是控件全部语义」的位置在 kit 一处收口补自然中文名,页面 0 改动。 +2. **本轮补的是 S-2 漏掉的第三种形状**:控件的**整条**可读名称就是一个英文字形码(实测 `ellipsis`)。 + 原来那两条都看不见它——DOM 支只认「图标自己的 `aria-label` == 自己的类名后缀」, + 而那颗溢出「…」的名字是按 contents 算出来的;`NAME` 也放行,因为名称**非空**,只是空话。 + → `semanticcheck` 第 8 条判据 `GLYPH` 现在有**两支**,共用判据函数 `whole_glyph_name`。 +3. **判据写在哪一层,反例就得造在哪一层**:`gateprobe` 判据 ⑲ 除了喂名称表(钉字符串函数), + 另加**第二腿**——在登录后的真页面上拿真按钮改三种形状,钉住 `COLLECT` 采集与 CDP AX 两支。 + 它第一跑是红的(自家 `pb-glyph` 夹具没摘,闸门抓了我们自己的反例),这条 FAIL 反过来证明第二腿在读名称。 +4. **真机复验(本机 `:5173` + 后端在线)24 条 AX 读数 × 明暗两色**:交互元素的可访问名称里 + 含字形码的只剩 `/help` 正文那条链接 `/api/meta`(撞中的是 `api`,是内容不是图标名 → 打印不立案)。 +5. **防复发**:`/help` 已进 `semanticcheck` 默认路由(12 → **13** 条),让「好样本必须放行」那一半 + 有个真页面替它站岗,而不是只活在 gateprobe 我们自己喂的名称表里。 +6. **读屏真机边界没有因为复验而缩小**:仍是 **MANUAL QA REQUIRED**(明细见 §7)。 + +--- + +## 1. 修改文件清单 + +### 1.1 本轮(阶段 10 · 未提交) + +| 文件 | 类型 | 本轮归属 | 说明 | +|---|---|---|---| +| `scripts/ui/semanticcheck.py` | 判据 | **整名两支** + `/help` 入列(同文件另有阶段 9 的 `TABKBD` 段,见 §2.2 逐 hunk 拆账) | 第 8 条判据 `GLYPH` 从一支变两支;默认路由 12 → 13 | +| `scripts/ui/gateprobe.py` | 反向验证 | **判据 ⑲ 第二腿** + 计数 17 → 19(同文件 `TABKBD` 段属阶段 9) | 名称表 13 条断言 + 真页面 3 条断言 | +| `docs/UI规范.md` | 规范 | §5.1.1「两道闸」→「三道闸」;§15.12 ⑲ 两腿与断言实数;§15.13 整名两支口径 + 13 条路由的理由 | 只改与代码口径冲突的既有章节,未新建重复文档 | +| `docs/NEX-对照与例外.md` | 对照表 | §2.8 S-2 行(`:146`):两道闸 → 三道闸 + 本轮真机复验读数 + 读屏边界;§7 变更记录新增阶段 10 整行(`:323`) | 同文件 §6 的 5 行漂移与 §7 的阶段 9 行是**阶段 9 遗留**(见 §1.2),本轮没有新增 §6 条目——antd 内部图形的英文宿主名称那行自阶段 8.5.1 就在册 | +| `nex.config.yaml` | 项目配置 | `ui_gates` 两条注释与代码对齐(19 条判据构成);`baseline` 84 → **90 个状态**并注明更早的 84 基线逐条仍可对照 | | +| `reports/NEX阶段10-S2复验与整名判据-2026-11-08.md` | 本报告 | | | +| `reports/ui_evidence/nex-p10/shots-s2/` | 证据 | **22 张 png**(11 组控件 × 明暗)+ 2 份 AX 读数 JSON(**24 条**:18 + 6) | 每条读数的 `截图` 字段都实测可解析(18 条带图,6 条注记无图) | +| `reports/ui_evidence/nex-p10/census/` | 证据 | 图标可读名称普查收口对账(只读,不进退出码) | | +| `reports/ui_evidence/nex-p10/p10-suite-*.log` + `p10-suite-index.log` | 证据 | §5 串行九条的完整日志与索引(9 份)| 每条 `exit` 码都在索引里 | + +**本轮没有改任何 `frontend/src/**` 文件。** 这是结论之一,不是遗漏:授权书第 6 条「不改变现有视觉表现和 +业务操作」在本轮被满足到最强形式——代码一行没动,动的全是「量它的尺子」。 + +### 1.2 留在工作树里的阶段 9 遗留(非本轮,等用户确认后再提) + +`frontend/src/app/layout/{ActivityCenter,AppHeader}.tsx`、`frontend/src/pages/{Dashboard,Help}.tsx`、 +`frontend/src/styles/app.css` + 两份阶段 9 报告(已 untracked)。这些是阶段 9 的三条用户诉求 +(撤顶栏健康态 `Badge`、总览流程面板跟随列表、节点展开双通道)与 `app.css` 注释提前闭合的修复, +**不属于 S-2**,本轮没有触碰,也没有把它们混进本轮的提交切分。 + +--- + +## 2. 修改前后差异 + +### 2.1 S-2 本体(已在 `4adf77b`,本轮未再改) + +``` +frontend/src/components/icons/index.ts | 300 +++++++++++++++----------- +frontend/src/components/ui/Input.tsx | 27 ++- 搜索按钮「搜索」/ 清空键「清空搜索」 +frontend/src/components/ui/Ctlbar.tsx | 19 +- Pager itemRender → 上一页 / 下一页 +frontend/src/components/forms/SecretInput.tsx | 9 + iconRender → 显示密码 / 隐藏密码 +frontend/src/components/ui/Tabs.tsx | 9 + more={{icon}} → 更多页签 +frontend/src/styles/app.css | 9 + 唯一一处:补回被 antd 降掉的悬停 z-index +``` + +改前 / 改后的可读名称(同一颗按钮,`decorative()` 前后): + +| 位置 | 改前 AT 念出来的 | 改后 | 内层图标 | +|---|---|---|---| +| 分镜卡工具条 | `upload 导入脚本` | **导入脚本 / 关键帧** | `anticon-upload` `aria-hidden=true` | +| 分镜导出下拉 | `down 导出` | **导出** | `anticon-down` `aria-hidden=true` | +| 新增镜头 | `plus 新增镜头` | **新增镜头** | `anticon-plus` `aria-hidden=true` | +| 搜索按钮 | `search` | **搜索**(宿主 `aria-label`) | `anticon-search` `aria-hidden=true` | +| 溢出「…」 | `ellipsis` | **更多页签** | 名称走 name-from-contents | + +### 2.2 本轮 · `scripts/ui/semanticcheck.py`(逐 hunk 归属) + +| hunk | 归属 | 内容 | +|---|---|---| +| `@@ -82,17 +82,46` | 10 + 9 混 | 模块 docstring:`GLYPH` 交叉核对从「只打印」改写成**两支两档**(阶段 10);同段追加 `TABKBD` 判据说明(阶段 9) | +| `@@ -113,11 +142,15` | 10 + 9 混 | `ROUTES` 追加 `/help` + 5 行理由注释(10);`NEX_TABS` 注释澄清与判据 `TABKBD` 别混名(9) | +| `@@ -141,6 +174,20` | **10** | 新增判据函数 `whole_glyph_name(name)` | +| `@@ -428,6 +475,19` | **10** | `COLLECT` 新增 5b:交「整条名称 = 单个小写拉丁词」的**候选**(正则 `^[a-z][a-z0-9-]{1,24}$`) | +| `@@ -444,7 +504,7` | **10** | `COLLECT` 返回值加 `nameOnly` | +| `@@ -793,6 +853,254` | 9 | `tab_kbd_check()` 等窄屏溢出页签键盘通道 | +| `@@ -801,6 +1109,9` | 10 + 9 混 | `ax_name_cand/ax_name_hit` 计数器(10)+ `tabkbd` 累计器(9) | +| `@@ -933,6 +1244,18` | 9 | 调用 `tab_kbd_check` 与选中态复位 | +| `@@ -958,6 +1281,7` | **10** | 每路由的 `ax_c/ax_h` 计数 | +| `@@ -972,14 +1296,37` | **10** | **两支立案**:DOM 侧 `nameOnly` × `whole_glyph_name` → 立案;AX 支撞中且整条 = 字形码 → 由「只打印」升为立案(`continue`,不再走只打印那一档);读数行加「整名候选 / 命中」 | +| `@@ -1166,8 +1513,20` | 10 + 9 混 | 覆盖说明补整名候选/命中读数(10)+ `TABKBD` 空转读数(9) | + +判据函数(两支共用,`gateprobe` ⑲ 钉它): + +```python +def whole_glyph_name(name): + """整条可读名称恰好是一个登记表字形码时返回那个码,否则返回空串。 + + 为什么只要「整条」:这是能不能写进退出码的分界线。 + · `upload 导入脚本` 这种混拼,宿主还有半句人话,AT 念得出「导入脚本」, + 归 DOM 侧那条(aria-label == anticon-<后缀>)管,本函数不管; + · `ellipsis` 这种整条就是字形码,用户听到的是一个英文单词,**等于没有名称**, + 而 NAME 查不出它(名称非空,只是空话)——只有这一种够格进退出码。 + 为什么还要撞登记表:`/api/meta`、`Esc`、`OK` 都是合法名称,不是字形码。 + """ + key = (name or "").strip().casefold() + return key if key in GLYPH_TOKENS else "" +``` + +### 2.3 本轮 · `scripts/ui/gateprobe.py` + +| hunk | 归属 | 内容 | +|---|---|---| +| `@@ -1,6 +1,6` / `@@ -20,7 +20,7` / `@@ -36,9 +36,24` 末段 | **10** | 十七条 → 十九条;⑲ 立项说明 | +| `@@ -36,9 +36,24` 前段 / `@@ -73,6 +88,78` / `@@ -494…` 末尾的 ⑱ 调用 | 9 | `TABKBD` 五反一正(真 430 窗口改真组件) | +| `@@ -89,6 +176,9` | 9 → 10 复用 | 把 `semanticcheck.BASE` 指到与反向验证同一个前端(⑱ 需要,⑲ 第二腿同样需要) | +| `@@ -382,7 +472,8` | **10** | 把 `pg` 所在 context 留成 `ctx`,第二腿要在同一 context 上开 CDP 会话 | +| `@@ -494,8 +585,88` 主体 | **10** | **⑲ 第二腿**:`whole_hits()`(DOM 支 + AX 支各跑一遍)→ 先摘自家夹具(摘不到 2 个直接停机)→ 原样必须静 → `aria-label=ellipsis` 两支都必须点名 → `aria-label=/api/meta` 必须放行 → 摘回属性复位 | +| `@@ -507,11 +678,26` | **10** | ⑲ 第一腿:`WHOLE_IN` 5 条坏名称 + `WHOLE_OUT` 8 条好名称;末行 `GATEPROBE_OK len(checks)+3` | + +第二腿为什么必须存在(这是本轮最实质的一条方法论): + +> 名称表那一腿只钉住了字符串函数。这条判据真正跑在浏览器里——`COLLECT` 的 5b 采集正则 + +> CDP `getPartialAXTree` 两支。采集正则写坏(例如整条名称匹配不上 `^[a-z][a-z0-9-]{1,24}$`)时, +> 名称表照样全绿,那还是恒真。 + +第二腿实测三种形状(`reports/ui_evidence/nex-p10/p10-gateprobe2.log`,本轮复跑 `p10-suite-gateprobe3.log` 同读数): + +``` + 摘掉自家夹具 2 个 → 剩余 pb-* 节点 0(应为 0) +OK semanticcheck.GLYPH-whole-live 真页面原样 必须放行 → 没点名 +OK semanticcheck.GLYPH-whole-live aria-label=ellipsis 必须点名 → 点名了 ellipsis|ellipsis +OK semanticcheck.GLYPH-whole-live aria-label=/api/meta 必须放行 → 没点名 +``` + +`ellipsis` 那一行点名叫出**两次**(`ellipsis|ellipsis`):DOM 支与 AX 支各一次。这是有意的—— +两支是两条独立的采集路径,各自都必须在真页面上被证明会咬;同一条真缺陷因此可能在清单里出现两行, +读的时候按「同一个控件」合并,不算重复计数(本轮真页面上整名命中恒 0,实际没有出现两行)。 + +### 2.4 本轮 · 文档与配置 + +- `docs/UI规范.md:512`(§5.1.1 三档口径段):**两道闸 → 三道闸**,写出第二支认的是「整条可访问 + 名称就是一个登记表字形码(AT 层)」,并标明两支共用 `whole_glyph_name`、反例分别在 ⑰ / `GLYPH` / ⑲。 +- `docs/UI规范.md:2450`(§15.12 标题):分类算术改成能加出 19 的写法(七张像素闸共 **11** 条 + 语义五条 + + ⑱ + ⑲ + 静态一条)。原来那句「七张像素闸 + 语义五条 + …」是拿**闸门数**冒充**判据数**,加不出标题。 +- `docs/UI规范.md:2459`:⑲ 立项说明补「两腿」;**断言实数 76 → 79**(本轮实测 `OK` 行数)。 +- `docs/UI规范.md:2487`:反向验证表新增一行 `semanticcheck.GLYPH-whole-live`,把「先摘夹具、 + 摘不到就停」的前提写成期望。 +- `docs/UI规范.md:2531`(并扩写 `:2526` 那条既有教训):记下第五种失败模式「**判据写在哪一层,反例就得造在哪一层**」, + 以及第二腿第一跑为什么红、红得对在哪里。 +- `docs/UI规范.md:2555-2563`(§15.13):`GLYPH` 两支两档口径入册;默认路由 **12 → 13** 条并写明 + `/help` 为什么在里面。 +- `docs/UI规范.md:2588-2590`(§15.13 末尾索引):`gateprobe` 的语义判据索引五条 → 六条(补 `GLYPH-whole`)。 +- `docs/NEX-对照与例外.md` §2.8(`:146`):S-2 那行的「两道机器闸」改成三道闸 + 附本轮真机复验读数 + 读屏边界; + §7 变更记录(`:323`)新增阶段 10 整行。antd 内部图形的英文名称那行漂移**沿用阶段 8.5.1 的在册记录**,本轮没有改 §6。 +- `nex.config.yaml` 两处 hunk / 四行:`:116` 判据条数与构成对齐(阶段 10)、`:118` `baseline` 改成 **15 路由 × 3 视口 × 2 主题 = 90 个状态**, + 并注明更早的 84 状态基线逐条仍可对照(阶段 4 起 `/not-a-page` 兜底页进了 visualcheck 名单)。 + +--- + +## 3. 为什么这样改(口径与取舍) + +1. **为什么不能批量 `aria-hidden`**:普查量过,改前有 **42 只**图标是宿主控件**唯一**的名称来源 + (无 `aria-label`、无 `title`、无文字)。批量隐藏 = 把这 42 颗变成无名控件, + 比原缺陷更糟。所以登记表用三档:默认装饰 / 显式 `aria-label` 具名 / 显式 `aria-hidden={false}` 放行调用方。 +2. **为什么不能批量具名**:宿主自己已经写了「导入脚本」,再给图标补一句 `aria-label="上传"` + = 同一个控件被念两遍。第 ② 档全站只有四只出口。 +3. **为什么「整条 = 字形码」才立案**:这是「能不能写进退出码」的分界线。混拼(`upload 导入脚本`) + 宿主还有半句人话,AT 念得出「导入脚本」,归 DOM 支管;整条就是 `ellipsis` 才是「等于没有名称」。 + 而「名称里含有一个拉丁词」这种松判据会把 `/api/meta`、`Esc`、`OK` 全抓进来——**假阳性的下场是这条闸被以噪音为由关掉**。 + 所以只打印不立案,把假阳性留在打印里、真缺陷进退出码。 +4. **为什么 `/help` 要进默认路由**:不加它,「好样本必须放行」这一半只活在 gateprobe 的名称表里, + 而表里的名字终究是我们自己写的。`/help` 手册正文那条链接的名字真叫 `/api/meta`, + 撞中登记表里的 `api` 却不该立案——它替这一半在真页面上站岗。加之前先量过: + `/help` 单独跑 1440 与 430 × 明暗 **各 0 条违规**(`reports/ui_evidence/nex-p10/p10-help1440.log`、`p10-help430.log`), + 不是把一条已经红的页面塞进串行。 +5. **为什么不改判据的阈值而是加一支**:`NAME` 那条判据的正确答案是「名称非空」, + `ellipsis` 通过它;DOM 支的正确答案是「`aria-label` == 自己的类名后缀」,`ellipsis` 挂在 + 内层图标上而按钮的名字按 contents 算,也通过它。**两支都不放宽**,只是补上第三条独立路径。 +6. **历史「12 条路由」的留档不动**:`docs/UI规范.md` 里 4 处「12 条路由」是**当时那遍实测的读数说明** + (§15.13 六条结论、§16 等),改成 13 会让「这条读数是哪一版代码跑出来的」失去锚点,所以故意不改; + 只有描述**默认配置**的那一句(§15.13:2559)跟着代码改。 + +--- + +## 4. 规范符合性说明 + +### 4.1 与项目 `AGENTS.md` 强制规则逐条对账 + +| 规则 | 本轮 | 依据 | +|---|---|---| +| 1 先复用,后新增 | ✅ | 没新增组件、没新增表面。新增的是一个判据函数与一支采集,全部进既有闸门 | +| 2 不擅自改技术栈 | ✅ | React / antd / Tailwind v4 一字未动;本轮连 app 代码都没动 | +| 3 禁止硬编码设计值 | ✅ | 无新增颜色 / 间距 / 圆角 / 阴影 / 层级(阶段 9 遗留的 `app.css` 那处不属于本轮) | +| 4 禁止私自建立视觉变体 | ✅ | 视觉零变化 | +| 5 页面不得绕开共享模式 | ✅ | 未触碰页面结构 | +| 6 交互状态完整(可点击元素必须键盘可达) | ✅ | 名称与键盘两条通道都有真读数:溢出「更多页签」Tab 可达、焦点环 `solid 2px`(light `rgb(22,119,255)` / dark `rgb(22,104,220)`);`TABKBD` 判据在 430 档跑真按键 | +| 7 不破坏工作区滚动结构 | ✅ | 无布局改动 | +| 8 主题必须成对实现 | ✅ | **所有**读数都取明暗两档且逐条一致(24 条 AX 读数、22 张截图);焦点环颜色两档分别记录 | +| 9 不滥用局部覆盖 | ✅ | 本轮 0 处 CSS 改动 | +| 10 先提交计划再改动 | ✅ | 判据改动先量后改:`/help` 在进默认名单之前单独跑过 1440 / 430 × 明暗(各 0 条违规) | + +### 4.2 与 `nex.config.yaml` 的 `requirements` / `rules` + +- `maintain_existing_interactions: true` → 本轮改的是尺子,业务操作路径没有任何一条被移动; + 24 条 AX 读数与 22 张截图证明「点得着、看得见、念得出」三件事的原样。 +- `ui_gates` 两条注释已与代码对齐(19 条判据构成、census 只读不进串行)。 +- `baseline` 从 84 更新为 **90 个状态**(阶段 4 起 `/not-a-page` 进 visualcheck 名单), + 并注明更早的 84 状态基线逐条仍可对照——不是把基线换掉,是把账算清。 +- **一处与现实相反的既有配置没动**(超范围,见 §7 第 1 条)。 + +### 4.3 与 `docs/UI规范.md`(项目级权威 UI/UX 规范) + +| 章节 | 口径 | 本轮状态 | +|---|---|---| +| §5.1.1 图标语义三档 | 默认装饰 / 显式具名 / 显式放行;两头不许一刀切 | 已把「三道闸」写清(源码出口形状 + DOM 字形码支 + AT 整名支),并注明两支共用 `whole_glyph_name` | +| §15.12 反向验证 | 新判据必须配对偶断言;反例造在判据运行的那一层 | 判据 ⑲ 两腿入册;断言实数改成 79;标题分类算术改正(七张像素闸贡献 11 条判据,不是 7 条) | +| §15.13 语义与行为判据 | `GLYPH` 四档 + 整名两支 + 13 条默认路由 | 两支两档与 `/help` 的入选理由入册 | +| §16 第 9 步(改动流程) | 动过判据必须跑 `gateprobe`;动过语义/焦点/aria 必须跑 `semanticcheck` 1440 与 430 各一遍 | 本轮照做(结果见 §5) | + +**不复制规范**:只在与代码口径冲突处改既有章节,没有新建一份与 `UI规范.md` 重复的文档。 + +### 4.4 与 NEX Design System 0.1.1(跨项目标准) + +`docs/NEX-对照与例外.md` §2.8 那行原本记着「NEX 08 说『名称要能读』但没说什么算泄漏」—— +这是**规范本身的缺口**。本轮把它推回上游(NEX 子仓库 `10ccdc1`,`08-accessibility-responsive.md` §1 新增两条): + +1. **可读名称有下限**:整条名称 = 图形内部标识(字形码 / 图标 key / 枚举值 / 状态码)按**没有名称**处理; + 判定按「整条」不按「包含」,正文里合法出现的英文词不是缺陷。 +2. **默认装饰,语义由宿主说**:只有当图标是宿主唯一名称来源时才具名;两头都不许一刀切。 + +项目侧判定保持 **COMPLIANT(阶段 8.5.1 修,阶段 10 复验)**,不为了对齐上游而改本项目尺寸或技术栈。 + +--- + +## 5. 测试命令与实测结果 + +项目没有 `lint`、没有单元测试,以下全是仓库里真实存在的命令。 +UI 闸从**仓库根**跑(`.venv/bin/python scripts/ui/*.py`、`node scripts/ui/classaudit.mjs`), +`dev/build/typecheck/preview` 在 `frontend/` 下跑。串行套件脚本 `/tmp/p10_suite.sh`(一次性驱动器,不进仓库),它的索引与九条日志已归档: +`reports/ui_evidence/nex-p10/p10-suite-index.log` + `p10-suite-*.log`。 + +| # | 命令(仓库根;`dev/build/typecheck/preview` 在 `frontend/`) | exit | 关键读数(全部为本次实跑,非引用旧账) | +|---|---|---|---| +| 1 | `node scripts/ui/classaudit.mjs` | **0** | 10 道源码闸逐条 0。与 S-2 直接相关的两条:`0 处绕过登记表的图标 import(只许 src/components/icons/index.ts)`、`0 处图标出口未走 decorative()(登记表 79 条出口 / 0 处外部 import)` | +| 2 | `.venv/bin/python scripts/ui/semanticcheck.py`(1440 × 明暗 × **13** 路由) | **0** | `=== 语义与行为 0 条违规 ===`;逐路由 `外泄 0`;末行 `名称整体=单个拉丁词的交互元素 0 个,其中整条名称就是登记表字形码 0 个(本遍无命中;0 也要报,这条不许悄悄空转)`;`/help` 那条 `GLYPH AX 名称撞中字形码 api role=link 「/api/meta」 ×2 —— DOM 侧没立案…要人眼确认` = **只打印不立案**(新判据要放行的正是它) | +| 3 | `NEX_WIDTH=430 .venv/bin/python scripts/ui/semanticcheck.py` | **0** | `=== 语义与行为 0 条违规 ===`;`TABKBD 溢出条带 4 处 / 被裁页签 6 颗 / 纯键盘选中成功 6 颗(视口 430;Tab→↓→↓→↵→Esc 全程真按键)`;13 条路由逐条 `汉堡名称 初始「打开导航菜单」→ 展开「关闭导航菜单」→ 收起「打开导航菜单」`;整名候选 0 命中 0;`api` 同样只打印 | +| 4 | `NEX_WIDTH=1440 .venv/bin/python scripts/ui/tableaudit.py` | **0** | `=== 违规 0 张表 ===` | +| 5 | `NEX_WIDTH=430 .venv/bin/python scripts/ui/tableaudit.py` | **0** | `=== 违规 0 张表 ===`(窄屏档没有因为本轮改动多出任何一张溢出表) | +| 6 | `.venv/bin/python scripts/ui/gateprobe.py` | **0** | `fixture nodes: 107`;`OK` **79** 条 / `FAIL` **0**;`GATEPROBE_OK 19/19 闸门坏了会响、好了不响`;⑲ 第二腿三形状见 §2.3(`摘掉自家夹具 2 个 → 剩余 pb-* 节点 0`) | +| 7 | `cd frontend && npm run typecheck` | **0** | `tsc --noEmit` 无输出(0 错误) | +| 8 | `cd frontend && npm run build` | **0** | **0 条 CSS 警告**(阶段 9 修掉注释提前闭合之后维持);仅既知的一条 chunk 体积警告:`dist/assets/ui-*.js 1,275.89 kB │ gzip 396.06 kB` > 1200 kB 阈值 = 阶段 9 已在册的 C-1 首屏体积漂移,本轮未恶化;`✓ built in 462ms` | +| 9 | `NEX_SHOTS=reports/ui_evidence/nex-p10 NEX_WIDTHS=1440,768,430 NEX_THEMES=light,dark .venv/bin/python scripts/ui/visualcheck.py` | **0** | **90 张**截图全部重产(15 路由 × 3 视口 × 2 主题,落 `reports/ui_evidence/nex-p10/shots/`);`console(0 条)` / `HTTP 失败(0 条)` / `断言(0 条)`;`header h=56` 三视口恒定,明暗 header 底 `rgb(255,255,255)` / `rgb(17,24,32)`,选中菜单项明暗 `bg rgb(230,244,255)` + `color rgb(22,119,255)` / `bg rgb(22,104,220)` + `color rgb(255,255,255)` | +| — | `.venv/bin/python scripts/ui/census-icons.py`(只读普查,脚本本身恒返回 0,不进串行) | 0 | 见 §5.1 ②:1 072 条图标读数 / 字形名可见 **80** / 宿主唯一语义 **0** / D 组 **1 种** | + +> **串行执行方式**:`screen -dmS p10suite /bin/zsh /tmp/p10_suite.sh`,九条按 1→9 顺序跑, +> 每条单独落日志,索引写 `name exit=N 行=M`,末行 `SUITE DONE`。日志已归档到 +> `reports/ui_evidence/nex-p10/`(`p10-classaudit.log` / `p10-help1440.log` / `p10-help430.log` / +> `p10-gateprobe2.log`,本轮九条完整日志为 `p10-suite-*.log`,索引 `p10-suite-index.log`)。 +> **没有 `lint`、没有单元测试**——上面九条是仓库里真实存在、且能作为退出条件用的全部命令。 + +**与既有基线的可比性**:本轮口径与阶段 9 完全一致—— +`visualcheck` 的 **15 路由 × 3 视口 × 2 主题 = 90 个状态**(14 条业务路由 + `/not-a-page` 兜底页), +更早的 **84 状态基线**(14 路由 × 3 × 2)逐条仍在这 90 张里,编号与文件名规则未变,可直接 diff; +`semanticcheck` 是另一套名单(**13** 条路由,含 `/help`、`/403`、一条不存在的路由), +两套名单口径不同这件事本身记在 §7 第 5 条,本轮没有把它们对齐。 + + +### 5.1 与本轮直接相关的三条读数原文 + +**① `gateprobe`(19 条判据 / 79 条断言,0 FAIL)** + +``` + 摘掉自家夹具 2 个 → 剩余 pb-* 节点 0(应为 0) +OK semanticcheck.GLYPH-whole-live 真页面原样 必须放行 → 没点名 +OK semanticcheck.GLYPH-whole-live aria-label=ellipsis 必须点名 → 点名了 ellipsis|ellipsis +OK semanticcheck.GLYPH-whole-live aria-label=/api/meta 必须放行 → 没点名 +GATEPROBE_OK 19/19 闸门坏了会响、好了不响 exit=0 +``` + +**② `census-icons`(只读普查 · 收口对账,`reports/ui_evidence/nex-p10/census/`)** + +``` +图标读数 1072 条(1440 × dark/light) + 字形名对 AT 可见:80(包围盒口径)/ 80(AT 可读口径) ← 立项时 900 + 其中「图标是宿主唯一语义」:0 条 / 0 种 ← 立项时 42 +── A 组按字形聚合 top 22 + up 38 · down 38 · left 2 · right 2 ← 全部是 antd 自绘部件(见 §7 第 3 条) +── D 组:可读名称里混进字形 token 的控件(去重) + a /api/meta api ×2 1440/dark/help + 合计 2 条读数 / 1 种 ← 立项时 261 条 +``` + +**③ `semanticcheck /help`(整名支的好样本,1440 与 430 各 0 条违规)** + +``` +GLYPH AX 名称撞中字形码 api role=link 「/api/meta」 ×2 —— DOM 侧没立案:名字来自正文文本… +GLYPH 名称整体=单个拉丁词的交互元素 0 个,其中整条名称就是登记表字形码 0 个(本遍无命中;0 也要报,这条不许悄悄空转) +=== 语义与行为 0 条违规 === exit=0 +``` + +--- + +## 6. 有代表性的截图(明暗两档一致) + +证据目录:`reports/ui_evidence/nex-p10/shots-s2/`,逐条 AX 读数在 +`AX-NAMES.json`(18 条)与 `AX-NAMES-pager-help.json`(分页两颗 + `/help` 链接)。 +每张图的 `截图` 字段与文件名一一对应,DOM 属性 + CDP `getPartialAXTree` 的 role/name 都在 JSON 里。 + +这一段先说清楚一件事:**S-2 是可访问名称缺陷,不是像素缺陷。** 下面这些图的前后看起来一样, +是设计目标而不是证据缺失——名称改在 AX 树里,屏幕上的字形本来就没动(本轮 app 代码 0 改动,更是没有任何像素改动的可能)。 +真正的「前后」证据有两份: + +1. `reports/ui_evidence/nex-s2/AX-DIFF-BEFORE-AFTER3.txt`——同一组路由、同一份采集脚本, + 改动前后各跑一遍:**AX 节点数 656 / 656 不变**(没有增删任何可访问节点), + **可读名称含字形码 261 条 → 1 条**(剩下的那条是 `/help` 正文链接 `/api/meta`,合法内容)。 + 同文件下半段还逐条核了「我们承诺的中文名称是否真的进了 AX 树」。 +2. `reports/ui_evidence/nex-s2/S2-SUMMARY-search-before-after.png`——搜索框那颗唯一有可见变化的 + 前后对照(加清空键后 hover 贴边,配套改了 `app.css` 一处 `z-index`)。 + +那份 AX-DIFF 有一个盲区,本轮补上了:它跑的时候「清空搜索」「隐藏密码」「更多页签」三个名字 +读数是 **0 / 0**——不是没修好,是那次快照没进入那个状态(搜索框里没有字、眼睛没点过、视口没窄到溢出)。 +本轮这 24 条读数是**先进状态再读名称**:搜索框先打字、眼睛先点一次再读第二态、视口降到 430 再 Tab 到溢出触发器。 + +下面几张是本轮改后的状态图(明暗各一份,全部落在 `reports/ui_evidence/nex-p10/shots-s2/`): + +![搜索框:图标 upload/down 不再进名称,清空键念「清空搜索」](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-s2/S2-SUMMARY-search-before-after.png) + +![分镜页「导出」按钮:AT 名称 = 导出,内层 anticon-down aria-hidden=true](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p10/shots-s2/storyboard-export-dark.png) + +![分镜页「导入脚本 / 关键帧」:内层 anticon-upload aria-hidden=true](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p10/shots-s2/storyboard-import-light.png) + +![430 视口溢出「更多页签」触发器:键盘 Tab 到达,焦点环 solid 2px(dark rgb(22,104,220))](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p10/shots-s2/models-430-more-focus-dark.png) + +![登录页密码眼睛默认态:名称「显示密码」随状态换成「隐藏密码」](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p10/shots-s2/login-eye-show-light.png) + +读数汇总(**light / dark 逐条一致**): + +| 控件 | 路由 | AT 读到的名称 | 内层图标 | +|---|---|---|---| +| 密码眼睛(两态) | `/login` | 「显示密码」→「隐藏密码」 | 名称挂在 `.anticon-eye`/`.anticon-eye-invisible`(第 ② 档具名,随状态换词),内层 `` `aria-hidden=true` | +| 导入脚本 | `/projects/10/storyboard` | 「导入脚本 / 关键帧」 | `anticon-upload` `hidden=true` | +| 导出 | 同上 | 「导出」 | `anticon-down` `hidden=true` | +| 新增镜头 | 同上 | 「新增镜头」 | `anticon-plus` `hidden=true` | +| 搜索按钮 | `/assets` | 「搜索」(宿主 `aria-label=搜索`,实测 `hostAria` 已取到) | `anticon-search` `role=img` `hidden=true` | +| 清空键 | `/assets` | 「清空搜索」 | `aria=清空搜索` `hidden=false`(第 ② 档具名) | +| 分页 prev / next | `/assets` | 「上一页」「下一页」 | 宿主 ` railTrack(p)} +``` +```diff +- {filtered.map((p) => )} ++ {filtered.map((p) => ( ++
++ ++
++ ))} +``` +```diff +- 示例项目流程 +- {filtered[0]?.name || '暂无项目'} ++ ++ 项目流程 ++ {railProject?.name || '暂无项目'} + +- {filtered[0]?.workflow ? … ++ {railProject?.workflow ? … +``` + +| 维度 | 改前 | 改后 | +|---|---|---| +| 面板服务项目 | 恒为 `filtered[0]` | 悬停/聚焦过的那一行;**没选过 = `filtered[0]`,与改前逐字同值** | +| 那一行被搜索/筛选去掉 | — | `find` 取不到 ⇒ 自动回落第一条(不出现空面板) | +| 标题 | 「示例项目流程」 | 「项目流程」+ 一句 `title` 说明怎么切 | +| 列表 20 s 自刷 | 每帧新行对象 | 存 id ⇒ 刷新后仍指向同一项目(若存对象会被换掉) | +| 「全局动态」 | 平台级流水,与项目无关 | **不联动**(用户明说「全局动态不需要」⇒ 写成反向断言,见 §5.3 第 6 条) | +| 卡片包的那层 `div` | 无 | 只挂触发器;block 容器 ⇒ 卡面(`w-full` 的 `Tile`)量到的宽高与包之前**逐像素相同**(railswitch 的几何断言守着) | + +### 2.5 口径同步(3 个文件,无行为改动) + +- `frontend/src/app/App.tsx`:`onBriefOpenChange={setBriefOpen}` —— **只展开、不取反**的那条通道接在外壳上。 + 刻意不写成 `(v)=>!v`:悬停计时器响的那一刻 `briefOpen` 很可能是渲染时快照的旧值,先点后悬会把刚点开的抽屉顶回去。 +- `frontend/src/pages/Help.tsx`:手册两句与现状对齐(不再宣称顶栏右侧常驻系统状态;「总览右侧的示例流程」→「可悬停列表切换的流程」)。 +- `frontend/src/app/layout/ActivityCenter.tsx`:注释口径同步(运行进度由这一颗唯一代言,顶栏只剩故障才出现的那一枚)。 +- `frontend/src/styles/app.css`:注释里 `font* / lineHeight` 缺的空格,纯注释,无选择器改动。 + +### 2.6 `scripts/ui/semanticcheck.py`(+436 −15)—— 只加判据,不改业务 + +| 新增 | 是什么 | 为什么必须进闸 | +|---|---|---| +| 第 10 条 **`TABKBD`** | 在**真页面 430 档**(不是 DOM 夹具)测窄屏溢出页签的纯键盘通道:被裁页签数量、`更多` 触发器可聚焦 / 有 AX 名称 / 无字形码 / `aria-haspopup=listbox` / `aria-expanded` 会翻、Tab 4 下能到达、焦点有描边、`↓` 能开菜单、方向键能选中被裁页签、`Enter` 后页面真的切换、`Esc` 能退出(共五种坏形状) | S-3 修的是「被裁页签键盘到不了」。这类缺陷**只在真溢出时才存在**,夹具种不出来;不钉进闸,下次换 Tabs 实现就会静默复发 | +| **`GLYPH` 第二支** `whole_glyph_name()` | 从一支变两支:DOM 支继续认「`aria-label` 等于自己的类名后缀 `anticon-<码>`」;新支拿 **CDP AX 树里 AT 真读到的整条名称**撞字形码登记表 | `ellipsis` 这种「整条名称只有一个英文单词」= 等于没有名称,`NAME` 软档查不出。S-2 收尾时补的口径(阶段 10) | +| 覆盖说明 | 读不到溢出条带 ⇒ 直接 `SystemExit`;1440 档这条**自报空转**(打印在覆盖说明里,不算违规也不算通过) | 这条判据历史上空转过一次(恒 0 看着像全绿)⇒ 空转必须自己喊出来 | + +### 2.7 `scripts/ui/gateprobe.py`(+192 −6)—— 反证两条新判据「坏了会响」 + +- **判据 ⑱**:在真页面上把那颗真的 `更多` 触发器逐个改坏(`tabindex=-1` / 抹名称来源 / 名称换成字形码 `ellipsis` / `aria-expanded` 写死 `true`),五种坏形状必须**逐个被点名**,原样必须**全静**;读不到溢出条带直接 `SystemExit`。 +- **判据 ⑲**:`GLYPH-whole` 两腿——第一腿吃名称表(字符串层),第二腿**在真页面上改真按钮**(DOM 采集 5b + CDP AX 树两支各跑一遍)。 + 只测字符串那一层等于自反 §15.12 立的规矩:判据写在哪一层,反例就得造在哪一层。 +- 判据总数 17 → **19**(末行 `GATEPROBE_OK 19/19` 数的是**判据**,不是 fixture 个数:17 个 `pb-*` + 22 个 `pg-*` + ⑱ 的 5 种真页面坏形状 + ⑲ 喂名称表,本来就对不上,别拿它互相核对)。 + +### 2.8 规范与配置(3 个文件) + +| 文件 | 关键差异 | +|---|---| +| `docs/UI规范.md` | **新增 §13.9 ①②③④**:① 顶栏只报故障(含「不许顺手改的」三条);② 联动读数跟随列表(只存 id / 双通道 / 回落同值 / **「全局动态」不跟随**白纸黑字);③ 本节判据一句话总结;④ 悬停展开的**七行判据表**(动词分工 / intent delay 的实测边界 / `canHover` 收口 / 移出不自动关 / 键盘不被打扰 / 收起之后不许悬停反悔 / 收起即卸载)。§6.1 顶栏行、§7 项目入口行改为「悬停 ≥300 ms = 展开、点击 = 展开/收起」;§15.12 反证表补判据 ⑱⑲;§15.13 闸表读数同步为 19/19;S-2 那条的闸门数 2 → 3 | +| `docs/NEX-对照与例外.md` | §6 新增 5 条 **P2 漂移**(分页框英文 `Go to`、`下一页` 恒 disabled、遮罩截走顶栏 pointer events、其余 9 只 `useForm()` 抽屉留 2 颗隐形 Tab 站、hover 打开的模态被补发 `mouseenter` 重触发);§7 新增「阶段 11 追加」①–⑤ | +| `nex.config.yaml` | `gateprobe` 注释 17 → 19 条并写清算法;**baseline 由 84 状态刷新为 90 状态**(阶段 4 起兜底页 `/not-a-page` 进 `visualcheck` 名单,14 → 15 路由),并注明「更早的 84 基线逐条仍可对照」 | + +--- + +## 3. 修改原因 + +### 3.1 目标 1「header 上不显示在线状态」 + +那颗绿点是**成功态常驻读数**:它每秒钟都在屏幕上,读者第二秒就学会跳过它, +它唯一携带的信息是「今天没亮过」——而那恰好是旁边「后端离线」会说的话。 +一块永远不变的像素在顶栏就是装饰,撤掉它故障可见性一点没减。 + +**撤的边界(刻意保守)**:只撤渲染,不撤数据。`/health` 轮询照旧(离线判定和 `meta` 都要它)、 +离线红色 Badge 照旧、断点隐件口径照旧(文字 <1280 隐、整颗 <1024 隐)。 +「平台此刻在干什么」原本就有唯一代言位——`ActivityCenter`(§13.7 顶栏唯一进度源),不因为撤了绿点而需要补位。 + +**验证**:`headergeo.py` 在 3 档 × 2 主题 × 17 路由 = 102 个状态上量到 +`header 高度读数集合 = [56]`、`顶栏横向溢出 = 0`、`[badge] 节点 = 0 颗`,违规 0 条; +`[aria-label]` 顺序里右侧仍是「平台动态 → 手册 → 主题 → 账号」,撤一件东西没有让其余控件挪位(§5.6)。 + +### 3.2 目标 2「总览节点跟随项目列表切换,全局动态不需要」 + +症状不是 bug,是一块**只读面板被写死成永远服务项目列表第一行**,标题只好叫「示例项目流程」。 +三个决定: + +1. **只存 id 不存行对象**——列表 20 s 自刷一次(`useAutoRefresh`),行对象每帧都是新的; + 存对象会让面板在用户没动鼠标的情况下被换掉,存 id 则刷新后仍指向同一个项目。 +2. **回落值必须等于改造前的值**——`find(...) || filtered[0]`:没悬停过、或悬停过的那行被搜索/筛选去掉, + 都落回 `filtered[0]`,与改前逐字同值。这一条是为了让 90 状态基线仍然可比。 +3. **两条触发通道,不新增控件**——整行 `onMouseEnter` + 行内控件被键盘聚焦 + (React 的 `onFocus` 会冒泡,不必逐颗控件挂)。与 §6.5 同源:hover 永远不许是唯一入口。 + 触屏档不补第三种形态是有意为之:那一档的项目卡自己就写着「流程节点」整句,少一次预览不少任何信息。 + +**「全局动态不需要」按字面执行**:它是平台级流水,与项目无关,**不联动**, +并且写成了 `railswitch.py` 的反向断言(悬停前后「全局动态」区块文本长度不变), +防止下一轮有人为了形式统一把它也做成跟随。 + +用户第 3 条里的「节点展开改成按钮的 hover」落点是**顶栏那颗按钮**(`button.nex-console`), +不是总览这块面板——这一行根本没有按钮。这个歧义已在 §13.9 ② 显式登记,避免下一轮把整行 hover 当成 ④ 的重复删掉。 + +### 3.3 目标 3「节点展开改成按钮的 hover」——两道必须写在规范里的保险 + +**A. intent delay 300 ms + `canHover()` 收口。** 这颗胶囊最宽 520 px、坐在顶栏正中, +是从品牌块走到右侧工具区的必经之路;0 延迟会让「路过」变成「打开一扇挡住整页的抽屉」。 +300 不是手感猜测,是实测边界(真浏览器页内计时,`hoverbrief.py`):真实停留 126 ms、243 ms 不开, +412 ms 以上必开;「进入胶囊 → 抽屉类名生效」端到端 409–429 ms(= 300 ms 计时 + 抽屉挂载约 110–130 ms), +读者感知的上限就是半秒。触屏档在 `canHover()` 那一步直接不收这条通道—— +否则手指按下去先 pointerover 再 click,抽屉会「闪一下就没了」。与 Tooltip 复用同一个判据,不新造第二把尺子。 + +**B. 「收起之后不许悬停反悔」(本轮实测抓出来的新缺陷)。** 遮罩盖住整页,**也包括胶囊自己**。 +收起抽屉的一瞬间,遮罩从静止的指针下面消失,浏览器向胶囊补发一次 `mouseover + mouseenter` +⇒「Esc 收起 → 半秒后它自己又开了」。实测时间线(1440,指针停在胶囊上): + +``` +1255 ms drawer-open=false → 1646 ms btn:mouseover + btn:mouseenter → 2123 ms drawer-open=true +``` + +判据是**指针真的动过才算意图**:补发的那一束里只有 `mouseover`/`mouseenter`,没有 `mousemove`; +而人把指针移到胶囊上、或在胶囊里挪一下必然带 `mousemove`。于是:收起 ⇒ 悬停卸膛; +胶囊上的真实 `mousemove` ⇒ 重新上膛并起 300 ms 计时;已上膛时 `mousemove` 一个字都不做 +(**不许重置停留计时**——126/243/412 ms 那组边界就是按「进入后停留」量的,改成「静止 300 ms」会让它们失效)。 + +**为什么「移出不自动关」**:抽屉里是项目身份、指标、七站跳转和归档/删除,不是只读提示; +胶囊在页面正中、抽屉贴右缘,中间隔着一条遮罩,鼠标还没走到抽屉「离开即收起」就先把门关了。 +要做就得给收起也加宽限并监听抽屉自己的 `pointerenter`——那是在一条已验证的模态通道上叠两套计时器。 +四条原有出口一条没动,且逐条实测过谁真的接住了点击(`escexits.py` 八条读数): +展开时 `(胶囊中心)` 的 `elementFromPoint` 命中 `div.ant-drawer-mask`,鼠标那里按下去落的是遮罩(`maskClosable`), +视觉结果与「再点一次胶囊」相同但机制不同;「再点胶囊」这条出口真正走得通的是键盘(Shift+Tab 回胶囊按 Enter/Space)。 +**Esc 的口径是焦点在抽屉内才有效**——复测:焦点退回胶囊后连按两次 Esc,`open` 仍是 `true` +(antd 把 keydown 绑在抽屉自己身上,焦点在门外收不到)。这不是本轮引入的:点按与悬停两条进入路径 +实测都会把焦点送进 `.ant-drawer`,所以「按 Esc 能收」对用户实际走得通的每条路径都成立。 + +### 3.4 为什么会动到 kit 的 `Drawer`(一次「越界」的自证) + +加完悬停通道后跑第 9 闸 FOCUS,发现抽屉开过一次之后正文末尾永久多出两个隐形 Tab 站。 +根因不在本项目:rc-drawer 的两颗 0×0 焦点哨兵无条件渲染在 `.ant-drawer` 根节点下、不受收起影响 +(`rc-drawer/lib/DrawerPopup.js:258-270`)。**没有在业务页用高优先级选择器去补**(AGENTS.md 规则 9), +而是给 kit `Drawer` 加一个默认关闭的 `destroyOnHidden`,只让概况抽屉打开—— +它的正文是只读回显 + 底部动作条,卸载代价为零;9 只带 `useForm()` 的表单抽屉不打开(会丢值), +它们的哨兵作为 P2 登记在 §7,不在本轮扩大改动。 + +### 3.5 T-1 跑不成,查的是什么、修到了哪一步 + +三条腿(分页 / 密码显隐 / 窄视口更多页签)在 22:36 与 22:52 两次作废,两次都不是脚本失败: +`pmset -g log` 显示 22:52:21 `Display is turned off`,而 `caffeinate` 仍持有 +`PreventUserIdleDisplaySleep` ⇒ **不是空闲休眠,是外部把屏幕熄掉并锁了会话**(截图实证锁屏, +右上角「你的屏幕正在被检视」= 远程会话在线)。锁屏期间的读数全部作废并单独归档,不混进证据。 + +顺手修掉了腿本身唯一的技术阻塞:SE(System Events)在这种状态下 `count of windows` = 0, +导航自证取不到地址栏。现在 `se_url()` 优先 SE,SE 看不到窗口时退 **Safari 字典 `URL of front document`** +——实测后者在窗口数为 0 时 URL/name/bounds 全部可用,腿的导航自证三件套现在两档都命中。 +**但播报读数仍缺**(`log stream` 在写,`vo6.py` 需要 `Safari activate` + `VO+Shift+↓` 锚定才采得到, +这条教训也是本轮踩出来的:第一次冒烟我误判成「VoiceOver 静音」)。⇒ T-1 维持 **MANUAL QA REQUIRED**,不签通过。 + +--- + +## 4. 规范符合性(本轮触碰的每一面) + +> 口径沿用 `docs/NEX-对照与例外.md`:**COMPLIANT** 已符合 / **ADOPTED** 采用 NEX / **ADAPTED** 采用项目现有成熟实现 / +> **DEFERRED** 暂缓 / **NOT APPLICABLE** 不适用。NEX 条文在 `nex_design_system/docs/`,项目权威规范在 `docs/UI规范.md`。 + +| # | 触碰面 | 判定 | NEX 出处 | 项目落点(文档 / 代码) | 理由 | +|---|---|---|---|---|---| +| 1 | 顶栏撤掉健康态「在线」 | **ADAPTED** | 02 §前言 + 2.1「不让装饰本身成为注意力中心」;**06 §7 只管单次交互的六态,没有一条管常驻健康读数** | `UI规范.md` §13.9 ① + §6.1 顶栏行;`AppHeader.tsx` | 方向与 NEX 原则一致,但 NEX 缺可判定的条文(什么读数可以常驻在外壳里)。按用户原话在项目侧立规,并把候选条文回灌 NEX(见 §4.1-A) | +| 2 | 顶栏只报故障 | **COMPLIANT** | 06 §7(Error 给原因与恢复方式) | 离线红色 `Badge` + `title` 里的原因原样保留 | 故障态语义一个字没减 | +| 3 | 总览「项目流程」跟随列表 | **ADAPTED** | 07 §1「只展示可帮助决策的指标」「不应堆叠没有业务关联的卡片」;NEX **没有**「联动读数」模板 | `UI规范.md` §13.9 ②;`Dashboard.tsx::railId/railProject/railTrack` | 保留已验证的表格与卡面像素,只把常量 `filtered[0]` 换成可回落的派生值。NEX 缺该模式,登记为候选(§4.1-B) | +| 4 | 「全局动态」不联动 | **NOT APPLICABLE(按用户明示)** | 07 §1 无对应约束 | `UI规范.md` §13.9 ② 明文「不跟着切」+ `railswitch.py` 反向断言 | 平台级流水与项目无关。写成断言是为了防止下一轮被「形式统一」抹平 | +| 5 | 悬停展开概况抽屉 | **ADAPTED** | 08 §2「所有可交互元素必须能通过键盘到达」「不得只在 hover 时才说明」;**NEX 全库 `hover` 只出现 2 次(03 §悬停样式、06 §暗色检查),没有 hover-intent / hover 触发模态的任何条文** | `UI规范.md` §13.9 ④(七行判据)+ §7 项目入口行;`PipelineConsole.tsx` | 这是 NEX 最大的空白:hover 能开一扇挡住整页的模态,风险全在细节(延迟、触屏收口、移出不自动关、键盘不被打扰、收起不许反悔)。项目侧用实测边界补齐 | +| 6 | 悬停不是唯一入口(点按/键盘仍在) | **COMPLIANT** | 08 §2 第 1 条 + §1 第 3 条 | `aria-expanded` 如实报状态;`hoverbrief.py` 的「只 focus 不 mouseenter ⇒ 不开」 | 与阶段 9 在总览页同一口径 | +| 7 | `destroyOnHidden`(抽屉收起即卸载) | **ADOPTED** | 08 §2「Modal/Drawer 打开时焦点进入容器;关闭后返回触发元素」——隐形哨兵让「返回」变成两个出不去的 Tab 站 | `UI规范.md` §15.12 判据 ⑰ 口径;`Overlay.tsx::Drawer` + `ProjectBriefDrawer.tsx` | 这条是 NEX 直接对本项目的正确约束,按 NEX 修 | +| 8 | 其余 9 只 `useForm()` 抽屉的哨兵 | **DEFERRED** | 同上 | `NEX-对照与例外.md` §6 P2 | 打开会丢表单值,需要先解决「先 setFieldsValue 后 open」的写法;不在本轮扩大改动 | +| 9 | 「hover 打开的模态被遮罩补发 `mouseenter` 重触发」 | **ADAPTED(本地已修)+ 候选条文** | NEX 无 | `UI规范.md` §13.9 ④ 判据 ⑥;`PipelineConsole.tsx::hoverArmed` | 这是任何「悬停开模态」的实现都会踩的坑,值得回灌 NEX(§4.1-C) | +| 10 | S-3 溢出页签键盘通道 | **ADOPTED** | 08 §2「所有可交互元素必须能通过键盘到达」+「Tab 顺序符合视觉顺序」 | `UI规范.md` §15.12 判据 ⑱;`semanticcheck.py::TABKBD` | 被裁页签在 DOM 里 rect 完整,只有真溢出才暴露 ⇒ 判据必须跑在真页面上 | +| 11 | `GLYPH` 整名支 | **ADOPTED** | 08 §1「可读名称有下限:整条名称就是内部标识 ⇒ 按没有名称处理;判定口径是『整条』而不是『包含』」 | `semanticcheck.py::whole_glyph_name` + 判据 ⑲ | NEX 这条写得比项目原来的实现准,直接照它的口径收 | +| 12 | 分页框英文 `Go to` / `下一页` 恒 disabled | **DEFERRED(登记 P2)** | 08 §1(名称要给用户听)、06 §7(Disabled 要给原因) | `NEX-对照与例外.md` §6 两条 P2;取证 `pagcheck.json` / `locname.json` | 前者要改 kit 的 `Pager` 名称通道,后者是本项目数据量下的真实形态,都不属于用户这四条 | +| 13 | Light / Dark 成对 | **COMPLIANT** | 06 §8 | 本轮全部验证件都跑两主题(railswitch 四档 = 2 档 × 2 主题、headergeo 102 状态含 dark、visualcheck 90 状态) | 规范红线 8 | +| 14 | 不改尺子 / 不重排顶栏 | **COMPLIANT(红线)** | 04 §布局尺寸一致性 | `headergeo.py` 102 状态 `h=[56]`、溢出 `[0]`、右侧簇顺序未变(§5.6) | 撤一个子节点不该动其余控件位置 | +| 15 | 文档 / PDF / AI Chat 工作区模板 | **NOT APPLICABLE** | 07 §6 §7 | 本项目无这三类工作区 | 历轮授权明确:不为本项目不存在的模板引入布局 | + +### 4.1 建议回灌 NEX 上游的三条(本轮证据齐了才敢提) + +- **A. 常驻状态读数的准入**:NEX 06 §7 只规范「一次交互的六态」,没有条文回答 + 「系统健康态能不能永久占据外壳固定区域」。建议补一条:*外壳常驻读数只允许承载「需要用户采取行动的信息」; + 成功态若长期不变,改为故障时才出现的告警。* +- **B. 联动只读面板(linked readout)**:07 §1 Dashboard 模板没有这个构件。建议补: + *一块跟随列表的只读面板必须①只存标识不存行对象;②触发通道含键盘等价路径;③未选择时的回落值等于改造前的默认值。* +- **C. hover 触发模态浮层**:建议补:*①必须有 intent delay 且给出实测边界;②触屏(`hover:none`)必须收口; + ③移出不自动关(除非浮层就在触发元素旁边且无遮罩);④收起后必须要求指针真实移动过才允许再次悬停展开; + ⑤键盘焦点移动不得触发展开。* + +--- + +## 5. 测试命令与实际执行结果 + +> 命令全部来自 `package.json` 与 `nex.config.yaml → frontend.checks`,**没有虚构的 lint / test**。 +> 串行日志 `/tmp/p12-.log`,索引 `/tmp/p12-suite-index.log`。dev `:5173` / preview `:4173` / 后端 `:8000`。 + +### 5.1 项目闸位(本轮全部实跑) + +| 命令 | exit | 实际读数 | +|---|---|---| +| `cd frontend && npm run typecheck` | 0 | `tsc --noEmit` 无输出 | +| `cd frontend && npm run build` | 0 | `✓ built in 536ms`;唯一告警仍是 `ui-*.js 1,275.93 kB` > 1200 kB(既有口径,见 §5.5) | +| `.venv/bin/python scripts/ui/visualcheck.py`(`NEX_WIDTHS=1440,768,430`) | 0 | **90 状态**(15 路由 × 3 档 × 2 主题,90 张 PNG 全部本轮新写)· console **0** · HTTP 失败 **0** · 断言 **0** | +| `node scripts/ui/classaudit.mjs` | 0 | 10 闸逐条 0:0 死类名 / 4164 候选 · 0 绕过登记表的图标 import · 0 未走 `decorative()` 的图标出口(登记表 79 条)· 0 裸 `
` 沿用 antd 默认空态 ⇒ 空态文案这一格从此有中文保证,但没有为此新增视觉 | +| `AGENTS.md` 强制规则 9 | 不滥用局部覆盖 | 本轮没有新增任何 CSS/`!important`/深层 DOM 覆盖 | +| 红线:不改后端 / 不升级技术栈 / 不引第二套 UI 库 / 保留 `theme/antd.ts → applyRootVars → @theme` / Header 56、Sider 224-64 尺子不动 | — | **全部未触碰**:本轮业务代码净增 1 行,CSS 0 行,依赖 0 个 | + +--- + +## 5. 测试命令与实际执行结果 + +第 1–9 步串行跑在一条命令里:`zsh reports/ui_evidence/nex-p12/run-suite.sh`,逐条日志与 exit 码在 `reports/ui_evidence/nex-p12/logs/`(汇总 `suite-index.log`);第 10 步是第 9 步的**原样重跑**(同样的命令、同样的环境变量),单独记在 `suite-index2.log` + `visualcheck2.log`。用的就是项目里真实存在的那几把尺——`npm run typecheck` / `npm run build` / `scripts/ui/*`;**本项目没有 lint、没有 test、没有 e2e,本轮没有虚构**。 + +| # | 命令 | exit | 输出 | 关键读数 | +|---|---|---|---|---| +| 1 | `zsh -c cd frontend && npm run typecheck` | **0** | 4 行 / 2 秒 | `tsc --noEmit` 无输出 ⇒ 0 错误 | +| 2 | `zsh -c cd frontend && npm run build` | **0** | 39 行 / 3 秒 | rolldown 构建成功(`built in 441ms`)、CSS 警告 0 条 | +| 3 | `node scripts/ui/classaudit.mjs` | **0** | 11 行 / 1 秒 | 11 行读数,末行:`0 处断点越界(第 9 闸:10 档在册 / 5 把登记尺子 / 裸 max-[…] 与未登记名与文档-探针失同步)` | +| 4 | `env NEX_WIDTH=1440 .venv/bin/python -u scripts/ui/semanticcheck.py` | **0** | 107 行 / 744 秒 | LOCALE 扫描 antd 内置件文案 160 处、52 种取值;英文命中 0 · 在册豁免 12;实际取值 24 条(前 6:aria-label=Decrease Value、aria-label=Increase Value、aria-label=down、aria-label=left、aria-label=right、aria-label=up…);GLYPH 外泄合计 0;违规:语义与行为 0 条违规 | +| 5 | `env NEX_WIDTH=430 .venv/bin/python -u scripts/ui/semanticcheck.py` | **0** | 141 行 / 668 秒 | LOCALE 扫描 antd 内置件文案 160 处、52 种取值;英文命中 0 · 在册豁免 12;实际取值 24 条(前 6:aria-label=Decrease Value、aria-label=Increase Value、aria-label=down、aria-label=left、aria-label=right、aria-label=up…);GLYPH 外泄合计 0;违规:语义与行为 0 条违规 | +| 6 | `env NEX_WIDTH=1440 .venv/bin/python -u scripts/ui/tableaudit.py` | **0** | 34 行 / 48 秒 | === 违规 0 张表 === | +| 7 | `env NEX_WIDTH=430 .venv/bin/python -u scripts/ui/tableaudit.py` | **0** | 34 行 / 41 秒 | === 违规 0 张表 === | +| 8 | `.venv/bin/python -u scripts/ui/gateprobe.py` | **0** | 97 行 / 40 秒 | `GATEPROBE_OK 21/21 闸门坏了会响、好了不响`;`OK` 行 89 条、`FAIL` 0 条 | +| 9 | `env NEX_SHOTS=reports/ui_evidence/nex-p12 NEX_WIDTHS=1440,768,430 NEX_THEMES=light,dark .venv/bin/python -u scripts/ui/visualcheck.py` | **1** | 43 行 / 176 秒 | 90 个状态全出图;日志逐状态读数只印 1440 档 **30** 行(`visualcheck.py:514`),其中 header 高度读数 56 px × 28 次、登录页无 header 2 次;console 0 条 / HTTP 失败 4 条 / 断言 0 条 | +| 10 | `env NEX_SHOTS=reports/ui_evidence/nex-p12 NEX_WIDTHS=1440,768,430 NEX_THEMES=light,dark .venv/bin/python -u scripts/ui/visualcheck.py` | **0** | 39 行 / 172 秒 | 90 个状态全出图;日志逐状态读数只印 1440 档 **30** 行(`visualcheck.py:514`),其中 header 高度读数 56 px × 28 次、登录页无 header 2 次;console 0 条 / HTTP 失败 0 条 / 断言 0 条 | + +> 读表须知(本轮踩过的坑,写死在这里免得下一轮再骗自己): +> `scripts/ui/visualcheck.py:514` 是 `if shot_prefix and width == WIDTHS[0]: print(f"shot …")` ⇒ **日志里的逐状态读数行恒为 30 条(只有 1440 档)**,768 / 430 两档照样出图、照样进三段(console / HTTP / 断言)统计,但不打印逐行读数。所以「状态是否跑到」只能看 `shots/` 的文件名(90 个),`header h=56` 这类逐状态读数只对 1440 档成立;**同一批 90 个 PNG 是按文件名覆盖写的**,表里的「出图」是名单口径(90 个状态都跑到过),本轮留下的这批由第 10 步写出;三档 × 2 主题 × 17 路由 = 102 状态的顶栏尺子是阶段 11 的 `reports/ui_evidence/nex-p11/headergeo.py` 钉的(本轮未重跑,见 §7)。 + +**第 9 步第一跑 `exit=1`:4 条 HTTP 500,查清是后端侧磁盘打满,不是 UI 回归** + +首跑(`logs/visualcheck.log` 的起止时间戳:00:35:29 → 00:38:25)`visualcheck exit=1`,日志里 `console 0 条 / 断言 0 条`,只有 4 条 HTTP 失败: +`/users → 500 /api/users`、`/users → 500 /api/users/audit`、`/projects/10/overview → 500 /api/auth/state`、 +`/projects/10/overview → 500 /api/projects/10`。后端日志(`/private/tmp/ignchk.gW8Oi8/w/.local/logs/backend.log`, +副本 `reports/ui_evidence/nex-p12/phase12-s3/backend-500-sqlite.txt`)给出的原因是: + +``` +sqlite3.OperationalError: disk I/O error +sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) disk I/O error +``` + +同刻 `df -h /` ⇒ **整个 APFS 容器剩 105 MiB / 228 GiB(100 % 满)**。 +⇒ 这是环境故障(数据库写不动了),与本轮改动(一颗前端 locale 对象)没有因果关系: +同一时刻之前跑完的 `sema1440`(160 处内置件文案读数)、`sema430`、`tableaudit1440/430`(各 34 行、0 违规) +都是在有数据的情况下通过的,故障只落在这 4 个请求上,几分钟后同一批端点全部回到 200。 +处理:**原样重跑第 9 步**(`visualcheck2.log`,命令与环境变量完全相同),不放宽任何判据、不跳过任何路由。 +⚠ 磁盘打满会同样影响后续任何一轮回归——**这句话在几分钟后就在本轮自己身上了**:见下一段。 +(本轮实际做的最小清盘记在 §7 第 11 条:只删可再生缓存,没碰仓库与数据库。) + +**第 9 步的重跑在本轮收尾时又失败过一次,失败原因仍然是磁盘(ENOSPC)** + +第一次重跑(00:38:55 → 00:41:46,39 行、三段全 0)只有终端回显,**exit 码没有落进任何 index**; +而且它的 `visualcheck2.log` 已经被下面的 重跑 ② 同名覆盖 ⇒ 本报告以 重跑 ② 那一份为准(同名单、同口径、同命令)。 +收尾时把第 9 步**原样**又跑了两遍,两遍都写进 `logs/suite-index2.log`: + +| 尝试 | 日志原样 | 判读 | +|---|---|---| +| 重跑 ① | `visualcheck2 exit=1 行= 54 秒=145`;末段不是三段计数,而是一条 traceback,最后一行 `OSError: [Errno 28] No space left on device: 'reports/ui_evidence/nex-p12/shots/430-dark-models.png'` | 截图按 `宽→主题→路由` 顺序写到第 79 张(共 90)时磁盘一个字节都不给了:同刻 `df -k /` ⇒ avail **42 668 KiB / 100 %**。脚本在写文件处抛异常直接退出 ⇒ 连 `console / HTTP / 断言` 三段都来不及打印。这属于**跑到一半没跑完**,不是「跑完但判据不过」 | +| 清盘(本轮唯一一次机器环境操作) | 只删**可再生**的下载/构建缓存:`~/Library/Caches/{pip,Homebrew,node-gyp,arduino,com.apple.python,notion-updater,motrix-updater}`、`~/.npm/{_cacache,_npx}` | 容器可用 42 MiB → **2.5 GiB**(`df` 从 100 % 变 81 %)。**没动**仓库文件、`node_modules`、`~/Library/Caches/ms-playwright` 里的浏览器、后端进程与数据库文件 | +| 重跑 ② | `visualcheck2 exit=0 行= 39 秒=172`;末段 `console(0 条)/ HTTP 失败(0 条)/ 断言(0 条)` | 90 张截图重新逐个校验:PNG 魔数 + `IEND` 完整,最小一张 20 725 B ⇒ 上一遍那个写崩的文件已被完整覆盖 | + +⇒ 判据一条没放宽、路由一条没跳过、一条豁免都没加;这一轮里所有失败都只发生在 +「机器写不下字」这一件事上(首跑的 sqlite `disk I/O error` 与重跑 ① 的 ENOSPC 同源)。 +磁盘这条继续留在 §7 第 11 条——缓存会长回来,下一轮回归前请先看一眼 `df`。 + +## 6. 90 状态回归(15 路由 × 3 视口 × 2 主题) + +截图与日志在 `reports/ui_evidence/nex-p12/`(`NEX_SHOTS` 指过去;该目录被 `.gitignore:50` 忽略 ⇒ 结论必须抄进正文)。下表由 `shots/*.png` 的 90 个文件名生成:`✓` = 该状态出了图,`h56|「×」` = 1440 档额外打印了顶栏高度与当前选中的一级导航文本(登录页本来没有 header,记 `无 header`)。 + +| 路由(截图名 slug) | 1440 L | 1440 D | 768 L | 768 D | 430 L | 430 D | 计 | +|---|---|---|---|---|---|---|---| +| `account` | h56|无选中项 | h56|无选中项 | ✓ | ✓ | ✓ | ✓ | 6 | +| `assets` | h56|「平台资产库」 | h56|「平台资产库」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `help` | h56|无选中项 | h56|无选中项 | ✓ | ✓ | ✓ | ✓ | 6 | +| `home` | h56|「项目总览」 | h56|「项目总览」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `login` | 无 header(登录页) | 无 header(登录页) | ✓ | ✓ | ✓ | ✓ | 6 | +| `models` | h56|「模型管理中心」 | h56|「模型管理中心」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `not-a-page` | h56|无选中项 | h56|无选中项 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-delivery` | h56|「导出与成本」 | h56|「导出与成本」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-dispatch` | h56|「任务调度中心」 | h56|「任务调度中心」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-library` | h56|「资产管理」 | h56|「资产管理」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-overview` | h56|「流程概览」 | h56|「流程概览」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-review` | h56|「质检与审核」 | h56|「质检与审核」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-storyboard` | h56|「分镜与脚本」 | h56|「分镜与脚本」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `projects-10-timeline` | h56|「时间线合成」 | h56|「时间线合成」 | ✓ | ✓ | ✓ | ✓ | 6 | +| `users` | h56|无选中项 | h56|无选中项 | ✓ | ✓ | ✓ | ✓ | 6 | + +合计 **90** 个状态(15 路由 × 3 视口 × 2 主题),缺图 0。 + +三段全为 0 条(`console 0 / HTTP 失败 0 / 断言 0`)是第 10 步日志末段的实测读数;第 9 步首跑那 4 条 HTTP 500 与重跑 ① 的 ENOSPC,取证在 §5 末尾的小节里。 + +**与既有基线的可比性** + +- 状态名单、截图文件名规则、视口档位(1440 / 768 / 430)与主题档位(light / dark)自阶段 4 起未变: + 更早的 **84 状态基线(14 路由)** 逐条仍包含在这 90 张里,阶段 10 起 `/not-a-page` 兜底页在册 ⇒ 90; + `nex.config.yaml` 的 `baseline` 已按这个口径写明,本轮不动它。 +- 尺子读数与阶段 10 同一口径,但**本轮只对 1440 档有逐状态打印**(`visualcheck.py:514` 的打印条件,见 §5 读表须知): + 1440 档 30 个状态里 28 个 `header={'h': 56}`、2 个 `header=None`——那两条是登录页(登录页本来没有 header); + 404 兜底页 `not-a-page` 实测**有** header(`h=56`,明 `rgb(255,255,255)` / 暗 `rgb(17,24,32)`), + 但它没有选中的一级导航(`menu=None`,与 403 同形,属既有形态)。 + 明暗 header 底 `rgb(255,255,255)` / `rgb(17,24,32)`,选中菜单项明暗 + `bg rgb(230,244,255)` + `color rgb(22,119,255)` / `bg rgb(22,104,220)` + `color rgb(255,255,255)`。 + **768 / 430 两档本轮只出图**(照样进 `console / HTTP / 断言` 三段统计,只是不打印逐行读数); + 「三档恒 56 px」不是这一轮证的,是阶段 11 的 `reports/ui_evidence/nex-p11/headergeo.py` + 在 3 视口 × 2 主题 × 17 路由 = 102 状态上量出的 `header 高度读数集合 = [56]`(本轮未重跑它)。 +- **本轮不产生任何视觉增量**:`p21-vdelta.py` 对 13 路由 + 登录页 + 分页/空表两处定向做了改前/改后可见文本 + diff,结果为零(唯一差异是相对时间与耗时秒数那种时间性内容,见 §2.2)。 + 所以这一节的 90 张截图的作用是**证明无回归**,不是展示新长相; + 要找「改前 vs 改后」的对照,应当看 §2.2 表里那三条 DOM 级读数(`title` / `aria-label` / locale keys), + 它们只在辅助技术与 hover 提示里可见,截图上本来就看不出来。 +- 已知非确定性(不是回归):`/projects/10/storyboard` 的 Tab 走位读数在历史各轮之间会在 + `65/56` ↔ `66/56` 之间抖动(阶段 10 与本轮都出现过);`/models`、`/help`、`/403`、 + 不存在路由的 `LOCALE builtins=0` 属正常——那些页面作用域内没有 antd 内置控件。 + + +## 7. 尚未解决的问题(除 §5 末那一次最小清盘——机器环境、只删可再生缓存——本轮没有动任何别的东西) + +| # | 问题 | 现状 | 为什么本轮不动 | +|---|---|---|---| +| 1 | **T-1 读屏真实验证仍缺**(N14 三腿 + NVDA 全腿) | 本轮三次探测:`CGDisplayIsAsleep(3) = 1`——显示器仍在空闲休眠、会话锁定。VoiceOver 进程活着(pid 27416)但播报需要人工解锁 ⇒ **MANUAL QA REQUIRED**,不得宣称通过。**00:54:16 现场复测**:ctypes 直调 CoreGraphics ⇒ `CGGetActiveDisplayList` 返回 **active displays = 0**(不是「某颗 asleep」,是整个显示列表空了),`pmset -g assertions` ⇒ `PreventUserIdleDisplaySleep 0`(没有任何进程替屏幕续命)⇒ 这条只能等用户给一段保持解锁的窗口 | 需要用户给一段保持解锁的窗口,或照 `reports/ui_evidence/nex-p11/vo/README.md` 的 P11-T1-S1…S8 自行念读 | +| 2 | **`InputNumber` 步进键念英文**(`S-3-2`,P2) | 全站 76 条读数(38/主题);**不可 locale 修**(见 §3.4) | 真要中文化只能 `controls={false}` 或自绘步进器,两者都动已验证的视觉与交互——超出本轮授权 | +| 3 | **NAME 软档 45 类**(可访问名称是整句散文) | `NEX_NAMESTRICT` 默认只打印不立案 | 批量整改属于 P2 清账,本轮范围外 | +| 4 | **`Field`/`FieldBlock` 标签到不了 AT**(`T1-N6`) | 字段名全靠 placeholder | 要传 `htmlFor`,动的是 kit 表单契约,需要单独一轮 | +| 5 | **显隐眼睛在 AT 里是「图片」**(`T1-N4`/`T1-N5`) | `role="img"` + `title` 走漏进密码框名称 | 重构宿主语义,动交互 | +| 6 | **Z1:横向滚动表被 antd 拆成两张 `
`** ⇒ 列名到不了读屏耳朵(20/24 张表) | 方案二选一未定(`aria-describedby` 手工绑列名 vs 列名进单元格文本) | 拿 20 张表赌一次不属于收口轮;先补 NVDA 腿用例 N02 再定 | +| 7 | **其余 9 只带 `useForm()` 的抽屉**收起后仍留 2 颗隐形 Tab 站 | 已修 1 只(`destroyOnHidden` 那一族) | 逐个验证成本高,留作下一轮 | +| 8 | **`T1-N2` 顶栏胶囊可访问名称 ≈110 字** | 阶段 11 已除鼠标隐喻,长度这条 P2 未做 | 改名称要同步 `aria-describedby` 的长内容落点,属独立小改 | +| 9 | **首屏 JS 体积** | `ui-*.js` 1,275.93 kB raw / 396.09 kB gzip;首屏 7 个文件 1,559.97 kB raw(阶段 12 复量,口径见 §6) | 阶段 9 已判「实施 0 处」,本轮 +0.04 kB 不改变结论 | +| 10 | `docs/NEX-对照与例外.md` §6 表体**仍有 4 行是 3 格**、§7 仍有 2 行格子数不对 | 已在 §6 的「本表自身的缺陷」注记里改准条数(6 → 4) | 补列要给它们编号,属文档治理专项 | +| 11 | **机器磁盘打满**(不是本项目缺陷,但随时会打断任何一轮回归):本轮收尾实测 `df -k /` ⇒ 228 GiB 容器可用只剩 **42 668 KiB(100 % 满)** | 已经造成两次**与 UI 无关**的失败:套件首跑的 4 条 HTTP 500(后端 `sqlite3.OperationalError: disk I/O error`)与重跑 ① 的 `OSError: [Errno 28] No space left on device`(写第 79 张截图时崩,`exit=1`)。**本轮为此破例做了一次机器环境操作**:只删可再生的下载/构建缓存(`~/Library/Caches/{pip,Homebrew,node-gyp,arduino,com.apple.python,notion-updater,motrix-updater}`、`~/.npm/{_cacache,_npx}`),可用回到 **2.5 GiB(81 %)** 之后重跑 ② `exit=0`;仓库文件、`node_modules`、`~/Library/Caches/ms-playwright` 的浏览器、后端进程与数据库**都没动** | 缓存会重新长回来。下一轮回归前请先看 `df`;真正占盘的项(本地快照、模型权重、`~/Library/Containers` 56 G)要用户点头才动 | + +## 8. 等用户答复的四件事(沿用上一轮,本轮仍未答复) + +1. 给一段保持解锁的窗口补 T-1 播报三腿(或自行照 README 念读); +2. ~~`nex.config.yaml` 端口口径~~ → **本轮已按实测直接改正**(§3.5),如不同意请回退这一处; +3. 是否把 `headergeo.py` / `railswitch.py` 升为常驻闸; +4. 工作树的 commit 切分(阶段 9/10/11/11后续/12 全堆在一起)。 diff --git a/reports/NEX阶段13-T1工装收口-2026-11-09.md b/reports/NEX阶段13-T1工装收口-2026-11-09.md new file mode 100644 index 0000000..36d9e5d --- /dev/null +++ b/reports/NEX阶段13-T1工装收口-2026-11-09.md @@ -0,0 +1,274 @@ +# NEX 阶段 13 · T-1 工装收口(解锁窗口不再需要人照着六步敲) + +- 执行时间:2026-11-09 00:55 → 01:25(正文内所有读数都带实测时刻) +- 授权范围:阶段 12 报告 §7 未解决项 **#1 = T-1 真机读屏验证仍缺**。本轮**零业务代码**—— + `frontend/src/**` 一个字节都没动(最近一次改动是阶段 12 的 `providers.tsx`,mtime 00:03:22,早于阶段 12 全量回归起点 00:09:42)。 +- 开工现场(01:05 实测,`run_t1.py status`):`CGSSessionScreenIsLocked = True`(自 2026-11-08 22:32:42 未解)、 + VoiceOver 进程 27416 活着、前端 `:5173` → 200、后端 `:8000` → 200、`df /` 可用 10 101 796 KiB(阶段 12 曾只剩 42 MiB)。 + +--- + +## 0. 一句话结论 + +T-1 缺的从来不是脚本,而是**解锁之后那几分钟里人还要连敲六条命令**——阶段 11 烧掉两次(半路熄屏)、 +阶段 12 烧掉一次(`Errno 28` 写第 79 张截图时崩),三次都不是判据错,是窗口被烧掉。本轮把它压成一条命令 + 一个能挂在锁屏下的看门狗。 + +但本轮真正的收获是**推翻了一条被沿用了三轮的说法**: +「播报原文至今一条未采」不准确——**播报通道一直是通的**。已归档的三份时间线里躺着 **98 条解锁期的真 VoiceOver 播报** +(21:49–21:57,比 S-2 修复提交晚 4.5 小时),其中 **0 条含图标字形码**;缺的只是**四条 T-1 目标各自那一格**。 +而锁屏期那些腿之所以白跑,是因为**旁白在念登录窗**——播报非零,落点全错,所以「零播报即停」这道防线根本拦不住它。 +本轮据此补了登录窗哨兵。**四条目标的播报仍未采到 ⇒ T-1 继续挂 `MANUAL QA REQUIRED`,不签通过。** + +--- + +## 1. 修改文件清单 + +| 文件 | 性质 | 体量 | 为什么改 | +|---|---|---|---| +| `reports/ui_evidence/nex-p11/vo/run_t1.py` | **新建** | 26 019 B / 只用标准库 | 一键盘子:`status / arm / stop / wait / legs / report / all`。锁屏时能挂,解锁后自己跑完三条腿并出记录表;含 §2.7 的三道停腿判据 | +| `reports/ui_evidence/nex-p11/vo/README.md` | 手册 | 106 → **134 行** / 13 333 B | §2 拆「2.1 一键盘子 / 2.2 手工(必须 `export NEX_VO_RAW`)」;§1 补「播报通道真的出得来 `_ssml`」;§3 说明判定行只有人工能签;§4 坑 1 **改写**(见 §2.6);§2.1 表格补哨兵一行;另修掉上一手留下的重复文本一处 | +| `.gitignore` | 项目配置 | 第 50 行 1 → 11 行 | `reports/*evidence/` 整目录排除改成「排除内容、逐层放行 `*/vo/*.py` 与 `*/vo/README.md`」 | +| `docs/NEX-对照与例外.md` | 规范 | §6 +1 句、§7 +1 行 | 登记阶段 13 与独立复量结果;新行按 §7 表头补齐 3 格(逐行验过列数);工装体积改用实测而非估算(01:26 复核 153 404 B,见 §9.1) | + +未改:`frontend/src/**`、`scripts/ui/**`(四条闸的判据一字未动)、后端、数据库、`package.json`。 + +工作树累计待提交:**16 个文件 +1 200 / −76**(`git diff --stat` 01:08 实测),阶段 9–13 五轮堆在一起—— +`semanticcheck.py` / `gateprobe.py` / `docs/*` / `nex.config.yaml` 被多轮共同改动,干净切分需要 hunk 手术(§8 第 3 件)。 + +--- + +## 2. 修改前后差异 + +### 2.1 解锁窗口里人工要做的事:6 条命令 → 0 条 + +| 改前手工步骤 | 改后由谁做 | 位置 | +|---|---|---| +| `df -h /` 看房量 | `arm()` 自动,可用 < 1 500 000 KiB(≈1.4 GiB)**拒绝开跑** | `run_t1.py:31,143` | +| 确认 `:5173` 在线 | `services()` 自动(同时探后端 `:8000/health`;前端非 200 直接拒跑) | `run_t1.py:91,101,149` | +| `export NEX_VO_RAW=…` + 起 `log stream` | `arm()` 自动,pid 落 `logs/vo6-logstream.pid` | `run_t1.py:143` | +| `caffeinate` 顶亮屏 | `arm()` 自动(`-d -u -t 1800`,TTL 30 min);等待期发现熄屏就 `-u -t 3` 点一下;解锁到手**重新 arm 续期** | `run_t1.py:164,224,233` | +| 人工盯屏等解锁 | `wait()` 每 10 s 一次 CoreGraphics 探针,每分钟出一行进度(房量 + 采集增量) | `run_t1.py:204` | +| 依次跑三条腿 + 渲染记录表 | `legs()` + `report()` | `run_t1.py:267,379` | + +人工只剩**「解锁」这一件事本身**——脚本做不了,也不该替。 + +### 2.2 等待期的噪声:这轮才量化清楚的一条 + +同一颗采集文件 `/tmp/vo-p13-tc.txt`(`log stream --predicate process == "VoiceOver"`): + +| 期间 | 增量 | 每秒 | +|---|---|---| +| 轮询期用 osascript 自查(阶段 12 的做法) | 6 s / 701 947 B | ≈117 000 B/s | +| `screencapture` 那一分钟 | 688 866 B | ≈11 480 B/s | +| `arm()` 起采瞬间(第一次,含回溯) | 6 s / 544 528 B | — | +| `arm()` 起采瞬间(01:18 重启,无回溯) | 6 s / **7 283 B** | — | +| **本轮看门狗等待期稳态**(01:05 → 01:13,8 min) | 1 890 → 1 928 KiB = **+38 KiB** | **≈81 B/s** | +| 什么都不起的静置基线 | 60 s / 1 244 B | ≈20 B/s | + +⇒ **每起停一个 GUI 进程(osascript、screencapture 都算)旁白就写一条 launchservices 日志**, +等待期用 System Events 自查等于自己往播报日志里泼噪声。改 CoreGraphics 探针后稳态 ≈81 B/s, +按 8 h 看门狗推算 ≈ 2.3 MiB,距 `MAX_RAW` 400 MiB 上限很远。 +**开跑判据仍以 `vo6.py guard` 四项为准**,等待期的探针不算判据(README §2.1)。 + +### 2.3 独立复量 S-3 修复(不靠阶段 11 那份快照自证) + +改前快照 `logs/preflight.stage11-2318-presolve.json`(30 862 B)↔ 阶段 12 修复后 `logs/preflight.json`(30 863 B),01:07 离线逐叶子重放: + +``` +场景数 6 · 叶子总数 改前=1010 改后=1010 · 差异叶子数 = 1 + [3].tabStops[68].al : 'Go to' -> '跳至' +``` + +- 差异落在场景 [3]「素材库 · 全部素材(每页 24)」的第 69 个 Tab 停靠点:分页快速跳转 `INPUT` 的 `aria-label`; +- 文件字节差 **+1 B**,与 `Go to`(5 B) → `跳至`(6 B UTF-8) 吻合; +- 四条 T-1 目标(登录页密码眼睛 / 素材库搜索清空键 / 分页两键 / 模型库溢出「更多页签」)的 name、role, + 以及各场景 `tabCount`、`hits`、`pagerText` **全部逐字段相等** ⇒ 既确认 S-3-1 修好了,也确认**没有附带 AX 漂移**。 + +### 2.4 记录表渲染器:夹具冒烟抓到 2 个真崩溃 + +`report()` 初版直接崩,两处都是数据结构假设错了:① `preflight.json` 顶层是 **list of dict**,我按 dict 遍历拿到的是键名; +② 时间线里的 `ax` 字段是被 `str()` 过的字典字面量,`json.loads` 解不开,得 `ast.literal_eval`。 +改完按 `(场景片段, 目标键)` 二键定位,每个目标输出 8 行:**AX 对照 / 实际播报 `_ssml` 原文 / 判据与机器预判 / 判定(人工签)**。 +判据列自己算「播报里是否混入字形码」(`GLYPHS` 30 个字形 + `ROLE_WORDS` + `STATE_WORDS`),但**脚本无权签「通过」**——那一行永远留空给人。 + +### 2.5 交接遗留的一处小脏(已清) + +上一手在 README §2.1 的替换里留了旧句尾巴,同一格出现两遍结论。本轮删并重测该行。 + +### 2.6 【更正】播报通道不是没通,锁屏期腿在读登录窗 + +本轮翻查既有三份时间线(合计 173 行,其中 128 个 `key` 事件)后发现三条被沿用/写错的事实: + +1. **播报通道在解锁期一直是通的**。`logs/vo5-timeline.jsonl` 有 **98 条**来自 os_log `_ssml` 的真播报 + (21:49–21:57;`vo5.py:28` 与 `vo6.py:31` 用的是同一道 `_ssml` 正则,**不是 DOM 推测**)。 +2. **S-2 的真机旁证其实已经存在**:S-2 三个提交 17:24 落库,`:5173` 的 dev server 20:10 起(晚于修复), + 这 98 条播报里 **0 条含字形码**(拿 `GLYPHS` 全 30 项做词边界匹配),而 S-2 改过的控件确实被念到了—— + 顶栏那颗就是「**搜索 ⟦停⟧ 按钮**」。同批还覆盖了「切换明暗主题,当前为浅色 按钮」「打开导航菜单 , 已收起 按钮」 + 「放大查看:《末班车》第一集 首帧 按钮 主要」「删除这个项目 按钮」「重试 按钮」等。 + ⇒ **S-2 的「可用读屏环境验证」不再只有 CDP 推断**;但四条 T-1 目标各自那一格仍缺(见下)。 +3. **锁屏期的腿不是「采不到」,是「采错了」**:`logs/locked-2236-2238/` 里 22:36 与 22:37 两张「页面截图」 + **MD5 完全相同**(`f8844af4…`,177 741 B)——截的是登录窗;同一条腿念回来的是 + 「Apple Watch | 解锁 | 共享屏幕时,无法使用」「显示了2个系统对话框」;归档时间线 31 条播报里 **19 条**是这种噪声。 + 另外在这 128 个 `key` 事件里搜四条目标的关键字(`显示/隐藏密码`、`清空搜索`、`上一页`、`下一页`、`更多页签`、`跳至`)——**命中 0**。 + +同时更正 README §4 坑 1 原文「锁定 / 熄屏采不到播报」→「锁定 / 熄屏时腿会照跑,但读的是登录窗」。 + +### 2.7 于是补了第三道停腿判据(登录窗哨兵) + +`legs()` 原来只有一道防线(第一条腿零播报即停),§2.6 证明它拦不住「播报非零但落点在登录窗」。新增: + +| 判据 | 触发即 | 依据 | +|---|---|---| +| 第一条腿播报命中 `LOCK_MARK`(`Apple Watch` / `共享屏幕时,无法使用` / `显示了2个系统对话框`),且 `≥2 条` 或 `占比过半` 或 `总播报≤6 条` | 停,提示「先确认真解锁」再单独 `legs` | 19/31、1/5 是锁屏;解锁期 0/98 | +| 腿与腿之间 `CGSSessionScreenIsLocked` 又变 True | 停,已按完的腿照常出记录表 | RustDesk 断连会重新锁屏 | +| 命中 1 条且占比很低 | **放行**,只在记录表保留原文 | 解锁态正常跑也可能飘进一条系统对话框播报,**误伤等于反向烧窗口** | + +三份真实时间线 + 一份合成反例的回归(01:16 实测): + +| 样本 | 播报 | 登录窗噪声 | 判定 | +|---|---|---|---| +| `vo6-timeline.jsonl`(22:52 锁屏期那条腿) | 5 | 1 | **中止** ✓ | +| `archive-locked/…含锁屏与冒烟.jsonl` | 31 | 19 | **中止** ✓ | +| `vo5-timeline.jsonl`(21:50 解锁期真播报) | 98 | 0 | 放行 ✓ | +| 合成反例(01:20 实跑):解锁态 20 条里飘进 1 条系统播报 | 20 | 1 | 放行 ✓ | + +--- + +## 3. 修改原因(为什么这轮做工装而不是继续改代码) + +1. **T-1 是阶段 8 起挂着的最后一格**,唯一阻塞是 GUI 会话锁定;产品侧代码在阶段 11/12 已收口(S-3 根因修复复量通过,§2.3)。再动产品代码就是没有证据的瞎改。 +2. **三次烧窗口全是同一类事故**(熄屏、磁盘、命令顺序),说明缺的是「把六步变成一个有前置检查的事务」。 +3. **落点哨兵是 §2.6 逼出来的**:不新增这一道,今晚的解锁窗口仍可能整条烧在登录窗上,而且脚本会报告「采到了播报」。 +4. **工装该进仓**:`.gitignore` 之前排的是整个 `reports/*evidence/`,阶段 11–13 攒出的 21 个 T-1 脚本**只存在于这块盘上**;换机或重克隆就要照报告手工重建尺子。这与本项目「证据可再生、结论必须抄进 `reports/*.md` 正文」是同一条卫生原则的两面——放行的仍是**尺子与手册**,不是证据(21 个文件 / 153 404 B = 149.8 KiB;`logs/`、`*.json`、截图照旧忽略,已用 `git check-ignore` 逐个验过)。 + +--- + +## 4. 规范符合性 + +| 条款 | 结论 | +|---|---| +| AGENTS.md 强制规则 2(不擅自改技术栈)/ 3(不硬编码设计值)/ 4(不私建视觉变体) | **满足**——本轮零产品代码、零样式 | +| AGENTS.md 规则 10(先计划后改动)+ brief「阶段之间设检查点」 | **满足**——改动全部落在 `reports/` 工装、`.gitignore`、两份文档 | +| NEX 08-accessibility-responsive | **未推进**:T-1 是它的验收腿,本轮只让这条腿变得可执行且不空烧;状态仍为 `MANUAL QA REQUIRED` | +| `docs/UI规范.md` 十二步回归 / 闸门口径 | **未动口径**:classaudit、tableaudit、semanticcheck、gateprobe 判据一字未改;新增的是采集工装,不是新闸 | +| 阶段 0「只允许改规范文档、Agent 指令和项目配置」 | `.gitignore` 属项目配置,在本条延长线上,已在 `docs/NEX-对照与例外.md` §7 登记 | +| 对照表 §6 `S-3-1` | 追加独立复量一句,状态不变(已修) | +| S-2 证据链 | **加固**:新增真机播报旁证 98 条 / 字形码 0(§2.6)。状态不由本轮改签——四条目标仍缺 | + +--- + +## 5. 测试命令与实际执行结果(全部本轮 01:07–01:20 亲自跑,不是引用上一轮) + +| # | 命令 | 退出码 | 关键读数 | +|---|---|---|---| +| 1 | `cd frontend && npm run typecheck` | **0** | `tsc --noEmit` 无输出 | +| 2 | `cd frontend && npm run build` | **0** | 3 184 modules,562 ms;`ui-*.js` **1 275.93 kB / gzip 396.09 kB**——与阶段 12 **逐字节一致**(产物名 `ui-DsRXK1XH.js`);`dist` 共 5.7 MB | +| 3 | `node scripts/ui/classaudit.mjs` | **0** | 0 死类名 / 4 165 候选;R15 图标出口 79 条 / 0 处外部 import;第 8 闸 Tag className 0;第 9 闸断点 0(10 档在册 / 5 把登记尺子);裸 ``(有 children)、 +`aria-label="切换"`(三元换图形带名字)、`export const I`(不是 JSX)、`更多页签`(合法的中文图标名)。 +真文件面再加两条:`ICNN` 这个前缀必须**不出现**在输出里,而计数行 `0 处图标型控件缺自然语言名称` **必须在场** +——「一个字都没读出来」等于判据瞎了,不是判据过了。 + +### 2.3 顺手修的那条红:判据 ㉒ 钉错了位置(**不是 S-2 引入的**) + +本轮第一次跑 `gateprobe` 拿到 **112 OK / 1 FAIL / exit=1**,FAIL 是阶段 16 的产物预算闸: + +``` +FAIL chunkbudget.broken DEGRADED 必须放行 → 点名了 + 实际: … 预算来源 : 不可信 —— 配置文件读坏了(见 CONFIG-BAD / CONFIG-MISSING),不冒充 DEGRADED 也不假装按兜底量过 + … CONFIG-BAD 配置不是合法 JSON … → 配置坏了必须响,不许混成 DEGRADED 用兜底蒙过去 +``` + +病灶:`verdict` 是**裸子串匹配**,而 `chunkbudget.mjs` 在「配置读坏了」这条路上 +**自己的解释散文里就写着字面量 `DEGRADED`**(两句),于是「好形状」被自己的散文撞中。 +这不是漏检而是**判据钉错了层**:钉在闸给人看的文案上,而不是钉在闸的结构化字段上。 + +修法(二选一里选了后者,**一条判定语义都没放宽**): +不动闸的文案(那两句解释是对的、有用的),把 ㉒ 的两腿一起改钉字段前缀 `预算来源 : `: + +| 断言 | 改前 | 改后 | +|---|---|---| +| 退化那腿(必须点名) | `"DEGRADED"` | `"预算来源 : DEGRADED"` | +| 坏配置那腿(必须放行) | `"DEGRADED"` | `"预算来源 : DEGRADED"` | + +现场核对(同尺复量):无 `output.budget` → `预算来源 : DEGRADED —— 配置里没有 output.budget…`; +配置读坏 → `预算来源 : 不可信 —— 配置文件读坏了…`。两腿现在评的是**同一个字段**, +而另一腿 `chunkbudget.degraded` 要求「DEGRADED 必须点名」仍然成立,没被一起改哑。 + +--- + +## 3. 修改原因(为什么这几处、为什么不是别处) + +1. **为什么不改业务代码**:复扫显示 46 颗图标型控件全部有名、79 条出口全部 `decorative()`、 + 浏览器侧 0 条字形码。没有缺陷可修;此时动 `frontend/src` 只会拿已验证的交互去换风险。 +2. **为什么补源码闸而不是补浏览器探针**:浮层要「点开」才在 DOM 里,而常驻探针的口径是 + 15 条路由的关闭态(这是它能在 CI 前几秒跑完的代价,不该为这一族破坏它)。 + 自闭合 JSX 无 children 这个结构事实让「没有名字」可以静态判定 ⇒ 闸放在源码侧, + 且 `s2overlay.py` 留作**按需取证**工具(不进退出码),量出来的 16 颗盲区正好是它该看的。 +3. **为什么不批量 `aria-hidden`**(用户明确禁止,也确实不该):46 颗图标型控件里 + 「图标是宿主唯一语义来源」的正是这一族,批量隐藏等于把「念英文码」换成「念『按钮』」, + 是把缺陷换了个方向而不是修掉。 +4. **为什么连带修 ㉒**:本轮验收证据要求末行 `GATEPROBE_OK N/N`。㉒ 的红是阶段 16 遗留、 + 与 S-2 无关,但它不响就永远拿不到 23/23,而「拿不到」会被后来人误读成「S-2 的闸有问题」。 + 已按要求把这条写进 §15.12 教训段,避免第三次犯同类错误(第一次是阶段 8.5 的空转、第二次是阶段 10)。 +5. **文档为什么必须同步 21 → 23**:㉒ 在阶段 16 落地时**从未写进 §15.12**, + 文档里的「二十一条」和脚本里的 `23/23` 已经不一致;本轮不补,下一轮就会被拿旧数字对账。 + +--- + +## 4. 规范符合性说明 + +| 依据 | 本轮怎么落的 | +|---|---| +| `AGENTS.md` 强制规则 1「先复用,后新增」 | 没有新增组件、没有新增视觉变体;新闸复用 `classaudit` 已有的 `stripComments`/退出码聚合/`gateprobe` 反向验证姿势 | +| 强制规则 2「不擅自改技术栈」 | 尺子仍是 Node + Playwright,未引入任何依赖;`frontend/package.json` 未改 | +| 强制规则 3「禁止硬编码设计值」 | 本轮不涉及样式,`app.css`/`theme/` 未触碰 | +| 强制规则 6「交互状态完整 · 可点击元素必须键盘可达」 | 未改交互;`semanticcheck` 的键盘/焦点判据在 1440 与 430 两档仍 0 违规(§5 第 7 条) | +| 强制规则 9「不滥用局部覆盖」 | 0 处 CSS 改动 | +| 强制规则 10「先提交计划再改动」 | 授权书即计划;实际改动 3 个文件 + 1 个探针 + 2 份文档,未越界 | +| `docs/UI规范.md` §5.1.1(图标语义三档) | 三档口径不变,闸从三道补到**四道**并写明第四道管的是「名字根本没写」 | +| `docs/UI规范.md` §15.12(反向验证) | 判据条目 21→23、形状表补两行、断言 89→113、新增「判据必须钉字段不能钉散文」教训 | +| `docs/UI规范.md` §16(人工验收边界) | 未宣称真机读屏通过,边界原样保留(见 §6) | +| `docs/NEX-对照与例外.md` §2.8 / §7 | S-2 行的闸数与理由更新;§7 追加一行变更记录(表头三格齐全) | +| NEX 0.1.1 `08-accessibility-responsive.md` §1 | 阶段 10 已把「整条名称 = 图形内部标识按无名处理」推回上游(NEX 子仓库 `10ccdc1`)。本轮**不需要**再改上游:第四道管的是「宿主没有名字」,NEX 现有条款「控件的可读名称必须是自然语言」已经覆盖 | + +**对既有闸口的影响评估(用户第 7 条要求)** + +- **R15(按钮一律是图标按钮)**:不受影响。R15 看的是源码里有没有 `icon={}` 这个槽, + 本轮 `frontend/src` 一字未改,`classaudit` 复跑 11 条计数全 0(含 R15 所在那几条)。 + 新闸 ① 号判据**只在已经有 `icon` 槽的前提下**才要求名字,所以它不可能反过来惩罚 R15。 +- **`classaudit` 其余 10 闸**:逐行 `stripComments` 后才扫,注释里那颗 `IconClose` 不会被误立案 + (判据 ㉓ 的 `export const I` 与「注释里那一颗」两条 good 断言就是钉这个的);退出码里加入 + `ICON_NAMELESS.length`,不会静默。 +- **常驻探针(`semanticcheck` / `visualcheck` / `tableaudit`)**:口径未动,90 态基线可比较。 + `s2overlay.py` 明确标注**只读、不进退出码**(写在文件头)。 + +--- + +## 5. 测试命令与实际执行结果 + +全部为本项目真实存在的命令(本项目**没有** lint / test / e2e 脚本,未虚构)。 + +| # | 命令 | 退出码 | 关键行原文 | +|---|---|---|---| +| 1 | `node scripts/ui/classaudit.mjs` | **0** | 11 条计数全 0,含新行 `0 处图标型控件缺自然语言名称(第 2 条·附二…)`;`0 个死类名 / 4165 个候选`;`0 处图标出口未走 decorative()(登记表 79 条出口 / 0 处外部 import)` | +| 2 | `cd frontend && npm run typecheck` | **0** | `tsc --noEmit`,无输出 | +| 3 | `cd frontend && npm run build` | **0** | `dist/assets/ui-DsRXK1XH.js 1,275.93 kB │ gzip: 396.09 kB`、`index-J3ytZVJt.js 190.11 kB │ gzip: 66.01 kB`、`index-CfhQmyaG.css 89.63 kB │ gzip: 15.94 kB` —— **三个哈希与阶段 13 基线逐字节一致**(磁盘实测 `ui-DsRXK1XH.js` = 1 275 933 B) ⇒ 本轮零业务代码改动的硬证据 | +| 4 | `node scripts/ui/chunkbudget.mjs` | **0** | `CHUNKBUDGET OK`;`预算来源 : DEGRADED —— 构建器未落盘配置…退化到兜底 1500 kB(兜底≠放宽,判定照旧)`(这是在册状态,不是新红) | +| 5 | `.venv/bin/python scripts/ui/gateprobe.py` | **0** | `OK` 行 **113** 条、`FAIL` **0** 条、末行 **`GATEPROBE_OK 23/23 闸门坏了会响、好了不响`**(修 ㉒ 之前:112 / 1 / `GATEPROBE_FAIL chunkbudget.broken/DEGRADED`) | +| 6 | `.venv/bin/python scripts/ui/tableaudit.py` | **0** | `=== 违规 0 张表 ===` | +| 7 | 全量回归(15 路由 × 3 视口 × 明暗 = 90 态) | **0** | 本轮 `frontend/src` 未变,沿用当前这份树的最新一轮全量读数:`visualcheck exit=0`(02:00:30→02:03:29,`=== 断言(0 条)===`,`header h=56` 在册尺寸未变)、`semantic-1440 exit=0`(→02:15:55)、`semantic-430 exit=0`(→02:27:05),两档均 `=== 语义与行为 0 条违规 ===`;日志 `reports/ui_evidence/nex-p15/{gates,visualcheck,semantic-1440,semantic-430}.log` | +| 8 | `.venv/bin/python reports/ui_evidence/nex-p17/s2overlay.py` | **0** | 8 个浮层目标 × 明暗**全部 OK(无 SKIP)**;`合计:浮层新增图标型控件 32 颗`(= 每主题 **16** 颗关闭态量不到);`缺陷 0 颗`(无名 0 / 字形码 0 / AX 未配对 0) | + +判据 ㉒ 修复的离线复量(13 条断言单独跑):13 OK / 0 FAIL。 + +**浮层盲区实测明细**(`reports/ui_evidence/nex-p17/run2/s2overlay.json`,明暗两跑数字一致): + +| 目标 | 路由 | 关闭态 | 打开后 | 盲区 | 无名 | 字形码 | +|---|---|---|---|---|---|---| +| 01 项目概况抽屉 | `/projects/{id}/overview` | 3 | 4 | **1** | 0 | 0 | +| 02 删除确认模态 | `/` | 16 | 16 | 0 | 0 | 0 | +| 03 平台动态抽屉 | `/` | 16 | 17 | **1** | 0 | 0 | +| 04 430 导航抽屉 | `/` (430) | 17 | 18 | **1** | 0 | 0 | +| 05 新建账号抽屉 | `/users` | 15 | 16 | **1** | 0 | 0 | +| 06 编辑母版抽屉 | `/assets` | 50 | 51 | **1** | 0 | 0 | +| 07 素材灯箱 | `/assets` | 50 | 53 | **3** | 0 | 0 | +| 08 分镜检查器 | `/projects/{id}/storyboard` | 17 | 25 | **8** | 0 | 0 | +| — | **每主题合计** | | | **16** | **0** | **0** | + +打开态读到的名字全是自然中文(`项目概况`、`平台动态`、`关闭导航菜单`、`上一个 (←)`、`关闭 (Esc)`、 +`复制这一镜`、`删除这一句`…);唯一那几处英文名称是 `Increase Value` / `Decrease Value` +——**在册的 S-3-2 豁免**(`rc-input-number` 把两个 `aria-label` 写死在源码里,`zh_CN` 没有 `InputNumber` 段), +不是字形码,不在本条判据范围内。 + +--- + +## 6. 截图(浮层打开态 · 明暗成对,共 16 张) + +分镜检查器(盲区最大的一族:8 颗图标钮只在选中镜头后存在): + +![分镜检查器 · 浅色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/08-storyboard-inline-light.png) +![分镜检查器 · 深色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/08-storyboard-inline-dark.png) + +素材灯箱(关闭 / 左右翻页三颗): + +![素材灯箱 · 浅色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/07-lightbox-light.png) +![素材灯箱 · 深色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/07-lightbox-dark.png) + +430 窄屏导航抽屉(唯一非 1440 的目标): + +![430 导航抽屉 · 浅色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/04-nav-drawer-430-light.png) +![430 导航抽屉 · 深色](/Users/jiliu/工作/projects/nex_animation/reports/ui_evidence/nex-p17/run2/04-nav-drawer-430-dark.png) + +其余 10 张同目录:`01-brief-drawer-*`、`02-confirm-modal-*`、`03-activity-drawer-*`、`05-user-drawer-*`、`06-asset-drawer-*`。 +(本轮零视觉改动,截图的作用是**证明浮层里那些控件确实存在且被量到了**,不是 before/after 对比。) + +--- + +## 7. 尚未解决的问题 + +| # | 事项 | 状态 | 说明 | +|---|---|---|---| +| 1 | **S-2 的真机读屏验收** | **MANUAL QA REQUIRED** | 本轮所有「名称」证据都来自 Chromium CDP 的 AX 树(计算后的 accessible name),**不是真实读屏**。VoiceOver + Safari 只覆盖过阶段 10 那批;**NVDA + Chrome 全家仍未执行**。浮层那一族(本报告 16 颗)从未在任何读屏里被念过 | +| 2 | S-3-2:`InputNumber` 步进键念英文(`Increase/Decrease Value`) | 挂账待批 | 已查证**没有语言包通道**(`rc-input-number/es/StepHandler.js` 写死),要修只能自绘步进器 = 改已验证视觉 ⇒ 按规矩先出方案等批准,本轮不动 | +| 3 | 阶段 16 收尾未做完 | 挂账 | `reports/ui_evidence/nex-p16/` 是空的、`drawerfocus.py` 未写、§15.14 与「十三道→十四道」旧称未同步。本轮**只补了 §15.12 的判据算术**(那是拿 23/23 的前提),其余没碰 | +| 4 | 阶段 14/15/16 报告不存在 | 挂账 | `reports/` 里只有 9–13。本轮报告按「下一个可用编号 17」命名,没去补前面三份 | +| 5 | 浮层探针的覆盖面是**样本**不是**全集** | 已知边界 | `s2overlay.py` 目前登记 8 个目标(覆盖 6 类浮层)。它不是自动发现的:新加一个抽屉不会自动进这张表。要变成退出条件,得先解决「触发器清单由谁维护」 | +| 6 | 本项目的 `gateprobe` 无 CI / git hook 承载 | 已知边界 | 四道闸 + 23 条判据全靠手动执行;这也是阶段 17 坚持「源码侧要有闸」的原因——源码闸是这几把尺子里跑得最快的一族 | +| 7 | 9 件等用户答复的事项 | 未变 | 阶段 13 报告里那份清单(解锁窗口排期、`.gitignore` 放行工装口径、阶段 9–17 的 commit 切分口径、`headergeo.py`/`railswitch.py` 是否升常驻闸、仓库卫生、「全局动态不跟随」的解释、`router.tsx` 预热注释措辞等),本轮没有一项被自动执行 | + +**本轮到此暂停**:不开 S-3、不开 T-1、不动 Bundle。 diff --git a/reports/NEX阶段18-S3-2收口与首屏分包-2026-11-09.md b/reports/NEX阶段18-S3-2收口与首屏分包-2026-11-09.md new file mode 100644 index 0000000..fd229d7 --- /dev/null +++ b/reports/NEX阶段18-S3-2收口与首屏分包-2026-11-09.md @@ -0,0 +1,383 @@ +# NEX 阶段 18 · S-3-2 收口 · 第 9 闸语义翻转 · 首屏分包(2026-11-09) + +本轮授权来自用户四条目标:① 顶栏不显示在线状态;② 项目总览「流程节点」跟随项目列表行的 hover / focus; +③ 项目首页节点展开改成按钮 hover;④ 推进 S-3、T-1、Bundle。 +①②③ 的代码在 11-09 01:37–01:41 落盘,本轮做的是**活体复验**(三条各有一把尺子,见 §5.2); +④ 里 **S-3 的最后一条(S-3-2)已收口**、**Bundle 找到根因并实施了低风险 kit 分组**、 +**T-1 仍卡在无人值守的读屏环境**(MANUAL QA REQUIRED,未宣称通过)。 + +--- + +## 0. 结论先说 + +| 项 | 结论 | 证据 | +|---|---|---| +| 顶栏在线状态 | 绿色健康态 Badge 已撤,只留红色「后端离线」;顶栏高度 56px、零溢出 | `reports/ui_evidence/nex-p18/chain.log` 的 `### headergeo` 段(3 档 × 2 主题 × 17 路由 = 102 个状态,登录页无 Header 不计) | +| 流程节点跟随列表行 | 表行 `onRow` + 窄屏卡容器同时挂 hover/focus 通道;面板标题从「示例项目流程」改为「项目流程」 | 同上 `### railshot` 段 + 修正尺子后的逐状态读数 `reports/ui_evidence/nex-p18/railshot2.log`(默认 / 悬停第 3 行 / 聚焦第 1 行三档一致)+ `panel-*.png` | +| 节点展开改 hover | `PipelineConsole` 悬停 300 ms 展开概况,点按通道不变 | 同上 `### hoverbrief` 段 | +| **S-3-2**(数字框步进器英文名) | **CLOSED**:`components/ui/Input.tsx` 就地改名,第 9 闸 LOCALE 的**在册豁免由 12 处清空到 0 处** | `reports/ui_evidence/nex-p18/s3final.log`(活体 42/42)、`gateprobe2.log`(`GATEPROBE_OK 23/23`) | +| **Bundle** | **ADOPT**:按 `components/{ui,…}` · `lib` · `stores` · `api` 切出 `kit` 块,第三方大块哈希不再随 kit 改动而失效 | `reports/ui_evidence/nex-p18/bundle-evidence.txt` | +| 第 9 闸语义检查 | 判据 ⑳ 两腿各加一条断言,全量 `OK` 行 **113 → 115**、`FAIL` 0 | `reports/ui_evidence/nex-p18/gateprobe2.log` | +| T-1 读屏 | **未完成**(锁屏,无法驱动 VoiceOver / NVDA) | `reports/ui_evidence/nex-p11/vo/logs/run_t1-all.log`(rc=4 作废) | + +--- + +## 1. 修改文件清单 + +### 1.1 本轮真正新改动的文件(7 个) + +| 文件 | 性质 | 行数 | 一句话 | +|---|---|---|---| +| `frontend/src/components/ui/Input.tsx` | 业务代码(kit 层) | +65 | S-3-2:把 antd 数字框两颗步进按钮的 `aria-label` 就地改成中文,**结构 / 类名 / 像素 / 鼠标与键盘行为一字未动** | +| `scripts/ui/semanticcheck.py` | 尺子 | +658(含注释) | 第 10 条判据 `LOCALE`:`Increase/Decrease Value` 从「豁免表」搬进「检测表」,`LOCALE_EXEMPT` 清空为 `{}` | +| `scripts/ui/gateprobe.py` | 尺子 | +417 | 判据 ⑳ 两条腿各补夹具:坏形状 `pb-locnum` 必须点名、好形状 `pg-locnumzh` 必须放行 | +| `frontend/vite.config.ts` | 构建配置 | +40 | `rolldownOptions.output.codeSplitting.groups` 切出 `kit` 块(含三个必踩坑的注释) | +| `docs/UI规范.md` | 规范 | 7 处 | §5.1.1 S-3 口径改写、§15.12 纪年与断言实数(113→115、68→70)、LOCALE 口径第 ③ 条改「豁免表已空」、census 段标注 S-3-2 已修 | +| `docs/NEX-对照与例外.md` | 对照表 | 2 处 | §6 `S-3-2` 行改判为**已修 · CLOSED**;§7 变更记录插入阶段 18 | +| `nex.config.yaml` | 项目配置 | 1 处 | `gateprobe.py` 注释:21 条判据 → **23 条**、115 条断言 | + +### 1.2 一次性工装(留在证据目录,不进闸门口径,也不写进 §15 常驻探针) + +`reports/ui_evidence/nex-p18/` 下:`s3step.py`(S-3-2 活体取证)、`attrib.py`(sourcemap 归属)、 +`closure.mjs`(首屏静态闭包)、`fsbytes.mjs`(全量产物字节)、`regress.sh`(本轮全量回归驱动)、 +`bundle-evidence.txt`(首屏与 churn 实测数据)。 + +### 1.3 本轮只复验、未再改的文件(三条 UI 目标,11-09 01:37–01:41 落盘) + +`frontend/src/app/layout/AppHeader.tsx`(撤健康态 Badge + 透传 `onBriefOpenChange`)、 +`PipelineConsole.tsx`(悬停 300 ms 展开概况)、`pages/Dashboard.tsx`(`railId/railProject/railTrack`)、 +`app/App.tsx`、`layout/ActivityCenter.tsx`、`layout/ProjectBriefDrawer.tsx`。 + +> **注意(不是本轮引入)**:阶段 9 起的改动至今**全部未提交**,`git diff` 看到的是阶段 9–18 的累计面, +> HEAD 仍停在 `418fb6b`。提交切分方案在等用户答复(§7 第 5 条)。 + +### 1.4 收尾这一段(11-09 03:1x–03:4x)另外动的文件:4 处,**全不在业务路径上** + +| 文件 | 性质 | 改了什么 | 为什么 | +|---|---|---|---| +| `reports/ui_evidence/nex-p15/railshot.py` | 尺子 | 三态各读一次标题 + 附「列表前 4 行」对照(旧版只读 1 次,`railshot.py.bak` 留档) | 目标 ② 的判决原来只有一个值,证明不了「跟随」 | +| `reports/ui_evidence/nex-p18/regress.sh` | 一次性工装 | `cd` 少算一层(`../..` → `../../..`)+ 加「不在仓库根就终止」守卫 | 第一次起跑静默空转,见 §5.4 的诚实记录 | +| `frontend/src/components/ui/Input.tsx` | 业务代码 | **纯空白**:`MaybeNumberInput` 里 `ref=` 一行缩进 10 → 8 空格 | 上一段落盘时的缩进手误;`typecheck` 复跑 0 | +| `frontend/dist*`、根 `.venv_p18.py`、`frontend/vite.config.kitexp.ts` | 实验产物 | 删除临时构建目录与实验配置;**保留** `dist-b1`(分组前对照)与 `dist`(现产物) | 见 §7 第 9 条 | + +证据落盘(新增):`reports/ui_evidence/nex-p18/{chain.log, railshot2.log, regress-final.txt, +regress-progress.log, bundle-evidence.txt}` 与 `reports/ui_evidence/nex-p18/live/`(28 个文件,本轮活体截图与 `hoverbrief.json`)。 + + +--- + +## 2. 修改前后差异 + +### 2.1 S-3-2:数字框步进器「Increase Value / Decrease Value」 + +**改前**:全站 antd 内置件里最后剩下的英文可读名称就是这两颗。读屏在任意数字框上念 +「Increase Value」/「Decrease Value」,第 9 闸 `LOCALE` 把它们记在**豁免表**里(12 处在册豁免之一)。 + +**改后**:kit 层的两个数字框出口(`NumberInput` / `MaybeNumberInput`)挂一个回调 ref, +拿到 antd 的 wrapper 节点后按**精确等值**替换那两条 `aria-label`,并用 `MutationObserver` +兜住 handler 重挂载(写之前先比一次当前值,观察者不会自己咬自己)。豁免表随之清空。 + +**为什么是这条路**(三条路里只有这条不动已验证资产): +1. `controls={false}` 撤掉步进器 → 改的是**已验证视觉**,否决; +2. 语言包 `zh_CN` 补 `InputNumber` → 查证过 **antd 的 zh_CN 没有这一段**,且 `rc-input-number@9.5.0` + 把两条 `aria-label` **写死**在 `es/StepHandler.js:87/:97`,写在 `...sharedHandlerProps` **之后** + ⇒ `upHandler`/`downHandler` 只换得到里面的图形,换不掉外层按钮的名字:**组件属性通道与语言包通道两条都不存在**; +3. kit 层就地改名 → 页面 0 改动、视觉 0 改动、行为 0 改动。选了它。 + +**为什么落在 kit 这一层**:全站数字框只有这两个出口(R8 把 antd 的 import 关在 +`theme/` · `app/` · `components/{ui,forms}`),在这里收口 = 一次改完全站生效。 + +### 2.2 第 9 闸:`LOCALE` 判据从「有豁免」到「零豁免」 + +搬两条字符串时踩到一个**闸门自身的坑**,值得记进规范: +`Increase Value`/`Decrease Value` 原本**只住在 `LOCALE_EXEMPT`**,不在 `LOCALE_EN`。 +清空豁免表之后它们既不是豁免项也不是检测项 ⇒ **永远不会命中**,判据会在「实际上已经不存在英文」 +与「将来有人写回英文」两种情况下都保持沉默。修法是把两条搬进 `LOCALE_EN` +(右侧注明来源写的是「rc-input-number 写死,非 en_US 键」,并在表头注释说明末尾两条不是语言包键)。 + +夹具(判据 ⑳ 两腿,共 6 条断言):坏侧 `pb-locprev` / `pb-locdata` / `pb-locnum` 逐条点名, +好侧 `pg-loczh` / `pg-loctxt` / `pg-locnumzh` 全部放行;六条 `-seen` 采集行全部在场。 + +### 2.3 Bundle:`kit` 分组 + +**根因更正(推翻阶段 17 的结论)**:上一轮把 `ui-*.js` 当成「纯 node_modules 大块」, +所以判定「改一行 kit 不会让它换名」。用 sourcemap 的 `sources` 原始列表核过: +`ui-*.js` 里是 **39 个 `src/` 模块 + 1 054 个 `node_modules` 模块** +(`src/components/ui/**`、`lib`、`stores`、`api` 全在里面)。⇒ 改一行 kit ⇒ 共享块换哈希 ⇒ +引用它的首屏 + 15 个路由块全部换名。 +(教训已写进 §7:按包分组的归属脚本会**漏看 src 模块**,归属结论必须回到 `.map` 的 `sources` 原始列表核。) + +**改动**:`vite.config.ts` 的 `build.rolldownOptions.output.codeSplitting.groups` 加一条 +`kit` 组,`includeDependenciesRecursively: false`,`priority: 100`。 +三个必踩坑已写进配置注释:① `advancedChunks` 已废弃,与 `codeSplitting` 同时给时被**静默忽略**; +② `import.meta.url` 的 `.pathname` 是 percent-encoded(`工作` → `%E5%B7%A5…`)而模块 id 是真路径, +不 `decodeURIComponent` 就**静默不命中**;③ `includeDependenciesRecursively` 默认 `true` +会把依赖整块拖进来(实测 `kit` 涨到 1 362 kB 且路由块被吃掉)。 + +**代价与收益**(详数据见 `reports/ui_evidence/nex-p18/bundle-evidence.txt`): +首屏静态闭包 7 文件 → 6 文件,`1 560 668 / 473 172 / 386 090` B → +`1 586 227 / 481 815 / 394 551` B(raw / gzip / brotli), +即冷启动 **+1.6 % raw、+1.8 % gzip、+2.2 % brotli**(拆块失去跨块字典复用)。 +换到的是:改一行 kit 后第三方大块 `WarningOutlined-*.js`(**1 217 164 B / gzip 369 492 B**) +**哈希不变**,老用户不再重下这一块 —— 缓存留存从 90 224 B 涨到 1 307 253 B。 +判定:**冷启动多付 1.6 %,换部署期每次 kit 改动少重下约 1.19 MB**,采纳。 + +`chunkSizeWarningLimit` **没有抬**:最大块 1 276 → 1 217 kB,仍 >1 200 ⇒ vite 照旧警告。 + +### 2.4 文档同步 + +`docs/UI规范.md` 的断言实数与口径按本轮实测改写(113→115、68→70、LOCALE「豁免表已空」、 +§5.1.1 去掉「要改只能自己画步进器」那条旧推断、§15.12 纪年补阶段 18); +`docs/NEX-对照与例外.md` 把 `S-3-2` 从「未修」改判 CLOSED 并插入阶段 18 纪年; +`nex.config.yaml` 的判据数注释同步。**没有新增规范文档**,也**没有**复制一份与 `docs/UI规范.md` 重复的内容。 + +--- + +## 3. 修改原因(为什么是这几处、为什么不是别处) + +1. **S-3 只剩这一条,且它是「说不出口」而不是「不好看」**:`LOCALE` 判据存在的意义就是 + 「antd 内置件对辅助技术说的是英文」。只要豁免表还在,判据就是**有权限的谎**—— + 它永远给这一类新缺陷留出「先记豁免、以后再说」的出口。清空豁免表让下一个英文回落当场变红。 +2. **不动已验证资产**:本轮唯一的产品代码改动只在 kit 层挂了一个回调 ref。 + Header / Sider / Content 尺寸、Empty 三分类、主题跟随系统、AntD 主题与 + `theme/antd.ts → applyRootVars → @theme` 单向流**全部未触碰**;没有新增 `--nex-*` 命名空间。 +3. **闸门改动必须自证**:判据从「有豁免」翻成「零豁免」这种收紧,最容易把尺子改成永远绿。 + 所以先加夹具(⑳ 两腿 6 条断言)再改判定,`gateprobe` 端到端跑通才算落地。 +4. **Bundle 是「先分析再实施」的授权**:上一轮的分析是错的,本轮先更正根因, + 再用 churn 实验(同一份源码做一处字符串改动、逐块比哈希)拿实测, + 最后才落一条 `groups` 规则。没有动 `chunkSizeWarningLimit`,也没有做全局分包重构。 +5. **不为了统一而统一**:本轮明确**没做**的事——CSS Layer 迁移、z-index 批量替换、 + 组件库重构、移动端导航再设计、Header/Sider 尺寸调整(阶段 8 授权里的禁区原样有效)。 + +--- + +## 4. 规范符合性说明 + +| 规范条目 | 本轮结论 | +|---|---| +| `nex.config.yaml` `verification.ui_gates`(14 条常驻) | 全部照旧,未增删;§15 标题「十三道常驻探针 + 一道反向验证」与实列 13 探针 + `gateprobe` **一致**,未改口径 | +| R8(antd import 只许四处) | `Input.tsx` 属 `components/ui`,未新增越界 import;`classaudit` 第 5 条 0 | +| R11 / §5.1.1 图标语义四道闸 | 未触碰图标登记表;`classaudit` 第 2/2附/2附二条均 0 | +| R12(改尺子全量回归) | 本轮动过 `semanticcheck.py` / `gateprobe.py` ⇒ 执行 §5.3 全量回归(含 430/576) | +| R19 反馈四级表面 / R20 门牌 | 未触碰 | +| §13 交互状态完整 · §12 明暗成对 | S-3-2 活体取证跑 `STEP 5→6→7→6` 明暗一致,并留 8 张成对截图 | +| `maintain_existing_interactions` | 步进器鼠标点击、长按连发、上下键、`controls={false}` 行为均未变;只有 `aria-label` 文本变了 | +| `preserve_validated_design` | 未改任何已验证布局与尺寸;顶栏改动是**撤掉一个装饰性状态**,故障可见性不减 | +| 不引入第二套 UI 库 / 不升级技术栈 | 未引入依赖,`package.json` 未改 | +| 禁止 `--nex-*` 新命名空间 | 未新增 | +| NEX 0.1.1(跨项目标准) | 本项属「项目适配」:NEX 要求可读名称说用户语言,本项目用 kit 层就地改名满足,不搬 NEX 组件包 | + +--- + +## 5. 测试命令与实测结果 + +> 所有浏览器检查**串行**执行(同一时刻只允许一个 Playwright 实例),日志逐段落盘,每段带 `rc=`。 +> 活体链日志:`reports/ui_evidence/nex-p18/chain.log`(`### semantic-1440` / `semantic-430` / +> `headergeo` / `railshot` / `hoverbrief` / `tableaudit` 六段,六段 `rc=` 全 0,末行 `### ALLCHAIN DONE`)。 + +### 5.1 S-3-2 活体取证(42 处宿主 · 8 个站点 · 明暗各一趟) + +```bash +mkdir -p reports/ui_evidence/nex-p18/final # NEX_OUT 必须预先存在 +NEX_SHOT=1 NEX_THEME=both NEX_OUT=reports/ui_evidence/nex-p18/final \ + .venv/bin/python -u reports/ui_evidence/nex-p18/s3step.py # → S3STEP OK (0) +``` + +| 量的是什么 | 实测读数 | 判决 | +|---|---|---| +| 宿主(`.ant-input-number`) | **42 处,42 处都带步进 handler**,分布在 8 个站点(delivery / dispatch / timeline 明暗各一趟 + 模型中心抽屉) | 采集面完整 | +| DOM `aria-label` | **42/42 = `增加数值` / `减少数值`** | 改名在 kit 两个出口都生效 | +| CDP AX 树反查(读屏真正拿到的名字) | **40/42 读到中文名**;`仍带英文名的宿主 0 处` | 无一处念英文 | +| 那 2 行没反查到名字的宿主 | timeline `idx=2`:`AXup=[] AXdn=[] geo w=0 h=0 x=-1013 y=-1825`(明暗各记一次) | **0×0 且坐标在视口外的隐藏实例**:AX 树里根本没有这两颗节点 ⇒ 是「没渲染」,不是「还念英文」 | +| 步进行为(明暗各一次) | `v0=5 → mouse_up=6 → key_arrowup=7 → mouse_dn=6` | 鼠标 + 键盘两条链路都在,值可增可减 | +| 命中自测 | `self=False`,落点命中的是 `.ant-input-number …-in-form-item` 父容器 | **不是本轮引入**:antd 的 handler-wrap 静止态 `width:0`,hover/focused 才展开(`frontend/node_modules/antd/es/input-number/style/index.js:193`),指针落在折叠区命中父盒是它的固有形态。脚本因此用 `dispatch_event` 打在同一颗 React handler 上,几何单独报一笔 | +| 跨 antd `useMobile` 断点重挂载 | 560px `handler=False`(窄档本来不渲染)→ 回 1440px `handler=True 名=增加数值/减少数值` | MutationObserver 兜住了重挂载,名字没回退 | +| 退出码 | `S3STEP OK (0)` | 通过 | + +### 5.2 三条 UI 目标的活体读数 + +**① 顶栏不再显示在线状态** — `.venv/bin/python -u reports/ui_evidence/nex-p11/headergeo.py`(`rc=0`) + +- `状态 102 个(3 档 × 2 主题 × 17 路由,登录页无 Header 不计)` +- `header 高度读数集合 = [56](期望 [56])`,每一档 `溢出 [0]`,末行 `=== 违规(0 条)===` +- 顶栏文本/名称读数集合里**没有任何**「在线 / 运行中 / 健康」字样;与平台状态有关的只剩 + `button[aria-label]:平台当前空闲`(ActivityCenter 自己的按钮名,§13.7 的唯一进度源) + 和后端失联时才会挂载的红色 `后端离线` Badge(本轮后端 `/health=200`,通道存在但未触发) +- 明暗两主题的顶栏读数逐字相同(只 `切换明暗主题,当前为浅色/深色` 一处随主题变化) + +**② 项目流程面板跟随列表行的 hover / focus** — `.venv/bin/python -u reports/ui_evidence/nex-p15/railshot.py`(`rc=0`,`reports/ui_evidence/nex-p18/railshot2.log`) + +| 档位 | 面板默认 | 悬停第 3 行 | 键盘聚焦第 1 行 | 列表前 4 行(对照) | +|---|---|---|---|---| +| 1440/light | 《末班车》第一集 | **告诉你个小秘密第1期** | 《末班车》第一集 | 1《末班车》第一集 / 2 告诉你个小秘密第2期 / **3 告诉你个小秘密第1期** / 4 跨界斗地主 · 大漠客栈二番局 | +| 1440/dark | 同上 | 同上 | 同上 | 同上 | +| 430/light | 同上 | 同上 | 同上 | 同上 | + +悬停第 3 行换到的名字**正好等于第 3 行的项目名**,聚焦第 1 行换回第 1 行的项目名:跟随关系成立,且窄屏卡片通道(`.nex-tile`)与宽屏表行通道(`onRow`)行为一致。 +> 尺子修正(不是产品改动):旧版 `railshot.py` 只在三张截图拍完后读**一次**标题,打印的「默认/悬停/聚焦」实际只有最后一个值,不足以证明跟随。本轮改为每个状态各读一次并附列表行名对照,原脚本留档 `reports/ui_evidence/nex-p15/railshot.py.bak`。 + +**③ 项目首页节点展开改成 hover** — `.venv/bin/python -u reports/ui_evidence/nex-p11/hoverbrief.py`(`rc=0`) + +`=== 断言 26 条 / 失败 0 条 ===`。关键读数: + +- 阈值两侧都对:真实停留 127 ms / 244 ms **不展开**,412 / 417 / 604 ms 展开,进入→展开实测延迟 **405–414 ms**(阈值 300) +- `aria-expanded=true` 与抽屉真实开合同步;抽屉标题给的是完整项目名(`《末班车》第一集草稿 · 流程 8% · 720p /`) +- 移开鼠标**不自动收起**(可以走进抽屉操作);三条关闭通道各测一次:再点胶囊 toggle / 点遮罩 / 焦点在抽屉内按 Esc +- 键盘通道未被改写:只是获得焦点不自动展开;`Enter` 展开;对照档「全程无 mouseenter 的 Enter 打开」焦点同样落在抽屉里 ⇒ 焦点归位是抽屉固有开合行为,不是 hover 新引入的 +- 触屏档(430):`matchMedia('(hover: hover)') = False`,悬停 900 ms `open=False`,点按展开且停在展开态(没有二次取反) +- 明暗成对成立;桌面档与触屏档 console 报错各 0 条 +- 已知行为(记入 §7,未改):焦点在**抽屉外**按 Esc 不收起(探测行 `[esc] … open = True`),焦点进抽屉后 Esc 正常 + +### 5.3 首屏分包(Bundle)实测 + +数据:`reports/ui_evidence/nex-p18/bundle-evidence.txt`(1024 进制,Node `zlib` 逐文件实测 gzip / brotli)。 +**口径说明**:本轮实测取自实验产物 `frontend/dist-b1`(分组前基线)与 `dist-c4` / `dist-c4b`(分组后 + 一次 kit 内微改); +`frontend/dist` 随后被 §5.4 的 `build` 步骤重建(含 `Input.tsx` 一处纯空白修正),故其中的 `kit` 哈希与表内不同,属预期。 + +| 指标 | 分组前(dist-b1) | 分组后(dist-c4) | 差 | +|---|---|---|---| +| 首屏静态闭包文件数 | 7 | 6 | −1 | +| 首屏闭包 raw | 1 560 668 B | 1 586 227 B | **+1.638 %** | +| 首屏闭包 gzip | 473 172 B | 481 815 B | **+1.827 %** | +| 首屏闭包 brotli | 386 090 B | 394 551 B | **+2.191 %** | + +改动的真正收益在**缓存留存**(同一次 kit 内微改前后对比): + +| 对照 | 哈希改名的块数 | 哈希不变(可复用缓存)的字节 | +|---|---|---| +| 分组前 `dist-b1` vs `dist-b3` | **20 / 22** | 90 224 B(只有 `rolldown-runtime` 589 B + `index.css` 89 635 B) | +| 分组后 `dist-c4` vs `dist-c4b` | 17 / 20 | **1 307 253 B**(其中第三方大块 `WarningOutlined-*.js` 1 217 164 B / gzip 369 492 B **哈希未变**) | + +⇒ 每次改 kit 少重下约 **1.19 MB**。代价是首屏 +2.2 %(brotli),换取第三方大块不再随 kit 改动重下。 +`chunkSizeWarningLimit` 仍为 1200 kB 未抬高,最大块 1 276 → 1 217 kB 仍然告警(告警还在,只是变小)。 +根因更正:`ui-*.js` **不是纯第三方**,里面掺了 **39 个 `src` 模块 + 1 054 个 `node_modules` 模块**——这才是它哈希必然随每次业务改动失效的原因,也是本轮切 `kit` 的依据。 +`frontend/vite.config.ts` 里三个坑已写成注释:① `advancedChunks` 与 `codeSplitting` 同时给时前者被静默忽略;② `import.meta.url.pathname` 是 percent-encoded,必须 `decodeURIComponent`;③ `includeDependenciesRecursively` 默认 `true` 会把依赖整块拖进来(实测 kit 涨到 1 362 kB)。 + +### 5.4 常驻闸门与全量回归(本轮收尾实跑) + +驱动:`bash reports/ui_evidence/nex-p18/regress.sh` → 逐步日志 `regress-final.txt`、进度 `regress-progress.log`。 +> 诚实记录:`regress.sh` 第一次起跑**没跑起来**——脚本里 `cd "$(dirname "$0")/../.."` 少算了一层 +> (工装在 `reports/ui_evidence//`,距仓库根是三层),`cd` 落到了 `reports/` 后所有相对路径静默失败。 +> 已改为三层并加「不在仓库根就终止」的守卫(`[ -f frontend/package.json ] || exit 1`)后**重跑**,下表是重跑的读数。 +> 项目里真实存在的命令只有这些:`npm run {dev,build,typecheck,preview}`、`node scripts/ui/{classaudit,chunkbudget,chunkinfo}.mjs`、 +> `.venv/bin/python scripts/ui/*.py`——**没有 lint / test / e2e**,未虚构。 + +| 步骤 | 命令 | 实测读数 | EXIT | +|---|---|---|---| +| typecheck | `cd frontend && npm run typecheck` | `tsc --noEmit` 无输出 | 0 | +| classaudit | `node scripts/ui/classaudit.mjs` | **11 条判据全 0**(死类名 0 / 4174 候选、图标登记表 0 越界、79 条出口全走 `decorative()`、裸 ` + +手册 + + +""" + + +def selftest() -> int: + """六种形状各一条:三条必须咬到、两条必须放行、一条只观察。 + + 没有这一段,「宿主级 0 条」这句话证明不了任何事——阶段 32 的 C 支就是因为 + 只量图标那颗 span 的 AX 名称,才把 672 条明明有名字的宿主算成缺名。 + """ + from playwright.sync_api import sync_playwright + sink = new_sink() + with sync_playwright() as pw: + browser = pw.chromium.launch() + page = browser.new_page() + cdp = page.context.new_cdp_session(page) + cdp.send("DOM.enable") + cdp.send("Accessibility.enable") + page.goto(SELFTEST_HTML) + page.wait_for_timeout(300) + measure(cdp, page, "selftest", sink) + browser.close() + icons = {r["tagname"] for r in sink["nameless_icon"]} + lats = {r["name"] for r in sink["latin"]} + imgs = {r["name"] for r in sink["img_latin"]} + spans = {r["cls"] for r in sink["hot_span"]} + checks = [("A 无名图标钮必须立案", "button" in icons or "a" in icons), + ("B 有 aria-label 的图标钮必须放行", not any("导入脚本" in (r.get("al") or "") + for r in sink["nameless_icon"])), + ("C 宿主有正文的图标链接必须放行", not any(r.get("own") == "手册" + for r in sink["nameless_icon"])), + ("F 拉丁名按钮必须立案", "export" in lats), + ("E 图形自己报英文字形码必须立案", "down" in imgs), + ("D 裸图标点击目标必须被观察到", any("anticon-close" in c for c in spans))] + bad = [n for n, ok in checks if not ok] + print("SELFTEST 六种形状:咬到 %d / 放行 %d / 观察 %d" + % (len(sink["nameless_icon"]) + len(sink["latin"]) + len(sink["img_latin"]), + 2, len(sink["hot_span"]))) + for n, ok in checks: + print("%s %s" % ("OK " if ok else "FAIL ", n)) + for k in ("nameless_icon", "latin", "img_latin", "hot_span", "nameless_plain", "nolink"): + print(" %-14s %d 条 %s" % (k, len(sink[k]), [ + (r.get("tag"), r.get("al", ""), r.get("own", ""), r.get("name", ""))[:4] + for r in sink[k]][:4])) + print("SELFTEST %s" % ("OK" if not bad else "FAIL " + " / ".join(bad))) + return 0 if not bad else 1 + + +if __name__ == "__main__": + sys.exit(selftest() if (len(sys.argv) > 1 and sys.argv[1] == "selftest") else main()) diff --git a/reports/ui_evidence/nex-p34/s2names.py b/reports/ui_evidence/nex-p34/s2names.py new file mode 100644 index 0000000..25b525c --- /dev/null +++ b/reports/ui_evidence/nex-p34/s2names.py @@ -0,0 +1,328 @@ +#!/usr/bin/python3 +# -*- coding: utf-8 -*- +"""S-2 定点验收:把阶段 8.5 VoiceOver 实测到的那几条播报,逐条回到今天的辅助技术读数。 + +要回答的问题很具体:`upload 导入脚本`、`down 导出`、`appstore 看板`、`ordered-list 分镜表`、 +`book 手册`(`reports/ui_evidence/nex-p8f/07-screen-reader/voiceover-announcements-2026-11-08.txt` +第 10/30/50/54/99 行)——今天读屏到底念什么?全站复量(`s2host.py`)证明「整站没有缺名宿主」, +但那是普查;这一条是**定点**:同一个控件、同一把尺子(CDP 算完的 AX name),前后对着看。 + +口径: + · 名称一律问 CDP(`semanticcheck.ax_button_name`),不读 DOM 属性——阶段 9 已经证明 + 这类名字常常不在元素自己身上(name-from-contents); + · 判定 = 名称非空 **且** 整条名称里不出现登记表字形码的独立拉丁词; + · 采不到(选择器落空 / 浮层没开)一律 `没量到`,不算通过。 +退出码 = 未通过 + 没量到 的条数。 +用法:NEX_BASE=http://127.0.0.1:5173 .venv/bin/python -u reports/ui_evidence/nex-p34/s2names.py +""" +import importlib.util, json, os, pathlib, re, sys + +HERE = pathlib.Path(__file__).resolve().parent +ROOT = HERE.parents[2] +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173") +WIDTH = int(os.environ.get("NEX_WIDTH", "1440")) +HEIGHT = int(os.environ.get("NEX_HEIGHT", "1000")) +SHOTS = os.environ.get("NEX_SHOTS") == "1" + + +def _load(name, rel): + spec = importlib.util.spec_from_file_location(name, str(ROOT / rel)) + m = importlib.util.module_from_spec(spec) + spec.loader.exec_module(m) + return m + + +sc = _load("sc", "scripts/ui/semanticcheck.py") +s2o = _load("s2o", "reports/ui_evidence/nex-p17/s2overlay.py") +TG = {t["slug"]: t for t in s2o.TARGETS} + +# (编号, 阶段 8.5 的 VoiceOver 实测, 路由, 找法, 浮层开关) +CASES = [ + ("N1", "book 手册", "/", "text:手册", ""), + ("N2", "appstore 看板", "/", "text:项目总览", ""), + ("N3", "appstore 看板", "/projects/{id}/overview", "text:流程概览", ""), + ("N4", "ordered-list 分镜表", "/projects/{id}/storyboard", "text:分镜与脚本", ""), + ("N5", "upload 导入脚本", "/projects/{id}/storyboard", "text:导入脚本", ""), + ("N6", "down 导出", "/projects/{id}/storyboard", "text:导出", ""), + ("N7", "up / down 步进(英文)", "/projects/{id}/timeline", "aria:增加数值", ""), + ("N8", "close-circle 清空搜索", "/assets", "clear:", ""), + ("N9", "close 抽屉关闭键", "/projects/{id}/overview", "hostclose:", "01-brief-drawer"), + ("N10", "close 灯箱那一族", "/assets", "lightbox:", "07-lightbox"), +] + +# 窄屏收纳:430 下侧栏整体换成抽屉(阶段 8 · N7),菜单项要先开抽屉才在 DOM 里 +NAV_OPEN_JS = """() => { const b = document.querySelector('[aria-label="打开导航菜单"]'); + if (!b) return 0; b.click(); return 1 }""" + +# 「这一刻这页压根没有这段文案」≠「尺子没量到」:前者是不适用,后者必须计进退出码 +TEXT_PRESENT_JS = """(arg) => ((document.body.innerText || '').includes(arg) ? 1 : 0)""" + +FIND_JS = r"""(how) => { + const txt = (n) => String(n === null || n === undefined ? '' : n).replace(/\s+/g, ' ').trim(); + const A = 'a,button,[role=menuitem],[role=button],[role=link],[role=tab],input,textarea'; + const HOST = 'button,a[href],[role=button],[role=link],[role=menuitem],[role=tab],' + + '[role=checkbox],[role=switch],input,textarea,summary,[tabindex]:not([tabindex="-1"])'; + const ICONISH = '.anticon,svg[data-icon],[role=img],.ant-btn-icon'; + const mark = (el, k) => { + if (!el) return null; + // 抓到图标就往上爬到宿主:量 span 自己的名字会把已具名的控件算成缺名 + if (el.matches(ICONISH)) el = el.closest(HOST) || el; + el.setAttribute('data-s2name', k); + return el; + }; + const kind = how.split(':')[0], arg = how.slice(kind.length + 1); + if (kind === 'aria') return mark(document.querySelector('[aria-label="' + arg + '"]'), how); + if (kind === 'text') { + const hits = [].slice.call(document.querySelectorAll(A)) + .filter((el) => txt(el.innerText || el.getAttribute('aria-label')).includes(arg)); + const outer = hits.filter((el) => !hits.some((o) => o !== el && o.contains(el))); + const pool = outer.length ? outer : hits; + const score = (el) => { + const t = txt(el.innerText || el.getAttribute('aria-label')); + const tier = t === arg ? 0 : (t.indexOf(arg) === 0 ? 1 : 2); + const shape = el.matches('button,a[href],[role=menuitem]') && + !el.matches('li.ant-menu-item') ? 0 : 1; + return [tier, shape]; + }; + if (!pool.length) return null; + let best = pool[0], bk = score(pool[0]); + for (const el of pool) { const k = score(el); + if (k[0] < bk[0] || (k[0] === bk[0] && k[1] < bk[1])) { best = el; bk = k } } + return mark(best, how); + } + return null; +}""" + +INFO_JS = r"""(how) => { + const el = document.querySelector('[data-s2name="' + CSS.escape(how) + '"]'); + if (!el) return null; + const cls = (n) => typeof n.className === 'string' ? n.className : (n.getAttribute && n.getAttribute('class')) || ''; + const ICON = '.anticon,[role=img],svg[data-icon]'; + const g = el.matches(ICON) ? el : el.querySelector(ICON); + const r = el.getBoundingClientRect(); + return { + tag: el.tagName.toLowerCase(), + cls: cls(el).split(/\s+/).slice(0, 3).join('.'), + al: el.getAttribute('aria-label') || '', + title: el.getAttribute('title') || '', + visible: txt(el.innerText), + icon: g ? (cls(g).split(/\s+/).find((x) => x.startsWith('anticon-')) || g.tagName) : '', + iconLabel: g ? (g.getAttribute('aria-label') || '') : '', + iconHidden: g ? !!g.closest('[aria-hidden="true"]') : null, + box: Math.round(r.width) + 'x' + Math.round(r.height), + focusable: el.matches('a[href],button,input,textarea,[tabindex]:not([tabindex="-1"]),[role=button][tabindex]'), + }; + function txt(n) { return String(n === null || n === undefined ? '' : n).replace(/\s+/g, ' ').trim(); } +}""" + + +ACTOR = {"button", "link", "textbox", "combobox", "searchbox", "listbox", "menuitem", + "menuitemcheckbox", "menuitemradio", "option", "radio", "checkbox", "switch", + "tab", "slider", "spinbutton"} + + +def ax_host_name(cdp, selector): + """问辅助技术这颗**宿主**叫什么,角色不限 button。 + + `semanticcheck.ax_button_name` 的口径是「只收 role=button」,用在链接、菜单项、 + tab 上会一律返回空串 —— 那是尺子的形状,不是产品的缺陷。这里改成与全站复量 + (`s2host.py`)同一套角色集,两把尺子必须读出同一个名字,否则定点结论不可信。 + 返回 (role, name);选择器落空或 CDP 失败返回 (None, None)。 + """ + try: + doc = cdp.send("DOM.getDocument", {"depth": 1}) + nid = cdp.send("DOM.querySelector", + {"nodeId": doc["root"]["nodeId"], "selector": selector}).get("nodeId") + if not nid: + return None, None + bid = cdp.send("DOM.describeNode", {"nodeId": nid})["node"]["backendNodeId"] + nodes = cdp.send("Accessibility.queryAXTree", {"backendNodeId": bid}).get("nodes", []) + except Exception: + return None, None + live = [n for n in nodes if not n.get("ignored")] + for n in live: + if ((n.get("role") or {}).get("value") or "") in ACTOR: + return (((n.get("role") or {}).get("value") or ""), + ((n.get("name") or {}).get("value") or "").strip()) + if not live: + return None, None + named = [n for n in live if ((n.get("name") or {}).get("value") or "").strip()] + n = named[0] if named else live[0] + return (((n.get("role") or {}).get("value") or ""), + ((n.get("name") or {}).get("value") or "").strip()) + + +def leaked(name): + """整条名称里出现登记表字形码的独立拉丁词 → 返回撞中的那些(空 = 干净)。""" + low = (name or "").lower() + return [t for t in sorted(sc.GLYPH_TOKENS) + if re.search(r"(? int: + from playwright.sync_api import sync_playwright + theme = os.environ.get("NEX_THEME", "light") + rows = [] + with sync_playwright() as pw: + browser = pw.chromium.launch() + page = browser.new_page(viewport={"width": WIDTH, "height": HEIGHT}) + cdp = page.context.new_cdp_session(page) + cdp.send("DOM.enable") + cdp.send("Accessibility.enable") + page.add_init_script("try{localStorage.setItem('nex-the','%s')}catch(e){}" % theme) + sc.login(page) + pid = page.evaluate(sc.PROJECT_JS) + shot = set() + for cid, before, route, how, slug in CASES: + r = route.replace("{id}", str(pid)) if pid else route + print("[%s] %s ← %s" % (cid, how, r), flush=True) + page.goto(BASE + r, wait_until="networkidle") + page.wait_for_timeout(1500) + note = "" + if slug: + t = TG[slug] + page.set_viewport_size({"width": int(t.get("width") or WIDTH), "height": HEIGHT}) + page.goto(BASE + t["route"].replace("{id}", str(pid)), wait_until="networkidle") + page.wait_for_timeout(1500) + if not page.evaluate(t["js"]): + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", "verdict": "没量到", "why": "浮层触发器没找到"}) + page.set_viewport_size({"width": WIDTH, "height": HEIGHT}) + continue + page.wait_for_timeout(int(t.get("wait") or 900)) + route = t["route"] + kind = how.split(":")[0] + if kind == "clear": + ipt = page.locator(".ant-input-affix-wrapper input:not([readonly]), " + "input.ant-input:not([readonly])").first + try: + ipt.click() + ipt.type("测试", delay=40) + page.wait_for_timeout(500) + note = "已在输入框里打「测试」唤出清空键" + except Exception as exc: + note = "输入框没找到:%s" % exc + sel = '[class*="clear"]' + hit = page.evaluate("""() => { const el = document.querySelector( + '.ant-input-clear-icon,[class*="-clear"],[class*="clear-icon"]'); + if (el) { el.setAttribute('data-s2name','clear:'); return 1 } return 0 }""") + how = "clear:" + if not hit: + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", "verdict": "没量到", "why": note + " · 清空键没出现"}) + continue + elif kind == "hostclose": + hit = page.evaluate("""() => { const el = document.querySelector( + '.ant-drawer-close,button[aria-label*="关闭"],.ant-drawer-extra button,.ant-drawer [aria-label],.ant-drawer .ant-btn-icon'); + if (el) { el.setAttribute('data-s2name','hostclose:'); return 1 } return 0 }""") + if not hit: + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", "verdict": "没量到", "why": "抽屉关闭键没找到"}) + continue + elif kind == "lightbox": + hit = page.evaluate("""() => { const el = document.querySelector( + '.nex-lightbox-nav,[aria-label^="上一个"],[aria-label^="关闭 ("]'); + if (el) { el.setAttribute('data-s2name','lightbox:'); return 1 } return 0 }""") + if not hit: + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", "verdict": "没量到", "why": "灯箱导航键没出现(可能只有 1 项)"}) + continue + else: + if not page.evaluate(FIND_JS, how): + why = "选择器落空" + if WIDTH < 768 and page.evaluate(NAV_OPEN_JS): + page.wait_for_timeout(1300) + if page.evaluate(FIND_JS, how): + note = "430 侧栏已收纳进导航抽屉:先点开抽屉才量到" + why = "" + else: + why = "开过导航抽屉仍落空" + if why: + arg = how.split(":", 1)[1] + absent = not page.evaluate(TEXT_PRESENT_JS, arg) + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", + "verdict": "不适用" if absent else "没量到", + "why": why + (" · 整页正文里搜不到「%s」,这一档视口不渲染这颗控件" + % arg if absent else "")}) + continue + role, name = ax_host_name(cdp, '[data-s2name="%s"]' % how) + if role is None: + rows.append({"id": cid, "before": before, "route": r, "how": how, + "name": "", "verdict": "没量到", "why": "AX 树里查不到这颗宿主"}) + continue + info = page.evaluate(INFO_JS, how) or {} + info["axrole"] = role + hit = page.locator('[data-s2name="%s"]' % how).first + try: + box = hit.bounding_box() + except Exception: + box = None + if SHOTS and box and (cid[:2] + route) not in shot: + shot.add(cid[:2] + route) + HERE.mkdir(parents=True, exist_ok=True) + try: # 视口外的控件(折叠区下方、横向滚动里)先滚进来再裁 + hit.scroll_into_view_if_needed(timeout=3000) + page.wait_for_timeout(250) + box = hit.bounding_box() or box + except Exception: + pass + vw = page.viewport_size["width"] + vh = page.viewport_size["height"] + pad, lead = 12, 150 + x0 = min(max(0, box["x"] - lead), max(0, vw - 40)) + y0 = min(max(0, box["y"] - pad), max(0, vh - 12)) + clip = {"x": x0, "y": y0, + "width": max(20, min(box["width"] + lead * 2, vw - x0)), + "height": max(20, min(box["height"] + pad * 2, vh - y0))} + try: + page.screenshot(path=str(HERE / ("names-%s-%s-%s.png" % (cid, vw, theme))), + clip=clip) + except Exception as exc: + note = (note + " · " if note else "") + "截图失败:%s" % str(exc)[:60] + lk = leaked(name) + ok = bool(name) and not lk + rows.append({"id": cid, "before": before, "route": r, "overlay": slug, "how": how, + "name": name, "leaked": lk, "note": note, "info": info, + "verdict": "通过" if ok else ("名称为空" if not name else "仍混字形码")}) + try: + page.evaluate("() => document.querySelectorAll('[data-s2name]')" + ".forEach(n => n.removeAttribute('data-s2name'))") + except Exception: + pass + page.set_viewport_size({"width": WIDTH, "height": HEIGHT}) + browser.close() + + print("S-2 定点验收 · %s · %d · 主题 %s · 用例 %d 条" % (BASE, WIDTH, theme, len(rows))) + print("=" * 108) + bad = 0 + for x in rows: + if x["verdict"] not in ("通过", "不适用"): + bad += 1 + i = x.get("info") or {} + icon = i.get("icon") or "" + if icon: + if i.get("iconHidden"): + icon += "(aria-hidden)" + elif i.get("iconLabel"): + icon += "(自带名「%s」)" % i["iconLabel"] + else: + icon += "(未消音,宿主要负责)" + print("%-4s %-22s → 「%s」 %-9s role=%-9s 图标:%s" + % (x["id"], x["before"], x["name"], x["verdict"], + (x.get("info") or {}).get("axrole", "") or "-", icon or "(无图标)")) + print(" 位置 %s%s · %s%s · %s · Tab 可达=%s · 可见文字=「%s」%s" + % (x["route"], ("(浮层 %s)" % x["overlay"]) if x.get("overlay") else "", + i.get("tag", ""), ("." + i["cls"]) if i.get("cls") else "", i.get("box", ""), + i.get("focusable"), (i.get("visible") or "")[:18], + (" · " + x["note"]) if x.get("note") else "")) + json.dump(rows, open(HERE / ("s2names-%d-%s.json" % (WIDTH, theme)), "w", encoding="utf-8"), + ensure_ascii=False, indent=1) + na = sum(1 for x in rows if x["verdict"] == "不适用") + print("--- 未通过 / 没量到 合计 %d 条 · 另有不适用(这一档视口不渲染该控件)%d 条 ---" + % (bad, na)) + return bad + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/reports/ui_evidence/nex-p35/filepick_ax.py b/reports/ui_evidence/nex-p35/filepick_ax.py new file mode 100644 index 0000000..9df5659 --- /dev/null +++ b/reports/ui_evidence/nex-p35/filepick_ax.py @@ -0,0 +1,163 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""S-3:`` 原生影子文字渗进可访问名称 —— 全站取证(改前 / 改后)。 + +形状与 S-2 那族「图标字形名混入名称」一模一样,只是来源换成了浏览器原生控件文案: +`` 的 `Choose File` / `No file chosen` 活在影子 DOM 里, +DOM 侧一条属性都读不到,所以 antd 语言包那把尺子(LOCALE)量不到它。 + +同一个页面里读两遍,不碰源码: + · after = 当前实现的真实读数; + · before = 运行时摘掉 FilePick 那两条 `aria-label`(等价于改动之前没有名字通道), + Chromium 的 AX 名称是实时计算的,摘掉后重读就是当时的名字。 +判据(只判 after): + A1 全站 AX 名称里再不含 `Choose File` / `No file chosen`; + A2 每颗文件按钮的 `aria-label` == 它自己的可见文字(字符串标签时), + 即名字通道与画面上那句话同源,不会各说各话; + A3 每颗 `` 自己也是一个 AT 停靠点,且名字非空、含中文 + (它是真正的激活目标,不能 aria-hidden 掉); + A4 摘掉名字之后必须能复现英文(证明这把尺子真的在量东西,不是恒真)。 +产出:logs/filepick-ax-before.json / logs/filepick-ax-after.json +""" +import json, os, pathlib, sys +from playwright.sync_api import sync_playwright + +HERE = pathlib.Path(__file__).resolve().parent +OUTD = HERE / "logs" +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5173") +PW = os.environ.get("NEX_PASS", "admin@123") +ROUTES = ["/", "/assets", "/models", "/account", "/users", "/help", + "/projects/10/overview", "/projects/10/library", "/projects/10/storyboard", + "/projects/10/dispatch", "/projects/10/review", "/projects/10/timeline", + "/projects/10/delivery"] +DOM = """()=>[...document.querySelectorAll('input[type=file]')].map(i=>{ + const btn=i.closest('button')||i.closest('.ant-btn'); + return {text:btn?btn.innerText.replace(/\\s+/g,' ').trim().slice(0,40):null, + btnLabel:btn?btn.getAttribute('aria-label'):null, + inputLabel:i.getAttribute('aria-label'), multiple:i.multiple, + visible:!!(i.offsetWidth||i.offsetHeight||i.closest('button'))}; +})""" +STRIP = """()=>{let n=0; + for(const i of document.querySelectorAll('input[type=file]')){if(i.removeAttribute('aria-label')===undefined&&i.hasAttribute('aria-label')===false)n++} + for(const b of document.querySelectorAll('button')){if(b.querySelector('input[type=file]')&&b.hasAttribute('aria-label')){b.removeAttribute('aria-label');n++}} + return n}""" +def ax_dump(cdp): + nodes = cdp.send("Accessibility.getFullAXTree")["nodes"] + out = [] + for n in nodes: + if n.get("ignored"): + continue + role = (n.get("role", {}) or {}).get("value") + name = (n.get("name", {}) or {}).get("value") + if role in ("button", "push button", "FileUpload", "textbox", "static text"): + out.append([role, name]) + return out + +res = {} +FAILS = [] + +# ── 状态清单:13 条路由的默认态 + 两处只有交互之后才存在的 FilePick ────────────── +# ① 「导入脚本 / 关键帧」面板(`showImport` 默认收起)——标签会随已选文件变成 +# 「已选:xxx.png」,是名字通道里唯一会变的两个之一; +# ② 分镜检查器「资产」页签里的 关键帧(首帧)/尾帧/参考图/参考视频—— +# 四个页签全部保持挂载、只用 hidden 收起,`display:none` 的面板在 AX 树里是 +# ignored,必须真点一下页签才量得到(实测默认态整个页面 0 颗,点完 4 颗)。 +# ⚠ 每个状态一律**新开一个页面**:本探针要在 before 遍里摘掉 aria-label, +# 而 React 不会替被外力改掉的属性回滚,复用页面就会把上一个状态的摘名痕迹 +# 读成下一个状态的现状(第一版就在这里假阳性过一颗「选择图片 / zip」)。 +def states(): + for route in ROUTES: + yield route, None + # 面板里两种模式各一颗:默认「粘贴脚本」只有 textarea, + # 「上传脚本文件」那颗(标签会变成「已选:xxx.png」)必须再点一下页签才在场。 + yield ("/projects/10/storyboard ▸ 导入面板", + lambda pg: (pg.get_by_role("button", name="导入脚本 / 关键帧").first.click(), + pg.wait_for_timeout(600), + pg.get_by_role("checkbox", name="上传脚本文件").first.click() + if pg.get_by_role("checkbox", name="上传脚本文件").count() + else pg.get_by_text("上传脚本文件").first.click())) + yield ("/projects/10/storyboard ▸ 检查器·资产", + lambda pg: (pg.evaluate("()=>document.querySelector('[data-shot-select]').click()"), + pg.get_by_role("tab", name="资产").first.click())) + + +def run_pass(strip_first): + side = {} + with sync_playwright() as pw: + b = pw.chromium.launch() + ctx = b.new_context(viewport={"width": 1440, "height": 900}) + p = ctx.new_page() + cdp = ctx.new_cdp_session(p); cdp.send("Accessibility.enable") + p.goto(BASE + "/login", wait_until="domcontentloaded") + p.wait_for_selector("#login-user"); p.fill("#login-user", "admin"); p.fill("#login-pass", PW) + p.click("button[type=submit]"); p.wait_for_url(lambda u: "login" not in u, timeout=20000) + for tag, opener in states(): + page = ctx.new_page() + cdp2 = ctx.new_cdp_session(page); cdp2.send("Accessibility.enable") + base_route = tag.split(" ▸")[0] + try: + page.goto(BASE + base_route, wait_until="domcontentloaded"); page.wait_for_timeout(2600) + if opener: + opener(page); page.wait_for_timeout(1300) + row = {"route": tag, "picks": page.evaluate(DOM)} + if strip_first: + row["stripped"] = page.evaluate(STRIP) + page.wait_for_timeout(400) + else: + row["stripped"] = 0 + row["ax"] = ax_dump(cdp2) + if not strip_first: + row["dom_after"] = row["picks"] + else: + row["dom_before"] = row["picks"] + except Exception as exc: + row = {"route": tag, "picks": [], "error": str(exc)[:180]} + side[tag] = row + page.close() + b.close() + return side + +after = run_pass(False) +before = run_pass(True) +for tag in after: + res[tag] = {"route": tag, "picks": after[tag].get("picks", []), + "after_ax": after[tag].get("ax", []), "before_ax": before.get(tag, {}).get("ax", []), + "stripped": before.get(tag, {}).get("stripped", 0), + "before_dom": before.get(tag, {}).get("picks", []), + "error": after[tag].get("error") or before.get(tag, {}).get("error")} + +def native(names): + return [nm for _, nm in names if nm and ("Choose File" in nm or "No file chosen" in nm)] + +tot = seen = 0 +for route, row in res.items(): + if not row["picks"]: + continue + tot += len(row["picks"]) + bad_after, bad_before = native(row["after_ax"]), native(row["before_ax"]) + print("\n### %s —— %d 颗文件选择热区" % (route, len(row["picks"]))) + for d in row["picks"]: + print(" 可见文字=%-22s 按钮名=%-24s input名=%s" % (d["text"], d["btnLabel"], d["inputLabel"])) + if d["btnLabel"] and d["text"] and d["btnLabel"] != d["text"]: + FAILS.append("%s 按钮名与可见文字不同源:%r vs %r" % (route, d["btnLabel"], d["text"])) + if not (d["inputLabel"] or "").strip(): + FAILS.append("%s input 没有名字:%r" % (route, d["text"])) + seen += 1 + print(" AX 含原生英文 after=%s before(%d 处摘名)=%s" % (bad_after, row["stripped"], sorted(set(bad_before))[:4])) + if bad_after: + FAILS.append("%s after 仍有原生英文:%s" % (route, bad_after)) + # 「改前必然复现出英文」这条自检只在**有热区**的状态上成立: + # 空状态(默认态的分镜页等)本来就一颗都没有,摘不出英文不是尺子失灵。 + if not bad_before and row["picks"]: + FAILS.append("%s before 复现不出原生英文(尺子恒真?)" % route) + +OUTD.mkdir(parents=True, exist_ok=True) +for side in ("before", "after"): + json.dump({r: {k: v for k, v in row.items() if k.endswith(side) or k in ("route", "picks", "stripped")} + for r, row in res.items()}, + open(OUTD / ("filepick-ax-%s.json" % side), "w", encoding="utf-8"), ensure_ascii=False, indent=1) +print("\n共 %d 个路由 / %d 颗文件选择热区 · 失败 %d 条" % (seen, tot, len(FAILS))) +for f in FAILS: + print(" FAIL " + f) +print("写入", OUTD / "filepick-ax-after.json", "与 filepick-ax-before.json") +sys.exit(1 if FAILS else 0) diff --git a/reports/ui_evidence/nex-p35/t1/eye_paint.py b/reports/ui_evidence/nex-p35/t1/eye_paint.py new file mode 100644 index 0000000..9f540e7 --- /dev/null +++ b/reports/ui_evidence/nex-p35/t1/eye_paint.py @@ -0,0 +1,122 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""密码框眼睛的**着色契约**探针(阶段 35 · T1-N4 的视觉回归)。 + +背景:`forms/SecretInput.tsx` 的 `iconRender` 从 antd 的 `` +换成真 `
临时 +tabIndex=-1 后 focus(),让 VoiceOver 光标随键盘焦点落到该格,静听完整播报。 +播报文本由系统日志(process == "VoiceOver" 的 _ssml)事后按时间窗对齐。 +不改动任何页面代码:tabIndex 只存在于这一次浏览器会话里。 +""" +import json, os, subprocess, sys, time +from playwright.sync_api import sync_playwright + +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +HERE = os.path.dirname(os.path.abspath(__file__)) +LOG = os.path.join(HERE, "logs"); os.makedirs(LOG, exist_ok=True) +WIDTH = int(os.environ.get("NEX_WIDTH", "430")) +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-raw.txt") +MIN_DWELL = float(os.environ.get("NEX_MIN_DWELL", "9")) +HARD_CAP = float(os.environ.get("NEX_HARD_CAP", "120")) +TL = os.path.join(LOG, "focusread-timeline.jsonl") +tl = open(TL, "a", encoding="utf8") + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": time.time(), "ev": ev} + rec.update(kw); tl.write(json.dumps(rec, ensure_ascii=False) + "\n"); tl.flush() + print(json.dumps(rec, ensure_ascii=False), flush=True) + +def keys(combo): + code, mods = combo + use = " using {" + ", ".join(f"{m} down" for m in mods) + "}" if mods else "" + subprocess.run(["osascript", "-e", f'tell application "System Events" to key code {code}{use}'], + capture_output=True, text=True) + +SETFOCUS_JS = """(arg) => { + const {ti, ri, ci} = arg; + const prev = window.__nexVoPrev; + if (prev) { try { prev.removeAttribute('tabindex'); } catch (e) {} } + const w = [...document.querySelectorAll('.ant-table-wrapper')][ti]; + if (!w) return {err: 'no-wrapper'}; + const tr = [...w.querySelectorAll('.ant-table-tbody tr')] + .filter(x => !x.className.includes('measure') && !x.className.includes('placeholder'))[ri]; + if (!tr) return {err: 'no-row'}; + const td = [...tr.children].filter(x => x.tagName === 'TD')[ci]; + if (!td) return {err: 'no-cell'}; + td.scrollIntoView({block: 'center', inline: 'center'}); + td.setAttribute('data-nex-vo', '1'); + td.tabIndex = -1; + window.__nexVoPrev = td; + td.focus({preventScroll: true}); + return {ok: true, hasFocus: document.activeElement === td, + text: (td.textContent || '').replace(/\\s+/g,' ').trim().slice(0, 220), + len: (td.textContent || '').trim().length, + headers: td.getAttribute('headers') || '', axis: td.getAttribute('axis') || '', + ariaLabel: td.getAttribute('aria-label') || '', + thText: [...(w.querySelectorAll('thead th')[ci]?.querySelectorAll('*')||[])].length}; +}""" + +def ssml_count(): + n = 0 + try: + with open(RAW, errors="replace") as f: + for line in f: + if "_ssml" in line: + n += 1 + except Exception: + return -1 + return n + +def wait_speech(t0, hard, idle=3.5): + """等第一条播报出现,再等播报静默 idle 秒;返回(首条时间, 静默时间, 是否被硬上限截断)。""" + base = ssml_count() + heard = None + last = t0 + while time.time() - t0 < hard: + c = ssml_count() + if c > base: + if heard is None: + heard = time.time() + last = time.time() + base = c + elif heard is not None and time.time() - last > idle: + return heard, time.time(), False + time.sleep(0.5) + return heard, time.time(), True + +def main(): + plan = json.load(open(sys.argv[1], encoding="utf8")) + with sync_playwright() as p: + br = p.chromium.launch(channel="chrome", headless=False, + args=["--no-first-run", "--no-default-browser-check", + "--disable-features=Translate"]) + page = br.new_context(viewport={"width": WIDTH, "height": 900}).new_page() + page.goto(BASE + "/", wait_until="domcontentloaded"); page.wait_for_timeout(1500) + if page.locator("#login-user").count(): + page.fill("#login-user", "admin"); page.fill("#login-pass", "admin1234") + page.keyboard.press("Enter"); page.wait_for_timeout(2500) + mark("logged-in") + subprocess.run(["osascript", "-e", 'tell application "Google Chrome" to activate']) + time.sleep(1.5) + cur = None + for step in plan: + if step["route"] != cur: + page.goto(BASE + step["route"], wait_until="domcontentloaded") + page.wait_for_timeout(4000); cur = step["route"] + mark("route", route=step["route"]) + # 进入网页区域,让旁白光标落在文档内 + keys((125, ["control", "option", "shift"])); time.sleep(2.5) + for (ti, ri, ci, note) in step["cells"]: + info = page.evaluate(SETFOCUS_JS, {"ti": ti, "ri": ri, "ci": ci}) + if info.get("err"): + mark("skip", ti=ti, rc=[ri, ci], err=info["err"]); continue + hard = min(HARD_CAP, max(MIN_DWELL, info["len"] / 6.0 + 25)) + t0 = time.time() + mark("focus", route=step["route"], ti=ti, rc=[ri, ci], note=note, + expect=info["text"], chars=info["len"], hasFocus=info["hasFocus"], + headers=info["headers"], ariaLabel=info["ariaLabel"], hard=round(hard, 1)) + heard, quiet, trunc = wait_speech(t0, hard) + mark("cell_done", rc=[ri, ci], read_s=round(quiet - t0, 1), + first_s=round(heard - t0, 1) if heard else None, truncated=trunc) + time.sleep(2.0) + page.evaluate("() => { const e=document.querySelector('[data-nex-vo]'); if(e){e.removeAttribute('tabindex'); e.removeAttribute('data-nex-vo');} window.__nexVoPrev=null; }") + time.sleep(1.2) + mark("done") + br.close() + +main() diff --git a/reports/ui_evidence/nex-p9/vo/safari3-align.py b/reports/ui_evidence/nex-p9/vo/safari3-align.py new file mode 100644 index 0000000..1e26963 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/safari3-align.py @@ -0,0 +1,41 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""把 safari3 时间线(ev=key)与 os_log 播报按窗对齐,输出 Safari 腿的实测材料。""" +import json, os, re, sys, datetime + +HERE = os.path.dirname(os.path.abspath(__file__)) +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-tc.txt") +TL = os.path.join(HERE, "logs", "safari3-timeline.jsonl") +OUT = os.path.join(HERE, "logs", "safari3-aligned.json") +TS = re.compile(r'^(\d{4}-\d\d-\d\d \d\d:\d\d:\d\d)\.\d+ .*?_ssml: "(.*?)"', re.S) + +rows = [] +with open(RAW, errors="replace") as f: + for line in f: + m = TS.match(line) + if not m: + continue + ts, ssml = m.group(1), m.group(2).replace('\\134"', '"') + body = re.sub(r"]*/>", " ⟦停顿⟧ ", ssml) + body = re.sub(r"|", "", body) + body = re.sub(r"\s+", " ", body).strip() + if not body: + continue + epoch = datetime.datetime.strptime(ts, "%Y-%m-%d %H:%M:%S").timestamp() + rows.append({"t": epoch, "clock": ts[11:], "text": body}) + +ev = [json.loads(l) for l in open(TL, encoding="utf8") if l.strip()] +keys = [e for e in ev if e["ev"] == "key"] +ends = [keys[i + 1]["t"] - 0.3 if i + 1 < len(keys) else keys[i]["t"] + 30 for i in range(len(keys))] +out = [] +for k, e in zip(keys, ends): + seg = [r for r in rows if k["t"] - 0.8 <= r["t"] < e] + out.append({"ts": k["ts"], "action": k["action"], "spoken": [r["text"] for r in seg], + "clocks": [r["clock"] for r in seg]}) +json.dump(out, open(OUT, "w", encoding="utf8"), ensure_ascii=False, indent=1) +for o in out: + print("=" * 96) + print(f'[{o["ts"]}] {o["action"]} 播报条数={len(o["spoken"])}') + for c, t in zip(o["clocks"], o["spoken"]): + print(f' {c} 播 : {t[:180]}') +print(f"\n---- 共 {len(out)} 键 → {OUT}", file=sys.stderr) diff --git a/reports/ui_evidence/nex-p9/vo/safari_vo.py b/reports/ui_evidence/nex-p9/vo/safari_vo.py new file mode 100644 index 0000000..33b5663 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/safari_vo.py @@ -0,0 +1,123 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""真机读屏 · VoiceOver + Safari 腿(阶段 9 · T-1 第 7 项要求的第二套 AT 环境)。 + +Safari 的偏好被 TCC 锁住(`defaults` 写不进容器,AllowJavaScriptAppleEvents 打不开), +拿不到 also JS 注入口,所以这一腿全程只用键盘:登录、地址栏、旁白走位都是 System Events 按键。 +窗口宽度用 UI 脚本设成 574(macOS 把 Safari 窗口宽度钳在 574,430 设不下去,报告里如实写)。 +""" +import json, os, subprocess, sys, time + +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-tc.txt") +HERE = os.path.dirname(os.path.abspath(__file__)) +TL = open(os.path.join(HERE, "logs", "safari-vo-timeline.jsonl"), "a", encoding="utf8") +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +TARGET = os.environ.get("NEX_HEADING", "分镜任务清单") +URL = BASE + "/projects/10/dispatch" +CODE = {"a":0,"b":11,"c":8,"d":2,"e":14,"f":3,"g":6,"h":4,"i":34,"j":38,"k":40,"l":37,"m":46, + "n":45,"o":31,"p":35,"q":12,"r":15,"s":1,"t":17,"u":32,"v":9,"w":13,"x":7,"y":16,"z":6, + "0":29,"1":18,"2":19,"3":20,"4":21,"5":23,"6":22,"7":26,"8":28,"9":25, + "/":69,":":41,".":47,"-":27} +VO = ["control", "option"] +_off = {"n": 0, "off": 0} + +def sh(scpt): + return subprocess.run(["osascript", "-e", scpt], capture_output=True, text=True) + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": time.time(), "ev": ev} + rec.update(kw); TL.write(json.dumps(rec, ensure_ascii=False) + "\n"); TL.flush() + print(json.dumps(rec, ensure_ascii=False)[:230], flush=True) + +def cnt(): + try: + with open(RAW, errors="replace") as f: + f.seek(_off["off"]); chunk = f.read(); _off["off"] = f.tell() + _off["n"] += chunk.count("_ssml: ") + except Exception: + return -1 + return _off["n"] + +def keys(code, mods=(), label=""): + t0 = time.time(); before = cnt() + use = " using {" + ", ".join(f"{m} down" for m in mods) + "}" if mods else "" + sh(f'tell application "System Events" to key code {code}{use}') + heard = None; last = t0 + while time.time() - t0 < 26: + c = cnt() + if c > before: + if heard is None: heard = time.time() + last = time.time(); before = c + elif heard is not None and time.time() - last > 2.2: + break + time.sleep(0.35) + mark("vokey", action=label, first_s=round(heard - t0, 1) if heard else None, + read_s=round(time.time() - t0, 1), new_lines=(cnt() - before)) + return heard + +def vo(code, label, extra=()): + return keys(code, VO + list(extra), label) + +def type_str(s): + """整串走剪贴板粘贴。实测这台机器的输入源是搜狗拼音:逐字符 key code 打「http://…」 + 会打成 `http;加号加号127.0.0.1;5199…`(`.` 变 `;`、`/` 变「加号」),登录名同理会被拼成拼音。 + 粘贴不经输入法,是唯一不碰系统输入法设置的写法(改输入法属于动用户环境,不做)。""" + subprocess.run(["pbcopy"], input=s.encode("utf8")) + time.sleep(0.3) + keys(9, ["command"], label="⌘V 粘贴") # 9 = v + +def main(): + mark("start", url=URL, heading=TARGET) + sh('tell application "Safari" to activate'); time.sleep(1.0) + sh('tell application "System Events" to tell process "Safari" to set size of window 1 to {574, 900}') + sh('tell application "System Events" to tell process "Safari" to set position of window 1 to {40, 40}') + time.sleep(0.8) + sz = sh('tell application "System Events" to tell process "Safari" to get size of window 1').stdout.strip() + fm = sh('tell application "System Events" to get name of first process whose frontmost is true').stdout.strip() + mark("window", size=sz, frontmost=fm, note="Safari 窗口宽度被 macOS 钳在 574") + # 地址栏 → 目标路由 + keys(37, ["command"]); time.sleep(1.0); type_str(URL); time.sleep(0.4); keys(36) + time.sleep(6.0) + mark("nav", url=URL) + # 未登录时表单会 autofocus 用户名:直接敲凭据 + type_str("admin"); keys(48); type_str("admin1234"); keys(36) + time.sleep(7.0) + mark("login-tried") + # QuickNav:VO+H 逐块标题跳,直到落到目标卡片的标题 + hit = None + for i in range(14): + h = vo(4, f"VO+H 第{i+1}次(跳到下一个标题)") + time.sleep(0.6) + seg = _since(h) + if TARGET in " ".join(seg): + hit = i + 1; break + mark("heading-search", tries=hit, target=TARGET, seen=_since(None)[-6:]) + # 进表格:VO+→ 若干下,观察有没有「第N列(共M列)」与表头文字 + for i in range(10): + vo(124, f"VO+→ 第{i+1}次") + for i in range(2): + vo(125, f"VO+↓ 第{i+1}次(换行)") + for i in range(2): + vo(123, f"VO+← 第{i+1}次(回退)") + mark("done") + +def _since(t): + out = [] + with open(RAW, errors="replace") as f: + try: + f.seek(max(0, f.seek(0, 2) - 4_000_000)) # 只回看尾部 4MB:debug 级一分十几 MB,全量读太慢 + f.readline() + except Exception: + f.seek(0) + for line in f: + if "_ssml: " not in line: continue + ts = line[:19] + try: + ep = time.mktime(time.strptime(ts, "%Y-%m-%d %H:%M:%S")) + except Exception: + continue + if t is None or ep >= t: + out.append(line.split("_ssml: ", 1)[1].replace('\\"', '"')[:200]) + return out[-12:] if t is None else out[-8:] + +main() diff --git a/reports/ui_evidence/nex-p9/vo/safari_vo2.py b/reports/ui_evidence/nex-p9/vo/safari_vo2.py new file mode 100644 index 0000000..d375295 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/safari_vo2.py @@ -0,0 +1,121 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""真机读屏 · VoiceOver + Safari 腿(第 2 版)。 + +第 1 版(safari_vo.py)失败原因已定性:登录时多按的那几下 Return/Tab 把旁白光标带进了 +**Safari 的菜单栏**(日志里连着读到「菜单栏 / 命令帮助菜单 / 旁白帮助菜单」), +菜单里 `VO+→` 不是导航键 ⇒ 后半程按键全部不出声。这一版针对四点改: + +1. 开场先按两下 `Esc`:菜单开着的时候什么键都白按。 +2. 不再重新打登录:第 1 版已经在 Safari 自己的 localStorage 里存好会话了, + 直接 ⌘L 粘 URL 进目标页,少两次回车就少一次把光标丢进浏览器 UI 的机会。 +3. 进网页内容靠**普通 Tab**(不是 VO 组合键):Safari 的焦点跟随把旁白光标交进文档正文, + 这一步第 1 版从来没做过,是「读不到网页」的真正出口。 +4. 走位顺序换了:先 `VO+↓` 线性走读(一定出声,能立刻看出光标在不在文档里), + 再 `VO+→/↓/←` 试表格导览,最后才试 `VO+H` 标题快导——快导失败不再拖累前面两段。 + +窗口宽度仍被 macOS 钳在 574(430 设不下去),报告如实写。全程只用键盘: +Safari 容器偏好被 TCC 锁死,AppleScript-JS 注入不进来。 +""" +import json, os, subprocess, time + +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-tc.txt") +HERE = os.path.dirname(os.path.abspath(__file__)) +LOGDIR = os.path.join(HERE, "logs") +TL = open(os.path.join(LOGDIR, "safari2-timeline.jsonl"), "a", encoding="utf8") +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +URL = BASE + "/projects/10/dispatch" +IDLE = float(os.environ.get("NEX_IDLE", "2.2")) +CAP = float(os.environ.get("NEX_CAP", "13")) +VO = ["control", "option"] +_off = {"n": 0, "off": os.path.getsize(RAW)} # 从文件末尾起算:只数本轮新增的播报 + + +def sh(scpt): + return subprocess.run(["osascript", "-e", scpt], capture_output=True, text=True) + + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": time.time(), "ev": ev} + rec.update(kw) + TL.write(json.dumps(rec, ensure_ascii=False) + "\n"); TL.flush() + print(json.dumps(rec, ensure_ascii=False)[:260], flush=True) + + +def cnt(): + try: + with open(RAW, errors="replace") as f: + f.seek(_off["off"]); chunk = f.read(); _off["off"] = f.tell() + _off["n"] += chunk.count("_ssml: ") + except Exception: + return -1 + return _off["n"] + + +def keys(code, mods=(), label="", shot=None): + t0 = time.time(); before = cnt() + use = " using {" + ", ".join(f"{m} down" for m in mods) + "}" if mods else "" + sh(f'tell application "System Events" to key code {code}{use}') + heard = None; last = t0 + while time.time() - t0 < CAP: + c = cnt() + if c > before: + if heard is None: heard = time.time() + last = time.time(); before = c + elif heard is not None and time.time() - last > IDLE: + break + time.sleep(0.3) + mark("key", action=label, first_s=round(heard - t0, 1) if heard else None, + wait_s=round(time.time() - t0, 1), spoken=(cnt() - before)) + if shot: + subprocess.run(["screencapture", "-x", os.path.join(LOGDIR, shot)]) + return t0 + + +def vo(code, label, shot=None): + return keys(code, VO, label, shot) + + +def paste(s, label=""): + subprocess.run(["pbcopy"], input=s.encode("utf8")) + time.sleep(0.3) + keys(9, ["command"], label=label or "⌘V 粘贴") + + +def main(): + mark("start", url=URL, note="第 2 版:Esc 退菜单 + Tab 进文档 + 先线性走读") + sh('tell application "Safari" to activate'); time.sleep(1.2) + sh('tell application "System Events" to tell process "Safari" to set size of window 1 to {574, 900}') + sh('tell application "System Events" to tell process "Safari" to set position of window 1 to {40, 40}') + time.sleep(0.8) + mark("window", + size=sh('tell application "System Events" to tell process "Safari" to get size of window 1').stdout.strip(), + frontmost=sh('tell application "System Events" to get name of first process whose frontmost is true').stdout.strip()) + keys(53, label="Esc(关菜单)") + keys(53, label="Esc(再确认一次)") + keys(37, ["command"], label="⌘L 地址栏"); time.sleep(1.0) + paste(URL, "⌘V 粘贴 URL"); time.sleep(0.4) + keys(36, label="Return 打开地址") + time.sleep(9.0) + mark("nav", url=URL) + keys(53, label="Esc(关弹窗)") + keys(48, label="Tab 第1下(进网页焦点)") + keys(48, label="Tab 第2下") + keys(53, label="Esc(把焦点交回旁白)") + mark("in-page") + for i in range(18): + vo(125, f"VO+↓ 第{i+1}次(线性走读)", shot="safari2-walk-01.png" if i == 3 else None) + mark("walk-done") + for i in range(6): + vo(124, f"VO+→ 第{i+1}次") + for i in range(3): + vo(125, f"VO+↓ 第{i+1}次(换行)") + for i in range(3): + vo(123, f"VO+← 第{i+1}次(回退)") + mark("nav-done") + for i in range(6): + vo(4, f"VO+H 第{i+1}次(下一个标题)") + mark("done") + + +main() diff --git a/reports/ui_evidence/nex-p9/vo/safari_vo3.py b/reports/ui_evidence/nex-p9/vo/safari_vo3.py new file mode 100644 index 0000000..b57ed3a --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/safari_vo3.py @@ -0,0 +1,76 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""Safari + VoiceOver 第 3 版:按旁白自己的提示走。 + +v2 的实测结论(写进日志,不是猜的): +- 19:31:57 旁白原话:`你当前在网页内容上。若要进入网页区域,请按下 Control-Option-Shift-下箭头。` + ⇒ 进网页区域要的是 **VO+Shift+↓**,光 `VO+↓` 停在文档容器上不动(v2 后半程 4 下全哑)。 +- 19:32:11 / 19:32:14 / 19:32:21:三次**普通 Tab** 之后旁白依次念出 + `打开导航菜单 , 已收起 按钮 横幅` / `跨界斗地主 · 大漠客栈二番局 83 百分之` / + `《跨界斗地主 …》流程进度 83 百分之 · 已完成 10 斜线 12 个节点 · 当前节点:时间线合成 …(点击展开项目概况) 你当前在按钮上` + ⇒ **旁白跟随键盘焦点**(Safari 开 Full Keyboard Access 与否都吃这一条), + 这条通道正是 S-2「可访问名称」要验的东西,比表格导览更值钱。 + +所以这一版两段都跑:A 段用 VO+Shift+↓ 进区域后走 8 下线性朗读;B 段用 16 下普通 Tab 采集 +每一站的可访问名称(含表格行里的操作按钮)。每键最长等 7s,哑了就继续,不浪费时间。 +""" +import json, os, subprocess, time + +RAW = "/tmp/vo-p9-tc.txt" +HERE = os.path.dirname(os.path.abspath(__file__)) +LOGDIR = os.path.join(HERE, "logs") +TL = open(os.path.join(LOGDIR, "safari3-timeline.jsonl"), "a", encoding="utf8") +CAP = 7.0 +IDLE = 1.8 +_off = {"n": 0, "off": os.path.getsize(RAW)} + + +def sh(s): + return subprocess.run(["osascript", "-e", s], capture_output=True, text=True) + + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": time.time(), "ev": ev} + rec.update(kw) + TL.write(json.dumps(rec, ensure_ascii=False) + "\n"); TL.flush() + print(json.dumps(rec, ensure_ascii=False)[:200], flush=True) + + +def cnt(): + with open(RAW, errors="replace") as f: + f.seek(_off["off"]); chunk = f.read(); _off["off"] = f.tell() + _off["n"] += chunk.count("_ssml: ") + return _off["n"] + + +def keys(code, mods, label): + t0 = time.time(); before = cnt(); heard = None; last = t0; n = 0 + use = " using {" + ", ".join(f"{m} down" for m in mods) + "}" if mods else "" + sh(f'tell application "System Events" to key code {code}{use}') + while time.time() - t0 < CAP: + c = cnt(); n = c - before + if n > 0: + if heard is None: heard = time.time() + last = time.time() + elif heard is not None and time.time() - last > IDLE: + break + time.sleep(0.3) + mark("key", action=label, spoken=n, first_s=round(heard - t0, 1) if heard else None) + return n + + +VO = ["control", "option"] +mark("start", note="v3:A 段 VO+Shift+↓ 进区域 + 8 下线性;B 段 16 下 Tab 采集 AX 名称") +sh('tell application "Safari" to activate'); time.sleep(1.2) +mark("frontmost", app=sh('tell application "System Events" to get name of first process whose frontmost is true').stdout.strip()) +keys(125, VO + ["shift"], "VO+Shift+↓(进入网页区域)") +for i in range(8): + keys(125, VO, f"A-VO+↓ 第{i+1}次") +mark("A-done") +for i in range(16): + keys(48, [], f"B-Tab 第{i+1}下") + if i == 7: + subprocess.run(["screencapture", "-x", os.path.join(LOGDIR, "safari3-mid.png")]) +mark("B-done") +subprocess.run(["screencapture", "-x", os.path.join(LOGDIR, "safari3-end.png")]) +mark("done") diff --git a/reports/ui_evidence/nex-p9/vo/spinprobe.py b/reports/ui_evidence/nex-p9/vo/spinprobe.py new file mode 100644 index 0000000..15f6c32 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/spinprobe.py @@ -0,0 +1,23 @@ +# 一次性证据探针:Dispatch 三颗 NumberInput 在 DOM 上的 ARIA 数值声明 +import os +from playwright.sync_api import sync_playwright +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +JS = r"""() => [...document.querySelectorAll('input[aria-label]')].filter(i=>/优先级|上限|等待秒数/.test(i.getAttribute('aria-label'))) + .map(i=>({label:i.getAttribute('aria-label'), value:i.value, outer:i.outerHTML.slice(0,420)}))""" +with sync_playwright() as p: + b=p.chromium.launch(); pg=b.new_context(viewport={"width":1440,"height":900}).new_page() + pg.goto(BASE+"/", wait_until="domcontentloaded"); pg.wait_for_timeout(1200) + if pg.locator("#login-user").count(): + pg.fill("#login-user","admin"); pg.fill("#login-pass","admin1234"); pg.keyboard.press("Enter"); pg.wait_for_timeout(2500) + pg.goto(BASE+"/projects/10/dispatch", wait_until="domcontentloaded"); pg.wait_for_timeout(4000) + for x in pg.evaluate(JS): + print("==",x["label"],"value=",x["value"]); print(" ",x["outer"]) + # 再问一次 CDP 计算后的 AX 值 + cdp=pg.context.new_cdp_session(pg); cdp.send("Accessibility.enable") + tree=cdp.send("Accessibility.getFullAXTree")["nodes"] + for n in tree: + nm=(n.get("name") or {}).get("value","") + if any(k in nm for k in ("优先级","上限","等待秒数")): + props={ (pr["name"]): (pr.get("value") or {}).get("value") for pr in n.get("properties",[])} + print("AX>",n.get("role",{}).get("value"),"|",nm,"|",props) + b.close() diff --git a/reports/ui_evidence/nex-p9/vo/tablecursor.py b/reports/ui_evidence/nex-p9/vo/tablecursor.py new file mode 100644 index 0000000..4847aa0 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/tablecursor.py @@ -0,0 +1,160 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""真机读屏 · 表格光标实测(阶段 9 · T-1 第 2 问:表头/行列定位)。 + +先用一次程序化 focus 把 VoiceOver 光标送进目标表格的某个单元格 +(日志会出现「你当前在table内部的cell上」),随后完全用 VoiceOver 自己的 +表格导航键 ⌘⌃→ / ⌘⌃↓ / ⌘⌃← 走格,检验: + ① 有没有播报「第几列 · 表头文字」;② 空表头列怎么念;③ 换行是否重新定位。 +时间线写 logs/tablecursor-timeline.jsonl(rc 用字符串描述动作,便于对齐)。 +""" +import json, os, subprocess, sys, time +from playwright.sync_api import sync_playwright + +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +HERE = os.path.dirname(os.path.abspath(__file__)) +LOG = os.path.join(HERE, "logs") +WIDTH = int(os.environ.get("NEX_WIDTH", "430")) +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-raw.txt") +TL = open(os.path.join(LOG, "tablecursor-timeline.jsonl"), "a", encoding="utf8") +# 实测:这台机器的旁白在表格里提示「请按下 Control-Option,然后再按下上/下/左/右箭头键」, +# 即表格导览键是 VO+方向键(⌃⌥←↓↑→),不是早期手册上的 ⌘⌃方向键。首次按下只播表格模式提示。 +VO = ["control", "option"] +RIGHT = (124, VO); LEFT = (123, VO); DOWN = (125, VO); UP = (126, VO) +ENTER = (36, []); SPACE = (49, ["control", "option"]) + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": time.time(), "ev": ev} + rec.update(kw); TL.write(json.dumps(rec, ensure_ascii=False) + "\n"); TL.flush() + print(json.dumps(rec, ensure_ascii=False), flush=True) + +def vo_alive(): + return subprocess.run(["pgrep", "-x", "VoiceOver"], capture_output=True).returncode == 0 + +def chrome_pid(): + """Playwright 起的 Chrome 主进程:命令行里有 --user-data-dir 且不是 --type= 子进程。 + 用户自己还开着一个 Chrome(同 bundle),osascript 按 App 名激活会叫错窗口,必须按 unix id 激活。""" + r = subprocess.run(["ps", "-Ao", "pid,args"], capture_output=True, text=True) + for line in r.stdout.splitlines(): + if "--user-data-dir=" in line and "--type=" not in line and "Google Chrome" in line: + pid = int(line.split(None, 1)[0]) + if "/playwright" in line or "playwright" in line: + return pid + return None + +def raise_chrome(page): + """把 Playwright 那个 Chrome 实例送到前台:标签置前 + 按 unix id 置前,并读回它自己的窗口标题自证。""" + try: page.bring_to_front() + except Exception: pass + pid = chrome_pid() + win = "" + if pid: + subprocess.run(["osascript", "-e", + 'tell application "System Events" to set frontmost of (first process whose unix id is %d) to true' % pid], + capture_output=True, text=True) + time.sleep(1.0) + r = subprocess.run(["osascript", "-e", + 'tell application "System Events" to tell (first process whose unix id is %d) to get name of window 1' % pid], + capture_output=True, text=True) + win = (r.stdout or "").strip() + " [pid=%d]" % pid + else: + subprocess.run(["osascript", "-e", 'tell application "Google Chrome" to activate']) + time.sleep(1.0); win = "(未找到 playwright Chrome,退化为按 App 名激活)" + return win + +def keys(combo): + code, mods = combo + use = " using {" + ", ".join(f"{m} down" for m in mods) + "}" if mods else "" + subprocess.run(["osascript", "-e", f'tell application "System Events" to key code {code}{use}'], + capture_output=True, text=True) + +_SSML = {"off": 0, "n": 0} + +def ssml_count(): + """增量读日志:原始流是 debug 级,十几分钟就上百 MB,每次从头读会把轮询拖垮。""" + try: + with open(RAW, errors="replace") as f: + f.seek(_SSML["off"]) + chunk = f.read() + _SSML["off"] = f.tell() + _SSML["n"] += chunk.count("_ssml: ") + except Exception: + return -1 + return _SSML["n"] + +def wait_quiet(t0, hard=40, idle=3.0): + base = ssml_count(); heard = None; last = t0 + while time.time() - t0 < hard: + c = ssml_count() + if c > base: + if heard is None: heard = time.time() + last = time.time(); base = c + elif heard is not None and time.time() - last > idle: + return heard, time.time(), False + time.sleep(0.4) + return heard, time.time(), True + +FOCUS_JS = """(arg) => { + const {ti, ri, ci} = arg; + const w = [...document.querySelectorAll('.ant-table-wrapper')][ti]; + if (!w) return {err:'no-wrapper'}; + const tr = [...w.querySelectorAll('.ant-table-tbody tr')] + .filter(x => !x.className.includes('measure') && !x.className.includes('placeholder'))[ri]; + const td = tr && [...tr.children].filter(x => x.tagName==='TD')[ci]; + if (!td) return {err:'no-cell'}; + td.scrollIntoView({block:'center'}); + const card = (w.closest('.ant-card')?.querySelector('.ant-card-head-title')?.textContent||'').trim(); + const ths = [...w.querySelectorAll('thead th')].map(e => (e.textContent||'').replace(/\\s+/g,' ').trim()); + td.tabIndex = -1; td.focus({preventScroll:true}); + return {ok:true, card, ths, cell:(td.textContent||'').replace(/\\s+/g,' ').trim().slice(0,90)}; +}""" +UNFOCUS = "() => { const a=document.activeElement; if(a && a.hasAttribute('tabindex') && a.tagName==='TD'){a.removeAttribute('tabindex'); a.blur();} }" + +def main(): + plan = json.load(open(sys.argv[1], encoding="utf8")) + with sync_playwright() as p: + br = p.chromium.launch(channel="chrome", headless=False, + args=["--no-first-run", "--no-default-browser-check"]) + page = br.new_context(viewport={"width": WIDTH, "height": 900}).new_page() + page.goto(BASE + "/", wait_until="domcontentloaded"); page.wait_for_timeout(1500) + if page.locator("#login-user").count(): + page.fill("#login-user", "admin"); page.fill("#login-pass", "admin1234") + page.keyboard.press("Enter"); page.wait_for_timeout(2500) + win = raise_chrome(page) + mark("logged-in", window=win, vo=vo_alive()) + if not vo_alive(): + mark("abort", err="VoiceOver 未运行"); br.close(); return + cur = None + for step in plan: + if step["route"] != cur: + page.goto(BASE + step["route"], wait_until="domcontentloaded") + page.wait_for_timeout(4000); cur = step["route"] + mark("route", route=step["route"]) + keys((125, ["control", "option", "shift"])); time.sleep(2.5) + for (ti, note) in step["tables"]: + win = raise_chrome(page) + if not vo_alive(): + mark("abort", err="VoiceOver 掉线", route=step["route"], ti=ti); br.close(); return + info = page.evaluate(FOCUS_JS, {"ti": ti, "ri": 0, "ci": 0}) + if info.get("err"): + mark("skip", ti=ti, err=info["err"]); continue + mark("enter-table", route=step["route"], ti=ti, note=note, + card=info["card"], ths=info["ths"], cell=info["cell"], action="focus R0C0") + wait_quiet(time.time(), 40) + page.evaluate(UNFOCUS) + time.sleep(1.0) + for act, combo in (("VO+→ 第1次(实测为表格模式提示)", RIGHT), + ("VO+→ 第2次 → R0C1", RIGHT), + ("VO+↓ → R1C1", DOWN), + ("VO+← → R1C0", LEFT)): + t0 = time.time() + keys(combo) + h, q, trunc = wait_quiet(t0, 30) + mark("vokey", route=step["route"], ti=ti, note=note, action=act, window=win, + first_s=round(h - t0, 1) if h else None, + read_s=round(q - t0, 1), truncated=trunc) + page.evaluate(UNFOCUS) + mark("done") + br.close() + +main() diff --git a/reports/ui_evidence/nex-p9/vo/walk.py b/reports/ui_evidence/nex-p9/vo/walk.py new file mode 100644 index 0000000..9620839 --- /dev/null +++ b/reports/ui_evidence/nex-p9/vo/walk.py @@ -0,0 +1,155 @@ +#!/usr/bin/env python3 +# -*- coding: utf8 -*- +"""真机读屏走查(阶段 9 · T-1):真实 Chrome + VoiceOver,按 readorder.json 的格子逐格播报。 + +只做「点一格 / 按 ⌘⌃→ 走一格 / 记录时间线」,不改任何页面代码。 +时间线写 logs/vo-walk-timeline.jsonl,播报由 /tmp/vo_extract.py 从系统日志抽取后按时间对齐。 +""" +import json, os, subprocess, sys, time +from playwright.sync_api import sync_playwright + +BASE = os.environ.get("NEX_BASE", "http://127.0.0.1:5199") +HERE = os.path.dirname(os.path.abspath(__file__)) +ROOT = os.path.abspath(os.path.join(HERE, "..", "..", "..")) +LOG = os.path.join(HERE, "logs") +os.makedirs(LOG, exist_ok=True) +WIDTH = int(os.environ.get("NEX_WIDTH", "430")) +DWELL = float(os.environ.get("NEX_DWELL", "12")) +RAW = os.environ.get("NEX_VO_RAW", "/tmp/vo-p9-raw.txt") +TL = open(os.path.join(LOG, "vo-walk-timeline.jsonl"), "a", encoding="utf8") + +def mark(ev, **kw): + rec = {"ts": time.strftime("%H:%M:%S"), "t": round(time.time(), 3), "ev": ev} + rec.update(kw) + TL.write(json.dumps(rec, ensure_ascii=False) + "\n"); TL.flush() + print(json.dumps(rec, ensure_ascii=False), flush=True) + +def keys(*combos): + """combos: (keycode, [modifiers]) → System Events key code""" + for code, mods in combos: + use = "" + if mods: + use = " using {" + ", ".join(f"{x} down" for x in mods) + "}" + script = f'tell application "System Events" to key code {code}{use}' + subprocess.run(["osascript", "-e", script], check=False, capture_output=True, text=True) + time.sleep(0.25) + +DOWN, LEFT, RIGHT, UP = 125, 123, 124, 126 +def vo_next_cell(n=1): keys(*([(RIGHT, ["command", "control"])] * n)) +def vo_prev_cell(n=1): keys(*([(LEFT, ["command", "control"])] * n)) +def vo_next_row(n=1): keys(*([(DOWN, ["command", "control"])] * n)) + +def log_lines(): + try: + return sum(1 for _ in open(RAW, errors="replace") if "_ssml" in _) + except Exception: + return -1 + +def wait_new_speech(prev, limit=5.0): + t0 = time.time() + while time.time() - t0 < limit: + c = log_lines() + if c > prev: + return True, c + time.sleep(0.4) + return False, log_lines() + +CLICK_JS = """(arg) => { + const {ti, ri, ci} = arg; + const w = [...document.querySelectorAll('.ant-table-wrapper')][ti]; + if (!w) return {err: 'no-wrapper'}; + const tr = [...w.querySelectorAll('.ant-table-tbody tr')] + .filter(x => !x.className.includes('measure') && !x.className.includes('placeholder'))[ri]; + if (!tr) return {err: 'no-row'}; + const td = [...tr.children].filter(x => x.tagName === 'TD')[ci]; + if (!td) return {err: 'no-cell'}; + td.scrollIntoView({block: 'center', inline: 'center'}); + const INTER = 'button,a[href],[role="button"],input,select,textarea'; + const cands = [td, ...td.querySelectorAll('*')].filter(e => { + if (e.closest(INTER)) return false; + if (!(e.textContent || '').trim()) return false; + const r = e.getBoundingClientRect(); + return r.width > 4 && r.height > 4; + }); + const leaf = cands.filter(e => ![...e.children].some(c => (c.textContent || '').trim())).pop() || cands.pop(); + if (!leaf) return {err: 'no-leaf'}; + const r = leaf.getBoundingClientRect(); + const tr2 = td.getBoundingClientRect(); + const x = Math.round(Math.min(Math.max(r.left + r.width / 2, tr2.left + 2), Math.min(tr2.right - 2, innerWidth - 2))); + const y = Math.round(Math.min(Math.max(r.top + r.height / 2, tr2.top + 2), Math.min(tr2.bottom - 2, innerHeight - 2))); + const vis = y > 60 && y < innerHeight - 8; + return {x, y, vis, inView: r.top >= 0 && r.bottom <= innerHeight, + text: (td.textContent || '').trim().slice(0, 200), + leaf: (leaf.textContent || '').trim().slice(0, 80), + tag: leaf.tagName + '.' + (leaf.className || '').toString().slice(0, 40)}; +}""" + +def page_state(page): + return page.evaluate("""() => ({ + url: location.pathname, + drawer: !!document.querySelector('.ant-drawer-open'), + modal: !!document.querySelector('.ant-modal-wrap'), + pop: !!document.querySelector('.ant-popover:not(.ant-popover-hidden), .ant-dropdown:not(.ant-dropdown-hidden)') + })""") + +def settle(page): + st = page_state(page) + if st["drawer"] or st["modal"] or st["pop"]: + keys((53, [])) # Esc + time.sleep(1.0) + mark("dismiss-overlay", **page_state(page)) + return page_state(page) + +def main(): + plan = json.load(open(sys.argv[1], encoding="utf8")) + with sync_playwright() as p: + br = p.chromium.launch( + channel="chrome", headless=False, + args=["--no-first-run", "--no-default-browser-check", + "--disable-features=Translate", "--autoplay-policy=no-user-gesture-required"]) + ctx = br.new_context(viewport={"width": WIDTH, "height": 900}) + page = ctx.new_page() + page.goto(BASE + "/", wait_until="domcontentloaded") + page.wait_for_timeout(1500) + if page.locator("#login-user").count(): + page.fill("#login-user", "admin"); page.fill("#login-pass", "admin1234") + page.keyboard.press("Enter"); page.wait_for_timeout(2500) + mark("logged-in", url=page.url) + cur = None + for step in plan: + if step["route"] != cur: + page.goto(BASE + step["route"], wait_until="domcontentloaded") + page.wait_for_timeout(4000) + cur = step["route"] + mark("route-ready", route=step["route"], + tables=page.evaluate("() => document.querySelectorAll('.ant-table-wrapper').length")) + for cell in step["cells"]: + ti, ri, ci = step["ti"], cell[0], cell[1] + info = page.evaluate(CLICK_JS, {"ti": ti, "ri": ri, "ci": ci}) + if info.get("err"): + mark("click-skip", route=step["route"], ti=ti, rc=(ri, ci), err=info["err"]); continue + prev = log_lines() + mark("click", route=step["route"], ti=ti, rc=[ri, ci], note=cell[2], + leaf=info["leaf"], tag=info["tag"], expect=info["text"]) + page.wait_for_timeout(700) + page.mouse.click(info["x"], info["y"]) + ok, now = wait_new_speech(prev) + mark("speech-after-click", heard=ok) + if not ok: + keys((RIGHT, ["control", "option"])) # 兜底:下一个项目 + ok, now = wait_new_speech(prev, 4) + mark("speech-after-vo-next", heard=ok) + st = settle(page) + mark("settle", **st) + # 同行向右逐格 + for _ in range(int(os.environ.get("NEX_STEP_RIGHT", "0"))): + prev = log_lines() + vo_next_cell(1) + mark("vo-next-cell", wait=DWELL) + time.sleep(DWELL) + mark("speech", heard=wait_new_speech(prev, 2)[0]) + time.sleep(max(0.0, DWELL - 3)) + mark("walk-done") + br.close() + +main() diff --git a/reports/验收报告-深夜面馆 · 最后一盏灯-2026-10-26.md b/reports/验收报告-深夜面馆 · 最后一盏灯-2026-10-26.md index cc92887..79f5e7c 100644 --- a/reports/验收报告-深夜面馆 · 最后一盏灯-2026-10-26.md +++ b/reports/验收报告-深夜面馆 · 最后一盏灯-2026-10-26.md @@ -82,7 +82,7 @@ | 2.5.shot3 | 平台 AI 关键帧 | 可复用/已就绪 | 镜头 3 已有关键帧 v1 · `重跑跳过` | ✅ 通过 | | 2.5.shot4 | 平台 AI 关键帧 | 可复用/已就绪 | 镜头 4 已有关键帧 v1 · `重跑跳过` | ✅ 通过 | | 2.5.version | 关键帧同槽位版本递增并立即成为 i2v 首帧 | 重复生成不新增槽位,version 递增、历史可回溯,镜头首帧指向最新版本文件 | 镜头 1 关键帧 v2(历史 2 版),i2v 首帧 4/keyframe/shot-10-keyframe-ai_62294050.png · `asset #50 · 4/keyframe/shot-10-keyframe-ai_62294050.png` | ✅ 通过 | -| 2.6.export | 分镜反向导出 md/csv/json 且 md 可回灌 | 导出 md 再次预览仍解析出 4 镜;csv/json 可下载 | md 987 字 → 回灌 parsed=4;csv 989 字;json 1736 字 · `GET /shots/export?fmt=md|csv|json` | ✅ 通过 | +| 2.6.export | 分镜反向导出 md/csv/json 且 md 可回灌 | 导出 md 再次预览仍解析出 4 镜;csv/json 可下载 | md 987 字 → 回灌 parsed=4;csv 989 字;json 1736 字 · `GET /shots/export?fmt=md\|csv\|json` | ✅ 通过 | | 2.7.bulk | 批量复制 / 统一改参 / 删除并续排镜号 | duplicate+patch+delete 一次事务生效,删除后镜号连续 | 复制出 [22] → 改为 close_up/pan_right(实测 close_up/pan_right)→ 删除后剩 4 镜,镜号 [1, 2, 3, 4] · `POST /shots/bulk` | ✅ 通过 | | 2.8.agent | 项目 LLM 总控台生成结构化计划(plan-only) | 真实大模型 qwen3.7-plus 产出计划,动作全部落在 8 个白名单动作内、按依赖排序、不自动代审,计划态不占队列 | run#22 status=succeeded provider/model=qwen/qwen3.7-plus intent=complete auto_approve=False 动作 []([])usage={"provider": "http_llm", "model": "qwen3.7-plus", "usage": {"completion_tokens": 1012, "prompt_tokens": 3869, "completio|已交付项目判定完成=True · `POST /projects/4/agent/plan → run #22` | ✅ 通过 | | 2.8.agent.blockers | LLM 总控台识别阻塞与规格冲突并给出人工处置建议 | 计划态必须说清「为什么现在不能往下走」:阻塞项(blockers)与规格冲突/降级提示(warnings)逐条可复核,且不得把不可执行的动作硬塞进队列 | run#22 blockers=[];warnings=[];回复摘要「项目《深夜面馆 · 最后一盏灯》已全部完成并成功导出成片。当前已有 720p 和 1080p 等多个版本的交付物,无需进一步操作。如需修改主题或调整分镜,请随时告知。」|项目已交付=True,判定完成=True · `GET /projects/4/agent/runs/22` | ✅ 通过 | @@ -151,7 +151,7 @@ | 7.2.transition | 非法转场枚举被拒且报错可自助(含可选值清单) | 非法 transition_out 返回 400,报错列出全部合法转场,时间线不被污染 | transition_out=fade -> 400:不支持的转场:fade,可选 cut, dissolve, fade_in, fade_out, fade_through_black, wipe · `PATCH /timeline/segments/{id} 负例` | ✅ 通过 | | 7.3.reorder | 轨道拖拽重排(并自动重算起点/字幕) | 重排后起点与字幕时间跟随,可再排回原顺序 | 原序 [10, 11, 12, 13] → 交换后 [11, 10, 12, 13] → 排回 [10, 11, 12, 13] · `POST /timeline/reorder` | ✅ 通过 | | 7.4.subtitle | 字幕逐句编辑(说话人 / 起止时间) | 按 cue_id 精确修改那条字幕:时间点后移 300ms、写入说话人、不产生重复行、文案回写镜头 | cue#70 10017→10317ms 结束 11352→11652ms 说话人「陈澈」文本「……还是这个味道。」;该镜字幕 1 条 / 全片 4 条 · `POST /timeline/subtitles cue_id 精确编辑` | ✅ 通过 | -| 7.5.subtitle_file | 字幕文件导出 srt / ass | SRT 含 4 句台词与时间轴,ASS 可单独用于烧录 | srt 191 字,命中台词 4/4,首条时间轴 00:00:00,250 --> 00:00:02,282;ass 864 字 · `GET /timeline/subtitles?fmt=srt|ass` | ✅ 通过 | +| 7.5.subtitle_file | 字幕文件导出 srt / ass | SRT 含 4 句台词与时间轴,ASS 可单独用于烧录 | srt 191 字,命中台词 4/4,首条时间轴 00:00:00,250 --> 00:00:02,282;ass 864 字 · `GET /timeline/subtitles?fmt=srt\|ass` | ✅ 通过 | | 7.6.bgm | 追加 BGM/环境音轨并登记为项目资产 | 上传 40s 立体声雨声环境床 → 循环铺满时间线、-20dB、开启 ducking | clip#93 kind=bgm loop=True gain=-20.0dB ducking=True 0→20101ms;资产库 bgm 2 条 · `POST /timeline/audio` | ✅ 通过 | | 7.7.report | 时间线就绪校验(合成前置检查) | ready=true,无 error 级问题(环境缺滤镜时的提示应为 warning) | ready=True issues=[] · `GET /timeline/report` | ✅ 通过 | diff --git a/reports/验收报告-跨界斗地主 · 客栈牌局-2026-10-26.md b/reports/验收报告-跨界斗地主 · 客栈牌局-2026-10-26.md index 33b4a57..aa4615f 100644 --- a/reports/验收报告-跨界斗地主 · 客栈牌局-2026-10-26.md +++ b/reports/验收报告-跨界斗地主 · 客栈牌局-2026-10-26.md @@ -90,7 +90,7 @@ | 2.5.shot3 | 平台 AI 关键帧 | 可复用/已就绪 | 镜头 3 已有关键帧 v1 · `重跑跳过` | ✅ 通过 | | 2.5.shot4 | 平台 AI 关键帧 | 可复用/已就绪 | 镜头 4 已有关键帧 v1 · `重跑跳过` | ✅ 通过 | | 2.5.version | 关键帧同槽位版本递增并立即成为 i2v 首帧 | 重复生成不新增槽位,version 递增、历史可回溯,镜头首帧指向最新版本文件 | 镜头 1 关键帧 v2(历史 2 版),i2v 首帧 6/keyframe/shot-18-keyframe-ai_cf899774.png · `asset #110 · 6/keyframe/shot-18-keyframe-ai_cf899774.png` | ✅ 通过 | -| 2.6.export | 分镜反向导出 md/csv/json 且 md 可回灌 | 导出 md 再次预览仍解析出 4 镜;csv/json 可下载 | md 1463 字 → 回灌 parsed=4;csv 1465 字;json 2216 字 · `GET /shots/export?fmt=md|csv|json` | ✅ 通过 | +| 2.6.export | 分镜反向导出 md/csv/json 且 md 可回灌 | 导出 md 再次预览仍解析出 4 镜;csv/json 可下载 | md 1463 字 → 回灌 parsed=4;csv 1465 字;json 2216 字 · `GET /shots/export?fmt=md\|csv\|json` | ✅ 通过 | | 2.7.bulk | 批量复制 / 统一改参 / 删除并续排镜号 | duplicate+patch+delete 一次事务生效,删除后镜号连续 | 复制出 [22] → 改为 close_up/pan_right(实测 close_up/pan_right)→ 删除后剩 4 镜,镜号 [1, 2, 3, 4] · `POST /shots/bulk` | ✅ 通过 | | 2.8.agent | 项目 LLM 总控台生成结构化计划(plan-only) | 真实大模型 qwen3.7-plus 产出计划,动作全部落在 8 个白名单动作内、按依赖排序、不自动代审,计划态不占队列 | run#23 status=succeeded provider/model=qwen/qwen3.7-plus intent=complete auto_approve=False 动作 []([])usage={"provider": "http_llm", "model": "qwen3.7-plus", "usage": {"completion_tokens": 1319, "prompt_tokens": 4257, "completio|已交付项目判定完成=True · `POST /projects/6/agent/plan → run #23` | ✅ 通过 | | 2.8.agent.blockers | LLM 总控台识别阻塞与规格冲突并给出人工处置建议 | 计划态必须说清「为什么现在不能往下走」:阻塞项(blockers)与规格冲突/降级提示(warnings)逐条可复核,且不得把不可执行的动作硬塞进队列 | run#23 blockers=[];warnings=["项目风格指南明确规定“无字幕无水印”,当前已导出的 1080p 成片未烧录字幕。若必须添加字幕,需先修改风格指南并重新执行生成流程。"];回复摘要「项目《跨界斗地主 · 客栈牌局》已全部完成并交付。4个镜头均已生成、质检合格并通过审核,时间线已就绪,且已成功导出 1080p 成片。根据项目风格指南中“无字幕无水印”的明确要求,当前成片未添加字幕。如需调整字幕或修改内容,请更新风格指南或发起新主题重写。」|项目已交付=True,判定完成=True · `GET /projects/6/agent/runs/23` | ✅ 通过 | @@ -159,7 +159,7 @@ | 7.2.transition | 非法转场枚举被拒且报错可自助(含可选值清单) | 非法 transition_out 返回 400,报错列出全部合法转场,时间线不被污染 | transition_out=fade -> 400:不支持的转场:fade,可选 cut, dissolve, fade_in, fade_out, fade_through_black, wipe · `PATCH /timeline/segments/{id} 负例` | ✅ 通过 | | 7.3.reorder | 轨道拖拽重排(并自动重算起点/字幕) | 重排后起点与字幕时间跟随,可再排回原顺序 | 原序 [18, 19, 20, 21] → 交换后 [19, 18, 20, 21] → 排回 [18, 19, 20, 21] · `POST /timeline/reorder` | ✅ 通过 | | 7.4.subtitle | 字幕逐句编辑(说话人 / 起止时间) | 按 cue_id 精确修改那条字幕:时间点后移 300ms、写入说话人、不产生重复行、文案回写镜头 | cue#74 10017→10317ms 结束 13488→13788ms 说话人「阿拉蕾」文本「哇哈哈,阿拉蕾当地主,牌最多嘛!」;该镜字幕 1 条 / 全片 4 条 · `POST /timeline/subtitles cue_id 精确编辑` | ✅ 通过 | -| 7.5.subtitle_file | 字幕文件导出 srt / ass | SRT 含 4 句台词与时间轴,ASS 可单独用于烧录 | srt 207 字,命中台词 4/4,首条时间轴 00:00:00,250 --> 00:00:03,861;ass 880 字 · `GET /timeline/subtitles?fmt=srt|ass` | ✅ 通过 | +| 7.5.subtitle_file | 字幕文件导出 srt / ass | SRT 含 4 句台词与时间轴,ASS 可单独用于烧录 | srt 207 字,命中台词 4/4,首条时间轴 00:00:00,250 --> 00:00:03,861;ass 880 字 · `GET /timeline/subtitles?fmt=srt\|ass` | ✅ 通过 | | 7.6.bgm | 追加 BGM/环境音轨并登记为项目资产 | 上传 40s 立体声客栈夜谈环境床 → 循环铺满时间线、-20dB、开启 ducking | clip#99 kind=bgm loop=True gain=-20.0dB ducking=True 0→20101ms;资产库 bgm 1 条 · `POST /timeline/audio` | ✅ 通过 | | 7.7.report | 时间线就绪校验(合成前置检查) | ready=true,无 error 级问题(环境缺滤镜时的提示应为 warning) | ready=True issues=[] · `GET /timeline/report` | ✅ 通过 |