dsh-cad-preview
在终端中运行以下命令:
dsh plugin install RichardYZLu/dsh-cad-preview
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中使用 dsh plugin install RichardYZLu/dsh-cad-preview 安装,或从 GitHub 完整源码地址 https://github.com/RichardYZLu/dsh-cad-preview 安装,装完重启 DSH Desktop 即可在右侧栏预览 3D 模型。
插件介绍
在 DSH 里做硬件相关开发时,最常见的打断就是:刚和 AI 聊完结构方案,却要切到独立的 CAD 软件去确认一个 .step 文件能不能用。dsh-cad-preview 把这个动作搬进了右侧栏——在文件树里点开 .step、.stl、.3mf、.obj、.ply 等模型,侧栏直接出现可以旋转、缩放、剖视的几何体,左键拖动旋转,右键拖动平移,滚轮或双指缩放,全程不必离开 DSH 窗口。
它覆盖了两类常见的建模场景:.step、.stp、.iges、.igs、.brep 这类 B-rep 实体模型交给 OpenCascade(WASM)解析,会读取实体、曲面与单位信息;.stl、.3mf、.obj、.ply 则走 three.js 的加载器,二进制与 ASCII 格式都能读,其中 .obj 只取几何、忽略材质。文件打开后顶栏会显示文件大小、包围盒尺寸(mm)、三角面数与解析耗时,让人一眼判断模型规模。工具条提供线框(W)、Z/Y 轴向上切换(U)、网格(G)、适配(F)与重置(R),右下角的方向箭头随视角实时旋转,帮助确认模型自身坐标系的朝向;默认外观按 CAD 块面的阅读习惯调校,用环境光遮蔽压暗接缝、用 30° 结构线勾出块面。
工程上最关键的取舍在于:B-rep 解析依赖 OpenCascade,是同步、一口气跑完的重计算,内存可能达到 GB 级,一旦放在页面主线程就会把整个聊天界面按住不放。因此插件把 CAD 内核整个放进 Web Worker,页面 bundle 里不含内核。解析期间界面照常响应,可以继续滚动、切换标签;关闭标签页立即释放内核内存;取消解析直接终止线程;坏文件最多只烧掉自己的 Worker。在侧栏与聊天共用同一个渲染进程的前提下,这是同时保住交互流畅与内存安全的做法。
它适合机械结构设计、硬件原型评估、模型格式排查等需要在对话中频繁查看 3D 文件的人,尤其是希望少切窗口、在模型与代码和需求讨论之间快速往返的开发者。
使用场景
- 在对话中直接查看 STEP 实体模型,无需切换到独立 CAD 软件
- 快速打开 STL、3MF、OBJ、PLY 等打印或扫描模型确认形状
- 解析大体积 B-rep 文件时仍能滚动界面、切换标签,不被卡住
适合人员
- 需要频繁查看 3D 文件的机械结构与硬件工程师
- 在 DSH 中做硬件方案讨论、希望少切窗口的开发者
- 对 CAD 格式兼容性和大模型解析性能有要求的工程团队