# 连续队列(1.0.0) ## 执行与提示 点击“连续执行队列”,确认剩余工程、规则和 Value 策略后,程序先只读枚举全部原理图页并固定清单,再按“工程 → 图页 → 规则”串行处理,不再每执行一项就等待再次点击。 - 旧 Part Number 未命中:黄色提示“未命中跳过”,不作替换,自动继续。未命中不等于替换成功。 - 旧器件命中:执行原生替换,恢复实例信息,保存并关闭工程,再重新打开核验;核验和关闭完成后才处理下一项。 - 目标器件不可用、Part Label 回读失败、保存或核验失败:记录工程、图页、位号和原因。当前独立工程任务在确认没有残留改动、资源已释放后暂缓本 CBB 余下项,继续后面的独立工程;保存、核验或资源状态不确定时停止整队并要求核验。 - 勾选“替换后将 Part Label 写入 Value”才额外改写 Value;未勾选不读取 Part Label,也不额外改写或创建 Value。旧 Value 已存在时,两种模式都继承其位置和显示样式。 - 旧 Value 含独立的 `/NC` 段时,两种模式都会把 `/NC` 同步到替换后的 Value 且不重复追加;目标没有 Value 时创建 `/NC` 并继承旧 Value 样式。日志按位号记录替换与同步;工程中的位号本来为空时改用稳定的 `UID=...`,不会输出无法追踪的空白标识。 ## 安全边界 连续模式支持多图页工程。每张图页都是独立、可恢复的队列项,快照、状态、暂停位置和错误均绑定到明确的原理图名及页号。图页清单在替换前固定;执行期间若新增、删除或重命名图页,程序会在下一次写入前停止,避免遗漏或处理错页。 程序不会接管已经手动打开的工程;请先自行保存需要保留的编辑并关闭工程。可以连接没有打开工程的 DxDesigner 会话,未运行时会自动启动。 每个工程只在其第一项实际替换前建立一次并校验原理图精简备份;已确认未命中的工程不会创建备份。同一工程的多个图页、多个规则,以及暂停后继续执行,均复用当前队列证据中的同一份备份,不重复复制。精简备份保留 `.prj`、`.dxp`、原理图数据库 `database/icdb.dat`、HDL、符号和相关配置,排除 `PCB`、`CES`、`ProjectBackup`、工程内 `backups`、日志目录及 `database/cdbsvr` 等运行生成内容。每份备份包含 `.dxpartreplace-backup.json`,记录文件范围、大小和 SHA-256。只读枚举完成后,程序会确认工程仍可安全处理,再在首次写入前备份命中工程;若工程在枚举期间发生变化,则停止而不猜测继续。发布版备份位于 EXE 同目录的 `data/quick-run/batch-backups/project-*`,当前队列完成或归档后随队列证据保留。 精简备份失败时默认停止,且尚未打开工程或执行替换。界面此时显示“忽略备份失败并继续”;只有再次确认工程已保存且另有独立副本后,才能对当前一次队列授权继续。程序仍会尝试备份其余工程,并把每个无备份继续的工程、原错误编号和“不可保证回滚”写入任务事件。该授权不保存为默认选项,下次执行仍恢复为备份失败即停止。备份不是自动回滚;不要通过删除保护文件绕过结果不确定状态。 同一时刻只打开一个工程,不同时堆积多个工程。为确认落盘,命中项有保存、关闭、回读核验的额外耗时。执行时不要手动切换或修改 CAD 工程;发现工程上下文变化时程序停止,而不是猜测继续。 “完成当前项后暂停”不会强行打断 CAD 写入;当前图页规则项完成后不启动下一项。再次确认可从记录的工程、图页和规则继续,不重复已完成页面。执行中关闭任务中心同样先请求安全暂停,需要等当前项结束后再关闭。 已经处理过步骤的队列在安全暂停或执行报错后会持久保存“已暂停”状态,不再留在“运行中”阻止正常管理。暂停任务可移至“已删除”并恢复;恢复后重新确认,从下一项继续。任务进入“已删除”后也可直接彻底删除任务记录,不受队列执行锁限制;工程文件、诊断日志和执行证据仍保留。 自动队列不允许混用人工流程的采集、跳过、重试或继续操作。执行期间锁定队列输入;本轮结束且存在失败项时,任务保留在“进行中”,可修改规则、Value/NC 选项和工程勾选后点击“重试失败项”。重试队列不重复处理已成功工程。 历史结果会区分“已保存”和“尚未确认保存”,全未命中的工程显示“未命中跳过”。日志中的 WARNING 是提示级别,不再作为自动停止条件;是否停止由实际执行状态决定。 进度展示文件被短暂占用时,不会中断实际执行;监控仍在内存中检查相关联的有效进度。控制握手或实际监控故障仍会停止并保留待核验保护,错误提示不再将这些故障一律伪装成超时。 ## 长期运行保留策略 `quick-run\quick-part-replace.log` 超过 5 MiB 后保留 3 个轮转备份,单个任务的 `events.jsonl` 超过 5 MiB 后保留 5 个轮转备份。`quick-run-history` 只清理由程序生成且名称可验证的 `batch-*`、`recovery-*`、`sheet-discovery-*` 和 `obsolete-*` 目录;未知目录、链接目录和当前活动的 `quick-run` 证据不会删除。 历史清理在新的准备、批量或恢复操作进入互斥执行区后运行。默认至少保留最新 10 份历史;其余记录在超过 30 天、总数超过 100 份或总容量超过 5 GiB 时从最旧开始删除。由于最近 10 份始终保留,单个超大工程可能使实际容量暂时高于 5 GiB,此时应人工转存需要长期留档的证据。 ## 操作历史与逐项续跑 详见[操作历史与继续执行](operation-history.md):搜索及清空历史不会重置完成回执;同一 CBB 部分成功后的失败项重试会保留成功项。