Files
dxdesigner-part-replacement/docs/testing/2026-10-21-batch-private-runtime.md
T

9.8 KiB
Raw Blame History

批次私有桌面复用与安全重建验收

本次仅更新源码和 Git,不修改 V1.1.3 发布包。实施基线为 e15ee25。

已实施的边界

一次 BOM 导入、一次顺序执行分别拥有一个 BatchCadRuntime。库存缓存全部命中时不创建 Windows 资源;原生 CLI 共用批次桌面,各自进程及 Job 及时回收。需要 CAD 时才启动,同批工程串行复用该实例。工程之间由独立子进程核对桌面、CAD GUID/PID 和活动工程路径为空;每个工程使用新的 VBS 工作进程,组件、引脚及库查询缓存不跨工程传递。原有保存、关闭、重开回读继续执行。

批次标识、代次、工程/任务/作业和尝试标识保存在独立 JSON 旁文件中,旧 BOM、TSV 和已保存任务格式保持兼容。启动下一次工作前先作废该证据目录的旧关闭证明。监控消息有自己的随机标识,旧代次的资源租约不能启动新进程或把迟到关闭结果登记为新代次。

原生写入、恢复属性及保存之前,工作进程先验证完整尝试身份并持久化 mutation_possible。落盘失败禁止调用写入。修改前自动重试仅一次,还要求整个工程此前所有作业都处于 prepared、身份匹配、状态文件未改变、工程完整指纹一致且旧资源已确认释放。当前未把“数据库文件单独变化”视为自动重试许可;缺少独立身份等价证据时保守停止。明确确认的恢复操作不自动重试。

原生 CLI 仅操作临时数据库副本。启动失败、超时或特定崩溃的重试还要核对当前租约已经关闭、当前批次/代次/尝试一致,以及源 PRJ/数据库 SHA256 未变化。普通表格、匹配、解析和封装错误不触发桌面重建。

原生会话重试耗尽或预算拒绝时停止整批,不能再回退 CAD 绕过异常。该分支在实机正常路径验收后新增四项异常注入并修复,普通非零退出与格式不支持的兼容回退保留。

身份冲突单独分类:bootstrap、空工程检查点的绑定损坏/不一致,以及旧 VBS 明确报告的私有 CAD GUID 冲突,都不会被归入普通启动未就绪而自动重建。子进程用专用退出码保留该类别,异常包裹也保留不可重试的原因。

每个成功释放的代次另外保存在 generation_releases,含桌面、CAD PID/GUID、清理证明与释放时间。重建不会覆盖旧代次的释放证据;发布失败后重新检查也不会重复追加成功记录。

资源清理与 Windows 契约

  • CloseDesktop:关闭自有句柄与确认桌面对象消失分开检查。仍有外部引用时不创建更多桌面绕过问题。
  • Job Objects:工作进程和后代位于自有 Job;正常退出优先,必要终止限定于自有进程及 Job。
  • TerminateProcess:终止请求后等待实际退出,随后回收句柄。
  • 监督进程不连接 CAD COM,不调用 SwitchDesktop。工作进程通过 STARTUPINFO.lpDesktop 启动;不改变用户输入桌面。

batch-resources/<批次>/session.json 保存生命周期、进程创建时间、工程关闭证明、重建原因和耗时。批末清理失败独立报告“资源释放待处理”,保留已核验任务状态,阻止后续 CAD 入口。界面提供“重新清理资源”,仅清理/重新检查资源,不重放替换。BOM 错误仍保留逐行诊断,但移除可应用的预览。

应用重启后只能重新确认已记录进程和桌面消失;不会根据旧 PID 终止新进程、接管 COM 或自动解除历史工程保护锁。损坏或未知格式的所有权记录保持阻塞,不能把缺失进程列表解释成没有资源。清理过程中即使日志写入失败也继续回收自有资源;释放记录发布失败可再次检查并落盘。取消请求不能覆盖清理失败。

残留时保留窗口 PID/TID/类和查询错误,进一步线程诊断见Windows 桌面研究。没有查询到窗口或线程,不等于不存在外部句柄持有者。

新增真实 Windows 对象寿命回归:测试自己的独立进程连接批次桌面,批次清理确实进入 blocked 并保留 completed_result;该外部进程仍存活、用户输入桌面不变,也没有生成工程 uncertain.flag。测试关闭自己拥有的独立进程后,资源入口确认 released,generation 仍为 1,没有创建新桌面或重放任务。

回归范围

针对性注入包含:惰性零启动、多工程一个 CAD、关闭证明作废、一次重建和第二次失败、修改后禁止重放、写前记录失败、任务边界暂停竞争、资源清理失败优先、释放日志发布失败后重新检查、损坏记录、跨重启检查、旧代次租约及检查点拒绝。独立审查发现的关闭证明过期、重复退出首次启动失败实例、独立服务入口绕过门禁、BOM 清理失败丢报告、损坏资源记录误解除等问题均已修复。

全量检查发现一个基线已有的取消测试:假执行器仅声明清理完成,却没有写出必要的释放证据。已在原基线隔离复现,并修正测试的释放证据,生产校验条件没有放宽。

扩展旧版本回归还发现两处既有边界:旧队列冻结 Value 策略发生冲突时,原先会先访问工程进行备份,导致真正的冲突被路径错误覆盖。现在以只读检查先拒绝冲突,断言拒绝前不备份、不启动 CAD、证据不变;备份仍先于 CAD 采集。千步骤模拟测试的固定 30 秒限制在基线也失败(41.83 秒,峰值 2.35 MiB),改为直接约束命令/状态全量解析各不超过两次,保留正确性、128 MiB 内存上限及实际耗时记录,没有调高秒数来掩盖回归。

最终统一执行 python -m pytest tests/v1_1 tests/trial_task_center -q --basetemp=build/pytest-batch-final-20261021:1104 passed、1 failed,327.33 秒。唯一失败是旧测试要求工作进程路径与长路径字符串逐字相等;本次把证据目录放到较长的 build 路径后,合法的 Windows 短路径触发该断言。生产传参指向正确文件,未改生产代码;将测试改为核对 canonical 文件/目录身份并继续严格核对其余参数,整个 test_quick_run.py 在同样较长路径下复测 34 passed。两次执行合计覆盖全部 1105 个不同用例,没有未修复的失败;未为测试断言修改重复执行已成功的真实替换。

最终千步骤模拟指标:20 个工程 × 5 张图页 × 10 条规则,91 保存、909 未命中,全部作业唯一;32.147 秒、峰值 2.05 MiB,命令及状态全量解析各 1 次。这是注入工作进程的控制层压力测试,不能作为实际 CAD 替换吞吐量。

实机与工单范围

实机验收仅对两个全新工程副本进行;源工程、中心库和原始工单附件不修改。分别核对 BOM 导入、替换、保存重开、独立回读、全部非目标元件属性与引脚连接、最终资源释放及原输入桌面。性能按相同样例对照单次运行,不代表大规模实机稳定性或固定加速比例。

工单只有六个工程有完整已捕获原生库存,回放与真实 CAD 验收分别报告,不能据此宣称全部 102 个工程均已实机通过。用户机器的桌面残留根因尚未在本机复现,本次减少重复创建/释放并补齐恢复边界,没有宣称根因已根治。

两工程实机对照

完整过程与复现命令见实机对照报告。计时只包含 BOM 导入和顺序执行,不包含独立检查器额外打开 CAD 的时间。

指标 基线 候选
BOM 导入 2.250 秒 3.187 秒
替换、保存回读、执行收尾 168.610 秒 148.672 秒
上述总耗时 170.860 秒 151.859 秒
私有桌面创建 6 2
CAD 启动 2 1

本次样例节省 19.001 秒(11.12%),BOM 阶段单次测量略慢。两个工程各保持 57 个组件、103 个引脚连接,56 个非目标组件全部属性及连接不变;两版本独立回读的完整结果一致。只有 RV05 更换到目标料号,RV11 保持旧料号。批次均记录 released,未自动重试,输入桌面未切换,源工程和中心库 .lmc 哈希不变。

正常替换验收之后,最终异常分类及释放历史补丁 a8358d9 又做了一次空 CAD 实机冒烟:probe、空工程 checkpoint、quit 全部通过,退出码均为 0,批次 released、pending 为空,CAD/桌面消失,输入桌面仍为 Default。该次实测 59.281 秒,没有打开任何工程,也没有重复替换。证据在工作树 build/batch-runtime-idle-smoke-20261021-final。

工单只读回放

使用回放工具复制工单任务库到新的 build 目录,再通过最新 inspect_batch 回放完整库存覆盖的原 Excel 行,保留原行号与工程归属。

项目 结果
工单原始范围 428 个任务;763 行,其中 437 条替换行、102 个工程
已捕获完整库存 8 份报告、6 个工程,覆盖 31 条替换行
最新逐行结果 20 通过、11 失败,工程/Excel 行号/状态与原报告一致
失败行 Excel 3、4、6、7、11、12、13、16–19 行
回放副作用 0 CAD/桌面/进程创建,0 目标计划写入,复制数据库未变化
原证据 ZIP、BOM、原生库存哈希不变
未回放 406 条替换行、96 个工程,没有相应完整已捕获库存

完整本机回放证据位于原仓库 build/issue-1-batch-runtime-replay-final-20261021。这些是报告回放,不能代替对应用户工程的实际替换验收。