修复原生调用停止、管理监督与只读状态边界 #13

Merged
abaishu0730 merged 28 commits from codex/runtime-lifecycle-safety into main 2026-11-12 17:40:06 +08:00
Owner

停止、超时或监督器失联时,旧路径可能终止仍在 Save/Close 的 cscript,再把进程退出描述为已释放。本 PR 改为停止后续原生动作、保留当前调用和精确身份,必要时转后台观察;保存、关闭、资源释放分别记录。同库活跃写入继续受保护,独立库可以排队运行。

依赖 #12,基线为其当前 head 5eb4b2d。本 PR 仅包含本轮运行时差分,保持 Draft;不合并、不正式发布、不关闭工单。

建议按以下顺序审查:

  1. A:保存事实与会话协议(7bd7cd3、97a3de2),helper 启动门及所有停止/watchdog/finally 路径(8d3eab1)。不强杀可能正在原生写入的 worker/helper,120 秒为后台交接界限。
  2. B:管理监督与事务边界(6278091)、重启观察和按库队列接线(cb11624)。更新在移除后取消时保留需恢复检查点,不继续导入,不自动重放。
  3. C:只读状态边界与 GUI/CLI。legacy 只观察已有匹配 LM,无法读取保持 UNKNOWN;不启动 LM、回答提示或关闭用户窗口。与 A 共用 mentor_adapter 的修改合并在 8d3eab1。

独立只读审查后,补齐 PID 复用后继续独立资源核对、异步 Add/CLOSING 阶段、权限 COM 查询后的取消检查,以及 Add 提交前阶段记录必须成功。记录失败发生在既有调用中时继续保留监督;发生在新 Add 提交前则不发出该写入。未确认结束的异步 Add 不自动 Close/Quit,明确已应答的失败才正常收尾(d9a79b6、051498b)。

验证:最终产品源码 5873b71,1,717 passed;compileall、diff 检查通过。正式 0.2.4b2 冻结程序的 GUI、verify-worker 启动前取消、management-worker 错误桌面拒绝、owner-probe、dialog-agent 只读空范围均通过;62 个冻结产品模块字节码与当前源码一致。独立冻结夹具的保存/管理 × 取消/父进程退出四个场景通过,实际执行的 helper 脚本已归档到 tests/support,未随产品打包。唯一测试警告为已知 pywinauto STA 提示。

可复核记录:docs/releases/2026-11-06-runtime-lifecycle-validation.json;候选说明:docs/releases/2026-11-06-runtime-lifecycle-candidate.md。本地已生成 54,227,147 字节的便携 ZIP,SHA-256 为 5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b,未作为正式 Release 发布。

真实 Mentor 隔离副本的应用按钮流程、Windows 10/网络共享及跨机器并发、现场 ICDB 失联恢复与版本/READY 仍未验收。冻结夹具替换了外部原生边界,不能替代这些验收。ICDB 自动 Repair 保持关闭;未修改生产库、删除原生锁/地址文件或结束真实 Mentor 进程。程序回退不撤销数据库事务,数据恢复仍需人工一致备份或明确选择的原生历史。

图标修正

44bb734 将原工作区的新版蓝色对勾/环形箭头 ICO、PNG、SVG 同步到本分支,修正首次候选漏带新图标的问题。已重新打包,核对 EXE 内嵌的七个尺寸图标、Qt 窗口图标和包内三份图片一致,13 项打包测试与冻结入口冒烟通过,62 个产品模块字节码与源码一致。此项只替换资源,未重复业务全量;前述 1,717 项为相同业务代码的全量记录。

上一轮本地包(不含 11 月 9 日修正):CbbRefreshVerify-0.2.4b2-iconfix-44bb734.zip,56,846,008 字节;SHA-256:4a0a96321801fdebf13fed0f850a0c4b32d6928480288fd35c2d36f534e6e5b5。记录:docs/releases/2026-11-06-icon-candidate-validation.json。首次候选包的记录保留用于追溯。

11 月 9 日审查修正

ca39fb3 修复评论 #319:显式释放取得新证据后,同步解除此前保留的同库队列记录,保留其他库和新任务;残留面板可刷新当前任务与历史记录,并持久化已释放状态。历史扫描与启动观察仅查询进程,不再独占打开生产库或删除协调检查点。

监督器退出后,仅当本轮日志、同步的内存阶段均确认没有原生写入且保存/关闭客户端已退出时,才结束空闲 Python 工作进程;在途调用和未知状态继续保留并复核。状态日志写入与 watchdog 读取串行,避免 Windows 文件共享竞争。删除未使用的 _terminate_pid。

验证:全量 1,732 passed(505.63 秒);重点回归 79 passed;compileall、git diff --check 通过。独立代码复查无剩余重要问题。详见 docs/releases/2026-11-09-review-319-validation.md 和同名 JSON。

本轮尚未重新打包,之前的 iconfix 测试包不含这些修改。真实 Mentor、冻结程序的新行为、Windows 10 和网络共享场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不关闭工单。

11 月 9 日其他 PR 复核跟进

已集成 #10 评论 #309、#12 评论 #313 的修复,并在链路末端处理 #11 评论 #310 的两个文件行尾规则。合并保留 ca39fb3 的内存阶段/原生写入保护、队列释放证明及持久化完成记录;新版图标未改变。

最终集成全量 1,742 passed;重点集成回归 136 passed;compileall 和 diff 检查通过。真实 Windows 私有桌面窗口夹具通过,独立集成复查无重要问题。记录 docs/releases/2026-11-09-latest-pr-stack-validation.json 和同名 Markdown。

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

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

已集成本轮 #344/#345/#348 修复,并处理 #326 的新增建议:管理派发统一进入 pending/返回/未知状态;监督器失联拒绝新调用,但已启动 Remove 的身份登记与等待允许受控继续;整库释放记录全部相关 CBB 和精确 operation_id,代次/操作变化不会被旧证明清除。

排队提示显示具体残留 CBB,验证/ICDB/管理均有处理入口;等待原因变化会更新提示。释放中的映射处理在同一串行释放动作内完成,然后才让排队任务恢复,避免旧证明影响新保留映射。关闭窗口也等待独立生命周期任务。重复摘要关闭后续做入口可重建,不保留已删除按钮引用。

最终集成全量 1775 passed;重点集成回归 211 passed;终态顺序修正后生命周期/管理回归 159 passed;compileall、diff 检查通过。独立复查提出的两个队列时序问题已修并复核无剩余重要发现。首轮全量发现 FINISHED 早于 result.json 发布的竞争,现已调整为先持久化结果再写终态,并保留失败 XML 与重跑记录。记录 docs/releases/2026-11-09-full-review-followup.md 与 ...-validation.json。

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

2026-11-11:评论 381 与交错操作回归

校验取得执行机会后,立即更新执行状态并隐藏已过期的残留入口。显示和点击均复核当前内存状态;延迟消息、重复点击及关闭期间的点击不会重新打开过期面板。前台结束不会清除独立后台 ICDB 任务仍需要的入口,后台结束或取消也不会误清同库前台的有效等待。

验证:全量 1,789 passed;加强并发屏障后相关回归 57 passed;Windows 11 原生 Qt 控件在私有桌面连续两次 21 passed 并正常退出,覆盖连点、取消、重开及两种结束顺序。恢复旧队列接纳方法的负向对照会稳定失败。一次早期外层验证控制器返回 1 已单独记录,没有计为完整通过。

新冻结候选包已重建:5 项冒烟通过,62 个包内模块与测试源码一致,新版图标及 EXE 图标资源一致。编译和差异检查通过。记录:docs/releases/2026-11-11-pr13-review381.md 与相邻验证 JSON。

此轮没有新增库锁或更改整批调度;真实 Mentor Save/Close/Add/Remove、现场 ICDB 修复、Windows 10 与共享库场景仍未验收。保留 Draft,不合并发布、不关闭现场工单。

2026-11-11:逐按钮模拟操作验证

补齐 46 项按钮测试,覆盖全部 48 个应用按钮/复选项(含版本和动态结果选项)、3 个菜单页签,以及文件选择和确认框选项。Windows 私有桌面的真实 Qt 界面组 276 passed 并正常退出,记录 281 次点击信号和 28 张代表性截图;全量 1,835 passed,只有既有 STA COM 模式警告。

故障注入发现“打开日志目录”在目录创建或系统打开失败时向 Qt 循环抛出异常,现已通过既有 UI 错误路径报告。两种故障均先失败后通过。新增场景包含重复点击、停止、取消、关闭重开、禁用状态及动态结果入口。

逐按钮清单和证据:docs/releases/2026-11-11-button-simulation.md 与相邻验证 JSON。新候选包已在 F 盘完成构建及 5 项冻结冒烟,62 个包内模块与测试源码一致,图标资源一致。首次 C 盘空间不足的构建失败记录保留,未计为通过。

这轮验证的是界面连接、参数、状态和错误处理。原生写库/回退/保存/取消/强制结束使用受控替身,未操作现场库;真实 Mentor、ICDB 修复、Windows 10 与跨机器共享库仍未验收。保持 Draft,未合并或发布。

停止、超时或监督器失联时,旧路径可能终止仍在 Save/Close 的 cscript,再把进程退出描述为已释放。本 PR 改为停止后续原生动作、保留当前调用和精确身份,必要时转后台观察;保存、关闭、资源释放分别记录。同库活跃写入继续受保护,独立库可以排队运行。 依赖 #12,基线为其当前 head `5eb4b2d`。本 PR 仅包含本轮运行时差分,保持 Draft;不合并、不正式发布、不关闭工单。 建议按以下顺序审查: 1. A:保存事实与会话协议(7bd7cd3、97a3de2),helper 启动门及所有停止/watchdog/finally 路径(8d3eab1)。不强杀可能正在原生写入的 worker/helper,120 秒为后台交接界限。 2. B:管理监督与事务边界(6278091)、重启观察和按库队列接线(cb11624)。更新在移除后取消时保留需恢复检查点,不继续导入,不自动重放。 3. C:只读状态边界与 GUI/CLI。legacy 只观察已有匹配 LM,无法读取保持 UNKNOWN;不启动 LM、回答提示或关闭用户窗口。与 A 共用 mentor_adapter 的修改合并在 8d3eab1。 独立只读审查后,补齐 PID 复用后继续独立资源核对、异步 Add/CLOSING 阶段、权限 COM 查询后的取消检查,以及 Add 提交前阶段记录必须成功。记录失败发生在既有调用中时继续保留监督;发生在新 Add 提交前则不发出该写入。未确认结束的异步 Add 不自动 Close/Quit,明确已应答的失败才正常收尾(d9a79b6、051498b)。 验证:最终产品源码 `5873b71`,**1,717 passed**;compileall、diff 检查通过。正式 0.2.4b2 冻结程序的 GUI、verify-worker 启动前取消、management-worker 错误桌面拒绝、owner-probe、dialog-agent 只读空范围均通过;62 个冻结产品模块字节码与当前源码一致。独立冻结夹具的保存/管理 × 取消/父进程退出四个场景通过,实际执行的 helper 脚本已归档到 tests/support,未随产品打包。唯一测试警告为已知 pywinauto STA 提示。 可复核记录:`docs/releases/2026-11-06-runtime-lifecycle-validation.json`;候选说明:`docs/releases/2026-11-06-runtime-lifecycle-candidate.md`。本地已生成 54,227,147 字节的便携 ZIP,SHA-256 为 `5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b`,未作为正式 Release 发布。 真实 Mentor 隔离副本的应用按钮流程、Windows 10/网络共享及跨机器并发、现场 ICDB 失联恢复与版本/READY 仍未验收。冻结夹具替换了外部原生边界,不能替代这些验收。ICDB 自动 Repair 保持关闭;未修改生产库、删除原生锁/地址文件或结束真实 Mentor 进程。程序回退不撤销数据库事务,数据恢复仍需人工一致备份或明确选择的原生历史。 ### 图标修正 44bb734 将原工作区的新版蓝色对勾/环形箭头 ICO、PNG、SVG 同步到本分支,修正首次候选漏带新图标的问题。已重新打包,核对 EXE 内嵌的七个尺寸图标、Qt 窗口图标和包内三份图片一致,13 项打包测试与冻结入口冒烟通过,62 个产品模块字节码与源码一致。此项只替换资源,未重复业务全量;前述 1,717 项为相同业务代码的全量记录。 上一轮本地包(不含 11 月 9 日修正):CbbRefreshVerify-0.2.4b2-iconfix-44bb734.zip,56,846,008 字节;SHA-256:4a0a96321801fdebf13fed0f850a0c4b32d6928480288fd35c2d36f534e6e5b5。记录:docs/releases/2026-11-06-icon-candidate-validation.json。首次候选包的记录保留用于追溯。 ### 11 月 9 日审查修正 ca39fb3 修复评论 #319:显式释放取得新证据后,同步解除此前保留的同库队列记录,保留其他库和新任务;残留面板可刷新当前任务与历史记录,并持久化已释放状态。历史扫描与启动观察仅查询进程,不再独占打开生产库或删除协调检查点。 监督器退出后,仅当本轮日志、同步的内存阶段均确认没有原生写入且保存/关闭客户端已退出时,才结束空闲 Python 工作进程;在途调用和未知状态继续保留并复核。状态日志写入与 watchdog 读取串行,避免 Windows 文件共享竞争。删除未使用的 `_terminate_pid`。 验证:全量 1,732 passed(505.63 秒);重点回归 79 passed;compileall、git diff --check 通过。独立代码复查无剩余重要问题。详见 docs/releases/2026-11-09-review-319-validation.md 和同名 JSON。 本轮尚未重新打包,之前的 iconfix 测试包不含这些修改。真实 Mentor、冻结程序的新行为、Windows 10 和网络共享场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不关闭工单。 ### 11 月 9 日其他 PR 复核跟进 已集成 #10 评论 #309、#12 评论 #313 的修复,并在链路末端处理 #11 评论 #310 的两个文件行尾规则。合并保留 ca39fb3 的内存阶段/原生写入保护、队列释放证明及持久化完成记录;新版图标未改变。 最终集成全量 1,742 passed;重点集成回归 136 passed;compileall 和 diff 检查通过。真实 Windows 私有桌面窗口夹具通过,独立集成复查无重要问题。记录 docs/releases/2026-11-09-latest-pr-stack-validation.json 和同名 Markdown。 本轮仅处理 11 月 9 日最新复核意见,11 月 6 日旧深审遗留不在所选范围。没有重新打包;旧测试包不含这些改动。真实 Mentor、Windows 10、共享库/跨机器场景仍未验收。保持 Draft,不合并、不关闭工单。 ### 11 月 9 日完整审查后续修正 已集成本轮 #344/#345/#348 修复,并处理 #326 的新增建议:管理派发统一进入 pending/返回/未知状态;监督器失联拒绝新调用,但已启动 Remove 的身份登记与等待允许受控继续;整库释放记录全部相关 CBB 和精确 operation_id,代次/操作变化不会被旧证明清除。 排队提示显示具体残留 CBB,验证/ICDB/管理均有处理入口;等待原因变化会更新提示。释放中的映射处理在同一串行释放动作内完成,然后才让排队任务恢复,避免旧证明影响新保留映射。关闭窗口也等待独立生命周期任务。重复摘要关闭后续做入口可重建,不保留已删除按钮引用。 最终集成全量 1775 passed;重点集成回归 211 passed;终态顺序修正后生命周期/管理回归 159 passed;compileall、diff 检查通过。独立复查提出的两个队列时序问题已修并复核无剩余重要发现。首轮全量发现 FINISHED 早于 result.json 发布的竞争,现已调整为先持久化结果再写终态,并保留失败 XML 与重跑记录。记录 docs/releases/2026-11-09-full-review-followup.md 与 ...-validation.json。 本轮未重新打包;旧 iconfix 测试包不含本轮修复。图标和两处 LF 规则保持。真实 Mentor、冻结新行为、Windows 10、共享库/跨机器场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不发布、不关闭工单。 ## 2026-11-11:评论 381 与交错操作回归 校验取得执行机会后,立即更新执行状态并隐藏已过期的残留入口。显示和点击均复核当前内存状态;延迟消息、重复点击及关闭期间的点击不会重新打开过期面板。前台结束不会清除独立后台 ICDB 任务仍需要的入口,后台结束或取消也不会误清同库前台的有效等待。 验证:全量 **1,789 passed**;加强并发屏障后相关回归 **57 passed**;Windows 11 原生 Qt 控件在私有桌面连续两次 **21 passed** 并正常退出,覆盖连点、取消、重开及两种结束顺序。恢复旧队列接纳方法的负向对照会稳定失败。一次早期外层验证控制器返回 1 已单独记录,没有计为完整通过。 新冻结候选包已重建:5 项冒烟通过,62 个包内模块与测试源码一致,新版图标及 EXE 图标资源一致。编译和差异检查通过。记录:`docs/releases/2026-11-11-pr13-review381.md` 与相邻验证 JSON。 此轮没有新增库锁或更改整批调度;真实 Mentor Save/Close/Add/Remove、现场 ICDB 修复、Windows 10 与共享库场景仍未验收。保留 Draft,不合并发布、不关闭现场工单。 ## 2026-11-11:逐按钮模拟操作验证 补齐 46 项按钮测试,覆盖全部 48 个应用按钮/复选项(含版本和动态结果选项)、3 个菜单页签,以及文件选择和确认框选项。Windows 私有桌面的真实 Qt 界面组 **276 passed** 并正常退出,记录 281 次点击信号和 28 张代表性截图;全量 **1,835 passed**,只有既有 STA COM 模式警告。 故障注入发现“打开日志目录”在目录创建或系统打开失败时向 Qt 循环抛出异常,现已通过既有 UI 错误路径报告。两种故障均先失败后通过。新增场景包含重复点击、停止、取消、关闭重开、禁用状态及动态结果入口。 逐按钮清单和证据:`docs/releases/2026-11-11-button-simulation.md` 与相邻验证 JSON。新候选包已在 F 盘完成构建及 5 项冻结冒烟,62 个包内模块与测试源码一致,图标资源一致。首次 C 盘空间不足的构建失败记录保留,未计为通过。 这轮验证的是界面连接、参数、状态和错误处理。原生写库/回退/保存/取消/强制结束使用受控替身,未操作现场库;真实 Mentor、ICDB 修复、Windows 10 与跨机器共享库仍未验收。保持 Draft,未合并或发布。
Author
Owner

审查 5/5(head 96e179b):三条 P1 已按方向修好,新增 1×P2 + 3×P3

范围:5eb4b2d..96e179ba,32 个提交,21 个源码文件 + 29 个测试文件 + 6 篇文档。核心是新增 session_record.py(351)、operation_lifecycle.py(55),以及 desktop_worker.py、verify_runner.py、mentor_adapter.py、native_management.py、library_reader.py、save_verified_block.vbs 的改动。

三条 P1 的复核

前轮 P1 现在的实现 判定
P1-1 取消/超时落在 Save 阶段会 taskkill /F 正在保存的 cscript,随后证据记成"已安全释放" stop_automation_clients() 不再终止进程,改成返回 pid 列表(desktop_worker.py:199-202);kill() 对 native worker/绑定了 cancel 文件的 worker 直接返回不结束(:207-215);_stop_worker 只做"请求停止 → 等 5s → 若 native_write_pending() 非 False 再等到 120s"(verify_runner.py:233-256,defaults.NATIVE_WRITE_STOP_WAIT_SECONDS=120);VBS 改为 WaitForStartGate(30s 超时、期间可取消)后 SAVE_START 之后不再检查取消,Save→IsSaved→PostSave→Close 跑完并分别输出 SAVE_OK/SAVE_REJECTED/SAVE_RESULT_UNKNOWN/POST_SAVE_FAILED/CLOSE_OK/CLOSE_FAILED;automation_release_state() 只有"worker 已退出且无 cscript 残留"才 safe_to_continue=True(desktop_worker.py:191-197);未退出则 handoff_session 转后台观察(verify_runner.py:1169-1177) 已修,和 tests/test_failure_lifecycle.py 里那条"挂起的 save helper 必须存活"的既有断言终于一致了
P1-2 管理 worker 没有 watchdog、不读取消文件 启动时注入 cancel_signal/start_gate/session_record_path/operation_id/supervisor_pid/supervisor_identity,bind_cancellation() + bind_session()(native_management.py:220-250);worker 内 armed start_supervisor_watchdog(..., session_record_path=..., operation_id=...)(:1227-1228);每个新原生调用前 _require_management_continuation()(6 处),校验取消文件、父进程存活与父进程身份;超时后 handoff_session 转观察(:259-262) 已修(边界见下面 P2)
P1-3 只读状态刷新会启动私有桌面 LM 并 positive-first 应答 scan_open_library_status 不再走 pywinauto 直探,也不再回退到"启动 LM"的读取;read_library_tree_image_map → _existing_library_tree_images(mentor_adapter.py:1479-1510),只观察唯一、已打开、enabled、路径匹配的 LM,找不到/不唯一/被禁用都返回 None;UNKNOWN 不再被伪装成 PENDING(library_reader.py:284-287),由调用方决定资格 已修

前轮深审的 P2 里顺带修掉两条:auto_repair 之后复验现在传 stop(verify_runner.py:602/627/705);_terminate_pid 不再被任何生产路径使用(只剩测试)。仍未处理(本 PR 范围外,建议另开):is_reusable_circuit_pcb 仍把"身份未知"当"不是目标"、verify 写路径仍缺 _idle_check、dialog_probe 的 UIA 线程、失败路径无写前基线、Add 改写库内 .prj 不保留 before 字节。

新发现

[P2] watchdog 不再结束 worker,"监督器失联"只剩"下次启动扫描"这一条兜底

start_supervisor_watchdog 删掉了 os._exit(75)(全仓已无 os._exit),现在只做三件事:置 _supervisor_lost、touch cancel 文件、写 supervisor-lost.json(desktop_worker.py:43-72)。

设计意图我认同(不打断在途 COM 调用),但副作用没被接住:

  • worker 只有在下一个取消检查点才会退出;若它卡在非 COM 的长循环(UIA 轮询、等原生对话框、_wait_native_exit),就会长时间"无人监督";
  • 正常路径下的接管者 handoff_session(verify_runner.py:1171-1177、native_management.py:259-262)是supervisor 自己调的——supervisor 已死,这条路径不会执行;
  • 兜底是 _show_unfinished_management() → discover_sessions()(main_window.py:324 启动时、:682 管理失败后),它依赖 session.json/worker-state.json 落在磁盘上。而 update_worker_state(..., required=False) 在记录写失败时只打 warning 继续(session_record.py:41-65,注释写明"不能打断已执行的 COM 调用")——磁盘异常恰恰是崩溃的同源场景,此时重启后也扫不到残留。

建议:watchdog 在写完 supervisor-lost.json 后读一次 native_write_pending()——明确为 False(调用未开始/已返回)时直接 os._exit(75),为 True/None 时保持保留。这样"记录可用"时行为与旧版一致,"记录不可用"时仍保守。另外把 discover_sessions 接到运行中的"查看残留"入口,而不是只在新会话启动/管理失败时扫描。

[P3] 被动扫描会做释放证明,短暂独占打开生产库并删除库上检查点

_show_unfinished_management() 的文案是"只显示记录,不自动重放"(main_window.py:471),但它调用的 discover_sessions() → reconcile_session_record() → _reconcile() 在确认无存活进程后会调用 release_retained_library()(session_record.py:179-189):对 .lmc/icdb.dat/layoutdb.lyt 取独占句柄、归档并删除库上的 blocker 检查点。在共享库上这会短暂挡住其它用户,且属于"看报告的动作改了库上的状态"。建议扫描阶段只读(ACTIVE/UNCONFIRMED),把 reconcile 留给显式的"核对并解除历史占用"或队列门禁。

[P3] 一次 UNCONFIRMED 会把这个库在本进程内永久挡在队列外,且没有解除入口

handoff_session 把库别名写进 _retained_libraries(session_record.py:254-258),只有观察线程最终拿到 RELEASED 才移除(:270-271)。若观察以 UNCONFIRMED 结束(另一台机器仍持有库、proof 需要人工、OpenProcess 被拒),别名不移除 → library_available() 恒 False(:24-28)→ 该库的排队任务一直"等待中",界面既没有"为什么被挡"的说明,也没有"重新核对"的按钮,只能重启应用。建议:观察线程退出时把最终状态上报到残留面板,并给一个显式的"重新核对/解除阻塞"动作。

[P3] _terminate_pid 成为死代码

desktop_worker 已改为返回 pid 列表而不是终止(desktop_worker.py:199-202),mentor_adapter.py:931 的 _terminate_pid 现在只有测试在用。建议删除或标注为测试辅助,别让后来者以为还存在强杀路径。

验证与边界

  • 代码级:上述 file:line 均在本 PR 树内逐条读过。
  • 本机沙箱无法创建 pytest 临时目录(mkdir(mode=0o700) 会得到进程自己都打不开的目录),本轮没有复跑测试,PR 自述的 1,717 passed / 冻结夹具四场景 / 62 模块字节码一致都未复现;只确认了对应记录文件存在(docs/releases/2026-11-06-runtime-lifecycle-validation.json、...-candidate.md)。
  • 未验证:真实 Mentor 的 Save/Close 与"保存中途停止"、管理新增/移除在停止与父进程被杀时的行为、Windows 10/网络共享、native_activity 的 Output 正则对现场语料的适配。

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

# 审查 5/5(head `96e179b`):三条 P1 已按方向修好,新增 1×P2 + 3×P3 范围:`5eb4b2d..96e179ba`,32 个提交,21 个源码文件 + 29 个测试文件 + 6 篇文档。核心是新增 `session_record.py`(351)、`operation_lifecycle.py`(55),以及 `desktop_worker.py`、`verify_runner.py`、`mentor_adapter.py`、`native_management.py`、`library_reader.py`、`save_verified_block.vbs` 的改动。 ## 三条 P1 的复核 | 前轮 P1 | 现在的实现 | 判定 | | --- | --- | --- | | **P1-1** 取消/超时落在 Save 阶段会 `taskkill /F` 正在保存的 cscript,随后证据记成"已安全释放" | `stop_automation_clients()` 不再终止进程,改成返回 pid 列表(`desktop_worker.py:199-202`);`kill()` 对 native worker/绑定了 cancel 文件的 worker 直接返回不结束(`:207-215`);`_stop_worker` 只做"请求停止 → 等 5s → 若 `native_write_pending()` 非 False 再等到 120s"(`verify_runner.py:233-256`,`defaults.NATIVE_WRITE_STOP_WAIT_SECONDS=120`);VBS 改为 `WaitForStartGate`(30s 超时、期间可取消)后 **SAVE_START 之后不再检查取消**,Save→IsSaved→PostSave→Close 跑完并分别输出 `SAVE_OK/SAVE_REJECTED/SAVE_RESULT_UNKNOWN/POST_SAVE_FAILED/CLOSE_OK/CLOSE_FAILED`;`automation_release_state()` 只有"worker 已退出且无 cscript 残留"才 `safe_to_continue=True`(`desktop_worker.py:191-197`);未退出则 `handoff_session` 转后台观察(`verify_runner.py:1169-1177`) | **已修**,和 `tests/test_failure_lifecycle.py` 里那条"挂起的 save helper 必须存活"的既有断言终于一致了 | | **P1-2** 管理 worker 没有 watchdog、不读取消文件 | 启动时注入 `cancel_signal/start_gate/session_record_path/operation_id/supervisor_pid/supervisor_identity`,`bind_cancellation()` + `bind_session()`(`native_management.py:220-250`);worker 内 armed `start_supervisor_watchdog(..., session_record_path=..., operation_id=...)`(`:1227-1228`);每个新原生调用前 `_require_management_continuation()`(6 处),校验取消文件、父进程存活与父进程身份;超时后 `handoff_session` 转观察(`:259-262`) | **已修**(边界见下面 P2) | | **P1-3** 只读状态刷新会启动私有桌面 LM 并 positive-first 应答 | `scan_open_library_status` 不再走 pywinauto 直探,也不再回退到"启动 LM"的读取;`read_library_tree_image_map` → `_existing_library_tree_images`(`mentor_adapter.py:1479-1510`),**只观察唯一、已打开、enabled、路径匹配的 LM**,找不到/不唯一/被禁用都返回 None;`UNKNOWN` 不再被伪装成 `PENDING`(`library_reader.py:284-287`),由调用方决定资格 | **已修** | 前轮深审的 P2 里顺带修掉两条:`auto_repair` 之后复验现在传 `stop`(`verify_runner.py:602/627/705`);`_terminate_pid` 不再被任何生产路径使用(只剩测试)。仍未处理(本 PR 范围外,建议另开):`is_reusable_circuit_pcb` 仍把"身份未知"当"不是目标"、verify 写路径仍缺 `_idle_check`、`dialog_probe` 的 UIA 线程、失败路径无写前基线、Add 改写库内 `.prj` 不保留 before 字节。 ## 新发现 ### [P2] watchdog 不再结束 worker,"监督器失联"只剩"下次启动扫描"这一条兜底 `start_supervisor_watchdog` 删掉了 `os._exit(75)`(全仓已无 `os._exit`),现在只做三件事:置 `_supervisor_lost`、touch cancel 文件、写 `supervisor-lost.json`(`desktop_worker.py:43-72`)。 设计意图我认同(不打断在途 COM 调用),但副作用没被接住: - worker 只有在**下一个取消检查点**才会退出;若它卡在非 COM 的长循环(UIA 轮询、等原生对话框、`_wait_native_exit`),就会长时间"无人监督"; - 正常路径下的接管者 `handoff_session`(`verify_runner.py:1171-1177`、`native_management.py:259-262`)是**supervisor 自己**调的——supervisor 已死,这条路径不会执行; - 兜底是 `_show_unfinished_management()` → `discover_sessions()`(`main_window.py:324` 启动时、`:682` 管理失败后),它依赖 `session.json`/`worker-state.json` 落在磁盘上。而 `update_worker_state(..., required=False)` 在记录写失败时**只打 warning 继续**(`session_record.py:41-65`,注释写明"不能打断已执行的 COM 调用")——磁盘异常恰恰是崩溃的同源场景,此时重启后也扫不到残留。 建议:watchdog 在写完 `supervisor-lost.json` 后读一次 `native_write_pending()`——明确为 `False`(调用未开始/已返回)时直接 `os._exit(75)`,为 `True/None` 时保持保留。这样"记录可用"时行为与旧版一致,"记录不可用"时仍保守。另外把 `discover_sessions` 接到运行中的"查看残留"入口,而不是只在新会话启动/管理失败时扫描。 ### [P3] 被动扫描会做释放证明,短暂独占打开生产库并删除库上检查点 `_show_unfinished_management()` 的文案是"只显示记录,不自动重放"(`main_window.py:471`),但它调用的 `discover_sessions()` → `reconcile_session_record()` → `_reconcile()` 在确认无存活进程后会调用 `release_retained_library()`(`session_record.py:179-189`):对 `.lmc`/`icdb.dat`/`layoutdb.lyt` 取独占句柄、归档并**删除**库上的 blocker 检查点。在共享库上这会短暂挡住其它用户,且属于"看报告的动作改了库上的状态"。建议扫描阶段只读(`ACTIVE`/`UNCONFIRMED`),把 reconcile 留给显式的"核对并解除历史占用"或队列门禁。 ### [P3] 一次 `UNCONFIRMED` 会把这个库在本进程内永久挡在队列外,且没有解除入口 `handoff_session` 把库别名写进 `_retained_libraries`(`session_record.py:254-258`),只有观察线程最终拿到 `RELEASED` 才移除(`:270-271`)。若观察以 `UNCONFIRMED` 结束(另一台机器仍持有库、proof 需要人工、`OpenProcess` 被拒),别名不移除 → `library_available()` 恒 `False`(`:24-28`)→ 该库的排队任务一直"等待中",界面既没有"为什么被挡"的说明,也没有"重新核对"的按钮,只能重启应用。建议:观察线程退出时把最终状态上报到残留面板,并给一个显式的"重新核对/解除阻塞"动作。 ### [P3] `_terminate_pid` 成为死代码 `desktop_worker` 已改为返回 pid 列表而不是终止(`desktop_worker.py:199-202`),`mentor_adapter.py:931` 的 `_terminate_pid` 现在只有测试在用。建议删除或标注为测试辅助,别让后来者以为还存在强杀路径。 ## 验证与边界 - 代码级:上述 `file:line` 均在本 PR 树内逐条读过。 - 本机沙箱无法创建 pytest 临时目录(`mkdir(mode=0o700)` 会得到进程自己都打不开的目录),**本轮没有复跑测试**,PR 自述的 1,717 passed / 冻结夹具四场景 / 62 模块字节码一致都未复现;只确认了对应记录文件存在(`docs/releases/2026-11-06-runtime-lifecycle-validation.json`、`...-candidate.md`)。 - 未验证:真实 Mentor 的 Save/Close 与"保存中途停止"、管理新增/移除在停止与父进程被杀时的行为、Windows 10/网络共享、`native_activity` 的 Output 正则对现场语料的适配。 **结论:修复后合并(1×P2 + 3×P3,无 P1)。**
Author
Owner

审查 6/6(复核 head ca39fb3,评论 319 的修复):1×P2 + 3×P3 全部按方向修好,新增 3×P3

范围:96e179ba..ca39fb35,1 个提交(ca39fb3 fix: clear verified queue blockers and exit idle orphan workers),源码 8 文件 / +210/−72,新增 tests/test_review_319.py(207) 与 docs/releases/2026-11-09-review-319-*。

复核

319 的项 本轮实现 判定
P2 watchdog 去掉 os._exit 后,"监督器失联"只剩下次启动扫描;且记录写失败时扫不到 watchdog 现在循环每 200ms 评估,同时满足三条才 os._exit(75)(desktop_worker.py:117):磁盘记录 _record_write_pending(...) is False、内存相位 _phase_pending(_native_phases[op]) is False、且所有已注册 helper 都已退出;worker_phase 在监督器失联后直接拒绝进入 NATIVE_CALL/CLOSING(:31-37);worker_main/management_worker_main 在 armed watchdog 之前先写 PRECALL(mentor_adapter.py:1016、native_management.py:1228);失联时的 cancel/证据写失败只记 warning,不影响退出判定 已修,且"内存 + 磁盘 + helper 三者一致才退"这个判据比我建议的更严
P3 被动扫描做释放证明、短暂独占打开生产库 discover_sessions 改用 inspect_session_record()(_reconcile(..., release=False),session_record.py:261-265),进程退出后返回 UNCONFIRMED · 需确认库占用已释放;main_window 的启动观察改成 handoff_session(..., observe_only=True);释放对话框的 discover_sessions 同样只观察 已修
P3 一次 UNCONFIRMED 让该库在本进程内永久排队、无解除入口 release_retained_library 成功后调用 acknowledge_library_release(record, retained, block_name=scoped)(library_lock.py:531/589),只在证明成立时清 _retained_libraries;_retained_results 保留最后一次观察并显示在释放对话框新增的 runtime_label("进行中/待核对 · block · detail",residual_release_dialog.py:33-35/199);成功释放还会为匹配的 operation 写 observation-release-*.json(session_record.py:58-77),刷新历史不会把它重新标成未确认 已修,acknowledge 用 alias-set 身份当"代次令牌",不会误清更新的 handoff,这点处理得对
P3 _terminate_pid 死代码 已删除(mentor_adapter.py 净 −13),cleanup 相关测试改为观察真实进程边界 已修

新测试不是走过场:test_review_319.py 用真实子进程当 supervisor 覆盖 PRECALL/POSTCALL(应退出)与 NATIVE_CALL/CLOSING/UNCONFIRMED、缺失/过期 journal(不应退出);test_discovery_of_exited_session_never_reconciles_library 直接 pytest.fail 拦住任何 release 调用;test_explicit_proof_resumes_queue… 验证证明成功后队列恢复、且独立库仍保持保留。

新发现(均 P3,不阻塞)

[P3] os._exit 的正确性依赖"每个派发点先写 NATIVE_CALL"这条纪律,目前靠 9 个调用点各自遵守

worker_phase 只设内存相位就释放锁,真正的 COM 调用在其后;watchdog 的判断窗口恰好在两者之间。现在 native_management.py 有 9 处 update_worker_state(..., 'NATIVE_CALL')(:839/1110/1127/1134/1149/1270/1278 等)分散在探测、提交、关闭各分支,任何一处新增派发忘记先写相位,watchdog 就会在"内存说 POSTCALL、磁盘说 POSTCALL"时把这个正要写库的 worker 结束掉。建议把"写相位 + 派发"收进一个 helper(例如 dispatch_native(job, call)),或在 worker_phase 里加一个 DISPATCH 相位并用同一把 _automation_clients_lock 护住派发窗口,让新增调用点在结构上不可能漏。

[P3] 整库证明会清掉该库上所有 block 的 retained 会话

release_retained_library 在 scoped is None(检查点或 owner 的 block 与入参不一致)时走整库证明,随后 acknowledge_library_release(..., block_name=None) 会把该库所有 retained 记录标成 RELEASED 并解除排队。证明本身是整库级的,所以安全性没问题;但事后无法区分"这次清了哪些 block 的会话",与我上一轮在 #10 提的"顺带清掉别的 CBB 的 blocker"是同一类问题。建议在 proof/observation-release-*.json 里记 reconciled_blocks: [...],或在 block 不匹配时停批。

[P3] 队列被挡的原因仍然只在释放对话框里可见

任务/队列侧被 library_available()=False 挡住时,界面仍只显示"等待中",要看到"被哪个残留会话挡住"必须打开释放对话框。建议在任务行或队列提示里加一句"该库有残留会话(block),点此处理",指向 check_library_release()。

(另:update_worker_state(..., required=False) 在监督器失联后仍会抛 RuntimeError——worker_phase 在 try 之外(session_record.py:103 对 :105);这对"派发前"是对的,但与"required=False 就返回 False"的表面约定不一致,建议在 docstring 写清。)

边界

  • 代码级复核;本机沙箱不能创建 pytest 临时目录,未复跑。记录里 full_suite 1732 / 0 失败 / 0 跳过 / 501s 与 13 个被测文件 SHA256 我核对了字段一致性,但未独立复现。
  • 仍未验证:真实 Mentor 在 supervisor 失联时的 Save/Close、跨机器共享库释放、以及这一版是否重新冻结打包(记录明确 candidate_rebuilt: false,0.2.4b2-iconfix-44bb734 不能作为本版证据)。

结论:可以合并(0 P1/P2,3×P3 建议)。

# 审查 6/6(复核 head `ca39fb3`,评论 319 的修复):1×P2 + 3×P3 全部按方向修好,新增 3×P3 范围:`96e179ba..ca39fb35`,1 个提交(`ca39fb3` fix: clear verified queue blockers and exit idle orphan workers),源码 8 文件 / +210/−72,新增 `tests/test_review_319.py`(207) 与 `docs/releases/2026-11-09-review-319-*`。 ## 复核 | 319 的项 | 本轮实现 | 判定 | | --- | --- | --- | | **P2** watchdog 去掉 `os._exit` 后,"监督器失联"只剩下次启动扫描;且记录写失败时扫不到 | watchdog 现在循环每 200ms 评估,**同时**满足三条才 `os._exit(75)`(`desktop_worker.py:117`):磁盘记录 `_record_write_pending(...) is False`、内存相位 `_phase_pending(_native_phases[op]) is False`、且所有已注册 helper 都已退出;`worker_phase` 在监督器失联后直接拒绝进入 `NATIVE_CALL/CLOSING`(`:31-37`);`worker_main`/`management_worker_main` 在 armed watchdog **之前**先写 `PRECALL`(`mentor_adapter.py:1016`、`native_management.py:1228`);失联时的 cancel/证据写失败只记 warning,不影响退出判定 | **已修**,且"内存 + 磁盘 + helper 三者一致才退"这个判据比我建议的更严 | | **P3** 被动扫描做释放证明、短暂独占打开生产库 | `discover_sessions` 改用 `inspect_session_record()`(`_reconcile(..., release=False)`,`session_record.py:261-265`),进程退出后返回 `UNCONFIRMED · 需确认库占用已释放`;`main_window` 的启动观察改成 `handoff_session(..., observe_only=True)`;释放对话框的 `discover_sessions` 同样只观察 | **已修** | | **P3** 一次 `UNCONFIRMED` 让该库在本进程内永久排队、无解除入口 | `release_retained_library` 成功后调用 `acknowledge_library_release(record, retained, block_name=scoped)`(`library_lock.py:531/589`),只在**证明成立**时清 `_retained_libraries`;`_retained_results` 保留最后一次观察并显示在释放对话框新增的 `runtime_label`("进行中/待核对 · block · detail",`residual_release_dialog.py:33-35/199`);成功释放还会为匹配的 operation 写 `observation-release-*.json`(`session_record.py:58-77`),刷新历史不会把它重新标成未确认 | **已修**,`acknowledge` 用 alias-set 身份当"代次令牌",不会误清更新的 handoff,这点处理得对 | | **P3** `_terminate_pid` 死代码 | 已删除(`mentor_adapter.py` 净 −13),`cleanup` 相关测试改为观察真实进程边界 | **已修** | 新测试不是走过场:`test_review_319.py` 用真实子进程当 supervisor 覆盖 `PRECALL/POSTCALL`(应退出)与 `NATIVE_CALL/CLOSING/UNCONFIRMED`、缺失/过期 journal(不应退出);`test_discovery_of_exited_session_never_reconciles_library` 直接 `pytest.fail` 拦住任何 release 调用;`test_explicit_proof_resumes_queue…` 验证证明成功后队列恢复、且独立库仍保持保留。 ## 新发现(均 P3,不阻塞) ### [P3] `os._exit` 的正确性依赖"每个派发点先写 `NATIVE_CALL`"这条纪律,目前靠 9 个调用点各自遵守 `worker_phase` 只设内存相位就释放锁,真正的 COM 调用在其后;watchdog 的判断窗口恰好在两者之间。现在 `native_management.py` 有 9 处 `update_worker_state(..., 'NATIVE_CALL')`(`:839/1110/1127/1134/1149/1270/1278` 等)分散在探测、提交、关闭各分支,任何一处新增派发忘记先写相位,watchdog 就会在"内存说 POSTCALL、磁盘说 POSTCALL"时把这个正要写库的 worker 结束掉。建议把"写相位 + 派发"收进一个 helper(例如 `dispatch_native(job, call)`),或在 `worker_phase` 里加一个 `DISPATCH` 相位并用同一把 `_automation_clients_lock` 护住派发窗口,让新增调用点在结构上不可能漏。 ### [P3] 整库证明会清掉该库上**所有 block** 的 retained 会话 `release_retained_library` 在 `scoped is None`(检查点或 owner 的 block 与入参不一致)时走整库证明,随后 `acknowledge_library_release(..., block_name=None)` 会把该库所有 retained 记录标成 `RELEASED` 并解除排队。证明本身是整库级的,所以安全性没问题;但事后无法区分"这次清了哪些 block 的会话",与我上一轮在 #10 提的"顺带清掉别的 CBB 的 blocker"是同一类问题。建议在 proof/`observation-release-*.json` 里记 `reconciled_blocks: [...]`,或在 block 不匹配时停批。 ### [P3] 队列被挡的原因仍然只在释放对话框里可见 任务/队列侧被 `library_available()=False` 挡住时,界面仍只显示"等待中",要看到"被哪个残留会话挡住"必须打开释放对话框。建议在任务行或队列提示里加一句"该库有残留会话(block),点此处理",指向 `check_library_release()`。 (另:`update_worker_state(..., required=False)` 在监督器失联后仍会抛 `RuntimeError`——`worker_phase` 在 `try` 之外(`session_record.py:103` 对 `:105`);这对"派发前"是对的,但与"required=False 就返回 False"的表面约定不一致,建议在 docstring 写清。) ## 边界 - 代码级复核;本机沙箱不能创建 pytest 临时目录,未复跑。记录里 `full_suite 1732 / 0 失败 / 0 跳过 / 501s` 与 13 个被测文件 SHA256 我核对了字段一致性,但未独立复现。 - 仍未验证:真实 Mentor 在 supervisor 失联时的 Save/Close、跨机器共享库释放、以及这一版是否重新冻结打包(记录明确 `candidate_rebuilt: false`,`0.2.4b2-iconfix-44bb734` 不能作为本版证据)。 **结论:可以合并(0 P1/P2,3×P3 建议)。**
Author
Owner

复核 #326 的修复(head fdd07224):三组改动全部落地,新增 1×P3(提示残留)——可以合并

新增 306aa5c5(原生派发收口 + 保留会话在证据里逐项列出)、78ff118f(已受理调用保留、队列等待原因)、a045683c(回执先于终态发布)、fdd07224(验证记录)。

逐条(对应评论 326)

326 的项 实现 判定
P3 os._exit 依赖"每个派发点先写 NATIVE_CALL" 新增 session_record.dispatch_native(job, call, phase=..., asynchronous=..., required=...):进入前登记相位、同步返回记 POSTCALL、回调抛错记 UNCONFIRMED;LibraryManager 启动/打开/创建/关闭/Quit、Add 提交、Remove 的 Popen、Reusable Blocks 编辑入口全部改用它 已修——从"9 个调用点各自遵守"变成"结构上只有一个入口"
监督器失联后仍要登记已受理的 Remove worker_phase(..., continuation=True):仅当内存相位与目标相位一致且仍 pending 时放行;否则抛 WORKER_STATE_UNCONFIRMED。Popen 之后的身份登记用 continuation,不会被失联否决;新派发仍被 WORKER_CANCELLED 拒绝(测试覆盖两种情形) 已修,语义拆分得很清楚
队列被挡时没有原因/入口 library_wait_reason() 只读内存、命名被挡的 CBB;NativeQueue.run(wait_state=...) 在等待原因变化时才重发通知;主窗口新增"查看残留会话…"按钮,ICDB/管理对话框在等待态也各自给出入口 已修(测试断言谓词不做文件系统 I/O、原因变化会重发、任务结束后按钮消失)
整库证明会清掉所有 block 的会话 释放证据新增 reconciled_blocks、reconciled_sessions(path/block/operation_id),reconciled_foreign_blockers 改为由检查点+会话共同推导;预证明快照冻结 alias 代次、block 与 operation_id,被替换的 operation 不会被误确认 已修
映射清理与等待票据的顺序 释放的 mapping finalizer 改为在序列化释放动作内部执行(_finalize_release_result),并带 mapping_cleanup_complete 让主窗口跳过二次清理;测试断言"新原生操作必须在旧映射释放完成之后才开始" 已修,这是本轮最实在的一条顺序保证
(他们自己发现的)终态早于回执 management_worker_main 改为先写 result.json 再写 FINISHED,使"孤儿 watchdog 退出"不可能夹在中间;首轮全量 1774+1 失败的 XML 保留,修正后 1775/0 已修,这个自查值得肯定

另外我特别核对了一点:dispatch_native 的异常分支用 update_worker_state(job, 'UNCONFIRMED')(required 默认 False),日志写失败不会覆盖原始异常——这一点没问题。

新发现

[P3] "查看残留会话…"入口在票据被接纳后不会消失,直到整批结束

_queue_wait_library 只有三个地方会清空:_finished(main_window.py:1656)、ICDB 的 icdb_check_start(:893)、以及"下一次 waiting 事件但 retained 为假"(:1450)。校验批次的 _queued_action 在获得票据后不会再发等待事件,所以按钮会在整个批次运行期间保持可见(:422-423 只看 _queue_wait_library is not None)。点开它会在 busy 状态进入排队态释放面板;由于全局互斥 Local\CbbRefreshVerify795 被当前批次持有,实际不会关闭任何进程,只是会看到一个与当前状态不符的面板。
建议:任一非 waiting 阶段事件到达时清空该字段,或把按钮可见性改成实时判断 library_available(...)(纯内存,无 I/O),这样"原因消失即隐藏"。

验证与边界

  • 我在 fdd07224 头里逐条核对了上面列出的实现与测试;validation 记录为 1775 passed / 0 failed / 0 skipped,首轮 1774+1 的失败 XML 单独保留,被测文件 SHA256 齐全。
  • 仍未验证:真实 Mentor 的 Save/Close/Add/Remove、Windows 10、共享库/跨机器并发;本版未重新冻结打包(candidate_rebuilt: false),旧 iconfix 包不能作为本版证据。

结论:可以合并(0 P1/P2,1×P3 建议)。

# 复核 #326 的修复(head `fdd07224`):三组改动全部落地,新增 1×P3(提示残留)——可以合并 新增 `306aa5c5`(原生派发收口 + 保留会话在证据里逐项列出)、`78ff118f`(已受理调用保留、队列等待原因)、`a045683c`(回执先于终态发布)、`fdd07224`(验证记录)。 ## 逐条(对应评论 326) | 326 的项 | 实现 | 判定 | | --- | --- | --- | | P3 `os._exit` 依赖"每个派发点先写 NATIVE_CALL" | 新增 `session_record.dispatch_native(job, call, phase=..., asynchronous=..., required=...)`:进入前登记相位、同步返回记 POSTCALL、回调抛错记 UNCONFIRMED;LibraryManager 启动/打开/创建/关闭/Quit、Add 提交、Remove 的 Popen、Reusable Blocks 编辑入口全部改用它 | **已修**——从"9 个调用点各自遵守"变成"结构上只有一个入口" | | 监督器失联后仍要登记**已受理**的 Remove | `worker_phase(..., continuation=True)`:仅当内存相位与目标相位一致且仍 pending 时放行;否则抛 `WORKER_STATE_UNCONFIRMED`。Popen 之后的身份登记用 continuation,不会被失联否决;新派发仍被 `WORKER_CANCELLED` 拒绝(测试覆盖两种情形) | **已修**,语义拆分得很清楚 | | 队列被挡时没有原因/入口 | `library_wait_reason()` 只读内存、命名被挡的 CBB;`NativeQueue.run(wait_state=...)` 在等待原因**变化时**才重发通知;主窗口新增"查看残留会话…"按钮,ICDB/管理对话框在等待态也各自给出入口 | **已修**(测试断言谓词不做文件系统 I/O、原因变化会重发、任务结束后按钮消失) | | 整库证明会清掉所有 block 的会话 | 释放证据新增 `reconciled_blocks`、`reconciled_sessions`(path/block/operation_id),`reconciled_foreign_blockers` 改为由检查点+会话共同推导;预证明快照冻结 alias 代次、block 与 operation_id,被替换的 operation 不会被误确认 | **已修** | | 映射清理与等待票据的顺序 | 释放的 mapping finalizer 改为在序列化释放动作**内部**执行(`_finalize_release_result`),并带 `mapping_cleanup_complete` 让主窗口跳过二次清理;测试断言"新原生操作必须在旧映射释放完成之后才开始" | **已修**,这是本轮最实在的一条顺序保证 | | (他们自己发现的)终态早于回执 | `management_worker_main` 改为先写 `result.json` 再写 `FINISHED`,使"孤儿 watchdog 退出"不可能夹在中间;首轮全量 1774+1 失败的 XML 保留,修正后 1775/0 | **已修**,这个自查值得肯定 | 另外我特别核对了一点:`dispatch_native` 的异常分支用 `update_worker_state(job, 'UNCONFIRMED')`(`required` 默认 False),日志写失败不会覆盖原始异常——这一点没问题。 ## 新发现 ### [P3] "查看残留会话…"入口在票据被接纳后不会消失,直到整批结束 `_queue_wait_library` 只有三个地方会清空:`_finished`(`main_window.py:1656`)、ICDB 的 `icdb_check_start`(`:893`)、以及"下一次 waiting 事件但 retained 为假"(`:1450`)。校验批次的 `_queued_action` 在获得票据后不会再发等待事件,所以按钮会在**整个批次运行期间**保持可见(`:422-423` 只看 `_queue_wait_library is not None`)。点开它会在 busy 状态进入排队态释放面板;由于全局互斥 `Local\CbbRefreshVerify795` 被当前批次持有,实际不会关闭任何进程,只是会看到一个与当前状态不符的面板。 建议:任一非 waiting 阶段事件到达时清空该字段,或把按钮可见性改成实时判断 `library_available(...)`(纯内存,无 I/O),这样"原因消失即隐藏"。 ## 验证与边界 - 我在 `fdd07224` 头里逐条核对了上面列出的实现与测试;validation 记录为 **1775 passed / 0 failed / 0 skipped**,首轮 1774+1 的失败 XML 单独保留,被测文件 SHA256 齐全。 - 仍未验证:真实 Mentor 的 Save/Close/Add/Remove、Windows 10、共享库/跨机器并发;本版未重新冻结打包(`candidate_rebuilt: false`),旧 iconfix 包不能作为本版证据。 **结论:可以合并(0 P1/P2,1×P3 建议)。**
Author
Owner

复核 #381 的修复(head 42e87190):那条 P3 已正确修好,新增 1×P3(多库等待只留一个入口)——可以合并

新增 1 个提交 42e87190(让残留释放入口跟随实时队列状态):main_window.py +41/−10、新增 tests/test_review381_queue_release.py(241) 与验证记录。

对 381 的复核

381 的项 实现 判定
"查看残留会话…"在票据被接纳后不消失 新增 _queued_release_library()(:496-500):每次 _update 都用内存里的 library_available() 复核,已释放即清空;票据接纳时发 native_slot_acquired 事件(:842、:1477)立即触发 _update,按钮随可见性计算一起消失 已修,而且不依赖批次结束(测试断言"动作还没结束按钮就消失、busy 仍为真")
过期等待消息重新打开入口 _queue_waiting()(:502-507)只在 retained 且当前仍被保留时写入,旧消息/普通排队消息不会复活入口 已修
延迟点击/关闭中点击 check_library_release(queued=True)(:509-514)点击时再复核,_closing 或已释放直接返回,不触发 inspect_residual_sessions 的原生扫描 已修(测试断言 5 次延迟点击 scans == [])
前台结束误清后台入口 _finished(:1683-1688)保留另一个库仍在等待的后台 ICDB 入口;_icdb_done(:948-954)只移除属于该任务且前台不再需要的入口 已修(前后台两种结束顺序都有用例)

测试质量我认可:执行中隐藏、5 次延迟点击、过期事件、跨库交错、反复开关面板、重复点校验→停止→再点释放、关闭期点击,共 14 项;还做了负向对照(只在测试进程里还原旧 _queued_action,新用例稳定失败)。另外他们如实保留了"外层控制器 exit 1、21 项断言却全过、未计为通过"这条记录——这种不粉饰的写法值得保持。

新发现

[P3] 单槽 _queue_wait_library:多个库同时被保留时,入口会被后者覆盖,先前的等待变成"隐形"

_queue_wait_library 只是一个字符串槽(:137),_queue_waiting 在"另一个库 retained 且仍被保留"时会直接覆盖(:505-506)。可达路径:

  1. 后台 ICDB 在库 B 上排队(B 有残留)→ 入口显示 B;
  2. 前台校验在库 A 上排队(A 有残留)→ 入口被覆盖为 A;
  3. 释放 A → 票据被接纳、_queued_release_library() 清空槽位 → B 的入口不会回来:NativeQueue 只在"本票据的等待原因变化"时重发 waiting(),B 的原因没有变化(main_window.py:842 一带的 wait_state)。

后果是 B 的等待在界面上消失,直到 B 的任务自己结束,或操作员切到 B 的库、用主界面的"释放残留会话…"入口(前台忙时该按钮禁用)。没有数据风险,但正是这次修复想消除的"隐形死等"。

建议:把单槽改成按库的映射(dict[library, reason],入口按库渲染/合并显示),或在某个等待被清除后让其余 pending 票据重发一次通知(例如 NativeQueue 在释放 active 时比较各票据当前 reason 集合,变化则再发 waiting())。

验证与边界

  • 记录:全量 1,789 passed / 0 failed / 0 skipped、聚焦回归 57、Windows 原生控件两轮各 21 项、负向对照 1 项预期失败;候选包重建(62 模块与源码一致、5 项冻结冒烟、EXE SHA-256 已记录)。
  • 未验证:真实 Mentor 的 Save/Close/Add/Remove、ICDB 修复、Windows 10、跨机器共享库——与之前的边界一致,本轮也没有声称任何现场验收。

结论:可以合并(0 P1/P2,1×P3 建议)。

# 复核 #381 的修复(head `42e87190`):那条 P3 已正确修好,新增 1×P3(多库等待只留一个入口)——可以合并 新增 1 个提交 `42e87190`(让残留释放入口跟随实时队列状态):`main_window.py` +41/−10、新增 `tests/test_review381_queue_release.py`(241) 与验证记录。 ## 对 381 的复核 | 381 的项 | 实现 | 判定 | | --- | --- | --- | | "查看残留会话…"在票据被接纳后不消失 | 新增 `_queued_release_library()`(`:496-500`):每次 `_update` 都用内存里的 `library_available()` 复核,已释放即清空;票据接纳时发 `native_slot_acquired` 事件(`:842`、`:1477`)立即触发 `_update`,按钮随可见性计算一起消失 | **已修**,而且不依赖批次结束(测试断言"动作还没结束按钮就消失、`busy` 仍为真") | | 过期等待消息重新打开入口 | `_queue_waiting()`(`:502-507`)只在 `retained` **且当前仍被保留**时写入,旧消息/普通排队消息不会复活入口 | **已修** | | 延迟点击/关闭中点击 | `check_library_release(queued=True)`(`:509-514`)点击时再复核,`_closing` 或已释放直接返回,不触发 `inspect_residual_sessions` 的原生扫描 | **已修**(测试断言 5 次延迟点击 `scans == []`) | | 前台结束误清后台入口 | `_finished`(`:1683-1688`)保留另一个库仍在等待的后台 ICDB 入口;`_icdb_done`(`:948-954`)只移除属于该任务且前台不再需要的入口 | **已修**(前后台两种结束顺序都有用例) | 测试质量我认可:执行中隐藏、5 次延迟点击、过期事件、跨库交错、反复开关面板、重复点校验→停止→再点释放、关闭期点击,共 14 项;还做了负向对照(只在测试进程里还原旧 `_queued_action`,新用例稳定失败)。另外他们如实保留了"外层控制器 exit 1、21 项断言却全过、未计为通过"这条记录——这种不粉饰的写法值得保持。 ## 新发现 ### [P3] 单槽 `_queue_wait_library`:多个库同时被保留时,入口会被后者覆盖,先前的等待变成"隐形" `_queue_wait_library` 只是一个字符串槽(`:137`),`_queue_waiting` 在"另一个库 retained 且仍被保留"时会直接覆盖(`:505-506`)。可达路径: 1. 后台 ICDB 在库 B 上排队(B 有残留)→ 入口显示 B; 2. 前台校验在库 A 上排队(A 有残留)→ 入口被覆盖为 A; 3. 释放 A → 票据被接纳、`_queued_release_library()` 清空槽位 → **B 的入口不会回来**:`NativeQueue` 只在"本票据的等待原因变化"时重发 `waiting()`,B 的原因没有变化(`main_window.py:842` 一带的 `wait_state`)。 后果是 B 的等待在界面上消失,直到 B 的任务自己结束,或操作员切到 B 的库、用主界面的"释放残留会话…"入口(前台忙时该按钮禁用)。没有数据风险,但正是这次修复想消除的"隐形死等"。 建议:把单槽改成按库的映射(`dict[library, reason]`,入口按库渲染/合并显示),或在某个等待被清除后让其余 pending 票据重发一次通知(例如 `NativeQueue` 在释放 active 时比较各票据当前 reason 集合,变化则再发 `waiting()`)。 ## 验证与边界 - 记录:全量 **1,789 passed / 0 failed / 0 skipped**、聚焦回归 57、Windows 原生控件两轮各 21 项、负向对照 1 项预期失败;候选包重建(62 模块与源码一致、5 项冻结冒烟、EXE SHA-256 已记录)。 - 未验证:真实 Mentor 的 Save/Close/Add/Remove、ICDB 修复、Windows 10、跨机器共享库——与之前的边界一致,本轮也没有声称任何现场验收。 **结论:可以合并(0 P1/P2,1×P3 建议)。**
Author
Owner

审查 PR #13 新提交(head 466f4005,3 个提交 / 47 文件):代码适合合并,但物不等于"现场验收通过"

新增:b86e4e3(逐按钮模拟)、42d0ceb(真机验收发现的 6 处缺陷)、466f400(占用范围 + PCB 打开授权)。我核对了源码实现、对应测试,以及两份验收记录(2026-11-12-native-acceptance.md、2026-11-12-scoped-release-validation.md)。

与上一轮的关系

上一轮(#387)之后这三笔提交不是在加新功能,而是把真机跑出来的问题修掉:冻结 EXE + Mentor EE7.9.5 实测发现 6 类缺陷(导出器退出竞态、无路径 viewdraw 误挡备份、sAddress_.adr 被误判内容不一致、私有桌面窗口不可读、旧工程缺 pcb.prj 被拒、释放按钮 busy 时空点),随后又针对 E01(外部会话挡住整库释放)和 E02(PCB 读写提示无用户确认入口)做了结构性修复。这点值得肯定:报告明确写了"未通过整体验收",没有把修复追记成通过。

关键实现核对(我认为这几处修得对)

  1. E01:观察项不再等于阻止项,但证据没放松(library_lock.py:378、residual_sessions.py:619)

    • 未知归属的外部进程进入 observed_owners/OBSERVED,不发送关闭、不计入主动释放数量;
    • 但真正决定能否继续的仍是三道本库证据:active_write_records(本库在途/助手)、地址记录、以及 .lmc/icdb.dat/LayoutDB.lyt 的独占只读句柄;
    • 你们真机验证的两个方向都在:外部脚本持有 LMC 独占句柄 → 释放被拒(error 32);句柄关闭后 → RELEASE_CONFIRMED 且主动关闭 0。测试 test_external_owner_release.py 也复现了这两向,并断言"本工具未绑定的 worker 仍然阻止证明"。
    • 这个修法比我上轮建议的"全局不阻塞"更稳:用目标资源证明替代进程名单,而不是放宽门禁。
  2. 单项失败与批次停止分开,且失败复核在让出队列之前完成(operation_lifecycle.py:5、verify_runner.py:1307/1330)

    • recheck_failed_release 只在"绑定会话/证据存在、非 ACTIVE、且释放证明成立"时把 safe_to_continue 置 True,业务失败状态保留;
    • 我特别核对了"取消本批次"不会被这个翻转吃掉:CANCELLED 仍会 queue_stop 并 stop.set(),后续项跳过;
    • test_batch_item_yield.py 断言了顺序 ['Beta','other','Gamma'](逐项让出)和失败复核时 active 仍为真(先复核、后让出)——这正是 B01/B02 想要的边界。
  3. E02:PCB 读写授权的绑定是"人 + 精确身份 + 每次点击前复核"(pcb_open_consent.py:31/48/135、dialog_agent.py:239)

    • validate_owner 要求 target→launcher→worker 父链、私有桌面前缀、且拒绝 diagnostic_only / native_lm_verify / interactive_input;
    • 选"继续"前 resource_guard 再查地址、其他会话,并对数据库/布局/LMC 取独占句柄,取句柄后再复查一次;
    • 真正点击由 validate_action_window 复核 HWND 归属、当前桌面、进程创建身份与按钮句柄;
    • ICDB 诊断路径没有 version_prompt,拿不到这个授权,自动 Repair 仍关闭。测试覆盖了"改窗口/改数据库所有者则拒绝"、"替换真实按钮则拒绝"、"默认按钮是取消"。
  4. 导出归属(OneDrive 误收录)(native_engineering_identity.py:306、native_export_guard.py:10)

    • 用创建时间而不是历史父 PID 认亲:排除导出开始前已存在的进程、拒绝早于父进程的子进程、PID 复用不认;
    • 且没有因此绕过身份校验:A/B 的 EDIF 崩溃仍以失败上报,C 正常新增,未伪造成功。
  5. 旧格式恢复 + UIA/Win32 提示差异:不再强制 pcb.prj,改用 maintenance_project_files 校验引用;"是(&Y)" 与 "是(Y)"、辅助节点/重排按"句柄+ID+类+去 & 文本"比较,替换按钮仍拒绝。scoped10 的完整恢复(installed=true、PASS/GREEN/READY、Save COMMITTED、Close CLOSED、PCB/助手 EXITED、资源 RELEASED)是真机证据,不是模拟。

新发现(P3,不阻塞合并)

[P3] 导出证据 JSON 不可读时会静默回到"过严"分支,且不留原因

native_export_guard._preexisting_export_pids 的外层 except (OSError, ValueError, KeyError, TypeError): excluded.clear()(native_export_guard.py:41)。一旦 *-process.json 损坏/被清理,被误归属的既有进程不再被排除,释放会再次被"导出器尚未释放"挡住,而 proof 里没有说明为什么。建议在 proof/diagnostic 里加 exclusion_unavailable(或落到日志),否则运维会重现 E01 那种"看不出谁在挡"的体验。

[P3] 批末状态刷新现在也走原生队列,结果窗口可能被其他票据推迟

ui/main_window.py:1387 把 _read_affected_records 包进 _queued_action。方向是对的(不在别人写库时去读状态),但如果队列里还有别的票据,批次结果窗口会等那个任务跑完才出现,操作员会看到"批次已结束但没窗口"。建议刷新前先给一个"已结束、正在刷新状态"的中间态,或给刷新用一个可跳过的低优先票据。

[P3] 验收文档含本机绝对路径与未入库证据名

docs/releases/2026-11-12-*.md 里大量 F:\CbbAccept-20261112\...、r7-accept.log 这类只在本机存在的路径。作为审计记录没问题,建议在文件头统一标注"本机证据路径,不入库",避免后来者按图索骥。

合并建议(直接回答"适不适合合并")

  • 适合合并:本轮改动是收紧证据链、补齐用户授权、修正误判,不是放开危险路径;1,880 项测试 + 真机完整恢复/更新/移除/释放的证据都在,且没有发现 P1/P2。按 #10 → #13 链路合并后,main 会变得比现在更安全(多出的能力都有显式确认与独立证明)。
  • 不适合以此发版或宣称现场验收通过:E03(A/B 原生 EDIF 导出 0xC0000005)尚未定位;Windows 10、跨机共享库、现场失联一致副本未验收;ICDB 自动 Repair 仍关闭;旧的 iconfix 包与本版无关。建议合并的同时把这三条写进 README/SOP 的"已知限制",特别是"跨机释放依赖 SMB 共享模式语义,未实测"。
  • #3(汇总) 仍停在 32d7a63,链路合并后可以关闭。

边界

本轮我只做代码级与记录级核对(上述 file:line 均在 466f4005 树内读过),没有复跑 1,880 项测试,也没有真实 Mentor 环境;结论不替代你们的真机验收,只是在"能否合并进代码库"这个维度上给出的判断。

# 审查 PR #13 新提交(head `466f4005`,3 个提交 / 47 文件):**代码适合合并,但物不等于"现场验收通过"** 新增:`b86e4e3`(逐按钮模拟)、`42d0ceb`(真机验收发现的 6 处缺陷)、`466f400`(占用范围 + PCB 打开授权)。我核对了源码实现、对应测试,以及两份验收记录(`2026-11-12-native-acceptance.md`、`2026-11-12-scoped-release-validation.md`)。 ## 与上一轮的关系 上一轮(#387)之后这三笔提交不是在加新功能,而是**把真机跑出来的问题修掉**:冻结 EXE + Mentor EE7.9.5 实测发现 6 类缺陷(导出器退出竞态、无路径 viewdraw 误挡备份、`sAddress_.adr` 被误判内容不一致、私有桌面窗口不可读、旧工程缺 `pcb.prj` 被拒、释放按钮 busy 时空点),随后又针对 E01(外部会话挡住整库释放)和 E02(PCB 读写提示无用户确认入口)做了结构性修复。这点值得肯定:**报告明确写了"未通过整体验收"**,没有把修复追记成通过。 ## 关键实现核对(我认为这几处修得对) 1. **E01:观察项不再等于阻止项,但证据没放松**(`library_lock.py:378`、`residual_sessions.py:619`) - 未知归属的外部进程进入 `observed_owners`/`OBSERVED`,不发送关闭、不计入主动释放数量; - 但真正决定能否继续的仍是三道本库证据:`active_write_records`(本库在途/助手)、地址记录、以及 `.lmc`/`icdb.dat`/`LayoutDB.lyt` 的**独占只读句柄**; - 你们真机验证的两个方向都在:外部脚本持有 LMC 独占句柄 → 释放被拒(error 32);句柄关闭后 → `RELEASE_CONFIRMED` 且主动关闭 0。测试 `test_external_owner_release.py` 也复现了这两向,并断言"本工具未绑定的 worker 仍然阻止证明"。 - 这个修法比我上轮建议的"全局不阻塞"更稳:**用目标资源证明替代进程名单**,而不是放宽门禁。 2. **单项失败与批次停止分开,且失败复核在让出队列之前完成**(`operation_lifecycle.py:5`、`verify_runner.py:1307/1330`) - `recheck_failed_release` 只在"绑定会话/证据存在、非 ACTIVE、且释放证明成立"时把 `safe_to_continue` 置 True,业务失败状态保留; - 我特别核对了"取消本批次"不会被这个翻转吃掉:`CANCELLED` 仍会 `queue_stop` 并 `stop.set()`,后续项跳过; - `test_batch_item_yield.py` 断言了顺序 `['Beta','other','Gamma']`(逐项让出)和失败复核时 `active` 仍为真(先复核、后让出)——这正是 B01/B02 想要的边界。 3. **E02:PCB 读写授权的绑定是"人 + 精确身份 + 每次点击前复核"**(`pcb_open_consent.py:31/48/135`、`dialog_agent.py:239`) - `validate_owner` 要求 target→launcher→worker 父链、私有桌面前缀、且拒绝 `diagnostic_only` / `native_lm_verify` / `interactive_input`; - 选"继续"前 `resource_guard` 再查地址、其他会话,并对数据库/布局/LMC 取独占句柄,取句柄后再复查一次; - 真正点击由 `validate_action_window` 复核 HWND 归属、当前桌面、进程创建身份与按钮句柄; - ICDB 诊断路径没有 `version_prompt`,**拿不到这个授权**,自动 Repair 仍关闭。测试覆盖了"改窗口/改数据库所有者则拒绝"、"替换真实按钮则拒绝"、"默认按钮是取消"。 4. **导出归属(OneDrive 误收录)**(`native_engineering_identity.py:306`、`native_export_guard.py:10`) - 用创建时间而不是历史父 PID 认亲:排除导出开始前已存在的进程、拒绝早于父进程的子进程、PID 复用不认; - 且没有因此绕过身份校验:A/B 的 EDIF 崩溃仍以失败上报,C 正常新增,未伪造成功。 5. **旧格式恢复 + UIA/Win32 提示差异**:不再强制 `pcb.prj`,改用 `maintenance_project_files` 校验引用;"是(&Y)" 与 "是(Y)"、辅助节点/重排按"句柄+ID+类+去 & 文本"比较,替换按钮仍拒绝。scoped10 的完整恢复(installed=true、PASS/GREEN/READY、Save COMMITTED、Close CLOSED、PCB/助手 EXITED、资源 RELEASED)是真机证据,不是模拟。 ## 新发现(P3,不阻塞合并) ### [P3] 导出证据 JSON 不可读时会静默回到"过严"分支,且不留原因 `native_export_guard._preexisting_export_pids` 的外层 `except (OSError, ValueError, KeyError, TypeError): excluded.clear()`(`native_export_guard.py:41`)。一旦 `*-process.json` 损坏/被清理,被误归属的既有进程不再被排除,释放会再次被"导出器尚未释放"挡住,而 proof 里没有说明为什么。建议在 proof/diagnostic 里加 `exclusion_unavailable`(或落到日志),否则运维会重现 E01 那种"看不出谁在挡"的体验。 ### [P3] 批末状态刷新现在也走原生队列,结果窗口可能被其他票据推迟 `ui/main_window.py:1387` 把 `_read_affected_records` 包进 `_queued_action`。方向是对的(不在别人写库时去读状态),但如果队列里还有别的票据,批次结果窗口会等那个任务跑完才出现,操作员会看到"批次已结束但没窗口"。建议刷新前先给一个"已结束、正在刷新状态"的中间态,或给刷新用一个可跳过的低优先票据。 ### [P3] 验收文档含本机绝对路径与未入库证据名 `docs/releases/2026-11-12-*.md` 里大量 `F:\CbbAccept-20261112\...`、`r7-accept.log` 这类只在本机存在的路径。作为审计记录没问题,建议在文件头统一标注"本机证据路径,不入库",避免后来者按图索骥。 ## 合并建议(直接回答"适不适合合并") - **适合合并**:本轮改动是**收紧证据链、补齐用户授权、修正误判**,不是放开危险路径;1,880 项测试 + 真机完整恢复/更新/移除/释放的证据都在,且没有发现 P1/P2。按 #10 → #13 链路合并后,main 会变得比现在更安全(多出的能力都有显式确认与独立证明)。 - **不适合以此发版或宣称现场验收通过**:E03(A/B 原生 EDIF 导出 0xC0000005)尚未定位;Windows 10、跨机共享库、现场失联一致副本未验收;ICDB 自动 Repair 仍关闭;旧的 iconfix 包与本版无关。建议合并的同时把这三条写进 README/SOP 的"已知限制",特别是"跨机释放依赖 SMB 共享模式语义,未实测"。 - **#3(汇总)** 仍停在 `32d7a63`,链路合并后可以关闭。 ## 边界 本轮我只做代码级与记录级核对(上述 `file:line` 均在 `466f4005` 树内读过),**没有复跑 1,880 项测试,也没有真实 Mentor 环境**;结论不替代你们的真机验收,只是在"能否合并进代码库"这个维度上给出的判断。
abaishu0730 marked the pull request as ready for review 2026-11-12 17:40:05 +08:00
abaishu0730 changed target branch from codex/review-residual-release to main 2026-11-12 17:40:05 +08:00
abaishu0730 added 28 commits 2026-11-12 17:40:05 +08:00
# Conflicts:
#	src/cbb_refresh_verify/residual_sessions.py
# Conflicts:
#	src/cbb_refresh_verify/ui/residual_release_dialog.py
abaishu0730 merged commit cbc5723849 into main 2026-11-12 17:40:06 +08:00
Author
Owner

CBB Verify 合入后复审(#10–#13 → main cbc5723,0.2.4b2)

范围:我上轮审的四个 head(b7baa24/e73f9c6/651b539/42898d3)→ 最终合入 head(e8a1714/0fca6ab/a7df105/9eea9a4),main 现为 cbc5723(tag v0.2.4-beta.2,__version__ = "0.2.4b2")。已确认最终树与 main 一致,四个 head 都是 main 的祖先,区间没有遗漏。

结论:我上轮 12 项里 7 项闭环、3 项部分、2 项未触及;没有 P1;有 2 条已核实的 P2 建议在下个版本修。


一、已闭环(挑重点)

  • result.json 先落盘再置终态(a045683):之前"证据丢失但状态 finished"的问题没了。
  • 强制结束改为多层判定:active_write_records + force_block_reason 二次判定 + 终止前重拍 native_activity。
  • 问题轮次的安全拒绝不再逃出队列(run_problem_pass 收口为 blocked 落盘)。
  • watchdog / dispatch_native / 只读边界:管理 worker 与只读状态路径都接上了监督与取消通道。
  • 行尾翻转已消除(application.py/main_window.py 不再整文件换行)。

二、我核实成立的 P2

P2-1 _idle_check 删掉了"无法归属的原生进程即拒"这一条 → 写前判定 fail-open

backup_recovery.py:31-58(main)现在只有:

match = _native_scope_match(command, roots=scope, files=(library, project, pcb))
if match is True:
    raise ValueError('TARGET_NATIVE_OWNER_ACTIVE: ...')
# Pathless clients do not identify this target. The address and
# exclusive file probes below still reject actual target occupancy.

也就是说 match is None(拿不到命令行的 ExpeditionPCB/viewdraw/iCDBProjectBackup/ReuseBlockImporter)不再阻断。当另一个会话正打开本工程、且此刻不持有 icdb.dat 独占句柄时,Add/Update/Remove、备份恢复、维护仍会继续写库。地址记录与独占探测只能覆盖"此刻正持句柄"的情况。

建议:恢复 match is None → TARGET_NATIVE_OWNER_UNCONFIRMED(保守优先),或在写路径上把"存在无法归属的原生进程"降级为需要用户显式确认。

P2-2 独占句柄跨越"读写打开"点击,会浪费唯一一次确认

pcb_open_consent.py:48-70 的 resource_guard 对 .lmc、LayoutDB.lyt、icdb.dat 打开 GENERIC_READ + share=0 的独占句柄并保持到 yield 结束;而 :115-118 的 control == 6("以读写方式打开")正是在 with resource_guard(...) 内部派发 BM_CLICK。

Mentor 在这个时刻要去读写同一批文件,很可能撞上 ERROR_SHARING_VIOLATION,而这次确认是一次性的(pcb-open-user-choice.json 已写)。对照 post_repair_consent.py:142-157 的顺序(先证明、再释放、后点击)才是对的。

建议:把点击放到 guard 退出之后(先 check() + 拿证据,再用 guard 之外的动作点击),或把这类句柄改成 share=FILE_SHARE_READ 且只用作"无人写"的证明。

三、我核对后不成立的一条(避免误伤)

子代理报"residual_sessions.py:305-325 把'没抓到窗口'当'没窗口',于是 force 会强杀正在写库的 iCDB Project Backup"。我按 main 的实际代码核对:native_activity()(residual_sessions.py:45-61)在 incomplete 为真、存在 UNCONFIRMED 窗口、或 iCDB Project Backup 的输出读取不到时都返回 UNCONFIRMED;而 force_block_reason()(:22-43)要求 activity.get('status') == 'IDLE' 才放行强制结束。所以"无窗口"不会变成 IDLE,这条不成立。

四、需要作者确认(我未能核实)

  • main_window.py:846/1378:子代理称入队使用"UI 当前库"且在 worker 线程读 QWidget(错库放行/跨线程)。我未在引用行附近确认到跨线程读控件的直接证据,请作者自查这两处是否在非 GUI 线程访问了控件。

五、P3

  • 非 checkpoint 租约不落盘(重启后无法解释上一次租约);
  • 导出预存的进程豁免范围偏宽;
  • 文档里的 1775/1851/1880 三组测试数字无法复现(建议附上生成命令与 commit)。

验证记录

  • 基准确认:git merge-base --is-ancestor 四段区间均成立;origin/main 树含 residual_sessions.py/pcb_open_consent.py,版本 0.2.4b2。
  • 逐行核对 backup_recovery.py:31-58、residual_sessions.py:19-61、pcb_open_consent.py:48-70/100-140、stop_control 相关路径(main)。
  • 未跑 pytest、未上原生真机(与作者声明的边界一致)。

未验证边界

真实原生会话下 _idle_check 的漏拦概率;ERROR_SHARING_VIOLATION 在真实 Mentor 上的实际发生率;跨线程访问控件的具体调用栈。

# CBB Verify 合入后复审(#10–#13 → main `cbc5723`,0.2.4b2) 范围:我上轮审的四个 head(`b7baa24`/`e73f9c6`/`651b539`/`42898d3`)→ 最终合入 head(`e8a1714`/`0fca6ab`/`a7df105`/`9eea9a4`),main 现为 `cbc5723`(tag `v0.2.4-beta.2`,`__version__ = "0.2.4b2"`)。已确认最终树与 main 一致,四个 head 都是 main 的祖先,区间没有遗漏。 ## 结论:我上轮 12 项里 7 项闭环、3 项部分、2 项未触及;**没有 P1**;有 2 条已核实的 P2 建议在下个版本修。 --- ## 一、已闭环(挑重点) - **`result.json` 先落盘再置终态**(`a045683`):之前"证据丢失但状态 finished"的问题没了。 - **强制结束改为多层判定**:`active_write_records` + `force_block_reason` 二次判定 + 终止前重拍 `native_activity`。 - **问题轮次的安全拒绝不再逃出队列**(`run_problem_pass` 收口为 blocked 落盘)。 - **watchdog / dispatch_native / 只读边界**:管理 worker 与只读状态路径都接上了监督与取消通道。 - 行尾翻转已消除(`application.py`/`main_window.py` 不再整文件换行)。 ## 二、我核实成立的 P2 ### P2-1 `_idle_check` 删掉了"无法归属的原生进程即拒"这一条 → 写前判定 fail-open `backup_recovery.py:31-58`(main)现在只有: ```python match = _native_scope_match(command, roots=scope, files=(library, project, pcb)) if match is True: raise ValueError('TARGET_NATIVE_OWNER_ACTIVE: ...') # Pathless clients do not identify this target. The address and # exclusive file probes below still reject actual target occupancy. ``` 也就是说 `match is None`(拿不到命令行的 ExpeditionPCB/viewdraw/iCDBProjectBackup/ReuseBlockImporter)**不再阻断**。当另一个会话正打开本工程、且此刻不持有 `icdb.dat` 独占句柄时,Add/Update/Remove、备份恢复、维护仍会继续写库。地址记录与独占探测只能覆盖"此刻正持句柄"的情况。 **建议**:恢复 `match is None → TARGET_NATIVE_OWNER_UNCONFIRMED`(保守优先),或在写路径上把"存在无法归属的原生进程"降级为需要用户显式确认。 ### P2-2 独占句柄跨越"读写打开"点击,会浪费唯一一次确认 `pcb_open_consent.py:48-70` 的 `resource_guard` 对 `.lmc`、`LayoutDB.lyt`、`icdb.dat` 打开 **`GENERIC_READ` + `share=0`** 的独占句柄并保持到 `yield` 结束;而 `:115-118` 的 `control == 6`("以读写方式打开")正是在 `with resource_guard(...)` 内部派发 `BM_CLICK`。 Mentor 在这个时刻要去读写同一批文件,很可能撞上 `ERROR_SHARING_VIOLATION`,而这次确认是一次性的(`pcb-open-user-choice.json` 已写)。对照 `post_repair_consent.py:142-157` 的顺序(先证明、再释放、后点击)才是对的。 **建议**:把点击放到 guard 退出之后(先 `check()` + 拿证据,再用 guard 之外的动作点击),或把这类句柄改成 `share=FILE_SHARE_READ` 且只用作"无人写"的证明。 ## 三、我核对后**不成立**的一条(避免误伤) 子代理报"`residual_sessions.py:305-325` 把'没抓到窗口'当'没窗口',于是 force 会强杀正在写库的 iCDB Project Backup"。我按 main 的实际代码核对:`native_activity()`(`residual_sessions.py:45-61`)在 `incomplete` 为真、存在 `UNCONFIRMED` 窗口、或 iCDB Project Backup 的**输出读取不到**时都返回 `UNCONFIRMED`;而 `force_block_reason()`(`:22-43`)要求 `activity.get('status') == 'IDLE'` 才放行强制结束。所以"无窗口"不会变成 IDLE,这条**不成立**。 ## 四、需要作者确认(我未能核实) - `main_window.py:846/1378`:子代理称入队使用"UI 当前库"且在 worker 线程读 QWidget(错库放行/跨线程)。我未在引用行附近确认到跨线程读控件的直接证据,请作者自查这两处是否在非 GUI 线程访问了控件。 ## 五、P3 - 非 checkpoint 租约不落盘(重启后无法解释上一次租约); - 导出预存的进程豁免范围偏宽; - 文档里的 1775/1851/1880 三组测试数字无法复现(建议附上生成命令与 commit)。 ## 验证记录 - 基准确认:`git merge-base --is-ancestor` 四段区间均成立;`origin/main` 树含 `residual_sessions.py`/`pcb_open_consent.py`,版本 0.2.4b2。 - 逐行核对 `backup_recovery.py:31-58`、`residual_sessions.py:19-61`、`pcb_open_consent.py:48-70/100-140`、`stop_control` 相关路径(main)。 - 未跑 pytest、未上原生真机(与作者声明的边界一致)。 ## 未验证边界 真实原生会话下 `_idle_check` 的漏拦概率;`ERROR_SHARING_VIOLATION` 在真实 Mentor 上的实际发生率;跨线程访问控件的具体调用栈。
Author
Owner

后续审查:1572e2d + fee4a67(评论 414 的修复提交)

本次审查针对本地分支 codex/import-without-export-gate 相对 main(cbc5723)的两个提交(尚未推送,可 fast-forward):

  • 1572e2d fix: decouple CBB imports from optional export diagnostics
  • fee4a67 fix: address review 414 write consent and native ownership boundaries

结论:代码层面可以合并,未发现阻断性缺陷。 建议合并前先确认下面 3 个语义问题,并按流程推送分支、另开 PR 关联本评论。

验证(本机沙箱,无 Mentor 现场环境)

  • pytest --collect-only 收集 1914 项,与 docs/releases/2026-11-13-review-414-validation.json 记录一致。
  • 改动涉及的 11 个测试文件共 218 项全部通过,其中包含本次新增的 28 项(write admission、导入解耦、导出释放、备份恢复、管理批处理、原生管理、后台队列)。
  • 全量测试在本沙箱受私有桌面/进程/GUI 限制:执行到约 94% 时已出现 26 项失败,随后在 GUI 子集挂起。已在 origin/main 基线(同沙箱、同参数)逐项对照,失败与挂起完全一致,未观察到本分支特有的测试回归。
  • git diff --check、python -m compileall -q src tests 通过;与 origin/main 无冲突;diff 中未发现敏感信息。

需要确认的问题

  1. 写后身份采集失败被当成“可安全继续”
    capture_registration_identity() 在任意异常时返回 IdentityOutcome(None, True, ...)(native_engineering_identity.py:243-255)。旧 capture_identity() 在写后原生采集失败时返回 False。现在结果虽是 RECOVERY_REQUIRED,却会通过 safe_to_continue=True 允许同库后续条目继续写入(management.py:400-413)。
    建议:写后采集异常分支返回 safe_to_continue=False,并补一条该路径的测试。

  2. 无界面/API 场景的状态语义
    WriteAdmission.confirm() 在 prompt is None 时抛普通 ValueError(write_admission.py:51),管理侧会映射成 UPLOAD_FAILED,容易被读成“上传失败”;备份恢复里用户选“跳过本项”则返回 BLOCKED/FAIL(backup_recovery.py:303)。
    建议:无提示场景抛 WriteAdmissionDeclined('skip'),统一返回 SKIPPED,避免误报。

  3. _idle_check() 重复探测
    每次调用固定做两轮进程查询 + 两轮独占资源探测(backup_recovery.py:31-66);无未知进程时第二轮是冗余的,而一次 add/update 会调用 idle check 5 次以上。对 SMB/网络库会放大延迟与瞬时共享冲突概率。
    建议:仅在出现未知进程、需要二次确认时再做第二轮。

其他建议

  • 新增代码风格与本仓库现有风格差异较大(密集单行、无空格赋值),建议整理后再合并;
  • pcb_open_consent 关闭独占句柄后再向原生窗口发点击,存在残余 TOCTOU 窗口;建议在代码注释中写明这是为避开 Mentor 自身 sharing violation 的已知取舍;
  • 两个提交没有正文,建议 PR 描述补齐变更、验证命令与回滚方式;
  • 本次 diff 与验证文档中含 40 处本机绝对路径(F:\CbbReview414\...),如需外发请脱敏;
  • 2026-11-13-review-414-validation.json 的冻结包校验早于 fee4a67,合并后需重建包并做一次冒烟。

产品边界

本次变更主动弱化了“导入内容等价”的保证:不再比对原生重写后的 ICDB 原始字节,coverage.schematic_semantics_checked=False,其他工程文件差异只记录不阻断,READY 只依赖可选的完整 Verify。文档已明确不宣称原理图语义等价。这一边界需要产品侧明确接受;若要求导入必须证明内容等价,则不建议直接合并。

验收边界

EDIF 0xC0000005 根因仍未定位(已移出普通导入路径);Windows 10、跨机 SMB、现场服务器失联修复未验收;自动 ICDB Repair 仍关闭。代码合并不等于现场验收或正式发布,云端 v0.2.4-beta.2 发布包不因本次合并自动更新。

### 后续审查:`1572e2d` + `fee4a67`(评论 414 的修复提交) 本次审查针对本地分支 `codex/import-without-export-gate` 相对 `main`(`cbc5723`)的两个提交(尚未推送,可 fast-forward): - `1572e2d` fix: decouple CBB imports from optional export diagnostics - `fee4a67` fix: address review 414 write consent and native ownership boundaries **结论:代码层面可以合并,未发现阻断性缺陷。** 建议合并前先确认下面 3 个语义问题,并按流程推送分支、另开 PR 关联本评论。 #### 验证(本机沙箱,无 Mentor 现场环境) - `pytest --collect-only` 收集 **1914 项**,与 `docs/releases/2026-11-13-review-414-validation.json` 记录一致。 - 改动涉及的 11 个测试文件共 **218 项全部通过**,其中包含本次新增的 28 项(write admission、导入解耦、导出释放、备份恢复、管理批处理、原生管理、后台队列)。 - 全量测试在本沙箱受私有桌面/进程/GUI 限制:执行到约 94% 时已出现 26 项失败,随后在 GUI 子集挂起。已在 `origin/main` 基线(同沙箱、同参数)逐项对照,失败与挂起完全一致,**未观察到本分支特有的测试回归**。 - `git diff --check`、`python -m compileall -q src tests` 通过;与 `origin/main` 无冲突;diff 中未发现敏感信息。 #### 需要确认的问题 1. **写后身份采集失败被当成“可安全继续”** `capture_registration_identity()` 在任意异常时返回 `IdentityOutcome(None, True, ...)`(`native_engineering_identity.py:243-255`)。旧 `capture_identity()` 在写后原生采集失败时返回 False。现在结果虽是 `RECOVERY_REQUIRED`,却会通过 `safe_to_continue=True` 允许同库后续条目继续写入(`management.py:400-413`)。 建议:写后采集异常分支返回 `safe_to_continue=False`,并补一条该路径的测试。 2. **无界面/API 场景的状态语义** `WriteAdmission.confirm()` 在 `prompt is None` 时抛普通 `ValueError`(`write_admission.py:51`),管理侧会映射成 `UPLOAD_FAILED`,容易被读成“上传失败”;备份恢复里用户选“跳过本项”则返回 `BLOCKED/FAIL`(`backup_recovery.py:303`)。 建议:无提示场景抛 `WriteAdmissionDeclined('skip')`,统一返回 `SKIPPED`,避免误报。 3. **`_idle_check()` 重复探测** 每次调用固定做两轮进程查询 + 两轮独占资源探测(`backup_recovery.py:31-66`);无未知进程时第二轮是冗余的,而一次 add/update 会调用 idle check 5 次以上。对 SMB/网络库会放大延迟与瞬时共享冲突概率。 建议:仅在出现未知进程、需要二次确认时再做第二轮。 #### 其他建议 - 新增代码风格与本仓库现有风格差异较大(密集单行、无空格赋值),建议整理后再合并; - `pcb_open_consent` 关闭独占句柄后再向原生窗口发点击,存在残余 TOCTOU 窗口;建议在代码注释中写明这是为避开 Mentor 自身 `sharing violation` 的已知取舍; - 两个提交没有正文,建议 PR 描述补齐变更、验证命令与回滚方式; - 本次 diff 与验证文档中含 40 处本机绝对路径(`F:\CbbReview414\...`),如需外发请脱敏; - `2026-11-13-review-414-validation.json` 的冻结包校验早于 `fee4a67`,合并后需重建包并做一次冒烟。 #### 产品边界 本次变更主动弱化了“导入内容等价”的保证:不再比对原生重写后的 ICDB 原始字节,`coverage.schematic_semantics_checked=False`,其他工程文件差异只记录不阻断,READY 只依赖可选的完整 Verify。文档已明确不宣称原理图语义等价。这一边界需要产品侧明确接受;若要求导入必须证明内容等价,则不建议直接合并。 #### 验收边界 EDIF `0xC0000005` 根因仍未定位(已移出普通导入路径);Windows 10、跨机 SMB、现场服务器失联修复未验收;自动 ICDB Repair 仍关闭。代码合并不等于现场验收或正式发布,云端 `v0.2.4-beta.2` 发布包不因本次合并自动更新。
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#13