7.0 KiB
DxPartReplace 器件批量替换
本工具用于 DxDesigner 7.9.5 工程的器件批量替换。正式桌面流程在任何写入前创建并校验原理图精简备份,按“工程 → 图页 → 规则”严格串行执行;不会并发打开或同时修改多个工程。精简备份不复制 PCB、CES 日志、历史工程备份和数据库运行日志。桌面程序、人工证据流程和原批处理 CLI 是三条不同路径,工作范围和安全保障不能混用。
启动与诊断位置
双击发布目录中的 DxPartReplace.exe。发布版默认把数据放在 EXE 同目录的 data 子目录:任务数据库是 data\task-center.db,应用日志是 data\logs\application.log,任务事件和证据位于 data\tasks\<任务ID>,桌面自动替换的共享交接文件位于 data\quick-run。更新程序时只替换 EXE 和 _internal,不要删除 data;向其他人分发时使用未运行过的干净发布包,不要把包含工程备份的本机 data 一起外发。源码开发运行仍默认使用 %LOCALAPPDATA%\DxProductivity\trial-task-center。
发生错误时保留目标工程和整个数据目录,至少提供 application.log、对应任务的 events.jsonl、quick-run\quick-part-replace.log、command.tsv、status.tsv、快照和原生 helper 报告。成功日志按替换前快照中的位号列出每个器件;原工程未标注位号时使用 UID=... 作为稳定标识。出现“结果无法确认”或已有待处理替换时,不要反复点击,也不要切换到其他工程后继续;先人工核对当前图页是否已被修改。
桌面一键自动替换
这是真正执行写操作的主界面路径。连续队列会先逐工程校验并备份,再只读枚举每个 .prj 的全部原理图页和待替换旧料号;全部清单固定后,将每个“工程 × 图页 × 规则”作为独立队列项串行处理。只读枚举已经确认未命中的项直接完成,不再为了同一结论第二次打开工程;命中的项仍进入完整替换、保存和回读流程。任务输入禁止链式映射,因此不会出现前序规则在执行中生成另一个规则源料号的歧义。
- 新建任务,选择 DxDesigner 工程目录并扫描;勾选要进入队列的
.prj。 - 添加旧料号到新料号的映射。新料号必须能从当前 DxDesigner 所连接的中央库中查询到。
- 请先保存并关闭已有 DxDesigner 工程。程序可复用一个空会话或自动启动 DxDesigner,但不会接管用户已经打开的工程。
- 点击 连续执行队列 并确认。程序逐个创建和校验原理图精简备份并只读枚举图页;全部图页清单固定后,才逐页执行原生 Replace Part、Library Wins、实例参数恢复、连接校验、保存关闭和重新打开回读。
- 当前页未命中或普通替换失败时记录结果并继续。状态不确定、工程关闭失败或队列文件异常时停止。暂停发生在完整图页规则项收尾后,恢复时不重复已完成页面。
- “全工程图页队列完成”表示所有已枚举图页和规则都得到已保存通过或未命中结果;它仍不表示已通过 Packager、ERC、网表或其他外部工程检查。
如果精简备份失败,队列默认在写入前停止,并显示“忽略备份失败并继续”。该按钮仅授权当前一次队列;确认后,备份失败的工程无法保证从本工具备份回滚,程序会在任务日志中记录警告。只有已经保存工程且另有独立副本时才应使用。下次执行仍恢复为备份失败即停止。
目录输入发生变化时,工程表会立即清空并要求重新扫描。尚未开始执行的任务会用新目录扫描结果整体替换旧清单,不继承旧目录的勾选状态;同一目录重扫仍保留已有选择,并把本次缺失的项目标记为不可用。任务一旦存在执行状态、尝试记录、恢复记录或自动队列证据,就不能在同一任务中切换目录,应新建任务,避免把两个目录的执行证据混在一起。
执行时界面会锁定删除、工程选择、扫描和规则修改,并显示当前工程、图页、规则、已完成项数和运行时长。队列运行中不能修改输入。存在失败项时任务保留在“进行中”,用户可调整选项并只重试失败工程;全部选中工程成功或未命中后才进入“已完成”。
错误提示会显示具体原因、当前工程、规则和错误编号。需要排查时检查 data\quick-run 和对应任务目录;写入状态无法确认时先核对当前图页。
长期运行时,快速替换日志和任务事件日志会按 5 MiB 轮转;历史证据默认至少保留最新 10 份,并按 30 天、100 份和 5 GiB 上限清理最旧的程序生成目录。需要永久留档的批次应及时复制到任务数据目录之外;当前活动证据、未知目录和链接目录不会被自动清理。
自动替换要求目标中央库可用。没有中央库的机器可以运行单元测试、UI 测试、构建和 EXE 冒烟测试,但不能证明真实目标库元件替换成功,也不能完成现场联调验收。
参数继承边界
桌面流程在替换前记录实例状态,并在原生替换后恢复应由原实例保留的放置和显示参数;目标符号、库控制属性和库引脚名称仍以 Library Wins 为准。连接、引脚号、坐标或受保护实例状态发生不允许的变化时,流程必须失败,不能仅以新 Part Number 已出现判定成功。
连续队列的通过项会自动保存、关闭并重新打开回读;人工证据流程仍不自动保存。失败后的 Undo 只允许在作业记录的工程和图页上下文仍精确匹配时执行;上下文已变化时会阻断,而不会对当前未知工程强制撤销。
人工证据流程
界面中保留的 启动任务 / Capture Before / Capture After / Retry 属于 TrialRunner 人工证据流程,不是桌面一键自动替换的第二阶段。
- 启动任务并对当前项目执行 Capture Before。
- 由操作员在 DxDesigner 中完成受控替换,不保存。
- 执行 Capture After;工具重新打开并校验已保存的 before 证据哈希,再比较前后完整证据。
- 通过时项目进入 Completed;失败时保留证据并从新的 Capture Before 重试。
该流程用于采集和比较证据,不继承桌面 quick-run 的自动写入承诺。
原批处理 CLI
Start-PartReplacement.ps1 和 BatchController 是面向完整项目批次的独立流程,包含不可变输入、全项目库存、映射认证、关闭后备份、逐规则替换、受控保存、恢复以及外部检查门禁。它要求现场验收过的兼容性配置和中央库,详细操作见 DxDesigner 7.9.5 元件替换操作指南。
不要把桌面 quick-run 的“当前队列已完成”当作批处理 CLI 的 verified_saved,也不要把人工 Capture Before/After 的比较结果当作已经备份、保存或通过外部检查。