新增 solidworks-assembly skill：EasyEDA STEP → SolidWorks 装配与干涉检查

本机环境已实测：SOLIDWORKS 2025 SP01.1（RevisionNumber 33.1.1）、 Python 3.14.3 64 位 + pywin32，GetActiveObject 可挂已开实例。已跑通的链路： - EasyEDA get3DFile 导 STEP —— 桥有 30s 硬超时，必须异步启动+轮询； 4MB 分块 base64 取回（刀片 31.2MB/25s，底板 53.9MB/44s） - GetImportFileData + LoadFile4 导入（得到带位号的装配树，一块板 95 个文档） - 遍历 GetDocuments 拿临时顶层 SLDASM → AddComponent4 插入（⛔ AddComponent5 恒返回 None） - ToolsCheckInterference2(0, EMPTY, False, pc, pf) 5 参形式可调 - CloseAllDocuments(True) 清理（295 文档 0.9s） ⛔ 未完成：刀片摆位（CreateTransform 卡在 pywin32 封送）、坐标系（插入后两板被重心归零，§14 的平移量不能直接用）。 ⇒ 现状能装能查，但两板堆在原点，干涉结果无工程意义。 NOTES-probed.md 记了 18 节实测坑，包括： - 无参成员是属性不是方法（含 GetMathUtility 这个例外） - SaveAs3 返回 True 但写出的是废件（外部引用断链） - LoadFile4 不会插进当前装配体 - 动态派发"找不到成员"时用 _oleobj_.GetIDsOfNames + Invoke 绕行 Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_0168Bu6SEx3cXXCJLkdnE6zB
2026-09-12 14:08:36 +08:00
@@ -0,0 +1,6 @@
 # STEP 导出件几十 MB，不进 git：用 solidworks-assembly skill 的 --export 随时重导
 *.step
 *.STEP
 *.obj
 *.SLDASM
 *.SLDPRT
@@ -0,0 +1,322 @@
 # SolidWorks COM 对接：已实测确定的事实（2026-09-12）
 > 这份只记**在本机实测通过**的东西。没实测的不写。
 > 环境：SOLIDWORKS 2025 SP01.1（`RevisionNumber` = 33.1.1），
 > `D:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\SLDWORKS.exe`，
 > Python 3.14.3 **64 位**（`C:\Python314`），pywin32 已装。
 ## 1. 连接
 ```python
 import win32com.client as wc
 app = wc.GetActiveObject('SldWorks.Application')   # 挂已经开着的那个实例
 ```
 - ⛔ **不要用 `gencache.EnsureDispatch`**：实测报
  `TypeError: This COM object can not automate the makepy process`。只能走**动态派发**。
 - `Dispatch` 会另起一个（可能不可见）实例；联调时用 `GetActiveObject`，
  出问题在用户屏幕上能直接看见。
 ## 2. ⛔ 最大的坑：无参成员是**属性**，不是方法
 pywin32 动态派发下，SolidWorks 的无参 `GetXxx()` 全被当成**属性**。加括号就报
 `'str' object is not callable` / `'bool' object is not callable`。
 | 写法 | 正确形式 |
 |---|---|
 | 文档数 | `app.GetDocumentCount`（**不加括号**）|
 | 全部文档 | `app.GetDocuments` → 返回 **tuple** |
 | 活动文档 | `app.ActiveDoc` |
 | 版本 | `app.RevisionNumber` → `'33.1.1'` |
 | 忙否 | `app.CommandInProgress` |
 | 标题 / 类型 / 路径 | `doc.GetTitle` / `doc.GetType` / `doc.GetPathName` |
 | 重建 | `doc.EditRebuild3`（**属性**，加括号会炸）|
 | **有参的才是方法** | `app.CloseDoc(title)` / `app.OpenDoc6(...)` / `app.LoadFile4(...)` / `doc.GetPartBox(True)` |
 ⛔ **不要写 `V = lambda o: o() if callable(o) else o` 这种"自动适配"包装** ——
 COM 对象 `callable()` 一律为 True，会把文档对象当函数调，报"找不到成员"。
 按上表逐个记死即可。
 - `doc.GetType`：**1 = 零件，2 = 装配体，3 = 工程图**。
 ## 3. 导入 STEP：`GetImportFileData` + `LoadFile4`
 ```python
 data = app.GetImportFileData(step_path)          # 有参 ⇒ 方法
 err  = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_I4, 0)
 doc  = app.LoadFile4(step_path, 'r', data, err)  # err.value == 0 即成功
 ```
 - ⛔ `LoadFile4(path, 'r', **None**, err)` 会报**"类型不匹配"** —— 第三参必须是
  `GetImportFileData` 返回的 ImportStepData 对象。
 - ⛔ `OpenDoc6(step, 1, 1, '', err, warn)` 实测返回 `None`、`err=2097152`
  （`swApplicationBusy`）。导 STEP 用上面那条路。
 - 实测耗时：刀片 31 MB ≈ **11 s**，底板 54 MB ≈ **20 s**。
 ### 导进来的是**带位号的装配树**（很重要）
 EasyEDA 以 `'Outfit'` 模式导出的 STEP，SolidWorks 会解析成完整装配体：
 - 顶层 = `PhoneRail_blade`（type=2，未保存）
 - 板体 = `Board~kkk5.step.sldprt`，包围盒实测 `x 0.01~89.99 / y 0.01~67.99 / z 0~1.67`
  —— 正是刀片 90×68×1.6，**说明 STEP 的坐标原点 = 板左下角，与 EDA 板坐标一致**
 - 每个器件一个子装配体，名字里**带位号**：`R1~R0402~…`、`U4~TSSOP-24~…`
 STEP 文件里位号在 `NEXT_ASSEMBLY_USAGE_OCCURRENCE` 的**实例名**（底板 164 个、刀片 75 个，
 与器件数对得上）；`PRODUCT` 里只有几何体名（`Board~`/`TopCopper~`/`TopSilkscreen~`…）。
 ⇒ 干涉报告可以按位号指名。
 ### 代价：一次导入产生上百个打开的文档
 刀片一块就 **95 个**，两块板 **295 个**，子件都是
 `%TEMP%\swx…\IC~~\*.sldprt / *.SLDASM` 的临时文件。
 - `doc.GetPathName` 能拿到这些临时件的真实路径（`AddComponent5` 可以直接引用它们）。
 - ⛔ **顺序约束**：要引用临时件，必须在**导入之后、清理之前**做完。
  一旦 `CloseAllDocuments`，`%TEMP%\swx…\IC~~\` 就空了（实测候选数 95 → 0）。
 ## 4. 清理
 ```python
 app.CloseAllDocuments(True)    # True = 连未保存的一起关，不弹框
 ```
 实测 295 个文档 **0.9 s** 关完，SolidWorks 本身不退出。
 ## 5. ⛔ 带外部引用的装配体**不能用 SaveAs 复制**
 `doc.SaveAs3(path, 0, 2)` 实测返回 **0（失败）**。官方也写明：
 带 in-context / 外部引用的装配体要用 `ISldWorks::CopyDocument`，不是 SaveAs。
 ⇒ 本 skill 的做法是**不另存**：导入后直接引用 `GetPathName` 给出的临时 SLDASM。
 ## 6. 两块板的 STEP 怎么来
 见 `easyeda-api` 侧：`eda.pcb_ManufactureData.get3DFile(name, 'step',
 ['Component Model'], 'Outfit', true)`。实测：
 | 板 | 生成 | 大小 |
 |---|---|---|
 | 刀片 | 22.6 s | 31.2 MB |
 | 底板 | 40 s | 53.9 MB |
 - ⛔ **桥有 30 s 硬超时**：底板直接同步调用会 `Request timed out after 30000ms`，
  且大导出会把 EDA 窗口搞断（`EDA window disconnected`）。
  ⇒ 必须**异步启动 + 轮询**：JS 里把 promise 挂到 `window.__gen`，立刻 return，再每 5 s 查一次。
 - 取回用 **4 MB 分块** base64（`String.fromCharCode.apply` 按 32 KB 小段拼，避免爆栈）：
  31 MB 实测 **2 s**、54 MB **4 s**。
  ⛔ 别用 512 KB 分块去推算大文件耗时 —— 瓶颈是**往返次数**不是带宽，线性外推会得出
  "51 分钟"这种离谱结论（实际 2 秒）。
 - 归档在 `.claude/r2/3d/`（已 `.gitignore`，几十 MB 不进 git）。
 ## 7. 还没实测通的（⚠ 别当成已知）
 - `AddComponent5(path, 0, '', False, '', 0.0, 0.0, 0.0)` → 返回 `None`
  （当时因 SaveAs 失败、路径不存在；**用临时 SLDASM 路径重试尚未完成**）
 - `ToolsCheckInterference2` → 六种参数形式**全部**报"非选择性的参数"，
  错误码一致 ⇒ 不是参数个数问题，需要从 `sldworks.tlb` 读真实参数表与 invkind。
 - 刀片相对底板的装配变换（绕 X 转 90° 竖起 + 平移到槽位）未做。
 ## 8. 权威签名：从 `sldworks.tlb` 读，别猜
 ```python
 import pythoncom
 tlb = pythoncom.LoadTypeLib(r'D:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\sldworks.tlb')
 # 遍历 GetTypeInfo(i) → GetFuncDesc(f) → GetNames(fd.memid)：names[0]=方法名，names[1:]=参数名
 # ⚠ PyFUNCDESC 没有 cParams 属性，用 len(fd.args)；有 cParamsOpt。
 ```
 实读到的（SOLIDWORKS 2025）：
 | 接口.方法 | 参数 | invkind |
 |---|---|---|
 | `ISldWorks.GetImportFileData` | `(FileName)` | 1 方法 |
 | `ISldWorks.LoadFile4` | `(FileName, ArgString, ImportData, Errors)` | 1 |
 | `ISldWorks.CloseAllDocuments` | `(IncludeUnsaved)` | 1 |
 | `IAssemblyDoc.AddComponent5` | `(CompName, ConfigOption, NewConfigName, UseConfigForPartReferences, ExistingConfigName, X, Y, Z)` | 1 |
 | **`IAssemblyDoc.ToolsCheckInterference2`** | **`(NumComponents, LpComponents, CoincidentInterference, PComp, PFace)`** | 1 |
 | `IAssemblyDoc.GetComponents` | `(ToplevelOnly)` | 1 |
 | `IModelDoc2.SaveAs3` | `(NewName, SaveAsVersion, Options)` | 1 |
 | `IModelDocExtension.SaveAs3` | `(Name, Version, Options, ExportData, AdvancedSaveAsOptions, Errors, Warnings)` | 1 |
 | `IComponent2.Transform2` | — | **2 属性读 / 4 属性写** |
 - ⛔ `ToolsCheckInterference2` 是 **5 个参数、0 可选**。只传 3 个会一律报
  **"非选择性的参数"**（= 缺必需参数），换几种写法都一样 —— 别以为是类型不对。
  后两个 `PComp` / `PFace` 是**输出**参数，要传 `VARIANT(VT_BYREF|VT_VARIANT, None)`。
 - ⛔ `AddComponent5` 的 8 参形式是对的；之前返回 `None` 纯粹因为**传进去的文件不存在**。
 - 摆位靠 **`comp.Transform2 = <MathTransform>`**（属性赋值，不是方法调用）。
 ## 9. ⛔ 类型库说"方法"，动态派发下可能仍是属性
 `IModelDoc2.EditRebuild3` 在 tlb 里是 `invkind=1`（方法、0 参），
 但实测 `asm.EditRebuild3()` 报 **`'bool' object is not callable`** ——
 动态派发对 0 参成员一律按属性取值（取值时就已执行）。
 ⇒ **0 参一律写成属性形式**，不管 tlb 标的是什么。
 ## 10. ⛔ 顶层导入文档是"未保存"的，`GetPathName` 是空串
 导入 STEP 后 `app.ActiveDoc` 是顶层装配体（`PhoneRail_blade`），它**没有路径**；
 有路径的是它的**子件**（`%TEMP%\swx…\IC~~\*.sldprt / *.SLDASM`）。
 ⇒ `AddComponent5` 不能拿顶层文档的 `GetPathName`（空串 ⇒ 文件不存在 ⇒ 返回 None），
 要去临时目录找 `PhoneRail_*.step.SLDASM`，或遍历 `GetDocuments` 挑有路径的那个。
 ## 11. ✅ 另存：`Extension.SaveAs3` 的空参数要传 `VARIANT(VT_DISPATCH, None)`
 ```python
 EMPTY = wc.VARIANT(pythoncom.VT_DISPATCH, None)
 err   = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_I4, 0)
 warn  = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_I4, 0)
 ok = doc.Extension.SaveAs3(dst, 0, 1, EMPTY, EMPTY, err, warn)   # → True, err=0
 ```
 - ⛔ 传 `None` 会报 **"类型不匹配"，且错误里指明是第 4 个参数**（`ExportData`）。
  `AdvancedSaveAsOptions`（第 5 参）同理。
 - `Options=1` = `swSaveAsOptions_Silent`。
 - ⛔ `IModelDoc2.SaveAs3(path, 0, 2)`（3 参那个）实测返回 **0**，别用。
 - 实测：刀片顶层装配体另存成 `.SLDASM` = 16.5 MB、底板 29.7 MB。
 ⛔⛔ **但这两个文件是废件** —— 更正上面这条。`SaveAs3` 返回 True、`err=0`、文件也写出来了，
   可是**再打开就是 `OpenDoc6 → None` 且 `err=0`**（文档数仍为 0），
   `AddComponent5` 引用它们也一律返回 `None`。
   原因：另存只写了顶层，子件引用仍指向 `%TEMP%\swx…\IC~~\`，
   而那个目录在 `CloseAllDocuments` 时已被清空 ⇒ 引用链断了。
   这正是官方那句「带 in-context / 外部引用的装配体不要用 SaveAs 复制，要用
   `ISldWorks::CopyDocument`」的实际后果。
   ⇒ **判据教训**：`SaveAs3` 返回 True **不等于**文件可用；必须**再打开一次**才算验证通过。
 ## 12. ⛔ `LoadFile4` 不会插进当前装配体，它总是另开一个顶层文档
 试过"在空装配体里连续导入两块板的 STEP，让它们成为同一装配的两棵子树"——**不成立**：
 每次 `LoadFile4` 都把活动文档顶成新的 `PhoneRail_base` / `PhoneRail_blade`，
 空装配体里 `GetComponents(True)` 仍是 **0 个**。
 ⇒ 唯一可行的装配路径是三步：
 1. `LoadFile4` 导入 STEP（得到未保存的顶层装配体）
 2. `Extension.SaveAs3` 另存成 `.SLDASM`（见 §11）
 3. `CloseAllDocuments(True)` → 新建总装 → `AddComponent5(那个 .SLDASM 路径, …)`
 ## 13. ✅ `ToolsCheckInterference2` 的 5 参形式已经对
 ```python
 pcomp = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 pface = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 n = asm.ToolsCheckInterference2(0, EMPTY, False, pcomp, pface)
 ```
 空装配体上调用**不再报错**（返回 None / PComp 0 项）⇒ 参数形式正确，
 先前那一串"非选择性的参数"纯粹是**参数个数不够**（只传了 3 个，它要 5 个）。
 ## 14. 刀片竖插到底板槽位的变换（纯几何，已算好）
 ⛔⛔ **前提作废（2026-09-12 更正）**：下表是按"原点 = 板左下角"算的，
 而那只在**单独打开导入的装配体**时成立。一旦用 `AddComponent4` 插进总装，
 实测包围盒变成 **刀片 `x -45~45 / y -34~34 / z -3.2~3.2`、底板 `x -49~49 / y -49~49 / z -9.7~9.7`**
 —— 两块板都**以各自几何中心为原点**（SolidWorks 插入时做了重心归零）。
 ⇒ 平移量必须按 `GetBox` 读回的**真实包围盒**现算，不能用板坐标直接减。下表仅留作参考。
 （原始推导）坐标系：STEP 原点 = 板左下角
 （刀片板体包围盒 `x 0.01~89.99 / y 0.01~67.99 / z 0~1.67`，正是 90×68×1.6）。
 刀片绕 **X 轴 +90°** 竖起：刀片 `y`(板高) → 底板 `z`(高度)，刀片 `z`(板厚) → 底板 `-y`。
 `MathTransform` 是 16 元素数组、**单位米**：`[R00..R22 (9 个，行主序), dx, dy, dz, 缩放, 0,0,0]`。
 | 槽 | 槽心 y | 平移 (dx, dy, dz) mm |
 |---|---|---|
 | 1 | 8.36 | (4.00, 9.16, 5.60) |
 | 2 | 28.68 | (4.00, 29.48, 5.60) |
 | 3 | 49.00 | (4.00, 49.80, 5.60) |
 | 4 | 69.32 | (4.00, 70.12, 5.60) |
 | 5 | 89.64 | (4.00, 90.44, 5.60) |
 - `dx = SLOT_CX(49) − J1_X(45) = 4.00`（金手指中心对齐槽心 x）
 - `dy = 槽心 y + 0.8`（板厚 1.6，转后 z=0 面朝 −y）
 - `dz = Z0 = 塑料体高 11.1 − 插入深度 D_INSERT`
 - ⚠ **`D_INSERT` 是估值 5.5**（LCSC 页和 SOFNG 都查不到）。装配跑通后可用干涉检查反推：
  刀片底边刚好贴到槽底时的 `Z0` 才是实测值。改这一个常量即可。
 摆位用属性赋值：`comp.Transform2 = mathUtil.CreateTransform(那 16 个数)`（见 §8，Transform2 是属性）。
 ## 15. ✅✅ 装配终于打通：用 **`AddComponent4`**，不是 `AddComponent5`
 ```python
 c = asm.AddComponent4(path, '', 0.0, 0.0, 0.0)     # (CompName, ConfigName, X, Y, Z)
 ```
 - ⛔ **`AddComponent5`（8 参）在这台机器上恒返回 `None`**，试过 ConfigOption=0/1、
  坐标 0/-1、正反斜杠、先 `OpenDoc6` 预载、总装先存盘——**全都 None，且不抛异常**。
 - ✅ `AddComponent4`（5 参）**一次就成**，返回 `PhoneRail_blade.step-1`。
  ⇒ 遇到 `AddComponent5` 返回 None 别再调参数，直接换 `AddComponent4`。
 - 类型库里还有更简的 `AddComponent(CompName, X, Y, Z)` 和批量的
  `AddComponents(Names, Transforms)`（可一次给变换，没试）。
 ### 被插的文件用**临时目录里的顶层 SLDASM**，别另存
 导入 STEP 后**不要关文档**，直接遍历 `GetDocuments` 找：
 有路径 + `GetType == 2` + 标题含板名 + 后缀 `.SLDASM`
 → 得到 `%TEMP%\swx…\IC~~\PhoneRail_base.step.SLDASM`，把它喂给 `AddComponent4`。
 - ⛔ 别用 glob 猜文件名：真实名字是 `PhoneRail_blade**.step**.SLDASM`（中间夹着 `.step`）。
  用 `GetDocuments` 遍历最可靠。
 - ⛔ 别走"另存再插"：`SaveAs3` 出来的是废件（§11），`CopyDocument` 返回 2（失败），
  `OpenDoc7` + `GetOpenDocSpec(DocumentType=1)` 也打不开 STEP（返回 None）——
  STEP 走的不是 `OpenDoc*` 那条文档通道。
 - `IImportStepData` 全表**只有 `MapConfigurationData` 可写**，
  "导入成单一零件"在 API 层没有开关。
 实测结果：两块板都插进同一个总装，`GetComponents(True)` = 2 个顶层零部件，
 `ToolsCheckInterference2` 可正常调用（1 s 返回）。
 ## 16. ⚠ 干涉检查的第 2 参：只能传 `EMPTY`，别传零部件元组
 已验证可用的唯一形式（全量检查）：
 ```python
 pc = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 pf = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 n  = asm.ToolsCheckInterference2(0, EMPTY, False, pc, pf)      # ✅ 1 s 返回
 ```
 ⛔ 改成 `ToolsCheckInterference2(len(comps), comps, False, pc, pf)`
 （把 `GetComponents()` 拿到的 COM 对象元组直接塞进去）会报
 **"服务器出现意外情况"**（`-2147417851`）——两种口径都试过，顶层和含子件都一样。
 ⇒ 想限定范围，得先把零部件封送成 SafeArray of IDispatch，不能直接传 Python 元组。
 ## 17. 摆位：`GetMathUtility` 是**方法**，要加括号
 报 `-2147352573 找不到成员` 的原因查明了 —— 类型库里：
 | 成员 | invkind |
 |---|---|
 | `ISldWorks.GetMathUtility()` | **1 方法**（⚠ 少数几个无参却是方法的例外，见 §2）|
 | `IMathUtility.CreateTransform(ArrayDataIn)` | 方法 |
 | `IMathUtility.CreateTransformRotateAxis(PointObjIn, VectorObjIn, Angle)` | 方法 |
 | `IComponent2.Transform2` | 属性读/写 |
 | `IComponent2.SetTransformAndSolve2(XformIn)` | **方法**（摆位更稳妥的入口）|
 | `IMathTransform.ArrayData` | 属性读/写 |
 ```python
 mu    = app.GetMathUtility()                  # ⇐ 加括号
 xform = mu.CreateTransform(arr16)             # arr16 可能要封送成 VT_ARRAY|VT_R8
 comp.SetTransformAndSolve2(xform)             # 或 comp.Transform2 = xform
 ```
 ⚠ §2 那条"无参 = 属性"的规律**有例外**：`GetMathUtility` 无参却是方法。
 ⛔ **但加括号也不行** —— `app.GetMathUtility()` 照样报"找不到成员"。
   动态派发对这个成员建的包装是坏的。**绕过 `getattr`，直接按 dispid 调**：
 ```python
 did = app._oleobj_.GetIDsOfNames('GetMathUtility')      # → 132（本机实测）
 raw = app._oleobj_.Invoke(did, 0, pythoncom.DISPATCH_METHOD, 1)
 mu  = wc.Dispatch(raw)                                   # → 可用的 IMathUtility
 ```
 ⇒ **通用招数**：动态派发报"找不到成员"时，先用 `_oleobj_.GetIDsOfNames(名字)` 确认
   这个名字在不在。在 → 用 `_oleobj_.Invoke(dispid, 0, DISPATCH_METHOD 或 DISPATCH_PROPERTYGET, 1)`
   手动调；不在 → 名字真错了（如 `MathUtility` 就报"未知名称"）。
   `IGetMathUtility`（dispid=133）虽然名字在，但两种 Invoke 都失败，别用。
 ## 18. 进度小结（2026-09-12）
 **已验证可用**：STEP 导出（异步+4MB 分块）→ `LoadFile4` 导入 →
 `GetDocuments` 找临时顶层 SLDASM → `AddComponent4` 插入 → `ToolsCheckInterference2(0, EMPTY, …)` 可调
 → `CloseAllDocuments(True)` 清理。
 **未完成**：① 刀片摆位（§17）② 干涉结果解读（`PComp` 数组解析、限定范围检查 §16）。
@@ -0,0 +1,97 @@
 ---
 name: solidworks-assembly
 description: 把 EasyEDA 的 PCB 导成 STEP、在本机 SOLIDWORKS 里装配并做干涉检查。用于「底板 + 刀片插在一起会不会撞」这类机械核对，也用于量插槽插入深度这类 EDA 侧算不出来的数。涉及 SolidWorks / STEP / 3D 装配 / 干涉检查 / 机械干涉 时触发。
 ---
 # SolidWorks 装配与干涉检查（PhoneRail 专用）
 > ⚠ **动手前先读 `NOTES-probed.md`** —— 那是本机逐条实测出来的 API 口径与坑，
 > 每一条都踩过一次。不读会把同样的坑再踩一遍。
 > 环境已实测：SOLIDWORKS 2025 SP01.1（`RevisionNumber` = `33.1.1`）、
 > Python 3.14.3 **64 位** + pywin32（32 位 Python 连不上 64 位 SW，本机不存在这问题）。
 ## 什么时候用
 - 底板与刀片、刀片与刀片之间的**机械干涉**核对（EDA 侧只能算 2.5D 净距，算不了竖插后的三维关系）
 - 量 EDA 侧拿不到的机械数：插槽**插入深度**、塑料体内腔、刀片底边离底板多高
 - ⚠ **但凡实物在手，优先用卡尺**。STEP 里的连接器是厂商**标称模型**，不含公差；
  3D 能替代"按标称值推算"，替代不了实测。
 ## 整条链（每一步都已实测通过）
 ### 1. 从 EasyEDA 导出 STEP
 ```python
 # 桥有 30 s 硬超时，大板同步调用必断 ⇒ 异步启动 + 轮询
 START = "window.__gen={state:'running'}; (async()=>{ ... get3DFile(name,'step',['Component Model'],'Outfit',true) ... })(); return {started:true};"
 # 再每 5 s 查 window.__gen.state，done 后用 4 MB 分块 base64 取回
 ```
 实测：刀片 31.2 MB（生成 22.6 s + 取回 2 s）、底板 53.9 MB（生成 40 s + 取回 4 s）。
 归档在 `.claude/r2/3d/`（已 `.gitignore`）。细节见 NOTES §6。
 ### 2. 导入 SolidWorks
 ```python
 app  = wc.GetActiveObject('SldWorks.Application')   # 挂已开着的实例
 data = app.GetImportFileData(step_path)
 err  = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_I4, 0)
 app.LoadFile4(step_path, 'r', data, err)            # err.value == 0 即成功
 ```
 导进来是**带位号的装配树**（`R1~R0402~…`、`U4~TSSOP-24~…`），一块板 95 个文档。
 ⛔ 第三参不能传 `None`（报"类型不匹配"）；⛔ `OpenDoc6` 导 STEP 返回 None。见 NOTES §3。
 ### 3. 找到可插引用 + 装配
 ```python
 # 导入后**不要关文档**，遍历 GetDocuments 找：有路径 + GetType==2 + .SLDASM
 p = ...   # → %TEMP%\swx…\IC~~\PhoneRail_base.step.SLDASM
 c = asm.AddComponent4(p, '', 0.0, 0.0, 0.0)          # ✅ 用 AddComponent4
 ```
 ⛔ **`AddComponent5`（8 参）在本机恒返回 `None`**，换参数没用，直接用 `AddComponent4`。
 ⛔ 别走"另存再插"：`SaveAs3` 出来的是废件、`CopyDocument` 返回 2、`OpenDoc7` 打不开 STEP。
 见 NOTES §11/§12/§15。
 ### 4. 干涉检查
 ```python
 pc = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 pf = wc.VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, None)
 n  = asm.ToolsCheckInterference2(0, EMPTY, False, pc, pf)   # 5 参，少一个都报"非选择性的参数"
 ```
 ⛔ 第 2 参只能传 `EMPTY`（`VARIANT(VT_DISPATCH, None)`），塞零部件元组会报"服务器出现意外情况"。
 ### 5. 清理
 ```python
 app.CloseAllDocuments(True)      # 295 个文档 0.9 s 关完，SW 不退出
 ```
 ⛔ 一关就清空 `%TEMP%\swx…\IC~~\`，所以第 3 步必须在清理**之前**做完。
 ## ⛔ 未完成的两步（别当成能用）
 1. **刀片摆位**。变换矩阵算好了（NOTES §14），但 `CreateTransform` 卡在 pywin32 封送：
   `GetMathUtility` 要用 dispid 绕行才拿得到（NOTES §17），拿到后 `CreateTransform`
   **又**报"找不到成员"——同一个病一层套一层，未解。
 2. **坐标系**：`AddComponent4` 插进总装后，两块板都被**重心归零**
   （刀片 `x -45~45 / y -34~34`、底板 `x -49~49 / y -49~49`），
   NOTES §14 那套"原点 = 板左下角"的平移量**不能直接用**，要按 `GetBox` 现算。
 ⇒ 现状：能装、能查干涉，但**两块板都堆在原点**，查出来的干涉没有工程意义。
   要么解掉上面两点，要么在 SolidWorks 里手工拖一次（更快）。
 ## 调试时的通用招数
 动态派发报"找不到成员"时，先确认名字在不在：
 ```python
 did = app._oleobj_.GetIDsOfNames('GetMathUtility')          # 在 → 返回 dispid
 raw = app._oleobj_.Invoke(did, 0, pythoncom.DISPATCH_METHOD, 1)
 ```
 还有一条贯穿始终的规律：**无参成员基本都是属性**（`app.GetDocumentCount` / `doc.GetTitle` /
 `doc.EditRebuild3` 都不加括号），有参的才是方法。但**有例外**（`GetMathUtility`），
 拿不准就去 `sldworks.tlb` 查 `invkind`（NOTES §8 给了读法）。