piclis如何设置github同步

一、准备工作（两种场景通用）

1. 创建 GitHub 仓库

1. 登录 GitHub，点击右上角「+」→「New repository」。
2. 填写仓库名（如 piclist-config 或 image-host）：
   1. 用于配置同步：建议设为 Private
   2. 用于图片图床：必须设为 Public
3. 点击「Create repository」完成创建。

2. 生成 GitHub Token

1. 进入 GitHub → 头像 → Settings → Developer settings → Personal access tokens → Tokens (classic)。
2. 点击「Generate new token (classic)」：
   1. Note 填写：PicList Sync
   2. Expiration 按需选择（如 90 天）
3. 勾选权限：repo（完整仓库权限）。
4. 点击「Generate token」，复制并保存 Token（仅显示一次，丢失需重新生成）。

二、场景1：PicList 配置同步到 GitHub（多设备同步）

1. 打开 PicList → 点击左下角「设置」→ 找到「配置同步」模块。
2. 同步类型选择「GitHub」。
3. 填写参数：
   1. 用户名：你的 GitHub 用户名
   2. 仓库：格式为 用户名/仓库名（如 yourname/piclist-config）
   3. 分支：main（或 master）
   4. Token：粘贴刚才生成的 GitHub Token
   5. 代理（可选）：网络需要代理时填写
   6. 同步间隔（可选）：自动同步频率（单位：分钟）
4. 点击「保存」，再点击「上传配置」，即可将本地配置推送到 GitHub。
5. 新设备使用：

1. 安装 PicList → 进入配置同步 → 填写相同信息 → 点击「下载配置」即可一键同步。

三、场景2：将 GitHub 作为图床（上传图片）

1. 打开 PicList → 左侧「图床」→ 选择「GitHub」→ 点击「配置」。
2. 填写参数：
     https://cdn.jsdelivr.net/gh/用户名/仓库名@分支/
   1. 配置名：自定义（如 GitHub图床）
   2. 仓库：用户名/仓库名（必须为 Public）
   3. 分支：main
   4. Token：粘贴之前生成的 GitHub Token
   5. 存储路径（可选）：如 images/（图片存放文件夹）
   6. 自定义域名（可选）：用于 CDN 加速，格式示例：
3. 点击「确定」，可设为默认图床。
4. 测试使用：

1. 直接将图片拖入上传区，即可自动生成 GitHub / CDN 图片链接。

四、常见问题

1. Token 失效

1. 去 GitHub 重新生成 Token，并在 PicList 里更新配置。

2. 图床无法访问/图片不显示

1. 检查仓库是否为 Public、Token 是否勾选 repo 权限。

3. 配置同步失败

1. 核对用户名、仓库名、分支、Token 是否正确，确保网络可以访问 GitHub。