从电脑手动导入 GGUF 模型文件到 PocketPal AI

什么时候需要手动导入

• Hugging Face 在当前网络环境下连接不稳定或被限速
• 需要下载应用内搜索不到的小众模型
• 需要下载受限模型（已在浏览器里拿到 HF token 权限）

电脑端下载

1. 在浏览器打开 Hugging Face 上目标模型的 GGUF 仓库
2. 找到想要的量化档位文件（.gguf 后缀），右键 → 另存为 / Download
3. 大文件（3GB+）建议用迅雷或下载管理器，避免浏览器下载中断

传输到手机

安卓用户

• USB 数据线：连上电脑后选择「文件传输」，把 .gguf 放进任意目录
• ADB：开发模式下用 adb push 传到 /sdcard/Download/
• 云盘：把文件存进夸克/百度网盘，手机端下载到本地

iOS 用户

• AirDrop：Mac 上直接 AirDrop 到 iPhone，选择 PocketPal AI 接收
• 文件 App：把 .gguf 放进 iCloud Drive，iPhone 上从「文件」App 打开并保存到 PocketPal AI 的文档目录
• USB + Finder：连电脑后在 Finder 的 iPhone 标签页 → 文件 → 拖入 PocketPal AI 文件夹

应用内加载

PocketPal AI 的 Models 页右上角有一个「Import GGUF」或「从文件导入」按钮。点它后会弹出文件选择器，找到刚才传进来的 .gguf 文件，确认导入。

导入完成后模型会出现在列表中，和应用内下载的模型使用方式完全一样——点 Load 加载即可。

注意事项

• 不要重命名文件：GGUF 文件内部包含模型元信息，应用依赖文件名或内部 header 识别模型名称与量化档位。改了名字可能导致识别失败。
• 文件完整性校验：Hugging Face 上的大文件可能提供 SHA256 校验值。下载后对比一下，确保文件没有损坏。
• iOS 存储配额：iOS 每个应用的文档目录有配额限制，单个 .gguf 文件如果超过 4GB 可能存不进去。