🔑 GitHub Token 权限配置助手

为 VvvebJs 配置正确的 GitHub 访问权限

⚡ 快速开始

👈 我是新手

第一次配置 GitHub Token

🚀 创建新 Token
🔧 我需要排查问题

Token 已创建但有问题

🧪 测试现有配置
1

访问 GitHub 设置

  1. 登录 GitHub
  2. 点击右上角头像 → Settings
  3. 左侧菜单 → Developer settings
  4. Personal access tokens → Tokens (classic)
  5. Generate new token (classic)
🔗 直接跳转
2

填写基本信息

VvvebJs Website Editor
推荐: 90 days
平衡安全性和便利性
3

选择权限范围 (Scopes)

⚠️ 重要: 必须勾选 repo 权限，这是 VvvebJs 保存文件的基础要求。
✅ 必需权限
包含: repo:status, repo_deployment, public_repo, repo:invite
用途: 创建、读取、更新网页文件
⚠️ 可选权限
用途: 如果您计划使用 GitHub Actions 自动部署
用途: 如果您需要管理 GitHub Packages
❌ 不需要的权限
  • ❌ admin:repo_hook
  • ❌ admin:org
  • ❌ admin:public_key
  • ❌ gist
  • ❌ notifications
  • ❌ user
  • ❌ delete_repo
  • ❌ admin:org_hook
原因: VvvebJs 只需要读写文件，不需要管理权限
4

配置环境变量

📋 获取 Token 后，在 Hugging Face Space Settings 中添加这些环境变量:
🔑 GitHub 认证
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GITHUB_OWNER=your_username
GITHUB_REPO=your_repo_name
⚙️ 存储配置
GITHUB_BRANCH=main
GITHUB_PATH=pages/
STORAGE_TYPE=github
📝 配置说明:
  • GITHUB_TOKEN: 刚创建的 40 字符 Token (以 ghp_ 开头)
  • GITHUB_OWNER: 您的 GitHub 用户名
  • GITHUB_REPO: 存储网页的仓库名
  • GITHUB_PATH: 网页保存的目录 (可以为空)
5

验证配置

✅ 配置检查清单
🧪 测试配置 ⚙️ 查看状态 🎨 开始使用编辑器

🔧 常见问题和解决方案

原因: Token 权限不足
解决:
  1. 确保勾选了 repo 权限
  2. 重新生成 Token 并更新环境变量
  3. 检查仓库是否为私有仓库（需要完整 repo 权限）
原因: Token 无效或过期
解决:
  1. 检查 Token 是否正确复制（40个字符，以 ghp_ 开头）
  2. 检查 Token 是否过期
  3. 重新生成新的 Token
原因: 仓库不存在或 Token 无访问权限
解决:
  1. 检查 GITHUB_OWNER 是否是正确的用户名
  2. 检查 GITHUB_REPO 是否是正确的仓库名
  3. 确保仓库存在且 Token 有访问权限
  4. 如果是组织仓库，确保 Token 有组织权限