dsh-print3d 🖨️

面向 DeepSeek Harness 的 3D 打印 / 增材制造能力插件：把「参数化建模、校准件 G-code、STL/G-code 分析、刀路可视化」封装成一等模型工具，并把「切片 / 建模 / 分析 / 诊断」知识封装成技能。

• 工具核心是确定性、零依赖的 Node 逻辑，进程内调用，不依赖系统 node；print3d_slice 是唯一例外——它桥接本机 PrusaSlicer（可选，未装则明确报错）。
• 技能是 Markdown 知识包，Agent 用 tool-skill 按需加载。
• 与配套预设 print3d（3D 打印工程 Agent） 解耦：预设提供「人设 + 引导」，本插件提供「可复用的引擎」，任何预设都能用。

能力清单

模型工具（6 个，注册到全局 tools 注册表）

生成类工具（STL/G-code/PNG）默认直接落盘到 桌面/3Doutput/（分 stl / gcode / preview 目录）并返回路径，避免把大段文本塞进上下文（对本地小模型尤其重要）；print3d_stl_analyze/print3d_gcode_estimate 返回 JSON，print3d_slice 是唯一调用外部进程的工具。

技能（5 个，注册到全局 skills 注册表）

CLI 脚本（5 个，随包附带）

scripts/ 下的脚本仍可独立作为 CLI 使用（node scripts/xxx.cjs ...），是工具之外的兜底/高级路径，也用于「任意模型 → 文件」的落盘工作流。

安装

完全退出 DSH 后，进入 DSH 安装目录：

pnpm exec dsh plugin --profile web add dsh-print3d
# 或本地包
pnpm exec dsh plugin --profile web add "C:\path\to\dsh-print3d"

重启 DSH。安装后，任意预设的 Agent 都能直接调用 print3d_* 工具、加载 print3d-* 技能。

依赖：标准 DSH 主机组合已提供 tools 与 skills 注册表（@deepseek-ai/dsh-tools / @deepseek-ai/dsh-skill），本插件无需额外 npm 依赖。

快速使用

用户：给我一个 20×20×10 的方块 STL，再生成它的校准 G-code，估算打印时间。

Agent 流程：

1. print3d_gen_parametric_stl(shape="box", x=20, y=20, z=10) → STL 文本 → write 落盘 part.stl
2. print3d_gen_calibration_gcode(part="cube", size=20) → G-code 文本 → write 落盘 part.gcode
3. print3d_gcode_estimate(gcode_text=...) → 时间/耗材/层数

安全红线

• 打印涉及高温：任何参数与 G-code 交付前都提示上机前人工核对，不声称绝对安全。
• 温度不超过材料供应商推荐范围；ABS/ASA/尼龙等提醒通风与 VOC。
• 打印机型号 / 材料 / 固件（Marlin/Klipper）不明确时先询问，不凭空假设。

目录结构

dsh-print3d/
  package.json           # 插件清单 + dsh.bundle.patch
  cordis.patch.yml       # 把插件行插入主机组合
  src/
    index.js             # 插件入口：注册工具 + 技能 + persona
    skills.js            # 从 skills/ 读取并注册 5 个技能
    persona.js           # 精简 persona（systemPrompt 段，面向本地小模型）
    tools/               # 6 个工具定义（一个能力一个文件）+ io.js 共享助手
  scripts/               # 5 个零依赖 Node 脚本（.cjs，CLI + 进程内可调用）
  skills/                # 5 个 SKILL.md 知识包
  MODULES.md             # 如何按模块化新增能力

如何扩展

见 MODULES.md。新增一个能力 = 新增一个脚本 + 一个工具定义（+ 可选一个技能 / 一个 persona 段），不用改动现有模块。

本地版（零 API 成本）

本插件自带一段精简 persona（src/persona.js，经 systemPrompt.section 注册），面向 Ollama + Qwen3 等本地小模型：短句、明确指令、直接点名工具，让 8B 模型也能稳定跑通工具链。

配合「3D 打印工程 Agent（本地版）」预设 + 本地 ollama-local/qwen3:8b 模型即可全程离线免费：

1. 启动 Ollama（模型已拉取：qwen3:8b 等）。
2. 新建会话，预设选「3D 打印工程 Agent（本地版）」。
3. 模型选 ollama-local / qwen3:8b（或设为默认）。

License

MIT