前言¶
在 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 模型幾何形狀和材質顏色的方法。
