审查拆分 4/4:残留释放边界、确认留证与 0.2.4b1 契约 #12

Merged
abaishu0730 merged 10 commits from codex/review-residual-release into main 2026-11-12 17:39:46 +08:00
Owner

针对评论 286 修正残留释放:初始 NOT_STARTED 检查点先落盘,逐项持久保存实际结果;初次/末次快照超时与中途异常都保留已完成/未执行项。保存失败停止继续发出动作,最终报告保存失败明确返回 PARTIAL/evidence_error;若匹配当前库的独立释放证明已成立,界面接受已释放事实并提示记录失败,不重新制造占用。

预览及精确句柄处重新检查原生窗口、进度和 Output。Backup/Restore/Repair 进行中或备份输出无法确认时,不强制结束该客户端;状态变化后可重新检查。服务器、导入器、未知身份仍排除,当前用户/会话与精确映像身份约束保留。派发处复核快照身份/原预览 roots,句柄处复核创建时间/完整映像/SID/Windows 会话/原生活动,文档已按实际分工更正。

预览显示完整程序路径和所在桌面,可查看后台窗口标题/输出并处理既有保存提示。只有当前备份窗口唯一存在可识别且启用的标准 Cancel/取消(IDCANCEL=2)按钮,才提供单独确认的原生取消请求;执行前重新匹配身份、用户会话、标题、桌面、窗口和按钮 PID。该请求串行执行并先留证,不等同于已取消或已修复,没有猜测菜单参数、自动选择历史版本或前台鼠标回退。原生取消确已关闭会话且释放证明成立时,同样通知父界面解除对应状态。

失败安全:确认意图与实际执行结果分别记录;普通残留客户端仍可按名单确认释放,活跃/未知状态保留可见原因和重新检查路径。回滚代码不能撤销进程结束/原生事务;恢复依靠一致人工备份或明确选择的原生历史,不自动重放。

依赖 #11,版本仍为未发布的 0.2.4b1 候选。README、SOP、手册和发布说明同步修正;模拟会话界面实际打开并完成布局检查。

本轮完整集成回归 1,631 passed,后端完整 1,385 passed;后端读范围专项 9、界面/独立操作专项 29 通过。完整回归后,GUI 释放证明比较改为纯路径字符串比较,避免访问网络文件系统;这一处调整后最终释放专项 63 passed,未为该独立比较改动重复整套测试。编译与 diff 检查通过。验证记录:docs/releases/2026-11-06-review-followup-validation.json;本阶段说明见 docs/reviews/2026-11-06-*-followup.md。

未执行真实 Mentor 的强制结束/原生取消或生产库写操作;新冻结包、现场 ICDB 恢复、Windows 10、跨机器共享库并发尚未验收。ICDB 自动修复继续暂停。保持 Draft,等待修正后的审查;没有合并本轮新代码、发布程序或关闭工单。

11 月 9 日其他 PR 复核跟进

评论 #313 已修复:按目标进程线程定位桌面,只读取对应进程的窗口;不可读状态按 PID 记录,不再伪造弹窗或让无关桌面失败影响全部行。预览和关闭、强制结束、保存响应、原生取消的执行前复核使用同一不可读状态。未知或正在写入的会话仍禁止强制结束,未添加盲目强杀覆盖。

释放记录只保存窗口身份、最多 4 KiB 的 UTF-8 输出摘要及原文大小/哈希,预览仍可查看全文。原生 Cancel 携带预览 block_names,复核范围不再扩大为整库。

本分支相关回归 116 passed(包含真实 Windows 私有桌面窗口夹具);compileall / diff 检查通过,独立复查无重要新问题。源修复 651b539,记录 docs/releases/2026-11-09-pr12-review313.md。已与 #13 的运行时生命周期保护集成。

本轮仅处理 11 月 9 日最新复核意见,11 月 6 日旧深审遗留不在所选范围。没有重新打包;旧测试包不含这些改动。真实 Mentor、Windows 10、共享库/跨机器场景仍未验收。保持 Draft,不合并、不关闭工单。

11 月 9 日完整审查后续修正

评论 #348 中的全局窗口读取失败与重复大日志已由 651b539 修复,本轮复核保留。新增确认范围/实际执行结果列和允许但未释放数量,预览允许与执行前拒绝分别可见。向后集成 #11 的结果窗口回收时,保留启用的释放逻辑并在旧摘要关闭后重建“继续未执行项”动作;目标仍限于原批次未执行项。

源修复 14c9a74,续做修复 a7df105;残留分支合并后针对性回归 41 passed。

本轮未重新打包;旧 iconfix 测试包不含本轮修复。图标和两处 LF 规则保持。真实 Mentor、冻结新行为、Windows 10、共享库/跨机器场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不发布、不关闭工单。

针对评论 286 修正残留释放:初始 NOT_STARTED 检查点先落盘,逐项持久保存实际结果;初次/末次快照超时与中途异常都保留已完成/未执行项。保存失败停止继续发出动作,最终报告保存失败明确返回 PARTIAL/evidence_error;若匹配当前库的独立释放证明已成立,界面接受已释放事实并提示记录失败,不重新制造占用。 预览及精确句柄处重新检查原生窗口、进度和 Output。Backup/Restore/Repair 进行中或备份输出无法确认时,不强制结束该客户端;状态变化后可重新检查。服务器、导入器、未知身份仍排除,当前用户/会话与精确映像身份约束保留。派发处复核快照身份/原预览 roots,句柄处复核创建时间/完整映像/SID/Windows 会话/原生活动,文档已按实际分工更正。 预览显示完整程序路径和所在桌面,可查看后台窗口标题/输出并处理既有保存提示。只有当前备份窗口唯一存在可识别且启用的标准 Cancel/取消(IDCANCEL=2)按钮,才提供单独确认的原生取消请求;执行前重新匹配身份、用户会话、标题、桌面、窗口和按钮 PID。该请求串行执行并先留证,不等同于已取消或已修复,没有猜测菜单参数、自动选择历史版本或前台鼠标回退。原生取消确已关闭会话且释放证明成立时,同样通知父界面解除对应状态。 失败安全:确认意图与实际执行结果分别记录;普通残留客户端仍可按名单确认释放,活跃/未知状态保留可见原因和重新检查路径。回滚代码不能撤销进程结束/原生事务;恢复依靠一致人工备份或明确选择的原生历史,不自动重放。 依赖 #11,版本仍为未发布的 0.2.4b1 候选。README、SOP、手册和发布说明同步修正;模拟会话界面实际打开并完成布局检查。 本轮完整集成回归 **1,631 passed**,后端完整 **1,385 passed**;后端读范围专项 9、界面/独立操作专项 29 通过。完整回归后,GUI 释放证明比较改为纯路径字符串比较,避免访问网络文件系统;这一处调整后最终释放专项 **63 passed**,未为该独立比较改动重复整套测试。编译与 diff 检查通过。验证记录:`docs/releases/2026-11-06-review-followup-validation.json`;本阶段说明见 `docs/reviews/2026-11-06-*-followup.md`。 未执行真实 Mentor 的强制结束/原生取消或生产库写操作;新冻结包、现场 ICDB 恢复、Windows 10、跨机器共享库并发尚未验收。ICDB 自动修复继续暂停。保持 Draft,等待修正后的审查;没有合并本轮新代码、发布程序或关闭工单。 ### 11 月 9 日其他 PR 复核跟进 评论 #313 已修复:按目标进程线程定位桌面,只读取对应进程的窗口;不可读状态按 PID 记录,不再伪造弹窗或让无关桌面失败影响全部行。预览和关闭、强制结束、保存响应、原生取消的执行前复核使用同一不可读状态。未知或正在写入的会话仍禁止强制结束,未添加盲目强杀覆盖。 释放记录只保存窗口身份、最多 4 KiB 的 UTF-8 输出摘要及原文大小/哈希,预览仍可查看全文。原生 Cancel 携带预览 block_names,复核范围不再扩大为整库。 本分支相关回归 116 passed(包含真实 Windows 私有桌面窗口夹具);compileall / diff 检查通过,独立复查无重要新问题。源修复 651b539,记录 docs/releases/2026-11-09-pr12-review313.md。已与 #13 的运行时生命周期保护集成。 本轮仅处理 11 月 9 日最新复核意见,11 月 6 日旧深审遗留不在所选范围。没有重新打包;旧测试包不含这些改动。真实 Mentor、Windows 10、共享库/跨机器场景仍未验收。保持 Draft,不合并、不关闭工单。 ### 11 月 9 日完整审查后续修正 评论 #348 中的全局窗口读取失败与重复大日志已由 651b539 修复,本轮复核保留。新增确认范围/实际执行结果列和允许但未释放数量,预览允许与执行前拒绝分别可见。向后集成 #11 的结果窗口回收时,保留启用的释放逻辑并在旧摘要关闭后重建“继续未执行项”动作;目标仍限于原批次未执行项。 源修复 14c9a74,续做修复 a7df105;残留分支合并后针对性回归 41 passed。 本轮未重新打包;旧 iconfix 测试包不含本轮修复。图标和两处 LF 规则保持。真实 Mentor、冻结新行为、Windows 10、共享库/跨机器场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不发布、不关闭工单。
Author
Owner

审查 4/4:残留释放边界 + 0.2.4b1 契约——修复后合并(2×P2 + 5×P3,无 P1)

范围:#12 相对 #11(282be7b..dc536da),54 文件 +3,917/−14。代码主体是新增 residual_sessions.py(441) 与 ui/residual_release_dialog.py(180),ui/main_window.py 只改 25 行;其余是 26 篇历史诊断/发布文档、版本号 0.2.4b1、以及 5 个新/改测试文件(test_residual_sessions.py 363 行、test_residual_release_dialog.py 156 行)。

结论

修复后合并。 这一段是本轮风险最高的改动(会真的结束用户进程),实现比我预期保守:默认只做正常关闭,强制结束是独立入口 + 独立确认 + 双重身份复核。没有发现 P1。

三条自述我逐条核对的结果

自述 核对 结论
只允许受支持客户端 _FORCE_CLIENT_NAMES = {expeditionpcb.exe, librarymanager.exe, viewdraw.exe, icdbprojectbackup.exe}(residual_sessions.py:18),force_block_reason(:21-34)对服务器/导入器/未知进程一律拒绝 成立(有 P2-2 与 P3-1 两处缺口)
派发与句柄两处复核 派发前查 created/executable/command/name + scope(:347-355);句柄处查 CreationTime/映像/SID/Windows 会话(:303-310) 基本成立,但 SID/会话只在句柄处、命令行/scope 只在派发处;PR 描述"两处都复核 SID/会话"不精确(P3)
consent 先落盘、失败不执行 open('x') + flush + fsync(:336-338),异常直接抛出,无原生动作 成立(有一处 P2)

另外两点我认为做得好

  • 释放证明链:只有全部会话 RELEASED 且 release_retained_library 返回 RELEASE_CONFIRMED、且证明里的库路径与当前库一致时,才 status=RELEASE_CONFIRMED(:377-381);否则保留 PARTIAL——"没证明成功就不说成功"。
  • 保存提示的应答也做了身份绑定:_answer_save_question 重新快照、比对进程身份、比对提示窗口与按钮集合完全相等、再校验按钮属于该 PID,然后才 BM_CLICK(:426-441)。这类"点按钮前再验一遍"的写法很少见,值得保留。

P2(建议合并前改)

[P2-1] 中途异常会丢掉 result.json;证据写失败又会静默保留 RELEASE_CONFIRMED

  • 位置:residual_sessions.py:340-386。fresh = {...query_process_snapshot()}(:340)与 after = {...}(:365)都没有保护。WMI 超时(OWNER_QUERY_TIMEOUT)在负载高的机器上很常见,一旦抛异常,整个函数直接退出,证据目录里只剩 consent.json(强制模式)或空目录,result.json 不会生成。
  • 我实测:强制模式下一次协作式释放若在快照处抛错,证据目录为空目录 —— 事后无法回答"到底关了谁、谁没关"。
  • 另一半:result.json 写失败被 except OSError 吞掉只记 evidence_error,但 status 已经是 RELEASE_CONFIRMED(:380-386),UI 会显示"已释放 N 个会话,旧占用记录已解除"。
  • 建议:把 :340-386 整体包在 try/except BaseException 里,except 分支写一份 result.json(status='PARTIAL'、error=...、已完成的会话结果)再抛出;证据写失败时把 status 降为 PARTIAL 并在 UI 上明示"证据未落盘"。

[P2-2] 强制结束绕过"原生操作进行中"判据——可能杀掉正在 Repair/Backup 的 iCDB Project Backup

  • 协作关闭对"正在进行"的防护在 close_target 里:窗口未启用 → 拒绝;有进度条 → "原生操作尚未结束";icdbprojectbackup.exe 的输出里出现 repairing|restoring|backing up|creating backup → "备份、恢复或修复需要在原生窗口确认结束后再释放"(:174-186)。
  • 但 force_block_reason(:21-34)和 _force_close(:303-315)完全不看这个状态,consent.json 里也不记录它。也就是说:用户对一条"占着库、看着像僵死"的 iCDB Project Backup 勾了强制结束,而它可能正在写备份/修复数据库——这正是最不该打断的时刻,而工具的默认协作路径明确知道要避开它。
  • 建议:force_block_reason 加上"原生操作进行中 → 不允许强制结束"(需要先重新读取一次原生输出;读不到也拒绝),或在强制确认框里把"该会话正在执行 Backup/Repair"作为阻断项列出。

P3(建议顺手处理)

[P3-1] 强制结束只校验映像基名,没有绑定安装路径/签名

  • force_block_reason 判据是 Path(row['image']).name.casefold() != name(:27-29),所以任何位置、任何来源的 expeditionpcb.exe 都能通过。
  • 结合 scope/created/SID 检查后实际风险不高,但既然这个动作不可撤销,建议至少把完整 image 路径写进 consent.json 并在 UI 预览里展示(审核时能看出"这不是我们的安装目录"),或额外校验安装目录前缀/签名。
  • 我实测:image='C:\\Temp\\expeditionpcb.exe' + scope_confirmed=True 时 force_block_reason 返回空(放行)。

[P3-2] 遗留会话落在私有桌面上时,操作员"看不到也点不到"

  • _process_windows 会枚举 CbbVerify_*/CbbRepair_*/CbbManagement_*/CbbStatusRead_*/CbbFlagRead_* 私有桌面(:128-142),但返回的窗口字典里没有 desktop 名。
  • close_target 遇到任何非 benign 的额外汇窗口就返回"存在原生弹窗,请先处理该窗口后重新检查"(:172-180)。如果那个弹窗在本工具自己创建的私有桌面上,人根本切不过去处理——唯一出路是强制结束(丢未保存更改)。
  • 建议:窗口字典带上 desktop 名;私有桌面上的窗口不要建议"请自行处理",而是直接给出"结束该会话(会丢失未保存更改)"的显式选项,或在 worker 退出时清理自己创建的桌面/窗口。

[P3-3] 契约描述与实现的两处精度问题

  • README/SOP/docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md:13-17 与 docs/releases/v0.2.4-beta.1.md 我逐条对过,内部一致;但"派发与句柄两处复核 SID/会话"这句与实现不符(见上表),建议改成"派发处复核身份与作用域,句柄处复核创建时间、映像、用户与会话"。
  • consent.json 里记录的是预览时的 force_allowed;实际执行时会重新校验并对变化项拒绝(:347-355),所以 consent 是"用户看到的意图"而不是"最终执行结果"。建议在 result.json 里明确列出 consent_allowed 与实际 release_status 的差异,避免事后误读。

[P3-4] inspect_residual_sessions 在库文件不存在时直接报 ValueError

  • :203-205:.lmc 不存在(网络盘掉线、盘符未映射)时报"请选择有效的中心库 .lmc 文件",与"网络路径不可见"是两类问题。建议区分文案,并在网络盘场景提示先恢复映射(ensure_mapped_drive_visible 已在别处使用)。

[P3-5] 释放时复核的 roots 比预览时更宽

  • 预览用 block/Work + SymbolLibs 两个窄 roots 判 scope(:215-216),释放时却用 (library.parent,) 全库判 scope(:350)。因为还有 created/command/executable 身份比对钉住同一进程,这不是越权漏洞;但"释放时的作用域复核"实际比"预览时的确认"更松,和 PR 里"两处复核"的说法不完全对应。建议两处用同一组 roots。

验证记录

  • 代码级:全部 file:line 逐条读过;force_block_reason 放行基名用例、maintenance_counts 双计为实跑。
  • 独占全量测试本机结果:1601 passed, 1 warning in 432.39s(7 分 12 秒),全部通过。
  • 测试覆盖:test_residual_sessions.py(363) + test_residual_release_dialog.py(156) 覆盖了"服务器/导入器不可强杀、SID 不符拒绝、句柄身份变化拒绝、consent 先落盘、私有桌面提示"等关键面。
  • 未验证/未做:真实 Mentor 客户端上的正常关闭与强制结束(只读审查,没有在本机杀任何 native 进程);跨用户会话场景。
# 审查 4/4:残留释放边界 + 0.2.4b1 契约——修复后合并(2×P2 + 5×P3,无 P1) 范围:#12 相对 #11(`282be7b..dc536da`),54 文件 +3,917/−14。代码主体是新增 `residual_sessions.py`(441) 与 `ui/residual_release_dialog.py`(180),`ui/main_window.py` 只改 25 行;其余是 26 篇历史诊断/发布文档、版本号 `0.2.4b1`、以及 5 个新/改测试文件(`test_residual_sessions.py` 363 行、`test_residual_release_dialog.py` 156 行)。 ## 结论 **修复后合并。** 这一段是本轮风险最高的改动(会真的结束用户进程),实现比我预期保守:**默认只做正常关闭,强制结束是独立入口 + 独立确认 + 双重身份复核**。没有发现 P1。 ### 三条自述我逐条核对的结果 | 自述 | 核对 | 结论 | | --- | --- | --- | | 只允许受支持客户端 | `_FORCE_CLIENT_NAMES = {expeditionpcb.exe, librarymanager.exe, viewdraw.exe, icdbprojectbackup.exe}`(`residual_sessions.py:18`),`force_block_reason`(`:21-34`)对服务器/导入器/未知进程一律拒绝 | **成立**(有 P2-2 与 P3-1 两处缺口) | | 派发与句柄两处复核 | 派发前查 `created/executable/command/name` + scope(`:347-355`);句柄处查 `CreationTime`/映像/SID/Windows 会话(`:303-310`) | **基本成立**,但 SID/会话只在句柄处、命令行/scope 只在派发处;PR 描述"两处都复核 SID/会话"不精确(P3) | | consent 先落盘、失败不执行 | `open('x')` + `flush` + `fsync`(`:336-338`),异常直接抛出,无原生动作 | **成立**(有一处 P2) | ### 另外两点我认为做得好 - **释放证明链**:只有全部会话 `RELEASED` 且 `release_retained_library` 返回 `RELEASE_CONFIRMED`、且证明里的库路径与当前库一致时,才 `status=RELEASE_CONFIRMED`(`:377-381`);否则保留 `PARTIAL`——"没证明成功就不说成功"。 - **保存提示的应答也做了身份绑定**:`_answer_save_question` 重新快照、比对进程身份、比对提示窗口与按钮集合完全相等、再校验按钮属于该 PID,然后才 `BM_CLICK`(`:426-441`)。这类"点按钮前再验一遍"的写法很少见,值得保留。 ## P2(建议合并前改) ### [P2-1] 中途异常会**丢掉 `result.json`**;证据写失败又会静默保留 `RELEASE_CONFIRMED` - 位置:`residual_sessions.py:340-386`。`fresh = {...query_process_snapshot()}`(`:340`)与 `after = {...}`(`:365`)都没有保护。WMI 超时(`OWNER_QUERY_TIMEOUT`)在负载高的机器上很常见,一旦抛异常,整个函数直接退出,**证据目录里只剩 `consent.json`(强制模式)或空目录**,`result.json` 不会生成。 - 我实测:强制模式下一次协作式释放若在快照处抛错,证据目录为空目录 —— 事后无法回答"到底关了谁、谁没关"。 - 另一半:`result.json` 写失败被 `except OSError` 吞掉只记 `evidence_error`,但 `status` 已经是 `RELEASE_CONFIRMED`(`:380-386`),UI 会显示"已释放 N 个会话,旧占用记录已解除"。 - 建议:把 `:340-386` 整体包在 `try/except BaseException` 里,`except` 分支写一份 `result.json`(`status='PARTIAL'`、`error=...`、已完成的会话结果)再抛出;证据写失败时把 `status` 降为 `PARTIAL` 并在 UI 上明示"证据未落盘"。 ### [P2-2] 强制结束**绕过"原生操作进行中"判据**——可能杀掉正在 Repair/Backup 的 iCDB Project Backup - 协作关闭对"正在进行"的防护在 `close_target` 里:窗口未启用 → 拒绝;有进度条 → "原生操作尚未结束";`icdbprojectbackup.exe` 的输出里出现 `repairing|restoring|backing up|creating backup` → "备份、恢复或修复需要在原生窗口确认结束后再释放"(`:174-186`)。 - 但 `force_block_reason`(`:21-34`)和 `_force_close`(`:303-315`)**完全不看这个状态**,`consent.json` 里也不记录它。也就是说:用户对一条"占着库、看着像僵死"的 iCDB Project Backup 勾了强制结束,而它可能正在写备份/修复数据库——这正是最不该打断的时刻,而工具的默认协作路径明确知道要避开它。 - 建议:`force_block_reason` 加上"原生操作进行中 → 不允许强制结束"(需要先重新读取一次原生输出;读不到也拒绝),或在强制确认框里把"该会话正在执行 Backup/Repair"作为阻断项列出。 ## P3(建议顺手处理) ### [P3-1] 强制结束只校验映像**基名**,没有绑定安装路径/签名 - `force_block_reason` 判据是 `Path(row['image']).name.casefold() != name`(`:27-29`),所以任何位置、任何来源的 `expeditionpcb.exe` 都能通过。 - 结合 scope/created/SID 检查后实际风险不高,但既然这个动作不可撤销,建议至少把完整 `image` 路径写进 `consent.json` 并在 UI 预览里展示(审核时能看出"这不是我们的安装目录"),或额外校验安装目录前缀/签名。 - 我实测:`image='C:\\Temp\\expeditionpcb.exe'` + `scope_confirmed=True` 时 `force_block_reason` 返回空(放行)。 ### [P3-2] 遗留会话落在私有桌面上时,操作员"看不到也点不到" - `_process_windows` 会枚举 `CbbVerify_*`/`CbbRepair_*`/`CbbManagement_*`/`CbbStatusRead_*`/`CbbFlagRead_*` 私有桌面(`:128-142`),但返回的窗口字典里**没有 desktop 名**。 - `close_target` 遇到任何非 benign 的额外汇窗口就返回"存在原生弹窗,请先处理该窗口后重新检查"(`:172-180`)。如果那个弹窗在**本工具自己创建的私有桌面**上,人根本切不过去处理——唯一出路是强制结束(丢未保存更改)。 - 建议:窗口字典带上 desktop 名;私有桌面上的窗口不要建议"请自行处理",而是直接给出"结束该会话(会丢失未保存更改)"的显式选项,或在 worker 退出时清理自己创建的桌面/窗口。 ### [P3-3] 契约描述与实现的两处精度问题 - README/SOP/`docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md:13-17` 与 `docs/releases/v0.2.4-beta.1.md` 我逐条对过,**内部一致**;但"派发与句柄两处复核 SID/会话"这句与实现不符(见上表),建议改成"派发处复核身份与作用域,句柄处复核创建时间、映像、用户与会话"。 - `consent.json` 里记录的是**预览时**的 `force_allowed`;实际执行时会重新校验并对变化项拒绝(`:347-355`),所以 consent 是"用户看到的意图"而不是"最终执行结果"。建议在 `result.json` 里明确列出 `consent_allowed` 与实际 `release_status` 的差异,避免事后误读。 ### [P3-4] `inspect_residual_sessions` 在库文件不存在时直接报 `ValueError` - `:203-205`:`.lmc` 不存在(网络盘掉线、盘符未映射)时报"请选择有效的中心库 .lmc 文件",与"网络路径不可见"是两类问题。建议区分文案,并在网络盘场景提示先恢复映射(`ensure_mapped_drive_visible` 已在别处使用)。 ### [P3-5] 释放时复核的 roots 比预览时更宽 - 预览用 `block/Work` + `SymbolLibs` 两个窄 roots 判 scope(`:215-216`),释放时却用 `(library.parent,)` 全库判 scope(`:350`)。因为还有 `created/command/executable` 身份比对钉住同一进程,这不是越权漏洞;但"释放时的作用域复核"实际比"预览时的确认"更松,和 PR 里"两处复核"的说法不完全对应。建议两处用同一组 roots。 ## 验证记录 - 代码级:全部 `file:line` 逐条读过;`force_block_reason` 放行基名用例、`maintenance_counts` 双计为实跑。 - **独占全量测试**本机结果:`1601 passed, 1 warning in 432.39s`(7 分 12 秒),全部通过。 - 测试覆盖:`test_residual_sessions.py`(363) + `test_residual_release_dialog.py`(156) 覆盖了"服务器/导入器不可强杀、SID 不符拒绝、句柄身份变化拒绝、consent 先落盘、私有桌面提示"等关键面。 - 未验证/未做:真实 Mentor 客户端上的正常关闭与强制结束(只读审查,没有在本机杀任何 native 进程);跨用户会话场景。
Author
Owner

深度审查:CBB Verify 工具(链路顶端 dc536da,含 main 既有代码)

范围:在完成 #9–#12 逐片审查后,继续对工具本身的运行时行为做深审,不再只看 diff:verify_runner.py(1331)、mentor_adapter.py(1636)、desktop_worker.py、native_management.py、library_reader.py、dialog_probe.py、backup_recovery.py。

结论

不阻塞 #9–#12 合并(下面多是 main 就有的深层问题,拆分链没有引入新回归),但建议在下一迭代修 3 条 P1:

# 问题 触发 后果
P1-1 取消/超时正好落在 Save 阶段时,会强杀正在保存的 cscript 用户在保存阶段点"当前项完成后停止",或活动超时 共享库上正在提交的 Save 被打断;随后证据还会记成"已安全释放"
P1-2 管理 worker 没有 supervisor watchdog,也不读取消文件 GUI 崩溃 / 被任务管理器结束 python worker + LibraryManager + CbbManagement_* 私有桌面永久残留,释放永远无法确认
P1-3 状态刷新会启动生产库的私有桌面 LM 并自动应答对话框 普通"读取 CBB" 一次只读刷新可能触发原生提示并被自动点"是/打开/恢复"

P1-1 取消/超时落在保存阶段会强杀正在 Save 的 cscript

证据链(我逐行读过)

  1. 保存阶段在 worker 内:mentor_adapter.py:820-827 发 save_start,用 launch_save_helper 起 SysWOW64\cscript.exe save_verified_block.vbs(该 VBS 执行 doc.Validate → doc.Save() → IsSaved → Close)。
  2. 等待循环 :830-841 里,一旦发现取消信号就 raise RuntimeError('VERIFY_CANCELLED: 已停止等待保存客户端') —— 直接放弃等待,不等待也不结束 helper。
  3. :876-889 的 finally 只 emit(stage='save_helper_retained'),不等待 helper。
  4. supervisor 侧 verify_runner.py:943-947(用户取消)或 :1059/:1082(超时)调用 _stop_worker(process)。
  5. _stop_worker(:230-252):request_stop() → wait(5) → 无论 worker 是否已合作退出,最后都会执行 process.stop_automation_clients()。
  6. DesktopWorker.stop_automation_clients()(desktop_worker.py:182-185)→ _save_clients()(按 parent == worker.pid + vbs 路径识别 cscript)→ _terminate_pid → taskkill /F。

为什么这是 P1

  • 界面在同一操作上承诺的是"原生写入只等待安全结束,不强制终止"(ui/main_window.py:1514),实现与该承诺相反。
  • 被 taskkill /F 的是一个正在执行 doc.Save() 的 COM 自动化客户端;按代码自己的注释(desktop_worker.py:182、watchdog docstring),这会"放弃正在进行的原生调用"。对共享中心库,这意味着一次保存被截断在 PCB/iCDB 侧。
  • 更糟的是证据会记成安全:automation_release_state() 在 _stop_worker 之后才取(verify_runner.py:1134-1135),此时 helper 已被杀 → remaining=[] → safe_to_continue=True → 写进 session-release.json,再被 _run_verify_serialized:700-701 用来把结果改成 safe_to_continue=True,最后落到 result.json(:748-749)。

关键旁证(这条最说明问题):仓库里已经有一条测试锁定的协议——tests/test_failure_lifecycle.py:258 test_cooperative_supervisor_loss_keeps_pending_save_helper_alive 断言"监督器合作式消失时,挂起的保存 helper 必须继续存活"(断言其退出码仍是 259)。也就是说:监管者死掉时工具选择"让保存跑完",而用户点停止时却直接把保存杀掉——策略正好反了。修 P1-1 不需要新设计,只需要让取消路径遵守这条已被测试固定的规则。

建议:save_start 之后,取消/超时只做"有界等待"(例如 120s),并按 SAVE_OK 是否出现记录 save_committed: true/false;automation_release_state() 必须在终止任何客户端之前采样并落盘;只有用户在二次确认框里明确选择"放弃本次保存"时才允许结束 helper,同时把 save_helper_terminated=true 与 safe_to_continue=false 一起写进证据。

P1-2 管理 worker 没有 supervisor watchdog,也不响应取消

  • start_supervisor_watchdog 全仓只有两处:mentor_adapter.py:1005(verify worker,stop_clients=True)与 native_repair_ui.py:291(repair worker)。
  • 管理 worker 由 native_management.py:192-244 启动(DesktopWorker(... '--management-worker' ...)),没有 armed watchdog,循环里也不检查取消文件;只有 add 类超时后才 touch cancel-native-add.signal(:231)。
  • 后果:supervisor 被结束(崩溃、任务管理器、断电前强杀)时,管理 worker + 它启动的 LibraryManager.exe + CbbManagement_* 桌面会一直留在那里;_retained_workers(:23)只是内存列表,进程一死就丢失;release_confirmed 需要那个挂住的 worker 自己写 safe_to_continue=true,永不成立;全仓没有 CloseDesktop/DeleteDesktop 的清理路径,只能靠 residual_sessions 人工观察(而私有桌面上的窗口人看不到,见 #12 的 P3-2)。
  • 建议:管理 worker 同样 armed watchdog(stop_clients=False 即可,保持"不杀原生库 owner"的语义),把桌面名写进库外 checkpoint,下次启动时枚举并清理上次残留的私有桌面。

P1-3 只读状态刷新会启动生产库的私有桌面 LM,并对对话框"positive-first"

  • 路径:ui/main_window.py:126 把 status_reader=scan_open_library_status 接进 read_library_fast;library_reader.py:340-344 在没有已打开 LM 窗口时回退到 read_library_tree_image_map。
  • read_library_tree_image_map(mentor_adapter.py:1532+)会 CreateDesktop + CreateProcess 打开生产 .lmc,轮询里调用 handle_known_dialogs。
  • choose_dialog_action(:352-377):仅对 "database restoration / restore database + last user saved / 数据库恢复 / continue to open with read/write / confirm that no other users have the design open" 这些家族返回 None(不点);其余一律 positive-first(yes/ok/continue/retry/restore/open/use/load/是/确定/继续/重试/恢复/打开/使用/加载),未知对话框还会走 fallback 点第一个非否按钮。
  • 后果:一次"读取 CBB"就可能触发原生提示并被自动应答;如果出现未列入屏蔽词的提示(例如某个"是否修复/是否覆盖"变体),工具会在操作员不知情的情况下替他做出写操作决定。
  • 建议:状态刷新期间把应答策略改成 deny-by-default(只点明确白名单里的只读类按钮,未知一律不点并把该 CBB 标成 UNKNOWN/PENDING 提示人工处理);或在状态刷新路径完全禁止启动原生进程(提示"请手动打开 Library Manager 后重试")。

P2(建议排期)

  1. auto_repair 之后的复验丢失 stop:verify_runner.py:595(attempt_recovery 未传 stop)与 :617-620(复验未传 stop=stop)→ 用户点停止后,修复完成后仍会跑完一整次校验;CLI 的 run_batch 默认 verifier 同样不转发 stop(:1247-1248)。我已核实 :617-620。
  2. verify 写路径的空闲证明弱于管理路径:mentor_adapter.py:612-617 只检查本机 ExpeditionPCB.exe 且要求精确路径参数;写前不做 _idle_check(backup_recovery.py:31-56:5 类原生进程 + sAddress.adr + 对 .lmc/LayoutDB.lyt/icdb.dat 的独占句柄),prepare_icdb_address(mentor_adapter.py:1090)在生产代码中零调用。跨会话/跨机器的真人 Mentor 会话因此可能与本工具并发写同一 CBB。
  3. "身份未知"被当成"不是目标":is_reusable_circuit_pcb(:237-245)在 ExecutablePath/CommandLine 为空时返回 False(放行),而同库的 _native_scope_match(backup_recovery.py:59-80)对同样情况返回 None(阻断)。建议改为三态并使用保守语义。
  4. pcb.prj 重写缺少写前复核与语义区分:ensure_project_central_library(:108-162)读→写之间不重读比对;updated == original 一律发 MATCH,把"键不存在/编码不支持/已对齐"混为一谈;调用点 :700-706 丢弃返回值。我已核实这三点。
  5. UIA 探针线程无界:dialog_probe.py:28-44 每次调用新建线程,超时只放弃等待(daemon 线程继续卡在 UIA 里),而 supervisor 每 200ms 轮询一次 capture_one(:242、verify_runner.py:1094)→ 长批次下线程数单调增长,且 COM 公寓混用(测试日志里每次都能看到 Revert to STA COM threading mode)。建议改为常驻单线程 + 任务队列 + 可取消调用。
  6. 失败路径没有写前内容基线:verify 路径不调用 build_manifest/identity,一次中途失败的 Save 之后无法从证据回答"这个 CBB 是否被写过"。
  7. Add 路径改写库内 .prj 时不保留 before 字节:native_management.py:345-363 → _align_library → ensure_project_central_library(evidence_dir=None),只在 reference-alignment.json 里留哈希。
  8. Save 与 Close 被合成一个布尔门:save_verified_block.vbs 在 Save 成功后仍有 POST_SAVE_CHECK/IsSaved/Close 三段可能失败,而 Python 侧只看到"核心标记不全",无法区分"已提交但关闭失败"与"根本没写";VBS 退出码也没有原因文本。

P3

  • _reload_after_maintenance 从不置 True(#11 遗留死字段);best_effort_backup/build_backup_command/backup_timeout_seconds 在生产代码中已无调用者(只在测试里);cleanup_verify_processes 的 tracked 不含 cscript 保存客户端(verify 路径靠 automation_release_state 兜底,其它调用方没有)。
  • 测试缺口:_bounded_call 的线程/超时、管理 worker 的监督器、队列 action 抛异常与 FIFO、kill() 短路、证据写一半、auto_repair 的 stop 传播。

验证记录

  • 以上 file:line 均由我逐条读过源码确认;P2-2/P2-3/P2-4 与子代理的报告交叉核对一致。
  • 子代理在串行条件下跑过单文件测试:test_integration.py 43 passed、test_desktop_worker.py 12 passed、test_operation_queue+test_status_bridge 10 passed、test_batch_status_faults 4 passed;跑前都确认了没有其它 pytest 进程(避免 Local\CbbRefreshVerify795 争用)。
  • 本轮我未再跑全量:上一轮已做过四个 PR 的独占全量(491/1376/1545/1601 passed)。

未验证边界

  • 没有在真实 Mentor/共享库上制造"保存中途取消",因此 P1-1 的实际数据后果(PCB 侧是否留下半写状态)是推断,不是实测;但其触发路径是代码级的,可以确定会被执行到。
  • 跨机器并发写(P2-2)是否会被 Mentor 自身的文件锁挡住,未验证。
  • P1-2 的残留是"进程/桌面"层面的可复现推断(watchdog 缺失是确定事实),没有在崩溃场景下实测残留时长。
# 深度审查:CBB Verify 工具(链路顶端 `dc536da`,含 main 既有代码) 范围:在完成 #9–#12 逐片审查后,继续对**工具本身的运行时行为**做深审,不再只看 diff:`verify_runner.py`(1331)、`mentor_adapter.py`(1636)、`desktop_worker.py`、`native_management.py`、`library_reader.py`、`dialog_probe.py`、`backup_recovery.py`。 ## 结论 **不阻塞 #9–#12 合并**(下面多是 main 就有的深层问题,拆分链没有引入新回归),但建议在下一迭代修 **3 条 P1**: | # | 问题 | 触发 | 后果 | | --- | --- | --- | --- | | P1-1 | 取消/超时正好落在 Save 阶段时,会**强杀正在保存的 cscript** | 用户在保存阶段点"当前项完成后停止",或活动超时 | 共享库上正在提交的 Save 被打断;随后证据还会记成"已安全释放" | | P1-2 | 管理 worker **没有 supervisor watchdog**,也不读取消文件 | GUI 崩溃 / 被任务管理器结束 | python worker + LibraryManager + `CbbManagement_*` 私有桌面永久残留,释放永远无法确认 | | P1-3 | 状态刷新会**启动生产库的私有桌面 LM 并自动应答对话框** | 普通"读取 CBB" | 一次只读刷新可能触发原生提示并被自动点"是/打开/恢复" | --- ## P1-1 取消/超时落在保存阶段会强杀正在 Save 的 cscript **证据链(我逐行读过)** 1. 保存阶段在 worker 内:`mentor_adapter.py:820-827` 发 `save_start`,用 `launch_save_helper` 起 `SysWOW64\cscript.exe save_verified_block.vbs`(该 VBS 执行 `doc.Validate → doc.Save() → IsSaved → Close`)。 2. 等待循环 `:830-841` 里,一旦发现取消信号就 **`raise RuntimeError('VERIFY_CANCELLED: 已停止等待保存客户端')`** —— 直接放弃等待,**不等待也不结束 helper**。 3. `:876-889` 的 `finally` 只 `emit(stage='save_helper_retained')`,不等待 helper。 4. supervisor 侧 `verify_runner.py:943-947`(用户取消)或 `:1059`/`:1082`(超时)调用 `_stop_worker(process)`。 5. `_stop_worker`(`:230-252`):`request_stop()` → `wait(5)` → **无论 worker 是否已合作退出,最后都会执行 `process.stop_automation_clients()`**。 6. `DesktopWorker.stop_automation_clients()`(`desktop_worker.py:182-185`)→ `_save_clients()`(按 `parent == worker.pid` + vbs 路径识别 cscript)→ `_terminate_pid` → **`taskkill /F`**。 **为什么这是 P1** - 界面在同一操作上承诺的是"**原生写入只等待安全结束,不强制终止**"(`ui/main_window.py:1514`),实现与该承诺相反。 - 被 `taskkill /F` 的是一个**正在执行 `doc.Save()` 的 COM 自动化客户端**;按代码自己的注释(`desktop_worker.py:182`、watchdog docstring),这会"放弃正在进行的原生调用"。对共享中心库,这意味着一次保存被截断在 PCB/iCDB 侧。 - 更糟的是**证据会记成安全**:`automation_release_state()` 在 `_stop_worker` 之后才取(`verify_runner.py:1134-1135`),此时 helper 已被杀 → `remaining=[]` → `safe_to_continue=True` → 写进 `session-release.json`,再被 `_run_verify_serialized:700-701` 用来把结果改成 `safe_to_continue=True`,最后落到 `result.json`(`:748-749`)。 **关键旁证(这条最说明问题)**:仓库里已经有一条**测试锁定的协议**——`tests/test_failure_lifecycle.py:258 test_cooperative_supervisor_loss_keeps_pending_save_helper_alive` 断言"监督器合作式消失时,挂起的保存 helper 必须**继续存活**"(断言其退出码仍是 259)。也就是说:**监管者死掉**时工具选择"让保存跑完",而**用户点停止**时却直接把保存杀掉——策略正好反了。修 P1-1 不需要新设计,只需要让取消路径遵守这条已被测试固定的规则。 **建议**:`save_start` 之后,取消/超时只做"有界等待"(例如 120s),并按 `SAVE_OK` 是否出现记录 `save_committed: true/false`;`automation_release_state()` 必须在终止任何客户端**之前**采样并落盘;只有用户在二次确认框里明确选择"放弃本次保存"时才允许结束 helper,同时把 `save_helper_terminated=true` 与 `safe_to_continue=false` 一起写进证据。 ## P1-2 管理 worker 没有 supervisor watchdog,也不响应取消 - `start_supervisor_watchdog` 全仓只有两处:`mentor_adapter.py:1005`(verify worker,`stop_clients=True`)与 `native_repair_ui.py:291`(repair worker)。 - 管理 worker 由 `native_management.py:192-244` 启动(`DesktopWorker(... '--management-worker' ...)`),**没有 armed watchdog**,循环里也不检查取消文件;只有 add 类超时后才 `touch cancel-native-add.signal`(`:231`)。 - 后果:supervisor 被结束(崩溃、任务管理器、断电前强杀)时,管理 worker + 它启动的 `LibraryManager.exe` + `CbbManagement_*` 桌面会一直留在那里;`_retained_workers`(`:23`)只是**内存列表**,进程一死就丢失;`release_confirmed` 需要那个挂住的 worker 自己写 `safe_to_continue=true`,永不成立;全仓没有 `CloseDesktop/DeleteDesktop` 的清理路径,只能靠 `residual_sessions` 人工观察(而私有桌面上的窗口人看不到,见 #12 的 P3-2)。 - 建议:管理 worker 同样 armed watchdog(`stop_clients=False` 即可,保持"不杀原生库 owner"的语义),把桌面名写进库外 checkpoint,下次启动时枚举并清理上次残留的私有桌面。 ## P1-3 只读状态刷新会启动生产库的私有桌面 LM,并对对话框"positive-first" - 路径:`ui/main_window.py:126` 把 `status_reader=scan_open_library_status` 接进 `read_library_fast`;`library_reader.py:340-344` 在**没有已打开 LM 窗口**时回退到 `read_library_tree_image_map`。 - `read_library_tree_image_map`(`mentor_adapter.py:1532+`)会 `CreateDesktop` + `CreateProcess` 打开**生产 `.lmc`**,轮询里调用 `handle_known_dialogs`。 - `choose_dialog_action`(`:352-377`):仅对 "database restoration / restore database + last user saved / 数据库恢复 / continue to open with read/write / confirm that no other users have the design open" 这些家族返回 `None`(不点);**其余一律 positive-first**(`yes/ok/continue/retry/restore/open/use/load/是/确定/继续/重试/恢复/打开/使用/加载`),未知对话框还会走 `fallback` 点第一个非否按钮。 - 后果:一次"读取 CBB"就可能触发原生提示并被自动应答;如果出现未列入屏蔽词的提示(例如某个"是否修复/是否覆盖"变体),工具会在操作员不知情的情况下替他做出写操作决定。 - 建议:状态刷新期间把应答策略改成 **deny-by-default**(只点明确白名单里的只读类按钮,未知一律不点并把该 CBB 标成 `UNKNOWN`/`PENDING` 提示人工处理);或在状态刷新路径完全禁止启动原生进程(提示"请手动打开 Library Manager 后重试")。 --- ## P2(建议排期) 1. **`auto_repair` 之后的复验丢失 `stop`**:`verify_runner.py:595`(`attempt_recovery` 未传 stop)与 `:617-620`(复验未传 `stop=stop`)→ 用户点停止后,修复完成后仍会跑完一整次校验;CLI 的 `run_batch` 默认 verifier 同样不转发 stop(`:1247-1248`)。**我已核实 `:617-620`。** 2. **verify 写路径的空闲证明弱于管理路径**:`mentor_adapter.py:612-617` 只检查本机 `ExpeditionPCB.exe` 且要求精确路径参数;写前不做 `_idle_check`(`backup_recovery.py:31-56`:5 类原生进程 + `sAddress.adr` + 对 `.lmc`/`LayoutDB.lyt`/`icdb.dat` 的独占句柄),`prepare_icdb_address`(`mentor_adapter.py:1090`)在生产代码中零调用。跨会话/跨机器的真人 Mentor 会话因此可能与本工具并发写同一 CBB。 3. **"身份未知"被当成"不是目标"**:`is_reusable_circuit_pcb`(`:237-245`)在 `ExecutablePath/CommandLine` 为空时返回 `False`(放行),而同库的 `_native_scope_match`(`backup_recovery.py:59-80`)对同样情况返回 `None`(阻断)。建议改为三态并使用保守语义。 4. **`pcb.prj` 重写缺少写前复核与语义区分**:`ensure_project_central_library`(`:108-162`)读→写之间不重读比对;`updated == original` 一律发 `MATCH`,把"键不存在/编码不支持/已对齐"混为一谈;调用点 `:700-706` 丢弃返回值。**我已核实这三点。** 5. **UIA 探针线程无界**:`dialog_probe.py:28-44` 每次调用新建线程,超时只放弃等待(daemon 线程继续卡在 UIA 里),而 supervisor 每 200ms 轮询一次 `capture_one`(`:242`、`verify_runner.py:1094`)→ 长批次下线程数单调增长,且 COM 公寓混用(测试日志里每次都能看到 `Revert to STA COM threading mode`)。建议改为常驻单线程 + 任务队列 + 可取消调用。 6. **失败路径没有写前内容基线**:verify 路径不调用 `build_manifest`/`identity`,一次中途失败的 Save 之后无法从证据回答"这个 CBB 是否被写过"。 7. **Add 路径改写库内 `.prj` 时不保留 before 字节**:`native_management.py:345-363` → `_align_library` → `ensure_project_central_library(evidence_dir=None)`,只在 `reference-alignment.json` 里留哈希。 8. **Save 与 Close 被合成一个布尔门**:`save_verified_block.vbs` 在 `Save` 成功后仍有 `POST_SAVE_CHECK`/`IsSaved`/`Close` 三段可能失败,而 Python 侧只看到"核心标记不全",无法区分"已提交但关闭失败"与"根本没写";VBS 退出码也没有原因文本。 ## P3 - `_reload_after_maintenance` 从不置 True(#11 遗留死字段);`best_effort_backup`/`build_backup_command`/`backup_timeout_seconds` 在生产代码中已无调用者(只在测试里);`cleanup_verify_processes` 的 `tracked` 不含 cscript 保存客户端(verify 路径靠 `automation_release_state` 兜底,其它调用方没有)。 - 测试缺口:`_bounded_call` 的线程/超时、管理 worker 的监督器、队列 action 抛异常与 FIFO、`kill()` 短路、证据写一半、auto_repair 的 stop 传播。 ## 验证记录 - 以上 `file:line` 均由我逐条读过源码确认;P2-2/P2-3/P2-4 与子代理的报告交叉核对一致。 - 子代理在**串行**条件下跑过单文件测试:`test_integration.py` 43 passed、`test_desktop_worker.py` 12 passed、`test_operation_queue+test_status_bridge` 10 passed、`test_batch_status_faults` 4 passed;跑前都确认了没有其它 pytest 进程(避免 `Local\CbbRefreshVerify795` 争用)。 - 本轮我未再跑全量:上一轮已做过四个 PR 的独占全量(491/1376/1545/1601 passed)。 ## 未验证边界 - 没有在真实 Mentor/共享库上制造"保存中途取消",因此 P1-1 的**实际数据后果**(PCB 侧是否留下半写状态)是推断,不是实测;但其触发路径是代码级的,可以确定会被执行到。 - 跨机器并发写(P2-2)是否会被 Mentor 自身的文件锁挡住,未验证。 - P1-2 的残留是"进程/桌面"层面的可复现推断(watchdog 缺失是确定事实),没有在崩溃场景下实测残留时长。
Author
Owner

深审补充:备份 / 恢复路径(P2×2 + P3×3)

对象:backup_recovery.py(recover_from_backup 全函数 144-295)、ui/backup_recovery_dialog.py、reimport_recovery.py(确认不共用 Work 替换逻辑)。

结论

这条路径可以合并。 它的总体设计比工具里其它写路径更保守,而且几处关键防线是对的:

  • 源备份全程只读:没有移动/删除/改写源工程任何文件的路径(我逐行确认)。
  • 先在 ~/.cbb-restore/<token> 的隔离库副本里把备份校验成 PASS + GREEN 才动目标(237-249)。
  • 安装前重新计算源 manifest 与**库 manifest(排除 incoming)**并与最初记录比对,变了就停止(260-263)——这是真正的 TOCTOU 防护,比大多数同类工具都严。
  • 安装用同卷 rename(保留原 Work → 放入新 Work),第二步失败会回滚第一步(265-270)。
  • 原 Work 改名保留而不是删除(Work.before-restore-<token>)。

需要修的是替换瞬间的可恢复性和最后一段空闲证明。

P2-1 两个 rename 之间没有持久化阶段记录,崩溃后没有补完/回滚路径

  • 位置:backup_recovery.py:264-272。
    emit('install', '备份已通过验证,正在保留原工程并恢复…')
    work.rename(retained)
    try: incoming.rename(work)
    except Exception: retained.rename(work); raise
    installed = True
    record['retained_work'] = str(retained)
    
  • emit()(:173-175)只把进度发给 UI,不落盘;record 只在最后的 save()(:182-190)写 recovery-result.json,而 record['retained_work'] 要到 :272(两次 rename 之后)才有值。
  • 后果:进程若在 work.rename() 与 incoming.rename() 之间消失(崩溃、断电、任务管理器),磁盘上只有 Work.before-restore-<token> 和 Work.restore-<token>,没有 Work。下一次 preflight 会报"缺少或无法唯一确定 Work 下的工程 PRJ"(verify_runner.py:175-176,失败关闭是对的),但证据文件里没有任何字段指向被保留的目录,操作员得自己猜目录名才能改回去。
  • 建议:替换前先把 {stage: 'install', retained, incoming, time} 原子写入 recovery-result.json(或单独的 install-journal.json),替换完成后再追加 installed: true;UI 在启动/读取库时若发现 journal 停在 install 且 Work 缺失,直接提示"把 Work.before-restore-<token> 改名为 Work"这类可执行动作。

P2-2 最后一次空闲证明与替换之间隔了两次全量哈希

  • 位置:_idle_check 在 :259,之后 :260、:262 是两次 manifest 全量比对(大库上可到分钟级),:265 直接 rename。
  • _idle_check 的独占句柄在函数返回时就被 ExitStack 关掉了(backup_recovery.py:52-56),所以跨 rename 没有任何独占保护。
  • 后果(诚实版):
    • 最可能:窗口内起来的原生会话让 work.rename() 因共享冲突失败,异常向上抛,库没被改(安全),但报错是通用异常,操作员看不出"是因为有人打开了工程"。
    • 更糟:rename 成功而该会话此后把保存写进 Work.before-restore-*,用户看到的是"恢复成功,但我刚做的修改没了"。
  • 建议:把 _idle_check 里那三个独占句柄(.lmc / icdb.dat / LayoutDB.lyt)提升到 recover_from_backup 的 ExitStack,从 :259 一直持有到 :267;rename 前再补一次轻量检查(目标 PCB 进程 + 地址残留),并把检查结果写进 journal。

P3

  • 装进去的字节没有清单::256 的 _copy_verified(...) 返回值(incoming 的 manifest)被丢弃,:258 又对 incoming 改了一次 CentralLibrary。于是"被验证过的副本"和"实际装进去的内容"之间没有可比对的清单,恢复后无法证明安装树与校验树一致。
  • ~/.cbb-restore 不是可回滚的完整库副本::229-231 在验证副本里 rmtree 掉目标 Work 再用源替换(这一步只作用于隔离副本,不影响真实库,源备份也没被动过)。因此它只能证明"恢复后的库能通过校验",回滚源始终是 Work.before-restore-<token>。UI/文档不要把它描述成"完整库副本"。
  • 残留目录无清理策略:Work.before-restore-*、Work.restore-* 会永久累积(恢复失败时 incoming 也可能留在库里);建议成功恢复 N 天后可清理,并在报告里给出路径。
  • 测试覆盖:37 个用例全绿,但全部 stub 掉了 idle_check;崩溃窗口(rename 之间)、暂存残留、目标身份变化、PASS 但证据写失败这四类都没有用例。

验证记录

  • 读完 recover_from_backup 全函数(144-295);确认 emit 不落盘、record 只在 save() 落盘、_copy_verified 返回值未使用、:229-231 只作用于隔离副本。
  • 子代理跑了 tests/test_backup_recovery.py 等单文件测试:37 passed(串行执行,跑前确认无其它 pytest 占用 Local\CbbRefreshVerify795),并用 SystemExit 在两次 rename 之间模拟进程消失,复现了"没有 Work 目录 + 记录 installed:false"。
  • 未验证:真实断电/强杀场景;大库上两次 manifest 的实际耗时(只做了代码级的窗口推断)。
# 深审补充:备份 / 恢复路径(P2×2 + P3×3) 对象:`backup_recovery.py`(`recover_from_backup` 全函数 144-295)、`ui/backup_recovery_dialog.py`、`reimport_recovery.py`(确认不共用 Work 替换逻辑)。 ## 结论 **这条路径可以合并。** 它的总体设计比工具里其它写路径更保守,而且几处关键防线是对的: - 源备份**全程只读**:没有移动/删除/改写源工程任何文件的路径(我逐行确认)。 - 先在 `~/.cbb-restore/<token>` 的**隔离库副本**里把备份校验成 `PASS + GREEN` 才动目标(237-249)。 - 安装前重新计算**源 manifest** 与**库 manifest(排除 incoming)**并与最初记录比对,变了就停止(260-263)——这是真正的 TOCTOU 防护,比大多数同类工具都严。 - 安装用同卷 `rename`(保留原 Work → 放入新 Work),第二步失败会回滚第一步(265-270)。 - 原 Work 改名保留而不是删除(`Work.before-restore-<token>`)。 需要修的是**替换瞬间的可恢复性**和**最后一段空闲证明**。 ## P2-1 两个 rename 之间没有持久化阶段记录,崩溃后没有补完/回滚路径 - 位置:`backup_recovery.py:264-272`。 ```python emit('install', '备份已通过验证,正在保留原工程并恢复…') work.rename(retained) try: incoming.rename(work) except Exception: retained.rename(work); raise installed = True record['retained_work'] = str(retained) ``` - `emit()`(`:173-175`)只把进度发给 UI,**不落盘**;`record` 只在最后的 `save()`(`:182-190`)写 `recovery-result.json`,而 `record['retained_work']` 要到 `:272`(两次 rename 之后)才有值。 - 后果:进程若在 `work.rename()` 与 `incoming.rename()` 之间消失(崩溃、断电、任务管理器),磁盘上只有 `Work.before-restore-<token>` 和 `Work.restore-<token>`,**没有 `Work`**。下一次 `preflight` 会报"缺少或无法唯一确定 Work 下的工程 PRJ"(`verify_runner.py:175-176`,失败关闭是对的),但证据文件里没有任何字段指向被保留的目录,操作员得自己猜目录名才能改回去。 - 建议:替换前先把 `{stage: 'install', retained, incoming, time}` 原子写入 `recovery-result.json`(或单独的 `install-journal.json`),替换完成后再追加 `installed: true`;UI 在启动/读取库时若发现 journal 停在 install 且 `Work` 缺失,直接提示"把 `Work.before-restore-<token>` 改名为 `Work`"这类可执行动作。 ## P2-2 最后一次空闲证明与替换之间隔了两次全量哈希 - 位置:`_idle_check` 在 `:259`,之后 `:260`、`:262` 是两次 manifest 全量比对(大库上可到分钟级),`:265` 直接 rename。 - `_idle_check` 的独占句柄在函数返回时就被 `ExitStack` 关掉了(`backup_recovery.py:52-56`),所以**跨 rename 没有任何独占保护**。 - 后果(诚实版): - 最可能:窗口内起来的原生会话让 `work.rename()` 因共享冲突失败,异常向上抛,库没被改(安全),但报错是通用异常,操作员看不出"是因为有人打开了工程"。 - 更糟:rename 成功而该会话此后把保存写进 `Work.before-restore-*`,用户看到的是"恢复成功,但我刚做的修改没了"。 - 建议:把 `_idle_check` 里那三个独占句柄(`.lmc` / `icdb.dat` / `LayoutDB.lyt`)提升到 `recover_from_backup` 的 `ExitStack`,从 `:259` 一直持有到 `:267`;rename 前再补一次轻量检查(目标 PCB 进程 + 地址残留),并把检查结果写进 journal。 ## P3 - **装进去的字节没有清单**:`:256` 的 `_copy_verified(...)` 返回值(incoming 的 manifest)被丢弃,`:258` 又对 incoming 改了一次 `CentralLibrary`。于是"被验证过的副本"和"实际装进去的内容"之间没有可比对的清单,恢复后无法证明安装树与校验树一致。 - **`~/.cbb-restore` 不是可回滚的完整库副本**:`:229-231` 在验证副本里 `rmtree` 掉目标 Work 再用源替换(这一步只作用于隔离副本,**不影响真实库**,源备份也没被动过)。因此它只能证明"恢复后的库能通过校验",回滚源始终是 `Work.before-restore-<token>`。UI/文档不要把它描述成"完整库副本"。 - **残留目录无清理策略**:`Work.before-restore-*`、`Work.restore-*` 会永久累积(恢复失败时 `incoming` 也可能留在库里);建议成功恢复 N 天后可清理,并在报告里给出路径。 - **测试覆盖**:37 个用例全绿,但**全部 stub 掉了 `idle_check`**;崩溃窗口(rename 之间)、暂存残留、目标身份变化、`PASS` 但证据写失败这四类都没有用例。 ## 验证记录 - 读完 `recover_from_backup` 全函数(144-295);确认 `emit` 不落盘、`record` 只在 `save()` 落盘、`_copy_verified` 返回值未使用、`:229-231` 只作用于隔离副本。 - 子代理跑了 `tests/test_backup_recovery.py` 等单文件测试:37 passed(串行执行,跑前确认无其它 pytest 占用 `Local\CbbRefreshVerify795`),并用 `SystemExit` 在两次 rename 之间模拟进程消失,复现了"没有 Work 目录 + 记录 installed:false"。 - 未验证:真实断电/强杀场景;大库上两次 manifest 的实际耗时(只做了代码级的窗口推断)。
Author
Owner

测试质量审计(链路顶端 dc536da)+ 对上一条 P1-1 的精确化

结论

测试文化整体是好的:以证据/行为断言为主,不用 mock 调用断言。但存在一类系统性盲区——把被测的守卫本身 stub 掉,导致"守卫失效"永远不会被测出来。

量化

指标 数值 解读
测试文件 / 行数 / 用例 84 / 15,187 / 958 规模合理
assert_called* 类断言 0 没有"验证调用"式的空断言,这点值得表扬
断言涉及 evidence/result.json/session-release 457 处 主要是行为与证据断言
真实 subprocess/Popen(跑真 VBS、真 worker) 31 处 有真实端到端用例,不是全 mock
monkeypatch.setattr 875 处 接缝注入多
其中替换 idle_check 29 处 / 4 个文件 盲区:backup_recovery、management 的关键用例都把空闲证明换掉了

盲区一:守卫被 stub 掉,守卫坏掉测不出来

  • tests/test_backup_recovery.py、test_management.py、test_management_native_transaction.py、test_management_retry_blockers.py 里共 29 处把 idle_check(或等价守卫)替换成 no-op。
  • 后果:如果有人把 _idle_check 改坏、或某条写路径漏调它(例如我上一条报告里 verify 写路径根本没用它),现有 958 个用例全部仍然通过。
  • 建议:为"漏调守卫"补反向用例——用一个真实的 _idle_check + 一个假的占用进程/假 sAddress.adr,断言写路径抛 TARGET_NATIVE_OWNER_ACTIVE/TARGET_DATABASE_ADDRESS_UNCONFIRMED;并加一条"所有写路径都必须调用 _idle_check"的结构测试(例如扫描 execute_job/recover_from_backup/_add_transaction 的调用图)。

盲区二:关键崩溃/竞争窗口没有用例

  • 恢复路径两次 rename 之间(backup_recovery.py:265-267)的崩溃窗口:无用例;子代理用 SystemExit 在真实代码点模拟才复现出"没有 Work 目录"。
  • 管理 worker 的监督器缺失、私有桌面残留:无用例(test_desktop_worker.py 只覆盖了 verify/repair 的 watchdog)。
  • UIA 探针超时后的线程残留:无用例。
  • session-release.json 与最终 result.json 的一致性("先杀后采样"会写错):无用例。

盲区三:_stop_worker 的"取消→终止"只有 worker 级用例

  • tests/test_failure_lifecycle.py:123 test_cancel_after_native_save_returns_stops_later_native_operations 跑真 VBS,证明了 VBS 自己在 Save 返回后会拒绝 Close 并以 9 退出——这很好。
  • tests/test_failure_lifecycle.py:203 test_stop_cancels_then_stops_automation_client_after_deadline 断言 _stop_worker 在等待超时后会 kill。
  • 但没有任何用例覆盖"保存仍在进行时,supervisor 侧把 helper 结束掉"这条路径,也没有断言这种情况下 session-release.json 应该写什么。

对上一条 P1-1 的精确化(重要,避免误伤作者)

我在评论 297 里说"取消会强杀正在 Save 的 cscript"。补充两点更准确的事实:

  1. 这是有意的策略,而且有 worker 级用例(test_stop_cancels_then_stops_automation_client_after_deadline)。所以问题不是"写错了",而是策略与表述/其它路径不一致:
    • 同一仓库的 test_cooperative_supervisor_loss_keeps_pending_save_helper_alive(:258)锁定的是"监督器消失时保存 helper 必须存活";
    • 界面文案写的是"原生写入只等待安全结束,不强制终止"(ui/main_window.py:1514)。
  2. 真正需要修的两点(与策略无关):
    • automation_release_state() 在 _stop_worker 之后才采样(verify_runner.py:1131-1135),因此"被我们杀掉的 helper"不会出现在 remaining_pids 里,session-release.json 会写 safe_to_continue: true;应改为先采样、再决定是否终止,并把 save_helper_terminated 作为独立字段落盘。
    • 无法区分"Save 已提交、只是 Close 失败"与"根本没写":VBS 已有 SAVE_OK 标记,Python 侧应单独记 save_committed: true/false,而不是与 CLOSE_OK 合在一个布尔门里(save_verified_block.vbs + mentor_adapter.py:846-851)。

建议的补测优先级

  1. _stop_worker 在"保存进行中"时的采样顺序与证据字段(P1-1 的修复必须有对应用例)。
  2. 恢复路径 rename 前后的 journal 与崩溃补完。
  3. 管理 worker 的 watchdog/取消。
  4. "所有写路径都调用空闲证明"的结构测试。
  5. UIA 探针的线程上限/取消。
# 测试质量审计(链路顶端 `dc536da`)+ 对上一条 P1-1 的精确化 ## 结论 测试文化整体是**好**的:以证据/行为断言为主,不用 mock 调用断言。但存在一类系统性盲区——**把被测的守卫本身 stub 掉**,导致"守卫失效"永远不会被测出来。 ## 量化 | 指标 | 数值 | 解读 | | --- | --- | --- | | 测试文件 / 行数 / 用例 | 84 / 15,187 / 958 | 规模合理 | | `assert_called*` 类断言 | **0** | 没有"验证调用"式的空断言,这点值得表扬 | | 断言涉及 evidence/`result.json`/`session-release` | 457 处 | 主要是行为与证据断言 | | 真实 `subprocess`/`Popen`(跑真 VBS、真 worker) | 31 处 | 有真实端到端用例,不是全 mock | | `monkeypatch.setattr` | 875 处 | 接缝注入多 | | 其中替换 `idle_check` | 29 处 / 4 个文件 | **盲区**:`backup_recovery`、`management` 的关键用例都把空闲证明换掉了 | ## 盲区一:守卫被 stub 掉,守卫坏掉测不出来 - `tests/test_backup_recovery.py`、`test_management.py`、`test_management_native_transaction.py`、`test_management_retry_blockers.py` 里共 29 处把 `idle_check`(或等价守卫)替换成 no-op。 - 后果:如果有人把 `_idle_check` 改坏、或某条写路径漏调它(例如我上一条报告里 verify 写路径根本没用它),现有 958 个用例**全部仍然通过**。 - 建议:为"漏调守卫"补**反向用例**——用一个真实的 `_idle_check` + 一个假的占用进程/假 `sAddress.adr`,断言写路径抛 `TARGET_NATIVE_OWNER_ACTIVE`/`TARGET_DATABASE_ADDRESS_UNCONFIRMED`;并加一条"所有写路径都必须调用 `_idle_check`"的结构测试(例如扫描 `execute_job`/`recover_from_backup`/`_add_transaction` 的调用图)。 ## 盲区二:关键崩溃/竞争窗口没有用例 - 恢复路径两次 `rename` 之间(`backup_recovery.py:265-267`)的崩溃窗口:无用例;子代理用 `SystemExit` 在真实代码点模拟才复现出"没有 Work 目录"。 - 管理 worker 的监督器缺失、私有桌面残留:无用例(`test_desktop_worker.py` 只覆盖了 verify/repair 的 watchdog)。 - UIA 探针超时后的线程残留:无用例。 - `session-release.json` 与最终 `result.json` 的一致性("先杀后采样"会写错):无用例。 ## 盲区三:`_stop_worker` 的"取消→终止"只有 worker 级用例 - `tests/test_failure_lifecycle.py:123 test_cancel_after_native_save_returns_stops_later_native_operations` 跑真 VBS,证明了 **VBS 自己在 Save 返回后**会拒绝 Close 并以 9 退出——这很好。 - `tests/test_failure_lifecycle.py:203 test_stop_cancels_then_stops_automation_client_after_deadline` 断言 `_stop_worker` 在等待超时后会 `kill`。 - 但**没有**任何用例覆盖"保存仍在进行时,supervisor 侧把 helper 结束掉"这条路径,也没有断言这种情况下 `session-release.json` 应该写什么。 ## 对上一条 P1-1 的精确化(重要,避免误伤作者) 我在评论 297 里说"取消会强杀正在 Save 的 cscript"。补充两点更准确的事实: 1. **这是有意的策略**,而且有 worker 级用例(`test_stop_cancels_then_stops_automation_client_after_deadline`)。所以问题不是"写错了",而是**策略与表述/其它路径不一致**: - 同一仓库的 `test_cooperative_supervisor_loss_keeps_pending_save_helper_alive`(`:258`)锁定的是"监督器消失时保存 helper 必须存活"; - 界面文案写的是"原生写入只等待安全结束,不强制终止"(`ui/main_window.py:1514`)。 2. **真正需要修的两点**(与策略无关): - `automation_release_state()` 在 `_stop_worker` **之后**才采样(`verify_runner.py:1131-1135`),因此"被我们杀掉的 helper"不会出现在 `remaining_pids` 里,`session-release.json` 会写 `safe_to_continue: true`;应改为**先采样、再决定是否终止**,并把 `save_helper_terminated` 作为独立字段落盘。 - 无法区分"Save 已提交、只是 Close 失败"与"根本没写":VBS 已有 `SAVE_OK` 标记,Python 侧应单独记 `save_committed: true/false`,而不是与 `CLOSE_OK` 合在一个布尔门里(`save_verified_block.vbs` + `mentor_adapter.py:846-851`)。 ## 建议的补测优先级 1. `_stop_worker` 在"保存进行中"时的采样顺序与证据字段(P1-1 的修复必须有对应用例)。 2. 恢复路径 rename 前后的 journal 与崩溃补完。 3. 管理 worker 的 watchdog/取消。 4. "所有写路径都调用空闲证明"的结构测试。 5. UIA 探针的线程上限/取消。
Author
Owner

深审补充 3:修复链 + 对话框自动应答 / 状态桥

一、修复链(native_repair.py / icdb_recovery.py / maintenance_entry.py / failed_session.py)

结论:没有 P1——因为整条修复链在生产路径上不可达

我逐个核对调用关系:

  • auto_repair 默认 False(verify_runner.py:82),全仓没有任何 auto_repair=True(grep 为零);UI 与恢复路径四处都显式传 False(ui/main_window.py:787、:1225、backup_recovery.py:238、:276)。
  • 唯一真正调用 run_native_repair 的 maintenance_entry.run_existing_address_maintenance(:342-451)只被 run_diagnosed_maintenance(:293)调用,而 run_diagnosed_maintenance 零调用者。
  • 用户能点到的"ICDB 批量检查"走的是 run_icdb_check(:226-290):纯只读、automatic_repair: False,发现错误只报 ICDB_REPAIR_REQUIRED、明确"未执行修复"(:278-281)。

所以 native_repair.py 这 310 行目前是只有测试在跑的死代码。建议在文件头与 README 明确写"保留入口,未接线",或干脆删除——否则读者会以为工具会自动做原生 Repair(而 README:14 已明确"不自动 Repair",两边一致,只是代码会误导人)。

这条链本身写得很好(值得保留,将来接线时直接用)

  • select_repair_target(:20-40):只接受 scope=project;报错数据库必须解析到当前工程的 database 且含 icdb.dat,否则 REPAIR_TARGET_UNCONFIRMED——不猜路径。
  • attempt_recovery(:127-165):attempt.json 用 open('x') 做一次一标记,重复即 REPAIR_ALREADY_ATTEMPTED;启动前要求无任何 PCB/Library Manager、无引用该工程的 cscript 保存助手(:147-152)。
  • repair_release_state(:212-252):原生已退出 + 无 owner + 无 sAddress.adr + 对 icdb.dat 独占句柄,缺一即 safe_to_continue=False。
  • run_native_repair:超时不杀 worker,只 request_stop() 并返回 TIMEOUT_UNRELEASED / safe_to_continue=False(:298-302);DesktopWorker.close() 也明确不使用 kill-on-close(desktop_worker.py:84-86 注释),只终止 companion——和 verify 路径"取消就杀"的做法形成鲜明对比,这才是应有的策略。
  • icdb_recovery.parse_session_loss:保留原生消息原文、按 path 推断 scope、拒绝推断目标;_read_log_delta 用 tail 哈希区分"追加"与"重写",不会把旧日志当本次失败(:110-134、:148-164)。

P3

  1. backup_project(native_repair.py:64-124,全树备份 + 逐文件哈希 + 备份期间独占 icdb.dat + 检测源文件变化)在生产代码中零调用,只有测试用;不要让人误以为 Repair 前会自动做完整备份(UI 文案"应用不自动备份"是对的)。
  2. attempt_recovery 的"任何 PCB 进程存在即拒绝"(:148-149)与 verify 路径"无关工程可以开着"(mentor_adapter.py:609-610)矛盾:应改成 scoped 匹配(_native_scope_match / _idle_check 已有的能力),否则现场开着别的设计就永远修不了。
  3. maintenance_entry.py:391-392 的 owner_safe = A or B and C 依赖 and 优先级,建议加括号(可读性)。

二、对话框自动应答 / 状态桥

P2-1 dialog_agent 通道一次超时后可能永久错位

  • JsonChannel.receive(dialog_agent.py:74-88)在超时时抛出,buffer 里可能残留半条/迟到的响应;_request(:482-503)在异常后不重置通道,下一次请求用新的 request_id,而 receive 先读到的是上一条残留响应 → 响应 request_id 不匹配 → 抛协议错误;真正的响应又留在 socket 里,形成错位级联,此后每次 poll 都失败,整项直接 FAIL。
  • 建议:任何协议错误都清空 buffer 并重新握手,或直接重建 dialog-agent 子进程;同时把 sequence 不匹配与 request_id 不匹配区分成可恢复/不可恢复两类。

P2-2 生产路径上还有第二套 positive-first 应答器,且规则可被配置静默放宽

  • mentor_adapter.py:352-377 的 choose_dialog_action 只对 database restoration 等几个家族返回"不点",其余一律 positive-first(含 restore/open/use/load/是/确定/恢复/打开),未知对话框还会走 fallback 点第一个非否定按钮;:1491、:1573 的 handle_known_dialogs 在生产路径上被状态读取调用(见上一条评论 P1-3)。
  • dialog_rules.py:119-138(load_rules + raw_by_id[rule_id].update(override))的 override 直接覆盖默认规则,且 action(:84)、target 都没有白名单:现场一个写错的 JSON 就能把"本来不点的规则"改成"点",属于"配置可以静默降低安全性"。
  • 建议:override 只允许 enabled=false 或收窄匹配条件;任何 action/target 变更必须显式确认并写入审计日志。

P2-3 "READY" 的判据在两条路径上不一致

  • 校验路径用 _normalize_bridge_result(verify_runner.py:255-266):READY 必须 source == 'IsVerifiedReuseBlock' 且 raw_status == 1,否则降级为 MALFORMED。
  • 批量状态路径(batch_status.py:46-47、:166-167、:228-229)只把 source/raw_status 透传,自身不再校验。
  • 建议:把"什么算 READY"抽成一个公共函数,两条路径都调用,避免将来某一条放松。

P2-4 UIA 探针线程(与评论 297 的 P2-5 同因)

dialog_probe._bounded_call(:28-44)每次调用新建线程、超时只放弃等待,5Hz 轮询下可累积大量阻塞线程。

验证记录

  • 我逐行读了 native_repair.py 全文件、icdb_recovery.py 全文件、maintenance_entry.py:226-451、desktop_worker.py 的 close/kill、dialog_agent.py 的通道与 _request、dialog_rules.py 的加载与 override、batch_status.py 的字段流转。
  • auto_repair=True 的全局搜索为零;run_diagnosed_maintenance 的调用者搜索为零。
  • 未验证:真实原生 Repair 执行(这条链在生产不可达,我没有构造可达路径去跑);dialog-agent 错位级联的端到端复现(只做了代码级推断:buffer 不重置 + request_id 校验必然冲突)。
# 深审补充 3:修复链 + 对话框自动应答 / 状态桥 ## 一、修复链(`native_repair.py` / `icdb_recovery.py` / `maintenance_entry.py` / `failed_session.py`) ### 结论:没有 P1——因为整条修复链在生产路径上**不可达** 我逐个核对调用关系: - `auto_repair` 默认 `False`(`verify_runner.py:82`),全仓**没有任何 `auto_repair=True`**(grep 为零);UI 与恢复路径四处都显式传 `False`(`ui/main_window.py:787`、`:1225`、`backup_recovery.py:238`、`:276`)。 - 唯一真正调用 `run_native_repair` 的 `maintenance_entry.run_existing_address_maintenance`(`:342-451`)只被 `run_diagnosed_maintenance`(`:293`)调用,而 `run_diagnosed_maintenance` **零调用者**。 - 用户能点到的"ICDB 批量检查"走的是 `run_icdb_check`(`:226-290`):纯只读、`automatic_repair: False`,发现错误只报 `ICDB_REPAIR_REQUIRED`、明确"未执行修复"(`:278-281`)。 所以 `native_repair.py` 这 310 行目前是**只有测试在跑的死代码**。建议在文件头与 README 明确写"保留入口,未接线",或干脆删除——否则读者会以为工具会自动做原生 Repair(而 README:14 已明确"不自动 Repair",两边一致,只是代码会误导人)。 ### 这条链本身写得很好(值得保留,将来接线时直接用) - `select_repair_target`(`:20-40`):只接受 `scope=project`;报错数据库必须解析到当前工程的 `database` 且含 `icdb.dat`,否则 `REPAIR_TARGET_UNCONFIRMED`——**不猜路径**。 - `attempt_recovery`(`:127-165`):`attempt.json` 用 `open('x')` 做**一次一标记**,重复即 `REPAIR_ALREADY_ATTEMPTED`;启动前要求无任何 PCB/Library Manager、无引用该工程的 cscript 保存助手(`:147-152`)。 - `repair_release_state`(`:212-252`):原生已退出 + 无 owner + 无 `sAddress.adr` + 对 `icdb.dat` 独占句柄,缺一即 `safe_to_continue=False`。 - `run_native_repair`:超时**不杀** worker,只 `request_stop()` 并返回 `TIMEOUT_UNRELEASED / safe_to_continue=False`(`:298-302`);`DesktopWorker.close()` 也明确不使用 kill-on-close(`desktop_worker.py:84-86` 注释),只终止 companion——和 verify 路径"取消就杀"的做法形成鲜明对比,**这才是应有的策略**。 - `icdb_recovery.parse_session_loss`:保留原生消息原文、按 path 推断 scope、拒绝推断目标;`_read_log_delta` 用 tail 哈希区分"追加"与"重写",不会把旧日志当本次失败(`:110-134`、`:148-164`)。 ### P3 1. `backup_project`(`native_repair.py:64-124`,全树备份 + 逐文件哈希 + 备份期间独占 `icdb.dat` + 检测源文件变化)在生产代码中**零调用**,只有测试用;不要让人误以为 Repair 前会自动做完整备份(UI 文案"应用不自动备份"是对的)。 2. `attempt_recovery` 的"任何 PCB 进程存在即拒绝"(`:148-149`)与 verify 路径"无关工程可以开着"(`mentor_adapter.py:609-610`)矛盾:应改成 scoped 匹配(`_native_scope_match` / `_idle_check` 已有的能力),否则现场开着别的设计就永远修不了。 3. `maintenance_entry.py:391-392` 的 `owner_safe = A or B and C` 依赖 `and` 优先级,建议加括号(可读性)。 ## 二、对话框自动应答 / 状态桥 ### P2-1 `dialog_agent` 通道一次超时后可能**永久错位** - `JsonChannel.receive`(`dialog_agent.py:74-88`)在超时时抛出,`buffer` 里可能残留半条/迟到的响应;`_request`(`:482-503`)在异常后**不重置通道**,下一次请求用新的 `request_id`,而 `receive` 先读到的是上一条残留响应 → `响应 request_id 不匹配` → 抛协议错误;真正的响应又留在 socket 里,形成**错位级联**,此后每次 poll 都失败,整项直接 FAIL。 - 建议:任何协议错误都清空 buffer 并重新握手,或直接重建 dialog-agent 子进程;同时把 `sequence` 不匹配与 `request_id` 不匹配区分成可恢复/不可恢复两类。 ### P2-2 生产路径上还有第二套 positive-first 应答器,且规则可被配置静默放宽 - `mentor_adapter.py:352-377` 的 `choose_dialog_action` 只对 database restoration 等几个家族返回"不点",**其余一律 positive-first**(含 `restore/open/use/load/是/确定/恢复/打开`),未知对话框还会走 `fallback` 点第一个非否定按钮;`:1491`、`:1573` 的 `handle_known_dialogs` 在生产路径上被状态读取调用(见上一条评论 P1-3)。 - `dialog_rules.py:119-138`(`load_rules` + `raw_by_id[rule_id].update(override)`)的 override 直接覆盖默认规则,且 `action`(`:84`)、`target` 都**没有白名单**:现场一个写错的 JSON 就能把"本来不点的规则"改成"点",属于"配置可以静默降低安全性"。 - 建议:override 只允许 `enabled=false` 或收窄匹配条件;任何 `action`/`target` 变更必须显式确认并写入审计日志。 ### P2-3 "READY" 的判据在两条路径上不一致 - 校验路径用 `_normalize_bridge_result`(`verify_runner.py:255-266`):`READY` 必须 `source == 'IsVerifiedReuseBlock'` 且 `raw_status == 1`,否则降级为 `MALFORMED`。 - 批量状态路径(`batch_status.py:46-47`、`:166-167`、`:228-229`)只把 `source/raw_status` **透传**,自身不再校验。 - 建议:把"什么算 READY"抽成一个公共函数,两条路径都调用,避免将来某一条放松。 ### P2-4 UIA 探针线程(与评论 297 的 P2-5 同因) `dialog_probe._bounded_call`(`:28-44`)每次调用新建线程、超时只放弃等待,5Hz 轮询下可累积大量阻塞线程。 ## 验证记录 - 我逐行读了 `native_repair.py` 全文件、`icdb_recovery.py` 全文件、`maintenance_entry.py:226-451`、`desktop_worker.py` 的 close/kill、`dialog_agent.py` 的通道与 `_request`、`dialog_rules.py` 的加载与 override、`batch_status.py` 的字段流转。 - `auto_repair=True` 的全局搜索为零;`run_diagnosed_maintenance` 的调用者搜索为零。 - 未验证:真实原生 Repair 执行(这条链在生产不可达,我没有构造可达路径去跑);dialog-agent 错位级联的端到端复现(只做了代码级推断:buffer 不重置 + request_id 校验必然冲突)。
Author
Owner

审查 4/4(复核 head 5eb4b2d):2×P2 已修,新增 1×P2 + 2×P3

范围:dc536da..5eb4b2d7,14 个提交,本片自有的是 5eb4b2d(持久化释放结果 + 保护进行中的原生备份会话),其余是 #10/#11 的跟进提交随链路同步。源码变更:residual_sessions.py +179/−56、ui/residual_release_dialog.py +77/−11、ui/management_dialog.py +17/−2,文档(README/SOP/ICDB 手册/发布说明)同步。

逐条复核

前轮项 本轮实现 判定
P2-1 中途异常丢 result.json;证据写失败仍报 RELEASE_CONFIRMED 先写 result.json 再动原生(residual_sessions.py:435-444 的 save());每个动作前写 REQUESTING、动作后写结果;整体 try/except BaseException + finally: save();save() 失败把 status 降 PARTIAL + report_saved=False;UI 追加"记录保存失败:…" 已修,而且是"动作前落盘"的正确顺序
P2-2 强制结束绕过"原生操作进行中" 新增 native_activity()(:44-68):窗口读取不完整 → UNCONFIRMED、有进度条/主窗禁用 → ACTIVE、iCDB Backup 输出里最后一条 repairing/restoring/backing up 晚于结束标记 → ACTIVE;force_block_reason 对 ACTIVE/UNCONFIRMED 直接拒绝;_force_close 在拿到句柄后又重采一次再判;stop 在 TerminateProcess 之前检查 已修
P3-2 私有桌面上的窗口看不到 窗口字典带 desktop;表格新增"窗口位置/程序路径";新增"查看原生提示…"(标题/输出/静态控件文本);私有桌面时 detail 追加提示 已修
P3-4 .lmc 不存在时报"请选择有效的 .lmc" 拆成"后缀不对"与"路径当前不可见,请检查文件是否存在及网络盘映射" 已修
P3-5 释放时 roots 比预览宽 有 block_names 时用 ReusableBlocksLP/<block>/Work + SymbolLibs,否则整库 部分:request_native_cancel() 构造的 plan 没有 block_names,取消路径仍走整库(见下)

文档与行为一致:README:7/9/11 与 SOP:28-31 已写明"停止只停后续动作、不结束正在 Save/Close 的调用进程"、"普通停止 5 秒 / 可能写入时最多 120 秒交给后台观察"、"仅对唯一可识别的 Cancel 按钮提供单独确认的原生取消"。

新发现

[P2] 一处窗口读取不完整,会让所有会话的"协作关闭"与"强制结束"同时不可用

_process_windows() 的 incomplete()(residual_sessions.py:147-150)在任何一次 EnumWindows/EnumDesktops/OpenDesktop 失败时,给 result 里的每个 pid 都追加一条 {'class': 'UNCONFIRMED', 'title': '窗口状态读取不完整'}。后果是链式的:

  • close_target() 把这条伪窗口当成"存在原生弹窗",返回 存在原生弹窗,请先处理该窗口后重新检查(:195-201)→ can_close=False;
  • native_activity() 第一句就返回 UNCONFIRMED(:45-46)→ force_block_reason 拒绝 → force_allowed=False;
  • _cancel_question() 要求 native_activity == ACTIVE,UNCONFIRMED 也不满足 → 没有取消入口。

也就是说,只要有一个桌面打不开(例如本工具自己创建的 CbbManagement_* 因上一个进程异常退出后不可读、或跨会话桌面),所有行的三条路全被堵住,而界面给的建议是"请先处理该窗口"——那条"窗口"是读取失败的占位符,人无从处理。这正是残留会话功能最需要生效的场景(supervisor 崩溃后的孤儿会话)。

建议:

  1. incomplete() 不要伪造窗口塞进 windows,改成按 pid 维护 windows_incomplete=True,让 close_target/native_activity/force_block_reason 只对受影响的那个 pid 收紧;
  2. 受影响会话若身份/作用域/用户会话都通过,且窗口落在本工具自己创建的 Cbb* 私有桌面上,给一条明确文案的"该会话窗口无法读取,仍按身份结束(需二次确认)",否则用户的唯一选择又回到任务管理器强杀。

[P3] consent.json / result.json 里反复写整段原生窗口输出

inspect_residual_sessions() 把 item['windows'] = observed(:288)直接放进 plan,而 _process_windows 对含 richedit 的窗口会填 window['output'] = _native_output(...)(:143-145,即整段 iCDB Backup 日志)。_release_residual_sessions 的 save() 每次动作前后各写一次完整 result.json,consent.json 也带全部 session 行;而 _write_json(management.py)对大小没有任何限制。一次多会话释放会把这个大字符串重复落盘十几次。

建议:落盘时剥掉 windows[*].output 与 children(只保留 desktop/title/class/hwnd),或把 output 截到 2–4 KB 并单列 output_excerpt;预览仍可在内存里保留全文供"查看原生提示"使用。

[P3] 取消路径的作用域复核仍比预览宽

request_native_cancel()(:418-421)构造的 plan 只有 library/sessions,没有 block_names,因此 _release_residual_sessions 里 roots=(library.parent,) 整库判 scope;预览时用的是 Work + SymbolLibs 两个窄 roots。有 created/command/executable/name 逐项比对钉住同一进程,所以不是越权,但"取消时复核的范围比确认时更松"与 PR 里"两处复核"的表述仍有落差。建议两处共用同一份 roots(把 block_names 一并传进取消的 plan)。

边界

  • 本机沙箱无法创建 pytest 临时目录(mkdir(mode=0o700) 会得到进程自己打不开的目录),本轮未复跑测试。
  • 未在真实 Mentor 客户端上做正常关闭/强制结束/原生取消;native_activity 的输出正则是对真实 Output 文本的启发式判断,需要现场语料校准(尤其"Backup information loaded correctly."之外的结束标记)。

结论:修复后合并(1×P2 + 2×P3,无 P1)。

# 审查 4/4(复核 head `5eb4b2d`):2×P2 已修,新增 1×P2 + 2×P3 范围:`dc536da..5eb4b2d7`,14 个提交,本片自有的是 `5eb4b2d`(持久化释放结果 + 保护进行中的原生备份会话),其余是 #10/#11 的跟进提交随链路同步。源码变更:`residual_sessions.py` +179/−56、`ui/residual_release_dialog.py` +77/−11、`ui/management_dialog.py` +17/−2,文档(README/SOP/ICDB 手册/发布说明)同步。 ## 逐条复核 | 前轮项 | 本轮实现 | 判定 | | --- | --- | --- | | **P2-1** 中途异常丢 `result.json`;证据写失败仍报 `RELEASE_CONFIRMED` | 先写 `result.json` 再动原生(`residual_sessions.py:435-444` 的 `save()`);每个动作前写 `REQUESTING`、动作后写结果;整体 `try/except BaseException` + `finally: save()`;`save()` 失败把 `status` 降 `PARTIAL` + `report_saved=False`;UI 追加"记录保存失败:…" | **已修**,而且是"动作前落盘"的正确顺序 | | **P2-2** 强制结束绕过"原生操作进行中" | 新增 `native_activity()`(`:44-68`):窗口读取不完整 → `UNCONFIRMED`、有进度条/主窗禁用 → `ACTIVE`、iCDB Backup 输出里最后一条 repairing/restoring/backing up 晚于结束标记 → `ACTIVE`;`force_block_reason` 对 `ACTIVE/UNCONFIRMED` 直接拒绝;`_force_close` 在拿到句柄后又重采一次再判;`stop` 在 `TerminateProcess` 之前检查 | **已修** | | **P3-2** 私有桌面上的窗口看不到 | 窗口字典带 `desktop`;表格新增"窗口位置/程序路径";新增"查看原生提示…"(标题/输出/静态控件文本);私有桌面时 detail 追加提示 | **已修** | | **P3-4** `.lmc` 不存在时报"请选择有效的 .lmc" | 拆成"后缀不对"与"路径当前不可见,请检查文件是否存在及网络盘映射" | **已修** | | **P3-5** 释放时 roots 比预览宽 | 有 `block_names` 时用 `ReusableBlocksLP/<block>/Work` + `SymbolLibs`,否则整库 | **部分**:`request_native_cancel()` 构造的 plan 没有 `block_names`,取消路径仍走整库(见下) | 文档与行为一致:README:7/9/11 与 SOP:28-31 已写明"停止只停后续动作、不结束正在 Save/Close 的调用进程"、"普通停止 5 秒 / 可能写入时最多 120 秒交给后台观察"、"仅对唯一可识别的 Cancel 按钮提供单独确认的原生取消"。 ## 新发现 ### [P2] 一处窗口读取不完整,会让**所有**会话的"协作关闭"与"强制结束"同时不可用 `_process_windows()` 的 `incomplete()`(`residual_sessions.py:147-150`)在**任何**一次 `EnumWindows`/`EnumDesktops`/`OpenDesktop` 失败时,给 `result` 里的**每个 pid** 都追加一条 `{'class': 'UNCONFIRMED', 'title': '窗口状态读取不完整'}`。后果是链式的: - `close_target()` 把这条伪窗口当成"存在原生弹窗",返回 `存在原生弹窗,请先处理该窗口后重新检查`(`:195-201`)→ `can_close=False`; - `native_activity()` 第一句就返回 `UNCONFIRMED`(`:45-46`)→ `force_block_reason` 拒绝 → `force_allowed=False`; - `_cancel_question()` 要求 `native_activity == ACTIVE`,`UNCONFIRMED` 也不满足 → 没有取消入口。 也就是说,只要有一个桌面打不开(例如本工具自己创建的 `CbbManagement_*` 因上一个进程异常退出后不可读、或跨会话桌面),**所有**行的三条路全被堵住,而界面给的建议是"请先处理该窗口"——那条"窗口"是读取失败的占位符,人无从处理。这正是残留会话功能最需要生效的场景(supervisor 崩溃后的孤儿会话)。 建议: 1. `incomplete()` 不要伪造窗口塞进 `windows`,改成按 pid 维护 `windows_incomplete=True`,让 `close_target`/`native_activity`/`force_block_reason` 只对**受影响的那个 pid** 收紧; 2. 受影响会话若身份/作用域/用户会话都通过,且窗口落在本工具自己创建的 `Cbb*` 私有桌面上,给一条明确文案的"该会话窗口无法读取,仍按身份结束(需二次确认)",否则用户的唯一选择又回到任务管理器强杀。 ### [P3] `consent.json` / `result.json` 里反复写整段原生窗口输出 `inspect_residual_sessions()` 把 `item['windows'] = observed`(`:288`)直接放进 plan,而 `_process_windows` 对含 richedit 的窗口会填 `window['output'] = _native_output(...)`(`:143-145`,即整段 iCDB Backup 日志)。`_release_residual_sessions` 的 `save()` 每次动作前后各写一次完整 `result.json`,`consent.json` 也带全部 session 行;而 `_write_json`(`management.py`)对大小没有任何限制。一次多会话释放会把这个大字符串重复落盘十几次。 建议:落盘时剥掉 `windows[*].output` 与 `children`(只保留 `desktop/title/class/hwnd`),或把 output 截到 2–4 KB 并单列 `output_excerpt`;预览仍可在内存里保留全文供"查看原生提示"使用。 ### [P3] 取消路径的作用域复核仍比预览宽 `request_native_cancel()`(`:418-421`)构造的 plan 只有 `library/sessions`,没有 `block_names`,因此 `_release_residual_sessions` 里 `roots=(library.parent,)` 整库判 scope;预览时用的是 `Work + SymbolLibs` 两个窄 roots。有 `created/command/executable/name` 逐项比对钉住同一进程,所以不是越权,但"取消时复核的范围比确认时更松"与 PR 里"两处复核"的表述仍有落差。建议两处共用同一份 roots(把 `block_names` 一并传进取消的 plan)。 ## 边界 - 本机沙箱无法创建 pytest 临时目录(`mkdir(mode=0o700)` 会得到进程自己打不开的目录),本轮未复跑测试。 - 未在真实 Mentor 客户端上做正常关闭/强制结束/原生取消;`native_activity` 的输出正则是对真实 Output 文本的启发式判断,需要现场语料校准(尤其"Backup information loaded correctly."之外的结束标记)。 **结论:修复后合并(1×P2 + 2×P3,无 P1)。**
Author
Owner

完整审查 #12(head 5eb4b2d,57 文件 +4,517/−14):修复后合并(1 P2 + 2 P3)

覆盖与方式

  • 全读:residual_sessions.py(564)、ui/residual_release_dialog.py(240)、ui/main_window.py 的增量、__init__.py。
  • 文档逐条对过:README.md、SOP.md、docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md、docs/releases/v0.2.4-beta.1.md、pyproject.toml(0.2.4b1)。
  • 测试:tests/test_residual_sessions.py(363)、tests/test_residual_release_dialog.py(156) 抽查关键断言。

这片的可靠之处(复核后确认)

本 PR 自己的 5eb4b2d 已把我上一轮的 2 个 P2 修到位:动作前先落盘 result.json、每个动作前后各存一次、整体 except BaseException + finally 保存、保存失败降 PARTIAL;强制结束前用 native_activity() 判"备份/恢复/修复进行中"并在句柄处重采一次(residual_sessions.py:349-371)。文档与实现一致:4 个客户端白名单、服务器/后台导入器排除、确认名单先落盘 fsync、结束仍须独立释放证明、Cancel 按钮仅唯一可识别时才提供。

P2(仍开放,上一轮提出)

[P2] 一处窗口读取不完整,会让所有会话的"协作关闭 + 强制结束 + 原生取消"同时不可用

_process_windows() 的 incomplete()(:147-150)在任何一次 EnumWindows/EnumDesktops/OpenDesktop 失败时,给 result 里每个 pid 追加一条 {'class': 'UNCONFIRMED', 'title': '窗口状态读取不完整'}。链式后果:

  • close_target() 把它当"原生弹窗",返回 存在原生弹窗,请先处理该窗口后重新检查(:195-201)→ can_close=False;
  • native_activity() 第一个分支直接 UNCONFIRMED(:45-46)→ force_block_reason 拒绝 → force_allowed=False;
  • _cancel_question() 要求 native_activity == 'ACTIVE'(:228)→ 连"请求原生取消"也不提供。

于是界面给的建议(:286-287"窗口在后台,可查看原生提示并使用已提供的保存/取消操作")指向那条占位符——人无从处理。这恰好是残留会话功能最需要生效的场景(supervisor 崩溃后的孤儿会话/不可读私有桌面)。

建议(同上一轮):incomplete() 不伪造窗口,改为按 pid 记 windows_incomplete,只收紧受影响的那个会话;对"身份/作用域/用户会话都通过、窗口就在本工具私有桌面上"的会话,给一条明确文案的"该会话窗口无法读取,仍按身份结束(二次确认)"。

P3

[P3-1] 证据文件里反复写入整段原生窗口输出

inspect_residual_sessions 把 item['windows'] = observed 直接放进 plan(:280-281),而 _process_windows 对含 richedit 的窗口会填 window['output'](:143-145,整段 iCDB Backup 日志)。_release_residual_sessions 的 save()(:424-433)每次动作前后各写一次完整 result.json,consent.json 也带全部 session 行,而 management._write_json 没有大小上限。一次多会话释放会把这个大字符串重复落盘十几次。
建议:落盘时剥掉 windows[*].output/children(保留 desktop/title/class/hwnd),或截断到 2–4 KB 并存 output_excerpt;预览仍可用内存里的全文。

[P3-2] "预览允许 / 执行拒绝"的差异没有呈现

consent.json 记的是预览时的 force_allowed(:439-441),执行时会重新判定并可能降级为 WAITING(:365-368);但 UI 只在行内追加 detail,没有把"用户确认的范围"与"最终执行结果"的差异单独列出来。事后核对"我勾了三个、为什么只关了一个"会很难。
建议:结果里直接给 consent_allowed vs release_status 的差异列(或结果摘要里一句"2 项预览允许、1 项执行时被拒绝:<原因>")。

与链路后续的关系

#13 在这之后接入了"只读观察/后台接管/队列解除"(session_record 侧),本 PR 的 inspect(被动预览)与 release(显式释放)主流程未被改写,只在释放成功后追加了会话释放记录;本次指出的 P2 在 #13 的跟进里仍未处理。

边界

  • 未在真实 Mentor 客户端上执行正常关闭/强制结束/原生取消;native_activity 的 Output 正则是启发式,需要现场语料校准("Backup information loaded correctly." 之外的结束标记)。
  • 本机沙箱无法创建 pytest 临时目录,未复跑测试套件。
# 完整审查 #12(head `5eb4b2d`,57 文件 +4,517/−14):修复后合并(1 P2 + 2 P3) ## 覆盖与方式 - 全读:`residual_sessions.py`(564)、`ui/residual_release_dialog.py`(240)、`ui/main_window.py` 的增量、`__init__.py`。 - 文档逐条对过:`README.md`、`SOP.md`、`docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md`、`docs/releases/v0.2.4-beta.1.md`、`pyproject.toml`(`0.2.4b1`)。 - 测试:`tests/test_residual_sessions.py`(363)、`tests/test_residual_release_dialog.py`(156) 抽查关键断言。 ## 这片的可靠之处(复核后确认) 本 PR 自己的 `5eb4b2d` 已把我上一轮的 2 个 P2 修到位:动作前先落盘 `result.json`、每个动作前后各存一次、整体 `except BaseException` + `finally` 保存、保存失败降 `PARTIAL`;强制结束前用 `native_activity()` 判"备份/恢复/修复进行中"并在句柄处重采一次(`residual_sessions.py:349-371`)。文档与实现一致:4 个客户端白名单、服务器/后台导入器排除、确认名单先落盘 `fsync`、结束仍须独立释放证明、`Cancel` 按钮仅唯一可识别时才提供。 ## P2(仍开放,上一轮提出) ### [P2] 一处窗口读取不完整,会让**所有**会话的"协作关闭 + 强制结束 + 原生取消"同时不可用 `_process_windows()` 的 `incomplete()`(`:147-150`)在任何一次 `EnumWindows`/`EnumDesktops`/`OpenDesktop` 失败时,给 `result` 里**每个 pid** 追加一条 `{'class': 'UNCONFIRMED', 'title': '窗口状态读取不完整'}`。链式后果: - `close_target()` 把它当"原生弹窗",返回 `存在原生弹窗,请先处理该窗口后重新检查`(`:195-201`)→ `can_close=False`; - `native_activity()` 第一个分支直接 `UNCONFIRMED`(`:45-46`)→ `force_block_reason` 拒绝 → `force_allowed=False`; - `_cancel_question()` 要求 `native_activity == 'ACTIVE'`(`:228`)→ 连"请求原生取消"也不提供。 于是界面给的建议(`:286-287`"窗口在后台,可查看原生提示并使用已提供的保存/取消操作")指向那条占位符——人无从处理。这恰好是残留会话功能最需要生效的场景(supervisor 崩溃后的孤儿会话/不可读私有桌面)。 建议(同上一轮):`incomplete()` 不伪造窗口,改为按 pid 记 `windows_incomplete`,只收紧受影响的那个会话;对"身份/作用域/用户会话都通过、窗口就在本工具私有桌面上"的会话,给一条明确文案的"该会话窗口无法读取,仍按身份结束(二次确认)"。 ## P3 ### [P3-1] 证据文件里反复写入整段原生窗口输出 `inspect_residual_sessions` 把 `item['windows'] = observed` 直接放进 plan(`:280-281`),而 `_process_windows` 对含 richedit 的窗口会填 `window['output']`(`:143-145`,整段 iCDB Backup 日志)。`_release_residual_sessions` 的 `save()`(`:424-433`)每次动作前后各写一次完整 `result.json`,`consent.json` 也带全部 session 行,而 `management._write_json` 没有大小上限。一次多会话释放会把这个大字符串重复落盘十几次。 建议:落盘时剥掉 `windows[*].output`/`children`(保留 `desktop/title/class/hwnd`),或截断到 2–4 KB 并存 `output_excerpt`;预览仍可用内存里的全文。 ### [P3-2] "预览允许 / 执行拒绝"的差异没有呈现 `consent.json` 记的是预览时的 `force_allowed`(`:439-441`),执行时会重新判定并可能降级为 `WAITING`(`:365-368`);但 UI 只在行内追加 detail,没有把"用户确认的范围"与"最终执行结果"的差异单独列出来。事后核对"我勾了三个、为什么只关了一个"会很难。 建议:结果里直接给 `consent_allowed` vs `release_status` 的差异列(或结果摘要里一句"2 项预览允许、1 项执行时被拒绝:<原因>")。 ## 与链路后续的关系 #13 在这之后接入了"只读观察/后台接管/队列解除"(`session_record` 侧),本 PR 的 `inspect`(被动预览)与 `release`(显式释放)主流程未被改写,只在释放成功后追加了会话释放记录;本次指出的 P2 在 #13 的跟进里仍未处理。 ## 边界 - 未在真实 Mentor 客户端上执行正常关闭/强制结束/原生取消;`native_activity` 的 Output 正则是启发式,需要现场语料校准("Backup information loaded correctly." 之外的结束标记)。 - 本机沙箱无法创建 pytest 临时目录,未复跑测试套件。
Author
Owner

复核 #348 的修复(head a7df1056):P2 与两个 P3 均已解决——可以合并

新增三个提交:651b539(不可读会话按 PID 隔离、证据有界)、14c9a74(确认范围与执行结果并列)、a7df1056(结果窗口退役后重建续做入口)。

逐条

348 的项 实现 判定
P2 一处读取不完整让所有会话的关闭/强制/取消同时不可用 不再伪造 UNCONFIRMED 窗口:先取目标进程线程快照,再用 GetThreadDesktop + OpenDesktop/EnumDesktopWindows 只枚举这些线程所在的桌面;失败按 PID 记进 _WindowSnapshot.incomplete。close_target/_save_question/_cancel_question/native_activity/_request_close/_force_close/_request_native_cancel/_answer_save_question 全部带上 incomplete 参数,只收紧受影响的那个会话 已修,且方向比我建议的更保守:不接受"身份+私有桌面即可强行结束"的兜底,而是保持"未知/活跃不允许强制"、让其他会话仍可操作、失败可重试。我认同这个取舍——身份与作用域确实证明不了 Save/Repair 已返回
P3-1 证据里重复写整段窗口输出 _session_evidence():窗口只留 hwnd/title/class/desktop/enabled,输出截断到 4096 字节并存 output_bytes/output_sha256/output_truncated,native_activity 去掉 output;result.json 与 consent.json 都改用它,完整预览仍留在内存供"查看原生提示" 已修
P3-2 确认范围与执行结果不可比 表格新增"确认范围/执行结果"两列(允许/未允许/待确认 × 已释放/未释放/身份已变化/已停止/执行中/尚未执行),结果消息追加"确认允许 N 项,其中未释放 M 项" 已修
(顺带)取消路径作用域 request_native_cancel 现在携带预览的 block_names,释放时用 Work + SymbolLibs 窄作用域复核,不再默默放大到整库 已修

我额外核对的点

  • 排队态释放入口是否会误伤正在运行的任务:#13 新增了 busy 时也能打开释放面板的入口,我担心它会列出当前活跃 worker 的原生会话。核对结论是不会造成实际干扰:release_residual_sessions 先拿全局互斥 Local\CbbRefreshVerify795,而正在执行的校验/管理在 supervisor 侧持有同一互斥,取不到就直接返回"其它批次尚在执行",不会关闭任何进程。这条保护是有效的。
  • 真实私有桌面窗口的回归(文档里说在 CbbManagement_* 上创建真实窗口、由另一进程读取)很有价值——正是它暴露了 EnumThreadWindows 不跨桌面的平台限制。

遗留

无阻断项。只剩一句文档层面的提醒:native_activity 对 iCDB Backup 输出的判定仍是启发式正则,现场若出现"Backup information loaded correctly."之外的结束语,需要补充语料(这与真实性验收边界一致)。

结论:可以合并(0 P1/P2/P3 阻断)。

# 复核 #348 的修复(head `a7df1056`):P2 与两个 P3 均已解决——可以合并 新增三个提交:`651b539`(不可读会话按 PID 隔离、证据有界)、`14c9a74`(确认范围与执行结果并列)、`a7df1056`(结果窗口退役后重建续做入口)。 ## 逐条 | 348 的项 | 实现 | 判定 | | --- | --- | --- | | **P2** 一处读取不完整让所有会话的关闭/强制/取消同时不可用 | 不再伪造 `UNCONFIRMED` 窗口:先取目标进程线程快照,再用 `GetThreadDesktop` + `OpenDesktop/EnumDesktopWindows` 只枚举这些线程所在的桌面;失败按 PID 记进 `_WindowSnapshot.incomplete`。`close_target`/`_save_question`/`_cancel_question`/`native_activity`/`_request_close`/`_force_close`/`_request_native_cancel`/`_answer_save_question` 全部带上 `incomplete` 参数,只收紧受影响的那个会话 | **已修**,且方向比我建议的更保守:不接受"身份+私有桌面即可强行结束"的兜底,而是保持"未知/活跃不允许强制"、让其他会话仍可操作、失败可重试。我认同这个取舍——身份与作用域确实证明不了 Save/Repair 已返回 | | P3-1 证据里重复写整段窗口输出 | `_session_evidence()`:窗口只留 `hwnd/title/class/desktop/enabled`,输出截断到 4096 字节并存 `output_bytes/output_sha256/output_truncated`,`native_activity` 去掉 output;`result.json` 与 `consent.json` 都改用它,完整预览仍留在内存供"查看原生提示" | **已修** | | P3-2 确认范围与执行结果不可比 | 表格新增"确认范围/执行结果"两列(允许/未允许/待确认 × 已释放/未释放/身份已变化/已停止/执行中/尚未执行),结果消息追加"确认允许 N 项,其中未释放 M 项" | **已修** | | (顺带)取消路径作用域 | `request_native_cancel` 现在携带预览的 `block_names`,释放时用 `Work + SymbolLibs` 窄作用域复核,不再默默放大到整库 | **已修** | ## 我额外核对的点 - **排队态释放入口是否会误伤正在运行的任务**:#13 新增了 busy 时也能打开释放面板的入口,我担心它会列出当前活跃 worker 的原生会话。核对结论是**不会造成实际干扰**:`release_residual_sessions` 先拿全局互斥 `Local\CbbRefreshVerify795`,而正在执行的校验/管理在 supervisor 侧持有同一互斥,取不到就直接返回"其它批次尚在执行",不会关闭任何进程。这条保护是有效的。 - 真实私有桌面窗口的回归(文档里说在 `CbbManagement_*` 上创建真实窗口、由另一进程读取)很有价值——正是它暴露了 `EnumThreadWindows` 不跨桌面的平台限制。 ## 遗留 无阻断项。只剩一句文档层面的提醒:`native_activity` 对 iCDB Backup 输出的判定仍是启发式正则,现场若出现"Backup information loaded correctly."之外的结束语,需要补充语料(这与真实性验收边界一致)。 **结论:可以合并(0 P1/P2/P3 阻断)。**
abaishu0730 marked the pull request as ready for review 2026-11-12 17:39:45 +08:00
abaishu0730 changed target branch from codex/review-ui-integration to main 2026-11-12 17:39:45 +08:00
abaishu0730 added 10 commits 2026-11-12 17:39:45 +08:00
abaishu0730 merged commit b2ddd76a04 into main 2026-11-12 17:39:46 +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#12