dsh-print3d：面向 DeepSeek Harness 的 3D 打印能力插件

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。3D 打印工作流通常包含参数化建模、校准件生成、切片策略配置、STL/G-code 分析及故障诊断等环节。dsh-print3d 插件将这些固定流程封装为“模型工具”与“技能”，供 Agent 直接调用。

核心功能¶

插件包含 6 个模型工具和 5 个技能。

模型工具¶

工具逻辑运行在进程内，除切片工具外无系统依赖。

1. 参数化 STL 生成 (print3d_gen_parametric_stl)
   生成水密 ASCII STL，支持 box、cylinder、tube、sphere、cone、rounded_box、gear 等几何体。
   输入： 形状参数。
   输出： STL 文件（落盘至 桌面/3Doutput/stl）。

2. 校准 G-code 生成 (print3d_gen_calibration_gcode)
   生成校准件 G-code，包括 cube、temp-tower、first-layer、retraction、bridge。
   输入： 参数（尺寸、类型）。
   输出： G-code 文件（落盘至 桌面/3Doutput/gcode）。

3. STL 分析 (print3d_stl_analyze)
   计算包围盒、体积、表面积、悬垂、非流形及水密性。
   输入： STL 文本。
   输出： JSON 分析报告。

4. G-code 估算 (print3d_gcode_estimate)
   估算打印时间、耗材、层数和温度。
   输入： G-code 文本。
   输出： JSON 估算结果。

5. 刀路可视化 (print3d_gcode_render)
   生成刀路俯视图 PNG 图片。
   输入： G-code 文本。
   输出： 图片块或 PNG 文件。

6. 切片桥接 (print3d_slice)
   唯一调用外部进程的工具，桥接本机 PrusaSlicer。
   输入： STL 路径。
   输出： G-code 文件。

技能¶

技能是 Markdown 知识包，按需加载。

1. 切片技能 (print3d-slicing)：12 种材料参数表及层高、线宽、温度、回抽、冷却规则。
2. G-code 技能 (print3d-gcode)：Marlin/Klipper 方言、起收尾脚本及估算口径。
3. 建模技能 (print3d-modeling)：OpenSCAD 写法及参数化 STL 生成逻辑。
4. 分析技能 (print3d-analysis)：STL/G-code 指标判读及 3MF 策略。
5. 诊断技能 (print3d-diagnosis)：10 类打印故障的症状→原因→修复映射。

安装¶

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

pnpm exec dsh plugin --profile web add dsh-print3d

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

典型用法¶

用户请求生成一个 20×20×10 的方块 STL，并生成校准 G-code 与时间估算。

1. 调用 print3d_gen_parametric_stl(shape="box", x=20, y=20, z=10)，生成 STL 文件并落盘。
2. 调用 print3d_gen_calibration_gcode(part="cube", size=20)，生成校准 G-code 并落盘。
3. 调用 print3d_gcode_estimate 传入 G-code 文本，返回打印时间与耗材估算。

注意事项¶

打印涉及高温，存在安全风险，请务必遵守以下红线：

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

总结¶

dsh-print3d 将 3D 打印的工程能力封装为确定性工具与知识包，适用于 DSH 生态中的各类 Agent。安装后即可调用参数化生成、分析、估算及切片功能，帮助开发者快速构建打印工作流。

目录：dsh-print3d
源码：GitHub - weisofns/dsh-print3d