位置:native_helper.py:576–582。if actual != identity 被移出了 for uid, identity in untouched.items()。在非精确目标范围的替换中,有多个未选器件时只检查最后一个;如果整页器件都被替换,untouched={},则在原生替换已经执行之后抛出 UnboundLocalError,无法正常进入后续恢复和保存。最小复现:未选 R2 的 Value 从 V0 变为 CHANGED、最后一个未选 R3 保持不变时,该函数错误地返回成功;仅有一个目标且没有未选器件时直接报错。这两例在 main 上通过,在 PR head 上失败。请修复缩进,并覆盖零个、多个未选器件的情况。
复现结束后显式 force 才能释放 PR head 的等待线程。这里需要保留禁止重放及必要的业务恢复证据,但“不能重放历史操作”不能直接等同于“当前 CAD 仍可能在写入”。建议以当前 attempt/generation 的可信关闭 checkpoint 和在途状态决定是否保留活进程;已有关闭证明时正常清理资源并传播原错误,不能通过清除历史 mutation 标记来放开重放。请补充“成功工程之后、下一个工作启动前发生异常”的 StopControl 回归。
本次验证:
回读、无 UID 库存/目标、VBS 字段防护、收尾结果及 Value 恢复专项:178 passed。
批次运行时、监督证据、原生快照及停止相关可运行子集:90 passed / 12 deselected,筛选条件为 not real and not readonly_native_wait and not explicit_force_stops and not supervisor_only_holds。
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
本 PR 修复受监督批处理、字段采集和无 UID 器件处理的可靠性问题。
最新复审修复(提交 e5e628d)
已修复的核心问题
最新验证
现场边界
Windows 10、真实 DxDesigner 7.9.5 无 UID 工程替换/保存/重开回读、中央库/许可证/COM 注册、网络共享和企业策略仍需现场验收。模拟 COM 和冻结 smoke 不替代真实 CAD 验收。
审查模型:GPT-6 Astra(high)
审查范围:
main(b939101)→ 本 PR 当前提交131b6dbbb31b654bc9e8e28fd424988323ab6e4f。结论:发现 2 项 P1、1 项 P2,建议修复后再合并。
[P1] 将未选器件的逐项比较恢复到循环内。
位置:native_helper.py:576–582。
if actual != identity被移出了for uid, identity in untouched.items()。在非精确目标范围的替换中,有多个未选器件时只检查最后一个;如果整页器件都被替换,untouched={},则在原生替换已经执行之后抛出UnboundLocalError,无法正常进入后续恢复和保存。最小复现:未选 R2 的 Value 从 V0 变为 CHANGED、最后一个未选 R3 保持不变时,该函数错误地返回成功;仅有一个目标且没有未选器件时直接报错。这两例在main上通过,在 PR head 上失败。请修复缩进,并覆盖零个、多个未选器件的情况。[P1] 不要将显示属性读取失败的默认值作为可写回的原始快照。
位置:QuickPartReplace.vbs:1724–1727,以及 1666–1673。新增回退将读取失败的可见性、字体等字段及坐标写成
0;这些值随后被 QPRestoreDisplay:2665–2677 当作真实快照无条件写回。通过生产 VBS 函数和 COM 形状替身已复现:原 Visible=1,采集时 getter 暂时失败,恢复时属性被写成 Visible=0。后续回读比较的仍是伪造的 0,不能证明保留了原始显示状态;坐标也有相同问题。请为不可读字段保留明确的有效性状态,禁止把默认值写回;若无法证明需要保留的状态,应在修改前阻断。[P2] 将无 UID 的 fallback 身份贯穿快照、替换结果、引脚和恢复流程。
位置:QuickPartReplace.vbs:1582–1587、native_helper.py:529–563。库存虽然允许
@REFDES|R1,快照仍将原始空 UID 传入QPComponentPins,其 pin owner 检查直接报pin owner UID is empty。Python 的replacement_matches也仍返回str(candidate.UID):一个无 UID 目标返回[''],两个返回Duplicate replacement association;引脚晋级却按 fallback key 选择器件。这三例均已复现。另外 VBS 第 1321 行仍用原始 UID 判断是否未选,第 2042 行恢复预检仍将原始 UID 与 fallback 快照直接比较。请统一所有本地关联键,同时保留引脚/连接的严格证明,补一条从库存到保存重开的无 UID 流程回归,不能只验证库存入口。验证记录:
test_native_readback_efficiency.py、test_missing_uid_inventory.py、test_target_execution.py、test_accuracy_vbs_guards.py,88 passed。cscript.exe执行提取的生产函数和 COM 形状替身。审查结论
建议先修复再合并(Request changes)。
这次改动的方向是对的:普通停止与强制结束分离、先持久化不确定性证据再终止自有 Job、强杀后保留业务结果并要求核验、补充进程/生命周期证据和 UI 后台资源快照,这些边界处理比 Beta 3 清晰很多,新增回归测试也覆盖了大部分生命周期路径。
但审查发现 4 组确定性的功能缺陷:两组在 Python 原生回读路径,一组在 VBS 的无 UID 路径,一组在 VBS 的显示属性恢复路径。它们会直接导致“只校验了部分非目标器件”“无 UID 器件替换无法完成”以及
UnboundLocalError,与 PR 描述的核心目标冲突,建议修复并补测试后再合并。审查基线:
131b6dbbb3(PR head)←b939101565(main),75 files,+4157/−197。阻断问题
P0-1
native_helper.py:574-582:非目标器件回读的if被移出循环当前代码:
if actual != identity与for同级(8 空格),已经不在循环体内。后果:untouched为空时直接UnboundLocalError,因为actual/identity从未赋值。这是“目标覆盖整页、没有非目标器件”的常见场景。len(metadata) != 10的兼容路径;新格式快照走verify_unselected_snapshot不受影响,但旧格式快照仍会命中。本地已用最小脚本复现:构造 3 个器件、改坏中间的非目标器件,函数返回
['u1']而不是抛错;传空untouched时抛UnboundLocalError。修复:把
if缩进回for内;新增“2 个以上非目标器件,改坏第一个”和“无非目标器件”的回归用例。P0-2
native_helper.py:561:replacement_matches()把 fallback 身份丢掉了本 PR 已经用
_component_uid()把无 UID 器件映射为@REFDES|<位号>,但这里仍返回原始UID。无 UID 器件的原始 UID 是空串,后果:report['replaced_uids'] = [''],随后promote_pin_numbers()用_component_uid(pin.Component)(@REFDES|R1)去匹配{''},匹配不到任何引脚,报Replacement produced no pins。'',len(set(matches)) != len(records),报Duplicate replacement association。本地验证:
_component_uid()返回@REFDES|R1,replacement_matches()返回['']。修复:改为
matches.append(_component_uid(candidate)),并检查所有返回/比较 UID 的位置是否都需要 fallback 身份;补一条无 UID 目标的replacement_matches+promote_pin_numbers回归。P0-3
QuickPartReplace.vbs:无 UID 路径只改了一半,多个位置仍用原始 UIDPR 的描述是“无 UID 器件使用
@REFDES|<位号>本地身份”“选择、快照、回读和恢复统一使用 fallback 键”,但 VBS 里至少这些位置仍使用CStr(Comp.UID)/CStr(Candidate.UID):QPComponentPins(:484)仍对空 UID 直接Err.Raise ... "pin owner UID is empty";QPSnapshotComponent(:1586)、QPUntouchedFullState(:1440)、QPConnectionSignature(:2780-2782)都用原始 UID 调它。只要当前页存在“有引脚且 UID 为空”的器件,构建引脚索引就会先抛 862,快照/捕获阶段即失败。QPCaptureAndSelect(:1321)用If Not MatchedUids.Exists(CStr(Comp.UID))判断未匹配器件,而MatchedUids的键已经是QPComponentIdentityKey()。无 UID 的目标会被当成“未匹配”,额外写入一条U未目标基线;之后QPVerifyUntouched会发现目标发生了替换,报unselected component changed(或组件计数不一致)。保存/重开与恢复路径仍直接比较原始 UID:
QPFinishBatchItem重开回读:1020:1764、:1923QPRestorePreflight:2042这些比较在无 UID 场景下是
''vs'@REFDES|R1',会在保存后回读或恢复前报saved component UID differs/replacement component UID or Refdes differs from snapshot。QPBuildComponentIndex(:417)仍以原始 UID 建索引,QPFindUniqueByOldLocation拿到代理后再做原始 UID 比较也会失败。因此当前无 UID 路径无法端到端完成替换:现场验证之前,静态代码已经能确定会在捕获或回读阶段失败。建议:
QPComponentIdentityKey),在引脚索引、匹配集合、恢复/回读比较、连接签名中全部使用;QPComponentPins改为按 fallback 身份建索引(或对无 UID 器件使用 Refdes/坐标回退);P0-4
QuickPartReplace.vbs:1648-1727+:2665-2677:显示属性读取失败的默认值会被恢复流程写回QPOptionalAttributeField在Color/Font/Size/Orientation/Visible读取失败时返回"0";QPSnapshotAttribute把它当作真实快照写入A记录。QPRestoreDisplay随后无条件CLng(Record(...))写回,QPVerifyDisplay又拿同一份"0"做比较,因此回读会“通过”。后果:快照期间一次瞬时 COM 读取失败,恢复后属性的颜色/字体/大小/方向/可见性会被改成 0,且回读无法发现。位置字段的失败分支目前因 VBScript
And非短路、Point Is Nothing在错误状态下被跳过而留下空 x/y;QPRestoreDisplay会因空字段报incomplete attribute style snapshot(比写回 0 安全,但错误信息不准确,且没有 location WARN)。修复:为每个可选显示字段保留“有效/缺失”标记,缺失时不要写回;恢复前对缺失的样式证据直接阻断并给出明确原因;或只恢复已成功读取的字段。补一条 VBS 测试:第一次 getter 失败、恢复前恢复成功,断言不会写 0。
已用生产函数 + cscript 替身复现:快照中
color为0;调用QPRestoreDisplay时打印write color=0。中等风险 / 建议修复
batch_supervisor.py:247-252:读取session.json只捕获FileNotFoundError。若文件是损坏 JSON 或权限错误,会在journal已标记finished后把原始JSONDecodeError/PermissionError抛给上层,而不是进入application_shutdown_error。建议捕获(OSError, ValueError, TypeError)并把“收尾状态未知”作为诊断错误处理;同时防御cad_shutdown/cleanup_errors不是预期类型的情况。worker_monitor.py:131-135:_publish_progress现在吞掉所有OSError。磁盘满、目录权限或锁冲突时,awaiting_reconciliation状态不会写到worker-progress.json,非监督路径的 UI 会一直显示旧阶段,用户看不到“需要强制结束/核验”的提示,诊断也丢失。建议至少写 WARN 日志或记录一个计数;如果只想忽略锁冲突,可恢复为仅忽略PermissionError/winerror 5/32/33。batch_supervisor.py:96-135:_retain_supervisor_after_control_error是无上限等待。它对try块内任何异常生效,包括on_progress/on_phase这类纯 UI 回调异常;如果监督进程不退出且用户不点强制结束,调用线程会永久停在这里。建议区分“控制通道异常”和“业务/UI 回调异常”,至少在等待期间持续更新心跳/日志,并向 UI 暴露等待状态。batch_supervisor.py:64-69:_force_owned_supervisor在force_state in {'termination_requested','confirmed'}时直接返回成功,不再确认进程是否真的退出。若上一次终止只写入了状态但进程仍存活,重试强制会被当成已成功。建议仍检查process.poll(),存活时重新终止或返回失败。stop_control.py:28-39:protect_interruption对已存在的 marker 只做fsync。如果上次open('x')成功但write前崩溃,会留下 0 字节文件;本次只同步空文件,并不能证明“原因已写入”。如果恢复逻辑只检查存在性则影响有限,但建议用临时文件 + 原子替换写入原因,或至少校验非空。isolated_cad.py:271-284:只有在cleanup_errors非空且 CAD 仍存活时才进入wait_for_resolution。如果self.cad存在但binding is None(启动阶段身份校验失败后保留 CAD 的情况),orderly_shutdown会保持False、cleanup_errors为空,最终可能被_finish_response判成application_shutdown_failed,掩盖真正的启动失败原因。建议为“从未完成绑定的 CAD”单独记录状态,或在该场景直接标记 uncertain 并保留原因。batch_runtime.py:324-329:wait_for_resolution在 batch worker 内是无上限等待;监督模式下 GUI 的强制结束只会终止 supervisor 进程,worker 的force_event永远不会被设置。当前依赖 Job 终止来结束 worker,这是可行的,但建议在文档和测试中明确写出这个依赖,并确认 supervisor 被外部终止时 worker/CAD 一定在同一个 Job 内。@ANON与 Python 不一致:VBS 的QPComponentIdentityKey对“UID 和 Refdes 都为空”的器件返回@ANON|x|y,而 Python 的_component_uid直接抛错。前者会让非目标匿名器件进入库存,后者会让整页components_on_sheet()失败。建议统一策略:要么两边都阻断,要么两边都使用同一套坐标 fallback,并明确坐标相同/重复时的处理。QP_FallbackIdentityUsed是进程级全局标志:一旦某个任务遇到无 UID 器件,后续所有任务都会禁用 native snapshot 读取,直到进程重启。功能上安全,但长期会话会持续退化到慢速 CAD 采集;建议按 job/session 重置,或在日志中明确提示。启动失败也标记 uncertain:
run_supervised在process is None(create_process直接失败)时仍走_mark_interrupted,给写任务打business_uncertain和uncertain.flag。此时业务进程尚未启动,按现有测试这是有意为之,但 UI 会表现为“结果待核验”,对用户来说偏重。建议在错误文案/恢复入口上区分“启动失败,无写入发生”。测试与文档
测试缺口:新增测试覆盖了 stop/force、supervisor evidence、resource status、VBS 库存身份,但没有覆盖:
verify_replacement_readback多个非目标器件、空untouched(P0-1);replacement_matches返回 fallback 身份、promote_pin_numbers无 UID 匹配(P0-2);这三类正好是本次改动的核心场景,建议补齐后再合并。
验证数字不一致:PR 描述写“发布前回归 986 passed”,
docs/reviews/2026-10-30-project-optimization-review.md写 960,docs/releases/v1.1.4-beta.4.md写 1147/923,docs/releases/v1.1.4-beta.4-build.md写 923,docs/testing/evidence/2026-10-30-environment-compatibility.json写 957。建议在每个数字旁注明具体的 pytest 命令、目录范围和运行环境,避免把“实现阶段扩展回归”“发布门禁”“构建门禁”混在一起。文档日期:
docs/releases/v1.1.4-beta.4.md开头是“2026-10-26”,与 PR 创建时间 2026-10-30 不一致,建议核对。证据文件包含本机绝对路径:
docs/testing/evidence/2026-10-30-environment-compatibility.json里有F:\Sync Tool Skyworth\...等路径。若仓库仅内部使用可接受;若会对外分发,建议脱敏。git diff --check只有docs/testing/2026-10-30-phase1-lifecycle-optimization.md:3的尾随空格(Markdown 换行语法),无需处理。本地验证
python -m pytest -q tests/v1_1:939 passed,8 failed。8 个失败均为本机未启用 Win32 长路径导致 pytest 临时目录mkdir失败(test_batch_supervisor、test_isolated_cad、test_project_long_paths、test_execution_metrics),与本次改动无关;PR 描述的 986 passed 可能来自启用了长路径的环境,建议补充运行环境说明。test_native_readback_efficiency、test_missing_uid_inventory、test_accuracy_vbs_guards、test_supervisor_evidence、test_supervisor_result、test_resource_status):96 passed。python -m compileall -q src:通过。untouched的UnboundLocalError)、P0-2(replacement_matches返回[''])和 P0-4(QPRestoreDisplay将读取失败的显示字段写成 0)。审查模型:
new-provider-2/skyworth-deepseek-v4.1-flash(ZCode 自动代码审查)审查时间:2026-10-30
复审模型:GPT-6 Astra(high)
复审提交:
f0a0131aac7f2c62307ce648cc387849ca05e201;已重新读取评论 88/89,并检查相对131b6db的修复及相关调用链。上轮评论 88 的 3 项问题已在本次审查范围内确认修复,可以关闭;另发现 1 项 P2,建议修复后再合并。
[P2] 已完成关闭检查的历史写入,不应使后续普通异常进入无限等待强制结束。
位置:batch_runtime.py:123–126、324–329。
__exit__对任何异常都会把全部历史 attempt 交给_retain_uncertain,后者用can_retry_attempt()判断是否进入wait_for_resolution()。但成功执行过替换的 attempt 仍然是mutation_possible,其“禁止重放”状态不会因为已经关闭并取得 checkpoint 而清除。因此,前一个工程已结束,下一工程备份失败,或者完成业务后business-result.json发布失败时,也会被当作仍有未完成的 CAD 写入:产生新的uncertain.flag,保留 CAD/桌面,普通停止无法退出,只能要求用户明确强制结束。我用真实
BatchCadRuntime.run_worker、attempt/checkpoint 文件和StopControl.wait_for_resolution,配合进程/CAD 替身复现了第一种情形:复现结束后显式 force 才能释放 PR head 的等待线程。这里需要保留禁止重放及必要的业务恢复证据,但“不能重放历史操作”不能直接等同于“当前 CAD 仍可能在写入”。建议以当前 attempt/generation 的可信关闭 checkpoint 和在途状态决定是否保留活进程;已有关闭证明时正常清理资源并传播原错误,不能通过清除历史 mutation 标记来放开重放。请补充“成功工程之后、下一个工作启动前发生异常”的 StopControl 回归。
本次验证:
not real and not readonly_native_wait and not explicit_force_stops and not supervisor_only_holds。复审结论(
f0a0131)上一轮 4 组阻断项均已修复,并通过复现/回归验证。 但本轮新发现 1 项 P1:历史 attempt 会让已完成工程后的普通异常进入强制结束等待,建议修复后再合并。其余为无 UID 大工程下的性能/日志和少量诊断/测试补充,属于非阻断建议。
复审基线:
f0a0131aac(PR head)←131b6dbbb3(上轮审查提交);增量 15 个文件,+312/−64。上轮阻断项复核
native_helper.py非目标器件比较被移出循环native_helper.py:576-582的if已回到循环内;新增零个/两个未选器件、首个未选器件被修改的回归。我用上轮最小脚本复测:改坏中间未选器件现在抛An unselected component was changed,空untouched正常返回['u1']。replacement_matches返回原始空 UIDnative_helper.py:561改为_component_uid(candidate);复测无 UID 目标返回 `['@REFDESQPComponentIdentityKey;@ANON已移除;QP_FallbackIdentityUsed在每次捕获前重置。新增test_missing_uid_capture_restore_save_and_reopen覆盖捕获→恢复→保存→重开→saved_ok。0写回工程QPOptionalAttributeField失败返回空值;QPSnapshotAttribute:1676-1678在写入前抛 836;QPRestorePreflight:2060-2063在恢复前拒绝缺失字段;6 个字段故障注入用例通过。复测QPSnapshotAttribute失败返回-2147220668(836)且不生成文本;QPRestoreDisplay的Writes=0。另外,上轮提到的
_finish_response损坏session.json/cad_shutdown处理、_publish_progress静默失败、强制重试不确认进程退出、空保护文件未补写原因等四项,也已在本次提交中修复,并有对应回归。剩余问题(含 1 项 P1 与若干非阻断建议)
1. [P2]
QPComponentIdentityKey在引脚热路径上的 COM 读取与 WARN 日志放大QPComponentIdentityKey在:802无条件读取Comp.Refdes,即使 UID 非空;:815在 fallback 时每条调用都写一条 WARN。QPComponentPins:483对每个引脚调用它;QPConnectionSignatureFromPins:2816又对每个引脚再调用一次。QPLog→QPAppendAscii:3298每条都OpenTextFile/Close,大页面上会产生大量文件 I/O 和日志,可能显著拖慢无 UID 工程,也是本次功能的目标场景。57 器件/103 引脚的小工程不会暴露该问题。建议:
Refdes;QPConnectionSignatureFromPins的Pins本身就是按 owner 分桶的,桶内再逐个比较身份是冗余的,可去掉或复用已知 identity。2. [P2]
_publish_progress在等待安全收尾时会持续刷 WARNworker_monitor.py:131-137已改为失败时写 WARN,但await_safe_completion分支每 ~0.1 秒调用一次_publish_progress(:310-315)。如果进度路径持续不可写(磁盘满、权限),会以约 10 条/秒持续写日志,可能进一步放大磁盘压力。建议按路径/错误去重或每 N 秒最多一条。3. [P1]
BatchCadRuntime.__exit__会把已完成工程的历史 attempt 当成仍在途写入batch_runtime.py:123-126在__exit__中把_project_attempts里的全部历史 attempt 交给_retain_uncertain;:324-329只要任一 attempt 的can_retry_attempt()为 False 就进入wait_for_resolution。而成功替换后的 attempt 会永久保持mutation_possible(batch_attempt.py的 state 只有prepared/mutation_possible,没有回到prepared的转换),即使对应工程已经 checkpoint、关闭并验证完成。因此“前一个工程已完成,下一个工程备份失败/启动前异常”这类普通错误也会:
uncertain.flag;我用一个
mutation_possible的历史 attempt 调用BatchCadRuntime.__exit__(RuntimeError, ...)复现:waiting_for_resolution=True、线程挂起、uncertain.flag=True,只有request_force()后才退出。main在同样输入下不会进入这条等待路径。建议:
__exit__只对当前 active evidence / 当前 generation / 当前项目的 attempt 做在途判断;已有可信关闭 checkpoint 的历史项目应直接传播原异常并正常清理资源。不要通过清除历史mutation_possible来放开重放。补一条“成功工程之后、下一工作启动前异常”的 StopControl 回归。4. [P3] VBS 与 Python 的 UID 去空格不一致
QPComponentIdentityKey:810返回CStr(Uid),未Trim;Python_component_uid返回str(value).strip()。如果 CAD 返回带前后空格的 UID,VBS 库存/快照键与 Python 的 selected/records 键会不一致,可能触发Source batch changed since snapshot或 native selected 匹配失败。建议 VBS 返回Trim(CStr(Uid)),并补一条带空格 UID 的契约测试。5. [P3] 无 UID 的超时诊断仍丢 fallback 身份
native_helper.py:823的replacement_timeout仍使用str(c.UID),无 UID 器件在诊断 JSON 中uid为空,虽然按Refdes还能筛到。建议统一用_component_uid(c),保持诊断与执行身份一致。6. [P3] 显示字段失败的错误信息可再具体一些
QPSnapshotAttribute的 location 失败只写field=location,丢弃了GetLocation/Point.X的 COM 错误描述;QPRestorePreflight:2063的错误也没有字段名/UID。现场定位时建议带上字段名和原始描述。7. [P3]
_finish_response的记录写入失败会覆盖收尾错误batch_supervisor.py:263/272在发现损坏/非法session.json后先write_record再抛application_shutdown_error;如果这次写盘也失败(磁盘/权限),会抛出原始OSError,覆盖更有用的收尾错误。建议 best-effort 包装,保留原始application_shutdown_error。8. [P3] 测试补充
QPSnapshotAttribute直接失败,但建议再加一条QPSnapshotComponent端到端失败用例,验证On Error Resume Next循环退出后确实抛出 836(防止未来再次吞错)。verify_replacement_readback用例(records为@REFDES|...),目前新测试覆盖了replacement_matches/引脚晋级,但未覆盖完整回读。QPComponentPins加一个多引脚 fake 的调用计数测试,防止身份函数在热路径上的重复读取回归。9. [P3] PR 描述
PR 描述仍写“发布前回归 986 passed”和旧边界;建议更新为
f0a0131的结果,并链接docs/testing/2026-10-30-pr9-review-fixes.md。修复记录里的 VBS SHA256 我已核对,与当前文件一致。本地验证
tests/v1_1:957 passed,8 failed。8 个失败仍是本机未启用 Win32 长路径导致的 pytest 临时目录mkdir失败(test_batch_supervisor/test_isolated_cad/test_project_long_paths/test_execution_metrics),与本次改动无关。test_quick_value_modes+test_quick_part_replace_contract+test_automatic_replacement_regression112 passed;tests/ui31 passed。tests/trial_task_center:329 passed,1 skipped,1 failed;失败为test_chinese_worker_diagnostics_are_not_replaced_with_garbage在当前系统mbcs编码下无法编码中文,属环境问题。python -m compileall -q src、git diff --check:通过。untouched不再出现;无 UIDreplacement_matches返回@REFDES|R1;显示字段失败在写入前抛 836;修复记录中的两个 VBS SHA256 与当前文件一致。结论:建议修复第 3 项(P1,历史 attempt 误等待)后再合并。 第 1、2 项(身份函数热路径、WARN 节流)建议在真实无 UID 大工程现场验证前处理,否则大页面可能出现明显的速度退化和日志膨胀。
复审模型:
new-provider-2/skyworth-deepseek-v4.1-flash(ZCode 自动代码审查)复审时间:2026-10-30
复审结论(PR #9,头提交 f0a0131)
Request changes:仍有 1 项 P1。
P1:已完成工程的历史 attempt 会让后续普通异常无限等待强制结束
位置:
src/dx_productivity/trial_task_center/batch_runtime.py:120-127、:322-327。BatchCadRuntime.__exit__在任意异常时把_project_attempts中的全部历史 attempt传给_retain_uncertain;而成功的写入会在QuickPartReplace.vbs中执行QPMarkBatchMutation,把 attempt 永久置为mutation_possible。即使随后_checkpoint()已写出project-checkpoint.json、project_checkpoint_released()为真,历史记录仍使can_retry_attempt()返回 False,于是wait_for_resolution()保留 CAD/桌面并阻塞,直到用户点击强制结束。我在 PR 独立工作树用真实
BatchCadRuntime、attempt 文件和 CAD/桌面替身复现:先让 worker 返回成功并将 attempt 标为mutation_possible,再模拟“下一工程启动前的普通异常”;PR 头输出waiting_for_resolution=True且 CAD 仍被持有,显式 force 后线程才退出。该路径不应把已经取得可信关闭 checkpoint 的历史工程当作当前仍在途写入。建议按当前 active attempt/generation 及其关闭 checkpoint 判断是否需要保留资源;已有可信关闭证明的历史工程应正常释放并传播原异常,同时保留禁止重放所需的审计证据。请补充“成功工程后、下一工程启动前异常”的回归测试。
验证
tests/v1_1/test_batch_runtime.py tests/v1_1/test_safe_user_stop.py tests/v1_1/test_supervisor_result.py tests/v1_1/test_supervisor_evidence.py tests/trial_task_center/test_worker_monitor.py:111 passed。git diff --check:仅有既有 Markdown 换行尾随空格。在该 P1 修复前不建议合并。
独立审查(PR #9,head
5ed8444)审查基线:
main(b939101)← head5ed8444;范围 77 个文件、约 +4500/−221。除静态阅读全部代码改动外,本机独立运行tests/v1_1全量:966 passed / 0 failed(核心子集 223 + 其余 743),与 PR 自述的 1115(含 integration 等目录)方向一致,复现通过。总体评价:方向正确、系统性很强——普通停止与强制结束分离、先落盘不确定性证据再终止 Job、强杀后保留业务结果并要求核验、
QPComponentIdentityKey统一身份、证据/lifecycle 归档、UI 后台资源快照,这些边界比 Beta 3 清晰。文档诚实地区分了"模拟/冻结"验收与"真实 CAD 现场验收"。发现 1 项 P1、3 项 P2,建议修复 P1 后再合并。[P1] 中断保护窄化依据磁盘上可能陈旧的
active_task,worker 中道崩溃时会把 uncertain 标到错误任务上位置:
src/dx_productivity/trial_task_center/batch_supervisor.py:40-42、batch_runtime.py:234、:256、:275。机理:
_prepare_attempts()只做内存更新(batch_runtime.py:234 self.record.update(active_task=...)),session.json 的落盘发生在该次 attempt 结束时的_checkpoint()(:256 self._save(state='ready'))。因此对一个"已启动、尚未 checkpoint"的新任务,磁盘上的active_task仍是上一个已完成任务的 id;若该新任务在写入中途异常退出(正是"结果缺失、最需要保护"的路径),supervisor 的_mark_interrupted读到陈旧active_task,把protected_task_ids收窄成上一个已完成任务,真正在途改写的新任务未标uncertain.flag→ 恢复流程可能对已改写的任务放行重复替换。self.record['active_attempt'] = attempt_id(:275)同样只改内存,不可作为磁盘侧的"当前 attempt"证据。建议(任选其一或组合):
run_worker()在_prepare_attempts()之后、启动 worker 子进程之前先self._save(),把active_task/active_attempt原子落盘,消除跨 attempt 窗口;_mark_interrupted中当无法证明磁盘active_task属于当前存活 attempt 时放弃窄化,回退到保护journal['task_ids']全集(当前protect_all_targets只覆盖强制路径,普通崩溃路径没有这个回退)。另请补充一个回归:mock 一个"第二次 attempt 已启动、磁盘记录仍是上一任务"的中道退出,断言
uncertain.flag落在本次在途任务而不是上一任务。[P2] PR 描述声称
git diff --check通过,但当前 HEAD 不通过docs/testing/2026-10-30-phase1-lifecycle-optimization.md:3有尾随空格,git diff --check main...HEAD实际 exit=2。python -m compileall -q src通过、VBS 两个 SHA256 与描述一致(7752FD…/46519A…)。建议删除该行尾随空格并修正 PR 描述,避免事实声明失真。[P2] 生成式
NativeSnapshotReader内嵌的QPComponentIdentityKey引用了未随脚本内嵌的QPLog位置:
QuickPartReplace.vbs的QPBuildNativeReadScript函数内嵌清单未包含QPLog,而QPComponentIdentityKey的 fallback 分支调用QPLog … "component_uid_missing_using_refdes_fallback"。当前依赖"fallback 出现时主脚本已通过QP_FallbackIdentityUsed禁用原生快照"这一隐式约定才不至于触发运行期Variable is undefined: 'QPLog',属于脆弱耦合。建议:把QPLog(必要时还有QP_FallbackIdentityWarnings)一并纳入内嵌清单,或给该日志加一个在内嵌环境下可解析的降级路径;并加一条静态扫描测试,断言内嵌函数清单覆盖这些函数体内引用到的全局 Sub/Function。[P2]
project_session.close()交互分支无限等待且无超时/force 出口位置:
project_session.py:116-119(while not self._done.wait(.1): pass)。若 VBS 工程会话关闭挂起,该线程无限等待;closing的 force 只能靠 GUI supervisor 对整个 worker Job 的process.terminate()兜底解开。可用,但该等待期间不产生任何进行中证据、不监听force_event,诊断上表现为无响应。建议该循环同时监听force_event(确认强制后提前放弃等待并交由上层终止),并周期性记录"awaiting project close"的 lifecycle 事件。[P3] 证据归档按 UTF-8(replace) 解码后丢弃原始字节
batch_supervisor.pyreceive/receive_stderr 与supervisor_evidence只保留解码后字符串;中文 Windows 下 DxDesigner/VBS 输出多为 GBK,会变成乱码且原始字节丢失(worker_monitor._decode已有 utf-8→mbcs 降级,建议 supervisor 侧对齐)。本机全量测试也出现子进程非 UTF-8 输出的告警,说明该场景真实存在。[P3]
_publish_progress现在静默吞掉全部写失败(仅节流 WARN)这是合理的设计权衡(进度发布不应打断 CAD 写入),且安全闸由 durable
uncertain.flag承担;但"等待核验"的 UI 状态依赖 worker-progress.json。建议在诊断包/日志中显著标记"进度文件不可写",或在写失败时仍尝试一次带重试的原子写以保住"awaiting_reconciliation"可见状态。确认已修复 / 做得好
5ed8444确实解决评论 93 的 P1:_active_attempts只保留当前 generation 在途证据、_checkpoint后清空、已完成工程不再把后续普通异常拖入wait_for_resolution;新增回归覆盖。_component_uid()与 VBSQPComponentIdentityKey两边约定一致(@REFDES|),fallback 时禁用原生快照,行为闭合。_finish_response对异常收尾(非正常 orderly_shutdown / 强制终止 / 非 desktop_release 阶段)统一转application_shutdown_failed且不暴露报告,逻辑自洽。IsProcessInJob复核、Job 空转宽限 2s、pending_batch_tasks统一执行顺序等,都是有效加固。结论
修复 P1 后建议合并;合并/发版前仍需完成 PR 自述的 Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程现场验收(中央库/许可证/COM 注册/网络共享/企业策略),并建议把
git diff --check清零后作为合并 gate。复审(PR #9,head
e5e628d,相对5ed8444增量 +90/−9)上轮 4 项结论复核:全部按预期修复
batch_runtime.py:285在_ensure_desktop之后、worker 启动之前执行self._save(active_task=..., active_attempt=attempt_id),把当前任务与 attempt 原子落盘;新增回归test_current_task_and_attempt_are_durable_before_worker_launch覆盖连续两个工程的磁盘身份。残留窗口仅剩_prepare_attempts→_ensure_desktop内部首个_save之间的少量无写入语句,该窗口内不可能发生 CAD 写入;即使崩溃也只会造成"多保护一个已 clean 任务"(过度保护),不再是漏保护。可关闭。Names增加QPLog QPAppendAscii并删除末尾空 stub;QPLog依赖的QP_Fso(生成脚本内初始化)与QPEncode(已内嵌)均闭合;契约测试新增QPLog QP_Root/QPAppendAscii断言,test_generated_capture_uses_original_selected_snapshot_and_untouched_reader以真实 cscript 跑通生成脚本。可关闭。project_session.py:122-124监听force_event→_abort.set()退出等待;每 15s 记录project_session_awaiting_close。小建议(非阻断):force 分支 break 后仍会进入close_grace(10–60s)等待,既然已确认强制,可把该路径 grace 缩短(如 5s)以更快交还上层 Job 收尾。_decode_process_output(batch_supervisor.py:27)先 utf-8 严格、失败回退 mbcs;stdout/stderr 与协议解析统一使用(json.loads(decoded))。证据仍只保存解码后字符串、未保留原始字节,属可接受的诊断取舍。新提交自身检查
git diff --check main...HEAD已通过(exit 0,上轮尾随空格已清理);python -m compileall -q src通过。tests/v1_1:967 passed / 0 failed(4 个已知告警:pywinauto STA 提示 + 子进程非 UTF-8 输出的 reader-thread 告警)。QuickPartReplace.vbs未变(7752FD937EF1513744F49B3A529DC075D4BD81AA743460254306FAA1BC385C92,与 PR 描述一致);NativeSnapshotReader.vbs更新为FBB7ADCE0E6905AF01B55F5D6F2F0E36A02E6CC8D79216FCC856D78606B9CDA5。建议在 PR 描述/验收文档中同步该新哈希,便于核对冻结包。docs/testing/2026-10-31-pr9-latest-review-fix.md对本轮修复的描述与代码一致。未变化/遗留(非阻断)
_publish_progress静默吞写失败(保留节流 WARN)——设计权衡,维持 P3。结论
P1/P2 均已闭环,代码、测试与文档一致,建议通过(Approve)。 合并前剩余两件小事:(a) PR 描述同步 NativeSnapshotReader 新 SHA;(b) 可选的 force 路径 grace 缩短。现场验收仍是发版前置条件。
再次复审(PR #9,head
e5e628d)Approve:当前未发现阻断合并的问题。
上轮结论已复核:
BatchCadRuntime在 worker 启动前持久化当前active_task/active_attempt,中断保护不会再依据陈旧任务漏标当前工程;成功工程后的下一工程异常不会错误进入历史 attempt 的无限等待。NativeSnapshotReader已显式携带QPLog和QPAppendAscii,不再依赖末尾空 stub;真实cscript.exe契约覆盖通过。ProjectSessionWorker.close()可观察等待状态并响应StopControl.force_event;普通关闭仍不会自动强杀 CAD。本次独立验证:
python -m pytest -q tests/v1_1 --tb=short:967 passed,1 warning(既有 pywinauto STA 提示)。python -m compileall -q src:通过。git diff --check:通过。非阻断建议:强制结束已确认后,
project_session.py:130-136仍可能按普通关闭路径等待 10–30 秒的close_grace;可在 force 分支使用更短的确认窗口,以更快把收尾交给上层 Job。Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程的现场验收仍需按 PR 描述执行。回审已合并 PR #9(
fix: harden supervised replacement and missing UID handling)merge
2cf526e,first-parent diff 78 文件 +4,612/−224。行号按origin/main(aff228e)复核;以下三条 P2 今天仍在 main。结论:可接受,没有 P1;3 条 P2 建议补修(都属"证据/等待/过度拒绝",不会写坏库)
P2-1 异常关机的回执没有落成
blocked,重启后不会再提示核验src/dx_productivity/trial_task_center/batch_supervisor.py(main:318-367)::325-330先写journal['state'] = 'blocked' if related else 'finished'并落盘;session.json的cad_shutdown:非法结构(:358-362)与"非正常关闭/强制终止/诊断错误/非 desktop_release 清理错误"(:363-366)都走raise shutdown_failure();except (OSError, ValueError, TypeError))会journal.update(state='blocked', ...)再抛;shutdown_failure()分支不回写,磁盘上仍是finished。pending_supervisors(:205-206)跳过finished,所以一旦 supervisor 以"关机失败"结束,下次启动不会再把它列进待核验,只有当时那次异常的堆栈留在日志里。建议:两条失败分支统一
journal.update(state='blocked', shutdown_record_error=...)后再抛;补一个"异常关机 → 重启后仍提示核验"的用例(现有test_safe_user_stop.py:95-114、test_supervisor_result.py:56-97都没断言这个状态)。P2-2 不安全阶段请求停止后会无限等待,普通停止永远完不成
src/dx_productivity/trial_task_center/worker_monitor.py:207-221:"不杀可能正在写的 CAD"这个原则是对的(我在别的 PR 里也赞成),但当前实现把"等"变成了没有上限、没有升级路径:
await_safe_completion只发一次,之后 supervisor 每轮都拿到None,直到用户手动强杀或 CAD 自己回来。test_safe_user_stop.py:27-35目前把"无界"写成了规格。建议:保留"不自动杀",但加升级:超过 N 分钟(可用常量+环境变量)把
waiting_for_safe_completion升级成await_explicit_force,由 UI 明确提示"保存仍在进行,是否强制释放",并把等待时长写进证据。用例断言"最终会被暴露给操作员",而不是断言"永远 None"。P2-3
ComponentMode下全 sheet 重复 Refdes 一律拒绝,多 slot/gate 器件会被整块挡住integration/dxdesigner795/QuickPartReplace.vbs:750-758:本 PR 引入的正是逐 UID 的
ComponentMode,判重却仍用Refdes:同一张图里一个多 slot/gate 器件(每个 gate 是独立 component、UID 不同、Refdes 相同)会被判成"重复"直接失败,inventory/preview 全挡。而旧的 all-match(规则)模式没有这个检查——新路径比旧路径更严,属于回退风险。test_missing_uid_inventory.py:8-15目前把这个行为写成了规格。建议:
ComponentMode用 UID 作为唯一键;只有在"按 Refdes 派发"的规则模式下才需要 Refdes 唯一。若确实要拒绝,请把文案改成"同一 Refdes 的多个实例需要逐 UID 选择",并给操作员一个继续的路径。P3(都在 main)
session.json/cad_shutdown缺失被当成正常(batch_supervisor.py:355-357把FileNotFoundError→{}),与"必须证明正常关闭"的语义不一致。protect_all_targets=True(:83/:113)会给已完成任务留下孤儿uncertain.flag,与has_interrupted的判定不一致。做得好的地方
test_safe_user_stop.py:306-430、test_isolated_desktop.py),用真实子进程/桌面而不是全 mock;测试缺口:
QuickPartReplace.vbs:1294/1506的 native-read guard 在test_quick_value_modes.py:374-392的 fake harness 里不可达,等于从未被执行过。验证记录
batch_supervisor.py、worker_monitor.py、QuickPartReplace.vbs:735-765在origin/main上逐行核对;未跑 pytest。