DSH GitHub Login —— 独立的 GitHub 可视化登录插件

一个零终端的 GitHub 登录小工具：打开窗口 → 生成设备码 → 浏览器输码授权 → 完成。 设备码流程在窗口内（Chromium 网络栈）执行，与你的浏览器共用同一网络通道—— 浏览器能打开 GitHub，这里就能完成登录，不受终端/代理配置差异影响。

• 登录成功后令牌保存在 ~/.dsh/github-auth.json；
• 同时同步进 gh CLI 的 ~/.config/gh/hosts.yml，gh 命令行立即可用（keyring 存在时 gh 以 keyring 优先）；
• 托盘常驻：随时查看账号状态 / 一键退出登录；
• 复用 GitHub CLI 的公开 OAuth client_id（178c6fc778ccc68e1d6a），权限范围 repo workflow gist read:org。

用法

npm install        # 安装 electron（已配置国内镜像）
npm start          # 直接运行
npm run dist       # 打包为便携版单文件 exe（dist/DSH-GitHub-Login.exe）

集成到其他应用（如桌面客户端）

把它当作一个独立进程调用即可：登录状态通过同一份文件（~/.dsh/github-auth.json） 共享，任何 DSH 生态工具都能读取：

spawn('<path>/DSH-GitHub-Login.exe', [], { windowsHide: false })

之后用 gh auth status 或直接读取 ~/.dsh/github-auth.json 验证登录状态。

原理

GitHub Device Flow：

1. POST https://github.com/login/device/code → user_code + device_code
2. 浏览器打开 https://github.com/login/device，输入 user_code 授权
3. 按 GitHub 给出的 interval 轮询 POST https://github.com/login/oauth/access_token
4. 拿到 access_token → 主进程落盘 + 写入 gh 配置

轮询严格遵循服务器间隔；网络抖动不中断（验证码 15 分钟有效期）；授权成功 即完成，用户名查询是尽力而为的补充。

与桌面端的关系

本仓库只包含登录插件本身，不包含任何桌面客户端代码。桌面客户端可在本地 集成它（见上）；两者通过令牌文件共享登录状态。

帮助 / Help

遇到问题先看这里；仍有疑问请到 Issues 提问。

• 一直"等待授权"：轮询与浏览器共用同一网络通道，浏览器能打开 GitHub 就一定能完成； 提示行会显示轮询次数，卡住时把提示文字发到 Issue。
• 显示 unknown：授权已成功、令牌已保存，只是用户名查询失败；重启程序后状态页会重试。
• gh 仍显示未登录：本工具写入 ~/.config/gh/hosts.yml；若系统 keyring 里有旧凭证， gh 会优先用 keyring——先 gh auth logout 清掉旧凭证即可。
• 如何退出登录：托盘菜单 GitHub: <账号> (click to log out)，或窗口中点"退出登录"。

License

MIT