火宝短剧本地安装：4.0.11（附本地模型池和高清制作功能）

启动：双击桌面的“火宝短剧-一键启动”，或 D:\web\dj\一键启动火宝.cmd。
数据：D:\web\dj\huobao-data。数据库、项目和素材始终使用这个目录。
程序：D:\web\dj\HuobaoDrama。不要把数据目录当作程序目录清理。
一键启动每次都会检查数据库，并备份到 huobao-data\backups。
若数据库缺失，新版会停止启动并提示检查数据目录，避免悄悄创建空库。

最近一次完整备份（包含你在升级期间新建的项目）：
D:\web\dj\integration-work\backups\upgrade-20261106-161805
包含旧程序、数据库、素材、模型桥接配置和存储设置。
补丁替换前的程序另保留于 integration-work\previous-app-20261106-161804。
最初升级前的备份也保留于 integration-work\backups\upgrade-20261106-123510。

风格预设：真人实拍、仙侠风格均已启用；已有项目风格没有被自动更改。

单独设置使用哪张显卡：
打开“设置 → AI 服务”，点击对应图片或视频配置右侧的编辑按钮。
在“使用显卡”中选择：自动分配、GPU1、GPU2 或 GPU3，然后保存。
每条模型配置分别保存，例如图片指定 GPU1、普通视频指定 GPU2、高清视频指定 GPU3。
自动模式按各卡的队列负载分配新任务；指定模式仅提交到选定显卡，维护或不可用时明确报错。
设置对新任务生效，已有任务继续在原显卡查询和下载。显卡编号与服务器编号一致。
当前保持原有默认模型和自动分配方式，未替你固定到某张显卡。

高清制作：
先完成普通“视频制作”，进入新增“高清制作”，选择分镜和 2K / 4K。
VDN-H3 根据原分镜提示词和原视频首帧重新生成；动作和画面细节可能变化。
2K：横屏 2560×1440，竖屏 1440×2560。
4K：横屏 3840×2160，竖屏 2160×3840。
原视频和各次高清结果分别保留。完成后可对比，点击“使用此高清版导出”才会切换。
切换后请在“拼接导出”重新拼接成片。混合分辨率采用最高尺寸；低清镜头仅缩放，不增加真实细节。
实际输出尺寸会经过校验，尺寸不符的结果不能用于高清版本选择。

显卡与数据保留：
Qwen Image 2.1 图片生成与参考图编辑均支持 GPU1、GPU2、GPU3。
批量提交的不同图片可分配到三张卡；每张图片由一张卡完成。
三张卡均已分别指定并实际生成、下载 512×512 图片。
GPU1 和 GPU3 均已分别完成 VDN 实机 2K 成片，实际尺寸 2560×1440，单段约 4 秒各用时约 9 分钟。
VDN 高清服务已按授权连接 zq-platform-network，保留令牌认证，没有开放公网端口。
只有具备 VDN 插件、且处于已准入状态的显卡节点才会接收高清任务。
GPU3 已补装 VDN 插件，历史任务保留；GPU1 新建独立制作节点，也具备 VDN 工作流。
原有 MiniMax、LTX、Wan 等视频模型均通过三张卡的工作流和模型检查。
GPU0 保持原服务。GPU1 原有模型、语音服务保留，新制作节点设置额外预留 8 GiB 显存，不开放主机端口。
两个原有项目按你的要求保持删除状态，记录与素材保留；新建项目继续使用当前数据。
4K 高分辨率采样较慢，请等待任务完成，不必重复提交。高清轮询窗口已延长至 3 小时。

实际验证结果（2026-11-06）：
2K 实机成片为 2560×1440；4K 实机成片为 3840×2160，均为 24 帧/秒。
约 4 秒的验证视频分别用时约 9 分钟、35 分钟，实际耗时取决于时长、分辨率及排队情况。
已验证原版文件保持不变、切换/恢复导出版本、拒绝不达标尺寸、混合分辨率拼接保留 4K。
本次重启前后核对：10 条模型配置、10 个风格、3 条项目记录（1 个正常显示，2 个按要求保留删除状态）、77 个分镜和 65 个素材文件内容一致。
确认取消的任务已同步为取消状态，不删除已完成素材；原有模型密钥、地址、优先级和默认设置保留。
验证记录：integration-work\gpu-selection-smoke.json、gpu-settings-ui-result.json、gpu-dispatch-test.json、three-gpu-all-workflows.json。

维护源码：D:\web\dj\huobao-source，基于官方 v4.0.11。
构建/备份工具：D:\web\dj\model-bridge。
后续更新请先备份，将新版源码与本地高清功能合并、测试后再替换程序。
不要直接用旧版 patch_desktop_video.py 覆盖新版；该脚本已有版本保护。
不要使用旧数据备份直接覆盖正在使用的数据目录，以免覆盖后续创建的内容。
