Files

65 lines
9.3 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.
# DxPartReplace V1.1.3 中文使用说明
保留原有任务视图和料号规则编辑,支持按工程拆分任务、按位号选择替换目标及可选 Excel 操作。
第一次使用请先看 [README 逐步图文教程](../../README.md#图文教程),按截图完成创建任务、BOM、替换和结果查看。以下内容用于补充查询各项规则。
## 日常流程
1. 点击“新建”,填写或选择根目录,点击“读取工程”。勾选要处理的 `.prj` 后创建任务,每个工程对应一个任务。已存在未完成任务的工程不会重复创建。
2. 在任务详情的“料号规则”页填写旧料号、新料号。新建任务只绑定一个工程;历史多工程任务仅供查看。
3. 打开“位号计划”,点击“采集所有匹配位号”。采集读取工程中的器件 UID、位号、图页、旧料号和原 Value,不保存工程。
4. 在表格中勾选需要替换的位号,其余行保持不勾选。查找框支持位号、UID、图页、料号和 Value,查找只过滤当前显示,不删除计划行。可逐行填写不同新料号、自定义 Value 和“同步 NC”,也可对可见行批量填写新料号。采集后的位号默认保留,避免误替换。
5. 点击“保存位号计划”。有未保存的编辑时无法执行;切换任务会保留编辑草稿。重新采集会核对工程身份并保留已保存计划;有未保存编辑时会提示丢弃草稿。
6. 点击“执行当前任务”只处理当前绑定工程,或点击“顺序执行本批任务”按任务顺序处理同批工程。上下移动按钮调整顺序。每次仅处理一个工程,暂停在当前步骤收尾后生效。
执行状态、失败重试和中断核验集中在底部操作区。界面不再维护当前任务的工程选择列表,避免工程范围和按钮范围混淆。
## 执行日志与修改明细
任务执行结束或暂停后,可以在“替换结果 / 日志”窗口查看修改明细。每个完成步骤按位号列出旧、新物料号,例如:`图页 MAIN:1 · 已保存并核验 · 位号 R1:4100-CA0000-T7 → 4100-CA0000-T0`;识别到 NC 并同步时另列说明。未命中、失败和保存后待核验分别显示状态,不计为成功修改。
明细来自执行器实际回读结果,不以勾选计划代替执行结果。同一工程的不同图页、规则分别保留记录;重新打开已完成任务时保留计划工作区,点击“替换结果 / 日志”按需查看。日志每页读取 200 条事件,可用“上一页日志”和“最新日志”翻页,包括保留的轮转记录;结果表最多显示当前页最近 500 条位号回读记录。详情窗口关闭后释放,重新打开读取最新页。历史版本未记录的中间步骤无法事后补全。
执行日志同时记录采集、图页枚举及队列准备、工程备份、每个“图页 × 规则”步骤、进度同步和任务合计的耗时及速率。一个步骤可能修改多个位号,步骤速率不等于器件替换速率;失败或暂停不会计为成功完成的任务。执行器的进度阶段耗时随该步骤证据保留,用于区分打开工程、原生替换、属性恢复、保存与回读的时间。任务合计包含子步骤,统计时不能重复相加。
## 可选 Excel 操作
无需导出也能完成全部编辑。读取工程创建任务后,点击“BOM 模板”会生成同批所有工程的一张表:工程名称和工程路径自动填写,每个工程预留一行,旧料号、新料号和位号留空,不要求先采集或填写规则。需要同一工程多条替换时复制该工程行;工程路径用于唯一分配任务,应保持原样。发布附件另提供通用空表;已创建任务时优先使用工具生成的本批模板。
表头批注包含中文填写说明,一行可以填写多个位号(逗号、分号、空格或顿号分隔),并填写替换开关、Value 和同步 NC。只填写工程信息的空白行会被忽略,未填写替换行的工程保留原计划。需要导出已采集的完整数据时,保存编辑后使用“导出位号计划”。
导入先核对所有工程归属,再按工程匹配位号;缺少清单时,按该工程 BOM 中的旧料号只读采集。不会执行替换。切换任务可查看、编辑各自预览,点击“保存本批位号计划”才一次写入所有受影响任务。保存失败全部回滚,预览期间不改已保存计划。工程、图页、UID、位号、旧料号及原 Value 用于身份校验,未知工程、重复器件或跨工程目标都会拒绝;不接受公式。布尔选项可使用 TRUE/FALSE 或 是/否。
V1.1.3 已包含原生采集:本机有兼容的 `icdb2ascii.exe` 时,BOM 校验和位号采集优先在临时数据库副本中一次导出真实 UID、位号及物料属性,不必逐条启动 CAD 查找。工具不可用或报告不受支持且已安全清理时,自动使用原 CAD 采集。源工程变化或后台清理不确定时停止并保留诊断;完整图页查询和实际替换仍沿用原执行链。运行前请保存并关闭目标工程。详情见 [原生采集接入记录](../research/2026-10-16-native-cli-integration.md)。
首次采集中未被 BOM 列为替换目标的位号默认“不替换”;已有计划中未列出的行保留原勾选和编辑状态,不会因后续 BOM 省略而自动停用。如果本次仅执行 BOM 列出的目标,请在预览中检查并取消其他启用行,或在 BOM 中显式填写对应的 `enabled=FALSE` 行。每个填写的位号须在当前工程清单中唯一匹配;同名位号跨图页时应填写图页或 UID。导入失败不会改变已保存计划。
“同步 NC”默认勾选,可以按行关闭;仅按原规则识别独立 `/NC` 标记。Value 复制选项和每行自定义 Value 延续原工具的处理方式。替换计划不允许旧、新料号相同,也不允许同批链式或循环替换。
## 保存、恢复及旧任务
执行前保留原工具的备份流程,替换后保存、关闭并重新打开核验。执行证据按任务存放。目标 UID、位号、原 Value 或旧料号变化时会停止校验,绝不会退回替换全部同料号器件。保存结果不确定时停止队列,先使用核验恢复入口处理。
旧数据库自动升级并保留任务、状态、规则。未采集位号计划的历史任务沿用旧流程;采集后,即使没有勾选位号,也不会触发全量替换。建议首次使用新版本前自行复制原工具的 data 文件夹;不同版本不要同时打开同一数据目录。
## 验证范围
快速测试覆盖任务拆分、SQLite 迁移、位号筛选、Excel 往返、串行调度和界面编辑;发布构建另检查执行保护及冻结程序启动。测试不会修改生产 CAD 工程。
本机 7.9.5 的真实 TypeLib 没有可直接调用的 ReplacePart 方法,生产替换仍沿用原生对话框及 Library Wins。详见 `docs/research/v1.1.0-native-interface-probe.md`。实际中央库、器件替换和保存回读仍需用工程副本现场验收。
## 后台运行与释放(1.1.1)
任务中心的自动采集、替换和中断核验恢复已默认接入私有 Windows 桌面。工具显式启动并持有自己的 CAD,通过私有桌面、会话 GUID 和活动图页窗口所属 PID 校验连接,不接管主桌面已有 CAD,也不自动退回主桌面执行。
主桌面可以继续查看其他文件。开始前仍须保存并关闭本次目标工程,运行中不要在其他软件内打开或修改同一工程;共享的许可证、CPU、磁盘和中央库资源仍会影响速度。本机不同轮次的私有 CAD 启动约 22~67 秒,也曾出现启动阻塞;1.1.2 的启动等待有 120 秒上限和取消检查,超时后收尾并保留诊断,不把增加等待上限视为已修复阻塞根因。
同一工程连续步骤复用后台会话,任务仍顺序执行。界面显示“启动后台 CAD”和“关闭 CAD 并释放后台会话”。任务完成或在步骤检查点暂停后,工具关闭自有工程、正常退出 CAD,确认进程退出,再清理自有 Job 子进程及句柄,并确认私有桌面消失。每次会话的启动、退出和清理证据单独保留在 `private-desktop-sessions` 下。
单步入口也执行备份、保存、重开核验和关闭。恢复成功会显示属性已保存并重开回读,无需用户另开后台工程手动保存。启动阶段尚未进入工程执行且清理成功时可以重试;执行超时、状态不确定或清理失败仍保留保护状态,由核验恢复入口处理。
该后端已在独立真实副本上完成替换、保存回读、暂停、恢复、启动取消及超时退出验证,详见 [验证记录](../testing/2026-10-15-private-desktop-execution.md)。1.1.1 发布包已包含此更新,详见 [版本说明](../releases/v1.1.1.md)。
1.1.2 增加执行证据长路径兼容:系统没有可用短文件名时,程序自动通过内部短目录入口访问,原任务数据、备份和日志仍在原目录;正常退出后清理入口。无需为了执行证据路径过长而先搬动工具目录。该兼容不代表旧版 CAD 支持任意长度的工程文件或中央库路径,相关路径仍受 CAD 本身限制。冻结 EXE 的长路径及 BOM 流程详见 [成品验收](../testing/2026-10-15-packaged-acceptance.md)。