dsh-engineering-ui 0.0.0-stage → 1.5.0

package/engineering/skills/sw-design/references/gbt-drafting.md

@@ -0,0 +1,71 @@
+# GB/T 机械制图参考标准（DSH 工程模式）
+
+> 来源：AutoCAD-skills mechanical-drafting-gbt / GBT 标准清单
+> 用途：AI 生成或验证工程图时，作为尺寸标注、视图布局、线型规范的参考依据。
+
+## 核心标准清单
+
+| 标准号 | 名称 |
+|--------|------|
+| GB/T 4457.4-2002 | 机械制图 图纸幅面和格式 图线 |
+| GB/T 4458.4-2003 | 机械制图 尺寸注法 |
+| GB/T 4458.5-2003 | 机械制图 公差与配合的注法 |
+| GB/T 14689-2008 | 技术制图 图纸幅面和格式 |
+| GB/T 14690-1993 | 技术制图 比例 |
+| GB/T 14691-1993 | 技术制图 字体 |
+| GB/T 14692-2008 | 技术制图 投影法 |
+| GB/T 17451-1998 | 技术制图 视图 |
+| GB/T 17452-1998 | 技术制图 剖视图和断面图 |
+| GB/T 10609.1-2008 | 技术制图 标题栏 |
+| GB/T 1182-2018 | 产品几何技术规范（GPS）几何公差 |
+| GB/T 131-2006 | 产品几何技术规范 表面结构 轮廓法 |
+| GB/T 1804-2000 | 一般公差 线性尺寸的未注公差 |
+
+## 实践规则
+
+### 线型层级
+
+- **粗实线**：可见轮廓线、可见棱边
+- **细实线**：尺寸线、尺寸界线、剖面线、指引线
+- **细点画线**：轴线、对称中心线（需超出轮廓 2~5mm）
+- **细虚线**：不可见轮廓线（剖面中减少可见性时用）
+- **粗/细线比**：约 2:1，视觉区分明显即可
+
+### 视图与剖视
+
+- 优先采用**第一角投影**（GB/T 默认），在标题栏注明投影方法
+- 主视图、俯视图、右视图严格对齐：主俯同 X（长对正），主右同 Y（高平齐）
+- 剖视图需要剖切符号和方向标记；位置明确时可省略
+- 剖面线角度统一 45°，同一零件各视图剖面线方向和间距一致
+- 螺纹孔、键槽、孔等标准件结构用简化画法，不画出每一个齿/旋棱
+
+### 标注规范
+
+- 每个尺寸只注一次，不重复
+- 最短尺寸靠近图形，外侧尺寸层层放大
+- 直径标注在非圆视图上，加 Φ 符号；半径加 R
+- 尺寸从功能基准（datum）出发，避免封闭尺寸链
+- 轴类零件：直径在纵向视图标注，长度尺寸分层排列
+- 文字统一水平方向，高度按选用的标题栏系列（常见 3.5mm）
+
+### 轴类零件专项
+
+- 端倒角几何表示并标注一次（如 `2×45°`）
+- 轴肩过渡需明确：圆角半径或退刀槽
+- 轴承位和配合位注明公差带（如 `Φ50h6`）；未确定时标 `TBD`
+- 键槽宽度、深度、长度全部标注，`30×5` 单独出现时须说明约定
+- 表面粗糙度附着在对应表面或作为总体要求，不可悬空装饰
+
+### 分级验证
+
+**Pass 1 — 全图一致性**
+- 闭合边界、零厚度材料、意外重叠、重复实体、相切断裂、同轴偏移
+- 计算链长、半径/直径、对称偏移、角度、节距与显示尺寸交叉验证
+
+**Pass 2 — 独立交叉视图重建**
+- 从两个视图独立重建特征，预测第三视图位置并比对
+- 每个剖视对照剖切面，剖面材料和孔洞前后关系正确
+
+**Pass 3 — 发布检查**
+- 检查修正冲突、高风险特征、功能基准、关键尺寸
+- 最终导出为 PDF/DWG 后复查：字体丢失、裁剪、比例错误、线宽失效

package/engineering/skills/sw-to-cad/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: sw-to-cad
+description: >-
+  SolidWorks 零件一键转换为 CAD 工程图（DWG/PDF）。
+  支持从 .sldprt 零件生成标准三视图工程图，并导出为 DWG（AutoCAD 可用）或 PDF。
+whenToUse: >-
+  当用户要求把 SolidWorks 零件转成 CAD 图纸、导出工程图、生成三视图、
+  或需要 .dwg/.pdf 格式的图纸时使用。
+source: engineering
+provider: filesystem
+---
+
+# SW → CAD 图纸转换指南
+
+## 功能概览
+
+将 SolidWorks 3D 零件（.sldprt）一键转换为：
+- **工程图**（.slddrw）：含标准三视图 + 等轴测
+- **DWG**（.dwg）：可直接用 AutoCAD 打开编辑
+- **PDF**（.pdf）：适合打印和分享
+
+## 使用方法
+
+### 命令格式
+
+```powershell
+# 生成工程图
+python "<包目录>\sw_bridge.py" drawing <零件路径> [输出路径]
+
+# 生成 DWG（推荐用于 AutoCAD）
+python "<包目录>\sw_bridge.py" dwg <零件路径> [输出路径]
+
+# 导出 PDF（快速预览）
+python "<包目录>\sw_bridge.py" export-pdf <输出路径>
+
+# 展示当前窗口
+python "<包目录>\sw_bridge.py" show
+```
+
+### 示例
+
+```powershell
+# 从零件生成 DWG
+python "C:\Users\...\tools\sw_bridge.py" dwg "C:\Users\...\DSH_法兰盘.sldprt" "C:\Users\...\DSH_法兰盘.dwg"
+
+# 从零件生成工程图
+python "C:\Users\...\tools\sw_bridge.py" drawing "C:\Users\...\DSH_法兰盘.sldprt"
+```
+
+## AI 调用流程
+
+当用户说"把这个零件转成 CAD 图纸"时：
+
+### 步骤 1：确认零件路径
+```powershell
+python "sw_bridge.py" list
+# 获取当前打开的零件列表
+```
+
+### 步骤 2：生成工程图
+```powershell
+python "sw_bridge.py" drawing "<零件路径>"
+```
+输出：
+- 自动创建三视图（前/俯/右）+ 等轴测
+- 保存为 `.slddrw` 文件
+- 返回截图路径
+
+### 步骤 3：导出 DWG（可选）
+```powershell
+python "sw_bridge.py" dwg "<零件路径>" "<输出.dwg>"
+```
+输出：
+- 自动转换为 DWG 格式
+- 可直接用 AutoCAD 打开
+
+### 步骤 4：展示结果
+```powershell
+python "sw_bridge.py" show
+```
+展示当前 SolidWorks 窗口截图给用户验收。
+
+## 技术原理
+
+1. **打开零件**：通过 COM 接口启动 SolidWorks 并打开零件
+2. **创建工程图**：使用 `NewDocument` 创建绘图文档
+3. **插入视图**：
+   - `CreateDrawViewFromModelView3` 插入标准视图
+   - 前视图居中，俯视图在下，右视图在右，等轴测在右上
+4. **保存**：`SaveAs3` 保存为 .slddrw
+5. **导出 DWG**：重新打开工程图，用 `SaveAs3` 导出为 DWG
+
+## 几何验证（CADX）
+
+生成 DWG/DXF 后，推荐使用 CADX 进行 7 项几何验证，确保图纸质量：
+
+```powershell
+# 导出 DXF（SolidWorks 工程图 → DXF）
+python "<工程模式根目录>\tools\sw_bridge.py" export-dxf "<输出.dxf>"
+
+# 运行几何验证
+python "<工程模式根目录>\tools\sw_bridge.py" cad-validate "<输出.dxf>"
+```
+
+验证项：未闭合多段线、重叠几何、尺寸过小、长宽比异常、墙厚不足、缺失元素、标注不一致。
+详见 `engineering/skills/sw-design/references/autocad-workflow.md`。
+
+## 已知限制
+
+1. **自动标注**：当前版本不自动添加尺寸标注，需要手动标注
+2. **图框**：使用默认 A3 图纸大小，不包含标题栏
+3. **复杂装配体**：仅支持单零件，装配体需要拆解后分别出图
+4. **模板**：自动探测绘图模板，如果找不到可能失败
+5. **AutoCAD 依赖**：CADX 验证需要已安装 AutoCAD（可选，非必需）
+
+## 后续改进方向
+
+- 自动添加尺寸标注
+- 自定义图纸大小（A4/A3/A2/A1/A0）
+- 添加标题栏和材料明细表
+- 支持直接导出 DXF 格式

package/engineering/skills/webots-simulation/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: webots-simulation
+description: Use when an engineering task requests Webots simulation, robot drive or sensor experiments, simulation reports, collision evidence, or tracing a simulation issue to a SolidWorks assembly. Not for strength, fatigue, FEA or arbitrary 2D-to-3D reconstruction.
+---
+
+# Webots simulation
+
+This release supplies sol peripheral contracts, stored reports and bounded fixtures. Real execution, CAD conversion and safe return-to-SW cores A01–A04 are **not implemented**. Do not claim a completed engineering loop.
+
+Read [integration-contract](../../docs/webots-mcp/integration-contract.md) for state/context and [report-viewer](../../docs/webots-mcp/report-viewer.md) for the live reader contract. Use [input-matrix](../../docs/webots-mcp/input-matrix.md) for supported input and [recipes-scenes](../../docs/webots-mcp/recipes-scenes.md) when preparing a bounded experiment.
+
+1. Discover the actual MCP server/tools; configured serverName is `webots` (`mcp__webots__sim_status`, `sim_report`, `sim_evidence`, `sim_job`). A missing tool is unavailable, never a prompt to emulate successful execution. Supply the **live authenticated** task/room binding and a request ID, not copied fixture IDs. The UI reader obtains it from `/dsh-engineering-ui/webots-context?sessionId=<live agent id>`; 403 `CONTEXT_UNAVAILABLE` means no authorized read. Never create a room or rewrite workflow state to bypass it.
+2. Read status and current owned reports first. The connection green light only proves installation/process availability. Keep `provenance`, `core_ready`, `execution_state`, `snapshot_at`, `stale`, `unsupported`, source revision and missing information visible. `fake`, `fixture`, `synthetic`, static validation, screenshots and empty contacts do not prove physical PASS or READY. `supported` describes support, not an experiment verdict.
+3. Use `sim_report` with `run_id` and one of `model_manifest`, `conversion_report`, `experiment_report`. Use `sim_evidence` for bounded worker-log pages: forward `next_offset` and the prior `sha256` as `expected_sha256`. A changed snapshot requires a fresh offset 0; do not concatenate different snapshots. Keep all candidate components and observed/derived/suspected evidence levels; a suspected or merged-body candidate is not a root cause.
+4. Prepare, rather than dispatch, currently unsupported experiments. Capture source/configuration/hash, model/world versions, units/frame sources, collision coverage, initial state, drive, sensor observations, seed/step and resource/stop budgets. Generated terrain worlds have no robot or calibrated physics. Missing mass, inertia, mapping or thresholds remain unknown, not invented defaults. Coordinate/inertia A01, joint/identity A02, attribution/SW changes A03 and physical/worker recovery A04 require their real implementation and verification.
+5. On `OUTCOME_UNKNOWN`, disconnect or action timeout, preserve operation/job/run/generation and the last confirmed progress; read status/job and evidence. Do **not** resend the action, even after reconnect. Cancellation acknowledgement does not prove rollback or process exit. Cleanup only verified session-owned processes; never terminate all Webots processes.
+
+SW changes require current source revision and unique persistent instance identity, evidence-based attribution, authorized parameter scope, snapshot/rollback and same-condition retest. This version cannot satisfy that chain: report the missing core and stop automatic modification. A user request to investigate is not permission to select an arbitrary candidate or change gravity, mass, friction, collision switches or pass thresholds to manufacture improvement.
+
+## 与工程模式主流程的接口（D1 接通说明）
+上面那段是原交付自带的「S07 阶段」说明，保留作证据口径。下面是**本仓库实际接入**后的走法，
+两者冲突时以本节为准（本节描述的是已经落地的代码）。
+
+### 接口面
+| 方向 | 接口 | 位置 |
+|---|---|---|
+| 模型进仿真 | `webots_mcp.pipeline publish-part` / `convert-part` | `engineering/tools/webots_mcp/` |
+| 归属授权 | `resolveWebotsContext()` + `ctx.tools.guard` | `engineering/plugins/dsh-engineering-ui/lib/webots.js` |
+| 只读证据 | `/dsh-engineering-ui/webots-context|-report|-evidence|-attribute` | 同上，复用 `guardRoute` |
+| 设置页状态 | 连接区「Webots连接」（只显示安装/进程可用） | `lib/client.js` |
+| 报告面板 | 组件 `EngWebotsPanel`（**已从设置页移除入口**，组件保留可复用） | `lib/client.js` |
+| 人设约束 | persona 的「## 仿真（Webots，可选）」段 | `preset-engineering.patch.yml` |
+| 模式入口 | mode-selection 的「🟦 Webots 仿真分支」 | `engineering/skills/mode-selection/SKILL.md` |
+
+### 三个必须记住的耦合点
+1. **身份不是猜的**：`task_id` 来自 `workflow_state.json`，`room_id` 来自
+   `mode_state.json` 里 `active=true` 且 `subagents[房间].id == 当前 agent.id` 的**唯一**房间。
+   所以 —— 仿真必须发生在 `select` 之后、`room-end` 之前；房间已经收尾就没有合法身份了。
+2. **不抢 SW 锁**：仿真链路不调 `sw_bridge`，因此不会进 `mode_gate` 的 FIFO 队列。
+   但**生成输入的那一步**（SW 导出）照旧要走原来的 SW 锁，不能借仿真名义绕开。
+3. **失败要说失败**：`RUNTIME_NOT_READY` / `CALIBRATION_REQUIRED` / `CONTEXT_UNAVAILABLE`
+   都是**正常返回值**，不是异常。把它们改写成"成功"是本项目最严重的一类 bug。
+
+### 当前能力边界（2026-11-05 实测）
+| 能做 | 不能做 |
+|---|---|
+| 离线把合成/真实零件捕获转成 URDF + PROTO（`urdf2webots 2025.0.0` 已跑通） | 原生 SW→URDF 的坐标系/惯量标定（A01） |
+| 读已存报告与日志证据（字节分页 + SHA-256） | 自动关节推断（A02，`blocked_native`） |
+| 归属校验、代际、操作幂等 | 自动根因回写 SW（A03/A04） |
+| `sim_status` 等只读查询 | 真实物理 PASS 判定（本版恒 `physical_validation=not_run`） |
+
+### 快速自检（不碰 DSH、不碰 SW、不碰 Webots）
+```powershell
+& $python -B -m unittest discover -s engineering/tests/webots_mcp -p 'test_*.py'   # 101 项
+node --test --test-force-exit engineering/plugins/dsh-engineering-ui/test/webots-*.test.mjs
+```
+
+For isolated tests, first create and verify an existing absolute `DSH_STATE_DIR`; explicitly isolate `DSH_HOME`, profile and engineering root. Do not migrate live state or sync/deploy/restart the real installation. Preserve raw evidence and its hash, and distinguish local fixtures, the bounded historical Webots probe, real CAD evidence and unexecuted work in the result.

package/engineering/tools/LICENSE.Auto-SolidWorks

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Auto SolidWorks contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/engineering/tools/_plugin_paths.py

@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+r"""_plugin_paths.py —— 定位 dsh-engineering-ui 插件源码（工作区 / 安装副本都适用）
+
+═══════════════════════════════════════════════════════════════════════════
+【为什么需要这个模块】
+
+回归测试里多个文件都硬编码了
+    os.path.join(HERE, "..", "plugins", "dsh-engineering-ui", "lib", "xxx.js")
+
+这个路径只在【工作区副本】成立：
+    <repo>/engineering/tools/  →  ../plugins/dsh-engineering-ui/lib/*.js   ✅
+
+而在【安装副本】上根本不存在：
+    %USERPROFILE%\.dsh\.agent-presetsengineering	ools\
+      ../plugins/...                                         ❌ 没有这个目录
+
+因为安装时插件被放到了 profile 的 node_modules：
+    %USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-engineering-ui\
+
+后果：测试在安装副本上一跑就 FileNotFoundError，
+      表现为"回归失败"，实际是测试自己的路径假设错了 ——
+      这会掩盖真正的回归问题（谁也不想在 30 个 ❌ 里找那 1 个真的）。
+═══════════════════════════════════════════════════════════════════════════
+"""
+import os
+
+
+def _candidates():
+    """插件 lib 目录的候选位置（按优先级）。"""
+    here = os.path.dirname(os.path.abspath(__file__))
+    eng_root = os.path.dirname(here)          # .../engineering
+    out = [
+        # ① 工作区布局：<repo>/engineering/plugins/dsh-engineering-ui/lib
+        os.path.join(eng_root, "plugins", "dsh-engineering-ui", "lib"),
+        # ② 上层工作区（有些布局把 plugins 放在仓库根）
+        os.path.join(os.path.dirname(eng_root), "plugins",
+                     "dsh-engineering-ui", "lib"),
+    ]
+    # ③ 安装副本：<DSH_HOME>/profiles/<profile>/node_modules/dsh-engineering-ui/lib
+    dsh_home = ""
+    for k in ("DSH_HOME",):
+        v = (os.environ.get(k) or "").strip()
+        if v:
+            dsh_home = v
+            break
+    if not dsh_home:
+        home = (os.environ.get("USERPROFILE") or os.environ.get("HOME") or "").strip()
+        if home and not home.startswith("~"):
+            dsh_home = os.path.join(home, ".dsh")
+    if dsh_home:
+        prof_dir = os.path.join(dsh_home, "profiles")
+        try:
+            for p in sorted(os.listdir(prof_dir)):
+                out.append(os.path.join(prof_dir, p, "node_modules",
+                                        "dsh-engineering-ui", "lib"))
+        except Exception:
+            pass
+        out.append(os.path.join(dsh_home, "node_modules",
+                                "dsh-engineering-ui", "lib"))
+    return out
+
+
+def plugin_lib_dir():
+    """返回存在的插件 lib 目录；都找不到返回 None。"""
+    for d in _candidates():
+        try:
+            if os.path.isdir(d):
+                return d
+        except Exception:
+            continue
+    return None
+
+
+def plugin_file(name):
+    """返回插件某个文件（如 'client.js' / 'index.js'）的绝对路径；找不到返回 None。"""
+    d = plugin_lib_dir()
+    if not d:
+        return None
+    p = os.path.join(d, name)
+    return p if os.path.isfile(p) else None
+
+
+def read_plugin_file(name):
+    """读取插件文件内容；找不到返回 None（调用方应据此 skip 而非 fail）。"""
+    p = plugin_file(name)
+    if not p:
+        return None
+    try:
+        import io
+        with io.open(p, encoding="utf-8") as f:
+            return f.read()
+    except Exception:
+        return None