4.6 KiB
停止、强制结束与恢复
执行期间点击“完成当前项后暂停”,程序不再启动下一替换项。已经进入修改或保存的当前项会继续完成必要校验、保存、重开回读和工程关闭,然后正常退出 CAD,并等待自有辅助进程收尾。关闭主窗口也遵循这个流程,操作仍在进行时窗口保持打开。
“当前项”是当前图页和替换规则对应的执行单元,不是整个工程或整个批次。已经保存核验的结果保留,未开始的任务保持未执行。
保存或修改长时间没有进度
有写入可能的阶段,程序不会仅因超过无进度时限就自动终止应用。界面显示保存或核验尚未确认,可以继续等待并导出诊断包。等待不会启动下一项,也不会自动清除保护记录。
如果操作已经失败且保存结果不确定,程序保留当前应用和工程现场,不再自动保存或丢弃。应先导出诊断、保留原始工程与备份,再决定是否需要强制结束。此时“继续等待”不表示自动恢复执行。
纯读取的 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、保存回读和保护记录仍是执行/恢复的依据。辅助日志写入失败不会覆盖已经提交的业务结果。若强制结束后的确认记录写入失败,仍显示资源/记录待处理并保留强制结束事实,不能直接开始下一次替换。
诊断包会包含上述文件,并沿用账号、令牌与用户目录脱敏规则。原始工程和库文件不会随诊断包导出。