# 无 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|`; - 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 选择、保存回读和窗口收尾。