Buzz模型存储位置修改指南：三步把系统盘空间让出来

Buzz模型存储位置修改指南三步把系统盘空间让出来【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz是一款基于 OpenAI Whisper、在你自己电脑上完全离线运行的语音转写与翻译工具支持 Whisper、Whisper.cpp、Faster Whisper 等多种模型。每下载一个识别模型默认都会落在系统盘的缓存目录里攒上几个大体积型号C 盘空间很快告急。下面按查位置 → 换目录 → 迁移旧模型 → 验证四个小任务走一遍帮你把 Buzz 模型存储位置搬到空间充裕的数据盘。任务一先弄清模型文件现在放在哪Buzz 把已下载的模型统一收在一个模型根目录下。没有手动指定时它使用操作系统的用户缓存目录并附加models子文件夹WindowsC:\Users\用户名\AppData\Local\Buzz\Cache\modelsmacOS~/Library/Caches/Buzz/modelsLinux~/.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_ROOTD:\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 OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考