Files
dxdesigner-part-replacement/docs/testing/2026-10-26-safe-stop-acceptance.md
T

5.8 KiB
Raw Blame History

用户停止与安全收尾实施验收

日期:2026-10-26;分支:codex/day0-safe-stop。实现用户在本会话批准的停止流程,对应全链路调查。

实现行为

  • 普通暂停和关闭窗口不启动下一项,当前写入、保存和回读安全完成后停止。当前项并不等于整个工程。
  • 有写入可能的阶段长期没有进度时显示等待,不自动把超时升级成杀进程。纯只读采集保留有界取消。
  • 写入失败、保存结果不确定或 Quit 被拒绝/超时且 CAD 仍存活时,交互执行保留应用与工程,等待处理,不自动保存或丢弃。
  • “强制结束…”独立确认;先持久化业务保护及批次中断证据,再终止明确自有的监督进程及 Job。证据写入或 fsync 失败时拒绝该次 force,界面保留重试能力。
  • 保存请求、保存调用返回、保存回读和工程关闭分别记录,工程关闭失败不会丢失此前保存边界。
  • 收尾记录写入失败不跳过满足身份检查的正常 Quit。主进程自然退出后给予自有后代 2 秒自然退出窗口,之后的强制清理单独记录。
  • 资源消失不吞掉异常退出;调用方收到独立收尾错误,已核验业务结果仍附带保留。
  • 等待期间可独立导出诊断包。关闭窗口在操作结束前不退出;失败/强制结束后取消自动关闭,保留恢复提示。

自动验证与审查

针对安全边界先运行失败用例再实现,包括慢保存不会被 watchdog 终止、明确 force 的保护先行、保护写入失败保留进程、已有文件也重新 fsync、保存后工程关闭拒绝、窗口关闭不触发 force、确认取消无副作用。

真实辅助进程测试覆盖监督子进程强制中断、控制回调异常时保持子进程存活、拒绝第一次保护写入后仍允许后续明确重试、资源清理不重放业务。CAD 调用在这些故障测试中使用替身,不能据此声称真实保存中断无损。

退出协议独立审查修复了部分子进程查询失败时丢失已知强制终止 PID 的问题。整体验证另外修复:只读入口没有 force 出口却进入无限等待、证据首次 fsync 失败后因文件存在被误放行、已执行 force 被诊断异常降级为普通停止、控制通信异常绕过确认清理、直接执行 force 失败没有反馈,以及 force 意图与监控异常并发的竞态。复审未发现新增阻断问题。

首次完整实现回归 1063 passed,1 条既有 pywinauto STA 警告,363.82 秒。之后完成审查修正,最终扩大回归 1147 passed,1 条既有 pywinauto STA 警告,325.64 秒:

python -m pytest -q tests/v1_1 tests/trial_task_center/test_application.py tests/trial_task_center/test_execution_safety.py tests/part_replace/test_verification.py tests/integration/test_quick_value_modes.py tests/integration/test_quick_session_startup.py tests/integration/test_quick_part_replace_contract.py tests/integration/test_automatic_replacement_regression.py tests/trial_task_center/test_worker_monitor.py tests/trial_task_center/test_batch.py

本命令包含项目发布脚本要求的源码测试范围,并补充此次受影响的 VBS、worker monitor 与批次测试。git diff --check 与新探针/停止模块语法检查通过。

两个旧 VBS fixture 在基线 b939101 也失败:未填 owned project path 且错误期望 no-match 保存、图页清单断言未使用规范化路径。修正的是 fixture 和断言,没有放宽生产所有权或保存规则;脚本契约组 72 项通过。

真实保存期间请求普通停止

工具:probe_safe_stop_live.py。本轮输出为 build/safe-stop-live-a9113545bf/,报告 report.json,最终资源复核 final-resource-check.json。

入口为源码 supervised service → 真实独立 batch worker → 生产 VBS → 真实 CAD,使用两份全新 Audio_D2128/Audio_T605A 副本。监听第一工程的生产 save_requested 日志后只设置普通停止 Event,不设置 force。此触发处于保存请求附近,不能声称精确暂停在 COM 内某一条指令。

检查 结果
第一个工程 当前 RV05 替换、保存和回读完成,任务 completed
第二个工程 保持 pending,没有继续替换
队列 paused=true,未请求强制结束
第一工程新 CAD 独立读回 57 器件、103 引脚连接;目标 RV05 为新料号,56 个非目标器件保持;目标身份、位置和连接保持
第二工程新 CAD 独立读回 57 个器件的完整属性及连接图与执行前一致
执行批次退出 orderly_shutdown=true、clean=true、forced_termination=false
资源 资源记录全部 released,最终枚举确认其桌面消失,没有本轮残留 CAD
原件 两个源工程目录哈希不变,中央库 .lmc 哈希不变

没有重放任何已经完成的替换;测试用的 before/after 独立读取使用新 CAD 实例。

边界

本轮没有构建或发布新 EXE,未做完整冻结 GUI 的保存中强制结束、掉电或原工单全量现场复测。GUI 行为使用 Qt 测试验证,真实保存停止使用源码监督入口验证;二者不能混写为冻结 GUI 全流程验收。

强制结束为避免切换任务竞态,保守标记本批可能涉及的目标;已完成业务证据和结果保留,但先前已完成任务也可能需要恢复核验。不能清除保护来继续。

保持应用等待不代表保存结果一定可以恢复。外部任务管理器强杀/系统掉电没有安全收尾保证,重启必须依赖原先写前证据核验。工单现场具体桌面持有者仍未查明,本实现不能当作现场根因已经闭环。