在 ComfyUI 画布里管理素材、分镜、生成队列和镜头版本。
高清二采与人脸修复功能完整保留，包括各自的 LoRA、强度、精修参数，以及高清二采的空间分格设置。这些功能继续使用输入模型已有的优化。移除的只有导演台内重复的 SLA / Sol / SM75 等专用模型分块后端；需要这些优化时，在外部 H3 Chunk 节点设置后接入导演台。原生模型可以正常接入，不强制安装分块插件。
生成视频与需要重新编码的导出默认使用“自动（GPU 优先）”：H.264 / H.265 检测可用的 NVIDIA NVENC，无法使用时回退到 CPU。导出设置也可明确选择 GPU 或 CPU；VP9 和 CRF 0 等不适合当前硬件路径的设置在自动模式使用 CPU。已有符合导出设置的视频仍直接复制／合并，避免无意义地重新压缩。
GPU 编码使用独立视频编码单元，速度与画面转换、分辨率、驱动有关；不会要求 CUDA 占用率一直满载。CPU 的 CRF 与 NVENC 的 CQ 不是完全等价的质量标尺，可按实际画面调整质量或码率。此功能仅负责视频压缩，与 H3 模型分块、二采和修脸是独立环节。
高清的空间分格、潜空间放大、人脸裁剪修复和 VAE 分块解码保留。这些处理不要求启用专用注意力内核；实际显存需求与能否运行仍取决于接入模型、硬件、分辨率及帧数。更改后端设置后请重启 ComfyUI、刷新页面。
大视频生成收尾时，首尾对齐通过帧索引送入编码器，避免复制整段 RGB 视频。画面缓冲优先使用内存，仅在可用内存不足以容纳画面并保留工作空间，或 CPU 内存分配失败时，才使用临时文件映射兜底；临时画面随任务释放。兜底需要 ComfyUI 临时目录有足够磁盘空间，慢硬盘可能增加耗时。
支持按需添加任意数量的关键帧，在时间轴上自由安排引导画面。 不再局限于首尾两张图或固定数量的槽位，可通过增减关键帧、拖动位置、填写秒数，控制镜头不同阶段的画面，创作自由度更高。时间精度为 0.1 秒；关键帧需位于镜头时长内，同一采样帧不能重复占用。
- 首尾帧固定在时间轴底层，其余关键帧向上避让；缩短时长保留原图与时间，越界位置完整可见并明确提示。
- 关键帧可直接上传、预览、替换，随项目保存和打包，无需先加入素材库；高清二采继续使用原图锚点。
- 关键帧与素材库图片可拖入提示词作为图片参考，引用 ID 稳定，调整时间顺序不换图；仅设置时间锚点不占用 Picture 编号。
- 支持使用上段尾帧作为此段首帧，或使用上段尾部视频进行运动引导；模式互斥高亮，占位与大图预览带文字说明，尾帧按视频版本缓存。
- 镜头列表右键支持复制镜头，保留设置、插在原镜头后，独立编辑并支持撤销。
更新后重启 ComfyUI 并刷新页面。请保留已有 data/；上段仍使用旧关键帧时间轴或缺少无损衔接缓存时，运动引导预检会提示重新生成上段。
该版本曾同步一份内附分块实现；自 v0.3.1 起已移除这份模型后端，统一继承外部模型。H3 Chunk 2.18.8 修复的是增强载入器自身的逐 token 调制与门控临时张量峰值，属于通用显存修复，并非导演台专用适配，也不表示原先的 QKV／MLP 分块未生效。使用该载入器时应更新它；原生加载路径不因此要求安装 H3 Chunk。此修复不保证所有显卡架构可用或完全避免显存不足。
- 运动引导读取对应版本的原始一采潜空间，二采使用前段最终潜空间保护衔接区域；缺少所需缓存会提前提示，不回退到压缩视频参考。
- 修复运动引导与二采分格同时使用时，保护遮罩宽度不匹配导致的报错；减少未使用尾部帧的冗余计算，增加解码分阶段计时。
- 重新整理缓存管理排版，可按一采、二采、修脸、运动衔接类型选择清理。当前项目及生成／排队中的项目受保护，切换项目后可清理空闲项目，素材和成品保留。
- 正在生成的镜头增加停止入口；右上角原生“运行”按当前选中镜头生成，并同步队列、结果和种子。
旧版本没有保存新衔接所需的最终潜空间。遇到缺失提示时先重建所指出的前段缓存；已有一采缓存的独立前段可以只二采，旧运动引导一采缓存则需要重新生成当前镜头。更新后需重启 ComfyUI。本次不承诺所有场景无缝衔接或固定提速比例。
显式包含作者示例工作流目录，确保 Comfy Registry 安装包保留中文文件名的示例 JSON。
- 导演台运行日志统一为英文事件，包含镜头、阶段、耗时和基础缓存保存／复用记录；界面标签保留中文。
- 执行报错只标记真正失败的步骤，保留底层异常与调用栈，不再将同一次失败逐层包装成解码、编码等多处错误。
- 增加 Comfy Registry 发布配置与专用打包排除规则；本地项目、素材、模型、缓存和日志不进入安装包。
- 图片素材描述增加“将描述词注入提示词”开关，默认关闭；开启时在图片标签后注入描述，关闭保留内容，随项目包与素材包保存。
- 人物绑定音色优先使用提示词中的显式音色引用；整段提示词遗漏绑定音色时，在人物图片标签后补充实际音频标签。导出素材大纲的 Skills 与示例同步标准音色用法，不自动猜测说话者编号。
- 修复去漂移设置变化后无法单独二采／修脸的问题；后处理成功后不再残留去漂移参数提示，仍保留真实一采缓存来源。去漂移位于“镜头衔接”，是默认关闭的测试选项，不保证解决颜色或纹理变化。
- 二采／修脸 LoRA 增加“不使用 LoRA”选项；仅移除继承的权重适配，不修改一采模型，不能移除已合并进模型文件的权重。
- 最小字号统一为 17px，正文 18px；移除页头副标题，调整描述开关布局。高清二采保留模型放大路径，兼容旧插值测试配置。
精修强度为 0 时跳过精修采样；日志区分放大、精修和总耗时。高分辨率与多分格仍可能耗时较长，本次不承诺推理提速或画质改善。
正式示例仍使用项目作者提供的 Star7导演台.json，内容未改动。此前 v0.1.0 为旧开发快照，请使用当前版本与作者示例。
- 导演台工作站 — Star7：分镜、镜头设置、生成队列、预览、二采、修脸和视频导出。
- 项目素材库 — Star7：人物、场景、物品、音色、视频与文字素材管理。
本插件只注册这两个公开节点。H3 条件、采样调度、高清二采、人脸修复、预览和解码实现包含在包内；内部步骤不展开为额外画布节点。视频编码和导出由内置实现完成，无需 VHS / VideoHelperSuite。
工作站接收模型、文本编码器、视频 VAE、音频 VAE和素材库输入。模型权重由使用者准备；Python 库依赖明确列在 requirements.txt 中。
- 将仓库或发行 ZIP 中的
star7-director文件夹放入ComfyUI/custom_nodes/。 - 使用运行 ComfyUI 的同一个 Python 环境安装
requirements.txt，然后重启 ComfyUI。 - 打开 作者示例工作流，选择本机已有的模型、CLIP、视频 VAE、音频 VAE和所需 LoRA。
- 在素材库添加素材，在导演台导入或添加镜头，检查参数后生成。
示例的模型输入链包含 MiniMax H3 Chunk—Star7 的模型加载、Sigma Shift、VEDA和显存分块节点，运行这份示例需要安装该插件。导演台接收该输入链处理后的模型，二采和修脸继续继承它的模型补丁，不会重新安装另一份分块后端；模型输入链可换成其他兼容的 ComfyUI 节点，使用原生模型时无需安装 H3 Chunk。示例中不包含模型或私人素材，加载后需选择本机模型并添加分镜。
ComfyUI 核心需要支持 MiniMax H3，旧版核心不能通过安装导演台补齐模型支持。不要用旧开发快照中的辅助节点工作流替代本次作者示例。
素材使用稳定 ID，镜头描述通过 @ 引用。普通素材改名不会替换提示词里的普通文字。素材缺失时保留素材卡、引用和镜头参数，补回文件后继续使用。
支持分镜导入、检查、导出、插入、右键增加镜头和拖动排序。导出素材大纲包含提示词编写 Skills 与当前素材目录。导入字母映射：
| 字母 | 模式 |
|---|---|
| I | 独立镜头 |
| R | 运动引导，接续前段动作与运镜 |
| F | 前段尾帧画面参考 |
| S / E / SE | 首帧 / 尾帧 / 首尾帧 |
| K | 自由关键帧时间轴，可选首尾帧及任意数量的中间关键帧 |
新故事首段使用 I；后续镜头省略模式时默认 R。“运动引导＋重绘”仍可手动选择，但不是 R 的默认模式。素材大纲中的 Skills 与该映射一致。
支持仅重新生成当前、仅二采／修脸、批量选择、继续生成全部。生成期间可追加任务，队列面板列出镜头顺序和一采、二采、修脸阶段；尚未开始的任务可取消；正在生成的任务可停止，使用指定任务编号，不发送全局中断。缺少依赖的镜头会报告原因，后续满足条件的独立镜头可继续。
浏览器刷新后恢复后台任务状态；即时预览不保留旧帧，后续预览或阶段结果会更新。关闭 ComfyUI 服务会中断正在执行的任务，已保存成品保留。
修改提示只比较明确的镜头输入：提示词、种子、秒数、输入/参考模式、首尾帧、实际引用素材、二采/修脸需求等。改回原参数会消除提示；外部模型或 LoRA 改动不会把全部镜头标为参数修改，执行缓存仍会核对真实生成条件。
普通连续性参考的前段一采变化单独提示，不自动连锁重跑。智能首尾帧使用上段尾帧时，实际输入变化纳入更新。已有二采/修脸成品不会仅因取消开关而自动降级。细节生成预设为 8 步。
导出设置支持帧率、H.264 MP4 / H.265 MP4 / VP9 WebM、CRF或目标码率、像素格式、音频开关与码率、可选参数元数据。默认保持当前源视频参数并直接复制；调整设置只重新编码导出副本，不重新生成镜头、不覆盖原视频。帧率转换保持时长，通过补帧/减帧实现，不进行 AI 插帧。
生成成品保存到 output/Star7-Director/年月日/。导出当前镜头直接保存到指定目录，不额外保留一份永久导出副本；分段和合并导出各自新建“项目名称-分段导出/合并导出-时间戳”文件夹。分段按镜头顺序保存已有成品，尚未生成或文件不可用的镜头会列出并跳过。
缓存管理可勾选项目删除二采/修脸辅助缓存，保留素材与成品视频。当前项目以及正在生成／排队的项目禁止清理；请切换到其他项目，再清理空闲项目。支持按缓存类型选择，清理后单独二采／修脸或运动衔接可能需要重建对应缓存。
运行数据位于 data/projects/<项目ID>/，按项目保存配置、素材、队列记录和辅助缓存。更新代码时保留已有 data/，不要删除用户项目。
仓库和发行包不包含本地项目、私人素材、模型权重、缓存、日志或生成视频。普通工作流携带配置与素材引用；项目 ZIP 可携带素材，不打包模型、成品或 latent 缓存。更多说明：文件管理、架构与状态规则。
Star7 代码采用 MIT 许可。AIMixer 衍生连续性代码保留 Apache-2.0 许可；内置第三方实现保留各自版权与许可。详见 LICENSE 与 THIRD_PARTY_NOTICES.md。
本次更新已执行 CPU 回归、实际视频编码/导出测试及界面生命周期测试。GPU生成效果取决于模型、硬件与提示词，未对所有硬件和生成组合进行验证。