前言¶

DeepSeek Harness（DSH）插件 dsh-cad-viewer 爲 Web GUI 增加了 3D 模型庫和 CAD 查看器功能。Agent 可以通過 CadQuery 腳本生成模型併入庫，支持在線查看和導出。模型存儲在服務端，同一實例下的設備共享。

插件簡介¶

這是一個 DeepSeek Harness 客戶端插件，用於在對話界面嵌入 3D 模型庫和 CAD 查看器。插件由 CMoyuer 維護，開源協議爲 MIT。

核心功能¶

• 3D 模型庫：支持文件夾管理、全庫搜索、拖拽移動、重命名和刪除。
• CAD 查看器：掛載上游 three-cad-viewer 界面，支持左/右鍵旋轉、中鍵平移、滾輪縮放。
• 10 種導出格式：包括 STEP/BREP（精確幾何）、STL/3MF/VRML（網格）、SVG/DXF（圖紙）。
• Agent 工具：提供 add_3dmodel、build_3dmodel、list_3dmodels、delete_3dmodel、cadquery_env。
• 服務端存儲：模型以 JSON 文件存儲，同一 DSH 實例下所有設備共享。
• 支持 CadQuery：可以使用 CadQuery 腳本進行建模。

安裝¶

使用官方命令安裝：

dsh plugin --profile web add dsh-cad-viewer

安裝完成後，修改配置或啓用插件需要重啓 dsh web。

使用方法¶

1. 模型入庫¶

使用 build_3dmodel 工具運行 CadQuery 腳本。腳本中需導入 cadquery as cq 並將模型賦值給 model。

2. 查詢列表¶

使用 list_3dmodels 查詢模型庫。支持 query（標題/名稱/id 子串）、folder（文件夾路徑）、limit（數量限制）參數。

3. 刪除模型¶

使用 delete_3dmodel 按 ID 或標題刪除。注意刪除操作不可撤銷。

4. 環境探測¶

使用 cadquery_env 探測 CadQuery 環境是否就緒。

5. 導出模型¶

在模型庫卡片的菜單或工作臺工具欄中選擇導出格式（如 STEP、STL、SVG 等）。

注意事項與限制¶

• 服務端運行：插件以服務端權限運行，修改配置後必須重啓 dsh web。
• 超時限制：單次構建超時時間爲 60 秒；導出超時由配置項 cadqueryExportTimeout 控制，默認爲 5 分鐘。
• 環境依賴：add_3dmodel 無需 CadQuery；build_3dmodel 和導出功能需要 CadQuery 環境。
• 去重機制：模型去重鍵爲「幾何 + 標題」。相同幾何和標題再次入庫會更新原條目。
• 存儲共享：模型庫同一 DSH 實例下所有設備共享。

總結¶

該插件將 CAD 建模與查看能力集成到 DeepSeek Harness 的工作流中。更多詳情見 插件目錄 或 GitHub 倉庫。