配置

全部可选项。 机器路径留空 = 自动发现（见上），只有自动发现找错时才需要 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 里报出来。

dsh-pbr-material

インストール

ドキュメント

配置