Files
dxdesigner-part-replacement/docs/testing/2026-10-30-missing-uid.md
T

31 lines
1.8 KiB
Markdown
Raw 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.
# 无 UID 器件鲁棒性修复
## 根因
目标计划的 `ComponentTarget` 本身已经拒绝空 UID,但来自原生快照和实时 CAD 的路径仍可能在进入计划之前把空 UID 当作普通字符串:
- `native_helper.read_snapshot()` 只检查行列数和 UID 集合重复,没有支持本地 fallback 身份;
- `check_context()` 以 `str(component.UID)` 构造字典,单个空 UID 可以成为合法字典键,多个空 UID 还可能互相覆盖;
- `QuickPartReplace.vbs` 的库存循环在后续分支才读取 UID,错误可能发生在 CAD 打开、等待或选择之后,导致界面表现为长时间无进展。
## 修复
- 快照协议仍拒绝空 UID 文本,但 VBS 库存和实时 CAD 会生成一致的本地键 `@REFDES|<refdes>`;
- CAD 当前页枚举统一通过 `_component_uid()`,UID 缺失时使用 Refdes fallback,重复 fallback 键立即阻断;
- VBS 库存循环在读取器件身份时允许 UID 缺失,但要求 Refdes 可读;无 Refdes 或无法读取身份仍立即失败;
- 选择、快照、回读和恢复统一使用 fallback 键,底层 CAD 查找使用 Refdes/坐标回退索引;原生 CLI 无法提供稳定 UID 时继续退回 CAD 采集;
- 不生成伪造的 CAD UID;fallback 只用于本批次本地关联,位号不唯一时不能继续。
## 验证
```text
tests/v1_1/test_target_execution.py
tests/v1_1/test_accuracy_vbs_guards.py
tests/v1_1/test_native_inventory_reader.py
tests/v1_1/test_native_ascii_inventory.py
tests/trial_task_center/test_quick_run.py
160 passed in 47.39s
```
新增场景覆盖:无 UID 的唯一 Refdes fallback、重复 Refdes 阻断、VBS 无 UID、VBS 空 Refdes、可选属性失败和必需属性失败。真实 DxDesigner 工程仍需用副本验证 fallback 选择、保存回读和窗口收尾。