Files
dxdesigner-part-replacement/docs/user/continuous-queue.md
阿白叔 cf90ced825
Core regression / Python core and release configuration (push) Successful in 17s
Core regression / JavaScript syntax (push) Successful in 3s
Core regression / Python core and release configuration (pull_request) Successful in 16s
Core regression / JavaScript syntax (pull_request) Successful in 3s
feat-ui-operation-history-and-durable-execution
2026-11-03 17:54:17 +08:00

44 lines
6.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 连续队列(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 部分成功后的失败项重试会保留成功项。