独立镜头 / 转场：不依赖前段，适合换场景、时间跳跃或开场。
状态承接：将前镜头结束状态与本镜头起止状态加入生成约束；允许换角度，仍使用本镜头的资产参考图。
尾帧接续：同场景连续动作。等待前段完成，从所选视频结束前 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 中的上游历史保留在本地，不作为子模块提交；新克隆会直接得到完整源码。