zhangx413/dsh-pbr-material ↗★ 7

dsh-pbr-material

本地ComfyUI驱动的图像转PBR材质工具 适合需要将普通照片本地处理为可平铺3D PBR材质贴图的创作者。

包名
dsh-pbr-material
兼容性
待验证
版本
0.2.0
许可证
MIT
最近更新
2026年10月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhangx413/dsh-pbr-material

配置

全部可选项。 机器路径留空 = 自动发现(见上),只有自动发现找错时才需要 config.json。 优先级:内置默认 < 自动发现 < config.json < profile patch 行里的 config:。

{
  "comfy": {
    "installDir": "",          // 空 = 自动发现(含 main.py 的目录)
    "python": "",              // 空 = 自动发现(ComfyUI 的 venv)
    "modelsDir": "",           // 空 = 自动发现(Comfy Desktop 的模型库)
    "runRoot": "",             // 空 = %LOCALAPPDATA%\dsh-pbr-material\comfy_root
    "downloadProxy": "",       // 空 = 只用直连;测下来代理和直连各有能用的时候
    "nodePackPath": "",        // 空 = 用插件自带的 assets/pbrlab
    "attachPorts": [8188, 8000, 8080, 8288],
    "spawnPort": 8288,         // 8164-8263 是 Windows 保留段,绑上去 WinError 10013
    "minFreeVramMiB": 9000,
    "shutdownOnFinish": true
  },
  "colorMatch": { "mode": "hue", "strength": 0.6, "hueLo": 5, "hueHi": 35 },
  "pbr": { "blend": 32, "baseRoughness": 0.55, "metallic": 0.0 },
  "outputDir": "",             // 空 = 会话工作区 / 当前工作区下的 pbr-materials
  "naming": { "prefix": "T_", "version": "01", "suffixes": { "albedo": "_C" /* … */ } }
}

ensureRunRoot 每次都会检查并修复 run root:custom_nodes\pbrlab 链到插件自带的节点包, comfy_extras 链到 ComfyUI 安装目录(重装会让它变成死链,main.py 直接 FileNotFoundError: comfy_extras)。修了什么会在 pbr_setup_status / pbr_comfy_status 里报出来。