dhb861832993-star/pbr-render 预览 preview

dhb861832993-star/pbr-render

DeepSeek Harness 的 PBR 3D 模型预览插件 — 支持 GLB/GLTF 游戏美术资源,包含纹理、材质通道检查器、轨道控制。pbr3d 栅栏及 pbr_render 工具。

Project Overview项目介绍

This is a native DeepSeek Harness (DSH) plugin that adds interactive physically-based rendering (PBR) previews for GLB and GLTF 3D model assets. It automatically detects when 3D model files are added to the DSH workspace, calls the built-in pbr_render tool without requiring any extra user prompts, and renders the interactive preview directly inside the DSH chat session. You can install it directly via the DSH CLI using the documented command, or build it locally with pnpm and esbuild for development testing after cloning the repository.

This plugin is built for game artists, 3D asset creators, and users who generate 3D models via DSH. It automatically injects usage instructions into DSH's system prompt, so the LLM knows when to trigger the preview without any extra configuration from the user. Once rendered, you can switch between different material channel views, swap out HDR environment lighting, toggle fullscreen mode, orbit the model by dragging, zoom with your mouse wheel, and adjust exposure settings to your liking. You can also view raw scalar texture channels in grayscale just like game engines do.

The plugin is released under the open-source MIT license, and includes several built-in CC0 1K HDR environment maps from Poly Haven, covering studio, sunset, outdoor, sunrise, and night lighting setups. It includes strict security safeguards: it only serves files from within the current DSH workspace, blocks non-allowed file extensions, and enforces a maximum file size limit of 512 MiB per asset. After installation, you will need to restart the DSH web client for the plugin to take effect in new chat sessions. Local development requires pnpm to install dependencies before building the package.

这是一个专为DeepSeek Harness(DSH)开发的原生插件,功能是为GLB、GLTF格式的3D游戏美术资源提供基于物理的渲染(PBR)预览。它支持自动识别工作区中新增的3D模型文件,自动调用渲染工具,直接在对话会话内生成可交互的预览视图,方便开发者和美术创作者检查资产。

面向游戏美术开发者、3D资产创作者和使用DSH生成3D模型的用户,插件会自动在DSH的系统提示中注入使用指南,无需用户额外配置触发指令。用户可以在预览界面切换不同材质通道、更换HDR环境光照,还支持全屏查看、拖拽旋转、滚轮缩放等交互操作。

该插件使用MIT许可证开源,可通过DSH CLI直接从GitHub仓库安装,本地开发则需要先安装pnpm依赖,打包后链接安装,重启DSH网页端后生效。插件对文件做了安全限制,仅允许访问工作区内文件,单文件大小上限为512MiB。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:dhb861832993-star/pbr-render

把 dhb861832993-star/pbr-render 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

PBRRender 🎨

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 · #gltf topic,欢迎社区收录。 The repo carries the #dsh · #dsh-plugin · #pbr · #gltf topics — community welcome.


🖼️ 效果展示 / Showcase

同一模型的材质通道检查(点击模式栏实时切换,以下为各模式渲染截图)。 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.


✨ 特性 / Features

PBR 渲染 / PBR Rendering

  • 金属/粗糙度/法线/自发光/AO 贴图自动加载(GLB 内嵌或 GLTF 兄弟文件)
  • Metalness / roughness / normal / emissive / AO maps load automatically (embedded in GLB or as GLTF sibling files)

材质通道检查 / Material-Channel Inspection

  • viewer 顶部模式栏一键切换 —— PBR / 基础色 / 法线 / 粗糙度 / 金属度 / AO / 自发光 / 线框
  • One-click mode bar at the top of the viewer — PBR / base color / normal / roughness / metallic / AO / emissive / wireframe

真实 HDR 环境光 / Real HDR Environment Lighting

  • 内置 5 种 CC0 HDR 环境图(Poly Haven 1K)—— studio 棚拍 / sunset 黄昏 / outdoor 户外 / sunrise 日出 / night 夜晚,env 字段切换,envBackground 可显示为背景;未指定时回退程序化 RoomEnvironment。viewer 顶部有"环境"切换栏,预览时可直接点击换环境
  • 5 built-in CC0 HDR environments (Poly Haven 1K) — 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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev Tencent-ADP-dsh-plugin 下一个 Next TeachReplay →