前言¶
DeepSeek Harness 的生态理念是“一切皆插件”。对于需要处理复杂视频生成任务的开发者而言，ComfyUI 提供了极高的灵活性，但直接使用其原生 API 往往缺乏持久化的工作流界面管理，且多服务器调度较为繁琐。该插件旨在解决这一问题，通过将 ComfyUI API JSON 导入为可长期保存的动态工作流页面，并提供跨服务器的任务队列管理与输出归档功能。
插件简介¶
dsh-comfy-video-studio 是一个由 a1303845406 开发的开源工作流插件（MIT 许可证）。它不再内置 MiniMax、Wan 等特定模型模板，而是支持导入任意 ComfyUI API 格式的 JSON，将其转化为可视化的工作流页面，并具备运行时兼容性检查、多服务器并发管理和视频输出管理能力。
核心功能¶
-
API JSON 导入与解析
插件支持导入 ComfyUI 的“导出（API 格式）”产生的 JSON。它会自动识别节点中的常量参数、图片或视频上传接口、枚举类型、模型引用以及 SaveVideo 输出节点。 -
运行时兼容性检查
在导入或运行前，插件会调用目标 ComfyUI 服务器的 /object_info 接口，检查缺失的节点、模型、无效的枚举值以及端口类型，防止任务在远端执行时报错。 -
工作流页面管理
导入成功后，用户可以保存、重命名工作流页面，并对字段进行编辑。支持修改字段的显示标签、分组、顺序以及标记高级参数。 -
多服务器与任务队列
插件支持动态保存多个 ComfyUI 服务器。它能够检测各服务器的延迟、设备状态、显存占用和远端队列情况。每台服务器可独立设置 1 到 3 个插件活动槽。超出活动槽的任务会保留在本地 FIFO 队列中，等待执行。 -
输出管理与持久化
所有视频输出均会被保存。用户可以指定其中一个作为任务的主预览。工作流、连接、任务和队列数据会持久化存储，确保 Harness 重启后能恢复等待中的任务和已有 prompt_id 的监控状态。
使用流程¶
- 在“服务器管理”页面添加或检查目标 ComfyUI 服务器。
- 在“导入”页面上传符合 API 格式的 JSON 文件。
- 查看插件生成的运行时兼容性报告。
- 在工作流定义中选择主 SaveVideo 输出节点，并勾选需要在界面上显示的参数。
- 保存工作流页面，随后即可通过动态页面提交任务。
配置与数据存储¶
插件支持通过 YAML 配置文件进行基础设置。默认持久化目录位于 $DSH_HOME/storages/dsh-comfy-video-studio/，包含连接设置、历史记录、原始 JSON 和页面定义文件。
配置示例：
- insert:
- id: comfy-video-studio
name: dsh-comfy-video-studio
config:
baseUrl: http://127.0.0.1:8188
maxUploadMb: 100
maxWorkflowMb: 5
requestTimeoutMs: 30000
historyLimit: 200
注意事项¶
- JSON 格式限制：插件只支持“导出（API 格式）”产生的 JSON。这种格式要求顶层键是节点 ID，每个节点包含
class_type和inputs。画布 JSON 会被拒绝并提示重新导出。 - 认证方式：服务器地址只接受无内嵌账号密码的 HTTP(S) URL。如果 ComfyUI 需要认证，应由反向代理处理。
- 依赖处理：缺失的节点或模型依赖只会阻止任务执行，不会阻止保存工作流页面。插件不会联网查询或自动安装节点和模型。
- 并发执行：标准单 GPU ComfyUI 通常仍会串行执行远端 prompt。活动槽 2–3 的设置控制的是插件提前提交任务的数量，并不保证 GPU 在硬件层面真正并行。
结语¶
该插件为在 DeepSeek Harness 中集成 ComfyUI 提供了标准化的工作流入口和队列管理方案。开发者可以通过社区目录页或 GitHub 仓库获取源码与更多细节。
