第十二章  常见问题与解决方法

问题一：Whisper 提示找不到引擎

确认依赖目录中存在 CPU、GPU-a、GPU-n 和 models。至少需要一个运行目录内含 whisper-cli.exe，并且 models 中有可用模型。打开“偏好设置 > 依赖管理”重新下载或修复，或检查是否把依赖目录改到了其他磁盘。

问题二：AMD 显卡转录报 Vulkan、架构或驱动错误

Whisper 的 AMD 后端位于 data\GPU-a。Voxly 会使用保守参数并禁用部分不兼容优化，但显卡驱动和 Vulkan 能力仍可能不同。先更新 AMD 驱动，尝试 Medium 或 Large V3 Turbo；仍失败时关闭 GPU，改用 CPU。Qwen Windows 运行时不支持 AMD GPU；稳定优先可使用 SenseVoice 或 FireRedASR2 的 CPU 推理。

问题三：Qwen 提示组件未安装或模型加载失败

打开“依赖管理”选择 Qwen3-ASR 并重新下载。确认依赖目录有足够空间，下载过程中不要移动目录。NVIDIA 模式还需要可用显卡驱动，但不要求单独安装 CUDA Toolkit。显存不足时缩短 Qwen 分段时长，或改用 CPU。

升级到 2.9.2 后若提示旧版 Qwen 已清理，这是正常迁移。程序只删除旧 Qwen 模型、缓存和相关 Python 包，不删除 Whisper、FFmpeg、基础 Python、任务或用户配置；按提示重新下载 Qwen3-ASR 即可。

问题四：为什么右键转录会出现命令行

这是当前设计。单文件、文件夹和文件夹空白处右键都会打开标题为“Voxly”的命令行，让你确认引擎、设备、格式、输出目录、语言和 AI 校对。直接连续回车即可使用默认值。

问题五：右键转录没有找到文件

文件夹模式只扫描当前文件夹，不递归子文件夹。支持的扩展名为 MP3、WAV、FLAC、M4A、AAC、WMA、OGG、MP4、MOV、AVI、MKV 和 WMV。确认文件扩展名和访问权限正确。

问题六：GPU 失败后是否会回退 CPU

资源管理器右键转录在启用“GPU 优先”时会自动回退 CPU。主窗口 Qwen 遇到 CUDA 不可用或显存不足时会询问是否改用 CPU。主窗口 Whisper 在匹配的 GPU 引擎缺失时会回退 CPU；运行中发生驱动或硬件错误时，可关闭 GPU 后重试。

问题七：转录速度慢或资源占用高

CPU 转录速度取决于模型和音频长度。Whisper 可在 Large V3 Turbo 与 Medium 之间选择、减少线程或关闭高开销解码参数；Qwen 可缩短分段时长、改用 CPU 或关闭其他占用显存的软件。纯 CPU、低配置或长时间批量任务建议优先 SenseVoice；中文、方言和会议建议 FireRedASR2。

问题八：为什么转录时没有等待音效

这是预期行为。普通转录不循环播放等待音效，避免长任务持续干扰；只有下载模型或依赖时播放等待音效。任务开始、完成、取消和错误仍可播放相应提示音。

问题九：AI 校对或翻译提示 Key、URL 或模型错误

在“高级设置 > AI 服务”确认接口类型。DeepSeek 使用官方接口；其他服务选择 OpenAI 兼容接口，再选择 OpenRouter 预设或自定义，填写正确 URL、模型和 Key。翻译窗口也要保存并启用对应服务。查询余额并不适用于所有自定义兼容接口。

问题十：转录结果错误较多

明确指定语言；Whisper 优先尝试 Large V3 Turbo，Qwen 可添加人名和术语上下文；中文或方言素材也可比较 FireRedASR2。开启 VAD 和幻觉过滤时要根据素材测试。完成后可用知识库和 AI 校对修正专有名词与同音错字。

问题十一：输出文件保存在哪里

主窗口使用“通用设置”的输出目录；留空时为程序目录下 output。右键转录默认保存到原媒体所在文件夹，也可在命令行或“命令行转录”设置中更改。

问题十二：配置或任务在哪里

用户配置和任务默认位于 %AppData%\Voxly\data。依赖目录默认是程序目录下 data，也可迁移；迁移位置记录在 %AppData%\Voxly\dependency-directory.txt。

问题十三：视频合成器无法预览或导出

确认完整包中存在 VideoSubtitleSynth.exe、libvlc 目录，以及 data 下的 ffmpeg.exe 和 ffprobe.exe。预览失败先检查 libVLC；导出失败查看 FFmpeg 错误并尝试 CPU 编码。自定义字体必须是有效的 TTF 或 OTF 文件。

问题十四：发送到 REAPER 失败

在“偏好设置 > REAPER 插件”重新确认资源目录并安装，重启 REAPER。便携版需要手动选择含 reaper.ini 或 reaper.exe 的目录。

问题十五：实时转录首次使用为什么需要等待

前台会议转录和后台按住说话使用 FireRedASR2。首次安装模型后，Voxly 启动时会在后台预加载，并在状态区显示加载进度。引擎就绪后会复用同一实例；若模型尚未安装、被安全软件占用或依赖目录变更，首次启动仍可能等待或提示重新下载。

问题十六：后台按住说话没有插入到当前文本框

确认已在“偏好设置 > 实时转录”启用全局按住说话，并且快捷键没有被其他软件占用。按快捷键前先把焦点放到可编辑文本框；管理员权限不同的两个程序之间可能无法模拟输入。隐藏到托盘不会停用快捷键，若托盘图标或热键异常，请重新显示 Voxly，检查调试日志中的热键注册错误。
