pocketpal 中文文档 下载 App

首次启动之后怎么下载第一个 GGUF 模型

预期首次打开是什么样

空聊天界面,顶部提示「没有可用的模型」,发送按钮灰色不可点。这是设计行为,不是安装失败。

三步流程

进入 Models 页

从侧边栏抽屉找到「Models」菜单项(图标是芯片)。首次进入会看到应用内置的几个推荐模型卡片(Gemma 2、Qwen、Phi 系列等),也可以用顶部搜索框手动搜索。

挑选并下载

参考 内存对照表 和 热门模型推荐,选一个不超过你手机内存上限的模型。

加载进内存

下载完成后卡片上的「下载」按钮变成「Load」。点一下,等几秒模型装进 RAM,之后按钮变成「Unload」表示模型已加载。回到聊天页即可正常对话。

加载 vs 下载的区别

状态含义
未下载存储里没有这个 GGUF 文件
已下载未加载文件在存储里,但没装进内存(省电、省 RAM)
已加载文件在 RAM 里,可立即对话
卸载从 RAM 里清出去,释放内存给其他应用

模型可以下载多个但同时只能加载一个。切换模型时先 Unload 当前模型,再 Load 新的。

常见问题

下载卡在某个百分比不动

常见原因:Hugging Face 在国内连接不稳定。试试:

  1. 切到代理 / VPN 环境
  2. 换 Wi-Fi / 流量重试
  3. 在电脑上下载好 .gguf 文件后通过文件传输导入手机(见 手动导入 GGUF 文件)

受限模型报 403

某些模型需要 HF 访问令牌。去 隐私与数据 → Hugging Face 令牌设置 按步骤填写 token 后重试。