音述AI本地分离人声失败的三大原因及解决方法：一是模型文件缺失或命名错误，需确认./models/下存在正确命名的.onnx文件；二是GPU加速异常，可禁用CUDA或安装匹配的CUDA 12.1；三是缓存与权限问题，需清理Temp中vocal_开头文件夹、以管理员身份运行并关闭占用音频的其他程序。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用音述AI本地分离人声时突然弹出“模型加载失败”或“CUDA初始化错误”，音频文件明明已拖入界面却卡在“正在准备模型”不动——这不是你电脑不行，而是模型路径、GPU驱动或临时缓存出了具体问题，按顺序排查就能立刻恢复运行。
检查模型文件是否完整且位置正确
音述AI启动时会自动从 【./models/】 目录下加载分离模型（如 2stems.onnx 或 4stems.onnx），若该文件夹为空、被误删，或模型文件名被手动修改过（比如加了空格或中文括号），程序就会静默报错，不提示具体原因。
打开音述AI所在根目录 → 进入 models 文件夹 → 确认里面至少存在一个 .onnx 后缀的模型文件（常见为 2stems.onnx）→ 若缺失，从官网下载页重新获取对应版本的 models.zip，解压后**覆盖粘贴**进 models 文件夹，不要新建子文件夹。
注意：Windows 资源管理器默认隐藏已知文件扩展名，务必在“查看”选项卡中勾选“文件扩展名”，否则可能误把 2stems.onnx.txt 当成 2stems.onnx。
GPU加速失效导致卡死或报错
方法一：强制禁用 GPU，切回 CPU 模式运行
右键桌面 → “NVIDIA 控制面板” → “管理 3D 设置” → “程序设置” → 找到 start.exe 或音述AI主程序 → 将“首选图形处理器”改为“集成图形” → 点应用。重启音述AI，此时会跳过 CUDA 初始化，直接走 CPU 推理，速度慢但稳定。
方法二：验证 CUDA 环境是否真就绪
不是装了显卡驱动就等于能跑 CUDA——必须安装匹配的 CUDA Toolkit（音述AI v2.3+ 要求 CUDA 12.1）。打开命令提示符，输入 nvcc -V，若提示“不是内部或外部命令”，说明 CUDA 未安装或未加入系统 PATH；此时不要强行点“立即分离”，先去 NVIDIA 官网下载 CUDA 12.1 Installer（exe 版本），勾选“CUDA Driver”和“CUDA Toolkit”，全程默认安装即可。
清理临时缓存与权限冲突
第一步：关闭音述AI，按下 Win+R 输入 %localappdata%\Temp → 回车 → 删除所有以 【vocal_】 开头的文件夹（如 vocal_cache_abc123）。
第二步：右键 start.exe → “以管理员身份运行” → 首次启动时若弹出 Windows SmartScreen 提示，点“更多信息” → “仍要运行”。这步不可跳过，否则某些 Windows 10/11 系统会拦截模型文件的内存映射操作，导致加载超时假死。
第三步：检查目标音频文件是否被其他程序占用。例如文件正被 Windows 媒体播放器预加载、或被微信/QQ 的语音转文字后台扫描——关掉这些进程再试。
