Buzz 模型存储位置自定义指南3 步把 Whisper 模型搬出系统盘【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款基于 OpenAI Whisper 的本地音频转写与翻译工具全程离线运行不上传任何音频。这篇教程带你用 3 步自定义 Buzz 的模型存储位置把动辄几个 GB 的 Whisper 模型从系统盘挪到空间更大的磁盘让转写体验既顺畅又省心。先搞清楚Buzz 的模型默认藏在哪里用惯了 Buzz 的人大概率没注意过这件事——你每下载一个模型都在悄悄消耗系统盘。Buzz 的模型体积并不小medium约 1.5 GBlarge-v3接近 2.9 GBFaster Whisper 和 Hugging Face 模型还会更多。默认情况下这些文件全部落在用户缓存目录下位置因系统而异Linux~/.cache/Buzz/modelsmacOS~/Library/Caches/Buzz/modelsWindowsC:\Users\你的用户名\AppData\Local\Buzz\Cache\models如果你的系统盘只剩几十 GB再下几个模型就会捉襟见肘。下面的方案就是把模型根目录整体迁移到你指定的位置。打开偏好设置的 Models 页先认识模型管理区迁移之前先知道 Buzz 在哪里管理模型。启动 Buzz点击菜单栏的「Help」帮助选择「Preferences」偏好设置在弹出窗口顶部切换到「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 buzzWindows新建run_buzz.batecho off set BUZZ_MODEL_ROOTD:\Buzz\Models C:\Program Files (x86)\Buzz\Buzz.exe然后以后都通过这个脚本启动 Buzz替代直接双击图标。也可以不写脚本直接在系统的环境变量设置里新增BUZZ_MODEL_ROOT效果相同。两点说明目录会自动创建不需要你提前建好但请确保该位置可读写设置了BUZZ_MODEL_ROOT后HuggingFace 相关的缓存会自动派生到它的上一级目录通常无需再手动设置其他变量⚠️ 注意环境变量只在启动时读取一次。改完脚本或变量后必须完全退出 Buzz 再重新打开才会生效。把旧模型搬到新位置避免重新下载改完路径后新目录是空的——已下载的模型不会自动跟着走。手动搬一次即可省下几个 GB 的重复下载完全关闭 Buzz确保环境变量生效后退出把旧位置整个models文件夹复制到BUZZ_MODEL_ROOT指向的新目录重新打开 Buzz进入 Models 页确认模型出现在「Downloaded」分组下确认无误后删除旧目录里不再需要的模型文件释放系统盘⚠️ 注意请整个文件夹复制不要只挑单个模型文件。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_MEMORYtrue可启用 8bit 量化模型降低显存占用代价是轻微精度损失。小结回到开头的问题系统盘快满了怎么办三步走完——打开 Models 页认准「Show file location」定位旧目录用BUZZ_MODEL_ROOT环境变量指定新位置整体迁移models文件夹并重启验证。之后每次下载模型都会自动落盘到你指定的磁盘。如果你还想进一步榨取性能可以继续逛逛偏好设置里的 GPU 选项、语言列表和快捷键配置官方偏好设置文档里还收录了全部高级环境变量按需取用即可。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考