Hugging Face 访问令牌怎么配置

什么情况下需要 HF token

• 下载标记为 Request access 或 Restricted 的模型
• 想下载比未登录用户更高的下载速率（HF 对未登录下载有速率限制）
• 导入私有仓库里的模型文件

获取 HF token 的步骤

第一步：注册 Hugging Face 账号

访问 huggingface.co 用邮箱注册，完成邮箱验证。

第二步：申请受限模型访问

1. 打开目标模型仓库页面（如 meta-llama/Llama-3.1-7B-Instruct-GGUF）
2. 页面右侧有「Request access」按钮
3. 填写申请理由（如实写用途，如「个人学习研究本地推理」）
4. 等待审核通过（通常几分钟到几小时，Llama 系列快，某些商业授权模型慢）

第三步：生成 Access Token

1. 登录后点右上角头像 → Settings
2. 左侧菜单 → Access Tokens
3. 点「Create new token」
4. Token 类型选 Read（只读就够了，不需要 Write 权限）
5. 生成后复制 token（格式类似 hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

第四步：填入 PocketPal AI

侧边导航 → Settings → Hugging Face Token → 粘贴生成的 token → 保存。

安全性说明

• Token 只存在 PocketPal AI 的本地设置中，不会上传到 PocketPal AI 服务端（因为它根本没有服务端）
• Token 只在请求 HF API 时使用（模型搜索、受限模型下载）
• Read 权限的 token 即使泄露也只能读取仓库内容，不能修改

常见问题

token 填对了还是 403

说明你申请的那个具体模型还没通过审核。打开模型仓库页面确认状态——部分模型除了仓库访问还需要额外的 GGUF 分支访问权限。

换手机了 token 要重新申请吗

不需要。token 是和你的 HF 账号绑定的，不是设备绑定。在新手机上的 PocketPal AI 设置里重新粘贴同一个 token 就行。