ProjectManager / 云同步 / GitHub Gist

GitHub Gist 同步

用 GitHub Gist 给项目数据做云端备份。四步配好,之后每次同步都会留下一份版本历史。

1创建 Personal Access Token

  1. 访问 GitHub 设置 — 登录 GitHub,点击右上角头像 →「Settings」→ 左侧「Developer settings」。
  2. 进入 Token 管理 — 选择「Personal access tokens」→「Tokens (classic)」→「Generate new token (classic)」。
  3. 填写 Token 信息 — 输入名称(如 ProjectManager-Sync),设置过期时间(建议 90 天或永不过期)。
提示:Token 创建后只显示一次,请务必立即复制保存到安全的地方。

2设置 Token 权限

  1. 勾选 Gist 权限 — 在权限列表中找到「gist」选项并勾选,允许 ProjectManager 创建和管理你的 Gist。
  2. 生成 Token — 滚动到页面底部,点击「Generate token」。
  3. 安全保存 Token — 生成的 Token 字符串只显示一次,关闭页面后将无法再次查看,请立即复制保存。
注意:切勿将 Token 提交到 Git 仓库或分享给他人。如 Token 泄露,请立即在 GitHub 上删除并重新生成。

3获取连接信息

在 ProjectManager 设置中填写以下信息:

同步后端
GitHub Gist
Token
上一步生成的 Personal Access Token
文件名
project.pm
提示:ProjectManager 会自动创建 Gist 并命名为 project.pm,利用 Gist 的版本历史追踪每次变更。

4在 ProjectManager 中配置

  1. 打开设置 — 点击菜单栏「设置」→「云同步」,选择「GitHub Gist」作为同步后端。
  2. 输入 Token — 粘贴你的 Personal Access Token。凭据将通过系统 keyring 安全加密存储,不会明文保存。
  3. 测试连接 — 点击「测试连接」,验证 Token 是否有效。成功后会显示你的 GitHub 用户名。
  4. 开始同步 — 点击「推送」将本地项目上传至 Gist,或点击「拉取」从 Gist 下载项目数据。首次推送会自动创建 Gist。
完成:配置完成后,每次同步都会创建 Gist 的新版本,你可以在 GitHub 上查看完整的变更历史。

使用限制

单个文件大小
最大 1MB
Gist 总数
无公开限制,但建议定期清理
API 频率
5000 次/小时(认证用户)
版本历史
自动保存,可回溯任意版本