Buzz 语音转文字 Mac 版装不上3 条路线一次搞定的安装避坑指南【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款能在 Mac 上离线跑语音转文字、还能顺带翻译的工具底层用的是 OpenAI 的 Whisper 模型。不少 Mac 用户卡在装不上、跑不快、Intel 机器直接报错这几步。这份指南按你的实际排障路径走先花 30 秒定位失败原因再挑一条适合自己的路线最后把高频坑一个个绕开。30 秒自检安装到底卡在哪动手装之前先对照下面几点八成问题一眼就能定位芯片是哪一种打开关于本机看芯片写的是 Apple M 系列M1/M2/M3…还是处理器写的是 Intel。这一点直接决定你能装哪个包。系统够新吗较新的 Buzz 已不再支持 Intel Mac最后一个支持 Intel 的版本是 1.4.5。如果你是 Intel 芯片只能去下 1.4.5 及更早的发布包。走的是哪个分发渠道官方发布页的独立安装包、Mac App Store、第三方商店不是同一条代码线。商店版本更新会滞后商店里装到旧功能或干脆装不上多半是这条分支同步慢了。给应用放行没有Mac 默认拦未识别的开发者应用第一次打开被拦属于正常现象不是坏了。图Buzz 语音转文字 Mac 版主界面左侧导入音频文件右侧是转录任务队列与进度状态三条安装路线怎么选路线适合谁上手难度拿到什么官方.dmg发布包绝大多数普通用户低拖进应用程序就能跑按芯片选对应包PyPI 安装pip习惯命令行、装过 ffmpeg中一条pip install跑起来版本跟随 pip源码构建要最新特性、要自己改高拿到 main 分支新功能需 Xcode 命令行工具 Python 环境一句话选型只想用就走第一条想跟最新修复且电脑能装命令行工具走第二条要改代码或尝最新功能才上第三条。路线一官方 .dmg 发布包新手一次装好这条最省心普通用户直接选它。先到关于本机确认芯片类型。打开项目官方发布页按芯片下对应的.dmgApple Silicon 选标记为 Apple Silicon / arm64 的包Intel 选 x64 的包注意 Intel 只能拿到 1.4.5 及更早。双击.dmg把 Buzz 图标拖进应用程序文件夹。第一次打开被拦就属正常——见下一节。被系统拦下怎么办Mac 出于安全会默认阻止未识别来源的应用。被拦之后别直接放弃进入系统设置 → 隐私与安全性。拉到安全性区块点仍要打开再在弹窗里确认允许一次。这一步是放行未签名应用的正规流程做完以后就不会再弹。路线二PyPI 安装命令行党适合习惯用 pip、装过 ffmpeg 的用户版本跟随 pip 走。前置准备 Python 3.13 环境并装好 ffmpeg。pip install buzz-captions python -m buzz第一行装程序本体第二行启动界面。日常升级就是pip install -U buzz-captions。路线三源码构建要最新功能这条路上手成本最高只有要改代码或尝 main 分支新功能才值得。前置装好 Xcode 命令行工具xcode-select --install和合适的 Python 环境。git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz项目用pyproject.toml hatchling 管理构建仓库里还提供了 Makefile 封装好打包步骤如bundle_mac目标。日常尝最新修复更推荐直接用官方产出的最新开发版构建物而不用自己从零编译真要本地编译就按仓库 Makefile 里的目标走装好依赖后产出可执行包。图Buzz 语音转文字偏好设置界面可配置转录后端、模型与 API 等关键参数最容易踩的 3 个坑坑一芯片选错速度掉一截。在 Apple Silicon 机器上硬装 Intel 包或反过来转录速度会明显变慢。判断方法就一条命令uname -m输出arm64就选 Apple Silicon 版输出x86_64就选 Intel 版。坑二没放行直接放弃。第一次打开被 Mac 拦不少人当坏了就删了。正确做法是上面被系统拦下怎么办里的那两步——进隐私与安全性点仍要打开。坑三GPU 加速没效果方向搞反了。Mac 上的GPU 加速和 NVIDIA 的 CUDA 不是一回事别混着配Apple Silicon加速靠系统原生能力选 Whisper.cpp 后端在 Mac 上表现最好无需单独装 CUDA。NVIDIA CUDA只服务于 Windows / Linux 上的 NVIDIA 显卡1.4.6 起需单独安装入口在帮助 → 关于 Buzz里装 CUDA 加速在 Mac 上装它没有意义。系统版本想用 Apple Silicon 的加速能力系统别太旧越新越稳。图Buzz 语音转文字模型偏好设置在这里选 Whisper.cpp 等后端与模型大小跑起来之后看结果与导出转录跑完右侧逐段显示文字支持搜索、播放定位和调速。想存成文件可在转录查看器里导出 TXT、SRT、VTT。图Buzz 语音转文字转录结果页逐段显示文字并可导出字幕文件卡住了去哪求助想报安装/崩溃问题到项目 issue 区提交尽量附上日志。日志位置在帮助 → 关于 Buzz → 显示日志。想交流方案、找同类问题去 Discussions 讨论区Intel 与 Apple Silicon 的兼容问题很多都沉淀在那。想第一时间用上新修复关注发布页的稳定版更新尤其是针对 Apple Silicon 的性能优化版本愿意尝鲜的可以拿最新开发版构建。模型下坏导致崩溃到帮助 → 偏好设置 → 模型删掉损坏的模型文件再重新下载。提示Buzz 需要 CPU 支持 AVX2太老的机器可能直接跑不起来这属于硬件底线不是安装步骤的问题。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考