docs: CBB Verify 全量扫描与阻塞分析(关联 #4) #5

Merged
abaishu0730 merged 1 commits from docs/scan-20261104-blockers into main 2026-11-06 10:20:24 +08:00
Owner

把 2026-11-04 的全量扫描报告归档到 docs/diagnostics/,与工单 #4 关联。

内容:扫描范围与方法、运行链路、F-01~F-27 功能缺陷(含代码位置)、K1/K2/K3 阻塞分级与任务可达性矩阵、现场失败映射、分支现状、测试评估、P0/P1/P2 修复路线。

仅文档变更,不改代码。报告中的复现项与判定均对应 main@39985f7 与 codex/temp-issue-2-icdb-recovery@29959e2。

Refs #4

把 2026-11-04 的全量扫描报告归档到 `docs/diagnostics/`,与工单 #4 关联。 内容:扫描范围与方法、运行链路、F-01~F-27 功能缺陷(含代码位置)、K1/K2/K3 阻塞分级与任务可达性矩阵、现场失败映射、分支现状、测试评估、P0/P1/P2 修复路线。 仅文档变更,不改代码。报告中的复现项与判定均对应 `main@39985f7` 与 `codex/temp-issue-2-icdb-recovery@29959e2`。 Refs #4
abaishu0730 added 1 commit 2026-11-04 15:20:56 +08:00
Author
Owner

合并就绪度:可以合并

相对 main:1 个文件 docs/diagnostics/2026-11-04-scan-and-blockers.md(+366/−0),draft=false、mergeable=true,无代码改动。

建议先于 #3 合并,把当前全量扫描/阻塞结论固化为基线。合并前请顺手确认两点:

  1. 文中引用的结论是否受 2026-11-05 的 #8(私有桌面释放)修复影响——若涉及"桌面/句柄泄漏"判断,请标注为修复前观测;
  2. 涉及 #3 内容的段落请标明对应分支/提交,避免文档先落地、实现未合入时被当成现状。

—— 只读审查,未做原生验证。

# 合并就绪度:可以合并 相对 main:1 个文件 `docs/diagnostics/2026-11-04-scan-and-blockers.md`(+366/−0),`draft=false`、`mergeable=true`,无代码改动。 建议**先于 #3 合并**,把当前全量扫描/阻塞结论固化为基线。合并前请顺手确认两点: 1. 文中引用的结论是否受 2026-11-05 的 #8(私有桌面释放)修复影响——若涉及"桌面/句柄泄漏"判断,请标注为修复前观测; 2. 涉及 #3 内容的段落请标明对应分支/提交,避免文档先落地、实现未合入时被当成现状。 —— 只读审查,未做原生验证。
Author
Owner

文档审查:全量扫描与阻塞分析(Approve,建议补"演进"标注)

范围:docs/diagnostics/2026-11-04-scan-and-blockers.md(+366),基于 main@39985f7、codex/temp-issue-2-icdb-recovery@29959e2。

结论

可以合并。 这份扫描质量很高:结论先行、证据给到 file:line、把"能证明单个 CBB 是否真的绿"和"不能稳定把一批刷绿"分开说,并且没有把离线测试当现场成功。

我抽了 4 条结论在当前 main 上复核,全部成立:

结论 复核方式 结果
F-03 内容检查文本误判 本机调用 classify_output(0, 'content checking completed successfully! 0 errors') 返回 FAIL,成立
F-04 .prj 只按 utf-8/replace 读 verify_runner.py:157;对照 backup_recovery._project_text 成立(UTF-16/ANSI 工程会在 preflight 被误判)
F-11 陈旧 sAddress.adr 永久阻断 icdb_ownership.py:13-16 + mentor_adapter.py:644-650 成立
F-13/F-14 超时/崩溃只写取消文件 desktop_worker.py start_supervisor_watchdog + verify_runner._stop_worker 成立(见下)

建议补两处(不阻塞合并)

[建议 1] 加一节"历史快照 + 后续演进"

文中的基准已过期:codex/temp-issue-2-icdb-recovery@29959e2("49 提交 / +13,173 行")不复存在,该分支现为 9970635,并已按审查拆成 #9–#12 四段审查链。

我在链路顶端(#12)实测到的状态:

  • F-03 部分修复:verify_runner.py 现用 diagnostic_text = re.sub(r'\b0\s+errors?\b', '', output) 再匹配错误词,0 errors 已能 PASS;但 ERROR_TEXT 仍是全文匹配,路径里带 "error"/"failed" 仍会判 FAIL(实测 '...successfully; C:/error/foo.log' → FAIL)。
  • F-04 已修复:verify_runner.py:178-179 改用 backup_recovery._project_text。
  • F-10 已修复并收窄:不再"任何 PCB 在跑就拒绝",只拒绝目标工程本身已打开(mentor_adapter.py:609-617)。
  • F-01 仍成立:执行前没有桥可用性预检,桥只在 PASS 之后查询。
  • F-11 仍成立:#9–#12 仍未提供"确认无会话后清除地址记录"的路径。
  • F-13 仍成立(但风险被人工兜底):_stop_worker 仍只 request_stop()(touch 取消文件);#12 新增的残留释放是人工确认路径,不是自动终止。
  • F-14 部分修复:mentor_adapter.py:1005 已给 verify worker 传 stop_clients=True(监督器崩溃会 os._exit(75));native_repair_ui.py:291 仍未传,靠 repair worker 自己的 _CancellationFile 轮询收敛。

把这些写成表格附在文末,读者就知道哪些结论还值得照着行动,哪些已经过时。

[建议 2] 统一测试口径

文中"main 463 passed / 8 failed"是未 pip install -e . 的环境差异;当前仓库 pyproject.toml 已配 pythonpath=["src"],干净环境直接 python -m pytest -q 是 480 passed。建议在表中注明"该行是本机未安装环境下的数字",避免后来者以为 main 真的带 8 个失败。

一点补充

文档里"共享中心库并发没有真正的互斥"我复核为成立:main 只有 Local\CbbRefreshVerify795 进程内互斥 + 本机进程探测;#9–#12 新增的 sidecar 库锁是合作式文件锁,Mentor 不参与。建议在文中把"合作式"的边界写得更直白(只约束本工具,不约束另一个工程师直接开 LM)。

—— 本次为只读审查,未执行原生操作。

# 文档审查:全量扫描与阻塞分析(Approve,建议补"演进"标注) 范围:`docs/diagnostics/2026-11-04-scan-and-blockers.md`(+366),基于 `main@39985f7`、`codex/temp-issue-2-icdb-recovery@29959e2`。 ## 结论 **可以合并。** 这份扫描质量很高:结论先行、证据给到 `file:line`、把"能证明单个 CBB 是否真的绿"和"不能稳定把一批刷绿"分开说,并且没有把离线测试当现场成功。 我抽了 4 条结论在当前 main 上复核,**全部成立**: | 结论 | 复核方式 | 结果 | | --- | --- | --- | | F-03 内容检查文本误判 | 本机调用 `classify_output(0, 'content checking completed successfully! 0 errors')` | 返回 `FAIL`,成立 | | F-04 `.prj` 只按 utf-8/replace 读 | `verify_runner.py:157`;对照 `backup_recovery._project_text` | 成立(UTF-16/ANSI 工程会在 preflight 被误判) | | F-11 陈旧 `sAddress.adr` 永久阻断 | `icdb_ownership.py:13-16` + `mentor_adapter.py:644-650` | 成立 | | F-13/F-14 超时/崩溃只写取消文件 | `desktop_worker.py` `start_supervisor_watchdog` + `verify_runner._stop_worker` | 成立(见下) | ## 建议补两处(不阻塞合并) ### [建议 1] 加一节"历史快照 + 后续演进" 文中的基准已过期:`codex/temp-issue-2-icdb-recovery@29959e2`("49 提交 / +13,173 行")不复存在,该分支现为 `9970635`,并已按审查拆成 **#9–#12** 四段审查链。 我在链路顶端(#12)实测到的状态: - **F-03 部分修复**:`verify_runner.py` 现用 `diagnostic_text = re.sub(r'\b0\s+errors?\b', '', output)` 再匹配错误词,`0 errors` 已能 PASS;但 `ERROR_TEXT` 仍是全文匹配,**路径里带 "error"/"failed" 仍会判 FAIL**(实测 `'...successfully; C:/error/foo.log'` → FAIL)。 - **F-04 已修复**:`verify_runner.py:178-179` 改用 `backup_recovery._project_text`。 - **F-10 已修复并收窄**:不再"任何 PCB 在跑就拒绝",只拒绝**目标工程本身**已打开(`mentor_adapter.py:609-617`)。 - **F-01 仍成立**:执行前没有桥可用性预检,桥只在 PASS 之后查询。 - **F-11 仍成立**:#9–#12 仍未提供"确认无会话后清除地址记录"的路径。 - **F-13 仍成立(但风险被人工兜底)**:`_stop_worker` 仍只 `request_stop()`(touch 取消文件);#12 新增的残留释放是**人工确认**路径,不是自动终止。 - **F-14 部分修复**:`mentor_adapter.py:1005` 已给 verify worker 传 `stop_clients=True`(监督器崩溃会 `os._exit(75)`);`native_repair_ui.py:291` 仍未传,靠 repair worker 自己的 `_CancellationFile` 轮询收敛。 把这些写成表格附在文末,读者就知道哪些结论还值得照着行动,哪些已经过时。 ### [建议 2] 统一测试口径 文中"main 463 passed / 8 failed"是**未 `pip install -e .`** 的环境差异;当前仓库 `pyproject.toml` 已配 `pythonpath=["src"]`,干净环境直接 `python -m pytest -q` 是 **480 passed**。建议在表中注明"该行是本机未安装环境下的数字",避免后来者以为 main 真的带 8 个失败。 ## 一点补充 文档里"共享中心库并发没有真正的互斥"我复核为成立:`main` 只有 `Local\CbbRefreshVerify795` 进程内互斥 + 本机进程探测;#9–#12 新增的 sidecar 库锁是合作式文件锁,Mentor 不参与。建议在文中把"合作式"的边界写得更直白(只约束本工具,不约束另一个工程师直接开 LM)。 —— 本次为只读审查,未执行原生操作。
abaishu0730 merged commit 46dae81190 into main 2026-11-06 10:20:24 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/cbb-refresh-verify-795#5