审查拆分 2/4:原生诊断、工程清单与 CBB 事务后端 #10

Merged
abaishu0730 merged 7 commits from codex/review-native-backend into main 2026-11-12 17:39:14 +08:00
Owner

历史释放记录在校验路径被跳过、在管理路径又触发复核,导致准入和报告口径不一致。现在两者共用实际占用复核:旧 JSON/内存租约触发当前进程、地址、独占文件和导出副本证明,确认释放后归档继续,不以历史记录本身判为占用,不执行进程关闭或 Repair。

对评论 275 的处理:管理在首次原生调用前保存释放经过,结果保留 release_proof 和“会话释放不等于历史数据恢复”的事实。写前失败(包括查询超时、证据目录配置错误)不会被当作本次会话未释放,从而误停下一独立项。release_check 失败原本已返回 BLOCKED;本轮没有重复增加门禁,也没有采用与用户明确要求冲突的“发现历史记录就停批”。

原生写入后增加目标工程、库配置及共享依赖的新增/删除/修改清单和写后 manifest;已释放的部分失败也会记录,活跃会话不为报告重新读取。明确不检查其他 CBB 内容,不新增全库备份/全库内容哈希。报告失败独立标为 UNCONFIRMED,不制造未完成原生事务;PASS 不再重复计入 unconfirmed。

失败安全:保留实际占用证据;本次未启动或已释放的失败可继续独立项。同目标未完成写入仍不自动重放。回滚按依赖逆序,代码回退不能恢复原生事务或丢失数据。

基线现为 main(#5/#9 已合并)。依赖闭包仍包含原生诊断、manifest、管理事务和释放证明;#11 接入界面,#12 单独接入残留释放。后端阶段独立验证 1,385 passed;本阶段未打包部署旧 UI,最终行为以 #11/#12 接入为准。

本轮完整集成回归 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 复核跟进

评论 #309 已修复:释放证明记录 requested_block_name、实际 BLOCK/LIBRARY 范围、被归档的检查点与 retained owner 身份,以及 reconciled_foreign_blockers。BlockA 操作核对了 BlockB 的历史占用时会明确列出 BlockB;仍不把进程释放等同于工程数据恢复,也没有新增阻塞门禁。

本分支相关回归 94 passed,compileall / diff 检查通过;独立复查无重要新问题。源修复 b7baa24,记录 docs/releases/2026-11-09-pr10-review309.md。修复已顺序同步到 #11–#13;最终集成树的全量验证记录见 #13。

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

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

评论 #344 跟进:状态查询默认新读,生产始终不复用旧 READY;明确低层显式断点 API 的适用限制。变更清单从实际分类常量生成排除目录/后缀/运行时规则与版本;移除未使用且默认释放口径偏乐观的 execution_outcome。复制改为边复制边计算摘要,减少一次源读取,同时保留最终源/目标 SHA256,仍拦截同大小同时间戳的内容变化。

修复 e8a1714;后端针对性测试 287 passed。没有采纳删除最终源哈希的建议,避免削弱来源变化检测。

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

历史释放记录在校验路径被跳过、在管理路径又触发复核,导致准入和报告口径不一致。现在两者共用实际占用复核:旧 JSON/内存租约触发当前进程、地址、独占文件和导出副本证明,确认释放后归档继续,不以历史记录本身判为占用,不执行进程关闭或 Repair。 对评论 275 的处理:管理在首次原生调用前保存释放经过,结果保留 release_proof 和“会话释放不等于历史数据恢复”的事实。写前失败(包括查询超时、证据目录配置错误)不会被当作本次会话未释放,从而误停下一独立项。`release_check` 失败原本已返回 BLOCKED;本轮没有重复增加门禁,也没有采用与用户明确要求冲突的“发现历史记录就停批”。 原生写入后增加目标工程、库配置及共享依赖的新增/删除/修改清单和写后 manifest;已释放的部分失败也会记录,活跃会话不为报告重新读取。明确不检查其他 CBB 内容,不新增全库备份/全库内容哈希。报告失败独立标为 UNCONFIRMED,不制造未完成原生事务;PASS 不再重复计入 unconfirmed。 失败安全:保留实际占用证据;本次未启动或已释放的失败可继续独立项。同目标未完成写入仍不自动重放。回滚按依赖逆序,代码回退不能恢复原生事务或丢失数据。 基线现为 main(#5/#9 已合并)。依赖闭包仍包含原生诊断、manifest、管理事务和释放证明;#11 接入界面,#12 单独接入残留释放。后端阶段独立验证 1,385 passed;本阶段未打包部署旧 UI,最终行为以 #11/#12 接入为准。 本轮完整集成回归 **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 复核跟进 评论 #309 已修复:释放证明记录 requested_block_name、实际 BLOCK/LIBRARY 范围、被归档的检查点与 retained owner 身份,以及 reconciled_foreign_blockers。BlockA 操作核对了 BlockB 的历史占用时会明确列出 BlockB;仍不把进程释放等同于工程数据恢复,也没有新增阻塞门禁。 本分支相关回归 94 passed,compileall / diff 检查通过;独立复查无重要新问题。源修复 b7baa24,记录 docs/releases/2026-11-09-pr10-review309.md。修复已顺序同步到 #11–#13;最终集成树的全量验证记录见 #13。 本轮仅处理 11 月 9 日最新复核意见,11 月 6 日旧深审遗留不在所选范围。没有重新打包;旧测试包不含这些改动。真实 Mentor、Windows 10、共享库/跨机器场景仍未验收。保持 Draft,不合并、不关闭工单。 ### 11 月 9 日完整审查后续修正 评论 #344 跟进:状态查询默认新读,生产始终不复用旧 READY;明确低层显式断点 API 的适用限制。变更清单从实际分类常量生成排除目录/后缀/运行时规则与版本;移除未使用且默认释放口径偏乐观的 execution_outcome。复制改为边复制边计算摘要,减少一次源读取,同时保留最终源/目标 SHA256,仍拦截同大小同时间戳的内容变化。 修复 e8a1714;后端针对性测试 287 passed。没有采纳删除最终源哈希的建议,避免削弱来源变化检测。 本轮未重新打包;旧 iconfix 测试包不含本轮修复。图标和两处 LF 规则保持。真实 Mentor、冻结新行为、Windows 10、共享库/跨机器场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不发布、不关闭工单。
Author
Owner

审查 2/4:原生后端(诊断 / 清单 / 管理事务)——修复后合并(3×P2 + 2×P3,无 P1)

范围:#10 相对 #9(9e230e1..da67de0),91 文件 +14,368/−433。核心是 library_lock.py(571)、native_diagnostic.py(522)、scoped_manifest.py(492)、native_backup.py(466)、management.py(+)、native_management.py(356)、management_transaction.py(124)。

结论

修复后合并。 安全设计的主干是好的,而且有几处做得比同类工具更严;问题集中在门禁的适用面和报告口径,不是"可能写坏库"级别。

我逐一复核且认为成立的设计

  1. management_transaction 的权威绑定很硬(management_transaction.py:81-124):nonce、checkpoint 阶段、lease_id、supervisor_pid 存活、源工程 engineering_identity + build_manifest、库基线、连"租约句柄是否真指向本库的 .lock"都用 DuplicateHandle+GetFinalPathNameByHandle 复核(:110-120)。这挡住了句柄替换/张冠李戴,是我这次审查里最扎实的一段。
  2. release_retained_library 是"证明式释放"(library_lock.py:501-570):要求无 scoped 进程、无 sAddress.adr、对 .lmc/icdb.dat/layoutdb.lyt 拿独占句柄、导出副本已释放、释放期间检查点未变;成功后把 blocker 原始字节归档成 blocker-before-N.json 并校验字节一致,只删 JSON 检查点、绝不删 .lock(:558-566)。证据留在库外。
  3. 能力探测(native_management.py:113-129)在 prepare_transaction 和 validate_transaction 两处都重新查,不是启动时缓存一次。

P2(建议合并前改)

[P2-1] run_management 会隐式自动解除 blocker,且失败被报成 UPLOAD_FAILED

  • 位置:management.py:259-264。
    if (has_blocker(library) or has_retained_library(library) or request.check_previous_release
            or unfinished_target and unfinished_target.get('safe_to_continue') is not True):
        release_proof = release_retained_library(library, root/'previous-release')
    
  • 触发场景:库里留有上一次(甚至是别的 CBB)未确认释放的检查点 OWNER_RELEASE_UNCONFIRMED → 操作员点"新增/替换/移除"后,程序在没有任何提示的情况下先做一次完整释放证明并归档删除该检查点,然后直接开始写库。request.check_previous_release 默认 False、UI 也没有任何地方置位,所以这条路径实际上只由"库里存在 blocker"触发。
  • 与契约冲突:release_retained_library 的 docstring 写的是 "Explicit user-requested release",README/SOP 写的是"未确认释放必须停批、保留现场"。这里既不是用户请求,也没有"停批"这一步。
  • 安全性边界(我复核过,避免夸大):不是无证明写库。release_retained_library 内部 _prove_library_released 会重新证明无进程/无地址/独占句柄,证明不成立就 raise LibraryBusy,操作终止;成功时 blocker 字节已归档。所以真实影响是"未告知的状态清理",不是"绕过释放证明"。
  • 附带缺陷 1(同一处):证明失败抛的是 LibraryBusy(OSError),落到 management.py:371-378 的 except Exception 后,add/update 会被记成 UPLOAD_FAILED——但此时一次原生调用都没发生(mutated=False)。remove 才是 BLOCKED。运维看到 UPLOAD_FAILED 会以为原生上传失败并去查 Mentor,属于误导。
  • 附带缺陷 2:释放记录里写着 data_recovery_confirmed: False(library_lock.py:551),意思是"进程已释放,但库数据是否被上一轮改坏没有确认"。这个字段既不进 checkpoint 也不上浮到 UI,操作员看到的仍是平常的"操作成功",等于把"数据可能不一致"这条信息丢在证据文件里。
  • 建议:has_blocker/has_retained_library 命中时改为"停批 + 明确原因(指向释放入口)",或在管理对话框里加一条需要显式勾选/确认的"先解除上一轮未确认释放";release_proof 的证明结果写进 checkpoint;LibraryBusy/OSError 在未发生原生调用时统一报 BLOCKED。

[P2-2] 校验路径用 LibraryLock(checkpoint=False),跳过 blocker 门禁——写库路径不遵守自己定的规则

  • 位置:verify_runner.py:571-579。
    library_lock = LibraryLock(request.lmc_file, checkpoint=False, safe_to_release=clients_released)
    
    而 LibraryLock.__enter__(library_lock.py:155-156)里是 if self.checkpoint and has_blocker(self.library): raise LibraryBusy(...)。
  • 后果:库里存在持久化的 OWNER_RELEASE_UNCONFIRMED 时,管理/维护路径会被挡住,但校验路径照常进入;而校验本身会调用 refresh_integration 写库,是一个写操作。
  • 我做的临时探针:有 blocker 时普通 lease 抛 LibraryBusy,checkpoint=False 的 lease 正常进入 —— 门禁确实被这个参数关掉了。
  • 减轻因素:校验前还有 unreleased_addresses、目标 PCB 打开检查、WMI owner 探测等门禁,通常能兜住"blocker 对应的现场仍然存在"的情况;但 blocker 的语义比这些检查宽(也覆盖检查点/映射状态),不能互相替代。
  • 建议:校验也走 checkpoint=True(或至少 checkpoint=False, block_gate=True),确保"库上有未确认释放"这个事实对所有写库路径都生效。

[P2-3] 写前库基线只防篡改,不做写后对比

  • management.py:301 采集 library-baseline-manifest.json,但全仓库只有 management_transaction.py:106 拿它和自己比较(防篡改)。remove/update/add 完成后没有重新扫描库,因此无法证明"只改动了目标 CBB、其它 CBB 未被波及"。
  • 这条正好卡在"能不能证明只改了目标 CBB"上:management.py:298-338 已经把写前基线采集出来了,差一步就能给出写后差分。
  • 建议:写后 build_manifest(library.parent) 与基线做差分,把"新增/删除/修改的文件列表"写进报告;这正好能回答现场最常问的"这次到底动了什么"。

P3(不阻塞合并)

[P3-1] maintenance_counts 把 PASS 同时计入 passed 和 unconfirmed

  • 位置:icdb_maintenance.py:27-29。unconfirmed 的判据是 status not in ('CHECKED','SKIPPED','CANCELLED') and error_category not in (...),PASS 不在这两个排除集里。
  • 实测(#12 树内直接调用):
    VerifyResult('PASS', library_flag='GREEN', safe_to_continue=True)
    -> {'passed': 1, ..., 'unconfirmed': 1, ...}
    
    即 passed + checked_without_repair + unconfirmed 会大于 total。运维拿这份 JSON 对账会算不平。
  • 建议:unconfirmed 里排除 PASS,或直接把 unconfirmed 改名成 other。

[P3-2] includes_ready: False 在 #10 单独合并时与 UI 不一致(#11 起已对齐)

  • icdb_maintenance.py:37 硬编码 'includes_ready': False;而 #10 的 ui/main_window.py:375 调用 self._run(names, include_ready=True),_run(:417-419)确实把 READY 条目带上。
  • #11 已把入口改成 _maintenance_names()(过滤 READY),从 #11 起这个字段才准确。
  • 建议:要么让 write_maintenance_report 接收 includes_ready 参数由调用方传入,要么在 #10 的审查记录里注明"该字段在 #10 单独部署时不准,随 #11 修正"。

验证记录

  • 代码级验证:上述 file:line 均在本 PR 树内逐条读过;maintenance_counts 的双计为实跑输出。
  • 独占全量测试本机结果:1376 passed, 1 warning in 225.35s,与 PR 自述的 1,376 一致。三路并发跑时出现成片 已有 CBB 校验任务运行(会话级互斥 Local\CbbRefreshVerify795),那些失败是并发伪失败,不是本 PR 缺陷;但"测试套件不并行安全"本身仍是遗留问题。
  • 未验证:真实 Mentor 原生新增/移除(只读审查,未在真库上执行);网络盘上的独占句柄语义。
# 审查 2/4:原生后端(诊断 / 清单 / 管理事务)——修复后合并(3×P2 + 2×P3,无 P1) 范围:#10 相对 #9(`9e230e1..da67de0`),91 文件 +14,368/−433。核心是 `library_lock.py`(571)、`native_diagnostic.py`(522)、`scoped_manifest.py`(492)、`native_backup.py`(466)、`management.py`(+)、`native_management.py`(356)、`management_transaction.py`(124)。 ## 结论 **修复后合并。** 安全设计的主干是好的,而且有几处做得比同类工具更严;问题集中在**门禁的适用面**和**报告口径**,不是"可能写坏库"级别。 ### 我逐一复核且认为成立的设计 1. **`management_transaction` 的权威绑定很硬**(`management_transaction.py:81-124`):nonce、checkpoint 阶段、`lease_id`、`supervisor_pid` 存活、源工程 `engineering_identity` + `build_manifest`、库基线、连"租约句柄是否真指向本库的 `.lock`"都用 `DuplicateHandle`+`GetFinalPathNameByHandle` 复核(`:110-120`)。这挡住了句柄替换/张冠李戴,是我这次审查里最扎实的一段。 2. **`release_retained_library` 是"证明式释放"**(`library_lock.py:501-570`):要求无 scoped 进程、无 `sAddress.adr`、对 `.lmc`/`icdb.dat`/`layoutdb.lyt` 拿独占句柄、导出副本已释放、释放期间检查点未变;成功后把 blocker 原始字节归档成 `blocker-before-N.json` 并校验字节一致,只删 JSON 检查点、**绝不删 `.lock`**(`:558-566`)。证据留在库外。 3. 能力探测(`native_management.py:113-129`)在 `prepare_transaction` 和 `validate_transaction` 两处都重新查,不是启动时缓存一次。 ## P2(建议合并前改) ### [P2-1] `run_management` 会**隐式自动解除** blocker,且失败被报成 `UPLOAD_FAILED` - 位置:`management.py:259-264`。 ```python if (has_blocker(library) or has_retained_library(library) or request.check_previous_release or unfinished_target and unfinished_target.get('safe_to_continue') is not True): release_proof = release_retained_library(library, root/'previous-release') ``` - 触发场景:库里留有**上一次(甚至是别的 CBB)**未确认释放的检查点 `OWNER_RELEASE_UNCONFIRMED` → 操作员点"新增/替换/移除"后,程序在**没有任何提示**的情况下先做一次完整释放证明并归档删除该检查点,然后直接开始写库。`request.check_previous_release` 默认 `False`、UI 也没有任何地方置位,所以这条路径实际上只由"库里存在 blocker"触发。 - 与契约冲突:`release_retained_library` 的 docstring 写的是 "**Explicit user-requested** release",README/SOP 写的是"未确认释放必须停批、保留现场"。这里既不是用户请求,也没有"停批"这一步。 - 安全性边界(我复核过,避免夸大):**不是无证明写库**。`release_retained_library` 内部 `_prove_library_released` 会重新证明无进程/无地址/独占句柄,证明不成立就 `raise LibraryBusy`,操作终止;成功时 blocker 字节已归档。所以真实影响是"**未告知的状态清理**",不是"绕过释放证明"。 - 附带缺陷 1(同一处):证明失败抛的是 `LibraryBusy(OSError)`,落到 `management.py:371-378` 的 `except Exception` 后,`add/update` 会被记成 `UPLOAD_FAILED`——但此时**一次原生调用都没发生**(`mutated=False`)。`remove` 才是 `BLOCKED`。运维看到 `UPLOAD_FAILED` 会以为原生上传失败并去查 Mentor,属于误导。 - 附带缺陷 2:释放记录里写着 `data_recovery_confirmed: False`(`library_lock.py:551`),意思是"进程已释放,但库数据是否被上一轮改坏没有确认"。这个字段既不进 checkpoint 也不上浮到 UI,操作员看到的仍是平常的"操作成功",等于把"数据可能不一致"这条信息丢在证据文件里。 - 建议:`has_blocker`/`has_retained_library` 命中时改为"停批 + 明确原因(指向释放入口)",或在管理对话框里加一条需要显式勾选/确认的"先解除上一轮未确认释放";`release_proof` 的证明结果写进 checkpoint;`LibraryBusy`/`OSError` 在未发生原生调用时统一报 `BLOCKED`。 ### [P2-2] 校验路径用 `LibraryLock(checkpoint=False)`,**跳过 blocker 门禁**——写库路径不遵守自己定的规则 - 位置:`verify_runner.py:571-579`。 ```python library_lock = LibraryLock(request.lmc_file, checkpoint=False, safe_to_release=clients_released) ``` 而 `LibraryLock.__enter__`(`library_lock.py:155-156`)里是 `if self.checkpoint and has_blocker(self.library): raise LibraryBusy(...)`。 - 后果:库里存在持久化的 `OWNER_RELEASE_UNCONFIRMED` 时,管理/维护路径会被挡住,但**校验路径照常进入**;而校验本身会调用 `refresh_integration` 写库,是一个写操作。 - 我做的临时探针:有 blocker 时普通 lease 抛 `LibraryBusy`,`checkpoint=False` 的 lease 正常进入 —— 门禁确实被这个参数关掉了。 - 减轻因素:校验前还有 `unreleased_addresses`、目标 PCB 打开检查、WMI owner 探测等门禁,通常能兜住"blocker 对应的现场仍然存在"的情况;但 blocker 的语义比这些检查宽(也覆盖检查点/映射状态),不能互相替代。 - 建议:校验也走 `checkpoint=True`(或至少 `checkpoint=False, block_gate=True`),确保"库上有未确认释放"这个事实对所有写库路径都生效。 ### [P2-3] 写前库基线只防篡改,不做写后对比 - `management.py:301` 采集 `library-baseline-manifest.json`,但全仓库只有 `management_transaction.py:106` 拿它和**自己**比较(防篡改)。remove/update/add 完成后没有重新扫描库,因此**无法证明"只改动了目标 CBB、其它 CBB 未被波及"**。 - 这条正好卡在"能不能证明只改了目标 CBB"上:`management.py:298-338` 已经把写前基线采集出来了,差一步就能给出写后差分。 - 建议:写后 `build_manifest(library.parent)` 与基线做差分,把"新增/删除/修改的文件列表"写进报告;这正好能回答现场最常问的"这次到底动了什么"。 ## P3(不阻塞合并) ### [P3-1] `maintenance_counts` 把 PASS 同时计入 `passed` 和 `unconfirmed` - 位置:`icdb_maintenance.py:27-29`。`unconfirmed` 的判据是 `status not in ('CHECKED','SKIPPED','CANCELLED') and error_category not in (...)`,PASS 不在这两个排除集里。 - 实测(#12 树内直接调用): ``` VerifyResult('PASS', library_flag='GREEN', safe_to_continue=True) -> {'passed': 1, ..., 'unconfirmed': 1, ...} ``` 即 `passed + checked_without_repair + unconfirmed` 会大于 `total`。运维拿这份 JSON 对账会算不平。 - 建议:`unconfirmed` 里排除 `PASS`,或直接把 `unconfirmed` 改名成 `other`。 ### [P3-2] `includes_ready: False` 在 #10 单独合并时与 UI 不一致(#11 起已对齐) - `icdb_maintenance.py:37` 硬编码 `'includes_ready': False`;而 #10 的 `ui/main_window.py:375` 调用 `self._run(names, include_ready=True)`,`_run`(`:417-419`)确实把 READY 条目带上。 - #11 已把入口改成 `_maintenance_names()`(过滤 READY),从 #11 起这个字段才准确。 - 建议:要么让 `write_maintenance_report` 接收 `includes_ready` 参数由调用方传入,要么在 #10 的审查记录里注明"该字段在 #10 单独部署时不准,随 #11 修正"。 ## 验证记录 - 代码级验证:上述 `file:line` 均在本 PR 树内逐条读过;`maintenance_counts` 的双计为实跑输出。 - **独占全量测试**本机结果:`1376 passed, 1 warning in 225.35s`,与 PR 自述的 1,376 一致。三路并发跑时出现成片 `已有 CBB 校验任务运行`(会话级互斥 `Local\CbbRefreshVerify795`),那些失败是并发伪失败,不是本 PR 缺陷;但"测试套件不并行安全"本身仍是遗留问题。 - 未验证:真实 Mentor 原生新增/移除(只读审查,未在真库上执行);网络盘上的独占句柄语义。
abaishu0730 changed target branch from codex/review-infrastructure to main 2026-11-06 10:26:29 +08:00
abaishu0730 added 1 commit 2026-11-06 10:26:29 +08:00
abaishu0730 added 4 commits 2026-11-06 11:55:32 +08:00
Author
Owner

审查 2/4(复核 head 807aa26):前轮 3×P2 + 1×P3 已修,新增 1×P3

范围:da67de0..807aa26b,3 个作者提交(8eefecd / 679f33b / 807aa26)+ main/#9/#5 合并。源码净变更 4 个文件 / +72/−13,新增 tests/test_review_backend_followup.py(138)。

逐条复核

前轮项 本轮实现 判定
P2-1 隐式释放 + 失败误报 UPLOAD_FAILED 新增 recheck_previous_release(library_lock.py:85-104):有 previous_release_check/unconfirmed/confirmed 三个阶段、release_check 检查点、release_proof 进结果;management.py:418-419 把 stage == 'release_check' 且未变更的失败改判 BLOCKED;UI 补"历史会话已释放;历史工程数据的恢复状态需另行核对" 已修,且把口径从"用户请求释放"改成"复核历史占用",docstring 同步改了,这点处理得比原来诚实
P2-2 校验路径用 checkpoint=False 跳过 blocker 门禁 verify_runner.py:571-579 在取 LibraryLock 之前先 recheck_previous_release;证明不成立返回 FAIL/LIBRARY_IN_USE,LibraryBusy 之外的异常落到 LIBRARY_ACCESS_FAILED;proof 写进 VerifyResult 与证据 已修
P2-3 只有写前基线、没有写后对比 management.py:213-241:写后 build_exclusive_library_manifest → library-changes.json(added/deleted/modified)+ library-after-manifest.json;失败降 UNCONFIRMED 并把 detail 拼进结果文案 已修,unrelated_cbb_content_checked: False 这个字段写得很对
P3-1 PASS 同时计入 passed/unconfirmed icdb_maintenance.py:24 把 PASS 加进排除集 已修

测试不是走过场,test_review_backend_followup.py 里几条我认为是对的:

  • 占用存在时断言 blocker_path 字节不变且返回 LIBRARY_IN_USE;
  • 释放成功后断言 release_proof['data_recovery_confirmed'] is False(不把"进程释放"说成"数据恢复");
  • 用 Path.open 拦截,断言写后差分不读取无关 CBB 的文件(ReusableBlocksLP/Other/...),并验证 SymbolLibs 共享依赖的变化会被记入 modified。

新发现

[P3] 别的 CBB 留下的 blocker 会被顺带清掉,证据里看不出是"别人的"

release_retained_library 只在所有检查点记录与 owner 的 block_name 都等于入参时才用窄作用域,否则退回整库证明(library_lock.py:560-564)。于是:

  • 库里留着 BlockB 的 OWNER_RELEASE_UNCONFIRMED;
  • 操作员对 BlockA 执行"新增/校验";
  • recheck_previous_release 仍会走整库证明,成功后归档并删除 BlockB 的检查点,而 release_proof 里只有入参 block_name='BlockA'。

安全性没问题(证明仍是"无进程 + 无 sAddress.adr + 独占句柄 + 导出副本已释放"),问题是证据与责任:事后无法从 proof 看出"这次顺手清了另一个 CBB 的检查点",而那个 CBB 的数据可能还没人核对过。

建议二选一:检测到 records/owner 的 block_name 与当前不一致时停批并指名("BlockB 上一次释放未确认,请先处理再继续"),或在 proof/library-changes.json 里写 reconciled_foreign_blockers: ['BlockB']。

边界

  • 本机沙箱里 pytest 的临时目录创建即被拒(mkdir(mode=0o700) 在本沙箱会得到进程自己都打不开的目录),本轮没有复跑测试;以上均为代码级复核,未在真实 Mentor/共享库上执行。

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

# 审查 2/4(复核 head `807aa26`):前轮 3×P2 + 1×P3 已修,新增 1×P3 范围:`da67de0..807aa26b`,3 个作者提交(8eefecd / 679f33b / 807aa26)+ main/#9/#5 合并。源码净变更 4 个文件 / +72/−13,新增 `tests/test_review_backend_followup.py`(138)。 ## 逐条复核 | 前轮项 | 本轮实现 | 判定 | | --- | --- | --- | | **P2-1** 隐式释放 + 失败误报 `UPLOAD_FAILED` | 新增 `recheck_previous_release`(`library_lock.py:85-104`):有 `previous_release_check/unconfirmed/confirmed` 三个阶段、`release_check` 检查点、`release_proof` 进结果;`management.py:418-419` 把 `stage == 'release_check'` 且未变更的失败改判 `BLOCKED`;UI 补"历史会话已释放;历史工程数据的恢复状态需另行核对" | **已修**,且把口径从"用户请求释放"改成"复核历史占用",docstring 同步改了,这点处理得比原来诚实 | | **P2-2** 校验路径用 `checkpoint=False` 跳过 blocker 门禁 | `verify_runner.py:571-579` 在取 `LibraryLock` 之前先 `recheck_previous_release`;证明不成立返回 `FAIL/LIBRARY_IN_USE`,`LibraryBusy` 之外的异常落到 `LIBRARY_ACCESS_FAILED`;proof 写进 `VerifyResult` 与证据 | **已修** | | **P2-3** 只有写前基线、没有写后对比 | `management.py:213-241`:写后 `build_exclusive_library_manifest` → `library-changes.json`(`added/deleted/modified`)+ `library-after-manifest.json`;失败降 `UNCONFIRMED` 并把 detail 拼进结果文案 | **已修**,`unrelated_cbb_content_checked: False` 这个字段写得很对 | | **P3-1** PASS 同时计入 `passed`/`unconfirmed` | `icdb_maintenance.py:24` 把 `PASS` 加进排除集 | **已修** | 测试不是走过场,`test_review_backend_followup.py` 里几条我认为是对的: - 占用存在时断言 `blocker_path` 字节不变且返回 `LIBRARY_IN_USE`; - 释放成功后断言 `release_proof['data_recovery_confirmed'] is False`(不把"进程释放"说成"数据恢复"); - 用 `Path.open` 拦截,断言写后差分**不读取**无关 CBB 的文件(`ReusableBlocksLP/Other/...`),并验证 `SymbolLibs` 共享依赖的变化会被记入 `modified`。 ## 新发现 ### [P3] 别的 CBB 留下的 blocker 会被顺带清掉,证据里看不出是"别人的" `release_retained_library` 只在**所有**检查点记录与 owner 的 `block_name` 都等于入参时才用窄作用域,否则退回整库证明(`library_lock.py:560-564`)。于是: - 库里留着 `BlockB` 的 `OWNER_RELEASE_UNCONFIRMED`; - 操作员对 `BlockA` 执行"新增/校验"; - `recheck_previous_release` 仍会走整库证明,成功后归档并**删除 `BlockB` 的检查点**,而 `release_proof` 里只有入参 `block_name='BlockA'`。 安全性没问题(证明仍是"无进程 + 无 `sAddress.adr` + 独占句柄 + 导出副本已释放"),问题是**证据与责任**:事后无法从 proof 看出"这次顺手清了另一个 CBB 的检查点",而那个 CBB 的数据可能还没人核对过。 建议二选一:检测到 `records`/`owner` 的 `block_name` 与当前不一致时**停批并指名**("BlockB 上一次释放未确认,请先处理再继续"),或在 proof/`library-changes.json` 里写 `reconciled_foreign_blockers: ['BlockB']`。 ## 边界 - 本机沙箱里 pytest 的临时目录创建即被拒(`mkdir(mode=0o700)` 在本沙箱会得到进程自己都打不开的目录),**本轮没有复跑测试**;以上均为代码级复核,未在真实 Mentor/共享库上执行。 **结论:修复后合并(1×P3,无 P1/P2)。**
abaishu0730 added 1 commit 2026-11-09 10:48:33 +08:00
Author
Owner

完整审查 #10(head 807aa26,93 文件 +14,575/−435):可合并(0 P1 + 0 P2 + 3 P3)

覆盖与方式

  • 37 个源码文件全部过目。逐行读完:scoped_manifest.py(365)、network_path.py(344)、management_transaction.py(124)、owner_probe.py(88)、native_occupancy.py(61)、pcb_bridge.py(177)、batch_status.py(307),以及 native_engineering_identity.py 的规范化/身份比对段(1–170)。
  • management.py/library_lock.py/verify_runner.py/native_management.py/mentor_adapter.py/desktop_worker.py/maintenance_entry.py:沿用前几轮逐行结论,本轮复核了它们的入口与失败分支。
  • 其余模块按风险模式全量扫描:157 处 except Exception、2 处 taskkill、2 处 shutil.rmtree、19 处 subprocess、11 处 while True,逐条看过命中点;未发现"吞掉安全事实"或"无界等待"的实例。
  • 测试:68 个测试文件 / 812 个用例,抽查了 manifest、事务、释放、所有权探测四组新增用例。

这片的可靠之处

ManifestScope 的语义边界是对的(project/library 两种作用域、runtime 类别只在结构位置成立时才排除、其他 CBB 直接剪枝不遍历);build_exclusive_library_manifest 对 .lmc/icdb.dat 用独占句柄边读边哈希;copy_verified 对锁定文件同一句柄"读-写-算哈希",并在复制前后用 size+mtime 复核;management_transaction 用 DuplicateHandle + GetFinalPathNameByHandle 验证"租约句柄确实指向本库的 .lock";pcb_bridge 把授权失败分成可回退/不可回退两类;owner_probe 把 WMI 放进独立进程并严格校验回包(pid 类型、去重、名字白名单、快照版本回显)。这些都是"防止写错库/写错工程"的正向证据。

P3(不阻塞)

[P3-1] batch_status 的断点续扫在生产里没有调用方

BatchStatusSession 的 docstring 写着 "with checkpoint recovery",scan(..., resume=True) 也是默认值(batch_status.py:188-221),但仅有的两个调用方都写死 resume=False:ui/main_window.py:66-67 与 application.py:104-105 → authoritative_status_map(batch_status.py:289-307,:302)。结果:status-scan.jsonl 每次被清空重写,BatchCheckpoint/指纹复用只存在于测试里(test_batch_status.py:180-183)。
建议:要么在长批次/断点续扫场景真正接上 resume=True,要么删掉这条特性并同步 docstring——现在这种"文档说有、生产不走"的状态,最容易在评审时被当成已有能力。

[P3-2] 写后变更清单没有声明"哪些类别不在比较范围"

management.py:214-230 生成 library-changes.json(added/deleted/modified + unrelated_cbb_content_checked: False),但排除规则散在 scoped_manifest.py:18-25(log/temp/backup/output/gerber/report/... 目录与 .log/.tmp/.bak/.pdf 后缀)和 :36-47(原生 DB 运行时子目录)。现场拿这份清单证明"本次只改了目标 CBB"时,无法区分"文件没变"与"这个类别根本没参与比较"。
建议:在报告里直接写 excluded_categories/excluded_suffixes(从同一份常量生成,避免漂移),并在 UI 的"变更清单"文案里带一句"以上为参与比较的工程文件"。

[P3-3] pcb_bridge.execution_outcome() 未接线,且默认值偏乐观

pcb_bridge.py:165-177 只在 tests/test_pcb_bridge.py 被调用;它对 SAVE_NOT_CONFIRMED 和 PCB_EXIT_NOT_CONFIRMED 都返回 safe_to_continue: True。当前主链路不用它是安全的(真正的 safe_to_continue 由 automation_release_state() 与剩余客户端决定),但以后一旦有人图省事接上,就会把"保存未确认/PCB 未退出"当成可继续。
建议:删除,或把两个未确认分支改成 False 并在函数名/注释里标"未接线,勿直接使用"。

[P3-4] copy_verified 对非锁定主文件做了两次源哈希(网络盘成本翻倍)

copy_verified(scoped_manifest.py:269-365)在复制时先算一次源摘要(:332-335),随后 validate_bytes(:352-360)又对源重算一次、对目标再算一次。对手工暂存一个数百 MB 的工程、且库在网络盘上的场景,等于把来源读两遍。
建议:保留"目标 vs 复制时摘要"的校验即可;源侧用已有的 size+mtime 复核(函数里本来就有 before/after 比对),或对超过阈值的大文件跳过第二次源哈希并显式记录 source_rehash_skipped。

边界

  • 本机沙箱不能创建 pytest 临时目录,未复跑 812 项;以上均为代码级复核。
  • 未接真实 Mentor/COM/共享库;build_exclusive_library_manifest 的独占句柄语义在网络盘上的行为未验证。
# 完整审查 #10(head `807aa26`,93 文件 +14,575/−435):可合并(0 P1 + 0 P2 + 3 P3) ## 覆盖与方式 - 37 个源码文件全部过目。逐行读完:`scoped_manifest.py`(365)、`network_path.py`(344)、`management_transaction.py`(124)、`owner_probe.py`(88)、`native_occupancy.py`(61)、`pcb_bridge.py`(177)、`batch_status.py`(307),以及 `native_engineering_identity.py` 的规范化/身份比对段(1–170)。 - `management.py`/`library_lock.py`/`verify_runner.py`/`native_management.py`/`mentor_adapter.py`/`desktop_worker.py`/`maintenance_entry.py`:沿用前几轮逐行结论,本轮复核了它们的入口与失败分支。 - 其余模块按风险模式全量扫描:157 处 `except Exception`、2 处 `taskkill`、2 处 `shutil.rmtree`、19 处 `subprocess`、11 处 `while True`,逐条看过命中点;未发现"吞掉安全事实"或"无界等待"的实例。 - 测试:68 个测试文件 / 812 个用例,抽查了 manifest、事务、释放、所有权探测四组新增用例。 ## 这片的可靠之处 `ManifestScope` 的语义边界是对的(project/library 两种作用域、runtime 类别只在结构位置成立时才排除、其他 CBB 直接剪枝不遍历);`build_exclusive_library_manifest` 对 `.lmc`/`icdb.dat` 用独占句柄边读边哈希;`copy_verified` 对锁定文件同一句柄"读-写-算哈希",并在复制前后用 size+mtime 复核;`management_transaction` 用 `DuplicateHandle` + `GetFinalPathNameByHandle` 验证"租约句柄确实指向本库的 `.lock`";`pcb_bridge` 把授权失败分成可回退/不可回退两类;`owner_probe` 把 WMI 放进独立进程并严格校验回包(pid 类型、去重、名字白名单、快照版本回显)。这些都是"防止写错库/写错工程"的正向证据。 ## P3(不阻塞) ### [P3-1] `batch_status` 的断点续扫在生产里没有调用方 `BatchStatusSession` 的 docstring 写着 "with checkpoint recovery",`scan(..., resume=True)` 也是默认值(`batch_status.py:188-221`),但仅有的两个调用方都写死 `resume=False`:`ui/main_window.py:66-67` 与 `application.py:104-105` → `authoritative_status_map`(`batch_status.py:289-307`,`:302`)。结果:`status-scan.jsonl` 每次被清空重写,`BatchCheckpoint`/指纹复用只存在于测试里(`test_batch_status.py:180-183`)。 建议:要么在长批次/断点续扫场景真正接上 `resume=True`,要么删掉这条特性并同步 docstring——现在这种"文档说有、生产不走"的状态,最容易在评审时被当成已有能力。 ### [P3-2] 写后变更清单没有声明"哪些类别不在比较范围" `management.py:214-230` 生成 `library-changes.json`(`added/deleted/modified` + `unrelated_cbb_content_checked: False`),但排除规则散在 `scoped_manifest.py:18-25`(`log/temp/backup/output/gerber/report/...` 目录与 `.log/.tmp/.bak/.pdf` 后缀)和 `:36-47`(原生 DB 运行时子目录)。现场拿这份清单证明"本次只改了目标 CBB"时,无法区分"文件没变"与"这个类别根本没参与比较"。 建议:在报告里直接写 `excluded_categories`/`excluded_suffixes`(从同一份常量生成,避免漂移),并在 UI 的"变更清单"文案里带一句"以上为参与比较的工程文件"。 ### [P3-3] `pcb_bridge.execution_outcome()` 未接线,且默认值偏乐观 `pcb_bridge.py:165-177` 只在 `tests/test_pcb_bridge.py` 被调用;它对 `SAVE_NOT_CONFIRMED` 和 `PCB_EXIT_NOT_CONFIRMED` 都返回 `safe_to_continue: True`。当前主链路不用它是安全的(真正的 `safe_to_continue` 由 `automation_release_state()` 与剩余客户端决定),但以后一旦有人图省事接上,就会把"保存未确认/PCB 未退出"当成可继续。 建议:删除,或把两个未确认分支改成 `False` 并在函数名/注释里标"未接线,勿直接使用"。 ### [P3-4] `copy_verified` 对非锁定主文件做了两次源哈希(网络盘成本翻倍) `copy_verified`(`scoped_manifest.py:269-365`)在复制时先算一次源摘要(`:332-335`),随后 `validate_bytes`(`:352-360`)又对源重算一次、对目标再算一次。对手工暂存一个数百 MB 的工程、且库在网络盘上的场景,等于把来源读两遍。 建议:保留"目标 vs 复制时摘要"的校验即可;源侧用已有的 size+mtime 复核(函数里本来就有 `before/after` 比对),或对超过阈值的大文件跳过第二次源哈希并显式记录 `source_rehash_skipped`。 ## 边界 - 本机沙箱不能创建 pytest 临时目录,未复跑 812 项;以上均为代码级复核。 - 未接真实 Mentor/COM/共享库;`build_exclusive_library_manifest` 的独占句柄语义在网络盘上的行为未验证。
abaishu0730 added 1 commit 2026-11-09 14:49:53 +08:00
Author
Owner

复核 #344 的修复(head e8a1714d):3 个 P3 已修,1 个 P3 我接受你的反驳——可以合并

新增两个提交:b7baa24b(跨 CBB 检查点在释放证据里具名)、e8a1714d(状态新鲜度口径、变更清单规则、copy 读取次数),对应评论 344 的四条 P3。

逐条

344 的项 实现 判定
P3-1 batch_status 的 resume 未接线 scan() 默认改 resume=False,authoritative_status_map 注明生产永远新查、缓存行不得授权生产动作;新增 test_default_scan_refreshes_cached_ready_after_payload_change,用"改 payload 不改 LMC"证明指纹不能当新鲜度证明 已修(选择"文档 + 默认安全"而不是接线,口径现在与代码一致)
P3-2 变更清单没声明排除面 新增 comparison_rules(scope)(scoped_manifest.py),把 rule_version、excluded_categories/suffixes、运行时位置、文件名/前缀、协调检查点全部写进 library-changes.json,并复用分类器同一批常量;UI 文案改为"已比对的工程文件…范围仅限报告列出的工程文件" 已修,测试逐项断言了字段与常量一致
P3-3 pcb_bridge.execution_outcome 未接线且默认乐观 已删除,连带删除两个只测试它的用例 已修
P3-4 copy_verified 二次源哈希 改为"流式复制时算摘要 → 最终源再哈希 → 目标哈希",源读取 3 次降为 2 次;明确拒绝去掉最终源哈希 接受你的反驳:size+mtime 确实无法发现"同尺寸同时间戳"的内容改动,我原来的建议会削弱来源变更检测;现在的做法是对的

验证

  • 我在 PR10 head(e8a1714d)里确认:scan 签名为 resume=False;library-changes.json 的 rule_version/excluded_* 与 scoped_manifest 常量同源;execution_outcome 已无引用;copy_verified 的未锁定主文件走"流式复制+一次源复哈希+一次目标哈希"。
  • 对应测试:test_scoped_manifest.py 的读取次数断言(源 2 次、目标 1 次)、test_review_backend_followup.py 的规则字段断言、test_batch_status.py 的新鲜度用例。

遗留(非本 PR 引入,仅记录)

comparison_rules 里 directory_name_positions/native_directory_positions 是给人读的短语字符串(如 "selected CBB Work/Cert root or its PCB child"),机器无法据此重算排除面。将来若要做"第三方复核工具",建议再给一份机器可读的位置元组;现在作为报告说明已经够用。

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

# 复核 #344 的修复(head `e8a1714d`):3 个 P3 已修,1 个 P3 我接受你的反驳——可以合并 新增两个提交:`b7baa24b`(跨 CBB 检查点在释放证据里具名)、`e8a1714d`(状态新鲜度口径、变更清单规则、copy 读取次数),对应评论 344 的四条 P3。 ## 逐条 | 344 的项 | 实现 | 判定 | | --- | --- | --- | | P3-1 `batch_status` 的 resume 未接线 | `scan()` 默认改 `resume=False`,`authoritative_status_map` 注明生产永远新查、缓存行不得授权生产动作;新增 `test_default_scan_refreshes_cached_ready_after_payload_change`,用"改 payload 不改 LMC"证明指纹不能当新鲜度证明 | **已修**(选择"文档 + 默认安全"而不是接线,口径现在与代码一致) | | P3-2 变更清单没声明排除面 | 新增 `comparison_rules(scope)`(`scoped_manifest.py`),把 `rule_version`、`excluded_categories/suffixes`、运行时位置、文件名/前缀、协调检查点全部写进 `library-changes.json`,并复用分类器同一批常量;UI 文案改为"已比对的工程文件…范围仅限报告列出的工程文件" | **已修**,测试逐项断言了字段与常量一致 | | P3-3 `pcb_bridge.execution_outcome` 未接线且默认乐观 | 已删除,连带删除两个只测试它的用例 | **已修** | | P3-4 `copy_verified` 二次源哈希 | 改为"流式复制时算摘要 → 最终源再哈希 → 目标哈希",源读取 3 次降为 2 次;明确拒绝去掉最终源哈希 | **接受你的反驳**:size+mtime 确实无法发现"同尺寸同时间戳"的内容改动,我原来的建议会削弱来源变更检测;现在的做法是对的 | ## 验证 - 我在 PR10 head(`e8a1714d`)里确认:`scan` 签名为 `resume=False`;`library-changes.json` 的 `rule_version`/`excluded_*` 与 `scoped_manifest` 常量同源;`execution_outcome` 已无引用;`copy_verified` 的未锁定主文件走"流式复制+一次源复哈希+一次目标哈希"。 - 对应测试:`test_scoped_manifest.py` 的读取次数断言(源 2 次、目标 1 次)、`test_review_backend_followup.py` 的规则字段断言、`test_batch_status.py` 的新鲜度用例。 ## 遗留(非本 PR 引入,仅记录) `comparison_rules` 里 `directory_name_positions`/`native_directory_positions` 是给人读的短语字符串(如 "selected CBB Work/Cert root or its PCB child"),机器无法据此重算排除面。将来若要做"第三方复核工具",建议再给一份机器可读的位置元组;现在作为报告说明已经够用。 **结论:可以合并(0 P1/P2/P3 阻断)。**
abaishu0730 marked the pull request as ready for review 2026-11-12 17:39:12 +08:00
abaishu0730 merged commit 229df4b0ef into main 2026-11-12 17:39:14 +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#10