前言¶
DSH 的理念是「一切皆插件」。對需要處理遊戲美術資源的智能體來說，生成或下載 GLB/GLTF 文件後，常常還要確認模型、貼圖、材質和環境光照是否正常。如果只能看到文件路徑，排查美術資源問題並不直觀。
pbr-render 插件用於解決這個問題：它把 GLB/GLTF 模型渲染爲可交互的 3D 預覽，並通過 pbr3d 圍欄嵌入到回答中。
這是什麼¶
pbr-render 是 DeepSeek Harness 的 PBR 3D 模型預覽插件，用於渲染 GLB/GLTF 遊戲美術資源並交互預覽。
倉庫 owner 爲 dhb861832993-star，許可證爲 MIT，package.json 版本爲 0.1.0，客戶端平臺爲 web。
核心功能¶
PBR 渲染¶
插件支持 PBR 渲染，可自動加載金屬、粗糙度、法線、自發光、AO 貼圖。
材質通道檢查¶
插件支持以下材質通道檢查模式：
pbrbasecolornormalroughnessmetallicaoemissivewireframe
環境光¶
插件內置 studio、sunset、outdoor、sunrise、night 環境圖，可切換並顯示背景，便於在不同光照條件下觀察模型表現。
交互¶
預覽支持：
- 拖拽旋轉
- 滾輪縮放
- 自動旋轉
- 曝光調節
- 全屏
主動觸發¶
插件可在模型發現 3D 模型文件時自動調用 pbr_render 工具並渲染預覽。
安全邊界¶
文件服務僅暴露工作區內的路徑，並限制擴展名與文件大小：
- 擴展名白名單：
.glb、.gltf、.bin、.ktx2、.hdr、.png、.jpg、.webp、.avif - 文件上限：
512 MiB
安裝與啓用¶
GitHub 安裝¶
先執行下面命令，從 GitHub 倉庫安裝插件：
dsh plugin --profile web add github:dhb861832993-star/pbr-render
本地開發¶
本地開發時，先安裝依賴並構建：
pnpm install
node scripts/build.mjs
再用本地路徑安裝：
dsh plugin --profile web add link:/path/to/pbr-render
啓用¶
安裝後需要重啓 dsh web，新會話生效。
典型用法¶
插件通過 pbr3d 圍欄在回答中嵌入 3D 預覽。輸出示例如下：
{"model":"/path/to/model.glb","autoRotate":true,"label":"模型說明"}
圍欄配置字段包括：
modelautoRotatebackgroundenvenvBackgroundenvIntensityexposureviewModelabel
其中，model 爲必填模型路徑。env 可設置爲 studio、sunset、outdoor、sunrise、night。viewMode 可設置爲 pbr、basecolor、normal、roughness、metallic、ao、emissive、wireframe。
適用場景與注意¶
適合使用 DSH web profile、需要在智能體回答中直接查看 GLB/GLTF 模型與材質通道的開發者。
使用注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與MIT許可證。 - 文件服務僅暴露工作區內的路徑，並受擴展名白名單和
512 MiB文件上限限制。 - DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店。
- 安裝或本地安裝後，需要重啓
dsh web，新會話生效。
結尾¶
pbr-render 的價值在於把 GLB/GLTF 遊戲美術資源的預覽、材質通道檢查和環境光照觀察納入 DSH 回答中，減少只靠文件路徑排查模型問題的成本。
GitHub 倉庫：https://github.com/dhb861832993-star/pbr-render
已覈實資料未提供社區目錄頁 URL，因此本文不附目錄頁鏈接。
