short-drama-director-dsh

短剧制作导演

> 想用 ComfyUI 免费做短剧，又不想学节点连线？这个项目把剧本、资产、分镜、视频提示词和 H3 工作流放进了 DeepSeek Harness 的创作台。

短剧制作导演是一个 DeepSeek Harness / DSH Desktop 插件，不是 DeepSeek 网页版功能，也不是通用 Agent 插件。它通过 Agent 调用本机或云端 ComfyUI，并在插件内提供资产库、分镜管理、视频提示词、MiniMax H3 转换、工作流配置和生成任务面板。

它适合不想从零搭 ComfyUI 工作流的单人创作者，也适合需要交接项目、复用资产和逐步返工的小团队。默认目标是让用户判断内容，插件负责资产绑定、工作流选择、任务提交、结果回收和归档。

当前版本：1.1.0

一眼看懂

flowchart LR
  A[剧本] --> B[人物 / 场景 / 道具资产]
  B --> C[分镜与视频提示词]
  C --> D[MiniMax H3 / 自定义工作流]
  D --> E[本地或云端 ComfyUI]
  E --> F[候选视频与结果归档]

一个典型流程：

1. 导入或粘贴剧本，让 Agent 盘点本集需要的资产。

2. 在资产库中确认人物、服装、场景和道具版本。

3. 生成或粘贴分镜，把 @人物、@场景、@道具 绑定到具体资产。

4. 在分镜面板检查参考图、视频提示词和工作流。

5. 提交到本地或云端 ComfyUI，等待任务完成。

6. 在结果区播放、比较、重做或选用，继续下一集。

界面截图

| 资产管理 | 分镜与 H3 绑定 |

| --- | --- |

| | |

它能做什么

短剧制作流程

• 从剧本整理人物、场景和道具资产，避免把盘点稿误识别为资产。
• 通过 ComfyUI 生成定妆照和资产图，不依赖按张购买的生图 API。
• 场景日夜、人物服装等变体必须从原资产走图像编辑，不允许用文生图重新造资产。
• 自动生成分集视频提示词，并把 @人物、@场景、@道具 绑定到具体资产版本。
• 将确认后的视频提示词转换为 MiniMax H3 中文格式。
• 在右侧分镜管理面板查看镜头、参考素材、视频提示词和生成结果，不必在多个文件之间来回切换。
• 支持拆分、重新拆分和复制分镜；提示词正文仍然是内容来源，界面只展示解析结果。

工作流与执行

• 支持本地 ComfyUI、云端 ComfyUI 和双端切换。
• 全局配置中可以按任务分别选择工作流，本地和云端环境可以保存不同选择。
• 自动扫描工作流目录，识别任务能力、模型引用、输出节点状态和匹配情况。
• 工作流改动后会重新检查；模型缺失、必需输入缺失或输出节点被旁路时，在提交前提示。
• 支持工作流记忆，把与剧情无关的兼容性经验和踩坑记录保存下来，供后续会话复用。
• 自动发现 ComfyUI、Python、模型和工作流位置，不写死安装盘符。

任务与结果

• 记录生成任务、候选视频和成片归档位置，任务面板刷新后重新从实例核对结果。
• “ComfyUI 运行完成”“文件已保存”“用户已选用”是三个独立事实，不混成一个成功状态。
• 生成失败时尽量保留原输入与候选，便于只重做有问题的镜头。
• 项目、资产和生成结果保存在用户自己的目录，不混入插件仓库。

工作流可以切换，但不建议从空白图重搭

工作流选择入口在 全局配置 → 对应任务 → 本地 / 云端 → 工作流。本地和云端是两套独立配置，保存后会按当前执行环境解析对应工作流。

最推荐的做法：复制随插件或整合包提供的已验证工作流，在副本上修改。

原因很直接：插件不只需要一个能出图的 ComfyUI 图，还需要知道提示词写进哪个节点、参考图对应哪个输入、哪些参数可以安全覆盖、哪个输出才是最终结果。从空白图开始搭当然可以，但需要额外完成这些绑定和验证；基于现有工作流改，通常兼容性更强，也更容易定位问题。

推荐顺序：

1. 先在 ComfyUI 中打开一份插件提供的工作流。

2. 另存为新的文件名，例如 H3-我的工作流-v1.json，不要直接覆盖原始文件。

3. 保留输入、参考素材、提示词、输出和关键模型节点，只替换或插入需要改动的节点。

4. 在 全局配置 中选中新工作流，保存并检查识别到的工作流能力、模型和输出节点。

5. 先跑一条短镜头，确认参考图、提示词、时长、输出文件和音频都正确，再接入整集。

当前兼容边界：

• 随插件提供的已验证工作流：兼容性最高，适合直接使用。
• 基于已验证工作流的小改版：例如替换同类型模型、LoRA、采样参数或增加一个后处理节点。只要保留必要输入和输出，通常最容易迁移。
• 结构相近但未知的工作流：插件会尝试识别能力；当前会话有可用模型时，也可能生成语义适配表，但这不是“任意工作流一键兼容”的承诺。
• 结构差异过大的工作流：可能需要显式完成输入、输出和任务角色映射，否则应在验证阶段阻断，而不是带病提交 GPU 任务。

更完整的改造步骤、验证清单和常见故障见 [工作流兼容与改造指南](docs/WORKFLOW-GUIDE.md)。

两种模式，一个底座

| 模式 | 适合做什么 | 边界 |

| --- | --- | --- |

| 通用模式 | 单张生图、图片编辑、视频生成、超分和临时实验 | 不要求创建短剧项目 |

| 短剧模式 | 剧本、资产、分镜、视频提示词、H3、任务结果和成片归档 | 需要明确的短剧项目目录与模式状态 |

模式切换是显式操作，不会因为打开某个面板或扫描工作流就自动进入短剧流程。只浏览分镜、查看资产或做环境预检，不会启动 GPU 生成任务。

还有这些细节

• 资产可按类型筛选，并查看本集是否使用；同角色不同服装、不同状态不会被当成同一个文件。
• 四视图、换装等衍生资产从原始资产发起，保留来源，不把重绘结果伪装成原图。
• 分镜支持新增、复制、拆分和重新拆分。【大分镜N】 只用于展示，正文里的时长和内容仍是解析来源。
• 视频提示词可以绑定具体资产版本；生成计划会显示实际使用的参考图顺序、任务方案和执行环境。
• H3 转换和校对会保留提示词来源；来源发生变化时会提示同步，而不是静默覆盖。
• 任务面板显示排队、运行、完成、下载失败和待核对等状态，刷新或重启后可重新检查结果。
• 本地和云端可以保存不同工作流与参数，不会因为切换一端而悄悄覆盖另一端。
• 多个工作流目录会被合并扫描；云端实例离线时仍可显示上次同步的缓存。
• 工作流记忆可保存与剧情无关的兼容性经验，后续会话可以继续复用。
• 环境发现会检查用户配置、环境变量、上次路径、同级目录和磁盘目录，不依赖作者机器的盘符。

适合谁

• 想用本地 ComfyUI 做短剧，但不想每天手连节点的人。
• 需要把剧本、资产、分镜、提示词和生成结果放在同一套项目结构里的人。
• 有自己工作流，希望基于现成流程做少量改动并保留可追溯性的人。
• 需要交接项目、复用资产、重做个别镜头的小团队。

不适合把它当成“任何 ComfyUI 工作流零配置直接跑”的万能执行器，也不适合把未验证的输入直接投入整集批量生成。

运行要求

• DeepSeek Harness / DSH Desktop，需兼容插件声明的 0.2.0-rc.2 peer dependencies。
• 图片和视频生成需要本机或云端 ComfyUI。仅使用剧本、分镜、提示词和 H3 转换时，可以先不连接 ComfyUI。
• Windows 是目前完整支持本地实例启停和桌面安装的目标平台。其他系统仍可使用不依赖 Windows 启动器的功能。

安装

本地 ZIP