dsh-engineering-ui 0.0.0-stage → 1.5.0

package/engineering/skills/solidworks-bridge/SKILL.md

@@ -0,0 +1,445 @@
+---
+name: solidworks-bridge
+description: >-
+  SolidWorks 自动化建模桥接工具（DSH_SW 通用版）。
+  通过 Python win32com 驱动 SolidWorks，支持 SW 2018~2024 任意版本。
+  单位：毫米（mm），默认前缀：DSH_。
+whenToUse: >-
+  当用户要求用 SolidWorks 建模、画图、生成 3D 零件、输出 .sldprt 文件时使用。
+source: engineering
+provider: filesystem
+---
+
+# SolidWorks 建模桥接（DSH_SW 通用版）
+
+> **本文件是通用版**：不写死任何电脑路径或 SolidWorks 版本号。
+> 复制到其他电脑后，把 `<包目录>` 替换成实际路径即可。
+
+## 0. 核心架构
+
+```
+DSH (pwsh 工具)
+  │  python <包目录>\sw_bridge.py run <脚本.py>
+  ▼
+sw_bridge.py (win32com 执行器)
+  │  win32com.client.dynamic.Dispatch('SldWorks.Application')
+  ▼
+SolidWorks（任意版本，自动探测模板）
+```
+
+## 1. 单位约定
+
+**所有尺寸单位默认毫米（mm）**，用户没说单位就是 mm。
+脚本中直接写 `m.rect(0, 0, 120, 80)` 就是 120mm×80mm。
+
+## 2. 保存命名约定
+
+**保存文件名按用户提供的模型名称命名**：
+- 前缀统一 `DSH_` + 用户提供的名称 + `.sldprt`
+- 用户说"建模一个圆球"，就保存为 `DSH_圆球.sldprt`
+- 用户给了明确文件名则优先用用户指定的名字
+
+## 3. 完整 API 速查
+
+```python
+import swapi
+
+# ── 文档操作 ───────────────────────────────────────
+m = swapi.new_part()          # 新建零件（模板自动探测）
+m = swapi.from_active()       # 包装当前活动文档
+m.save(path)                  # 另存为（返回 {"ok": True/False, "path": ...}）
+m.massprops()                 # 质量属性（体积/重量/重心）
+m.close()                     # 关闭文档
+m.export_pdf(path)            # 导出 PDF
+
+# ── 展示 / 可视化 ─────────────────────────────────
+m.bring_to_front()            # 窗口置前 + 最大化
+m.set_view_iso()              # 等轴测视角 + 居中 + 缩放 1.2x
+m.zoom_to_fit()               # 缩放适应窗口
+m.screenshot(path)            # 窗口截图 PNG
+m.export_image(path)          # 导出位图
+m.rebuild()                   # 重建模型
+
+# ── 基准面 / 草图 ────────────────────────────────
+m.begin_sketch("Front Plane")        # 在基准面开始草图（自动正视+居中）
+m.begin_sketch_on_face(x, y, z)      # 在实体表面开草图（坐标 mm）
+m.end_sketch()                       # 结束草图（自动 MergePoints 闭合端点）
+
+# ── 草图图元（坐标单位 mm）───────────────────────
+m.rect(cx, cy, w, h)                # 中心矩形
+m.circle(cx, cy, r)                 # 圆
+m.line(x1, y1, x2, y2)              # 直线
+m.polyline([(x1,y1), (x2,y2), ...]) # 折线
+m.centerline(x1, y1, x2, y2)        # 中心线（旋转轴）
+
+# ── 特征操作（尺寸单位 mm）──────────────────────
+m.extrude(depth, symmetric=False)   # 拉伸凸台
+m.cut(depth=10, through=True)       # 切除 / 完全贯穿
+m.revolve(angle_deg=360, cut=False) # 旋转（需先画中心线）
+m.fillet(radius, edge_points)       # 圆角：边上的采样点坐标
+m.chamfer(width, edge_points, 45)   # 倒角
+```
+
+## 4. 调用方式（DSH AI 使用）
+
+AI 通过 DSH 的 `pwsh` 工具执行：
+
+> **路径查找（新电脑/未知环境）**：先运行 `python "<工程模式根目录>\tools\sw_bridge.py" self-path`，返回 JSON 中的 `.dir` 字段即为 `<包目录>`。无需手动替换占位符。
+
+```powershell
+# 查找 sw_bridge.py 路径（推荐第一步）
+python "<工程模式根目录>\tools\sw_bridge.py" self-path
+# 返回: {"ok": true, "path": "C:\\...\\sw_bridge.py", "dir": "C:\\..."}
+
+# 检查 SolidWorks 连接状态
+python "<包目录>\sw_bridge.py" status
+
+# 执行建模脚本
+python "<包目录>\sw_bridge.py" run "<脚本路径>"
+
+# 展示成品
+python "<包目录>\sw_bridge.py" show
+
+# 生成工程图（强制中文视图名 *前视/*上视/*右视/*等轴测）
+python "<包目录>\sw_bridge.py" drawing "零件路径" [输出路径]
+
+# 导出 DWG
+python "<包目录>\sw_bridge.py" dwg "零件路径" [输出路径]
+
+# 清理临时文件
+python "<包目录>\sw_bridge.py" cleanup "目录路径"
+
+# Vision 不可用时截图供前端识图
+python "<包目录>\sw_bridge.py" vision-fallback "描述"
+```
+
+## 4.5 SW 使用窗口互斥 + 批量调用（多小屋并行时必须遵守）
+
+### SW 进程级互斥窗口（代码级强制，自动生效）
+
+每个 sw_bridge.py 调用都会自动检测 SLDWORKS.EXE 进程并排队（FIFO 先到先用）：
+
+```powershell
+# 推荐：带上房间名（来自小屋 prompt 中的房间名）
+python "<包目录>\sw_bridge.py" run "script.py" --room "结构件"
+
+# 或用环境变量
+$env:DSH_ROOM = "结构件"; python "<包目录>\sw_bridge.py" run "script.py"
+```
+
+- 并行模式下多个小屋同时跑：SW 调用自动检测进程并 FIFO 排队（谁先排队谁先用）
+- 若返回 sw_busy:true：用 `python mode_gate.py sw-wait <房间> --timeout 90` 原地阻塞等锁（或 `wait-rooms`），
+  再重试同一条命令（必须带 --room）；队列位置已保留，禁止放弃
+- 🚫禁止用 `Start-Sleep 90 + job_output wait:true` 长阻塞轮询：静默等待会让用户以为 DSH 卡死
+  （2026-10-31 事故，见 docs/DSH卡死事故分析_job_output阻塞.md）
+- 前一个小屋完全关闭 SW 进程后，队首小屋自动获得 SW 使用权
+- 串行模式 / 非模式2：锁自动跳过，零影响
+- 锁随小屋生命周期保持，由主对话的 room-end 统一释放并确保 SW 进程关闭
+- 小屋收工前必须 close-all 完全关闭 SW，否则 room-end 等 20 秒后会强制关闭
+
+### 一次调用规划多步操作（批量执行，禁止逐步调用）
+
+❌ **禁止**这样逐步调用（每次都要重新连接 SW，又慢又占锁窗口）：
+```powershell
+python "<工程模式根目录>\tools\sw_bridge.py" new          # 连接1
+python "<工程模式根目录>\tools\sw_bridge.py" sketch-rect 120 80 30   # 连接2
+python "<工程模式根目录>\tools\sw_bridge.py" save "x.sldprt"    # 连接3
+```
+
+✅ **必须**把全部建模步骤写进一个脚本，一次 run 执行（一次调用规划多步）：
+```powershell
+python "<工程模式根目录>\tools\sw_bridge.py" run "D:\work\build_part.py" --room "结构件"
+```
+```python
+# build_part.py —— 所有步骤一个脚本内完成
+import swapi
+m = swapi.new_part()
+m.begin_sketch("Front Plane"); m.rect(0, 0, 120, 80); m.extrude(30)
+m.begin_sketch("Top Plane"); m.circle(0, 0, 12); m.cut(through=True)
+m.set_view_iso()
+m.save(r"C:\output\DSH_底座.sldprt")
+print("DONE")
+```
+
+### 开新子代理前的 SW 收尾（铁律）
+
+在创建任何下一个子代理（同级小屋或下一级子代理孩子）之前：
+1. 当前建模必须已完成并保存（`m.save(...)`）
+2. 调用 `python "<工程模式根目录>\tools\sw_bridge.py" close-all` 保存并关闭 SW
+3. 确认 SW 锁已释放（room-end 会自动释放；或 `python "<工程模式根目录>\tools\mode_gate.py" sw-release <房间名>`）
+**严禁开着 SW 去开下一个子代理！**
+
+## 5. 已踩坑与解决方案
+
+### 坑 1：草图吸附导致坐标不精确
+- **现象**：输入 17.5mm 被吸附到 18mm
+- **解决**：swapi 连接时自动禁用推理/吸附（`_disable_snapping`）
+
+### 坑 2：对称拉伸枚举随版本变化
+- **现象**：2022 用枚举 6，2018 用枚举 5
+- **解决**：`swapi._get_midplane_enum(sw)` 自动适配
+
+### 坑 3：圆角必须指定 Options=2
+- **现象**：调用 FeatureFillet3 但不传 Options 参数会静默失败
+- **解决**：`FeatureFillet3(2, R1_m, 0, 0, 0, 0, 0, None×7)`
+
+### 坑 4：键槽 API 语义
+- **现象**：CreateSketchSlot 的 CenterCenter 模式在 pywin32 下生成错误几何
+- **解决**：只用 FullLength 模式，X2 传右圆弧圆心而非最外端点
+
+### 坑 5：中文草图名跨语言不可靠
+- **现象**：英文版 SW 草图叫 "Sketch2"，中文版叫 "草图2"
+- **解决**：用 `swapi.select_sketch_by_index(sw, model, 2)` 按序号选
+
+### 坑 6：欢迎页 vs 主窗口混淆
+- **现象**：SolidWorks 2022 有两个大窗口，主窗口标题含版本号
+- **解决**：`swapi._find_sw_windows()` 排除纯 "SOLIDWORKS" 标题
+
+## 5.5 关键 Bug 修复（2025-08-21）
+
+### Bug 6: FACE vs PLANE 选择
+- **现象**: 第一个特征后，`begin_sketch("Front Plane")` 失效，ActiveSketch 始终为 None
+- **根因**: 在已有特征的文档中，选择 PLANE 基准面无法激活草图
+- **解决**: 改用 `begin_sketch_on_face(x, y, z)` 选择实体表面
+- **示例**:
+  ```python
+  # 错误：底座创建后继续用基准面会失败
+  m.begin_sketch("Front Plane")  # ActiveSketch = None
+
+  # 正确：在实体表面开草图
+  m.begin_sketch_on_face(25, 0, 10)  # 底座顶面中心
+  ```
+
+### Bug 7: CreateLine 返回 None
+- **现象**: 线段创建静默失败
+- **解决**: 确保 `ActiveSketch is not None` 后再调用 CreateLine
+- **代码**: `_ensure_sketch_active()` 方法
+
+### Bug 8: 三角形轮廓不闭合
+- **现象**: 3条线画完但 FeatureExtrusion3 返回 None
+- **解决**: 在 end_sketch() 前调用 `MergePoints(0.0005)` 闭合端点
+- **代码**:
+  ```python
+  active_sk = self.skm.ActiveSketch
+  active_sk.MergePoints(0.0005)  # Bug 8 关键！
+  self.skm.InsertSketch(True)
+  ```
+
+### Bug 4: FeatureCut3 完全无效
+- **现象**: 所有参数组合都返回 None，体积不变
+- **解决**: 改用 FeatureExtrusion3 的切除模式（AddPad=False）
+- **代码**:
+  ```python
+  def cut(self, depth=10, through=False):
+      T1 = SW_END_THROUGH if through else SW_END_BLIND
+      d = depth * MM
+      feat = self.fm.FeatureExtrusion3(
+          False, False, False, T1, 0, d, 0,  # AddPad=False 即切除
+          ...)
+  ```
+
+### Bug 3: extrude-to-point (T1=2) 参数类型不匹配
+- **现象**: 无论传 list/tuple/None/VARIANT 都报类型不匹配
+- **解决**: 放弃此方法，改用标准 FeatureExtrusion3
+
+### Bug 10: 遗留文档干扰
+- **现象**: 新建零件时有13个旧文档打开
+- **解决**: `new_part()` 前先关闭所有文档
+  ```python
+  for _ in range(50):
+      try:
+          if sw.ActiveDoc: sw.ActiveDoc.CloseDoc(0)
+      except: pass
+  ```
+
+### Bug 16: begin_sketch 多特征后永久失效
+- **现象**: 第一个特征后，后续所有 `begin_sketch("Front Plane")` 调用失败
+- **根因**: `clear_selection()` 过早清除平面选择状态，干扰 `InsertSketch(True)` 的选面逻辑；残留草图模式未退出
+- **解决**: 移除 `select_plane()` 中的 `clear_selection()`；在 `begin_sketch()` 开头先 `InsertSketch(False)` 退出残留模式；草图激活成功后再清理选择；fallback 改为动态范围搜索（±5~200mm）
+
+### Bug 17: begin_sketch_on_face 最大边界面不可选
+- **现象**: 最小边界（x=0/y=0/z=0）可选，最大边界（x=max/y=max）完全不可选
+- **根因**: `SelectByID2(FACE, x,y,z)` 使用射线拾取，在最大边界处射线穿过边/顶点而非面；且 face.GetBox 返回 SW 内部坐标（居中），与用户局部坐标不匹配
+- **解决**: 两步匹配法——第一遍用原始坐标尝试；失败后聚合所有面 GetBox 计算实体整体包围盒，将用户局部坐标转换为内部坐标（`internal = body_min + local`）再匹配；匹配后用 `face.Select(True)` 直接选面
+- **验证**: 9项测试全部通过 ✅（含最大边界 x=100/y=60、球面、多特征后）
+
+### Bug 18: 多特征后 on_face 成功率下降
+- **现象**: 随特征数量增加，`begin_sketch_on_face` 失败率上升
+- **根因**: SW COM 内部选择状态累积导致退化
+- **解决**: 每次 `SelectByID2` 尝试前调用 `clear_selection()`；特征创建后自动 `rebuild()`
+
+## 6. 建模方法论
+
+### 旋转体（轴、球、法兰）
+```python
+m.begin_sketch("Front Plane")
+m.polyline([(0,R1), (x1,R1), (x1,R2), (x2,R2), (x2,0), (0,0)])
+m.centerline(-20, 0, 200, 0)   # 旋转轴略超出轮廓
+m.end_sketch()
+m.revolve(360)
+```
+
+### 板/箱体
+```python
+m.begin_sketch("Front Plane")
+m.rect(0, 0, 120, 80)
+m.end_sketch()
+m.extrude(10)
+# 面上画孔
+m.begin_sketch_on_face(0, 0, 10)
+m.circle(0, 0, 10)
+m.end_sketch()
+m.cut(through=True)
+```
+
+### 圆角/倒角
+```python
+# 圆角：取棱边上一点坐标
+m.fillet(5, [(60, 40, 5), (-60, 40, 5)])
+# 倒角
+m.chamfer(1, [(0, 40, 10)], angle_deg=45)
+```
+
+### 🧭 产物归属登记（Bug-16/17 修复 · 小屋必做）
+
+每次 `m.save(...)` 之后，**主动登记产物归属**（取代 mode_gate 的 mtime 猜测）：
+
+```powershell
+python "<工程模式根目录>\tools\mode_gate.py" room-artifact "结构件" "C:\...\DSH_车架底板.SLDPRT" 车架底板
+```
+
+> 【Bug-16/17】原实现只按"最近 mtime"推断，导致一个房间刚产出的文件被同时
+> 归到 4 个房间名下。登记后 room-status 只显示本房间登记过的文件。
+
+### 💓 心跳（Bug-23 修复 · 已非必需）
+
+**小屋无需再手动跳心跳**。存活判定以 **DSH 平台状态**为权威：
+大屋在 `list_agents` 后调
+`python "<工程模式根目录>\tools\mode_gate.py" platform-sync <房间名> running`，
+mode_gate 据此判定死活（10 分钟内有效）。
+
+- `sw_bridge.py` 仍会在取锁/释放时顺手刷新心跳（兼容旧流程）；
+- `room-heartbeat` 命令保留但**不再是判定死活的前提**；
+- 旧文档"心跳超 180s 就判死并自动重启"的规则**已废除** ——
+  实测心跳会因小屋忙于建模而失真（age 涨到 1222~1777s 而平台侧仍 running）。
+
+```powershell
+# 兼容用法（可选）：
+python "<包目录>\mode_gate.py" room-heartbeat "结构件"
+# 权威做法（大屋执行）：
+python "<包目录>\mode_gate.py" platform-sync "结构件" running
+```
+
+---
+
+## 6.5 【第二轮修复】新增建模 API（Bug-34~46）
+
+> 以下 API 为第二轮回归修复新增，**优先使用它们**，可绕开已踩过的坑。
+
+### 🧩 参数化齿轮（Bug-41）—— 不要再用 polyline 逐点画齿形
+
+```python
+# ✅ 推荐：模数/齿数/齿宽 → 一次成型（渐开线齿廓，点数自适应）
+r = m.gear(module_mm=1, teeth=30, thickness_mm=8, bore_dia_mm=5,
+           plane="Top Plane")
+# r["params"] 含分度圆/齿顶圆/齿根圆/基圆直径，可直接写进图纸说明
+
+# 只想要齿廓点集（自己控制特征时）：
+prof = m.involute_gear_profile(1, 30, pressure_angle_deg=20)
+pts = prof["points"]      # 单齿轮廓，16 点（旧方案 300+ 点必失败）
+```
+
+**为什么**：实测用 polyline 逐点画 z=30 齿形（300+ 点）时 SW 判定"轮廓无效"，
+`FeatureExtrusion3` 返回 None。新 API 用解析渐开线 + 齿数自适应点数
+（16 点/齿），既精确又能被 SW 稳定识别。
+
+### 🔩 专用孔命令（Bug-42）—— 不要再用 circle+cut 赌方向
+
+```python
+# ✅ 显式指定孔轴线方向，不再依赖 SW 默认贯穿方向
+m.bore(dia_mm=10, axis="X", through=True)          # 沿 X 的贯穿孔
+m.bore(dia_mm=6, axis="Y", depth_mm=20, through=False)  # 沿 Y 的盲孔
+```
+
+**为什么**：实测 circle+cut(through=True) 的贯穿方向由 SW 决定，
+在轴承座上开 Ø10 内孔时方向偏了，去料率仅 0.7%，被误判失败。
+
+### 📐 尺寸约束（Bug-34）—— annotate 能自动出图的前提
+
+```python
+# ✅ 建模时就加尺寸约束，工程图的 InsertModelAnnotations 才有东西可插
+m.begin_sketch("Top Plane")
+m.rect(0, 0, 300, 180)
+m.add_dimension(-150, -90, 150, -90, value_mm=300)   # 总长
+m.add_dimension(150, -90, 150, 90, value_mm=180)     # 总宽
+# 或批量：
+m.add_key_dimensions([(-150,-90),(150,-90),(150,90),(-150,90)])
+m.end_sketch(); m.extrude(8)
+```
+
+**为什么**：台账回归结论——"annotate 插 0 个标注，因为本轮建模未加约束"。
+不加尺寸 → 模型无可插入的 DisplayDimension → 工程图永远没有尺寸标注。
+若确实没加，可用 `m.annotate_geometry_fallback()` 得到"建议标注清单"手工补。
+
+### 🔗 旋转特征（Bug-40）—— 显式给轴，不依赖按名选面
+
+```python
+# 多特征零件上按名选基准面会降级到实体面，导致 revolve 拿不到轴
+m.revolve_on_face(face_point=(0,0,20), axis_point=(0,0,0), axis_dir=(0,0,1))
+# 之后在草图内画轮廓，再 m.revolve(360)
+```
+
+### 🏗️ 装配摆位与验收（Bug-30/44）
+
+```python
+# 建组件（坐标可能被 SW 忽略，务必用自测验收）
+m.add_component(r"...\DSH_车架底板.SLDPRT", 113, 0, 0)
+
+# ✅ 验收标准（台账明确要求：读回坐标 == 期望才算修好）
+m.verify_component_position(comp, [113, 0, 0])   # -> {"ok": True, ...}
+
+# 一键自测（含补救）
+m.self_test_assembly_placement(r"...\DSH_车架底板.SLDPRT", (113, 0, 0))
+
+# 批量按坐标摆位（内部优先用装配体级 TransformComponent）
+m.place_components_by_coords([("DSH_车架底板-1", 113, 0, 0),
+                              ("DSH_车轮-1", 100, 75, 30)])
+```
+
+**关键**：组件对象（Component2）在 late-binding 下**只读**，
+SetTransform/MoveComponent 全不可用；正确途径是**装配体文档级**的
+`TransformComponent(组件数组, MathTransform)`（已实现为首选路径）。
+
+### 📦 零件归属自检（Bug-38）
+
+```powershell
+# 保存前校验零件是否属于本房间（越界会被拒绝保存）
+python sw_bridge.py check-part "DSH_电机座.SLDPRT" --room 结构件
+# -> {"allowed": false, "owner_room": "传动机构", ...}
+
+# 总装前核对归属与去重
+python "<工程模式根目录>\tools\workflow_gate.py" verify-ownership
+```
+
+---
+
+## 7. 典型工作流（用户约定）
+
+1. **新建零件** → `m = swapi.new_part()`（自动清理遗留文档）
+2. **画草图** → 第一个特征用 `m.begin_sketch("Front Plane")`，后续用 `m.begin_sketch_on_face(x, y, z)`
+3. **画轮廓** → 使用 `rect()`、`circle()`、`line()` 等，每步检查 ActiveSketch
+4. **闭合端点** → `end_sketch()` 前自动调用 `MergePoints(0.0005)`
+5. **创建特征** → `m.extrude(10)` / `m.cut(through=True)` / `m.revolve(360)`
+6. **循环** 步骤 2-5 直到完成
+7. **保存** → `m.save(os.path.join(dir, "DSH_零件名.sldprt"))`
+8. **生成工程图** → `python "<工程模式根目录>\tools\sw_bridge.py" drawing "零件路径"`
+9. **导出 DWG** → `python "<工程模式根目录>\tools\sw_bridge.py" dwg "零件路径"`
+10. **展示** → `python "<工程模式根目录>\tools\sw_bridge.py" show`
+
+**关键规则**：
+- `begin_sketch()` 在多特征后已修复（Bug 16），先退出残留草图模式再重新选面
+- `begin_sketch_on_face()` 优先用**面包围盒匹配+face.Select(True)**选面（Bug 17），可可靠命中最大边界和旋转体曲面
+- 每个 SelectByID2 尝试前自动清除选择状态（Bug 18）
+- 特征创建后自动 rebuild() 刷新 COM 状态（Bug 18）
+- `cut()` 已改用 FeatureExtrusion3 切除模式，不再依赖 FeatureCut3
+- `MergePoints()` 在 end_sketch() 内自动调用，无需手动调用

package/engineering/skills/sw-design/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: sw-design
+description: SolidWorks 机械设计工作流。涵盖三维建模、装配设计、工程图输出、GB/T 制图规范、AutoCAD 几何验证（CADX）和 SolidWorks 桥接。
+whenToUse: 当需要进行 SolidWorks 三维建模、装配设计、出工程图或将 SolidWorks 零件转换为 AutoCAD 图纸时使用
+disable-model-invocation: false
+user-invocable: true
+source: engineering
+provider: filesystem
+---
+
+## SolidWorks 机械设计工作流
+
+### 一、设计前分析
+
+1. **需求分析**
+   - 明确零件的功能要求、材料、热处理、表面处理
+   - 确定载荷类型和大小，评估应力和疲劳风险
+   - 确定工作环境条件（温度、湿度、腐蚀性）
+
+2. **尺寸合理性检查**
+   - 壁厚是否均匀？是否有应力集中风险？
+   - 加工工艺是否可行？脱模斜度是否合适？
+   - 运动部件是否有足够间隙？配合公差是否合理？
+   - 是否考虑热膨胀？
+
+### 二、零件建模流程（solidworks-modeling.md 参考）
+
+1. **草图绘制**
+   - 选择合适的基准面（前视/上视/右视）
+   - 使用几何约束（水平、垂直、共线、同心、相切等）
+   - 使用尺寸约束标注尺寸
+   - 确保草图完全定义（黑色，非蓝色）
+
+2. **特征建模**
+   - 拉伸凸台/基体、旋转凸台/基体
+   - 拉伸切除、旋转切除
+   - 扫描、放样
+   - 添加圆角、倒角
+   - 异形孔向导（标准孔、螺纹孔）
+   - 镜像、阵列（圆周/线性）
+
+   **⚠️ Bug-20 注意 — 多基准面切换后草图定位偏移：**
+   - 肋板/三角加强筋等特征，优先在 **Front Plane**（前视基准面）上绘制轮廓再拉伸，
+     而非在 Top Plane 上定位后再拉伸。Top Plane 上的坐标在多步操作中容易漂移。
+   - 如果必须在非基准面上开草图，使用 `begin_sketch_on_face(x, y, z)` 明确指定坐标，
+     并确保该面与目标特征位置对齐。
+   - 复杂装配体（如 L 形支架），建议全部特征在同一基准面完成后再做装配体。
+
+3. **零件验证**
+   - 质量属性检查（质量、体积、重心）
+   - 干涉检查
+   - 简单应力分析（Simulation Xpress）
+
+### 三、装配体设计
+
+1. **装配顺序规划**
+   - 确定基准零件
+   - 规划装配路径
+   - 考虑装配工具操作空间
+
+2. **配合定义**
+   - 标准配合：重合、平行、垂直、相切、同轴心、距离、角度
+   - 高级配合：对称、宽度、路径配合、线性耦合
+   - 机械配合：凸轮、齿轮、齿条小齿轮、螺旋、万向节
+
+3. **装配体验证**
+   - 干涉检查
+   - 碰撞检查
+   - 动态间隙检查
+   - 爆炸视图生成
+
+### 四、工程图输出
+
+1. **视图选择**
+   - 标准三视图（前视、上视、右视）+ 等轴测
+   - 投影视图、剖视图（全剖、半剖、局部剖、阶梯剖）
+   - 局部放大图、辅助视图
+
+2. **标注规范（参考 references/gbt-drafting.md）**
+   - 尺寸标注（GB/T 4458.4）
+   - 公差标注（GB/T 1800 系列）
+   - 表面粗糙度（GB/T 131）
+   - 形位公差（GB/T 1182）
+   - 标题栏（GB/T 10609.1）
+
+3. **图层规范（参考 references/autocad-workflow.md）**
+   - `OUTLINE` / `THIN` / `CENTER` / `HIDDEN` / `DIM` / `TEXT` / `HATCH`
+
+### 五、AutoCAD 几何验证（CADX）
+
+> 参考：`references/autocad-workflow.md`
+
+从 SolidWorks 生成的工程图导出为 DWG/DXF 后，可使用 CADX 进行几何验证：
+
+```powershell
+# 导出 DXF（SolidWorks 工程图 → DXF）
+python "<工程模式根目录>\tools\sw_bridge.py" export-dxf "<输出.dxf>"
+
+# 运行 CADX 几何验证（7 项检查）
+python "<工程模式根目录>\tools\sw_bridge.py" cad-validate "<输出.dxf>"
+```
+
+**验证流程：**
+1. 读取 DXF 中所有实体（LWPOLYLINE、LINE、CIRCLE、DIMENSION 等）
+2. 逐项执行 7 种检查，记录问题位置和严重等级
+3. 返回 JSON 摘要：`{status: "PASSED/REVIEW/FAILED", critical, warning, info, issues: [...]}`
+4. CRITICAL 项必须在发布前修复
+
+### 六、参考文档
+
+- `references/gbt-drafting.md` — GB/T 机械制图国家标准（线型、标注、视图、剖视）
+- `references/autocad-workflow.md` — AutoCAD 工作流、CADX 验证命令、坐标约定

package/engineering/skills/sw-design/references/autocad-workflow.md

@@ -0,0 +1,81 @@
+# AutoCAD 工作流与几何验证（DSH 工程模式）
+
+> 来源：CADX 工程模式 + AutoCAD-skills mechanical-drafting-gbt
+> 用途：指导 AI 操作 AutoCAD 时的流程规范、验证规则和坐标约定。
+
+## 连接与安全
+
+- 优先挂接已有 AutoCAD 进程，不强制启动或关闭用户会话
+- 所有 COM 操作使用 dynamic dispatch（`win32com.client.dynamic.Dispatch`），不依赖类型库注册
+- AutoCAD busy 时（RPC_E_CALL_REJECTED）先发送 ESC 取消挂起命令，再重试
+- 坐标单位统一 mm，与 swapi 一致
+
+## 几何验证流程（7 项检查）
+
+每次生成或修改 AutoCAD 图纸后，必须运行以下验证：
+
+| # | 检查项 | 严重等级 | 说明 |
+|---|--------|---------|------|
+| 1 | UNCLOSED_POLYLINE | WARNING/INFO | 应闭合但开口 > 10mm 的多段线 |
+| 2 | OVERLAPPING_GEOMETRY | CRITICAL | 墙体/轮廓线错误重叠 |
+| 3 | ROOM_TOO_SMALL | CRITICAL | 房间面积低于 GB/T 最低标准 |
+| 4 | ROOM_ASPECT_RATIO | WARNING | 长宽比超出合理范围（> 3:1） |
+| 5 | WALL_TOO_THIN | CRITICAL | 平行墙间距 < 100mm（机械）或 150mm（建筑） |
+| 6 | MISSING_ELEMENTS | WARNING/INFO | 房间缺少门或窗 |
+| 7 | DIMENSION_MISMATCH | CRITICAL | 标注值与实际几何不符（误差 > 2%） |
+
+验证入口：
+```powershell
+python "<工程目录>\sw_bridge.py" cad-validate <图纸.dwg 或 .dxf> [规则文件]
+# 或直连 AutoCAD：
+python "<工程目录>\sw_bridge.py" cad-validate-live
+```
+
+## 坐标与命名约定
+
+- **单位**：所有尺寸 mm（整数），输出前 ×1000 换算
+- **图层命名**：大写 + 字母数字下划线，如 `OUTLINE`、`DIM`、`CENTER`
+- **线型层级**：
+  - `OUTLINE`：粗实线（可见轮廓）
+  - `THIN`：细实线（尺寸、剖面线）
+  - `CENTER`：细点画线（轴线）
+  - `HIDDEN`：细虚线（不可见轮廓）
+  - `HATCH`：细实线（剖面填充）
+  - `DIM`：细实线（尺寸标注）
+  - `TEXT`：细实线（文字说明）
+
+## CAD 执行铁律
+
+1. **事务原子性**：每次批量创建实体前记录句柄，失败时仅回滚该批次
+2. **后验验证**：每创建实体后立即读取返回句柄，比对类型/图层/坐标
+3. **禁止猜测**：未确定的配合/公差/材料一律标 `TBD`，不自行补全
+4. **视图一致性**：多视图必须共享同一参数源，禁止从不同视角独立估算
+5. **比例真实性**：标题栏声明 `1:1` 时，实际导出比例必须确实是 1:1；`FIT`/`NTS` 不得与固定比例混用
+
+## 快速参考命令
+
+```powershell
+# 环境自检
+python "<工程模式根目录>\tools\sw_bridge.py" doctor
+
+# 连接状态
+python "<工程模式根目录>\tools\sw_bridge.py" status
+
+# 列出已打开文档
+python "<工程模式根目录>\tools\sw_bridge.py" list
+
+# SolidWorks 零件 → 工程图
+python "<工程模式根目录>\tools\sw_bridge.py" drawing <零件.sldprt>
+
+# 工程图 → DWG（AutoCAD 可读）
+python "<工程模式根目录>\tools\sw_bridge.py" dwg <零件.sldprt>
+
+# 导出 DXF（供 CADX 验证）
+python "<工程模式根目录>\tools\sw_bridge.py" export-dxf <图纸.dxf>
+
+# AutoCAD 几何验证
+python "<工程模式根目录>\tools\sw_bridge.py" cad-validate <图纸.dxf>
+
+# 展示 SolidWorks 窗口 + 截图
+python "<工程模式根目录>\tools\sw_bridge.py" show
+```