GitHub Gist 同步配置 —— 书架数据的云端通路

Gist 是什么

Gist 是 GitHub 提供的轻量级代码片段托管服务——你可以把任意文本、JSON、代码片段存在上面，支持公开或私有。Novella 选它做同步通道的原因是：免费、稳定、API 简单、OAuth 集成方便。

同步数据里存了什么

Novella 往 Gist 写入一个 JSON 文件，包含以下内容：

• 书架上的所有书籍条目（书名、书源来源、加入时间、分类标签）。
• 每本书的阅读进度（当前章节、阅读到第几页、最后阅读时间）。
• 书签和高亮标记。
• 插件仓库列表和已安装的插件 ID。

不包含：

• 章节正文内容（太占空间、版权敏感）。
• 应用设置（阅读主题、字号等这些可以本地备份导出）。
• 任何统计数据或行为日志。

首次同步配置

授权登录 GitHub 后：

1. 进入 设置 → 云同步。
2. 同步方式选「GitHub Gist」。
3. 可以让应用自动创建一个新 Gist，或者手动在 GitHub 上创建一个私有 Gist 后把 Gist ID 填进来。
4. 点击「立即同步一次」验证通路是否正常——成功后会显示 Gist 的更新时间戳。

同步频率选择

Novella 提供三种同步触发方式：

• 自动同步 —— 每次书架变更（加书、删书、进度推进）时自动推送到 Gist。实时性好但网络请求多。
• 定时同步 —— 每隔 N 分钟（可选 5/15/30/60 分钟）检查变更后推送。推荐大多数用户选这个。
• 手动同步 —— 只在你点「立即同步」时才推送。适合网络环境不稳定或担心流量的用户。

多设备 Gist ID 必须相同

如果你想让两台设备共享同一个书架，两边的 Gist ID 必须填同一个。Gist 是单文件覆盖更新，两边同时写时后写的版本会覆盖前一个——所以在多设备间切换阅读时，建议每次换设备后先点一次「从云端拉取」确保拿到最新版本。