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、在你自己电脑上完全离线运行的语音转写与翻译工具，支持 Whisper、Whisper.cpp、Faster Whisper 等多种模型。每下载一个识别模型，默认都会落在系统盘的缓存目录里，攒上几个大体积型号，C 盘空间很快告急。下面按"查位置 → 换目录 → 迁移旧模型 → 验证"四个小任务走一遍，帮你把 Buzz 模型存储位置搬到空间充裕的数据盘。
任务一：先弄清模型文件现在放在哪
Buzz 把已下载的模型统一收在一个"模型根目录"下。没有手动指定时，它使用操作系统的用户缓存目录并附加models子文件夹：
- Windows：
C:\Users\<用户名>\AppData\Local\Buzz\Cache\models - macOS：
~/Library/Caches/Buzz/models - Linux：
~/.cache/Buzz/models
不用凭感觉找，可以打开偏好设置直接看：
- 点击窗口顶部菜单栏「Edit」中的「Preferences」，或直接按
Ctrl+,（Mac 上为Cmd+,） - 切换到「Models」选项卡，这里会分「Downloaded」（已下载）和「Available for Download」（可下载）两组列出全部型号
- 在列表中选中一个已下载的模型，点击「Show file location」按钮
- 系统文件管理器会直接打开模型所在的文件夹——这就是当前的模型存储位置
任务二：用 BUZZ_MODEL_ROOT 把下载目录指到数据盘
修改模型存储位置的入口不在偏好设置窗口里，而是环境变量BUZZ_MODEL_ROOT。相关逻辑可以在 buzz/model_loader.py 中查看：启动时读取该变量，指向哪个目录，后续所有模型就存到哪里，目录不存在时会自动创建。
⚠️ 注意：设置
BUZZ_MODEL_ROOT后，Buzz 会基于它自动推导 Hugging Face 下载所用的HF_HOME目录（见 buzz/buzz.py），两者指向同一处即可，无需再单独配置。
Windows 上操作
- 新建一个
run_buzz.bat脚本，第一行写set BUZZ_MODEL_ROOT=D:\Buzz\Models，第二行写 Buzz 可执行文件的完整路径来启动程序 - 以后每次都通过该脚本启动 Buzz；也可以把
BUZZ_MODEL_ROOT添加进"系统属性 → 环境变量"作为系统级变量，全局生效 - 检查数据盘目录名尽量用英文，避免特殊符号
macOS / Linux 上操作
- 新建
run_buzz.sh脚本，第一行写export BUZZ_MODEL_ROOT=/home/你的用户名/buzz_models，第二行写buzz启动命令 - 给脚本加上可执行权限（执行
chmod +x run_buzz.sh） - 之后通过
./run_buzz.sh启动 Buzz
选新位置时建议：
- 优先选空间充足的非系统盘，例如
D:\Buzz\Models或/home/yourname/buzz_models - 保证当前用户对该目录有读写权限
- 避免路径中出现中文或空格，减少下载和解压时的意外
任务三：把已下载的旧模型迁过去
环境变量只影响新下载，Buzz 不会自动搬运旧文件。已经下载好的模型需要手动迁移：
- 打开旧模型根目录，把
models下的内容整体复制，包括whisper子文件夹和各 Hugging Face 模型缓存目录 - 粘贴到
BUZZ_MODEL_ROOT指向的新目录，保持原有文件夹与文件名称不变 - 保留每个模型目录内的
.buzz_complete标记文件，Buzz 靠它判断下载是否完整，缺了会被视为未下载 - 确认新位置工作正常后，再手动清理旧目录释放空间
⚠️ 注意：迁移等于"搬家"，Buzz 靠文件名和位置识别模型。文件缺失、改名或损坏都会导致识别不到，只能重新下载。
任务四：验证新位置是否生效
- 完全退出 Buzz，再用新脚本启动
- 打开偏好设置「Models」选项卡，确认原本已下载的模型仍显示在「Downloaded」分组中
- 选中任一模型再次点击「Show file location」，如果文件管理器打开的是数据盘目录，说明切换成功
- 挑一段短音频试转写；若提示模型路径为空（对应报错 "Model path is empty. Check BUZZ_MODEL_ROOT…"），回去检查变量是否拼写正确、脚本是否真正执行
排障：模型"消失"时查这几处
- 权限不足：确认运行 Buzz 的用户能在该目录新建、写入文件
- 路径含特殊字符：改成纯英文加数字的路径重试
- 文件不完整：核对迁移后文件大小与原来一致；Buzz 加载时会做大小校验，缺斤少两的模型会被当作"未下载"处理
- 没有重启：环境变量在进程启动时读取，改完变量后必须重启 Buzz 才生效
把新旧模型都收进同一块数据盘后，系统盘就再也不会被大模型文件占满了。更多可用环境变量与偏好项，可参考 官方文档 · Preferences。
【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
