前言¶
在 DeepSeek Harness (DSH) 生态中，dsh-better-sidebar 负责管理文件浏览。当打开 .stl 或 .3mf 文件时，开发者通常需要将其下载到本地或打开新的标签页。dsh-3d-preview 插件将基于 WebGL 的 3D 渲染引擎集成到侧边栏中，无需离开当前上下文即可查看模型、切换切片机托盘并读取耗材颜色。
插件介绍¶
该插件由 kmyqchy 维护，采用 MIT 许可证。它基于 Three.js 构建，不依赖运行时模块。它专门设计用于与 dsh-better-sidebar 一起工作，充当文件查看器。
核心功能¶
- 文件格式与规范：支持
.stl和.3mf。它解析 3MF 核心规范、生产扩展（外部模型部分）、basematerials、colorgroup 以及 Bambu Studio 和 OrcaSlicer 的 facet paint 数据。 - 切片机集成：它检测切片机托盘并允许在预览期间切换它们。它从项目元数据中提取每对象耗材颜色，以正确渲染颜色（例如 Bambu Studio 项目）。
- 交互与视图：支持鼠标交互（拖拽旋转、滚轮缩放、右键拖拽平移）。提供适应视图、快照（PNG）和全屏模式。
- 统计信息：在预览器底部显示三角形数量、对象数量、实例数量、包围盒尺寸、材质置信度和托盘芯片。
安装与启用¶
此插件需要 Node 20+ 以及已安装 dsh-better-sidebar 的 DSH 配置文件。
安装预构建的 Tgz 包：
dsh plugin --profile web add https://github.com/kmyqchy/dsh-3d-preview/releases/latest/download/dsh-3d-preview.tgz
安装后，必须重启 dsh web。配置文件在引导时组合，因此新插件在重新启动前不会加载。
典型用法¶
- 在侧边栏文件浏览器中点击
.stl或.3mf文件以在侧边栏中加载预览。 - 使用鼠标进行交互：拖拽旋转、滚轮缩放、右键拖拽平移。
- 如果在切片机项目中，使用提供的控件切换切片机托盘。
- 检查底部的统计数据和切片机分配的耗材颜色。
限制与注意¶
- 文件大小：文件大小限制为 20 MB。此限制由
dsh-better-sidebar.mediaLimit控制。 - 格式支持：目前仅支持 STL 和 3MF。不支持 glTF、STEP、OBJ 或 PLY。
- 功能范围：无线框图、截面平面或测量工具。
- 无热重载：由于文件通过 HTTP 获取，更改后不会自动重新加载。重新导出文件后必须重新打开标签页。
- 视觉：不显示切片机缩略图（例如
Metadata/plate_N.png），仅显示几何图形。 - 语言：界面语言由
navigator.language决定。如果语言代码以zh开头（例如zh-CN），则显示中文，否则显示英文。
结语¶
该插件为 DSH 侧边栏提供了一种直接在对话上下文中检查 3D 模型几何形状和材质颜色的方法。
