企业官网建设流程全解析

Buzz 模型存储位置自定义指南：3 步把 Whisper 模型搬出系统盘

【免费下载链接】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 的本地音频转写与翻译工具，全程离线运行，不上传任何音频。这篇教程带你用 3 步自定义 Buzz 的模型存储位置，把动辄几个 GB 的 Whisper 模型从系统盘挪到空间更大的磁盘，让转写体验既顺畅又省心。

先搞清楚：Buzz 的模型默认藏在哪里

用惯了 Buzz 的人大概率没注意过这件事——你每下载一个模型，都在悄悄消耗系统盘。

Buzz 的模型体积并不小：medium约 1.5 GB，large-v3接近 2.9 GB，Faster Whisper 和 Hugging Face 模型还会更多。默认情况下，这些文件全部落在用户缓存目录下，位置因系统而异：

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

如果你的系统盘只剩几十 GB，再下几个模型就会捉襟见肘。下面的方案就是把模型根目录整体迁移到你指定的位置。

打开偏好设置的 Models 页，先认识模型管理区

迁移之前，先知道 Buzz 在哪里管理模型。

1. 启动 Buzz，点击菜单栏的「Help」（帮助）
2. 选择「Preferences」（偏好设置）
3. 在弹出窗口顶部切换到「Models」（模型）选项卡

Models 页会按「已下载」和「可下载」两组列出当前模型类型的所有规格。选中某个模型后，底部有三个按钮：

• Download：下载选中模型
• Show file location：在文件管理器中打开模型所在文件夹
• Delete：删除已下载的模型

现在就可以点一次「Show file location」，确认你的模型当前落在哪个目录——记住这个路径，后面迁移旧模型要用。

👉 一个小提醒：偏好设置里并没有「浏览选择新目录」的按钮。Buzz 官方提供的自定义方式是环境变量，下一节就讲它。

核心一步：用 BUZZ_MODEL_ROOT 指定新存储位置

Buzz 启动时会读取环境变量BUZZ_MODEL_ROOT，只要它存在，所有模型（包括 Hugging Face 缓存）都会写到这个目录。做法分系统：

macOS / Linux：新建一个启动脚本run_buzz.sh：

#!/bin/bash export BUZZ_MODEL_ROOT=/data/buzz_models buzz

Windows：新建run_buzz.bat：

@echo off set BUZZ_MODEL_ROOT=D:\Buzz\Models "C:\Program Files (x86)\Buzz\Buzz.exe"

然后以后都通过这个脚本启动 Buzz，替代直接双击图标。也可以不写脚本，直接在系统的环境变量设置里新增BUZZ_MODEL_ROOT，效果相同。

两点说明：

1. 目录会自动创建，不需要你提前建好，但请确保该位置可读写
2. 设置了BUZZ_MODEL_ROOT后，HuggingFace 相关的缓存会自动派生到它的上一级目录，通常无需再手动设置其他变量

⚠️ 注意：环境变量只在启动时读取一次。改完脚本或变量后，必须完全退出 Buzz 再重新打开才会生效。

把旧模型搬到新位置，避免重新下载

改完路径后，新目录是空的——已下载的模型不会自动跟着走。手动搬一次即可省下几个 GB 的重复下载：

1. 完全关闭 Buzz（确保环境变量生效后退出）
2. 把旧位置整个models文件夹复制到BUZZ_MODEL_ROOT指向的新目录
3. 重新打开 Buzz，进入 Models 页，确认模型出现在「Downloaded」分组下
4. 确认无误后，删除旧目录里不再需要的模型文件，释放系统盘

⚠️ 注意：请整个文件夹复制，不要只挑单个模型文件。Hugging Face 系模型按「仓库 → snapshots → 文件」的目录结构存放，且每个快照目录里有一个.buzz_complete完成标记文件，缺了它 Buzz 会认为模型没下完；OpenAI Whisper 的.pt模型则会被校验文件大小。结构不完整时，最省事的办法是点「Delete」删掉再重新下载。

搬完之后，随便导一段音频跑一次转写（如上图主界面），能正常出结果就说明一切就绪。

避坑清单与进阶技巧

路径选择：避免中文或特殊符号，选读写权限明确的非系统盘，如D:\Buzz\Models或/data/buzz_models。

下载失败或模型损坏：先点「Delete」删除该模型再重新下载；仍不行的话到「Help → About Buzz → Show logs」查看日志定位原因。

离线/内网部署：项目自带脚本 scripts/download-models.py，可以在一台有网的机器上批量下载所需规格，配合BUZZ_MODEL_ROOT把整个模型缓存目录拷到离线机器使用。

网络慢的地区：可叠加环境变量HF_ENDPOINT指向镜像源加速 Hugging Face 模型下载，详见偏好设置文档中的环境变量列表。

内存吃紧：设置BUZZ_REDUCE_GPU_MEMORY=true可启用 8bit 量化模型，降低显存占用，代价是轻微精度损失。

小结

回到开头的问题：系统盘快满了，怎么办？三步走完——打开 Models 页认准「Show file location」定位旧目录；用BUZZ_MODEL_ROOT环境变量指定新位置；整体迁移models文件夹并重启验证。之后每次下载模型都会自动落盘到你指定的磁盘。

如果你还想进一步榨取性能，可以继续逛逛偏好设置里的 GPU 选项、语言列表和快捷键配置，官方偏好设置文档里还收录了全部高级环境变量，按需取用即可。

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