用 GitHub 账号登录 Novella —— OAuth 授权流程说明

为什么不用邮箱注册

Novella 不需要自己的用户数据库。它选择 GitHub 账号做登录有两个原因：

1. GitHub Gist 是它唯一的云同步通道——用同一个账号授权 Gist API 最自然，不需要再维护一套独立的账号系统。
2. 开发者友好——轻书架生态的用户群体本身就以开发者为主，几乎人人有 GitHub 账号。

整个登录流程走标准的 OAuth 2.0 授权码模式，Novella 不会拿到你的 GitHub 密码。

登录步骤

1. 打开 Novella，进入 设置 → 账号。
2. 点击「登录 GitHub」，应用会调用系统浏览器跳转到 GitHub 授权页面。
3. 在 GitHub 页面上确认授权范围（只读公开信息 + Gist 读写权限），点击「授权」。
4. 浏览器会自动跳回 Novella，授权完成后设置页会显示你的 GitHub 用户名。

授权范围说明

Novella 请求的 GitHub 权限只有两项：

• user:read —— 读取你的公开资料（用户名、头像），仅用于在设置页显示身份，不做任何数据收集。
• gist —— 创建、读取、更新你的 Gist 代码片段。这是云同步的核心——Novella 把同步数据序列化后写入一个私有 Gist。

Novella 不会请求仓库读写（repo）、组织管理（admin:org）或任何其他敏感权限。授权后你随时可以在 GitHub 的 Applications 设置页撤回。

撤回授权

打开 GitHub 设置 → Applications → Authorized OAuth Apps，找到 Novella 对应的应用条目，点击「撤销」按钮。撤销后 Novella 立即失去 Gist 访问权——本地书架不受影响，只是云同步会停止工作。