SolidWorks WLJ for DeepSeek Harness

English | 中文

把 SolidWorks WLJ（图纸/自然语言 → 参数化 SolidWorks 零件，带人工确认门禁与数值几何验证）以原生插件形式装进 DeepSeek Harness：14 个 wlj_* 工具 + 一条 WLJ 技能系统提示词段，会话内直接可用。

插件自包含、不依赖本机路径；状态经 fs 持久化到 wlj-state/；C# 执行/分析走 subprocess+curl；服务不可达时明确降级，绝不假成功。

✨ 能力

工具	作用
wlj_environment_profile	版本驱动环境档案（SW2020 拒 revolve；SW2022+ 凸台旋转可用、旋转切除仍不可用）
wlj_start_workflow	建工作流，返回 9 个 intake 问题（含材料 / 公差螺纹 / IR 能力检查）
wlj_answer_question / wlj_get_state / wlj_next_action	回答问题 / 查状态 / 下一步
wlj_approve_brief / wlj_attach_plan / wlj_approve_plan / wlj_approve_execution	四道人工确认门禁
wlj_attach_feature_graph	JS 版 Feature Graph 校验器（与 Python ir_schema 一致）+ SW2020 revolve 门禁
wlj_execute_feature_graph	执行门禁（live=true 强制）；有 skill_dir 走本地 CLI 编译执行，否则返回 PREPARED 交接合同
wlj_verify_execution	基础检查 + expected_geometry 数值比对（PASS / GEOMETRY_MISMATCH / GEOMETRY_UNVERIFIED）
wlj_health_check / wlj_prepare_retry	只读探活 C# 服务 / 失败清理门禁

🚀 安装

要求

• DeepSeek Harness（与制作本包时版本一致；preset 依赖 @deepseek-ai/* 包名与配置）
• 真实 SolidWorks 执行需要 Windows + SolidWorks + C# 执行服务（base_url 默认 http://localhost:5000，可指向任意机器）；无该环境时仍可离线跑完整工作流与校验

一键安装

git clone https://github.com/WLj924/solidworks-wlj-dsh.git
cd solidworks-wlj-dsh
bash install.sh            # macOS / Linux
# 或 Windows：
# powershell -ExecutionPolicy Bypass -File install.ps1

脚本会：复制 preset/ 三件套到 ~/.dsh/.agent-presets/solidworks-wlj/，自动定位 harness 的 node_modules（含 @deepseek-ai/dsh）并重建符号链接。找不到时按提示设置 DSH_NODE_MODULES 环境变量。

手动安装

1. 把 preset/ 下三个文件放到 ~/.dsh/.agent-presets/solidworks-wlj/
2. 找到目标机 DSH 的 node_modules（通常 ~/.npm/_npx/<hash>/node_modules）
3. ln -s <该路径> ~/.dsh/.agent-presets/solidworks-wlj/node_modules（Windows 用 junction）

然后

1. 完全重启 DeepSeek Harness
2. 新建会话，选择 SolidWorks WLJ preset
3. 会话内出现 14 个 wlj_* 工具 + WLJ 技能提示词段

不想用 preset？也可以会话内 cordis_define 加载 plugin/wlj-harness-plugin.js（动态插件版，进程级，重启失效）。

📐 工作流（门禁顺序不可跳过）

wlj_start_workflow → 9 个 intake 问题 → wlj_approve_brief → wlj_attach_feature_graph（单位 meters）
→ wlj_attach_plan（含 verification 验证块）→ 4 个计划问题 → wlj_approve_plan
→ wlj_approve_execution → wlj_execute_feature_graph(live=true) → wlj_verify_execution(expected_geometry)

失败恢复：清理文档 → wlj_prepare_retry(cleanup_confirmed=true)；禁止自动重放。 执行后必须数值验证——PASS 才算"已生成"，GEOMETRY_MISMATCH / GEOMETRY_UNVERIFIED 不得称"已复现"。

📁 仓库结构

solidworks-wlj-dsh/
├── install.sh / install.ps1     # 一键安装脚本
├── preset/                      # preset 三件套（agent.cordis.yml / wlj-plugin.js / preset.yml）
├── plugin/                      # 双版本插件源码
│   ├── wlj-harness-plugin.js    # 动态插件版（cordis_define 用，函数体）
│   └── wlj-preset-plugin.js     # preset 版（ESM；与 preset/wlj-plugin.js 同内容）
├── dist/                        # 历史 tar.gz 安装包
├── LICENSE-AGPL-3.0
└── README.md / README.en.md

⚠️ 注意事项

• 符号链接必须重建：node_modules 是符号链接，指向安装 DSH 的 node_modules；打包/复制会失效，用安装脚本或手动重建。
• Node ESM 模块缓存：修改 wlj-plugin.js 后必须重启 DSH（或换文件名）才生效。
• 目标机 DSH 版本一致：preset 的 agent.cordis.yml 基于 standard，行依赖 @deepseek-ai/* 包名与配置。
• Feature Graph IR 不含工程图 / 爆炸 / 螺纹 / 旋转切除 / 自由曲面节点（遇到需换方案并先说明缺口）。
• web.fetch 仅 GET（健康检查）；POST 执行/分析走 subprocess+curl。

🔗 相关仓库

• SolidWorks WLJ 主仓库（MCP server 版，供 Claude / Codex）：solidworks-wlj
• SolidPilot（架构与 Feature Graph IR 灵感来源，vendored compiler / C# 执行服务 / 契约测试）

📜 License

AGPL-3.0

🤝 贡献

报告问题、PR 或文档改进请开 Issue / Pull Request。改动插件代码时注意同步 preset/wlj-plugin.js 与 plugin/wlj-preset-plugin.js（两者逻辑一致），并重启 DSH 验证。