前言¶

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 仓库。