【扫描】批量校验阻塞点:状态桥部署、未知弹窗停批、取消语义与共享库并发 #4

Open
opened 2026-11-04 15:15:49 +08:00 by abaishu0730 · 0 comments
Owner

背景

对 main@39985f7(v0.2.3-beta.1,2026-10-29)和活跃分支 codex/temp-issue-2-icdb-recovery@29959e2(2026-11-04,领先 main 49 个提交、+13,173 行)做了全量扫描:逐模块阅读源码、两个分支跑完整 pytest、解析 32 位状态桥 PE 导入表并实机启动、对关键判定函数做行为探针。

要回答的问题不是"代码写得好不好",而是:这个工具现在能否稳定地把一批 CBB 刷成绿?

结论:单 CBB / Win11 / 状态桥可用 / 无人占用 → 可以;批量、Win10、共享库并发、库损坏恢复四类场景仍被阻塞。 工具"失败即阻塞、不伪造绿色"的方向是对的,问题集中在判定链的部署完整性、现场弹窗/占用环境、以及批量的工程化。

扫描数据

项 main temp-issue-2 分支
源文件 / 行数 38 / 8,180 47 / 13,000+
测试文件 / 行数 35 / 5,752 约 50 / 9,000+
用例数 471 1,196
本机 pytest 463 passed / 8 failed 1,178 passed / 18 failed

测试机:Windows 11 x64,未安装 Mentor EE7.9.5,SysWOW64 无 x86 MFC/VC 运行时。上述失败均归因于环境(未 pip install -e .、无 Mentor、缺 x86 运行时、长路径/编码),不是断言暴露的产品逻辑失败。

阻塞点

P0 · 批量上线前必须解决

# 阻塞点 证据 影响
K2-1 状态桥不可用时仍启动批量:桥只在 worker 成功后查询,批量入口无桥预检 verify_runner.py:981-1000;ui/main_window.py:63-68 每个 CBB 白做 2–10 分钟原生刷新 + Save/Close,最后 BRIDGE_UNAVAILABLE;3000 项 = 3000 次无效写库
K2-1b 32 位桥依赖 x86 mfc140/MSVCP140/VCRUNTIME140,打包清单只带 exe、未声明/检测运行时(发布 ZIP 不在仓库,需在发布包复核) packaging/CbbRefreshVerify.spec:4-14;PE 导入表;本机 0xC0000135 未装 VC++ 2015-2022 x86 运行时的机器,桥永远不可用 → 全部项最终 FAIL
K2-2 未知弹窗即停批:任何不在白名单的窗口 = UNKNOWN_DIALOG = 当前项 FAIL + 整批停止;规则要求精确英文文本 + GXWND/Button 类名 dialog_rules.py:216-236;dialog_supervisor.py:458-471 Mentor 版本/语言差异或任何新提示都会中断整批;历史 IME 6 项误判即此类
K2-3 超时/取消不终止 worker:request_stop 只 touch 取消文件,worker 仅在 3 处检查;看门狗在 cancel_path 存在时只写取消、不退出 desktop_worker.py:34-56,149-157;mentor_adapter.py:684-689,744-746,787-789 监督器报 TIMEOUT/FAIL 后仍可能有迟到的 Save/Close;清理恰好看到 PCB 已退出时会继续下一项
K2-6 ICDB 失联的自动 Repair 全链路未验收;Repair 后 BackAnnotate 被原生拒绝 docs/releases/2026-11-03-field-feedback.md、2026-11-04-icdb-review-fixes.md 现场一旦出现 lost server session,后续条目全部 SKIPPED

P1 · 批量可用性与数据安全

# 阻塞点 证据 影响
K2-4 共享中心库无跨机互斥:main 只有 Local\ 命名互斥 + 本机 PCB 探测;分支新增 sidecar 文件锁,但属合作式,Mentor 不参与 verify_runner.py:742-746;library_lock.py(分支) 两台机器/两位工程师同时操作同名 CBB 无任何防护
K2-5 残留 sAddress.adr 永久阻断;本机任意 PCB 打开即拒跑 icdb_ownership.py:13-16;mentor_adapter.py:619-621 日常使用门槛高;一次崩溃后需人工清场
K2-7 Win10 未验证:私有桌面 UIA 不派发 MFC 菜单,直接 PCB 路线在 Win10 的提交行为无现场证据 docs/API-FINDINGS.md §7 只能以"Win11 已验证"交付
K2-8 内容检查文本误判;preflight 只按 UTF-8 解析 .prj verify_runner.py:30-31,128-141,157 "0 errors" 被判失败;UTF-16/ANSI 工程被误判"无 PCBDesignPath"
K2-9 工具会改写中心库内 PCB/pcb.prj 的 CentralLibrary,网络库不做整工程备份 mentor_adapter.py:93-162,707-712 无回退副本,与 README"不直接改写中心库 .prj"的表述冲突
K3-1 首屏 O(全库) SHA-256 + 逐 CBB preflight,无进度、不可取消 batch_status.py:95-122;ui/main_window.py:257-263 3000 项网络库首屏可达数十分钟
K3-2 队列不持久化、不能取消当前项、无断点续跑 verify_runner.run_batch;ui/main_window.py:417-454 长批次中断只能重来

可复现的具体缺陷

  1. 桥无法启动(本机):
    .\tools\status_bridge\bin\CbbStatusBridge32.exe --codec-test
    # 退出码 -1073741515 (0xC0000135);导入表含 mfc140.dll / MSVCP140.dll / VCRUNTIME140.dll
    
  2. 无桥仍执行全量:read_library_fast 返回 UNAVAILABLE 的条目仍进入 verify_all;run_verify 完成 PCB 刷新后才在 apply_post_verify_status 判 BRIDGE_UNAVAILABLE。
  3. 内容检查误判(探针):
    classify_output(0, "Reuse Block's content checking completed successfully! 0 errors, 0 warnings")
    # -> 'FAIL'(ERROR_TEXT 正则命中 "errors")
    
  4. 未知弹窗停批:在 dialog_rules.v1.json 不新增规则的前提下,任何新提示(如 "Reusable block already exists")都会走 decide() 的 UNKNOWN_DIALOG 分支并返回 safe_to_continue=False。
  5. 取消语义:DesktopWorker.request_stop() 仅 Path(cancel).touch();worker 在 save helper 轮询循环(mentor_adapter.py:800-809)中不会读取取消状态,也没有超时。

复现与环境

git clone https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795.git
cd cbb-refresh-verify-795
python -m pip install -e .
python -m pip install pytest pytest-qt
python -m pytest -q

建议的修复顺序与验收

  1. 桥部署闭环(P0):打包 VC_redist.x86 或桥改 /MT;启动时桥自检;无桥时禁用"批量校验"并提示安装,而不是跑完整批。
    • 验收:干净 Win11(无 VC 运行时)→ 明确提示安装;不产生任何原生刷新。
  2. 弹窗分级(P0):规则增加 on_unknown: stop | record_continue | block_item;纯文本/IME/无按钮窗口仅记录并留证;数据库恢复/许可/保存失败仍阻断。
    • 验收:新增未登记弹窗的模拟场景,批量不中断且 dialogs.jsonl 有证据。
  3. 取消/超时语义(P0):明确"停自动化客户端、保留原生会话";worker 未确认退出时不得释放互斥/继续下一项;看门狗按是否处于 Save/Close 决定终止或保留并落盘决策。
    • 验收:模拟 Save 卡死 → 超时后 worker 确认退出或明确标记"仍存活",下一项不启动。
  4. 占用与残留策略(P1):PCB 占用按 CBB 路径匹配;sAddress.adr 在"不可达 + 非本机活进程 + 超时"时判定为陈旧并允许确认清理。
  5. 合并分支库锁(P1),并与上传工具约定同一协议。
  6. 规模化(P2):增量扫描、进度条、取消当前项、队列持久化、证据保留策略。

需要平台/产品侧确认(无法靠改代码消除)

  • Win10 是否在交付范围内;若否,请在 README 与验收清单中明确"仅 Win11"。
  • 共享中心库的并发使用规则(单人独占窗口 vs 引入锁并让 Mentor 侧配合)。
  • ICDB 失联修复的验收口径:"修复后自动重开 + 保存关闭 + READY"是否必须全绿才算出库。
  • 历史 PCB 版本恢复是否接受 RESTORED_REVIEW_REQUIRED 并人工复核版本。

附

  • 本地完整报告:CBB-Verify-全面扫描与阻塞分析.md(F-01~F-27 缺陷清单、K1/K2/K3 阻塞分级、现场失败映射、路线图)。需要的话可整理为 docs/diagnostics/ 下的正式文档提交 PR。
  • 扫描基准:main@39985f7、codex/temp-issue-2-icdb-recovery@29959e2。
## 背景 对 `main@39985f7`(v0.2.3-beta.1,2026-10-29)和活跃分支 `codex/temp-issue-2-icdb-recovery@29959e2`(2026-11-04,领先 main 49 个提交、+13,173 行)做了全量扫描:逐模块阅读源码、两个分支跑完整 pytest、解析 32 位状态桥 PE 导入表并实机启动、对关键判定函数做行为探针。 要回答的问题不是"代码写得好不好",而是:**这个工具现在能否稳定地把一批 CBB 刷成绿?** 结论:**单 CBB / Win11 / 状态桥可用 / 无人占用 → 可以;批量、Win10、共享库并发、库损坏恢复四类场景仍被阻塞。** 工具"失败即阻塞、不伪造绿色"的方向是对的,问题集中在判定链的部署完整性、现场弹窗/占用环境、以及批量的工程化。 ## 扫描数据 | 项 | main | temp-issue-2 分支 | | --- | --- | --- | | 源文件 / 行数 | 38 / 8,180 | 47 / 13,000+ | | 测试文件 / 行数 | 35 / 5,752 | 约 50 / 9,000+ | | 用例数 | 471 | 1,196 | | 本机 pytest | 463 passed / 8 failed | 1,178 passed / 18 failed | 测试机:Windows 11 x64,未安装 Mentor EE7.9.5,SysWOW64 无 x86 MFC/VC 运行时。上述失败均归因于环境(未 `pip install -e .`、无 Mentor、缺 x86 运行时、长路径/编码),不是断言暴露的产品逻辑失败。 ## 阻塞点 ### P0 · 批量上线前必须解决 | # | 阻塞点 | 证据 | 影响 | | --- | --- | --- | --- | | K2-1 | **状态桥不可用时仍启动批量**:桥只在 worker 成功后查询,批量入口无桥预检 | `verify_runner.py:981-1000`;`ui/main_window.py:63-68` | 每个 CBB 白做 2–10 分钟原生刷新 + Save/Close,最后 `BRIDGE_UNAVAILABLE`;3000 项 = 3000 次无效写库 | | K2-1b | **32 位桥依赖 x86 `mfc140/MSVCP140/VCRUNTIME140`,打包清单只带 exe、未声明/检测运行时**(发布 ZIP 不在仓库,需在发布包复核) | `packaging/CbbRefreshVerify.spec:4-14`;PE 导入表;本机 `0xC0000135` | 未装 VC++ 2015-2022 x86 运行时的机器,桥永远不可用 → 全部项最终 FAIL | | K2-2 | **未知弹窗即停批**:任何不在白名单的窗口 = `UNKNOWN_DIALOG` = 当前项 FAIL + 整批停止;规则要求精确英文文本 + `GXWND`/`Button` 类名 | `dialog_rules.py:216-236`;`dialog_supervisor.py:458-471` | Mentor 版本/语言差异或任何新提示都会中断整批;历史 IME 6 项误判即此类 | | K2-3 | **超时/取消不终止 worker**:`request_stop` 只 touch 取消文件,worker 仅在 3 处检查;看门狗在 `cancel_path` 存在时只写取消、不退出 | `desktop_worker.py:34-56,149-157`;`mentor_adapter.py:684-689,744-746,787-789` | 监督器报 TIMEOUT/FAIL 后仍可能有迟到的 Save/Close;清理恰好看到 PCB 已退出时会继续下一项 | | K2-6 | **ICDB 失联的自动 Repair 全链路未验收**;Repair 后 BackAnnotate 被原生拒绝 | `docs/releases/2026-11-03-field-feedback.md`、`2026-11-04-icdb-review-fixes.md` | 现场一旦出现 lost server session,后续条目全部 SKIPPED | ### P1 · 批量可用性与数据安全 | # | 阻塞点 | 证据 | 影响 | | --- | --- | --- | --- | | K2-4 | **共享中心库无跨机互斥**:main 只有 `Local\` 命名互斥 + 本机 PCB 探测;分支新增 sidecar 文件锁,但属合作式,Mentor 不参与 | `verify_runner.py:742-746`;`library_lock.py`(分支) | 两台机器/两位工程师同时操作同名 CBB 无任何防护 | | K2-5 | **残留 `sAddress.adr` 永久阻断;本机任意 PCB 打开即拒跑** | `icdb_ownership.py:13-16`;`mentor_adapter.py:619-621` | 日常使用门槛高;一次崩溃后需人工清场 | | K2-7 | **Win10 未验证**:私有桌面 UIA 不派发 MFC 菜单,直接 PCB 路线在 Win10 的提交行为无现场证据 | `docs/API-FINDINGS.md` §7 | 只能以"Win11 已验证"交付 | | K2-8 | 内容检查文本误判;preflight 只按 UTF-8 解析 `.prj` | `verify_runner.py:30-31,128-141,157` | "0 errors" 被判失败;UTF-16/ANSI 工程被误判"无 PCBDesignPath" | | K2-9 | 工具会改写中心库内 `PCB/pcb.prj` 的 CentralLibrary,网络库不做整工程备份 | `mentor_adapter.py:93-162,707-712` | 无回退副本,与 README"不直接改写中心库 .prj"的表述冲突 | | K3-1 | 首屏 O(全库) SHA-256 + 逐 CBB preflight,无进度、不可取消 | `batch_status.py:95-122`;`ui/main_window.py:257-263` | 3000 项网络库首屏可达数十分钟 | | K3-2 | 队列不持久化、不能取消当前项、无断点续跑 | `verify_runner.run_batch`;`ui/main_window.py:417-454` | 长批次中断只能重来 | ## 可复现的具体缺陷 1. **桥无法启动**(本机): ```powershell .\tools\status_bridge\bin\CbbStatusBridge32.exe --codec-test # 退出码 -1073741515 (0xC0000135);导入表含 mfc140.dll / MSVCP140.dll / VCRUNTIME140.dll ``` 2. **无桥仍执行全量**:`read_library_fast` 返回 `UNAVAILABLE` 的条目仍进入 `verify_all`;`run_verify` 完成 PCB 刷新后才在 `apply_post_verify_status` 判 `BRIDGE_UNAVAILABLE`。 3. **内容检查误判**(探针): ```python classify_output(0, "Reuse Block's content checking completed successfully! 0 errors, 0 warnings") # -> 'FAIL'(ERROR_TEXT 正则命中 "errors") ``` 4. **未知弹窗停批**:在 `dialog_rules.v1.json` 不新增规则的前提下,任何新提示(如 "Reusable block already exists")都会走 `decide()` 的 `UNKNOWN_DIALOG` 分支并返回 `safe_to_continue=False`。 5. **取消语义**:`DesktopWorker.request_stop()` 仅 `Path(cancel).touch()`;worker 在 `save helper` 轮询循环(`mentor_adapter.py:800-809`)中不会读取取消状态,也没有超时。 ## 复现与环境 ```powershell git clone https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795.git cd cbb-refresh-verify-795 python -m pip install -e . python -m pip install pytest pytest-qt python -m pytest -q ``` ## 建议的修复顺序与验收 1. **桥部署闭环**(P0):打包 `VC_redist.x86` 或桥改 `/MT`;启动时桥自检;无桥时禁用"批量校验"并提示安装,而不是跑完整批。 - 验收:干净 Win11(无 VC 运行时)→ 明确提示安装;不产生任何原生刷新。 2. **弹窗分级**(P0):规则增加 `on_unknown: stop | record_continue | block_item`;纯文本/IME/无按钮窗口仅记录并留证;数据库恢复/许可/保存失败仍阻断。 - 验收:新增未登记弹窗的模拟场景,批量不中断且 `dialogs.jsonl` 有证据。 3. **取消/超时语义**(P0):明确"停自动化客户端、保留原生会话";worker 未确认退出时不得释放互斥/继续下一项;看门狗按是否处于 Save/Close 决定终止或保留并落盘决策。 - 验收:模拟 Save 卡死 → 超时后 worker 确认退出或明确标记"仍存活",下一项不启动。 4. **占用与残留策略**(P1):PCB 占用按 CBB 路径匹配;`sAddress.adr` 在"不可达 + 非本机活进程 + 超时"时判定为陈旧并允许确认清理。 5. **合并分支库锁**(P1),并与上传工具约定同一协议。 6. **规模化**(P2):增量扫描、进度条、取消当前项、队列持久化、证据保留策略。 ## 需要平台/产品侧确认(无法靠改代码消除) - Win10 是否在交付范围内;若否,请在 README 与验收清单中明确"仅 Win11"。 - 共享中心库的并发使用规则(单人独占窗口 vs 引入锁并让 Mentor 侧配合)。 - ICDB 失联修复的验收口径:"修复后自动重开 + 保存关闭 + READY"是否必须全绿才算出库。 - 历史 PCB 版本恢复是否接受 `RESTORED_REVIEW_REQUIRED` 并人工复核版本。 ## 附 - 本地完整报告:`CBB-Verify-全面扫描与阻塞分析.md`(F-01~F-27 缺陷清单、K1/K2/K3 阻塞分级、现场失败映射、路线图)。需要的话可整理为 `docs/diagnostics/` 下的正式文档提交 PR。 - 扫描基准:`main@39985f7`、`codex/temp-issue-2-icdb-recovery@29959e2`。
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

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