企业官网建设流程全解析

Buzz Mac 安装避坑指南：从芯片选择到 GPU 加速一次讲清

【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz

Buzz 是一款基于 OpenAI Whisper 的本地语音转写工具，可完全离线运行并支持 GPU 加速。Mac 安装时最常见的坑有三个：Intel 与 Apple Silicon 架构选错、首次启动被系统拦截、GPU 加速不生效。本文按安装前自查、安装执行、故障排查的顺序，带你把正确版本装到位。

🔍 安装前自查：先搞清楚你的 Mac 是什么

动手下载之前，花两分钟确认下面两件事，它们决定了后面所有步骤怎么走。

查芯片架构：一条命令的事

Mac 分两种芯片，下载包必须对得上：

• 打开「终端」，运行uname -m：
  • 输出arm64→ Apple Silicon（M1 及以后）
  • 输出x86_64→ Intel
• 关键事实：官方现行版本1.4.6只提供 Apple Silicon 构建，最后一个支持 Intel Mac 的版本是1.4.5。也就是说 Intel 机型在 1.4.5 之后拿不到新特性的官方包；反过来，Apple Silicon 机型装旧版 Intel 包会白白少掉 CoreML 加速等新能力。

动作：现在打开终端执行uname -m，把结果记下来再去找安装包。

系统版本与安装渠道：官方发布页优先

Buzz 在 Mac 上主要有三个安装渠道，更新节奏不一样：

• 官方发布页（.dmg）：与开源仓库同步，修复和新特性先到这里；
• App Store 版本：独立打包、独立上架，版本号和功能经常落后于发布页，官方仓库里的修复可能要等一段时间才会出现在商店；
• PyPI / 源码：面向想要最新特性或自定义环境的用户。

结论：除非你特别依赖 App Store 的分发习惯，否则一律选发布页。

动作：点左上角菜单 >「关于本机」确认 macOS 版本，再到官方发布页按你的芯片架构挑对应构建。

📦 选一条安装路线走到底

路线一：官方预编译包（推荐大多数人）

1. 到官方发布页，Apple Silicon 选 arm64 构建的 .dmg；Intel 用户只能选1.4.5的 x64 构建。
2. 下载后双击打开，把 Buzz 拖进「应用程序」文件夹。
3. 首次启动。如果系统弹出「无法验证开发者」一类的提示，先别慌——自编译或未走完公证流程的包没有签名，macOS 默认拦截，这属于正常现象。

图：Buzz 主界面，左侧是转录任务队列，上方工具栏可添加音频或开始录制

动作：在 Finder 里右键点击 Buzz 图标选「打开」，或在「系统设置 > 隐私与安全性」下拉到底点「仍要打开」。

路线二：源码编译（想要最新特性再走这条）

只有当官方版还没有你要的功能，或你想自己控制运行环境时，才建议走这条路。

前置条件：

• 装好 Xcode 命令行工具：xcode-select --install
• Python 3.13（项目pyproject.toml要求>=3.13,<3.14）
• 装好 ffmpeg：brew install ffmpeg

最小命令集：

git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz && python3.13 -m venv .venv && source .venv/bin/activate pip install . && python -m buzz

安装过程中构建系统会一并编译 whisper.cpp 子模块；在 Apple Silicon 上Makefile会自动加上-DWHISPER_COREML=1，让转录后端走 CoreML，无需额外配置。

动作：运行python -m buzz，主窗口能正常弹出即说明源码版安装成功。

🚑 装不上、打不开、加速不了：故障速查

以下每条按「症状—可能原因—动作」列出，对号入座即可。

症状：双击提示「无法打开，因为无法验证开发者」

• 原因：包未签名或未公证，源码编译产物、个别第三方镜像最常见；
• 动作：Finder 中右键「打开」，弹窗里再点一次「打开」；或走「系统设置 > 隐私与安全性」底部的「仍要打开」。

症状：转录明显偏慢，GPU 加速像没开

• 原因：Whisper 类型选错了。Mac 上 Buzz 走Whisper.cpp后端才能真正用上 GPU（实现见buzz/transcriber/whisper_cpp.py），选 Whisper 或 Faster Whisper 实际是在跑 CPU；
• 动作：在偏好设置里把 Whisper 类型改成 Whisper.cpp，选一个 ggml 模型，首次转录时等模型完整下载完成。

症状：速度掉档，长音频要等很久

• 原因：模型太大，或 Intel 机器停在 1.4.5 拿不到后续优化；模型文件下载损坏也会导致异常；
• 动作：换更小的 whisper.cpp 模型；仍不正常就到「Help > Preferences > Models」删除已下载模型重新下载。

图：Buzz 偏好设置，在这里切换 Whisper 类型、管理模型与 API 密钥

📮 装好之后：更新跟踪与反馈渠道

• 查版本：Help > About Buzz 可以看到当前版本号，再到官方发布页对比是否有更新；想尝鲜最新开发版，看项目文档 FAQ 中「latest development version」一节的说明；
• 管模型：Mac 上模型缓存在~/Library/Caches/Buzz，可通过「Help > Preferences > Models > Show file location」直接打开目录；
• 提问题：遇到 bug 到项目 issue 跟踪器提交，附上「Help > About Buzz > Show logs」里的日志文件，开发者定位问题会快很多。

动作：装完先打开 Help > About Buzz 记一下版本号，日后排查和升级都以它为基准。

【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz