GitHub OAuth 登录 — 授权流程走浏览器跳回

为什么必须登录

登录后 Gloom 的核心功能才有意义：

• 首页动态流需要你的关注关系和 Star 记录来铺排
• Star 列表、Following 列表、个人主页这些页面全绑定到具体账号
• 要给 Issue/PR 加表情回应，也必须身份认证

不登录也能打开 Gloom，但内容基本是空的——没有动态、没有 Star、没有个人数据。

登录流程（四步）

第一步：打开 Gloom，点「用 GitHub 登录」

首次启动停在登录入口页，上面只有一个按钮「Sign in with GitHub」。点它。

第二步：跳转到浏览器里的 GitHub 授权页

系统会用你默认浏览器打开 github.com 的 OAuth 授权页面（如果浏览器没登录过 GitHub，会先让你输入账号密码）。页面会列出 Gloom 请求的权限范围（通常是只读的基本信息 + 读写 Star + 读写 Follow），确认权限列表里没有你不认识的大范围权限。

第三步：点「授权」或「Authorize」

GitHub 确认权限后，浏览器应该自动跳回 Gloom 应用。

第四步：回到 Gloom，登录完成

跳回 Gloom 后应用自动加载你的数据，停在首页。如果停在浏览器没自动跳回，重新在 Gloom 里点一次登录按钮就行——授权记录已经有了，第二次会直接跳过浏览器阶段。

安全相关

• 密码不会经过 Gloom：OAuth 流程里密码只在 GitHub 自己的页面里输入，Gloom 拿不到
• Token 只在本地存：授权成功后拿到的 access token 存在 Gloom 应用的本地存储里，不会上传到任何服务器
• 可以随时撤销授权：在 GitHub → Settings → Applications → Authorized OAuth Apps 里找到 Gloom，点「Revoke」就能让已存的 token 失效

登录遇到的常见卡点

浏览器一直卡在 GitHub 页面不跳回

授权完成后 GitHub 需要回调 Gloom 应用的 gloom:// 自定义协议。如果没自动跳：

1. 检查 Gloom 是不是真的在后台（没被系统杀掉）
2. 手动回到桌面点 Gloom 图标，它应该直接进入已登录状态（token 已经存好了）
3. 如果还不行，清一下浏览器缓存重走流程

授权后 Gloom 加载不出数据

确认手机能正常打开 github.com。Gloom 所有数据都直接从 GitHub API 拉，网络不通时客户端无解——换 Wi-Fi 或切流量试试。

想换账号

Gloom 没有内置「退出登录」按钮（因为浏览型客户端不需要多账号管理）。要换账号的话，清除 Gloom 应用数据（设置 → 应用 → Gloom → 清除数据），或卸载重装。