codex/review-native-backend
main
历史释放记录在校验路径被跳过、在管理路径又触发复核,导致准入和报告口径不一致。现在两者共用实际占用复核:旧 JSON/内存租约触发当前进程、地址、独占文件和导出副本证明,确认释放后归档继续,不以历史记录本身判为占用,不执行进程关闭或 Repair。
对评论 275 的处理:管理在首次原生调用前保存释放经过,结果保留 release_proof 和“会话释放不等于历史数据恢复”的事实。写前失败(包括查询超时、证据目录配置错误)不会被当作本次会话未释放,从而误停下一独立项。release_check 失败原本已返回 BLOCKED;本轮没有重复增加门禁,也没有采用与用户明确要求冲突的“发现历史记录就停批”。
release_check
原生写入后增加目标工程、库配置及共享依赖的新增/删除/修改清单和写后 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。
docs/releases/2026-11-06-review-followup-validation.json
docs/reviews/2026-11-06-*-followup.md
未执行真实 Mentor 的强制结束/原生取消或生产库写操作;新冻结包、现场 ICDB 恢复、Windows 10、跨机器共享库并发尚未验收。ICDB 自动修复继续暂停。保持 Draft,等待修正后的审查;没有合并本轮新代码、发布程序或关闭工单。
评论 #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,不合并、不关闭工单。
评论 #344 跟进:状态查询默认新读,生产始终不复用旧 READY;明确低层显式断点 API 的适用限制。变更清单从实际分类常量生成排除目录/后缀/运行时规则与版本;移除未使用且默认释放口径偏乐观的 execution_outcome。复制改为边复制边计算摘要,减少一次源读取,同时保留最终源/目标 SHA256,仍拦截同大小同时间戳的内容变化。
修复 e8a1714;后端针对性测试 287 passed。没有采纳删除最终源哈希的建议,避免削弱来源变化检测。
本轮未重新打包;旧 iconfix 测试包不含本轮修复。图标和两处 LF 规则保持。真实 Mentor、冻结新行为、Windows 10、共享库/跨机器场景未验收;ICDB 自动 Repair 仍关闭。保持 Draft,不合并、不发布、不关闭工单。
范围:#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)。
9e230e1..da67de0
library_lock.py
native_diagnostic.py
scoped_manifest.py
native_backup.py
management.py
native_management.py
management_transaction.py
修复后合并。 安全设计的主干是好的,而且有几处做得比同类工具更严;问题集中在门禁的适用面和报告口径,不是"可能写坏库"级别。
management_transaction
management_transaction.py:81-124
lease_id
supervisor_pid
engineering_identity
build_manifest
.lock
DuplicateHandle
GetFinalPathNameByHandle
:110-120
release_retained_library
library_lock.py:501-570
sAddress.adr
.lmc
icdb.dat
layoutdb.lyt
blocker-before-N.json
:558-566
native_management.py:113-129
prepare_transaction
validate_transaction
run_management
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')
OWNER_RELEASE_UNCONFIRMED
request.check_previous_release
False
_prove_library_released
raise LibraryBusy
LibraryBusy(OSError)
management.py:371-378
except Exception
add/update
mutated=False
remove
BLOCKED
data_recovery_confirmed: False
library_lock.py:551
has_blocker
has_retained_library
release_proof
LibraryBusy
OSError
LibraryLock(checkpoint=False)
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(...)
refresh_integration
checkpoint=False
unreleased_addresses
checkpoint=True
checkpoint=False, block_gate=True
management.py:301
library-baseline-manifest.json
management_transaction.py:106
management.py:298-338
build_manifest(library.parent)
maintenance_counts
passed
unconfirmed
icdb_maintenance.py:27-29
status not in ('CHECKED','SKIPPED','CANCELLED') and error_category not in (...)
VerifyResult('PASS', library_flag='GREEN', safe_to_continue=True) -> {'passed': 1, ..., 'unconfirmed': 1, ...}
passed + checked_without_repair + unconfirmed
total
PASS
other
includes_ready: False
icdb_maintenance.py:37
'includes_ready': False
ui/main_window.py:375
self._run(names, include_ready=True)
_run
:417-419
_maintenance_names()
write_maintenance_report
includes_ready
file:line
1376 passed, 1 warning in 225.35s
已有 CBB 校验任务运行
Local\CbbRefreshVerify795
807aa26
范围:da67de0..807aa26b,3 个作者提交(8eefecd / 679f33b / 807aa26)+ main/#9/#5 合并。源码净变更 4 个文件 / +72/−13,新增 tests/test_review_backend_followup.py(138)。
da67de0..807aa26b
679f33b
tests/test_review_backend_followup.py
recheck_previous_release
library_lock.py:85-104
previous_release_check/unconfirmed/confirmed
management.py:418-419
stage == 'release_check'
LibraryLock
FAIL/LIBRARY_IN_USE
LIBRARY_ACCESS_FAILED
VerifyResult
management.py:213-241
build_exclusive_library_manifest
library-changes.json
added/deleted/modified
library-after-manifest.json
UNCONFIRMED
unrelated_cbb_content_checked: False
icdb_maintenance.py:24
测试不是走过场,test_review_backend_followup.py 里几条我认为是对的:
test_review_backend_followup.py
blocker_path
LIBRARY_IN_USE
release_proof['data_recovery_confirmed'] is False
Path.open
ReusableBlocksLP/Other/...
SymbolLibs
modified
release_retained_library 只在所有检查点记录与 owner 的 block_name 都等于入参时才用窄作用域,否则退回整库证明(library_lock.py:560-564)。于是:
block_name
library_lock.py:560-564
BlockB
BlockA
block_name='BlockA'
安全性没问题(证明仍是"无进程 + 无 sAddress.adr + 独占句柄 + 导出副本已释放"),问题是证据与责任:事后无法从 proof 看出"这次顺手清了另一个 CBB 的检查点",而那个 CBB 的数据可能还没人核对过。
建议二选一:检测到 records/owner 的 block_name 与当前不一致时停批并指名("BlockB 上一次释放未确认,请先处理再继续"),或在 proof/library-changes.json 里写 reconciled_foreign_blockers: ['BlockB']。
records
owner
reconciled_foreign_blockers: ['BlockB']
mkdir(mode=0o700)
结论:修复后合并(1×P3,无 P1/P2)。
network_path.py
owner_probe.py
native_occupancy.py
pcb_bridge.py
batch_status.py
native_engineering_identity.py
verify_runner.py
mentor_adapter.py
desktop_worker.py
maintenance_entry.py
taskkill
shutil.rmtree
subprocess
while True
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 类型、去重、名字白名单、快照版本回显)。这些都是"防止写错库/写错工程"的正向证据。
ManifestScope
copy_verified
pcb_bridge
owner_probe
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——现在这种"文档说有、生产不走"的状态,最容易在评审时被当成已有能力。
BatchStatusSession
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
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 的"变更清单"文案里带一句"以上为参与比较的工程文件"。
management.py:214-230
scoped_manifest.py:18-25
log/temp/backup/output/gerber/report/...
.log/.tmp/.bak/.pdf
:36-47
excluded_categories
excluded_suffixes
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 并在函数名/注释里标"未接线,勿直接使用"。
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()
copy_verified(scoped_manifest.py:269-365)在复制时先算一次源摘要(:332-335),随后 validate_bytes(:352-360)又对源重算一次、对目标再算一次。对手工暂存一个数百 MB 的工程、且库在网络盘上的场景,等于把来源读两遍。 建议:保留"目标 vs 复制时摘要"的校验即可;源侧用已有的 size+mtime 复核(函数里本来就有 before/after 比对),或对超过阈值的大文件跳过第二次源哈希并显式记录 source_rehash_skipped。
scoped_manifest.py:269-365
:332-335
validate_bytes
:352-360
before/after
source_rehash_skipped
e8a1714d
新增两个提交:b7baa24b(跨 CBB 检查点在释放证据里具名)、e8a1714d(状态新鲜度口径、变更清单规则、copy 读取次数),对应评论 344 的四条 P3。
b7baa24b
scan()
test_default_scan_refreshes_cached_ready_after_payload_change
comparison_rules(scope)
rule_version
excluded_categories/suffixes
pcb_bridge.execution_outcome
scan
excluded_*
scoped_manifest
execution_outcome
test_scoped_manifest.py
test_batch_status.py
comparison_rules 里 directory_name_positions/native_directory_positions 是给人读的短语字符串(如 "selected CBB Work/Cert root or its PCB child"),机器无法据此重算排除面。将来若要做"第三方复核工具",建议再给一份机器可读的位置元组;现在作为报告说明已经够用。
comparison_rules
directory_name_positions
native_directory_positions
结论:可以合并(0 P1/P2/P3 阻断)。
No dependencies set.
The note is not visible to the blocked user.
历史释放记录在校验路径被跳过、在管理路径又触发复核,导致准入和报告口径不一致。现在两者共用实际占用复核:旧 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,不合并、不发布、不关闭工单。
abaishu0730 referenced this pull request2026-11-05 23:31:53 +08:00
审查 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)。结论
修复后合并。 安全设计的主干是好的,而且有几处做得比同类工具更严;问题集中在门禁的适用面和报告口径,不是"可能写坏库"级别。
我逐一复核且认为成立的设计
management_transaction的权威绑定很硬(management_transaction.py:81-124):nonce、checkpoint 阶段、lease_id、supervisor_pid存活、源工程engineering_identity+build_manifest、库基线、连"租约句柄是否真指向本库的.lock"都用DuplicateHandle+GetFinalPathNameByHandle复核(:110-120)。这挡住了句柄替换/张冠李戴,是我这次审查里最扎实的一段。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)。证据留在库外。native_management.py:113-129)在prepare_transaction和validate_transaction两处都重新查,不是启动时缓存一次。P2(建议合并前改)
[P2-1]
run_management会隐式自动解除 blocker,且失败被报成UPLOAD_FAILEDmanagement.py:259-264。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 字节已归档。所以真实影响是"未告知的状态清理",不是"绕过释放证明"。LibraryBusy(OSError),落到management.py:371-378的except Exception后,add/update会被记成UPLOAD_FAILED——但此时一次原生调用都没发生(mutated=False)。remove才是BLOCKED。运维看到UPLOAD_FAILED会以为原生上传失败并去查 Mentor,属于误导。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。LibraryLock.__enter__(library_lock.py:155-156)里是if self.checkpoint and has_blocker(self.library): raise LibraryBusy(...)。OWNER_RELEASE_UNCONFIRMED时,管理/维护路径会被挡住,但校验路径照常进入;而校验本身会调用refresh_integration写库,是一个写操作。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 未被波及"。management.py:298-338已经把写前基线采集出来了,差一步就能给出写后差分。build_manifest(library.parent)与基线做差分,把"新增/删除/修改的文件列表"写进报告;这正好能回答现场最常问的"这次到底动了什么"。P3(不阻塞合并)
[P3-1]
maintenance_counts把 PASS 同时计入passed和unconfirmedicdb_maintenance.py:27-29。unconfirmed的判据是status not in ('CHECKED','SKIPPED','CANCELLED') and error_category not in (...),PASS 不在这两个排除集里。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 条目带上。_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 缺陷;但"测试套件不并行安全"本身仍是遗留问题。审查 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)。逐条复核
UPLOAD_FAILEDrecheck_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 补"历史会话已释放;历史工程数据的恢复状态需另行核对"checkpoint=False跳过 blocker 门禁verify_runner.py:571-579在取LibraryLock之前先recheck_previous_release;证明不成立返回FAIL/LIBRARY_IN_USE,LibraryBusy之外的异常落到LIBRARY_ACCESS_FAILED;proof 写进VerifyResult与证据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这个字段写得很对passed/unconfirmedicdb_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']。边界
mkdir(mode=0o700)在本沙箱会得到进程自己都打不开的目录),本轮没有复跑测试;以上均为代码级复核,未在真实 Mentor/共享库上执行。结论:修复后合并(1×P3,无 P1/P2)。
完整审查 #10(head
807aa26,93 文件 +14,575/−435):可合并(0 P1 + 0 P2 + 3 P3)覆盖与方式
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:沿用前几轮逐行结论,本轮复核了它们的入口与失败分支。except Exception、2 处taskkill、2 处shutil.rmtree、19 处subprocess、11 处while True,逐条看过命中点;未发现"吞掉安全事实"或"无界等待"的实例。这片的可靠之处
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。边界
build_exclusive_library_manifest的独占句柄语义在网络盘上的行为未验证。复核 #344 的修复(head
e8a1714d):3 个 P3 已修,1 个 P3 我接受你的反驳——可以合并新增两个提交:
b7baa24b(跨 CBB 检查点在释放证据里具名)、e8a1714d(状态新鲜度口径、变更清单规则、copy 读取次数),对应评论 344 的四条 P3。逐条
batch_status的 resume 未接线scan()默认改resume=False,authoritative_status_map注明生产永远新查、缓存行不得授权生产动作;新增test_default_scan_refreshes_cached_ready_after_payload_change,用"改 payload 不改 LMC"证明指纹不能当新鲜度证明comparison_rules(scope)(scoped_manifest.py),把rule_version、excluded_categories/suffixes、运行时位置、文件名/前缀、协调检查点全部写进library-changes.json,并复用分类器同一批常量;UI 文案改为"已比对的工程文件…范围仅限报告列出的工程文件"pcb_bridge.execution_outcome未接线且默认乐观copy_verified二次源哈希验证
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 阻断)。