dsh-engineering-ui 0.0.0-stage → 1.5.0

package/engineering/tools/env_check.py

@@ -0,0 +1,467 @@
+# -*- coding: utf-8 -*-
+r"""env_check.py —— 工程模式【本机环境自检】（设置页「工程环境检查」的后端）
+
+═══════════════════════════════════════════════════════════════════════════
+【为什么需要它】
+用户在学校微机房实测到的现象，本质是同一件事：
+  工程模式默认"这台电脑什么都有"，一旦缺 Python 3.8+（64 位）、缺 pywin32、
+  缺 numpy，或者 SW/CAD 装在了别的盘 —— 表现就变成"某些设置静默失效"，
+  而界面不会告诉用户少了什么。
+
+用户的要求（原话）：
+  「在设置 → 工程模式中，连接区上面再加一个『检查电脑是否有对应的环境』，
+   然后写一段提示词自己发给新的对话，新的 Agent 对话就自己去查看看少啥，
+   自己安装。」
+
+【本模块提供什么】
+  1) probe()          —— 一次性把依赖查清楚，返回结构化结论
+                         （ok / warn / missing，每一项都带"怎么修"）
+  2) install_prompt() —— 生成一段**可直接发给新对话**的提示词：
+                         把缺失项、期望版本、可用命令、验收标准全部写进去，
+                         新 Agent 照着做就行，不需要用户自己翻译报错。
+  3) 交付目录 / 软件路径等"本机设置"的读写入口（转发到 settings.py）。
+
+【为什么不用 import 探测就下结论】
+  微机房最容易骗人的一件事：import win32com 在宿主进程里可能成功
+  （宿主用的是随包 Python），但真正跑 sw_bridge.py 的那个解释器根本没有。
+  所以这里对 Python 的检查一律【用目标解释器起子进程跑一段探针】，
+  而不是在当前进程里 try/import。
+═══════════════════════════════════════════════════════════════════════════
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+
+# ── 依赖清单（单一事实源：UI 文案、提示词、自检都读它）────────────────────
+DEPS = [
+    {"id": "python", "name": "Python 解释器（≥ 3.8，64 位）",
+     "why": "按 README 的最低要求检查；工具使用 annotations、dataclasses、"
+            "subprocess.run(capture_output=True) 等较新语法与标准库接口。"},
+    {"id": "pywin32", "name": "pywin32（SolidWorks / AutoCAD 的 COM 自动化）",
+     "why": "没有它就完全无法驱动 SolidWorks 与 AutoCAD。",
+     "kind": "module", "module": "win32com.client", "pip": "pywin32"},
+    {"id": "numpy", "name": "numpy（有限元求解 Level 1）",
+     "why": "物理在环的纯 Python FEA（CST/CTE 单元）依赖它；"
+            "缺了只能退回 Level 0 解析解，薄壁件判定会变粗。",
+     "kind": "module", "module": "numpy", "pip": "numpy"},
+    {"id": "ezdxf", "name": "ezdxf（DXF 解析 / CADX 几何验证）",
+     "why": "cad-validate 的 7 项检查需要读 DXF；缺了 CADX 验证直接不可用。",
+     "kind": "module", "module": "ezdxf", "pip": "ezdxf"},
+    {"id": "shapely", "name": "shapely（几何布尔运算）",
+     "why": "DXF 重叠/相交检查依赖它；缺了该项检查会被跳过。",
+     "kind": "module", "module": "shapely", "pip": "shapely"},
+    {"id": "PIL", "name": "Pillow + mss（截图 / 看图矫正）",
+     "why": "「建模后必须看图」这条门禁靠截图证据；缺了截图链路会降级。",
+     "kind": "module", "module": "PIL", "pip": "Pillow mss"},
+]
+
+PROBE_CODE = r'''
+import json, sys
+out = {"ok": True, "version": "%d.%d.%d" % sys.version_info[:3],
+       "executable": sys.executable, "prefix": sys.prefix,
+       "bits": 64 if sys.maxsize > 2**32 else 32,
+       "modules": {}, "error": None}
+for mod, shown in (("win32com.client", "pywin32"), ("numpy", "numpy"),
+                   ("ezdxf", "ezdxf"), ("shapely", "shapely"),
+                   ("PIL", "PIL"), ("mss", "mss")):
+    try:
+        __import__(mod)
+        out["modules"][shown] = {"ok": True, "version": None}
+    except Exception as e:
+        out["modules"][shown] = {"ok": False, "error": repr(e)[:200]}
+if sys.version_info < (3, 8):
+    out["ok"] = False
+    out["error"] = "Python 版本过低（需要 3.8+，当前 %d.%d）" % sys.version_info[:2]
+elif out["bits"] != 64:
+    out["ok"] = False
+    out["error"] = "需要 64 位 Python，当前为 32 位"
+print(json.dumps(out))
+'''
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# 解释器发现
+# ══════════════════════════════════════════════════════════════════════════
+
+def _candidates():
+    """候选解释器（去重保序）。
+
+    优先使用本机设置、环境变量和当前解释器；其后先试 py -3，
+    避免只认 PATH 里排在前面的旧版本。
+    """
+    out = []
+    try:
+        import settings as _settings
+        _p = _settings.python_exe()
+        if _p:
+            out.append(_p)
+    except Exception:
+        pass
+    v = (os.environ.get("DSH_PYTHON") or "").strip().strip('"')
+    if v:
+        out.append(v)
+    out.extend([sys.executable, "py", "python", "python3"])
+    seen, uniq = set(), []
+    for c in out:
+        if not c:
+            continue
+        key = str(c).lower()
+        if key in seen:
+            continue
+        seen.add(key)
+        uniq.append(c)
+    return uniq
+
+
+def _run_probe(exe):
+    """用某个解释器跑探针脚本，返回 (ok, data, raw_error)。"""
+    args = [exe]
+    if os.path.basename(exe).lower() in ("py", "py.exe"):
+        args.append("-3")
+    try:
+        r = subprocess.run(args + ["-c", PROBE_CODE],
+                           capture_output=True, text=True, timeout=25)
+    except Exception as e:
+        return False, None, "无法执行 %r: %r" % (exe, e)
+    stdout = (r.stdout or "").strip()
+    stderr = (r.stderr or "").strip()
+    if not stdout:
+        # 典型旧版 Python：语法错误直接死在 stderr，stdout 空 ——
+        # 这正是微机房"插件解析失败"的现场。
+        return False, None, (stderr or
+                             "无输出（可能是 Python 版本过低，语法错误只打到 stderr）")[-600:]
+    try:
+        data = json.loads(stdout.splitlines()[-1])
+    except Exception:
+        return False, None, "探针输出不是 JSON: %s" % stdout[-300:]
+    return bool(data.get("ok")), data, (data.get("error") or stderr[-600:] or None)
+
+
+def probe_python():
+    """挑一个能满足最低要求的解释器，并返回它的模块状况。"""
+    tried = []
+    for exe in _candidates():
+        ok, data, err = _run_probe(exe)
+        tried.append({"exe": exe, "version": (data or {}).get("version"),
+                      "ok": bool(ok), "error": err})
+        if ok and data:
+            return {"ok": True, "chosen": data.get("executable"),
+                    "version": data.get("version"),
+                    "bits": data.get("bits"),
+                    "executable": data.get("executable"),
+                    "modules": data.get("modules") or {},
+                    "tried": tried, "note": None}
+    return {"ok": False, "chosen": None, "version": None, "modules": {},
+            "tried": tried,
+            "error": "没有找到可用的 Python 3.8+（64 位）解释器",
+            "note": ("候选全部失败。PATH 中的 Python 可能版本过低或为 32 位。"
+                     "解决：在设置页「工程环境检查」里指定 python.exe，"
+                     "或安装 Python 3.11/3.12 并勾选 Add to PATH。")}
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# 软件路径 / 设置
+# ══════════════════════════════════════════════════════════════════════════
+
+def probe_sw_path():
+    mine = None
+    try:
+        import settings as _settings
+        mine = _settings.sw_exe()
+    except Exception:
+        pass
+    try:
+        import swapi
+        found = swapi.find_sldworks_exe()
+    except Exception as e:
+        return {"ok": bool(mine), "path": mine,
+                "error": "探测 swapi 失败: %r" % (e,)}
+    return {"ok": bool(found), "path": found or mine,
+            "from_settings": bool(mine),
+            "error": None if found else
+                     "未找到 SLDWORKS.exe（注册表 / 常见安装目录 / 环境变量都没命中）"}
+
+
+def probe_cad_path():
+    try:
+        import conn_state
+        p = conn_state._find_acad_exe()
+    except Exception as e:
+        return {"ok": False, "path": None, "error": "探测失败: %r" % (e,)}
+    return {"ok": bool(p), "path": p,
+            "error": None if p else "未找到 acad.exe（可选组件：缺了仍可出 SLDDRW）"}
+
+
+def probe_settings():
+    try:
+        import settings as _settings
+        root, src = _settings.delivery_root()
+        rep = _settings.report()
+        writable = False
+        try:
+            os.makedirs(root, exist_ok=True)
+            probe_file = os.path.join(root, ".dsh_write_probe")
+            with open(probe_file, "w", encoding="utf-8") as f:
+                f.write("ok")
+            os.remove(probe_file)
+            writable = True
+        except Exception:
+            writable = False
+        return {"ok": bool(writable), "delivery_root": root,
+                "delivery_root_source": src, "writable": writable,
+                "file": rep.get("file"),
+                "ignored": [r for r in rep.get("paths", [])
+                            if r.get("usable") is False],
+                "error": None if writable else ("交付目录不可写：%s" % root)}
+    except Exception as e:
+        return {"ok": False, "error": "读取设置失败: %r" % (e,)}
+
+
+def probe_engine():
+    """工程模式自身文件是否完整（换机 / 半拷贝时很容易缺）。"""
+    need = ["sw_bridge.py", "swapi.py", "mode_gate.py", "workflow_gate.py",
+            "defense_gate.py", "physics_bridge.py", "conn_state.py", "settings.py"]
+    missing = [n for n in need if not os.path.isfile(os.path.join(HERE, n))]
+    return {"ok": not missing, "tools_dir": HERE, "missing": missing,
+            "error": ("缺少核心脚本：%s" % ", ".join(missing)) if missing else None}
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# 汇总
+# ══════════════════════════════════════════════════════════════════════════
+
+def probe(full=True):
+    """完整自检。返回 {ok, status, items[], summary, counts}。
+
+    status: 'ok'（全绿）/ 'warn'（只缺可选项）/ 'bad'（缺必需项）
+    """
+    items = []
+
+    def add(item_id, name, state, detail, fix=None, optional=False):
+        items.append({"id": item_id, "name": name, "state": state,
+                      "optional": bool(optional),
+                      "detail": detail or "", "fix": fix or ""})
+
+    eng = probe_engine()
+    add("engine", "工程模式核心脚本", "ok" if eng["ok"] else "missing",
+        eng["tools_dir"] if eng["ok"] else eng.get("error"),
+        "重新运行 install-0.2.0.ps1 或 sync-to-dsh.ps1，把 tools/ 同步到安装副本")
+
+    py = probe_python()
+    if py["ok"]:
+        add("python", "Python 解释器", "ok",
+            "%s（%s，%s 位）" % (py["version"], py["chosen"], py["bits"]))
+    else:
+        add("python", "Python 解释器", "missing", py.get("error") or "未找到",
+            py.get("note") or "安装 Python 3.11/3.12 并加入 PATH，"
+                              "或在设置里指定 python.exe")
+
+    mods = py.get("modules") or {}
+    for dep in DEPS:
+        if dep.get("kind") != "module":
+            continue
+        m = mods.get(dep["id"])
+        if m is None:
+            add(dep["id"], dep["name"], "unknown",
+                "无法确认（Python 解释器不可用）", "先解决 Python 解释器问题")
+        elif m.get("ok"):
+            add(dep["id"], dep["name"], "ok", "已安装")
+        else:
+            add(dep["id"], dep["name"], "missing", (m.get("error") or "导入失败"),
+                '-m pip install %s' % (dep.get("pip") or dep["id"]))
+
+    sw = probe_sw_path()
+    add("solidworks", "SolidWorks 安装路径",
+        "ok" if sw["ok"] else "missing",
+        sw.get("path") or sw.get("error"),
+        "在连接区点「SOLIDWORKS连接」重新探测；"
+        "或在「工程环境检查」里手动指定 SLDWORKS.exe")
+    cad = probe_cad_path()
+    add("autocad", "AutoCAD 安装路径",
+        "ok" if cad["ok"] else "warn",
+        cad.get("path") or cad.get("error"),
+        "可选：在连接区点「AutoCAD 连接」探测；缺少时仍可输出 SLDDRW / PDF",
+        optional=True)
+
+    st = probe_settings()
+    add("delivery_root", "交付目录",
+        "ok" if st.get("ok") else "missing",
+        "%s（来源：%s）" % (st.get("delivery_root"),
+                           st.get("delivery_root_source")),
+        "在「工程环境检查」里把交付目录改到一个可写的位置（例如 D:/dsh-out）")
+    ignored = st.get("ignored") or []
+    if ignored:
+        add("stale_paths", "跨机器残留设置", "warn",
+            "；".join("%s=%s（%s）" % (r["key"], r["value"], r.get("note") or "")
+                     for r in ignored),
+            "这些设置来自另一台电脑，已自动忽略；可点「清空本机路径设置」重来")
+
+    state = "ok"
+    if any(i["state"] == "missing" and not i["optional"] for i in items):
+        state = "bad"
+    elif any(i["state"] in ("missing", "warn", "unknown") for i in items):
+        state = "warn"
+
+    return {
+        "ok": state != "bad",
+        "status": state,
+        "items": items,
+        "missing": [i for i in items
+                    if i["state"] in ("missing", "unknown") and not i["optional"]],
+        "summary": ("环境完整，可以直接建模" if state == "ok" else
+                    ("缺少可选项，部分功能会降级" if state == "warn" else
+                     "缺少必需项，工程模式无法正常建模")),
+        "counts": {"ok": len([i for i in items if i["state"] == "ok"]),
+                   "warn": len([i for i in items
+                                if i["state"] in ("warn", "unknown")]),
+                   "missing": len([i for i in items if i["state"] == "missing"])},
+        "python": {"chosen": py.get("chosen"), "version": py.get("version"),
+                   "tried": py.get("tried")},
+        "full": bool(full),
+    }
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# 提示词生成（用户要的「写一段提示词自己发给新的对话」）
+# ══════════════════════════════════════════════════════════════════════════
+
+_PROMPT_HEAD = """【工程模式 · 本机环境修复任务】
+
+你正在一台可能缺少依赖的电脑上，为 DSH「工程模式」预设做环境修复。
+请按下面清单逐项处理，不要跳过、不要假设"应该已经装了"。
+
+## 一、当前自检结论（由 tools/env_check.py 实测生成）
+状态：{status_cn}
+{summary}
+
+## 二、必须处理的问题
+
+"""
+
+_PROMPT_TAIL = """
+## 三、执行规则（请严格遵守）
+
+1. **先确认解释器，再装包。** 需要 Python 3.8+（64 位）。
+   安装依赖必须使用自检选中的实际解释器，避免装到另一个 Python。装包前先跑：
+```powershell
+   & "{python}" -c "import sys;print(sys.version);print(sys.executable);print(64 if sys.maxsize > 2**32 else 32)"
+```
+   **所有 pip 安装都必须使用同一个合格解释器**：
+```powershell
+   & "{python}" -m pip install --upgrade pip
+   & "{python}" -m pip install {pip_pkgs}
+```
+2. **装完必须回填。** 若 py -3 可用而 python 不可用，请把这件事告诉我，
+   我会把它固定成本机设置（settings.py set python_exe <路径>），
+   这样插件和门禁脚本用的是同一个解释器，不会再出现"装了但没生效"。
+3. **每装完一项就复验**，不要全装完再一次性验证：
+```powershell
+   & "{python}" "{tools}\\env_check.py" probe
+```
+4. **SolidWorks / AutoCAD 路径**：若自检说找不到，先点设置页连接区的「连接」；
+   仍不行就在「工程环境检查」里手动指定可执行文件。**不要全盘扫描 C: 盘根目录**。
+5. **交付目录**：默认不再落在桌面（以前会凭空建一个 test 文件夹）。
+   请在设置页「工程环境检查」里把交付目录设到一个明确、可写的位置。
+6. 全部处理完后，最后再跑一次完整自检，并把结论贴给我：
+```powershell
+   & "{python}" "{tools}\\env_check.py" probe
+```
+
+## 四、验收标准（做不到就是没修好）
+
+- env_check.py probe 的 status 必须是 ok（或只剩 AutoCAD 这类可选项）；
+- sw_bridge.py doctor 不再报 Python 语法错误 / 缺 pywin32；
+- 设置页「工程环境检查」里所有必需项都是绿色。
+"""
+
+
+def _guess_python():
+    try:
+        py = probe_python()
+        return py.get("chosen") or py.get("executable")
+    except Exception:
+        return None
+
+
+def install_prompt(result=None, tools_dir=None):
+    """生成可直接粘贴给新对话的修复提示词。"""
+    r = result or probe()
+    items = r.get("items") or []
+    tools = tools_dir or HERE
+    lines, pip_pkgs = [], []
+    idx = 0
+    for it in items:
+        if it["state"] not in ("missing", "warn", "unknown"):
+            continue
+        idx += 1
+        tag = "可选项" if it.get("optional") else "必需"
+        lines.append("### %d. %s（%s）" % (idx, it["name"], tag))
+        if it.get("detail"):
+            lines.append("- 现状：%s" % it["detail"])
+        if it.get("fix"):
+            lines.append("- 处理：%s" % it["fix"])
+        lines.append("")
+        m = re.search(r"-m pip install\s+(.+)$", it.get("fix") or "")
+        if m:
+            pip_pkgs.append(m.group(1).strip())
+    if not lines:
+        lines = ["（无 —— 当前环境已完整，无需处理任何项。）", ""]
+    status_cn = {"ok": "完整", "warn": "有可选项缺失",
+                 "bad": "缺少必需项"}.get(r.get("status"), str(r.get("status")))
+    head = _PROMPT_HEAD.format(status_cn=status_cn,
+                               summary=r.get("summary") or "")
+    tail = _PROMPT_TAIL.format(
+        pip_pkgs=" ".join(dict.fromkeys(pip_pkgs)) if pip_pkgs else "<包名>",
+        python=(_guess_python() or "python"),
+        tools=tools)
+    return head + "\n".join(lines) + tail
+
+
+# ══════════════════════════════════════════════════════════════════════════
+# CLI
+# ══════════════════════════════════════════════════════════════════════════
+
+def _print(obj):
+    print(json.dumps(obj, ensure_ascii=False, indent=2))
+
+
+def _main(argv):
+    cmd = (argv[0] if argv else "probe").lower()
+    if cmd in ("probe", "check", "status"):
+        res = probe(full=True)
+        _print(res)
+        return 0 if res.get("ok") else 1
+    if cmd in ("prompt", "install-prompt"):
+        res = probe(full=True)
+        text = install_prompt(res)   # 代码围栏已在模块常量里就位，无需二次替换
+        if "--json" in argv:
+            _print({"ok": True, "prompt": text, "status": res.get("status")})
+        else:
+            sys.stdout.write(text + "\n")
+        return 0
+    if cmd in ("set-delivery-root", "set_delivery_root") and len(argv) >= 2:
+        import settings as _settings
+        _print(_settings.set_path("delivery_root", argv[1]))
+        return 0
+    if cmd == "set-path" and len(argv) >= 3:
+        import settings as _settings
+        _print(_settings.set_path(argv[1], argv[2]))
+        return 0
+    if cmd == "settings":
+        import settings as _settings
+        _print(_settings.report())
+        return 0
+    _print({"ok": False,
+            "error": "用法: env_check.py probe | prompt [--json] | settings | "
+                     "set-path <key> <path> | set-delivery-root <dir>"})
+    return 2
+
+
+if __name__ == "__main__":
+    sys.exit(_main(sys.argv[1:]))

package/engineering/tools/examples/build_axis.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+"""
+示例2：五段阶梯轴（旋转成型 + 倒角 + 键槽）—— 教学重点
+========================================================
+设计需求（单位 mm，以左端面 x=0 为基准，轴沿 +X 方向）:
+  轴段1: Φ30 × 30     (x: 0 ~ 30)
+  轴段2: Φ36 × 6      (x: 30 ~ 36)
+  轴段3: Φ46.494 × 40 (x: 36 ~ 76)，两端开倒角 C1×45°
+  轴段4: Φ35 × 74     (x: 76 ~ 150)
+  轴段5: Φ30 × 36     (x: 150 ~ 186)
+  总长 = 186 mm
+
+附加特征:
+  A. 轴最左端 (x=0) 倒角 C1×45°
+  B. 轴最右端 (x=186) 倒角 C1×45°
+  C. 第四段右端 (x=150) 台阶倒角 C1×45°
+  D. 第四段右端往左 20mm 处 (中心 x=130) 开键槽:
+       直槽口 总长 35、宽 10（半圆半径 5）
+       深度: 键槽底面到过轴心的平行平面距离 12.5
+
+【通用版改动】选中键槽草图不再写死中文名"草图2"，
+改用 swapi.select_sketch_by_index 按特征树序号选择（与语言无关）。
+
+执行: python sw_bridge.py run examples\build_axis.py
+（或在 DSH 里说："建模一个五段阶梯轴，Φ30×30 / Φ36×6 / Φ46.494×40 /
+  Φ35×74 / Φ30×36，总长186，第四段右侧开键槽宽10圆心距25、
+  右侧圆心距右端面7.5，保存为 DSH_五段阶梯轴"）
+"""
+import os
+import math
+
+import win32com.client
+import pythoncom
+
+import swapi
+
+# ---- 半径表（直径/2）----
+R1 = 30 / 2.0      # 15
+R2 = 36 / 2.0      # 18
+R3 = 46.494 / 2.0  # 23.247
+R4 = 35 / 2.0      # 17.5
+R5 = 30 / 2.0      # 15
+
+X1, X2, X3, X4, X5 = 30, 36, 76, 150, 186
+
+# ---- 1. 新建零件 ----
+m = swapi.new_part()
+print("STEP1 new part:", m.title)
+
+# ---- 2. 前视基准面：画旋转轮廓 + 中心线 ----
+m.begin_sketch("Front Plane")
+m.polyline([
+    (0, R1), (X1, R1), (X1, R2), (X2, R2), (X2, R3), (X3, R3),
+    (X3, R4), (X4, R4), (X4, R5), (X5, R5), (X5, 0), (0, 0),
+])
+m.line(0, 0, 0, R1)
+m.centerline(-20, 0, 206, 0)
+m.end_sketch()
+
+# ---- 3. 旋转 360° 成阶梯轴 ----
+r = m.revolve(360)
+print("STEP2 revolve ->", "OK" if r is not None else "FAIL")
+if r is None:
+    raise RuntimeError("revolve failed")
+
+# ---- 4. 轴段3 两端圆环棱边倒角 C1×45° ----
+m.clear_selection()
+c1 = m.chamfer(1, [(X2, R3, 0)], angle_deg=45)
+print("STEP3 chamfer seg3 left  C1 ->", "OK" if c1 is not None else "FAIL")
+m.clear_selection()
+c2 = m.chamfer(1, [(X3, R3, 0)], angle_deg=45)
+print("STEP4 chamfer seg3 right C1 ->", "OK" if c2 is not None else "FAIL")
+
+# ---- 5. 轴最左端 (x=0) 端面棱边倒角 C1 ----
+m.clear_selection()
+c3 = m.chamfer(1, [(0, R1, 0)], angle_deg=45)
+print("STEP5 chamfer left end  C1 ->", "OK" if c3 is not None else "FAIL")
+
+# ---- 8. 第四段键槽 ----
+# 用户要求（实测确认的 API 语义）:
+#   "键槽长度25" = 圆心距(中心距) 25
+#   "右侧圆心距离右端面 7.5" → 右圆心 x = 150 - 7.5 = 142.5
+#   左圆心 x = 142.5 - 25 = 117.5
+#   宽 10 → 半径 5；底面距过轴心平面 12.5
+#   全长 = 圆心距 + 2R = 25 + 10 = 35
+#
+# 实测结论（读草图段验证）:
+#   CreateSketchSlot(center_line=1, FullLength=1, 宽, X1, X2) 中:
+#     X1 = 槽中心，X2 = 右圆弧**圆心**（不是最外端点！）
+#     传 (中心=130, 右圆心=142.5) → 圆弧圆心落在 117.5 和 142.5
+#     → 圆心距 25 OK，右圆心距右端面 7.5 OK，全长 35 OK
+#   注意: CenterCenter 模式(0) 的 X1 被解释为槽左端，会生成错误几何 FAIL
+KEY_W = 10.0                # 宽度（半径 R=5）
+KEY_R = KEY_W / 2.0         # 5
+KEY_CC = 25.0               # 圆心距（用户要求"长度25"）
+KEY_GAP_RIGHT = 7.5         # 右侧圆心距第四段右端面 7.5（用户明确）
+KEY_RIGHT_C = X4 - KEY_GAP_RIGHT        # 右圆心 x = 150 - 7.5 = 142.5
+KEY_CENTER = KEY_RIGHT_C - KEY_CC / 2.0   # 槽中心 x = 130
+KEY_OFFSET = 12.5           # 键槽底面距过轴心平面的距离
+
+m.clear_selection()
+m.begin_sketch("Front Plane")
+MM = swapi.MM
+m.skm.CreateSketchSlot(
+    1,                        # swSketchSlotCreationType_center_line
+    1,                        # swSketchSlotLengthType_FullLength（实测：X2=右圆心）
+    KEY_W * MM,
+    KEY_CENTER * MM, 0, 0,   # 槽中心 (x, y, z)
+    KEY_RIGHT_C * MM, 0, 0,  # 右圆弧圆心（实测语义）
+    0, 0, 0,
+    1, False)
+m.end_sketch()
+# 选中键槽草图（第二个草图）—— 通用版：按序号选，不依赖中文/英文名
+m.model.ClearSelection2(True)
+sel = swapi.select_sketch_by_index(m.sw, m.model, 2)
+print("STEP8 select keyway sketch ->", "OK" if sel else "FAIL")
+if not sel:
+    raise RuntimeError("cannot select keyway sketch by index 2")
+k = m.fm.FeatureCut3(
+    True, False, False, 1, 0, 0.0, 0.0,          # 单向, 完全贯穿
+    False, False, False, False, 0, 0,
+    False, False, False, False, False, False, True,
+    False, False, False,                          # 自动选择
+    3, KEY_OFFSET * MM, True)                     # 起始=等距12.5, 方向向外
+print("STEP8 keyway: 圆心距%d 右圆心x=%.1f(距右端面%.1f) 中心x=%.1f ->"
+      % (KEY_CC, KEY_RIGHT_C, X4 - KEY_RIGHT_C, KEY_CENTER),
+      "OK" if k is not None else "FAIL")
+
+# ---- 6. 轴最右端 (x=186) 端面棱边倒角 C1 ----
+m.clear_selection()
+c4 = m.chamfer(1, [(X5, R5, 0)], angle_deg=45)
+print("STEP6 chamfer right end C1 ->", "OK" if c4 is not None else "FAIL")
+
+# ---- 7. 第四段右端 (x=150) 台阶棱边倒角 C1 ----
+m.clear_selection()
+c5 = m.chamfer(1, [(X4, R4, 0)], angle_deg=45)
+print("STEP7 chamfer seg4 right C1 ->", "OK" if c5 is not None else "FAIL")
+
+# ---- 9. 保存 ----
+out = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+                   "DSH_五段阶梯轴.sldprt")
+print("STEP9 save:", m.save(out))

package/engineering/tools/examples/build_cup.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+"""
+示例3：杯子（拉伸外壁 + 切除内腔 + 杯口倒角）
+==============================================
+设计（单位 mm）:
+  杯身外径 D80, 高 100
+  内腔直径 D70, 深 95（杯底厚 5）
+  杯口内外倒角 C2
+
+执行: python sw_bridge.py run examples\build_cup.py
+（或在 DSH 里说："建模一个马克杯，外径 80、高 100、壁厚 3、底部厚 4，
+  保存为 DSH_杯子"）
+
+本示例完全通用：不依赖任何本机路径，保存到脚本所在目录。
+"""
+import os
+import swapi
+
+D_OUT = 80.0    # 杯身外径
+H = 100.0       # 杯高
+D_IN = 70.0     # 内腔直径
+BOTTOM = 5.0    # 杯底厚
+DEPTH = H - BOTTOM  # 内腔深度 95
+
+m = swapi.new_part()
+print("STEP1 new part:", m.title)
+
+# ---- 2. 杯身外圆柱 D80×100 ----
+m.begin_sketch("Front Plane")
+m.circle(0, 0, D_OUT / 2.0)
+m.end_sketch()
+m.extrude(H)
+print("STEP2 cup body D%.0f x %.0f OK" % (D_OUT, H))
+
+# ---- 3. 切除内腔 D70×95（顶面画圆，向下切 95，留底 5）----
+m.begin_sketch_on_face(0, 0, H)
+m.circle(0, 0, D_IN / 2.0)
+m.end_sketch()
+m.cut(depth=DEPTH)
+print("STEP3 cavity D%.0f x %.0f OK" % (D_IN, DEPTH))
+
+# ---- 4. 杯口外沿倒角 C2（顶面外圆棱边 z=H）----
+# 顶面外棱边: 半径 40 的圆, 取 y 方向极值点
+m.clear_selection()
+c1 = m.chamfer(2, [(0, D_OUT / 2.0, H)], angle_deg=45)
+print("STEP4 rim outer chamfer C2 ->", "OK" if c1 is not None else "FAIL")
+
+# ---- 5. 杯口内沿倒角 C2（顶面内圆棱边 z=H）----
+m.clear_selection()
+c2 = m.chamfer(2, [(0, D_IN / 2.0, H)], angle_deg=45)
+print("STEP5 rim inner chamfer C2 ->", "OK" if c2 is not None else "FAIL")
+
+# ---- 6. 保存（按用户提供的名称命名；不校验）----
+out = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+                   "DSH_杯子.sldprt")
+print("STEP6 save:", m.save(out))