dsh-short-video-studio

配置（个性化）

优先级：环境变量 > 配置文件 > 默认值。Web 设置页的 ComfyUI 菜单提供可视化编辑，保存即生效：

ComfyUI 设置页

配置文件：~/.dsh/dsh-short-video-studio.json（或 DSH_SVS_CONFIG 指定路径）：

{
  "canvasHome": "tab",
  "baseUrl": "http://localhost:8188",
  "apiKey": "",
  "pollMs": 2000,
  "timeoutMs": 900000,
  "models": { "fluxUnet": "flux2_dev_fp8mixed.safetensors", "h3Fps": 24, "…": "…" },
  "tiers": {
    "video.reference2video": { "fast": "minimax-h3-ref2v-fast", "balanced": "minimax-h3-ref2v-balanced-sol", "quality": "minimax-h3-ref2v-quality-sol" }
  },
  "preferred": { "image.image2image": ["flux2-img2img"] }   // 写家族名：该家族在各档的实现都会被优先选中,
  "assetOverrides": { "minimax-h3-ref2v-quality": { "unet": "my_custom.safetensors" } }
}

• canvasHome：画布挂在哪儿。"tab"（默认）＝会话区视图标签页（与「对话」并列，整屏工作态）；"sidebar"＝右侧栏标签页（边看对话边生成，还能浮动成可拖拽缩放的面板）。设置页 ComfyUI → 界面 里改。两种取值下只有一个画布实例——插件启动时只注册选中的那个家，互斥由结构保证，不存在两个 iframe 抢同一份工程的状态问题。入口与「工作区文件」「新建终端」同一套原生做法：右栏折叠时从会话标题栏右上角的展开按钮进入，在引导页点「短视频画布」胶囊。改选即保存，刷新页面后生效（设置页有「立即刷新」按钮）。换家只换挂载点：工程数据、生成能力、Agent 工具全都不受影响；
• models.* / 环境变量（DSH_SVS_COMFY_URL / DSH_SVS_FLUX_MODEL / DSH_SVS_H3_MODEL_REF / DSH_SVS_H3_MODEL_FL / DSH_SVS_H3_LORA_FL_FAST / DSH_SVS_H3_LORA_8STEP 等）：换模型文件不改图结构；
• preferred：未分档能力默认用哪个工作流（设置页「设为默认」写回这里）——把你导入的工作流设为某能力的默认，即完成「换模型」，内置清单可保留可遮蔽可删除。H3 视频能力已分档，默认由 tiers / 设置页策略决定，不走 preferred；
• tiers：已分档能力的档位选择（capability → tier → 实现 id，见 docs/tier-strategy-design.md §4.1）；设置页点选策略/逐档下拉就是写这里。选「内置默认」= 清空该能力的条目（回到跟随注册表首选）；
• strategies：你自己命名并组合的策略（capability → [{ id, name, tiers }]）。设置页「＋ 新增策略（命名 + 逐档组合）」写这里，可重命名 / 编辑档位 / 删除，上限 24 条/能力；tiers 只需 ≥1 个档位，而策略定义了它提供哪些档位（没写的档位不属于它，请求会显式报错而不是回退）；指向不存在实现的选择在投影时被丢弃（不留死引用）；
• strategyOf：最近一次点过的策略 id（capability → 策略 id），只用于 UI 点亮与消歧（某条用户策略的组合恰好等于默认时，避免两个单选同时点亮）；真正生效的仍然是 tiers；
• assetOverrides：覆盖资产文件（同 $assets 机制，优先级最高）。精确匹配该档 id 的覆盖 > 旧 id 继承的覆盖（minimax-h3-ref2v-* 继承 minimax-h3-ref2v、*-balanced* 额外继承 minimax-h3-ref2v-8step、minimax-h3-i2v-* 继承 minimax-h3-i2v）；
• apiKey 非空时请求带 Authorization: Bearer（适配需鉴权的 ComfyUI 网关）。

关于"某能力的默认工作流是哪一个"：已分档能力（H3 视频）不用 preferred 解析档位——档位由 tiers 配置或各实现里该档的首选（priority 降序 → 非加速优先 → id 升序）决定（见 docs/tier-strategy-design.md）。preferred 对未分档清单（图片能力、你导入的自定义清单）仍是固定选择；没有 preferred 时取候选列表第一个，顺序是确定性的：priority 降序（缺省 0），相同则按 id 升序。想让某份清单永不被选为隐式默认（实验性、依赖自定义节点），在它的 JSON 里写负数 priority（内置的 PDD 清单用 -30；显式在设置页选进策略仍可用，缺节点时如实置灰而不是静默换实现）。internal: true 的诊断清单（如 minimax-h3-ref2v-sol-stats）则完全不参与解析。要显式钉住未分档能力的默认：

"preferred": { "image.image2image": ["flux2-img2img"] }   // 写家族名：该家族在各档的实现都会被优先选中

可选的加速件（非内置默认，按需开启）

项	开启方式	实测收益（ComfyUI 0.33.3 / 124 帧 / 同 seed 关开对照）
fl2v 8 步 768p LoRA（minimax_h3_fl2v_turbo_8step_v1.0_768p_comfyui_bf16.safetensors，i2v balanced 档）	models.h3FlBalancedLora 或各清单的 assetOverrides..lora_8step	lightx2v/Minimax-h3-Turbo（Apache-2.0，1.82GB）。必须与 shift 6/3 配对：768p 系 LoRA 配 544p 系的 shift 12/3 会结构性崩坏，而不是「略糊」——这就是该档单列一份模板（scripts/h3-templates/minimax-h3-i2v-8step.json）而非改现有 i2v 清单的原因
int8_convrot 视频 VAE（需自行下载 minimax_h3_video_vae_int8_convrot.safetensors，Kijai/MiniMax-H3-experimental）	models.h3VideoVae 或各清单的 assetOverrides..vae（不设则用内置 fp16）	解码 ~1.2–1.5×、常驻显存 2.7GB vs 5.0GB；同 seed 抽帧像素均值差 1.88/255（视觉等价）。端到端仅省 ~2s/镜（480p）～~5s/镜（768p）
日常档 balanced（组「MiniMax H3 参考生成视频」，清单 minimax-h3-ref2v-balanced / -balanced-sol）	显式传 tier="balanced"（或在设置页把该档选成带加速实现）	166.3s/镜（带加速 136.3s）vs 成片档 396.6s/镜（省 58%），画质明显优于 4 步 fast 档，帧锐度比 quality 还高约 13%
PDD 8 步蒸馏（需自装第三方节点包 ComfyUI-MiniMax-H3-PDD-Acc + 权重 aptech0081/MiniMax-H3-Acc-LoRAs-ComfyUI，Apache-2.0，Ref2VA/FL2VA 各 1.54GB）	权重必须放 ComfyUI/models/pdd_acc/；配置键 models.h3PddRef2v / models.h3PddFl2v（env DSH_SVS_H3_PDD_REF2V / DSH_SVS_H3_PDD_FL2VA）或 assetOverrides..pdd；在设置页「＋ 新增策略」里把该档选成 …-balanced-pdd[-sol]（不做隐式默认，priority **档位契约全文**：见 [docs/tier-strategy-design.md`](https://github.com/fengyungithub/dsh-short-video-studio/blob/9f7443661fb1b577753ca057f547e119b2abe974/docs/tier-strategy-design.md)（三层模型、受控三档、清单字段契约、**策略＝内置默认 + 用户命名组合**、解析与错误语义、实施阶段与验收脚本）。

内置清单不默认使用第三方 int8 VAE：它是社区实验件，通过配置或 assetOverrides 开启，符合"换模型=改配置/加清单"的设计。balanced（8 步）与加速实现（-sol）已改为内置：前者是正式档位之一；后者需自装第三方节点，缺节点时该实现置灰不可用（不静默回退），并在设置页「＋ 新增策略」里自行组合、命名、选用。

H3 加速选型与实测数据：见 docs/minimax-h3-acceleration-lora.md（LoRA 全家福、shift/steps/分辨率/base 四条硬约束、三档成本阶梯、PDD 复测与落地（§9.9）、Sol-Attn 细则、剩余杠杆排序）。

全工作流 Benchmark（分辨率 × 档位 × LoRA × Sol 加速）：见 docs/minimax-h3-video-benchmark.md —— 速查结论表、token/成本模型（分辨率超线性 tokens^1.5、步数线性 t≈19s+18.9s×步数）、Sol 交叉点（768p 才值得，1.25–1.38×）、一条 60 镜短片的时间换算、陷阱与未测清单。取数脚本：node e2e-out/bench.mjs、node e2e-out/inventory.mjs。

I2V 与 Ref2V 的概念差别 · 跨模型选型参考（LTX-2.5 vs MiniMax H3）：见 docs/i2v-vs-ref2v-and-model-comparison.md —— 两种"图生视频"的机制差别、角色一致性 / 分辨率 / 时长 / 速度 / 音频与字幕 / 部署成本逐维对照、按镜头类型的选型建议与未验证清单。本文是技术选型参考，不属于插件契约（插件侧只说能力、保持模型无关）。