众所周知，由于网络原因，国内用户无法直接访问全球最大的 AI 模型库 https://huggingface.co 。许多 AI 软件（如 pyVideoTrans）都需要从这里在线下载模型。为此，默认使用国内镜像站 https://hf-mirror.com 来解决这个问题。

坏消息来了：

最近，这个镜像站越来越不稳定，经常出现下载失败、连接超时的问题，甚至还加了限流，动不动就报 429 “请求太多” 的错误。

这些问题通常表现为以下几种错误提示：

别担心！下面我一步步教你几种简单可靠的方法来正常下载模型。选择适合自己的方式，就能轻松搞定。

方法一：直接从 Hugging Face 官网下载（推荐科学上网用户）

这是最直接、最稳定的方式，前提是你能“科学上网”（比如用 VPN），并且浏览器能正常打开 https://huggingface.co 。

步骤：

1. 设置代理：在软件的“网络代理”文本框中，填写你的代理地址和端口（格式：代理地址:端口）。或者设置系统级代理，确保整个电脑都能上网。

2. 创建锁文件：在 sp.exe 同目录下，新建一个空文件，命名为 huggingface.lock。注意：文件后缀必须是 .lock，不是 .txt！为了避免出错，请在文件资源管理器中启用“显示文件扩展名”选项（文件夹顶部 -> 查看 -> 勾选“文件扩展名”）,如下图

   

   小贴士：不会创建 .lock 文件？没问题！右键新建一个 huggingface.txt，然后重命名，把 .txt 改成 .lock。记得先选中“文件扩展名”选项哦，就像上图一样。

这样设置后，软件就会优先从官网下载模型，速度快、成功率高！

方法二：使用专用下载工具（超简单，一键搞定）

为了让下载更方便，我专门准备了两个 EXE 工具：一个从镜像站 hf-mirror.com 下载，另一个从官网 huggingface.co 下载。你可以根据网络情况选择。

步骤：

1. 访问下载页面： ，下载你需要的文件，下载后和 sp.exe放在一起。

2. 双击运行工具，模型就会自动开始下载，并放到正确位置。

方法三：手动从 GitHub 下载压缩包

如果以上方法都不行，可以手动下载预打包的模型压缩包，从 GitHub 获取。

步骤：

1. 在浏览器中打开： https://github.com/jianchang512/stt/releases/tag/0.0

2. 下载你需要的模型文件

3. 解压文件到软件的 models 文件夹。特别注意：解压时要检查目录层级，别搞错文件夹结构了！