dsh-cad-preview：在 DeepSeek Harness 侧边栏里查看真实 CAD 三维模型

它是做什么的？

它是 DeepSeek Harness（DSH）的 CAD 3D 模型预览插件，把右侧栏的文件树变成可以直接旋转、缩放、剖视真实几何体的 3D 查看器。它解决的是在 DSH 里打开 STEP、IGES、BREP 等 CAD 文件只能看到文本、无法确认模型长什么样的麻烦，让你在聊天界面旁边就能核对零件外形与尺寸。核心能力覆盖 B-rep 与网格两大类格式的解析渲染，并显示包围盒尺寸、三角面数和解析耗时。

核心功能

• 多格式解析：支持 .step / .stp / .iges / .igs / .brep 走 OpenCascade WASM 真 B-rep 离散，.stl / .3mf / .obj / .ply 走网格加载路径。
• 独立线程解析：B-rep 解析放在 Web Worker 里执行，页面主线程不加载内核，避免重模型把整个 DSH 界面冻住甚至拖垮渲染进程。
• 交互式相机：左键拖动旋转、右键或 Shift 加左键平移、滚轮缩放，工具条提供线框、Z/Y 轴向上、网格、适配与重置。
• 结构线与线框模式：默认环境光遮蔽加 30° 结构线勾出块面，切到线框后隐藏面、只保留 1° 结构线，圆柱侧面也不会被滤掉。
• 方向指示器：右下角三根带字母的彩色箭头随视角实时旋转，标出模型坐标系方向，且不拦截鼠标交互。
• 法向兜底：网格法向缺失、数量不匹配、全零或含 NaN 时自动从面推导，避免整个模型渲染成黑色。

怎么使用这个插件？

在 DSH 中启用后，打开侧边栏文件树里的 CAD 文件即可预览，插件会把模型离散成三角网格并用 WebGL 渲染出来。顶栏会显示文件大小、包围盒尺寸、三角面数与解析耗时，方便快速判断模型是否加载完整。需要换视角时用鼠标拖动或滚轮，需要看内部结构时点工具条的线框按钮，需要重新框选模型时按适配键。它可与 dsh-better-sidebar 或 DSH 内置的文档预览配合使用，由 RichardYZLu 维护，最近更新于 2026-10-08。

报错怎么排查？

模型整体渲染成黑色通常不是预览器缺陷，而是 STL 文件把面片法向写成全零，插件已统一做可用法向兜底，法向正常的文件会原样保留。 重模型导致界面卡顿或渲染进程异常时，说明解析没有跑在独立线程上，按官方说明确认 Worker 路径生效即可。 裁剪面在建筑尺度下出现接缝闪烁，源于固定近远裁剪面比值过大，插件改为逐帧自适应更新，遇到闪烁按官方说明检查裁剪面设置。