模型下载中断或卡住进度条的解决方法

常见原因

1. Hugging Face 在当前网络环境下不稳定

这是最常见的原因。HF 服务器在海外，国内直连经常被限速。解决：

• 切换到代理 / VPN / 科学上网环境
• 换 Wi-Fi / 移动数据重试
• 不要在网络切换的临界状态下载

2. 手机存储不够

下载前确认：剩余存储 > 模型体积 + 1GB。存储不够下载会直接失败或卡在某个百分比。

3. 下载过程被系统中断

安卓厂商的定制 ROM（小米 MIUI、OPPO ColorOS 等）会在后台清理时杀掉应用进程。PocketPal AI 被挂起 = 下载中断。

解决：

• 把 PocketPal AI 加到电池优化白名单
• 把 PocketPal AI 锁定在最近任务列表里
• 下载过程中不要主动划掉应用

4. 受限模型缺少 HF token

如果是受限模型（Request access 标签），没填 HF token 或 token 对应的账号还没通过模型权限审核，下载会直接报 403。

中断后怎么继续

应用内断点续传（优先）

回到 Models 页，找到下载中断的模型，点击继续下载（通常会自动从上次中断处接着传，而不是从头开始）。

反复失败就换电脑下载

这是最稳的方案：

1. 电脑浏览器打开 Hugging Face 模型页面
2. 右键 .gguf 文件 → 下载
3. 电脑下载稳了之后用 USB / AirDrop 传到手机
4. PocketPal AI → Models → Import GGUF → 选中文件

验证下载完整性

下载完之后，对比文件大小：

• PocketPal AI 显示的文件大小（模型卡片上）
• Hugging Face 仓库页面标注的文件大小

如果两者一致 → 完整性 OK，可以加载。如果偏小 → 没下完整，继续补或重下。