GitHub Personal Access Token 申请

获取 GitHub Personal Access Token (PAT) 是为了让程序（如你的 Python 脚本或 GitHub Actions）能够代表你安全地访问仓库。GitHub 目前提供两种类型的 Token：Fine-grained（细粒度） 和 Classic（经典）。

为了安全性，建议优先使用 Fine-grained 令牌。以下是具体的操作步骤：

## 第一步：进入开发者设置

  1. 登录 GitHub，点击右上角的个人头像。

  2. 在下拉菜单中选择 Settings（设置）。

  3. 在页面左侧菜单的最下方，找到并点击 Developer settings。

## 第二步：生成 Fine-grained Token（推荐）

这种 Token 权限控制更精确，可以只授权给特定的仓库。

  1. 在左侧点击 Personal access tokens -> Fine-grained tokens。

  2. 点击右侧的 Generate new token。

  3. 配置基础信息：

    • Token name：起一个容易识别的名字（如 Sync-Obsidian-to-Hugo）。

    • Expiration：设置过期时间（建议不要设为永久，90天左右比较安全）。

  4. Repository access（仓库访问）：

    • 选择 Only select repositories。

    • 在下拉列表中选择你的 Hugo 框架仓库（因为你需要向它推送代码）。

  5. Permissions（权限设置）：

    • 点击 Repository permissions 展开。

    • 找到 Contents，将其权限设置为 Read and write（这会自动勾选 Metadata 的只读权限）。

  6. 滚动到页面底部，点击 Generate token。

## 第三步：保存并记录 Token

  1. 立即复制： 生成后，你会看到一串以 github_pat_ 开头的字符串。请务必立刻将其复制并保存到本地的安全位置（如密码管理器中）。

  2. 唯一性： 刷新页面后，你就再也无法看到这串字符了。如果丢失，你只能删除并重新生成一个。