前言¶
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，因此本文不附目录页链接。
