Buzz 音频转录故障排查完整指南转录失败、模型下载中断、录音无声一次解决【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款基于 OpenAI Whisper 的离线音频转录与翻译工具音频文件与实时录音都能在本地电脑完成语音转文字。本文覆盖 Buzz 音频转录中最高频的几类故障——Buzz 模型下载失败、GPU 加载报错、长音频卡死、Buzz 无法录音——每个问题给出现象判断与分步修复方法帮你快速定位原因。模型准备问题下载失败与 GPU 报错提示模型文件不存在或 Buzz 模型下载失败典型现象启动转录时报FileNotFoundError: ... ggml-tiny.bin或下载进度停在 99% 后失败。打开偏好设置菜单栏或Ctrl/Cmd ,→Models确认对应模型的下载状态。删除未下载完整的模型文件再重新下载——残留的损坏文件是最常见的崩溃诱因。确认模型目录存在且可写各系统默认位置如下系统模型存储位置Linux~/.cache/Buzz/modelsmacOS~/Library/Caches/BuzzWindows%USERPROFILE%\AppData\Local\Buzz\Buzz\Cache离线机器可在另一台联网电脑下载好模型把整个models文件夹复制到相同位置再使用。避坑提示模型缓存在用户目录下如果换系统账户运行 Buzz模型需要重新准备。出现 CUDA 错误、显存不足模型加载失败典型现象CUDA error: invalid device function或加载大型模型时直接崩溃多见于老款 NVIDIA 显卡或 CUDA 版本低于 12 的环境。Windows 官方安装包自带 GPU 支持但需要CUDA 12旧版本会自动回退到 CPU 转录先确认转录本身能跑通。Linux 下核对 NVIDIA 驱动、CUDA 12、cuBLAS、cuDNN 是否齐全。想彻底绕开 GPU 时设置环境变量BUZZ_FORCE_CPUtrueLinux/macOS 在终端执行export BUZZ_FORCE_CPUtrueWindows 执行set BUZZ_FORCE_CPUtrue也可以在偏好设置的禁用 GPU选项中直接勾选。显存紧张时设置BUZZ_REDUCE_GPU_MEMORYtrue改用 8bit 量化模型或换用更小的模型尺寸、Whisper.cpp 引擎。避坑提示CPU 模式速度更慢但更稳定先保证能用再考虑提速。音频文件类问题导入异常与长音频转录导入音频后卡住或提示格式无法解析典型现象导入.m4a、.flac等文件后任务无进展或解析报错。检查 FFmpeg 是否已安装Buzz 依赖它做解码Ubuntu/Debian 执行sudo apt install ffmpegmacOS 执行brew install ffmpeg。用系统自带播放器确认该音频能正常播放排除文件损坏。把文件路径中的中文、空格和特殊符号去掉改用简单的英文路径。用 FFmpeg 把音频转成 WAV 或 MP3 后重新导入试试。处理长音频1 小时以上时卡死或内存溢出典型现象进度条长时间不动最终程序无响应。在任务设置里换用更小的模型tiny / base / small或 Whisper.cpp 引擎明显降低内存占用。用 FFmpeg 把音频切成短段再逐个导入ffmpeg -i input.mp3 -f segment -segment_time 3600 output_%03d.mp3。关闭其他高内存占用的程序后重试。使用 GPU 时观察显存占用必要时启用BUZZ_REDUCE_GPU_MEMORYtrue。避坑提示分段转录的结果是多个独立文件导出前确认每一段都已处理完成。录音类问题Buzz 无法录音或录到无声设备列表为空或报 PaErrorCode-9999典型现象录音页下拉框里找不到麦克风或一点录音就提示Unanticipated host error [PaErrorCode-9999]。先用系统自带录音工具测试麦克风能否收音确认硬件正常。Windows 进入设置 → 隐私 → 麦克风允许桌面应用访问麦克风。临时禁用杀毒软件部分安全软件会拦截 Buzz 对音频设备的访问。Linux 下把当前用户加入 audio 组sudo usermod -aG audio $USER注销后重新登录。重启 Buzz让设备列表重新枚举。想转录系统声音却只录到麦克风典型现象录下来的只有环境音没有想采集的应用声音。安装虚拟音频设备macOS 用 BlackHoleWindows 用 VB CABLELinux 用 PulseAudio 的回路设备。把目标应用的音频输出指到该虚拟设备。在 Buzz 录音源下拉框中选择这个虚拟设备再开始录音。避坑提示忘记把录音源切到虚拟设备时默认采集的仍是物理麦克风。进阶排查日志、环境变量与崩溃定位程序崩溃或行为异常先读日志打开帮助 → 关于 Buzz点击Show logs跳转到日志目录。打开最近的日志文件搜索ERROR和Exception两个关键字。确认崩溃是否发生在模型下载阶段若是则回到删除并重新下载模型的步骤。核对 CPU 是否支持 AVX2非常老的电脑无法运行 Buzz。问题复现且无法解决时把日志文件附上再反馈给项目维护者。用环境变量自定义模型路径与运行行为系统盘空间不足时设置BUZZ_MODEL_ROOT指定模型根目录Linux/macOS 执行export BUZZ_MODEL_ROOT/mnt/external_drive/buzz_modelsWindows 执行set BUZZ_MODEL_ROOTD:\buzz_models。建议同时把HF_HOME指向同一目录部分库会独立下载模型文件。BUZZ_FORCE_CPUtrue、BUZZ_REDUCE_GPU_MEMORYtrue等变量按需在启动前设置用法见前文对应小节。macOS/Linux 可把上述变量写进一个run_buzz.sh启动脚本每次通过脚本启动 Buzz。避坑提示更换模型根目录后原目录里的模型不会自动迁移需手动复制或重新下载。上手指引导入文件前先确认FFmpeg 已安装且文件路径是纯英文模型下载失败时先删除旧文件再重新下载不要反复重试GPU 环境不稳定时用BUZZ_FORCE_CPUtrue切到 CPU 保证可用录音前先用系统工具验证麦克风再检查系统麦克风权限遇到崩溃从帮助 → 关于 Buzz → Show logs查日志是最短路径【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
