企业官网建设流程全解析

告别数小时等待：Buzz 离线转录模型下载提速的三条路径

【免费下载链接】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 在本地把语音转成文字。但模型动辄上 GB，默认从海外仓库下载时常卡在百 KB/s 级。这篇指南把 Buzz 模型下载速度拉到 MB/s 级，覆盖国内镜像、企业内网离线部署、代理转发三种场景。

先诊断：你的下载卡在哪一步？ 🔍

点完"下载模型"没动静，多数不是 Buzz 的锅，是网络到不了模型源。先分清是打不开、还是慢、还是下完报错。打开 Preferences → Models，看"Available for Download"里还缺哪些，再对号入座。

按场景走，从慢到快

同样是 Buzz 模型下载，按网络选路：国内直连走镜像，内网走离线导入，有代理就转发。

场景A：国内网络直连镜像（适合绝大多数用户）

Whisper.cpp、Faster Whisper、Hugging Face 这三个后端都通过huggingface_hub拉文件，所以只要把它的请求源指到国内镜像，一行变量搞定，不用改任何代码。

1. 换源：设一个环境变量，把 HF 请求指到镜像。

   export HF_ENDPOINT=https://hf-mirror.com # Linux / macOS：指定 HF 请求走国内镜像 # Windows PowerShell $env:HF_ENDPOINT="https://hf-mirror.com"

2. 重启 Buzz 下载：Preferences → Models，选 Whisper.cpp 或 Faster Whisper 后端，点 Download。
3. 只想要单个文件：选 Whisper.cpp → Custom，在"Download link to Whisper.cpp ggml model file"输入框里贴该 ggml 文件的直链，再 Download。

改完重启即可，速度通常从百 KB/s 跳到 MB/s 级。注意：经典 Whisper 后端走的是固定 CDN 地址，镜像不覆盖它，用镜像时优先选 Whisper.cpp / Faster Whisper。

场景B：完全离线导入（适合企业内网/断网环境）

内网或断网机器连不了外网，最稳的思路是"有网机器下好，整包拷过去"。Buzz 支持把整个模型目录指到任意位置，所以可以先把 Buzz 模型下载缓存搬到内网。

1. 固定目录再下载：先设好BUZZ_MODEL_ROOT，让界面里 Download 的模型都落进同一个地方。

   export BUZZ_MODEL_ROOT=/mnt/buzz-models # Linux / macOS：模型统一存到这里 # Windows PowerShell $env:BUZZ_MODEL_ROOT="D:\buzz-models"

   然后打开 Buzz → Preferences → Models → Download，下完你需要的尺寸。

2. 整包拷走：把BUZZ_MODEL_ROOT整个目录打包送到内网机器。

   tar czf buzz-models.tgz -C /mnt buzz-models # 打包（Windows 直接压缩 D:\buzz-models 即可）

3. 内网机器指向同一目录：文件在就不触发下载，断网也能转录。

   export BUZZ_MODEL_ROOT=/mnt/buzz-models # Linux / macOS # Windows PowerShell $env:BUZZ_MODEL_ROOT="D:\buzz-models"

内网机器全程不碰外网；Preferences → Models 里对应尺寸会直接出现在"Downloaded"下。想批量脚本化（按后端+尺寸筛选、已存在自动跳过），有本地 checkout 的可跑python scripts/download-models.py。

场景C：已有代理工具时的加速配置（适合已配代理的用户）

已经挂了代理就别折腾镜像了，让请求直接走代理更省事。Buzz 用的requests和huggingface_hub都会读标准代理变量。

1. 设代理：把流量指到你的本地代理端口。

   export HTTPS_PROXY=http://127.0.0.1:7890 # Linux / macOS：走本地代理 export HTTP_PROXY=http://127.0.0.1:7890 # Windows PowerShell $env:HTTPS_PROXY="http://127.0.0.1:7890" $env:HTTP_PROXY="http://127.0.0.1:7890"

2. 处理证书：公司代理报 SSL/证书错时，Buzz 启动时会优先注入系统证书库，一般自动信任代理 CA，通常不用手动导。
3. 重启再下：Preferences → Models 里点 Download，速度取决于你的代理线路，通常比裸连稳。

有代理就最省事，改个环境变量重启即可。

怎么确认提速真的生效了？ 🧪

典型量级（视线路波动）：

先核对文件确实下到位了：

# Linux / macOS：列出模型文件并核对大小 # 预期 tiny≈73MB / base≈139MB / small≈462MB / medium≈1.5GB / large≈2.9GB ls -lhR "$BUZZ_MODEL_ROOT" | grep -E "ggml|\.pt|model.bin" # Windows PowerShell Get-ChildItem -Recurse $env:BUZZ_MODEL_ROOT | Where-Object { $_.Name -match "ggml|\.pt|model.bin" } | Format-Table Name, Length

模型完整性用"症状→检查命令"对照：

• 症状：加载报"SHA256 checksum does not match"或提示文件太小 → 文件没下完整。

  ls -lh "$BUZZ_MODEL_ROOT" | grep ggml-medium # medium 应约 1.5GB，几百 MB 就是坏的

• 症状：进度条走完了，界面却仍显示可下载 → 尺寸或后端没对上，回到 Preferences → Models 确认它落在"Downloaded"下。

踩坑速查 🐛

症状：进度长时间不动，像卡死。原因：镜像/代理变量没生效，或 Windows 并行下载锁竞争。修复：先确认变量指向镜像域名（而非 huggingface.co）。

echo $HF_ENDPOINT # Linux / macOS，应输出镜像域名 echo $env:HF_ENDPOINT # Windows

症状：报"Model path is empty / Check BUZZ_MODEL_ROOT"。原因：离线机器没指向已下载目录。修复：把 Buzz 指到拷过去的模型目录。

export BUZZ_MODEL_ROOT=/mnt/buzz-models # Linux / macOS $env:BUZZ_MODEL_ROOT="D:\buzz-models" # Windows

症状：文件下完了，加载却报 SHA256 不符。原因：残留了半截坏文件。修复：在 Preferences → Models 选中该尺寸点 Delete 清掉，再重新 Download（删的是你本地缓存，不动仓库）。

# 界面操作：选中模型尺寸 → Delete → 再 Download

症状：公司代理下报 SSL/证书错误。原因：代理 CA 未被信任。修复：默认已自动信任系统证书库；确实报错时显式指定 CA。

export REQUESTS_CA_BUNDLE=/path/to/corporate-ca.pem # Linux / macOS $env:REQUESTS_CA_BUNDLE="C:\path\to\corporate-ca.pem" # Windows

延伸阅读

• buzz/model_loader.py：下载、SHA256 校验、断点续传的核心，159–172 行是各尺寸预期大小，600 行是 Whisper.cpp 仓库地址。
• scripts/download-models.py：内网/离线预下载脚本，按后端+尺寸筛选，已存在自动跳过。
• docs/docs/preferences.md：BUZZ_MODEL_ROOT、HF_HOME、BUZZ_REDUCE_GPU_MEMORY 等环境变量说明。

模型下载不再是 Buzz 离线转录的瓶颈。镜像、离线导入、代理三条路，总有一条贴合你的网络；遇到新坑，把报错贴出来一起看。

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