pbr-render
DeepSeek Harness 的 PBR 模型预览：使用基于物理的材质、纹理、环境光照和轨道控制来渲染 GLB/GLTF 游戏美术资源 — 围栏语言 `pbr3d` + `pbr_render` 工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dhb861832993-star/pbr-render#8931eb36d84015cfc39e34e8bab126fdbdbdd6f5Pbr Render 以 pbr-render 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
PBR（基于物理）3D 模型预览插件 for DeepSeek Harness A Physically-Based Rendering 3D model preview plugin for DeepSeek Harness
渲染 GLB/GLTF 游戏美术资源，带贴图纹理、环境光照、轨道控制、材质通道检查，直接在模型回答里交互预览。 Render GLB/GLTF game-art assets inside chat with PBR textures, environment lighting, orbit controls, and material-channel inspection — fully interactive.
🔌 生态 / Ecosystem：仓库已挂
#dsh·#dsh-plugin·#pbr·#gltftopic，欢迎社区收录。 The repo carries the#dsh·#dsh-plugin·#pbr·#gltftopics — community welcome.
同一模型的材质通道检查（点击模式栏实时切换，以下为各模式渲染截图）。 Material-channel inspection of the same model (switch live via the mode bar; screenshots of each mode below).
| PBR（完整物理渲染 / Full PBR） | 基础色 / Base Color | 法线 / Normal |
|---|---|---|
| pbr | basecolor | normal |
| 粗糙度（灰度）/ Roughness | 金属度（灰度）/ Metallic | AO（灰度）/ Ambient Occlusion |
|---|---|---|
| roughness | metallic | ao |
| 自发光 / Emissive | 线框 / Wireframe |
|---|---|
| emissive | wireframe |
标量通道（粗糙度/金属度/AO）按 PBR 规范以灰度显示——正是游戏引擎（Unity/UE）读取的原始贴图通道数据。 Scalar channels (roughness/metallic/AO) are shown in grayscale per PBR convention — the raw texture-channel data game engines (Unity/UE) actually read.
PBR 渲染 / PBR Rendering
材质通道检查 / Material-Channel Inspection
真实 HDR 环境光 / Real HDR Environment Lighting
studio 棚拍 / sunset 黄昏 / outdoor 户外 / sunrise 日出 / night 夜晚，env 字段切换，envBackground 可显示为背景；未指定时回退程序化 RoomEnvironment。viewer 顶部有"环境"切换栏，预览时可直接点击换环境studio / sunset / outdoor / sunrise / night, switched via the env field, or shown as the background with envBackground; falls back to a procedural RoomEnvironment when unset. An on-viewer "environment" bar lets you swap environments live交互 / Interaction
主动触发 / Active Triggering
pbr_render 工具并渲染预览，无需用户提示pbr_render tool and renders a preview when a 3D model file appears (API-generated / downloaded / dropped into the workspace) — no user prompt needed安全 / Security
# GitHub 仓库安装 / Install from the GitHub repo
dsh plugin --profile web add github:dhb861832993-star/pbr-render
# 或本地开发 / Or for local development
pnpm install
node scripts/build.mjs
dsh plugin --profile web add link:/path/to/pbr-render
重启 dsh web，新会话生效。 Restart dsh web; takes effect on a new session.
插件自动注入系统提示教学。模型在合适场景主动调用 pbr_render 工具验证路径，然后输出 pbr3d 围栏：
The plugin injects a system-prompt guide automatically. The model calls the pbr_render tool to validate the path, then emits a pbr3d fence:
```pbr3d
{"model":"E:/generated/robot.glb","autoRotate":true,"label":"API 生成的机器人 / API-generated robot"}
```
| 字段 / Field | 类型 / Type | 默认 / Default | 说明 / Description |
|---|---|---|---|
model | string | 必填 / required | 模型路径（绝对或相对工作区），.glb/.gltf/.fbx / model path (absolute or workspace-relative), .glb/.gltf/.fbx |
autoRotate | boolean | true | 自动旋转 / auto-rotate |
background | string | #14161c | 场景背景色（envBackground:true 时被 HDR 背景覆盖）/ scene background color (overridden when envBackground:true) |
env | string | studio | 内置 HDR 环境图：studio / sunset / outdoor / sunrise / night（CC0, Poly Haven 1K）/ built-in HDR environment |
envBackground | boolean | false | 同时把 HDR 环境图显示为场景背景 / also show the HDR environment as the scene background |
envIntensity | number | 1.0 | 环境光照强度（HDR/IBL 亮度）/ environment light intensity |
exposure | number | 1.0 | 曝光 0.2–3 / exposure 0.2–3 |
viewMode | string | pbr | 初始材质视图 / initial material view |
label | string | — | 视图说明文字 / caption under the viewer |
| 模式 / Mode | 显示 / Shows |
|---|---|
pbr | 完整物理渲染 / full physically-based render |
basecolor / normal / emissive | 彩色贴图通道 / color map channels |
roughness / metallic / ao | 标量通道灰度显示（R/G/R 通道提取）/ scalar channels in grayscale (R/G/R extraction) |
wireframe | 线框 / wireframe |
lib/index.js — host 半边：pbr_render 工具 + 文件服务路由 + 系统提示段 / host half: the pbr_render tool + file-service route + system-prompt sectionlib/client.js — 浏览器半边：DOM 观察 pbr3d 围栏 → 按需加载 three 资产 → PBR 渲染 / browser half: DOM-watches pbr3d fences → lazy-loads the three assets → renders PBRsrc/three-entry.js + scripts/build.mjs — three.js 引擎打包（esbuild）/ three.js engine bundling via esbuildlib/assets/env/*.hdr — 内置 HDR 环境图（CC0, Poly Haven 1K，RGBE 格式）/ built-in HDR environments (CC0, Poly Haven 1K, RGBE)test-model.glb / test-tex.glb — 演示模型（单色 + 全套贴图）/ demo models (solid-color + full texture set)MIT