# 停止、强制结束与恢复 执行期间点击“完成当前项后暂停”,程序不再启动下一替换项。已经进入修改或保存的当前项会继续完成必要校验、保存、重开回读和工程关闭,然后正常退出 CAD,并等待自有辅助进程收尾。关闭主窗口也遵循这个流程,操作仍在进行时窗口保持打开。 “当前项”是当前图页和替换规则对应的执行单元,不是整个工程或整个批次。已经保存核验的结果保留,未开始的任务保持未执行。 ## 保存或修改长时间没有进度 有写入可能的阶段,程序先请求停止并等待安全边界。默认从最后一次业务进度起计时:150 秒无进展时请求停止,300 秒仍无进展时进入安全完成等待,再经过 30 秒仍无进展则触发失败自动回收。阶段或完成数量等实际进度变化会重新计时,只有心跳不会延长等待;这不是整个任务的总时限。等待期间不会启动下一项。 执行错误需要释放 Mentor 时,程序先持久化结果不确定的保护记录,再进入自有进程的释放流程;正常退出失败时可能强制结束自有进程。只有确认相关进程退出后才释放私有桌面,不处理用户自行打开的 Mentor。保护记录无法可靠保存时保留资源等待处理,并显示原因。 资源释放不等于工程回滚或替换成功,关闭时仍可能落盘。结果不确定的任务必须先“核验并恢复”,已保存核验的项目不会自动重放。Mentor 退出助手另有独立的 20 秒等待时限,不能与上述停滞时限混淆;本版该退出超时仍待实机复核。 纯读取的 BOM/库存采集仍采用有界取消;不存在写入需要完成时,不要求用户无限等待。确认未修改的启动失败也保留既有有界停止机制。 ## 明确选择强制结束 “强制结束…”与普通暂停分开。确认框明确提示:当前操作可能正在修改或保存,强制结束可能留下未保存或部分保存结果,之后必须先核验恢复。 确认后,程序先持久化中断保护和批次记录,再终止自己拥有的监督进程及 Job。保护记录无法可靠保存时,不执行这次强制结束,界面提示原因并允许重试或导出诊断。取消确认没有终止副作用。 为避免强制请求与工程切换同时发生而漏记目标,强制结束会保守保护本批可能涉及的任务。先前已保存结果不会被覆盖或重放,但这些任务也可能显示需复核或被保留在当前列表。不要删除保护文件绕过核验。 ## 程序重启之后 - 资源复核只处理进程和桌面状态,不重新替换。 - 结果不确定的任务必须使用“核验并恢复”,按照已有快照和当前实际工程核对。 - 已保存核验结果继续保留;资源清理成功不自动解除业务保护,也不自动继续队列。 - 如果应用没有正常退出或后代进程需要强制清理,会单独报告收尾异常,不能把“资源已释放”理解为“保存和退出均正常”。 任务管理器强杀、系统关机或掉电可能不给程序写最终日志的机会。这些情况依赖修改前已经落盘的证据及下次启动的中断核验;程序不能保证被外部强杀时完成当前保存。 ## 后台进程启动或结果异常 `worker_start_failed` 表示后台进程未成功启动。`worker_result_missing` 表示进程已退出但没有可信的最终结果;`worker_result_invalid` 表示结果损坏或身份校验未通过。退出码为 0 也不能代替业务结果和保存核验。 出现结果缺失或无效时,先导出诊断包;若显示资源待处理,先点“重新清理资源”,再对结果不确定的任务使用“核验并恢复”。清理不会重复替换,也不会清除工程保护。`interruption_protection_failed` 表示连中断保护也未能写入,请保留现场、日志和备份,不要删除批次记录绕过阻断。 如果采集到的器件 UID 为空、位号为空或 UID 重复,工具会在读取快照和当前 CAD 页时立即停止,报告目标身份不完整,并保留诊断记录。此类器件不会进入替换选择或等待回读循环;修正工程身份后应重新采集和生成计划。不要把空 UID 当作可重复使用的匹配键。 每个批次的 `data/batch-resources/<批次ID>/` 增加以下诊断文件: - `lifecycle.jsonl`:启动、业务开始/结束、资源收尾和最终结果提交的阶段记录。 - `process.json`:监督进程退出码、stdout/stderr 各自最多 64 KiB 的 UTF-8 尾部、最后协议消息和自有 Job 的释放记录。 - `supervisor.json` 中的 `force_state`:记录强制结束是否完成保护、是否已请求终止、退出确认是否完成。 阶段日志是辅助诊断;最终 `result.json`、保存回读和保护记录仍是执行/恢复的依据。辅助日志写入失败不会覆盖已经提交的业务结果。若强制结束后的确认记录写入失败,仍显示资源/记录待处理并保留强制结束事实,不能直接开始下一次替换。 诊断包会包含上述文件,并沿用账号、令牌与用户目录脱敏规则。原始工程和库文件不会随诊断包导出。