尧图网页设计 
Buzz 模型下载卡住或中断从定位原因到本地导入的实操指南【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款基于 OpenAI Whisper 的本地离线音频转录与翻译工具运行在个人电脑上不需要把语音数据上传到任何服务器。但新手最常卡住的环节不是转录而是 Buzz 模型下载进度条长时间停在 0%中途弹出连接错误或者下载完成后提示校验失败、文件被删除。本文写给遇到这三类问题的用户先花两分钟对照现象表定位故障点再用最小的一组命令完成修复最后用官方尺寸表验证模型真正可用。三类典型故障现象先对照表格选处方Buzz 的模型按来源分为五条下载通道OpenAI Whisper 官方、Whisper.cpp、Faster Whisper、Hugging Face 等故障表现也不同。先判断你属于哪一类现象最可能的原因对应处方进度条以很低的速度缓慢推进或长时间停在 0%跨国链路拖慢模型仓库下载第 1 级换镜像端点中途断开提示连接错误模型目录里残留半截文件连接中断断点续传未生效第 1 级或第 2 级下载完成却提示 SHA256 校验不匹配文件被自动删除文件不完整或损坏第 2 级本地导入手动放入文件后偏好设置里仍显示可下载Buzz 未在预期目录找到文件先读定位根因一节定位根因模型下载最常见的三个问题1. 模型源在海外。Whisper.cpp 与 Faster Whisper 的模型文件从 Hugging Face Hub 分发buzz/model_loader.py 第 120~123 行定义了模型根目录默认位于系统用户缓存下的Buzz/models可用环境变量BUZZ_MODEL_ROOT覆盖。跨国链路慢是国内用户下载缓慢的主要来源。2. 中断的文件不会自动愈合。Buzz 从第 1007 行起实现了断点续传但前提是服务器支持 HTTP Range 请求返回 206 状态码。若服务器只返回 200下载会从头重来表现为每次都从 0% 开始。3. 放错位置或未通过校验。OpenAI Whisper 官方模型下载后会做 SHA256 校验第 1171~1186 行不匹配时文件被自动删除并提示重试Hugging Face 类模型则要求缓存目录里存在.buzz_complete标记文件缺失即判定为未下载完成第 127 行、第 781~784 行。技术原理Hugging Face 下载在独立子进程中运行失败后自动重试最多 3 次间隔按 5 秒、10 秒递增第 686~687 行、第 699~720 行已缓存的文件不会重复下载。所以一次中断后的第二次下载起点是上次断开的字节而不是 0——这也是先换链路、再谈重建的原因。三级修复方案按你的网络条件自选路径第 1 级推荐把模型下载切换到国内镜像端点Buzz 官方支持用HF_ENDPOINT环境变量更换 Hugging Face 下载端点官方偏好文档 docs/docs/preferences.md 第 124 行明确给出了加速示例。以 PyPI 方式安装的 Buzz 为例# Linux / macOS设置镜像端点后启动 export HF_ENDPOINThttps://hf-mirror.com python -m buzzWindows 用户在命令行执行set HF_ENDPOINThttps://hf-mirror.com后再启动 Buzz.exe。启动后打开偏好设置的模型页面选择模型并点击 DownloadWhisper.cpp、Faster Whisper、Hugging Face 三个后端的下载都会改走镜像速度由本地带宽决定不再受跨国链路限制。注意事项OpenAI Whisper 官方模型走的是独立的直连下载路径第 926 行起的_download_whisper不受HF_ENDPOINT影响。若你只需要这个小众后端请改用第 2 级方案或在偏好设置中改选 Whisper.cpp / Faster Whisper 后端两者都走 Hugging Face 通道可被镜像加速。第 2 级备选把现成的 ggml 模型文件导入模型目录适合文件已经有了但 Buzz 不认的场景例如从同事处拷贝、或用其他工具下载过的.bin文件。Whisper.cpp 后端支持Custom 自定义模型文件名是固定的ggml-model-whisper-custom.bin第 654~655 行这是手动导入中最可靠的路径打开偏好设置 → 模型任选一个已下载模型点击显示文件位置按钮Buzz 会直接打开它实际使用的模型根目录无需猜测路径将手头任意ggml-*.bin模型重命名为ggml-model-whisper-custom.bin放入该目录回到偏好设置在模型列表选择 Whisper.cpp 下的 Custom。文件存在即校验通过模型出现在已下载分组下。模型根目录默认位置Linux 为~/.cache/Buzz/modelsmacOS 为~/Library/Caches/Buzz/modelsWindows 建议以显示文件位置打开的目录为准。若你的 Buzz 设置过BUZZ_MODEL_ROOT则以该目录为准。第 3 级进阶为离线机器批量预下载模型文件仓库自带离线部署脚本 scripts/download-models.py专为无网络或网络隔离环境设计支持按后端和尺寸筛选。在一台联网正常的机器上执行git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz uv run python scripts/download-models.py --model-type whispercpp --model-size tiny模型会写入BUZZ_MODEL_ROOT指向的目录默认是用户缓存。把该目录整体拷贝到离线机器启动前设置同名变量即可export BUZZ_MODEL_ROOT/path/to/buzz-models脚本对已存在的模型会自动跳过already present, skipping因此可多次运行补齐缺项。复查三种方法确认模型文件可用方法一看已下载分组。偏好设置 → 模型的列表把模型分为 Downloaded 与 Available for Download 两组划分依据是get_local_model_path()的完整校验文件存在 尺寸/标记检查。仍在可下载分组下说明文件没被识别回到定位根因一节排查。方法二对照官方尺寸表。buzz/model_loader.py 第 159~172 行内置了各模型的预期大小文件明显偏小基本就是下载不完整模型预期大小tiny / tiny.en约 73 MBbase / base.en约 139 MBsmall / small.en约 462 MBmedium / medium.en约 1.5 GBlarge / large-v2 / large-v3约 2.9 GBlarge-v3-turbo约 1.6 GB方法三跑一次真实转录。导入一段音频文件发起转录Buzz 会完整走完加载模型 → 推理 → 输出文本链路这是最接近实际使用的验收方式。卡住时去哪里找答案Buzz 的下载逻辑本身已内置断点续传、重试与双重校验多数下载失败在正确定位上述三个根因后即可解决无需改动代码。若问题仍未排除按顺序查阅docs/docs/installation.md 覆盖各平台安装方式docs/docs/preferences.md 提供全部环境变量清单含HF_ENDPOINT、BUZZ_MODEL_ROOT、HF_HOME的说明下载、续传与校验的完整实现集中在 buzz/model_loader.py 一个文件中定位具体报错时直接对照行号阅读效率最高。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 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 的本地离线音频转录与翻译工具运行在个人电脑上不需要把语音数据上传到任何服务器。但新手最常卡住的环节不是转录而是 Buzz 模型下载进度条长时间停在 0%中途弹出连接错误或者下载完成后提示校验失败、文件被删除。本文写给遇到这三类问题的用户先花两分钟对照现象表定位故障点再用最小的一组命令完成修复最后用官方尺寸表验证模型真正可用。三类典型故障现象先对照表格选处方Buzz 的模型按来源分为五条下载通道OpenAI Whisper 官方、Whisper.cpp、Faster Whisper、Hugging Face 等故障表现也不同。先判断你属于哪一类现象最可能的原因对应处方进度条以很低的速度缓慢推进或长时间停在 0%跨国链路拖慢模型仓库下载第 1 级换镜像端点中途断开提示连接错误模型目录里残留半截文件连接中断断点续传未生效第 1 级或第 2 级下载完成却提示 SHA256 校验不匹配文件被自动删除文件不完整或损坏第 2 级本地导入手动放入文件后偏好设置里仍显示可下载Buzz 未在预期目录找到文件先读定位根因一节定位根因模型下载最常见的三个问题1. 模型源在海外。Whisper.cpp 与 Faster Whisper 的模型文件从 Hugging Face Hub 分发buzz/model_loader.py 第 120~123 行定义了模型根目录默认位于系统用户缓存下的Buzz/models可用环境变量BUZZ_MODEL_ROOT覆盖。跨国链路慢是国内用户下载缓慢的主要来源。2. 中断的文件不会自动愈合。Buzz 从第 1007 行起实现了断点续传但前提是服务器支持 HTTP Range 请求返回 206 状态码。若服务器只返回 200下载会从头重来表现为每次都从 0% 开始。3. 放错位置或未通过校验。OpenAI Whisper 官方模型下载后会做 SHA256 校验第 1171~1186 行不匹配时文件被自动删除并提示重试Hugging Face 类模型则要求缓存目录里存在.buzz_complete标记文件缺失即判定为未下载完成第 127 行、第 781~784 行。技术原理Hugging Face 下载在独立子进程中运行失败后自动重试最多 3 次间隔按 5 秒、10 秒递增第 686~687 行、第 699~720 行已缓存的文件不会重复下载。所以一次中断后的第二次下载起点是上次断开的字节而不是 0——这也是先换链路、再谈重建的原因。三级修复方案按你的网络条件自选路径第 1 级推荐把模型下载切换到国内镜像端点Buzz 官方支持用HF_ENDPOINT环境变量更换 Hugging Face 下载端点官方偏好文档 docs/docs/preferences.md 第 124 行明确给出了加速示例。以 PyPI 方式安装的 Buzz 为例# Linux / macOS设置镜像端点后启动 export HF_ENDPOINThttps://hf-mirror.com python -m buzzWindows 用户在命令行执行set HF_ENDPOINThttps://hf-mirror.com后再启动 Buzz.exe。启动后打开偏好设置的模型页面选择模型并点击 DownloadWhisper.cpp、Faster Whisper、Hugging Face 三个后端的下载都会改走镜像速度由本地带宽决定不再受跨国链路限制。注意事项OpenAI Whisper 官方模型走的是独立的直连下载路径第 926 行起的_download_whisper不受HF_ENDPOINT影响。若你只需要这个小众后端请改用第 2 级方案或在偏好设置中改选 Whisper.cpp / Faster Whisper 后端两者都走 Hugging Face 通道可被镜像加速。第 2 级备选把现成的 ggml 模型文件导入模型目录适合文件已经有了但 Buzz 不认的场景例如从同事处拷贝、或用其他工具下载过的.bin文件。Whisper.cpp 后端支持Custom 自定义模型文件名是固定的ggml-model-whisper-custom.bin第 654~655 行这是手动导入中最可靠的路径打开偏好设置 → 模型任选一个已下载模型点击显示文件位置按钮Buzz 会直接打开它实际使用的模型根目录无需猜测路径将手头任意ggml-*.bin模型重命名为ggml-model-whisper-custom.bin放入该目录回到偏好设置在模型列表选择 Whisper.cpp 下的 Custom。文件存在即校验通过模型出现在已下载分组下。模型根目录默认位置Linux 为~/.cache/Buzz/modelsmacOS 为~/Library/Caches/Buzz/modelsWindows 建议以显示文件位置打开的目录为准。若你的 Buzz 设置过BUZZ_MODEL_ROOT则以该目录为准。第 3 级进阶为离线机器批量预下载模型文件仓库自带离线部署脚本 scripts/download-models.py专为无网络或网络隔离环境设计支持按后端和尺寸筛选。在一台联网正常的机器上执行git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz uv run python scripts/download-models.py --model-type whispercpp --model-size tiny模型会写入BUZZ_MODEL_ROOT指向的目录默认是用户缓存。把该目录整体拷贝到离线机器启动前设置同名变量即可export BUZZ_MODEL_ROOT/path/to/buzz-models脚本对已存在的模型会自动跳过already present, skipping因此可多次运行补齐缺项。复查三种方法确认模型文件可用方法一看已下载分组。偏好设置 → 模型的列表把模型分为 Downloaded 与 Available for Download 两组划分依据是get_local_model_path()的完整校验文件存在 尺寸/标记检查。仍在可下载分组下说明文件没被识别回到定位根因一节排查。方法二对照官方尺寸表。buzz/model_loader.py 第 159~172 行内置了各模型的预期大小文件明显偏小基本就是下载不完整模型预期大小tiny / tiny.en约 73 MBbase / base.en约 139 MBsmall / small.en约 462 MBmedium / medium.en约 1.5 GBlarge / large-v2 / large-v3约 2.9 GBlarge-v3-turbo约 1.6 GB方法三跑一次真实转录。导入一段音频文件发起转录Buzz 会完整走完加载模型 → 推理 → 输出文本链路这是最接近实际使用的验收方式。卡住时去哪里找答案Buzz 的下载逻辑本身已内置断点续传、重试与双重校验多数下载失败在正确定位上述三个根因后即可解决无需改动代码。若问题仍未排除按顺序查阅docs/docs/installation.md 覆盖各平台安装方式docs/docs/preferences.md 提供全部环境变量清单含HF_ENDPOINT、BUZZ_MODEL_ROOT、HF_HOME的说明下载、续传与校验的完整实现集中在 buzz/model_loader.py 一个文件中定位具体报错时直接对照行号阅读效率最高。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考