火宝短剧模型接入（更新于 2026-11-06）

DeepSeek：默认文本模型，模型名 deepseek-chat，官方接口。已完成真实回复测试。
Qwen（Dify）：原有 Dify 应用，通过兼容入口提供文本和流式回复。
OpenAI（Dify）：原有 Dify 应用，通过兼容入口提供文本和流式回复。
Qwen Image 2.1（默认图片·三卡可选）：服务器本地图片工作流，支持文生图及最多六张参考图编辑。
已通过火宝实际生成 512×512 图片，并用该图完成改色编辑，PNG 下载及保存均验证通过。
MiniMax H3（默认视频·三卡可选）：支持文生视频、单张首帧和最多九张参考图。
MiniMax H3 加速版：Hybrid 支持文生视频/图生视频；R2V-4Step 需要 1-9 张参考图，不支持固定首帧模式。
LTX 2.3：文生视频或单张图生视频；Text-Preserve 版本用于保留画面中的文字。
Wan 2.2：单张图生视频，必须提供一张图片。
以上共 6 个视频模型选项，可在设置 → AI 服务 → 视频中点击模型设为默认，也可在生成时选择。
Grok（本机）：使用本机 Grok CLI，通过 127.0.0.1:18793 接入；未登录时在火宝中停用。

Grok 登录：双击同目录 Grok登录.cmd，按浏览器提示登录。
登录后脚本会实际验证回复，再自动启用火宝中的 Grok；DeepSeek 保持默认。
如果已经通过其他方式登录，运行 activate_grok.py 即可验证并启用。

远端兼容服务：http://192.168.110.111:18792
容器：huobao-model-bridge，配置及代码位于 /home/ps/huobao-model-bridge。
容器自动重启策略：unless-stopped。只绑定服务器内网地址。
本机 Grok 兼容服务通过当前用户的启动文件夹自动启动，后台运行。
关闭火宝后，双击桌面「火宝短剧-一键启动」打开。
脚本位置：D:\web\dj\一键启动火宝.cmd。
一键启动先检查原数据库和模型配置，再保存数据库备份；数据缺失或为空时会停止并显示提示。
数据库备份位于 D:\web\dj\huobao-data\backups；备份包含项目记录和模型配置，不复制图片、视频文件。
重复运行会切回已打开的火宝窗口。Grok 已启用时，也会检查并启动本机 Grok 兼容服务。
运行记录位于 D:\web\dj\huobao-data\last-launch.json。

固定数据目录（2026-11-06 修复）：
D:\web\dj\huobao-data 保存数据库、模型配置、项目及生成素材。
AppData\Roaming\HuobaoDrama 仅保留桌面缓存、启动日志和存储目录指针。
程序默认也指向上述 D 盘目录，即使存储指针文件缺失，也不会改为打开空的 AppData 数据库。
本次从 2026-11-06 09:53 的数据库快照恢复「洪荒」项目，补齐多视频模型配置；13 张原图从服务器原任务取回。
原视频任务继续查询，其中任务 14 已完成并取回视频，任务 23 沿用原任务编号查询。
已实际关闭重开，并临时移开存储指针验证：9 条配置、1 个项目、2 集、27 个分镜保留，已完成素材无缺失。
恢复后的完整配置数据库备份：integration-work\backups\huobao-restored-full-20261106.sqlite3。
验证结果：persistence-after-restart.json；原图恢复清单：data-recovery-20261106.json。

边界：
1. Dify 保留原应用的系统提示词和工作流；兼容入口只接受文本消息，不提供工具调用和附件上传。
2. H3 不支持末帧约束、参考视频、外部音色样本，或同时指定固定首帧和其他参考图；会明确报错。
3. 本次多模型更新通过 21 项兼容服务测试、桌面适配测试、6 模型接口预检，以及两个 GPU 节点的 9 个工作流节点/模型检查。没有额外提交测试视频；原有生成任务继续查询。
4. H3 的图片参考由火宝转换为内嵌图片数据。网络图片需先下载并导入火宝。
5. Qwen（Dify）/ OpenAI（Dify）是文本应用；图片功能使用独立的 Qwen Image 2.1 配置。
6. 当前服务器 Qwen 图片工作流按约一百万像素、32 像素对齐限制实际输出尺寸；较大尺寸请求会在上游按比例缩放。

密钥不写入本说明；client.json 与 grok-client.json 是受权限保护的本机接入配置，不要公开分享。
修改前的火宝数据库备份位于 D:\web\dj\integration-work\backups。

多显卡调度（2026-11-06）：
当前 GPU1、GPU2、GPU3 共同接收 Qwen 图片及原有六种视频模型任务，按队列长度和提交预约数自动选择节点。
同一时间提交的不同任务可以分到不同 GPU；每条视频仍由一张 GPU 执行。
任务 ID 保留原执行节点，轮询和下载始终回到该节点；节点暂不可达时不重复提交已有任务。
GPU0 保持原服务。GPU1 新增独立 huobao-comfy-gpu1 节点，原有服务继续运行，设置 8 GiB 额外显存预留。
在“设置 → AI 服务 → 编辑 → 使用显卡”中，按模型选择自动、GPU1、GPU2 或 GPU3。
指定模式不自动换卡；维护、无响应或缺少 VDN 时明确拒绝提交，保留原任务和结果。
实际检查结果见 video-pool-preflight-20261106.json；接口预检见 video-integration-20261106.json。

当前桌面兼容扩展（4.0.11）：
基于官方 4.0.11 源码构建，保留 localvideo 多模型适配器和固定数据目录，新增高清制作页面。
MiniMax H3-VDN-H3 在独立兼容服务 192.168.110.111:18794 运行，支持按原分镜和首帧重生成 2K/4K。
原版与高清版本分别保留，选择版本后才用于重新拼接。GPU1/GPU2/GPU3 均具备 VDN 工作流。
Qwen 图片显卡池状态接口为 /v1/images/pool，需要原桥接令牌；同一任务的查询和下载回到原执行节点。
请求可选 gpu=auto/gpu1/gpu2/gpu3；调度器通过 strict_provider 区分固定 GPU2 与旧的 default 自动调度。
服务器本次配置、容器定义和历史备份位于 /home/ps/huobao-gpu-selection，目录受权限保护。
GPU1 令牌仅原调度服务用户获得读取权限，没有开放所有用户读取；新节点仅加入 zq-platform-network。
原 4.0.10 文件保存在 integration-work\backups\multivideo-4.0.10；patch_desktop_video.py 不可用于 4.0.11。
后续更新需备份当前数据，将本地功能与新版源码合并测试后构建；不要直接覆盖当前数据目录。
远端兼容服务代码的更新前备份为 /home/ps/huobao-model-bridge/bridge.py.before-multivideo-20261106。
