Files
cbb-refresh-verify-795/docs/diagnostics/2026-11-05-blocker-scope.md

2.6 KiB
Raw Permalink Blame History

阻塞范围收紧记录

后续审查已修正本记录中“切库清除旧标志”和“只检查 Work”的不足。当前行为与验证请以 全链路审计 为准:状态按库保存,释放包含共享数据库并绑定原任务范围。

本轮处理的是“一个 CBB 出问题后把整批和其他库一起停掉”的误阻塞。

已收紧

  • 批次继续条件保持按实际释放证据判断。单项 FAIL、ICDB 检查发现问题或普通内容错误,只要本次原生/自动化客户端已经退出并返回 safe_to_continue=true,下一项继续;只有进程仍存活、退出状态无法确认或共享写入安全无法证明时才停止后续写操作。
  • 管理失败状态现在绑定实际中心库。切换到另一个中心库会清除旧库的 _management_unsafe,不会把库 A 的失败带到库 B;释放检查完成回调也只清除同一库的状态。
  • 显式维护的原生占用检查按目标 PRJ 命令行过滤无关 PCB/Library Manager。旧的零参数占用探针仍兼容,目标路径可用时不再被其他 CBB 阻塞。
  • 释放证明支持目标 CBB 范围。提供目标名称时,只检查该 Work 工程的地址记录、主要数据库文件和命令行包含该工程的原生客户端;其他 CBB 的 sAddress.adr 不再阻塞当前恢复。无目标范围的全库释放检查继续保守处理。
  • 释放接口新增参数保持旧调用兼容;旧插件或测试没有 block_name 参数时继续走全库证明路径。
  • UI 比较中心库身份不再对不可达 UNC 路径调用会访问网络的 Path.resolve()。网络共享暂时不可达时保持可用状态和错误提示,不在界面刷新中抛异常。

仍然必须停止的情况

  • 当前项的 PCB、Project Backup、保存助手、Importer 或管理工作进程仍在运行。
  • 进程查询失败、原生窗口身份不明、退出状态缺失,或库锁/共享写入归属无法确认。
  • 用户明确点击取消,当前批次停止后续项目。

这些停止条件保护共享数据库和原生写入现场;移除它们会把一个仍在写入的工程与下一个 CBB 并行运行,可能造成更大范围的数据损坏。

验证

新增回归覆盖单项已释放失败继续批次、切库清除管理阻塞、目标 CBB 过滤无关进程/地址、旧释放接口兼容和不可达 UNC 路径。最终全量回归 1309 passed,1 条既有 pywinauto STA 警告;compileall 与 git diff --check 通过。

本轮没有修改图标等其他工作区文件,也没有对现场中心库执行写入、Repair 或 Restore。