企业官网建设流程全解析

手把手指南：Buzz 的 Whisper 模型下载卡在 99%？换手动摆放就通

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

打开 Buzz 下载 Whisper 模型（OpenAI 的语音转文字模型），进度条在 37% 停了半小时，或者一上来就弹"网络连接超时"。原因不复杂：模型文件托管在海外平台，体积 1GB 到 10GB，跨国链路又不稳。不用硬扛网络，把文件放进本地模型目录，离线转录就能跑起来。

Buzz 去哪里找模型

Buzz 默认把模型放在系统缓存目录下的models子文件夹：

• Windows：C:\Users\用户名\AppData\Local\Buzz\models
• macOS：~/Library/Caches/Buzz/models
• Linux：~/.cache/Buzz/models

也可以用环境变量BUZZ_MODEL_ROOT覆盖这个路径，方便把模型挪到空间更大的磁盘。

手动摆放 Whisper 模型

这是多数场景下能直接走通的做法：在网络好的机器上把模型下载下来，再拷贝过来。

克隆仓库并安装依赖：

git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz pip install .

先想清楚要哪一档模型：tiny最快但精度低，small、medium均衡，large-v3精度最高但最慢。然后从镜像站点拿到对应文件——Whisper.cpp 用的是ggml-model-whisper-*.bin文件，其余转录引擎的模型来自 Hugging Face。

把文件拖入上面的models目录。启动 Buzz，进入"偏好设置 → 模型"：Whisper.cpp 的自定义模型可以直接指向你放好的.bin文件，也可以把界面里的下载链接填成一个可达的镜像地址，Buzz 会自动去拉取。

如果模型走 Hugging Face 通道，再加一个HF_ENDPOINT环境变量指向国内镜像，相当于给整个下载库换源。

备选：配一个代理

手上已有稳定代理的话，不用手动搬文件。启动前设置环境变量：

export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 python main.py

Windows 的 PowerShell 里改成$env:HTTP_PROXY="http://127.0.0.1:7890"再启动即可。下载全程走代理，其他设置不用动。

备选：克隆完整镜像仓库

代码和配套资源想一次拿全，直接克隆镜像仓库：

git clone https://gitcode.com/GitHub_Trending/buz/buzz

克隆完成后运行 Buzz，能复用的本地文件不会再从国外服务器拉取，适合不想折腾路径配置的人。

验证成功，顺手处理常见失败

成功标志：在"偏好设置 → 模型"里能看到目标模型并选中；拖入音频转录，查看器能输出带时间戳的文本。

排查清单（现象 → 处理）：

• 反复"网络连接超时"：跨国链路瓶颈，改走手动摆放或镜像仓库路线。
• SHA256 校验失败：文件传了一半不完整，删除后重新拷贝；Buzz 对 ggml 模型下载后会自动校验。
• 模型选不到：确认文件在models目录里、文件名符合规则（whisper.cpp 为ggml-model-whisper-*.bin）。
• 同一个模型被反复下载：用BUZZ_MODEL_ROOT固定模型路径，避免缓存目录漂移。

几条顺手优化 ⚙️

• 实时录音转录用tiny/small，离线精转再用large，按场景分档。
• 有 NVIDIA 显卡就开 CUDA 加速；Apple Silicon 用对应加速选项。
• 用文件夹监控自动转录新放入的音频，不用逐个导入。
• 批量自动化直接用 CLI，省去界面操作。

参考资料

• docs/docs/installation.md — 官方安装说明，覆盖各平台与 PyPI、Flatpak、Snap 的安装方式。
• buzz/model_loader.py — 模型下载、路径解析与完整性校验的实现。
• buzz/transcriber/ — 各转录引擎（Whisper、Whisper.cpp、本地服务等）的实现。
• buzz/widgets/preferences_dialog/models_preferences_widget.py — 模型设置界面源码，排查界面行为时有用。

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