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 点第一个非否按钮。
Save 与 Close 被合成一个布尔门:save_verified_block.vbs 在 Save 成功后仍有 POST_SAVE_CHECK/IsSaved/Close 三段可能失败,而 Python 侧只看到"核心标记不全",无法区分"已提交但关闭失败"与"根本没写";VBS 退出码也没有原因文本。
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
针对评论 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,不合并、不发布、不关闭工单。
审查 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.py363 行、test_residual_release_dialog.py156 行)。结论
修复后合并。 这一段是本轮风险最高的改动(会真的结束用户进程),实现比我预期保守:默认只做正常关闭,强制结束是独立入口 + 独立确认 + 双重身份复核。没有发现 P1。
三条自述我逐条核对的结果
_FORCE_CLIENT_NAMES = {expeditionpcb.exe, librarymanager.exe, viewdraw.exe, icdbprojectbackup.exe}(residual_sessions.py:18),force_block_reason(:21-34)对服务器/导入器/未知进程一律拒绝created/executable/command/name+ scope(:347-355);句柄处查CreationTime/映像/SID/Windows 会话(:303-310)open('x')+flush+fsync(:336-338),异常直接抛出,无原生动作另外两点我认为做得好
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_CONFIRMEDresidual_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都能通过。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)。如果那个弹窗在本工具自己创建的私有桌面上,人根本切不过去处理——唯一出路是强制结束(丢未保存更改)。[P3-3] 契约描述与实现的两处精度问题
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 先落盘、私有桌面提示"等关键面。深度审查: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:
CbbManagement_*私有桌面永久残留,释放永远无法确认P1-1 取消/超时落在保存阶段会强杀正在 Save 的 cscript
证据链(我逐行读过)
mentor_adapter.py:820-827发save_start,用launch_save_helper起SysWOW64\cscript.exe save_verified_block.vbs(该 VBS 执行doc.Validate → doc.Save() → IsSaved → Close)。:830-841里,一旦发现取消信号就raise RuntimeError('VERIFY_CANCELLED: 已停止等待保存客户端')—— 直接放弃等待,不等待也不结束 helper。:876-889的finally只emit(stage='save_helper_retained'),不等待 helper。verify_runner.py:943-947(用户取消)或:1059/:1082(超时)调用_stop_worker(process)。_stop_worker(:230-252):request_stop()→wait(5)→ 无论 worker 是否已合作退出,最后都会执行process.stop_automation_clients()。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)。native_management.py:192-244启动(DesktopWorker(... '--management-worker' ...)),没有 armed watchdog,循环里也不检查取消文件;只有 add 类超时后才touch cancel-native-add.signal(:231)。LibraryManager.exe+CbbManagement_*桌面会一直留在那里;_retained_workers(:23)只是内存列表,进程一死就丢失;release_confirmed需要那个挂住的 worker 自己写safe_to_continue=true,永不成立;全仓没有CloseDesktop/DeleteDesktop的清理路径,只能靠residual_sessions人工观察(而私有桌面上的窗口人看不到,见 #12 的 P3-2)。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点第一个非否按钮。UNKNOWN/PENDING提示人工处理);或在状态刷新路径完全禁止启动原生进程(提示"请手动打开 Library Manager 后重试")。P2(建议排期)
auto_repair之后的复验丢失stop:verify_runner.py:595(attempt_recovery未传 stop)与:617-620(复验未传stop=stop)→ 用户点停止后,修复完成后仍会跑完一整次校验;CLI 的run_batch默认 verifier 同样不转发 stop(:1247-1248)。我已核实:617-620。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。is_reusable_circuit_pcb(:237-245)在ExecutablePath/CommandLine为空时返回False(放行),而同库的_native_scope_match(backup_recovery.py:59-80)对同样情况返回None(阻断)。建议改为三态并使用保守语义。pcb.prj重写缺少写前复核与语义区分:ensure_project_central_library(:108-162)读→写之间不重读比对;updated == original一律发MATCH,把"键不存在/编码不支持/已对齐"混为一谈;调用点:700-706丢弃返回值。我已核实这三点。dialog_probe.py:28-44每次调用新建线程,超时只放弃等待(daemon 线程继续卡在 UIA 里),而 supervisor 每 200ms 轮询一次capture_one(:242、verify_runner.py:1094)→ 长批次下线程数单调增长,且 COM 公寓混用(测试日志里每次都能看到Revert to STA COM threading mode)。建议改为常驻单线程 + 任务队列 + 可取消调用。build_manifest/identity,一次中途失败的 Save 之后无法从证据回答"这个 CBB 是否被写过"。.prj时不保留 before 字节:native_management.py:345-363→_align_library→ensure_project_central_library(evidence_dir=None),只在reference-alignment.json里留哈希。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.py43 passed、test_desktop_worker.py12 passed、test_operation_queue+test_status_bridge10 passed、test_batch_status_faults4 passed;跑前都确认了没有其它 pytest 进程(避免Local\CbbRefreshVerify795争用)。未验证边界
深审补充:备份 / 恢复路径(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)。rename(保留原 Work → 放入新 Work),第二步失败会回滚第一步(265-270)。Work.before-restore-<token>)。需要修的是替换瞬间的可恢复性和最后一段空闲证明。
P2-1 两个 rename 之间没有持久化阶段记录,崩溃后没有补完/回滚路径
backup_recovery.py:264-272。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()因共享冲突失败,异常向上抛,库没被改(安全),但报错是通用异常,操作员看不出"是因为有人打开了工程"。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 天后可清理,并在报告里给出路径。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"。测试质量审计(链路顶端
dc536da)+ 对上一条 P1-1 的精确化结论
测试文化整体是好的:以证据/行为断言为主,不用 mock 调用断言。但存在一类系统性盲区——把被测的守卫本身 stub 掉,导致"守卫失效"永远不会被测出来。
量化
assert_called*类断言result.json/session-releasesubprocess/Popen(跑真 VBS、真 worker)monkeypatch.setattridle_checkbackup_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 目录"。test_desktop_worker.py只覆盖了 verify/repair 的 watchdog)。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。session-release.json应该写什么。对上一条 P1-1 的精确化(重要,避免误伤作者)
我在评论 297 里说"取消会强杀正在 Save 的 cscript"。补充两点更准确的事实:
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)。automation_release_state()在_stop_worker之后才采样(verify_runner.py:1131-1135),因此"被我们杀掉的 helper"不会出现在remaining_pids里,session-release.json会写safe_to_continue: true;应改为先采样、再决定是否终止,并把save_helper_terminated作为独立字段落盘。SAVE_OK标记,Python 侧应单独记save_committed: true/false,而不是与CLOSE_OK合在一个布尔门里(save_verified_block.vbs+mentor_adapter.py:846-851)。建议的补测优先级
_stop_worker在"保存进行中"时的采样顺序与证据字段(P1-1 的修复必须有对应用例)。深审补充 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零调用者。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
backup_project(native_repair.py:64-124,全树备份 + 逐文件哈希 + 备份期间独占icdb.dat+ 检测源文件变化)在生产代码中零调用,只有测试用;不要让人误以为 Repair 前会自动做完整备份(UI 文案"应用不自动备份"是对的)。attempt_recovery的"任何 PCB 进程存在即拒绝"(:148-149)与 verify 路径"无关工程可以开着"(mentor_adapter.py:609-610)矛盾:应改成 scoped 匹配(_native_scope_match/_idle_check已有的能力),否则现场开着别的设计就永远修不了。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。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 就能把"本来不点的规则"改成"点",属于"配置可以静默降低安全性"。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透传,自身不再校验。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的调用者搜索为零。审查 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 手册/发布说明)同步。逐条复核
result.json;证据写失败仍报RELEASE_CONFIRMEDresult.json再动原生(residual_sessions.py:435-444的save());每个动作前写REQUESTING、动作后写结果;整体try/except BaseException+finally: save();save()失败把status降PARTIAL+report_saved=False;UI 追加"记录保存失败:…"native_activity()(:44-68):窗口读取不完整 →UNCONFIRMED、有进度条/主窗禁用 →ACTIVE、iCDB Backup 输出里最后一条 repairing/restoring/backing up 晚于结束标记 →ACTIVE;force_block_reason对ACTIVE/UNCONFIRMED直接拒绝;_force_close在拿到句柄后又重采一次再判;stop在TerminateProcess之前检查desktop;表格新增"窗口位置/程序路径";新增"查看原生提示…"(标题/输出/静态控件文本);私有桌面时 detail 追加提示.lmc不存在时报"请选择有效的 .lmc"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 崩溃后的孤儿会话)。建议:
incomplete()不要伪造窗口塞进windows,改成按 pid 维护windows_incomplete=True,让close_target/native_activity/force_block_reason只对受影响的那个 pid 收紧;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)。边界
mkdir(mode=0o700)会得到进程自己打不开的目录),本轮未复跑测试。native_activity的输出正则是对真实 Output 文本的启发式判断,需要现场语料校准(尤其"Backup information loaded correctly."之外的结束标记)。结论:修复后合并(1×P2 + 2×P3,无 P1)。
完整审查 #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_allowedvsrelease_status的差异列(或结果摘要里一句"2 项预览允许、1 项执行时被拒绝:<原因>")。与链路后续的关系
#13 在这之后接入了"只读观察/后台接管/队列解除"(
session_record侧),本 PR 的inspect(被动预览)与release(显式释放)主流程未被改写,只在释放成功后追加了会话释放记录;本次指出的 P2 在 #13 的跟进里仍未处理。边界
native_activity的 Output 正则是启发式,需要现场语料校准("Backup information loaded correctly." 之外的结束标记)。复核 #348 的修复(head
a7df1056):P2 与两个 P3 均已解决——可以合并新增三个提交:
651b539(不可读会话按 PID 隔离、证据有界)、14c9a74(确认范围与执行结果并列)、a7df1056(结果窗口退役后重建续做入口)。逐条
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参数,只收紧受影响的那个会话_session_evidence():窗口只留hwnd/title/class/desktop/enabled,输出截断到 4096 字节并存output_bytes/output_sha256/output_truncated,native_activity去掉 output;result.json与consent.json都改用它,完整预览仍留在内存供"查看原生提示"request_native_cancel现在携带预览的block_names,释放时用Work + SymbolLibs窄作用域复核,不再默默放大到整库我额外核对的点
release_residual_sessions先拿全局互斥Local\CbbRefreshVerify795,而正在执行的校验/管理在 supervisor 侧持有同一互斥,取不到就直接返回"其它批次尚在执行",不会关闭任何进程。这条保护是有效的。CbbManagement_*上创建真实窗口、由另一进程读取)很有价值——正是它暴露了EnumThreadWindows不跨桌面的平台限制。遗留
无阻断项。只剩一句文档层面的提醒:
native_activity对 iCDB Backup 输出的判定仍是启发式正则,现场若出现"Backup information loaded correctly."之外的结束语,需要补充语料(这与真实性验收边界一致)。结论:可以合并(0 P1/P2/P3 阻断)。