codex/issue29-blocking-cleanup
main
批量执行曾在 UID 异常、工程末提交、保存后数据库占用及后台桌面残留处停止,任务完成状态也可能滞后。本 PR 以工程为单位暂存并保存,使用保存后的 Mentor 原生导出核验目标,再提交回执;确认自有写进程退出后允许独立工程继续。
关联 #20、#29。本 PR 不自动关闭工单,保留故障机长期验收项。包含当前分支相对 main 的 4 个提交,不包含独立校验工作台。
历史 icdb.dat PermissionError 的具体持锁者无法从旧日志还原;本次验证的是锁冲突交接处理。真实故障注入由独立 fixture 持锁,驱动在产品正常退出 Mentor 后才释放它,不能声称产品可以关闭任意外部句柄。持续外部锁、权限不足、文件变化或强杀后的结果继续待核验。
icdb.dat
原生 ASCII 不证明 Value 属性空值与缺失的差异,也不验证 CAD 图形位置、字体和颜色。源文件尚未绑定时退出程序,保存 marker 和原尝试保留,但不会被自动提升为成功证明。
原始测试证据和工程副本保留在 Windows 验证机的 D:/CodexValidation/;报告区分模拟、原生探针和真实 Mentor 验收。本 PR 未更新旧候选安装包或发布版本。
D:/CodexValidation/
b19afc6
e63a82b
结论:需修改后复审。 未发现 P0;5 项 P1、15 项 P2。P1 集中在“失败后无法自动恢复”,与“非阻塞”目标直接冲突。
tests/v1_1 tests/ui
LongPathsEnabled=0
1. batch_runtime.py:212-217 桌面工厂异常 → generation=0 非法记录 → 资源闸门永久锁死
batch_runtime.py:212-217
generation=0
工厂调用被移到首次落盘之前。工厂抛错(DesktopSlot._context() 的“无法确认登录会话”、LOCALAPPDATA 缺失、slot 目录 mkdir 失败)或 _save 写盘失败时,内存 generation=1、磁盘仍是 generation=0/desktop=None;close() 写出 state=released 但 generation=0 的记录,_valid_record 拒绝 → pending_resources 生成无 session_id 的 blocked 条目 → cleanup_pending_resources 直接 continue,force_* 也无入口。此后所有新批次在 __enter__ 被拒,只能手删 session.json。已用假工厂复现。
DesktopSlot._context()
LOCALAPPDATA
_save
generation=1
generation=0/desktop=None
close()
state=released
_valid_record
pending_resources
cleanup_pending_resources
continue
force_*
__enter__
session.json
建议:generation += 1 后先落盘 starting(占位名),工厂成功后再用真实名重写;异常时回滚 generation 并写合法 released 记录。
generation += 1
starting
released
2. quick_run.py:902-934 prewrite 暂停覆盖已提交终态
quick_run.py:902-934
after 在 _commit_staged_project(930,内部 append_only 追加 saved_ok 行)之前读取;933 行 _write_status_details(..., (*after, 暂停行)) 整文件替换,把刚追加的终态行删掉。saved_netlist 协议下,同工程已有 pending_save 前缀且用户在当前项派发前停止即可触发。结果:status.tsv 仍是 pending_save、journal 已是 verified,has_interrupted_quick_run 为真 → 串行队列按“待核验”阻塞,reconcile_terminal_receipts 不会自愈。
after
_commit_staged_project
append_only
saved_ok
_write_status_details(..., (*after, 暂停行))
pending_save
status.tsv
has_interrupted_quick_run
reconcile_terminal_receipts
建议:933 行改为重新读取当前 status 后追加(或直接用 _append_status_details)。
_append_status_details
3. batch.py:246-249 组件失败直关 worker,绕过 ProjectSessionScope.on_commit
batch.py:246-249
ProjectSessionScope.on_commit
直接 project_session.worker.close() 会让 VBS 保存并写出 project-commit-*.tsv(pending_save),但跳过 on_commit(quick_run.py:1108-1115 注册)→ SQL 永不提交。下一轮 journal.bind 发现“marker 存在但未提交” → quick_run_uncertain,整批停下等待人工恢复。触发条件:同工程前序位号已 pending_save,当前组件返回 batch_failed/batch_skipped。
project_session.worker.close()
project-commit-*.tsv
on_commit
quick_run.py:1108-1115
journal.bind
quick_run_uncertain
batch_failed/batch_skipped
建议:改调 project_session.close(),再丢弃 worker 引用。
project_session.close()
4. project_isolation.py:104-110、service.py:1191-1194 “从未派发”查询未按轮次过滤
project_isolation.py:104-110
service.py:1191-1194
execution_operations 一轮一行但旧行永不删除,查询也不带 round_id;任何历史轮次执行过的任务 dispatched 恒真 → absent_attempt 恒假 → recover_dependency 永远拒绝,BLOCKED 任务只能改库解除。
execution_operations
round_id
dispatched
absent_attempt
recover_dependency
建议:查询 join 当前 execution_rounds.round_id。
execution_rounds.round_id
5. saved_netlist_verification.py:248-255 no_match 缺 scope 覆盖证明,空候选即 verified
saved_netlist_verification.py:248-255
no_match
该分支只检查“残留旧料号”,候选为空时 any() 为 False → 直接以空回读提交 verified。导出缺页、缺该位号,或 source_schematic/source_page 与冻结 scope 不一致导致候选全被过滤时,即为静默假成功。纯 no_match 工程没有 pending_save 项会先失败,因此不会有人兜底。
any()
verified
source_schematic/source_page
建议:no_match 也绑定冻结 scope——targets 模式要求每个 selector 的 refdes 在导出 scope 内存在并核对料号;all 模式要求该 schematic/sheet 至少存在组件;缺失即保持 pending。
batch_runtime.py:1085-1086
isolated_desktop.py:797
desktop_confirmation
None
.get()
quick_run.py:372-385
TaskCenterError
ValueError/OSError
quick_run.py:413/527-528
execution_journal.py:668-731
operation_attempts
bind_source=True
desktop_slot.py:70-75
unlock()
ReleaseMutex/Close
_held
batch_resources.py:81-88
:291-293
session_id
saved_netlist_verification.py:67
except (…):pass
saved_source.py:113-149
publish('bound')/record_operation
OSError
netlist_verification.py:258-263
_reference_plan
saved_netlist_verification.py:190-193
readbacks_intact
readback_files
(完整 15 项见审查报告。)
PROC_THREAD_ATTRIBUTE_JOB_LIST
IsProcessInJob
leased
saved_netlist.status=='verified'
journal.bind/claim
release_mentor
无 Mentor DxDesigner,20 次桌面循环、20 个真实文件锁、真实 BOM 双目标只能做证据审计;QuickPartReplace.vbs 仅逐段审了保存/关闭/导出/marker 路径。
QuickPartReplace.vbs
5 项 P1 补回归测试 + 默认全量通过(允许本机 8 项长路径环境失败),即可转为“有条件通过”。
4a438e02
结论:通过。 上一轮 5 项 P1 全部修复,P2 大部分修复;未发现新增缺陷。默认全量无新增失败。
generation>0
test_desktop_startup_before_acquisition_does_not_block_later_batches
test_unlaunched_worker_retry_leaves_no_ownership_record
project_commit_unverified
test_saved_prewrite_pause_preserves_verified_prefix_and_retired_claim
recover_quick_run
batch.py
complete_project_session
test_component_failure_closes_retained_prefix_with_commit_callback
project_isolation.py
service.py
execution_rounds
_verify_no_match
source_sheets
test_saved_netlist_verification
batch_runtime.py
cell_catalog.py
(… or {})
require_recorded=True
isolated_desktop.release_desktop
desktop_lease_pending
isolation_proof
desktop_slot.unlock
finally
acquire
release
load_saved_export
except: pass
after_task
unavailable
saved_source.bind_sources
source_uid
desktop_factory is PrivateDesktop
isolated-generation-*.json
project_fingerprint
status_size
建议合并;剩余 5 项 P2 可在合并后统一治理。实机验收项(20 次桌面循环、20 个真实文件锁、真实 BOM 双目标)仍建议在故障机按原清单复验。
No dependencies set.
The note is not visible to the blocked user.
批量执行曾在 UID 异常、工程末提交、保存后数据库占用及后台桌面残留处停止,任务完成状态也可能滞后。本 PR 以工程为单位暂存并保存,使用保存后的 Mentor 原生导出核验目标,再提交回执;确认自有写进程退出后允许独立工程继续。
关联 #20、#29。本 PR 不自动关闭工单,保留故障机长期验收项。包含当前分支相对 main 的 4 个提交,不包含独立校验工作台。
开发清单
验收清单
待验收与限制
历史
icdb.datPermissionError 的具体持锁者无法从旧日志还原;本次验证的是锁冲突交接处理。真实故障注入由独立 fixture 持锁,驱动在产品正常退出 Mentor 后才释放它,不能声称产品可以关闭任意外部句柄。持续外部锁、权限不足、文件变化或强杀后的结果继续待核验。原生 ASCII 不证明 Value 属性空值与缺失的差异,也不验证 CAD 图形位置、字体和颜色。源文件尚未绑定时退出程序,保存 marker 和原尝试保留,但不会被自动提升为成功证明。
报告
原始测试证据和工程副本保留在 Windows 验证机的
D:/CodexValidation/;报告区分模拟、原生探针和真实 Mentor 验收。本 PR 未更新旧候选安装包或发布版本。代码审查结果(
b19afc6→e63a82b,2026-11-19)结论:需修改后复审。 未发现 P0;5 项 P1、15 项 P2。P1 集中在“失败后无法自动恢复”,与“非阻塞”目标直接冲突。
测试复跑(Windows 10 / Python 3.12 / pytest 8.4,本机无 DxDesigner)
tests/v1_1 tests/ui:2464 passed / 8 failed(合计 2472,与声明一致)LongPathsEnabled=0的深路径用例,base 工作树同样失败,非本 PR 回归必须修复(P1)
1.
batch_runtime.py:212-217桌面工厂异常 →generation=0非法记录 → 资源闸门永久锁死工厂调用被移到首次落盘之前。工厂抛错(
DesktopSlot._context()的“无法确认登录会话”、LOCALAPPDATA缺失、slot 目录 mkdir 失败)或_save写盘失败时,内存generation=1、磁盘仍是generation=0/desktop=None;close()写出state=released但generation=0的记录,_valid_record拒绝 →pending_resources生成无 session_id 的 blocked 条目 →cleanup_pending_resources直接continue,force_*也无入口。此后所有新批次在__enter__被拒,只能手删session.json。已用假工厂复现。建议:
generation += 1后先落盘starting(占位名),工厂成功后再用真实名重写;异常时回滚 generation 并写合法released记录。2.
quick_run.py:902-934prewrite 暂停覆盖已提交终态after在_commit_staged_project(930,内部append_only追加saved_ok行)之前读取;933 行_write_status_details(..., (*after, 暂停行))整文件替换,把刚追加的终态行删掉。saved_netlist 协议下,同工程已有pending_save前缀且用户在当前项派发前停止即可触发。结果:status.tsv仍是pending_save、journal 已是 verified,has_interrupted_quick_run为真 → 串行队列按“待核验”阻塞,reconcile_terminal_receipts不会自愈。建议:933 行改为重新读取当前 status 后追加(或直接用
_append_status_details)。3.
batch.py:246-249组件失败直关 worker,绕过ProjectSessionScope.on_commit直接
project_session.worker.close()会让 VBS 保存并写出project-commit-*.tsv(pending_save),但跳过on_commit(quick_run.py:1108-1115注册)→ SQL 永不提交。下一轮journal.bind发现“marker 存在但未提交” →quick_run_uncertain,整批停下等待人工恢复。触发条件:同工程前序位号已pending_save,当前组件返回batch_failed/batch_skipped。建议:改调
project_session.close(),再丢弃 worker 引用。4.
project_isolation.py:104-110、service.py:1191-1194“从未派发”查询未按轮次过滤execution_operations一轮一行但旧行永不删除,查询也不带round_id;任何历史轮次执行过的任务dispatched恒真 →absent_attempt恒假 →recover_dependency永远拒绝,BLOCKED 任务只能改库解除。建议:查询 join 当前
execution_rounds.round_id。5.
saved_netlist_verification.py:248-255no_match缺 scope 覆盖证明,空候选即 verified该分支只检查“残留旧料号”,候选为空时
any()为 False → 直接以空回读提交verified。导出缺页、缺该位号,或source_schematic/source_page与冻结 scope 不一致导致候选全被过滤时,即为静默假成功。纯no_match工程没有pending_save项会先失败,因此不会有人兜底。建议:
no_match也绑定冻结 scope——targets 模式要求每个 selector 的 refdes 在导出 scope 内存在并核对料号;all 模式要求该 schematic/sheet 至少存在组件;缺失即保持 pending。建议同批处理(P2 摘选)
batch_runtime.py:1085-1086+isolated_desktop.py:797:desktop_confirmation为None时.get()抛 AttributeError,覆盖原始归还错误并让 isolated 通道失效。quick_run.py:372-385:reconcile_terminal_receipts只捕获TaskCenterError,核验抛出的裸ValueError/OSError不写 uncertain.flag。quick_run.py:413/527-528、execution_journal.py:668-731:operation_attempts仅在bind_source=True写入,reconcile/prewrite 提交的 proof 缺该字段 → 合法已核验提交被永久拒绝恢复。desktop_slot.py:70-75:unlock()在ReleaseMutex/Close出错时提前返回,_held残留、句柄泄漏,本登录会话内无法再领桌面。batch_resources.py:81-88、:291-293:损坏/不可解析记录生成无session_id的 blocked 条目,cleanup 跳过、force 不覆盖 → 永久阻断。saved_netlist_verification.py:67:except (…):pass把完整性失败静默降级为“无已核验导出”,可能静默换证据源重导出。saved_source.py:113-149:publish('bound')/record_operation位于捕获OSError的 try 内,诊断写失败被误判为源读取失败,32/33 时还会多退一次 Mentor。netlist_verification.py:258-263:_reference_plan多单元循环覆盖,所有 unit 拿到最后一个 identity 的 preserved Value → 正确替换被判 different。saved_netlist_verification.py:190-193:readbacks_intact对缺失/空readback_files真空为真(fail-open)。(完整 15 项见审查报告。)
已确认成立
PROC_THREAD_ATTRIBUTE_JOB_LIST原子加入 +IsProcessInJob复核;Job 未空时保留句柄;重启恢复只观测不终止。leased校验 owner 存活;receipt 绑定 lease_id/scope/state/sha256;同名桌面缺记录明确拒绝收养。saved_ok强制saved_netlist.status=='verified';全树指纹、命令哈希、saved_sources 哈希与 files 哈希多重绑定,导出后再次校验。pending_save迁移、journal.bind/claim派发前拒绝未核验项;暂停/强杀保持待核验。release_mentor每次 bind 至多一次;Restart Manager 只读。未覆盖
无 Mentor DxDesigner,20 次桌面循环、20 个真实文件锁、真实 BOM 双目标只能做证据审计;
QuickPartReplace.vbs仅逐段审了保存/关闭/导出/marker 路径。修复后的复审门槛
5 项 P1 补回归测试 + 默认全量通过(允许本机 8 项长路径环境失败),即可转为“有条件通过”。
增量复审(
e63a82b→4a438e02,2026-11-19)结论:通过。 上一轮 5 项 P1 全部修复,P2 大部分修复;未发现新增缺陷。默认全量无新增失败。
P1 修复确认
generation=0非法记录、资源闸门永久锁死_save只在generation>0落盘;先写starting(含新 generation)再赋值/进入工厂;工厂或首次写盘失败均不产生所有权记录test_desktop_startup_before_acquisition_does_not_block_later_batches(factory / first_write 两组)与test_unlaunched_worker_retry_leaves_no_ownership_record_append_status_details;顺序调整为“先暂停声明、后提交前缀”;提交期间以project_commit_unverified保护,核验成功即清除test_saved_prewrite_pause_preserves_verified_prefix_and_retired_claim(含 publication / marker_locked 故障注入与recover_quick_run)on_commitbatch.py在组件失败分支先complete_project_session(触发提交回调)再继续test_component_failure_closes_retained_prefix_with_commit_callback,断言 SQL 状态与进度project_isolation.py/service.py改为 JOINexecution_rounds(task_id 主键、round_id 随轮次更新)no_match缺 scope 覆盖证明_verify_no_match:targets 模式要求每个 selector 的位号可定位且料号等于目标;all 模式要求 sheet 存在于source_sheets;readbacks_intact强制覆盖 pending_save 的 snapshot/report/writer 三件套test_saved_netlist_verification新增 75 行P2 修复确认
desktop_confirmation为None的 AttributeError:batch_runtime.py两处 +cell_catalog.py改为(… or {})。operation_attempts统一在_commit_staged_project写入;恢复时require_recorded=True,不再“缺字段即永久拒绝”。isolated_desktop.release_desktop先落归还 receipt 再解锁,并记录desktop_lease_pending;isolation_proof对未归还租约直接拒绝隔离。desktop_slot.unlock改为finally清理_held/句柄;acquire/release先交换 handle 再解锁。load_saved_export不再静默except: pass:完整性失败抛错并由after_task置unavailable。saved_source.bind_sources把诊断写入移出 32/33 等待路径,状态文件共享冲突不再误回收 Mentor(新增专项测试)。_reference_plan多单元按source_uid精确绑定,冲突显式报错。测试复跑
tests/v1_1 tests/ui:2503 passed / 8 failed(旧头 2464/8;8 项为同一批LongPathsEnabled=0环境失败,无新增失败)仍未处理(P2,建议登记跟进,不阻塞合并)
desktop_factory is PrivateDesktop身份判断:包装/子类工厂会静默降级为非 managed 桌面。session.json仍无 force/quarantine 入口,只能手删。isolated-generation-*.json每次隔离复制、无归档,长期累积。project_fingerprint吞 OSError:非 32/33 的权限/锁被报成“源文件仍在变化”。_append_status_details仍是非原子尾部追加(读取侧已有status_size认证缓解)。结论
建议合并;剩余 5 项 P2 可在合并后统一治理。实机验收项(20 次桌面循环、20 个真实文件锁、真实 BOM 双目标)仍建议在故障机按原清单复验。