Buzz 离线语音转文字安装指南3 个渠道对照 3 步装好流程 报错速查【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款在本机离线完成语音转文字和翻译的工具不联网也能跑。新手最常卡在三个坑渠道选错、Windows 拦截弹窗、麦克风没权限。记住先对照渠道表选对安装包装完拿一段短音频验证一遍基本一次到位。先做决定Buzz 安装选哪个版本或渠道Buzz 的安装渠道主要有三条动手之前先对号入座避免下完包才发现跑不起来。版本适合谁去哪拿取舍稳定版Release当前版本 1.4.6日常使用、办公、想省心的人官方发布页Releases按系统选 dmg / exe / tar.gz功能完整、最稳新功能比每日构建晚几周每日构建Daily Build想尝新特性、帮项目挑错的开发者项目 CI 构建列表需登录Linux 可执行sudo snap install buzz --edge修复与新功能最新个别构建可能不稳定PyPI 版写脚本、无界面服务器环境终端执行pip install buzz-captions再用python -m buzz启动能和自动化流程结合Linux 上要先补装系统依赖库一句话建议多数人直接拿稳定版就够想试新特性或帮开发找问题再上每日构建需要批量跑任务时才考虑 PyPI 路线。装前核对清单Buzz 安装前检查这几件事花两分钟过一遍下面 5 条能避开后面八成麻烦。查 CPU 是否支持 AVX2。检查方式Windows 看任务管理器里的处理器型号Mac 点关于本机。含义近十年左右的主流 CPU 都支持如果是更老的机器、不带 AVX2Buzz 无法运行得换电脑或改用在线转录服务。Mac 用户确认芯片。检查方式关于本机里看是 Apple SiliconM 系列还是 Intel。含义Apple Silicon 可以装最新版Intel 芯片官方最后支持到 1.4.5之后的版本需要 Apple 芯片装之前就要接受这一点。留好磁盘空间给模型下载。检查方式确认系统盘还有几 GB 空余。含义首次运行会把 Whisper 模型下到本地缓存——macOS 在~/Library/Caches/BuzzWindows 在%USERPROFILE%\AppData\Local\Buzz\Buzz\CacheLinux 在~/.cache/Buzz模型从几十 MB 到几 GB 不等完全离线的机器先把别的电脑上的模型文件夹拷过来。Windows 用户确认系统版本。检查方式设置里看版本号。含义官方安装包要求 Windows 10 及以上更老的系统只能走 PyPI 路线。有 N 卡的人确认加速方案。检查方式设备管理器里看显卡型号。含义从 1.4.6 起 CUDA 加速不再打包在安装程序里要单独安装没有 N 卡完全不用管Whisper.cpp 在 CPU 上就能跑。按步骤装好 Buzz3 步完成第 1 步按系统下载安装包① 操作Mac 下载.dmgWindows 下载.exeLinux 直接在终端执行 Flatpak 或 Snap 命令命令见 官方安装文档。 ② 预期结果得到一个完整的安装包Linux 的话命令执行完提示安装成功。 ③ ⚠️ Windows 包没有签名安装时系统会弹出蓝色警告页这不是病毒点更多信息再选仍要运行即可。第 2 步安装并启动① 操作Mac 双击 dmg 把 Buzz 拖进应用程序Windows 运行 exe 按提示走Linux 在应用列表里点开 Buzz。 ② 预期结果弹出主窗口顶部是任务列表左上角有麦克风按钮整体长这样③ ⚠️ 首次启动系统可能弹权限请求比如麦克风一律允许否则录音功能用不了。第 3 步选模型跑一次试转录① 操作点添加一段音频文件在任务的 Model 一列选模型。Mac 用户选 Whisper.cpp官方 FAQ 推荐 Mac 用它普通 PC 同样适用显存 6GB 以上的 N 卡可试 Faster Whisper。尺寸先选 tiny 或 small 就够。 ② 预期结果Status 从 Queued 变 In Progress完成后显示 Completed 和用时。 ③ ⚠️ 第一次用会先下载模型等得久一点如果中途崩溃多是模型没下全去 偏好→模型 删掉再重新下载。模型都集中管理在这个界面已下载的列在 Downloaded 分组下装完先验证Buzz 安装后怎么确认能用别急着关掉程序做完下面两件事再放心。转录一段短音频导入一段 1 分钟内的 mp3模型选 Whisper.cpp small任务选 Transcribe。跑完后双击结果能看到带起止时间戳的文字还能导出 TXT、SRT、VTT✅ 文字对得上、时间戳连续说明主流程通了。核对版本和模型缓存Help → About Buzz 里的版本号和你下载的安装包一致偏好→模型 里点显示文件位置缓存目录里确实有模型文件。✅ 两项都对上安装就彻底完成了。常见报错速查Buzz 安装与运行报错对照表报错现象常见原因解决方法Windows 安装时提示Windows 已保护你的电脑安装包未签名被系统安全机制拦下点更多信息选仍要运行属正常现象录音提示 Unanticipated host error[PaErrorCode-9999]系统没给麦克风权限或杀毒软件拦截Windows 到 设置→隐私→麦克风 允许 Buzz临时关杀毒再试转录速度慢模型比硬件大换小一号的模型或改用 Whisper.cpp有 6GB 显存的 N 卡可试 Faster Whisper下载模型后启动崩溃模型文件不完整或损坏在 偏好→模型 删除该模型重新下载仍不行就把日志发到项目 Issue 区N 卡没有 GPU 加速1.4.6 起 CUDA 不再随主包分发Help → About Buzz → Install CUDA Acceleration 单独安装没有 N 卡可忽略Linux 启动提示缺库系统依赖没装全按官方文档用 apt 装好 libportaudio2 等依赖再装 Snap 包日常升级与维护Buzz 版本更新怎么做怎么发现有新版项目发布页按时间倒序列出所有版本Help → About Buzz 能看到你现在装的版本号两边一对就知道落不落后。怎么更新Windows 直接运行新的 .exe 覆盖安装Mac 用新 .dmg 覆盖装旧版都不需要先卸载Linux 的 Snap 执行sudo snap refresh buzzPyPI 路线用pip install -U buzz-captions。想跟最新构建打开项目 CI 构建列表最新一次成功构建排在最上面登录后可下载对应安装包见下图Linux 用户直接sudo snap install buzz --edge切到开发通道。模型缓存维护模型都放在前面清单里列出的缓存目录删掉对应文件会自动重新下载要搭一台完全离线的机器可以先用 离线模型准备脚本 在有网电脑上备好模型再拷过去。写在最后选对渠道、装前核对、装完验证这套流程走完Buzz 的离线语音转文字基本不会再卡你。更多细节看 中文安装文档 和 常见问题 FAQ还解决不了就去项目仓库的 Issue 反馈区提问附上 Help → About 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），仅供参考