fix: harden supervised replacement and missing UID handling #9

Merged
abaishu0730 merged 10 commits from codex/project-optimization into main 2026-10-31 11:25:10 +08:00
Owner

本 PR 修复受监督批处理、字段采集和无 UID 器件处理的可靠性问题。

最新复审修复(提交 e5e628d)

  • P1:run_worker 在启动 CAD/worker 前原子落盘当前 active_task 和 active_attempt,避免崩溃时把 uncertain.flag 写到上一工程。新增连续两个工程的磁盘身份回归。
  • P2:生成式 NativeSnapshotReader 明确内嵌 QPComponentIdentityKey、QPLog、QPAppendAscii,fallback 原生读取不再依赖隐式 stub。
  • P2:工程会话关闭等待每 15 秒记录生命周期事件,并监听 StopControl.force_event,强制请求后交由上层 Job 收尾;普通关闭不自动强杀 CAD。
  • Windows stdout/stderr 对 UTF-8 失败按 mbcs 回退,保留中文 DxDesigner/VBS 诊断。

已修复的核心问题

  • 非目标器件逐项回读和空 untouched。
  • Python/VBS 无 UID fallback 从库存、引脚、快照、恢复到保存重开回读的统一关联。
  • 显示字段、Value、InstanceValue 读取失败不再写入伪造默认值。
  • 已完成工程的历史 attempt 不再让后续普通异常进入无限等待;只对当前 active attempt 保留资源等待。
  • 收尾记录损坏、强制重试、空保护文件、进度写入失败和进程/Job 证据边界。

最新验证

  • 生命周期、停止、监督结果、身份、VBS guards、无 UID 库存:152 passed。
  • 原生读取、VBS 契约、项目会话、当前任务落盘:34 passed。
  • compileall、缓存后的 git diff --check 通过。
  • 最新冻结 EXE smoke 通过,监督器、Job/进程身份、win32timezone、资源释放通过。
  • 最新源码和包内 VBS SHA256 一致。

现场边界

Windows 10、真实 DxDesigner 7.9.5 无 UID 工程替换/保存/重开回读、中央库/许可证/COM 注册、网络共享和企业策略仍需现场验收。模拟 COM 和冻结 smoke 不替代真实 CAD 验收。

本 PR 修复受监督批处理、字段采集和无 UID 器件处理的可靠性问题。 ### 最新复审修复(提交 e5e628d) - P1:run_worker 在启动 CAD/worker 前原子落盘当前 active_task 和 active_attempt,避免崩溃时把 uncertain.flag 写到上一工程。新增连续两个工程的磁盘身份回归。 - P2:生成式 NativeSnapshotReader 明确内嵌 QPComponentIdentityKey、QPLog、QPAppendAscii,fallback 原生读取不再依赖隐式 stub。 - P2:工程会话关闭等待每 15 秒记录生命周期事件,并监听 StopControl.force_event,强制请求后交由上层 Job 收尾;普通关闭不自动强杀 CAD。 - Windows stdout/stderr 对 UTF-8 失败按 mbcs 回退,保留中文 DxDesigner/VBS 诊断。 ### 已修复的核心问题 - 非目标器件逐项回读和空 untouched。 - Python/VBS 无 UID fallback 从库存、引脚、快照、恢复到保存重开回读的统一关联。 - 显示字段、Value、InstanceValue 读取失败不再写入伪造默认值。 - 已完成工程的历史 attempt 不再让后续普通异常进入无限等待;只对当前 active attempt 保留资源等待。 - 收尾记录损坏、强制重试、空保护文件、进度写入失败和进程/Job 证据边界。 ### 最新验证 - 生命周期、停止、监督结果、身份、VBS guards、无 UID 库存:152 passed。 - 原生读取、VBS 契约、项目会话、当前任务落盘:34 passed。 - compileall、缓存后的 git diff --check 通过。 - 最新冻结 EXE smoke 通过,监督器、Job/进程身份、win32timezone、资源释放通过。 - 最新源码和包内 VBS SHA256 一致。 ### 现场边界 Windows 10、真实 DxDesigner 7.9.5 无 UID 工程替换/保存/重开回读、中央库/许可证/COM 注册、网络共享和企业策略仍需现场验收。模拟 COM 和冻结 smoke 不替代真实 CAD 验收。
abaishu0730 added 6 commits 2026-10-30 16:36:37 +08:00
Author
Owner

审查模型:GPT-6 Astra(high)

审查范围:main(b939101)→ 本 PR 当前提交 131b6dbbb31b654bc9e8e28fd424988323ab6e4f。

结论:发现 2 项 P1、1 项 P2,建议修复后再合并。

  1. [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 上失败。请修复缩进,并覆盖零个、多个未选器件的情况。

  2. [P1] 不要将显示属性读取失败的默认值作为可写回的原始快照。

    位置:QuickPartReplace.vbs:1724–1727,以及 1666–1673。新增回退将读取失败的可见性、字体等字段及坐标写成 0;这些值随后被 QPRestoreDisplay:2665–2677 当作真实快照无条件写回。通过生产 VBS 函数和 COM 形状替身已复现:原 Visible=1,采集时 getter 暂时失败,恢复时属性被写成 Visible=0。后续回读比较的仍是伪造的 0,不能证明保留了原始显示状态;坐标也有相同问题。请为不可读字段保留明确的有效性状态,禁止把默认值写回;若无法证明需要保留的状态,应在修改前阻断。

  3. [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。
  • 额外构造的 6 个边界用例:6 failed,分别覆盖上述回读问题 2 例、fallback 身份问题 3 例、默认显示值写回问题 1 例。Python 直接调用生产函数;VBS 使用 cscript.exe 执行提取的生产函数和 COM 形状替身。
  • 默认测试集本机结果:874 passed / 73 failed;失败涉及当前解释器缺少 pywin32,以及 Windows 长路径环境限制。补装 pywin32 时 PyPI 连接超时,因此不将这批环境失败列为 PR 缺陷,也不声称全量回归通过。
  • 未对真实 DxDesigner 工程执行替换、保存或重开;以上复现不等同于真实 CAD 验收。本次仅审查,未修改 PR 源码。
审查模型:**GPT-6 Astra(high)** 审查范围:`main`(`b939101`)→ 本 PR 当前提交 `131b6dbbb31b654bc9e8e28fd424988323ab6e4f`。 结论:发现 **2 项 P1、1 项 P2**,建议修复后再合并。 1. **[P1] 将未选器件的逐项比较恢复到循环内。** 位置:[native_helper.py:576–582](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/131b6dbbb31b654bc9e8e28fd424988323ab6e4f/src/dx_productivity/trial_task_center/native_helper.py#L576)。`if actual != identity` 被移出了 `for uid, identity in untouched.items()`。在非精确目标范围的替换中,有多个未选器件时只检查最后一个;如果整页器件都被替换,`untouched={}`,则在原生替换已经执行之后抛出 `UnboundLocalError`,无法正常进入后续恢复和保存。最小复现:未选 R2 的 Value 从 V0 变为 CHANGED、最后一个未选 R3 保持不变时,该函数错误地返回成功;仅有一个目标且没有未选器件时直接报错。这两例在 `main` 上通过,在 PR head 上失败。请修复缩进,并覆盖零个、多个未选器件的情况。 2. **[P1] 不要将显示属性读取失败的默认值作为可写回的原始快照。** 位置:[QuickPartReplace.vbs:1724–1727](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/131b6dbbb31b654bc9e8e28fd424988323ab6e4f/integration/dxdesigner795/QuickPartReplace.vbs#L1724),以及 1666–1673。新增回退将读取失败的可见性、字体等字段及坐标写成 `0`;这些值随后被 [QPRestoreDisplay:2665–2677](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/131b6dbbb31b654bc9e8e28fd424988323ab6e4f/integration/dxdesigner795/QuickPartReplace.vbs#L2665) 当作真实快照无条件写回。通过生产 VBS 函数和 COM 形状替身已复现:原 Visible=1,采集时 getter 暂时失败,恢复时属性被写成 Visible=0。后续回读比较的仍是伪造的 0,不能证明保留了原始显示状态;坐标也有相同问题。请为不可读字段保留明确的有效性状态,禁止把默认值写回;若无法证明需要保留的状态,应在修改前阻断。 3. **[P2] 将无 UID 的 fallback 身份贯穿快照、替换结果、引脚和恢复流程。** 位置:[QuickPartReplace.vbs:1582–1587](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/131b6dbbb31b654bc9e8e28fd424988323ab6e4f/integration/dxdesigner795/QuickPartReplace.vbs#L1582)、[native_helper.py:529–563](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/131b6dbbb31b654bc9e8e28fd424988323ab6e4f/src/dx_productivity/trial_task_center/native_helper.py#L529)。库存虽然允许 `@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**。 - 额外构造的 6 个边界用例:**6 failed**,分别覆盖上述回读问题 2 例、fallback 身份问题 3 例、默认显示值写回问题 1 例。Python 直接调用生产函数;VBS 使用 `cscript.exe` 执行提取的生产函数和 COM 形状替身。 - 默认测试集本机结果:**874 passed / 73 failed**;失败涉及当前解释器缺少 pywin32,以及 Windows 长路径环境限制。补装 pywin32 时 PyPI 连接超时,因此不将这批环境失败列为 PR 缺陷,也不声称全量回归通过。 - 未对真实 DxDesigner 工程执行替换、保存或重开;以上复现不等同于真实 CAD 验收。本次仅审查,未修改 PR 源码。
Author
Owner

审查结论

建议先修复再合并(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 被移出循环

当前代码:

for uid, identity in untouched.items():
    component = current.get(uid)
    actual = None if component is None else (
        str(component.Refdes), *(attribute_value(component, name)
            for name in ("Part Number", "Value", "Part Name", "Part Label")))
if actual != identity:
        raise ValueError('An unselected component was changed')

if actual != identity 与 for 同级(8 空格),已经不在循环体内。后果:

  1. 只校验最后一个非目标器件。前面任意一个非目标器件被改动都不会报错,替换后可能静默破坏未选中的器件。
  2. untouched 为空时直接 UnboundLocalError,因为 actual/identity 从未赋值。这是“目标覆盖整页、没有非目标器件”的常见场景。
  3. 该分支是 len(metadata) != 10 的兼容路径;新格式快照走 verify_unselected_snapshot 不受影响,但旧格式快照仍会命中。

本地已用最小脚本复现:构造 3 个器件、改坏中间的非目标器件,函数返回 ['u1'] 而不是抛错;传空 untouched 时抛 UnboundLocalError。

修复:把 if 缩进回 for 内;新增“2 个以上非目标器件,改坏第一个”和“无非目标器件”的回归用例。

P0-2 native_helper.py:561:replacement_matches() 把 fallback 身份丢掉了

matches.append(str(candidate.UID))

本 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 路径只改了一半,多个位置仍用原始 UID

PR 的描述是“无 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、:1923
    • QPRestorePreflight :2042

    这些比较在无 UID 场景下是 '' vs '@REFDES|R1',会在保存后回读或恢复前报 saved component UID differs / replacement component UID or Refdes differs from snapshot。

  • QPBuildComponentIndex(:417)仍以原始 UID 建索引,QPFindUniqueByOldLocation 拿到代理后再做原始 UID 比较也会失败。

因此当前无 UID 路径无法端到端完成替换:现场验证之前,静态代码已经能确定会在捕获或回读阶段失败。建议:

  1. 定义一个统一的 VBS 身份函数(现有 QPComponentIdentityKey),在引脚索引、匹配集合、恢复/回读比较、连接签名中全部使用;
  2. QPComponentPins 改为按 fallback 身份建索引(或对无 UID 器件使用 Refdes/坐标回退);
  3. 如果本版只想支持“库存识别”,则应在替换入口明确拒绝无 UID 器件并给出可操作提示,而不是让流程走到一半失败;
  4. 补一条带 fake pins 的 VBS 契约测试,覆盖“空 UID + 有引脚”的捕获/回读。

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。


中等风险 / 建议修复

  1. batch_supervisor.py:247-252:读取 session.json 只捕获 FileNotFoundError。若文件是损坏 JSON 或权限错误,会在 journal 已标记 finished 后把原始 JSONDecodeError/PermissionError 抛给上层,而不是进入 application_shutdown_error。建议捕获 (OSError, ValueError, TypeError) 并把“收尾状态未知”作为诊断错误处理;同时防御 cad_shutdown / cleanup_errors 不是预期类型的情况。

  2. worker_monitor.py:131-135:_publish_progress 现在吞掉所有 OSError。磁盘满、目录权限或锁冲突时,awaiting_reconciliation 状态不会写到 worker-progress.json,非监督路径的 UI 会一直显示旧阶段,用户看不到“需要强制结束/核验”的提示,诊断也丢失。建议至少写 WARN 日志或记录一个计数;如果只想忽略锁冲突,可恢复为仅忽略 PermissionError / winerror 5/32/33。

  3. batch_supervisor.py:96-135:_retain_supervisor_after_control_error 是无上限等待。它对 try 块内任何异常生效,包括 on_progress/on_phase 这类纯 UI 回调异常;如果监督进程不退出且用户不点强制结束,调用线程会永久停在这里。建议区分“控制通道异常”和“业务/UI 回调异常”,至少在等待期间持续更新心跳/日志,并向 UI 暴露等待状态。

  4. batch_supervisor.py:64-69:_force_owned_supervisor 在 force_state in {'termination_requested','confirmed'} 时直接返回成功,不再确认进程是否真的退出。若上一次终止只写入了状态但进程仍存活,重试强制会被当成已成功。建议仍检查 process.poll(),存活时重新终止或返回失败。

  5. stop_control.py:28-39:protect_interruption 对已存在的 marker 只做 fsync。如果上次 open('x') 成功但 write 前崩溃,会留下 0 字节文件;本次只同步空文件,并不能证明“原因已写入”。如果恢复逻辑只检查存在性则影响有限,但建议用临时文件 + 原子替换写入原因,或至少校验非空。

  6. 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 并保留原因。

  7. batch_runtime.py:324-329:wait_for_resolution 在 batch worker 内是无上限等待;监督模式下 GUI 的强制结束只会终止 supervisor 进程,worker 的 force_event 永远不会被设置。当前依赖 Job 终止来结束 worker,这是可行的,但建议在文档和测试中明确写出这个依赖,并确认 supervisor 被外部终止时 worker/CAD 一定在同一个 Job 内。

  8. @ANON 与 Python 不一致:VBS 的 QPComponentIdentityKey 对“UID 和 Refdes 都为空”的器件返回 @ANON|x|y,而 Python 的 _component_uid 直接抛错。前者会让非目标匿名器件进入库存,后者会让整页 components_on_sheet() 失败。建议统一策略:要么两边都阻断,要么两边都使用同一套坐标 fallback,并明确坐标相同/重复时的处理。

  9. QP_FallbackIdentityUsed 是进程级全局标志:一旦某个任务遇到无 UID 器件,后续所有任务都会禁用 native snapshot 读取,直到进程重启。功能上安全,但长期会话会持续退化到慢速 CAD 采集;建议按 job/session 重置,或在日志中明确提示。

  10. 启动失败也标记 uncertain:run_supervised 在 process is None(create_process 直接失败)时仍走 _mark_interrupted,给写任务打 business_uncertain 和 uncertain.flag。此时业务进程尚未启动,按现有测试这是有意为之,但 UI 会表现为“结果待核验”,对用户来说偏重。建议在错误文案/恢复入口上区分“启动失败,无写入发生”。


测试与文档

  1. 测试缺口:新增测试覆盖了 stop/force、supervisor evidence、resource status、VBS 库存身份,但没有覆盖:

    • verify_replacement_readback 多个非目标器件、空 untouched(P0-1);
    • replacement_matches 返回 fallback 身份、promote_pin_numbers 无 UID 匹配(P0-2);
    • VBS “空 UID + 有引脚”的捕获/保存回读/恢复(P0-3)。

    这三类正好是本次改动的核心场景,建议补齐后再合并。

  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 命令、目录范围和运行环境,避免把“实现阶段扩展回归”“发布门禁”“构建门禁”混在一起。

  3. 文档日期:docs/releases/v1.1.4-beta.4.md 开头是“2026-10-26”,与 PR 创建时间 2026-10-30 不一致,建议核对。

  4. 证据文件包含本机绝对路径:docs/testing/evidence/2026-10-30-environment-compatibility.json 里有 F:\Sync Tool Skyworth\... 等路径。若仓库仅内部使用可接受;若会对外分发,建议脱敏。

  5. git diff --check 只有 docs/testing/2026-10-30-phase1-lifecycle-optimization.md:3 的尾随空格(Markdown 换行语法),无需处理。


本地验证

  • 环境:Windows 11 x64、Python 3.12.10;在 PR head 的独立克隆上运行。
  • 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:通过。
  • 额外用最小脚本复现了 P0-1(非目标器件漏检、空 untouched 的 UnboundLocalError)、P0-2(replacement_matches 返回 [''])和 P0-4(QPRestoreDisplay 将读取失败的显示字段写成 0)。

审查模型:new-provider-2/skyworth-deepseek-v4.1-flash(ZCode 自动代码审查)
审查时间:2026-10-30

## 审查结论 **建议先修复再合并(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` 被移出循环 当前代码: ```python for uid, identity in untouched.items(): component = current.get(uid) actual = None if component is None else ( str(component.Refdes), *(attribute_value(component, name) for name in ("Part Number", "Value", "Part Name", "Part Label"))) if actual != identity: raise ValueError('An unselected component was changed') ``` `if actual != identity` 与 `for` 同级(8 空格),已经不在循环体内。后果: 1. **只校验最后一个非目标器件**。前面任意一个非目标器件被改动都不会报错,替换后可能静默破坏未选中的器件。 2. **`untouched` 为空时直接 `UnboundLocalError`**,因为 `actual`/`identity` 从未赋值。这是“目标覆盖整页、没有非目标器件”的常见场景。 3. 该分支是 `len(metadata) != 10` 的兼容路径;新格式快照走 `verify_unselected_snapshot` 不受影响,但旧格式快照仍会命中。 本地已用最小脚本复现:构造 3 个器件、改坏中间的非目标器件,函数返回 `['u1']` 而不是抛错;传空 `untouched` 时抛 `UnboundLocalError`。 修复:把 `if` 缩进回 `for` 内;新增“2 个以上非目标器件,改坏第一个”和“无非目标器件”的回归用例。 ### P0-2 `native_helper.py:561`:`replacement_matches()` 把 fallback 身份丢掉了 ```python matches.append(str(candidate.UID)) ``` 本 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 路径只改了一半,多个位置仍用原始 UID PR 的描述是“无 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`、`:1923` - `QPRestorePreflight` `:2042` 这些比较在无 UID 场景下是 `''` vs `'@REFDES|R1'`,会在保存后回读或恢复前报 `saved component UID differs` / `replacement component UID or Refdes differs from snapshot`。 - `QPBuildComponentIndex`(`:417`)仍以原始 UID 建索引,`QPFindUniqueByOldLocation` 拿到代理后再做原始 UID 比较也会失败。 因此当前无 UID 路径**无法端到端完成替换**:现场验证之前,静态代码已经能确定会在捕获或回读阶段失败。建议: 1. 定义一个统一的 VBS 身份函数(现有 `QPComponentIdentityKey`),在引脚索引、匹配集合、恢复/回读比较、连接签名中全部使用; 2. `QPComponentPins` 改为按 fallback 身份建索引(或对无 UID 器件使用 Refdes/坐标回退); 3. 如果本版只想支持“库存识别”,则应在替换入口明确拒绝无 UID 器件并给出可操作提示,而不是让流程走到一半失败; 4. 补一条带 fake pins 的 VBS 契约测试,覆盖“空 UID + 有引脚”的捕获/回读。 ### 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`。 --- ## 中等风险 / 建议修复 1. **`batch_supervisor.py:247-252`**:读取 `session.json` 只捕获 `FileNotFoundError`。若文件是损坏 JSON 或权限错误,会在 `journal` 已标记 `finished` 后把原始 `JSONDecodeError`/`PermissionError` 抛给上层,而不是进入 `application_shutdown_error`。建议捕获 `(OSError, ValueError, TypeError)` 并把“收尾状态未知”作为诊断错误处理;同时防御 `cad_shutdown` / `cleanup_errors` 不是预期类型的情况。 2. **`worker_monitor.py:131-135`**:`_publish_progress` 现在吞掉所有 `OSError`。磁盘满、目录权限或锁冲突时,`awaiting_reconciliation` 状态不会写到 `worker-progress.json`,非监督路径的 UI 会一直显示旧阶段,用户看不到“需要强制结束/核验”的提示,诊断也丢失。建议至少写 WARN 日志或记录一个计数;如果只想忽略锁冲突,可恢复为仅忽略 `PermissionError` / `winerror 5/32/33`。 3. **`batch_supervisor.py:96-135`**:`_retain_supervisor_after_control_error` 是无上限等待。它对 `try` 块内任何异常生效,包括 `on_progress`/`on_phase` 这类纯 UI 回调异常;如果监督进程不退出且用户不点强制结束,调用线程会永久停在这里。建议区分“控制通道异常”和“业务/UI 回调异常”,至少在等待期间持续更新心跳/日志,并向 UI 暴露等待状态。 4. **`batch_supervisor.py:64-69`**:`_force_owned_supervisor` 在 `force_state in {'termination_requested','confirmed'}` 时直接返回成功,不再确认进程是否真的退出。若上一次终止只写入了状态但进程仍存活,重试强制会被当成已成功。建议仍检查 `process.poll()`,存活时重新终止或返回失败。 5. **`stop_control.py:28-39`**:`protect_interruption` 对已存在的 marker 只做 `fsync`。如果上次 `open('x')` 成功但 `write` 前崩溃,会留下 0 字节文件;本次只同步空文件,并不能证明“原因已写入”。如果恢复逻辑只检查存在性则影响有限,但建议用临时文件 + 原子替换写入原因,或至少校验非空。 6. **`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 并保留原因。 7. **`batch_runtime.py:324-329`**:`wait_for_resolution` 在 batch worker 内是无上限等待;监督模式下 GUI 的强制结束只会终止 supervisor 进程,worker 的 `force_event` 永远不会被设置。当前依赖 Job 终止来结束 worker,这是可行的,但建议在文档和测试中明确写出这个依赖,并确认 supervisor 被外部终止时 worker/CAD 一定在同一个 Job 内。 8. **`@ANON` 与 Python 不一致**:VBS 的 `QPComponentIdentityKey` 对“UID 和 Refdes 都为空”的器件返回 `@ANON|x|y`,而 Python 的 `_component_uid` 直接抛错。前者会让非目标匿名器件进入库存,后者会让整页 `components_on_sheet()` 失败。建议统一策略:要么两边都阻断,要么两边都使用同一套坐标 fallback,并明确坐标相同/重复时的处理。 9. **`QP_FallbackIdentityUsed` 是进程级全局标志**:一旦某个任务遇到无 UID 器件,后续所有任务都会禁用 native snapshot 读取,直到进程重启。功能上安全,但长期会话会持续退化到慢速 CAD 采集;建议按 job/session 重置,或在日志中明确提示。 10. **启动失败也标记 uncertain**:`run_supervised` 在 `process is None`(`create_process` 直接失败)时仍走 `_mark_interrupted`,给写任务打 `business_uncertain` 和 `uncertain.flag`。此时业务进程尚未启动,按现有测试这是有意为之,但 UI 会表现为“结果待核验”,对用户来说偏重。建议在错误文案/恢复入口上区分“启动失败,无写入发生”。 --- ## 测试与文档 1. **测试缺口**:新增测试覆盖了 stop/force、supervisor evidence、resource status、VBS 库存身份,但没有覆盖: - `verify_replacement_readback` 多个非目标器件、空 `untouched`(P0-1); - `replacement_matches` 返回 fallback 身份、`promote_pin_numbers` 无 UID 匹配(P0-2); - VBS “空 UID + 有引脚”的捕获/保存回读/恢复(P0-3)。 这三类正好是本次改动的核心场景,建议补齐后再合并。 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 命令、目录范围和运行环境,避免把“实现阶段扩展回归”“发布门禁”“构建门禁”混在一起。 3. **文档日期**:`docs/releases/v1.1.4-beta.4.md` 开头是“2026-10-26”,与 PR 创建时间 2026-10-30 不一致,建议核对。 4. **证据文件包含本机绝对路径**:`docs/testing/evidence/2026-10-30-environment-compatibility.json` 里有 `F:\Sync Tool Skyworth\...` 等路径。若仓库仅内部使用可接受;若会对外分发,建议脱敏。 5. `git diff --check` 只有 `docs/testing/2026-10-30-phase1-lifecycle-optimization.md:3` 的尾随空格(Markdown 换行语法),无需处理。 --- ## 本地验证 - 环境:Windows 11 x64、Python 3.12.10;在 PR head 的独立克隆上运行。 - `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`:通过。 - 额外用最小脚本复现了 P0-1(非目标器件漏检、空 `untouched` 的 `UnboundLocalError`)、P0-2(`replacement_matches` 返回 `['']`)和 P0-4(`QPRestoreDisplay` 将读取失败的显示字段写成 0)。 --- 审查模型:`new-provider-2/skyworth-deepseek-v4.1-flash`(ZCode 自动代码审查) 审查时间:2026-10-30
abaishu0730 added 1 commit 2026-10-30 17:48:28 +08:00
Author
Owner

复审模型:GPT-6 Astra(high)

复审提交:f0a0131aac7f2c62307ce648cc387849ca05e201;已重新读取评论 88/89,并检查相对 131b6db 的修复及相关调用链。

上轮评论 88 的 3 项问题已在本次审查范围内确认修复,可以关闭;另发现 1 项 P2,建议修复后再合并。

  • 未选器件比较已回到循环内;零个、多个未选器件的情况通过。
  • 不可读显示字段不再伪造为 0,快照及恢复入口会在写入前阻断;原始 Value/InstanceValue 也恢复为严格采集。
  • fallback 身份已贯穿匹配结果、引脚、快照、恢复和保存重开回读。新增生产 VBS + COM 替身流程回归通过。

[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 替身复现了第一种情形:

worker 返回 0,project_checkpoint_released(...) == True
下一步在启动任何新 CAD 工作前抛出 OSError(模拟下一工程备份失败)
PR head:waiting_for_resolution=True,cad_closed=False,uncertain.flag=True,调用线程仍等待
main:   waiting_for_resolution=False,cad_closed=True,uncertain.flag=False,正常退出并传播原异常

复现结束后显式 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。
  • 上次独立复现中的回读及无 UID 5 例:5 passed;显示写回问题用本次严格阻断测试验证。
  • 新增上述生命周期边界复现:PR head 失败,main 对照通过。
  • 本次未重新执行完整测试集,也未验证真实 DxDesigner 工程或冻结 EXE;本机审查解释器仍缺少 pywin32/pywinauto,因此没有把 PR 描述的 1115 passed 当作本次独立验证结果。未修改 PR 源码。
复审模型:**GPT-6 Astra(high)** 复审提交:`f0a0131aac7f2c62307ce648cc387849ca05e201`;已重新读取评论 88/89,并检查相对 `131b6db` 的修复及相关调用链。 **上轮评论 88 的 3 项问题已在本次审查范围内确认修复,可以关闭;另发现 1 项 P2,建议修复后再合并。** - 未选器件比较已回到循环内;零个、多个未选器件的情况通过。 - 不可读显示字段不再伪造为 0,快照及恢复入口会在写入前阻断;原始 Value/InstanceValue 也恢复为严格采集。 - fallback 身份已贯穿匹配结果、引脚、快照、恢复和保存重开回读。新增生产 VBS + COM 替身流程回归通过。 **[P2] 已完成关闭检查的历史写入,不应使后续普通异常进入无限等待强制结束。** 位置:[batch_runtime.py:123–126](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/f0a0131aac7f2c62307ce648cc387849ca05e201/src/dx_productivity/trial_task_center/batch_runtime.py#L123)、[324–329](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/f0a0131aac7f2c62307ce648cc387849ca05e201/src/dx_productivity/trial_task_center/batch_runtime.py#L324)。 `__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 替身复现了第一种情形: ```text worker 返回 0,project_checkpoint_released(...) == True 下一步在启动任何新 CAD 工作前抛出 OSError(模拟下一工程备份失败) PR head:waiting_for_resolution=True,cad_closed=False,uncertain.flag=True,调用线程仍等待 main: waiting_for_resolution=False,cad_closed=True,uncertain.flag=False,正常退出并传播原异常 ``` 复现结束后显式 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`。 - 上次独立复现中的回读及无 UID 5 例:**5 passed**;显示写回问题用本次严格阻断测试验证。 - 新增上述生命周期边界复现:**PR head 失败,main 对照通过**。 - 本次未重新执行完整测试集,也未验证真实 DxDesigner 工程或冻结 EXE;本机审查解释器仍缺少 pywin32/pywinauto,因此没有把 PR 描述的 1115 passed 当作本次独立验证结果。未修改 PR 源码。
Author
Owner

复审结论(f0a0131)

上一轮 4 组阻断项均已修复,并通过复现/回归验证。 但本轮新发现 1 项 P1:历史 attempt 会让已完成工程后的普通异常进入强制结束等待,建议修复后再合并。其余为无 UID 大工程下的性能/日志和少量诊断/测试补充,属于非阻断建议。

复审基线:f0a0131aac(PR head)← 131b6dbbb3(上轮审查提交);增量 15 个文件,+312/−64。


上轮阻断项复核

# 上轮问题 状态 证据
1 native_helper.py 非目标器件比较被移出循环 已修复 native_helper.py:576-582 的 if 已回到循环内;新增零个/两个未选器件、首个未选器件被修改的回归。我用上轮最小脚本复测:改坏中间未选器件现在抛 An unselected component was changed,空 untouched 正常返回 ['u1']。
2 replacement_matches 返回原始空 UID 已修复 native_helper.py:561 改为 _component_uid(candidate);复测无 UID 目标返回 `['@REFDES
3 VBS 无 UID 路径只改了一半 已修复 组件索引、引脚索引、捕获/未目标集合、保存重开回读、恢复计划、恢复预检、连接签名均已使用 QPComponentIdentityKey;@ANON 已移除;QP_FallbackIdentityUsed 在每次捕获前重置。新增 test_missing_uid_capture_restore_save_and_reopen 覆盖捕获→恢复→保存→重开→saved_ok。
4 显示字段读取失败把默认 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 又对每个引脚再调用一次。
  • 无 UID 工程中,这意味着每个引脚约 4 次 COM 读取(UID+Refdes ×2)和 2 条 WARN;QPLog → QPAppendAscii:3298 每条都 OpenTextFile/Close,大页面上会产生大量文件 I/O 和日志,可能显著拖慢无 UID 工程,也是本次功能的目标场景。57 器件/103 引脚的小工程不会暴露该问题。

建议:

  1. 在 UID 非空时提前返回,只有 UID 为空才读 Refdes;
  2. 把 fallback WARN 移出身份函数(在库存/捕获时按身份去重记录一次),或加一个字典去重;
  3. QPConnectionSignatureFromPins 的 Pins 本身就是按 owner 分桶的,桶内再逐个比较身份是冗余的,可去掉或复用已知 identity。

2. [P2] _publish_progress 在等待安全收尾时会持续刷 WARN

worker_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;
  • 保留 CAD/桌面并阻塞在等待强制结束;
  • 让普通“完成当前项后暂停”无法退出。

我用一个 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(防止未来再次吞错)。
  • Python 侧建议补一条无 UID 的 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 我已核对,与当前文件一致。


本地验证

  • 环境:Windows 11 x64、Python 3.12.10、独立克隆 + 本地 venv。
  • tests/v1_1:957 passed,8 failed。8 个失败仍是本机未启用 Win32 长路径导致的 pytest 临时目录 mkdir 失败(test_batch_supervisor/test_isolated_cad/test_project_long_paths/test_execution_metrics),与本次改动无关。
  • 关键集成/VBS:test_quick_value_modes + test_quick_part_replace_contract + test_automatic_replacement_regression 112 passed;tests/ui 31 passed。
  • tests/trial_task_center:329 passed,1 skipped,1 failed;失败为 test_chinese_worker_diagnostics_are_not_replaced_with_garbage 在当前系统 mbcs 编码下无法编码中文,属环境问题。
  • 定向新增用例(native readback、VBS guards、supervisor result、safe stop):105 passed。
  • python -m compileall -q src、git diff --check:通过。
  • 已复现修复效果:非目标器件漏检/空 untouched 不再出现;无 UID replacement_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

## 复审结论(`f0a0131`) **上一轮 4 组阻断项均已修复,并通过复现/回归验证。** 但本轮新发现 **1 项 P1**:历史 attempt 会让已完成工程后的普通异常进入强制结束等待,建议修复后再合并。其余为无 UID 大工程下的性能/日志和少量诊断/测试补充,属于非阻断建议。 复审基线:`f0a0131aac`(PR head)← `131b6dbbb3`(上轮审查提交);增量 15 个文件,+312/−64。 --- ## 上轮阻断项复核 | # | 上轮问题 | 状态 | 证据 | |---|---|---|---| | 1 | `native_helper.py` 非目标器件比较被移出循环 | 已修复 | `native_helper.py:576-582` 的 `if` 已回到循环内;新增零个/两个未选器件、首个未选器件被修改的回归。我用上轮最小脚本复测:改坏中间未选器件现在抛 `An unselected component was changed`,空 `untouched` 正常返回 `['u1']`。 | | 2 | `replacement_matches` 返回原始空 UID | 已修复 | `native_helper.py:561` 改为 `_component_uid(candidate)`;复测无 UID 目标返回 `['@REFDES|R1']`,新增用例直接流入 `promote_pin_numbers`。 | | 3 | VBS 无 UID 路径只改了一半 | 已修复 | 组件索引、引脚索引、捕获/未目标集合、保存重开回读、恢复计划、恢复预检、连接签名均已使用 `QPComponentIdentityKey`;`@ANON` 已移除;`QP_FallbackIdentityUsed` 在每次捕获前重置。新增 `test_missing_uid_capture_restore_save_and_reopen` 覆盖捕获→恢复→保存→重开→`saved_ok`。 | | 4 | 显示字段读取失败把默认 `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` 又对每个引脚再调用一次。 - 无 UID 工程中,这意味着每个引脚约 **4 次 COM 读取**(UID+Refdes ×2)和 **2 条 WARN**;`QPLog` → `QPAppendAscii:3298` 每条都 `OpenTextFile`/`Close`,大页面上会产生大量文件 I/O 和日志,可能显著拖慢无 UID 工程,也是本次功能的目标场景。57 器件/103 引脚的小工程不会暴露该问题。 建议: 1. 在 UID 非空时提前返回,只有 UID 为空才读 `Refdes`; 2. 把 fallback WARN 移出身份函数(在库存/捕获时按身份去重记录一次),或加一个字典去重; 3. `QPConnectionSignatureFromPins` 的 `Pins` 本身就是按 owner 分桶的,桶内再逐个比较身份是冗余的,可去掉或复用已知 identity。 ### 2. [P2] `_publish_progress` 在等待安全收尾时会持续刷 WARN `worker_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`; - 保留 CAD/桌面并阻塞在等待强制结束; - 让普通“完成当前项后暂停”无法退出。 我用一个 `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(防止未来再次吞错)。 - Python 侧建议补一条无 UID 的 `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 我已核对,与当前文件一致。 --- ## 本地验证 - 环境:Windows 11 x64、Python 3.12.10、独立克隆 + 本地 venv。 - `tests/v1_1`:**957 passed,8 failed**。8 个失败仍是本机未启用 Win32 长路径导致的 pytest 临时目录 `mkdir` 失败(`test_batch_supervisor`/`test_isolated_cad`/`test_project_long_paths`/`test_execution_metrics`),与本次改动无关。 - 关键集成/VBS:`test_quick_value_modes` + `test_quick_part_replace_contract` + `test_automatic_replacement_regression` **112 passed**;`tests/ui` **31 passed**。 - `tests/trial_task_center`:**329 passed,1 skipped,1 failed**;失败为 `test_chinese_worker_diagnostics_are_not_replaced_with_garbage` 在当前系统 `mbcs` 编码下无法编码中文,属环境问题。 - 定向新增用例(native readback、VBS guards、supervisor result、safe stop):**105 passed**。 - `python -m compileall -q src`、`git diff --check`:通过。 - 已复现修复效果:非目标器件漏检/空 `untouched` 不再出现;无 UID `replacement_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
Author
Owner

复审结论(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 判断是否需要保留资源;已有可信关闭证明的历史工程应正常释放并传播原异常,同时保留禁止重放所需的审计证据。请补充“成功工程后、下一工程启动前异常”的回归测试。

验证

  • PR 独立工作树定向测试: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,头提交 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 判断是否需要保留资源;已有可信关闭证明的历史工程应正常释放并传播原异常,同时保留禁止重放所需的审计证据。请补充“成功工程后、下一工程启动前异常”的回归测试。 ### 验证 - PR 独立工作树定向测试:`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 修复前不建议合并。
abaishu0730 added 1 commit 2026-10-31 09:25:45 +08:00
Author
Owner

独立审查(PR #9,head 5ed8444)

审查基线:main(b939101)← head 5ed8444;范围 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"证据。

建议(任选其一或组合):

  1. run_worker() 在 _prepare_attempts() 之后、启动 worker 子进程之前先 self._save(),把 active_task/active_attempt 原子落盘,消除跨 attempt 窗口;
  2. 或在 _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.py receive/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;新增回归覆盖。
  • 无 UID fallback 在 Python _component_uid() 与 VBS QPComponentIdentityKey 两边约定一致(@REFDES|),fallback 时禁用原生快照,行为闭合。
  • _finish_response 对异常收尾(非正常 orderly_shutdown / 强制终止 / 非 desktop_release 阶段)统一转 application_shutdown_failed 且不暴露报告,逻辑自洽。
  • 强制路径先落盘证据再 terminate、IsProcessInJob 复核、Job 空转宽限 2s、pending_batch_tasks 统一执行顺序等,都是有效加固。

结论

修复 P1 后建议合并;合并/发版前仍需完成 PR 自述的 Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程现场验收(中央库/许可证/COM 注册/网络共享/企业策略),并建议把 git diff --check 清零后作为合并 gate。

## 独立审查(PR #9,head `5ed8444`) 审查基线:`main`(`b939101`)← head `5ed8444`;范围 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"证据。 建议(任选其一或组合): 1. `run_worker()` 在 `_prepare_attempts()` 之后、启动 worker 子进程之前先 `self._save()`,把 `active_task`/`active_attempt` 原子落盘,消除跨 attempt 窗口; 2. 或在 `_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.py` receive/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`;新增回归覆盖。 - 无 UID fallback 在 Python `_component_uid()` 与 VBS `QPComponentIdentityKey` 两边约定一致(`@REFDES|`),fallback 时禁用原生快照,行为闭合。 - `_finish_response` 对异常收尾(非正常 orderly_shutdown / 强制终止 / 非 desktop_release 阶段)统一转 `application_shutdown_failed` 且不暴露报告,逻辑自洽。 - 强制路径先落盘证据再 terminate、`IsProcessInJob` 复核、Job 空转宽限 2s、`pending_batch_tasks` 统一执行顺序等,都是有效加固。 ### 结论 修复 P1 后建议合并;合并/发版前仍需完成 PR 自述的 Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程现场验收(中央库/许可证/COM 注册/网络共享/企业策略),并建议把 `git diff --check` 清零后作为合并 gate。
abaishu0730 added 1 commit 2026-10-31 10:25:00 +08:00
Author
Owner

复审(PR #9,head e5e628d,相对 5ed8444 增量 +90/−9)

上轮 4 项结论复核:全部按预期修复

  1. [P1] active_task 落盘窗口 — ✅ 已闭环。 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 任务"(过度保护),不再是漏保护。可关闭。
  2. [P2] 生成式 NativeSnapshotReader 依赖闭合 — ✅ 已修复。 Names 增加 QPLog QPAppendAscii 并删除末尾空 stub;QPLog 依赖的 QP_Fso(生成脚本内初始化)与 QPEncode(已内嵌)均闭合;契约测试新增 QPLog QP_Root / QPAppendAscii 断言,test_generated_capture_uses_original_selected_snapshot_and_untouched_reader 以真实 cscript 跑通生成脚本。可关闭。
  3. [P2] project_session 关闭等待可观察/可强制 — ✅ 已修复。 project_session.py:122-124 监听 force_event → _abort.set() 退出等待;每 15s 记录 project_session_awaiting_close。小建议(非阻断):force 分支 break 后仍会进入 close_grace(10–60s)等待,既然已确认强制,可把该路径 grace 缩短(如 5s)以更快交还上层 Job 收尾。
  4. [P3] 编码回退 — ✅ 已修复。 _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 告警)。
  • VBS SHA256:QuickPartReplace.vbs 未变(7752FD937EF1513744F49B3A529DC075D4BD81AA743460254306FAA1BC385C92,与 PR 描述一致);NativeSnapshotReader.vbs 更新为 FBB7ADCE0E6905AF01B55F5D6F2F0E36A02E6CC8D79216FCC856D78606B9CDA5。建议在 PR 描述/验收文档中同步该新哈希,便于核对冻结包。
  • PR 描述与 docs/testing/2026-10-31-pr9-latest-review-fix.md 对本轮修复的描述与代码一致。

未变化/遗留(非阻断)

  • 体积:现 78 文件 / +4587;docs 占比仍高(一次性验收记录与代码同 diff)。上轮体积审查的"合并前把 D 类验收文档拆为独立提交"建议仍适用。
  • _publish_progress 静默吞写失败(保留节流 WARN)——设计权衡,维持 P3。
  • 仍需 Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程现场验收(中央库/许可证/COM 注册/网络共享/企业策略)。

结论

P1/P2 均已闭环,代码、测试与文档一致,建议通过(Approve)。 合并前剩余两件小事:(a) PR 描述同步 NativeSnapshotReader 新 SHA;(b) 可选的 force 路径 grace 缩短。现场验收仍是发版前置条件。

## 复审(PR #9,head `e5e628d`,相对 `5ed8444` 增量 +90/−9) ### 上轮 4 项结论复核:全部按预期修复 1. **[P1] active_task 落盘窗口 — ✅ 已闭环。** `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 任务"(过度保护),不再是漏保护。**可关闭。** 2. **[P2] 生成式 NativeSnapshotReader 依赖闭合 — ✅ 已修复。** `Names` 增加 `QPLog QPAppendAscii` 并删除末尾空 stub;`QPLog` 依赖的 `QP_Fso`(生成脚本内初始化)与 `QPEncode`(已内嵌)均闭合;契约测试新增 `QPLog QP_Root` / `QPAppendAscii` 断言,`test_generated_capture_uses_original_selected_snapshot_and_untouched_reader` 以真实 cscript 跑通生成脚本。**可关闭。** 3. **[P2] project_session 关闭等待可观察/可强制 — ✅ 已修复。** `project_session.py:122-124` 监听 `force_event` → `_abort.set()` 退出等待;每 15s 记录 `project_session_awaiting_close`。小建议(非阻断):force 分支 break 后仍会进入 `close_grace`(10–60s)等待,既然已确认强制,可把该路径 grace 缩短(如 5s)以更快交还上层 Job 收尾。 4. **[P3] 编码回退 — ✅ 已修复。** `_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 告警)。 - VBS SHA256:`QuickPartReplace.vbs` 未变(`7752FD937EF1513744F49B3A529DC075D4BD81AA743460254306FAA1BC385C92`,与 PR 描述一致);`NativeSnapshotReader.vbs` 更新为 `FBB7ADCE0E6905AF01B55F5D6F2F0E36A02E6CC8D79216FCC856D78606B9CDA5`。建议在 PR 描述/验收文档中同步该新哈希,便于核对冻结包。 - PR 描述与 `docs/testing/2026-10-31-pr9-latest-review-fix.md` 对本轮修复的描述与代码一致。 ### 未变化/遗留(非阻断) - 体积:现 78 文件 / +4587;docs 占比仍高(一次性验收记录与代码同 diff)。上轮体积审查的"合并前把 D 类验收文档拆为独立提交"建议仍适用。 - `_publish_progress` 静默吞写失败(保留节流 WARN)——设计权衡,维持 P3。 - 仍需 Windows 10 + 真实 DxDesigner 7.9.5 无 UID 工程现场验收(中央库/许可证/COM 注册/网络共享/企业策略)。 ### 结论 **P1/P2 均已闭环,代码、测试与文档一致,建议通过(Approve)。** 合并前剩余两件小事:(a) PR 描述同步 NativeSnapshotReader 新 SHA;(b) 可选的 force 路径 grace 缩短。现场验收仍是发版前置条件。
Author
Owner

再次复审(PR #9,head e5e628d)

Approve:当前未发现阻断合并的问题。

上轮结论已复核:

  • BatchCadRuntime 在 worker 启动前持久化当前 active_task/active_attempt,中断保护不会再依据陈旧任务漏标当前工程;成功工程后的下一工程异常不会错误进入历史 attempt 的无限等待。
  • 生成式 NativeSnapshotReader 已显式携带 QPLog 和 QPAppendAscii,不再依赖末尾空 stub;真实 cscript.exe 契约覆盖通过。
  • ProjectSessionWorker.close() 可观察等待状态并响应 StopControl.force_event;普通关闭仍不会自动强杀 CAD。
  • Windows stdout/stderr 解码已增加 UTF-8 → mbcs 回退。

本次独立验证:

  • python -m pytest -q tests/v1_1 --tb=short:967 passed,1 warning(既有 pywinauto STA 提示)。
  • 集成/VBS 相关测试:112 passed。
  • 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,head `e5e628d`) **Approve:当前未发现阻断合并的问题。** 上轮结论已复核: - `BatchCadRuntime` 在 worker 启动前持久化当前 `active_task`/`active_attempt`,中断保护不会再依据陈旧任务漏标当前工程;成功工程后的下一工程异常不会错误进入历史 attempt 的无限等待。 - 生成式 `NativeSnapshotReader` 已显式携带 `QPLog` 和 `QPAppendAscii`,不再依赖末尾空 stub;真实 `cscript.exe` 契约覆盖通过。 - `ProjectSessionWorker.close()` 可观察等待状态并响应 `StopControl.force_event`;普通关闭仍不会自动强杀 CAD。 - Windows stdout/stderr 解码已增加 UTF-8 → mbcs 回退。 本次独立验证: - `python -m pytest -q tests/v1_1 --tb=short`:**967 passed,1 warning**(既有 pywinauto STA 提示)。 - 集成/VBS 相关测试:**112 passed**。 - `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 描述执行。
abaishu0730 added 1 commit 2026-10-31 11:18:35 +08:00
abaishu0730 merged commit 2cf526e176 into main 2026-10-31 11:25:10 +08:00
Author
Owner

回审已合并 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:

if self.stop_requested and idle >= idle_timeout * 2:
    if not self.safe_stop:
        if not self.waiting_for_safe_completion:
            self.waiting_for_safe_completion = True
            return 'await_safe_completion'
        return None      # ← 之后永远是 None
    return 'unresponsive'

"不杀可能正在写的 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:

If ComponentMode Then
    RefdesKey = Trim(CStr(Comp.Refdes))
    If Len(RefdesKey) > 0 Then
        If SheetRefdes.Exists(RefdesKey) Then Err.Raise ... "duplicate component Refdes: " & RefdesKey
        SheetRefdes.Add RefdesKey, True
    End If
End If

本 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)

  1. session.json / cad_shutdown 缺失被当成正常(batch_supervisor.py:355-357 把 FileNotFoundError → {}),与"必须证明正常关闭"的语义不一致。
  2. 强制释放的回执只有 task 级清单,没有 per-refdes 的"哪些位号可能被写"清单,事故复盘时不够。
  3. protect_all_targets=True(:83/:113)会给已完成任务留下孤儿 uncertain.flag,与 has_interrupted 的判定不一致。
  4. UID 回退会全局关闭 native 读取(性能回退);单个组件 Refdes 读取失败会中止整个索引,建议降级为"该组件记为未知"。

做得好的地方

  • 真实进程用例质量高(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。
  • 未验证:真实 DxDesigner 795 上"同 sheet 多 slot 共享 Refdes"的合法性(依据 DxDesigner 语义推断);未审计该 PR 全部 78 文件。
# 回审已合并 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`: ```python if self.stop_requested and idle >= idle_timeout * 2: if not self.safe_stop: if not self.waiting_for_safe_completion: self.waiting_for_safe_completion = True return 'await_safe_completion' return None # ← 之后永远是 None return 'unresponsive' ``` "不杀可能正在写的 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`: ```vb If ComponentMode Then RefdesKey = Trim(CStr(Comp.Refdes)) If Len(RefdesKey) > 0 Then If SheetRefdes.Exists(RefdesKey) Then Err.Raise ... "duplicate component Refdes: " & RefdesKey SheetRefdes.Add RefdesKey, True End If End If ``` 本 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) 1. `session.json` / `cad_shutdown` **缺失**被当成正常(`batch_supervisor.py:355-357` 把 `FileNotFoundError` → `{}`),与"必须证明正常关闭"的语义不一致。 2. 强制释放的回执只有 task 级清单,没有 per-refdes 的"哪些位号可能被写"清单,事故复盘时不够。 3. `protect_all_targets=True`(`:83`/`:113`)会给已完成任务留下孤儿 `uncertain.flag`,与 `has_interrupted` 的判定不一致。 4. UID 回退会**全局关闭** native 读取(性能回退);单个组件 Refdes 读取失败会中止整个索引,建议降级为"该组件记为未知"。 ## 做得好的地方 - 真实进程用例质量高(`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。 - 未验证:真实 DxDesigner 795 上"同 sheet 多 slot 共享 Refdes"的合法性(依据 DxDesigner 语义推断);未审计该 PR 全部 78 文件。
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/dxdesigner-part-replacement#9