火宝短剧 · 本地多显卡版

基于 chatfire-AI/huobao-drama 4.0.11 的本地定制代码。上游源码基线为 b48e6b2312166e25b1ff141832d2e82e5d63c142，原项目说明和许可证保留在 huobao-source/。

已集成功能

模型桥接与多显卡图片、视频调度；可按单个分镜选择显卡重新生成。
显示实际执行节点：GPU1 / ComfyUI 8189、GPU2 / ComfyUI 8188、GPU3 / ComfyUI 8191。
MiniMax H3 视频及 VDN-H3 2K/4K 高清版本，保留原版供对比。
角色、场景、道具的图片参考图上传与编辑接口。
本地长任务持续查询、重启后恢复查询和原任务结果恢复。
任务列表可单独取消排队或生成中的本地图片、视频任务，保留已有素材和历史记录。
固定数据目录、一键启动、升级备份与真人实拍、仙侠风格预设。
跨集结尾上下文、分镜起止状态、前镜头尾帧接续与持久化依赖队列。
中英文视频提示词同步保存，MiniMax H3 提交前使用英文制作描述，保留中文对白与素材引用。

英文视频提示词

新拆分镜、重新生成视频提示词时同时产出中文和英文。视频提示词下方可查看、编辑或重新翻译英文；「补齐英文」仅翻译已有中文提示词，不重新拆分镜、不生成视频。中文修改后旧英文标记为待更新。

MiniMax-H3 系列（含加速版、VDN 高清）提交前自动补齐或更新英文，并翻译镜头衔接约束。对白原文、@/# 素材标记和时间段通过校验后才提交，中文台词不改为英语；语音标记采用 H3 可识别的 says: / Dialogue:。翻译失败时不提交新视频，也不取消原任务。任务记录保存实际英文请求文本并显示「英文提交」。已生成视频不自动重跑。

镜头衔接

视频制作中、视频提示词上方的「镜头衔接」面板提供三种模式：

独立镜头 / 转场：不依赖前段，适合换场景、时间跳跃或开场。
状态承接：将前镜头结束状态与本镜头起止状态加入生成约束；允许换角度，仍使用本镜头的资产参考图。
尾帧接续：同场景连续动作。等待前段完成，从所选视频结束前 0.05–3 秒提取画面作为单张首帧，再向选定 GPU 提交。支持当前本地 MiniMax-H3、MiniMax-H3-Hybrid、Wan2.2-I2V；不与多张参考图或参考音色混用。

来源默认为按集号、镜号排序的前一镜，也可选择本项目更早的镜头。不能引用未来、自身、其他项目或已删除的镜头。第一镜、转场需用独立模式。拆分镜工具会读取上一集结尾剧本及最后三个分镜；起止状态是文字设定，不代表系统已经识别或审核了成片画面。

已有分镜升级后保持原模式、原视频，不会自动重新生成。新拆分时 Agent 会填写起止状态并选择衔接方式；旧分镜可在面板中补填后保存。尾帧预览仅提取画面，不生成新视频。前镜头失败时下游保持等待；可取消等待，或先处理前镜头。等待中的任务可重启恢复，并保留原模型与显卡选择。

前镜头版本或起止设定改变后，已生成的下游视频显示核对提示，旧版保留，不自动重跑。依赖链按顺序提交，独立镜头仍可多卡并行。VDN-H3 高清制作仍使用其参考图工作流，不支持固定首帧接续。

视频进度与预计耗时

视频预览下方、任务列表和高清制作页会显示排队、模型加载、采样、解码与编码阶段，以及已提交时长。采样步数来自对应 ComfyUI 任务的实时消息；积累足够的步速记录后显示当前采样阶段的剩余时间区间，后续解码、编码和保存另计。

整段视频耗时只参考同显卡、同工作流及规格的成功记录，不包含排队与下载；样本不足时不报估算。采样完成不代表成片完成，连接中断或数据过期会隐藏旧估算。进度读取不会取消、重新提交或改换显卡。

服务器的进度扩展源文件为 integration-work/comfy_progress.py，由 install_comfy_progress.py 备份后嵌入现有适配器；无需重启 ComfyUI。图片、视频及私有配置仍不进入 Git。

取消任务

打开右上角「任务」，在对应图片或视频记录上点击「取消任务」。只停止这一条任务，不影响其他镜头、其他显卡任务或已有素材。等待前镜头的任务也可以直接取消。

已提交的任务需要收到对应节点的取消确认，才会显示「已取消」；未收到回执时显示「正在等待显卡确认」，可重试取消，重启后仍会跟踪原任务。提交中尚无任务编号、已经完成或正在保存结果的任务不提供取消按钮。已取消任务单独统计，不计入失败数量。

目录或文件	用途
`huobao-source/`	前端、后端、Electron 桌面端源码及上游文档
`model-bridge/`	模型桥接、启动、打包、升级、数据检查和测试脚本
`integration-work/.py`、`.ps1`、`*.cjs`	服务器适配、部署、迁移及验证脚本；部分为历史维护步骤，运行前阅读脚本
`integration-work/browser-test/`	浏览器界面验证脚本
`一键启动火宝.cmd`	当前 Windows 工作站的启动入口
`升级与高清制作说明.txt`	本地升级和高清制作说明

本地数据与配置

此仓库保存代码，不包含项目数据库、模型密钥、生成素材、视频、安装包和备份。现有机器上的这些文件不会因为加入 .gitignore 而被删除。

huobao-data/：项目、模型配置、素材和生成记录，必须单独备份。
HuobaoDrama/：安装后的桌面应用，不随代码上传。
model-bridge/client.json、grok-client.json：本机连接配置和令牌，不上传。
integration-work/backups/、previous-app-*/、stage-4.0.11/：升级备份及打包产物，不上传。
所有常见视频扩展名均已加入忽略规则；TypeScript 的 .ts 源码正常跟踪。

在新机器上仅克隆代码不会恢复原项目和模型配置，需要另外恢复数据备份并配置私有接口。维护脚本含当前工作站路径和内网节点约定，迁移前需按部署环境检查。

开发与构建

按 huobao-source/README.md 和各目录的 package.json 安装对应依赖并构建。当前本地升级流程还使用 model-bridge/build_upgrade.py 与 switch_upgrade.ps1，需要准备已验证的 4.0.11 桌面运行包；安装包与暂存包不存入 Git。

一键启动火宝.cmd 面向已经安装、已有数据的工作站，不是全新安装程序。升级前先保存编辑并完成数据库、素材和配置备份。

Git 同步

git pull --ff-only origin main
git status
git add <需要提交的代码路径>
git commit -m "说明本次修改"
git push origin main

拉取代码不会自动替换正在运行的桌面程序。构建和升级需单独执行。当前工作站 huobao-source/.git 中的上游历史保留在本地，不作为子模块提交；新克隆会直接得到完整源码。

7.1 KiB Raw Blame History