浏览帮助文章

把作品备份到 GitHub 或 Gitee

先自己建好仓库，把个人访问令牌存在本机浏览器，再把作品单向备份出去。

这是什么

Git 备份把你的作品从 Pixorla 复制到你已经在 GitHub 和/或 Gitee 建好的仓库。Pixorla 是真相源：在这里编辑，再点「立即备份」。仓库只是保险柜。这不是双向同步；用 GitHub 登录 Pixorla 也不会获得写仓库权限。

请先自己建仓库

在 GitHub 或 Gitee 新建仓库即可（空仓也可以，不必先加 README）。若有私有或不公开作品，请用私有仓库。然后在 Pixorla 账户设置 → Git 备份填写 owner/repo。Pixorla 不会替你建仓。

个人访问令牌（PAT）

PAT 是你在 Git 托管站生成的钥匙，用来让 Pixorla 写文件。粘贴到账户设置 → Git 备份。令牌加密存在本机，不会写入 Pixorla 数据库，退出登录会删除（与其他本机密钥相同）。仓库名不是密钥，退出后可以保留。用 GitHub 登录 Pixorla 不会获得写仓库权限，仍需单独的 PAT。

在 GitHub 获取 PAT

请用细粒度令牌，只授权你已经建好的那一个备份仓库。不需要「创建仓库」权限。

  1. 打开 GitHub，点击头像 → Settings。左侧栏靠近底部打开 Developer settings。
  2. 打开 Personal access tokens → Fine-grained tokens，再点 Generate new token。填写名称和过期时间。
  3. Repository access 选 Only select repositories，勾选你已经建好的备份仓库。
  4. Permissions → Repository permissions 里，把 Contents 设为 Read and write。Metadata 保持 Read-only。不要开 Administration 或其他权限。
  5. 生成后立刻复制——GitHub 只显示一次。粘贴到 Pixorla 账户设置 → Git 备份的 GitHub 卡片。

打开 GitHub 令牌设置 →

在 Gitee 获取私人令牌

Gitee 把 PAT 叫做「私人令牌」。界面会强制勾上 user_info，不能取消，这是正常的。另外必须再勾 projects（仓库读写），不需要建仓权限。

  1. 打开 Gitee，点击头像 → 设置。左侧打开「安全设置 → 私人令牌」（有的界面写作 Personal access tokens）。
  2. 点击「生成新令牌」。填写描述；若有过期时间一并设置。
  3. user_info 会默认勾上且无法取消，不用管。再勾选 projects（查看、创建、更新项目）。不要全选，其余权限保持关闭。
  4. 提交，若提示则输入 Gitee 登录密码确认。
  5. 立刻复制令牌——关闭页面后不再显示。粘贴到 Pixorla 账户设置 → Git 备份的 Gitee 卡片。

打开 Gitee 私人令牌设置 →

执行备份

先「测试连接」，再「立即备份」。也可在各平台卡片开启「主动保存作品成功后自动备份」；只在当前浏览器登录且令牌可用时运行，后台自动保存草稿不触发。已配置的平台各自推送，一边失败不影响另一边。只提交内容有变化的作品，目录为 fiddles/{id}/，内含 index.html、fiddle.md、fiddle.json。图片不会打进仓库。作品很多时若中途停下，再点一次即可续跑。

频率限制

为避免短时间反复清空再全量重推占用线路，清空远程备份每小时最多 3 次；测试连接与立即备份合计每 10 分钟最多 200 次请求。作品按每批 15 个分批，GitHub 与 Gitee 同时推时 GitHub 更快，特别大的库可能先推一部分。超限后等几分钟再点「立即备份」即可从上次停下的地方续跑。

覆盖、删除与退出

下次备份会覆盖 Git 里的同名文件。在 Pixorla 删除作品不会删除仓库里的目录——要清请自己在 Git 里删。退出登录会清除本机 PAT。不要把 PAT 发到公开地方或截进图里。