dsh-pbr-material

做 3D 或游戏材质时，从一张现场照片到引擎里能平铺贴的 PBR 贴图集，往往要在 DCC 里手工拆通道、修接缝、猜参数，既慢又难复现。dsh-pbr-material 把这条链路收进 DSH 插件：在本地 ComfyUI 上跑固定管线，从单张参考图产出 albedo、normal、height、roughness、AO、curvature、metallic 等可平铺贴图（数据贴图为 16-bit），并附带与 PBRLab 一致的平铺量测和 3×3 预览，让你用眼睛和指标一起判断能不能用。

插件把「该怎么选模式、怎么写描述、什么时候别乱生成」留给 skill 与 Agent 的判断，把 19 节点图怎么连、怎么提交、色相选择性调色、MakeSeamless、PBRSynth 落盘等确定性步骤写进代码。两种模式对应最常见的踩坑：已是正面平铺贴图的照片用 direct 直通保留原生分辨率与真实细节；有透视、背景或光照渐变的照片才用 generate，先经 FLUX.2 Klein 重绘成平面 albedo 再推导。选错模式会把缝、骨料、色差一起「洗」掉，面板和 pbr_material_from_photo 的 mode 参数都把这个选择放在显眼位置。

装好后，Agent 可通过 pbr_comfy_status、pbr_material_from_photo、pbr_check_maps 等工具一条龙处理；新机器上还能用 pbr_setup_status / pbr_setup_install 自检并后台部署 run root、节点包与约 12.5 GB 权重，且优先复用已在跑的 ComfyUI 实例，避免双份大模型占满显存。侧边栏「PBR 材质」工作台可直连 REST 后台跑任务，多模态模型可结合参考图写英文材质描述，输出目录与命名计划与宿主 API 对齐。

适合需要在本地、可控环境下从照片快速出材质贴图集的 TA、独立开发者和小团队，以及已经在用 DSH 并希望 Agent 自动部署与对话里一句「看看 PBR 插件的环境」就能收尾的人。商用前请自行确认 FLUX、Qwen 等权重的许可；插件负责下载与管线，不替你碰 API key。