闪搭数字人 V2.3 安装与升级说明
版本：V2.3
适用系统：Windows 10 / 11 64 位

一、先分清三个下载内容

1. 闪搭数字人 V2.3 主程序
   - 主程序安装文件夹约 152MB。
   - 负责安装软件、FFmpeg、FFprobe 和模型兼容适配器。
   - 不包含 Python 运行环境，也不包含模型权重。

2. 闪搭数字人五模型完整运行环境 V1.0
   - 下载约 7.11GB，完整安装后约需 22GB。
   - 包含两套完整 Python 本体，以及 MuseTalk 1.5、LatentSync 1.5、IndexTTS2.5 的完整独立依赖层。
   - 首次安装一次即可；以后只升级主程序时不需要重复安装。

3. 五个独立模型包
   - Qwen3-TTS 闪搭全能版、IndexTTS2.5、FunASR、MuseTalk 1.5、LatentSync 1.5。
   - 每个模型一个完整压缩包，按实际用途下载，不要混放。

二、新电脑首次安装

1. 下载“闪搭数字人-五模型完整运行环境-V1.0-安装文件夹”。
2. 保持环境安装程序与 dependencies 文件夹位于同一目录，不要只复制 EXE，也不要在压缩包内直接运行。
3. 双击“闪搭数字人-五模型完整运行环境-V1.0-安装程序.exe”，选择空间充足的磁盘完成安装。
4. 下载“闪搭数字人-V2.3-正式安装文件夹”，双击“闪搭数字人-V2.3-安装包-x64.exe”安装主程序。
5. 打开软件。每台电脑可联网领取一次 24 小时免卡试用；正式使用时输入卡密，首次激活自动绑定当前电脑。
6. 按任务下载模型，并完整解压到空间充足、路径稳定的磁盘目录。
7. 进入“AI模型 → 本地模型”，点击添加本地模型，在已解压模型的根目录中选择 config.json。
   不要只选择文件夹，也不要选择权重子目录里的其他 JSON 文件。
8. 刷新模型状态。绿灯表示模型服务可用；红灯表示尚未启动或配置失败。
9. 先做一次 5—10 秒短任务，确认声音、显存、输出目录和结果正常后，再运行长文本或长视频。

三、从 V2.2 或更早版本升级

1. 退出闪搭数字人，并停止所有仍在运行的模型服务。
2. 先安装一次“五模型完整运行环境 V1.0”。这是重新整理后的正式完整环境，旧版内置或裁剪环境不再作为交付依据。
3. 双击“闪搭数字人-V2.3-安装包-x64.exe”覆盖安装主程序。
4. 原有五个模型权重不用重新下载，也不要移动或改名。
5. 打开“AI模型 → 本地模型”并刷新状态。
6. 首次启动 MuseTalk 和 LatentSync 时，V2.3 会自动更新旧的 aigcpanelrun.py 和 aigcpanelserver.py，移除开发电脑绝对路径。
7. 分别完成一次语音合成、音色合成或数字人口型短测。

四、V2.3 修复与交付变化

- MuseTalk 1.5 和 LatentSync 1.5 不再读取写死的 D:\AIGC\model\_shinedap-shared 路径，可放在任意盘符和普通目录。
- LatentSync 使用主程序动态提供的 FFmpeg / FFprobe。
- 主程序不会再执行或导入模型包里的旧虚拟环境。
- 主程序与完整运行环境分开交付，后续升级软件不再重复搬运数 GB 的 Python 依赖。
- CosyVoice3 已从正式推荐和下载资源中移除。

五、模型选择

- Qwen3-TTS 闪搭全能版：从零音色设计、内置音色、声音克隆、语音指令、长文配音和入库音色复用。
- IndexTTS2.5 闪搭调优版：高情感、角色化对白和更有表演感的旁白。
- FunASR：音频/视频语音转文字、字幕与脚本回收。
- MuseTalk 1.5：优先用于多数真人数字人口播，兼顾速度与自然度。
- LatentSync 1.5：近景质量优先，通常比 MuseTalk 更慢、显存要求更高。

六、常见故障

1. 模型显示红灯
   - 确认完整运行环境 V1.0 已经安装。
   - 确认模型压缩包已完整解压。
   - 确认模型目录没有被移动、改名或重复嵌套一层文件夹。
   - 删除软件中的失效配置，重新选择实际模型根目录中的 config.json。
   - 刷新模型状态，再查看模型卡片日志。

2. 日志出现 No Python at ...
   - 使用完整的“五模型完整运行环境 V1.0”安装文件夹重新安装环境。
   - 确认环境安装程序与 dependencies 文件夹同级。
   - 再覆盖安装 V2.3 主程序，并重新添加失效模型配置。

3. 出现 Unknown model service error
   - 先看对应模型的日志，不要只看任务卡片提示。
   - 检查模型是否为绿灯、显存是否充足、模型目录是否完整。
   - 重启该模型服务后再做短任务。

4. 安装进度看起来不动
   - 完整环境解压约 22GB，安装期间进度可能暂时停留。
   - 观察任务管理器中的磁盘活动；仍有读写时继续等待。
   - 不要同时启动多个安装程序，不要在安装过程中删除临时文件。

5. 移动模型后无法使用
   - 先在软件中删除原模型配置，再从新位置重新添加。
   - 不要直接修改配置文件中的旧绝对路径。

七、不要误删

- 不要删除已安装的五模型完整运行环境。
- 不要删除正在使用的模型权重。
- 不要删除自己生成并已入库的音色、参考音频和成片。
- 清理旧模型前，必须先确认新模型显示绿灯并完成短测。

推荐顺序：
退出软件和模型服务 → 安装完整运行环境 V1.0 → 覆盖安装 V2.3 → 刷新现有模型至绿灯 → 测试常用工作流。