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