dsh-github-auth

0.3.0：首次使用引导

• 「准备工具 → 登录账号 → 开始使用」分步引导，已有账号保持直接进入概览。
• 缺少 gh 时一键下载 GitHub CLI 官方稳定版，按操作系统与架构选择安装包，校验官方 SHA-256 清单后解压并检查版本。
• 安装到当前用户的 ~/.local/bin/gh（Windows 为 gh.exe）；不安装包管理器、不需要管理员权限，不修改 PATH，也不覆盖已有文件。
• 准备过程显示进度，可取消、重试；缺少系统解压工具或网络不可用时提供官方手动安装入口。
• 已手动安装后点击「我已安装，重新检测」即可识别，无需重启 DSH。
• 支持 macOS、Linux、Windows 的 x64 / ARM64 官方便携包；本机实际验证 macOS ARM64 下载至隔离目录的完整链路。
• 36 项测试覆盖安装、取消、重复请求、校验与首次使用界面。

使用

将插件加入 DSH profile，然后在插件页面准备工具并登录。宿主使用 Node 18 或更新版本，无额外运行时 npm 依赖。

dsh plugin --profile desktop add github:oliblue-evan/dsh-github-auth

打开「插件 → GitHub 授权」即可使用；「设置 → GitHub 授权」提供相同界面。

首次使用：缺少工具时点击「一键准备工具」，下载完成后直接点击「连接 GitHub 账号」。工具已安装会跳过准备步骤；有现有账号则直接显示概览。

登录：阅读权限说明后开始网页登录，输入一次性代码，在 GitHub 页面确认账号和权限。完成后自动显示账号。

手动安装：展开备用安装说明，按 GitHub CLI 官方说明 安装，再点击「我已安装，重新检测」。在插件运行时安装工具也无需重启。Windows 等环境若终端尚未包含用户工具目录，其他程序需通过完整路径调用 gh；插件能直接找到它。

本机退出仅移除 gh 登录配置与该账号的本机存储凭据。GitHub 远端令牌和 SSH 密钥需要在官方页面单独管理。环境变量 GH_TOKEN / GITHUB_TOKEN 优先控制授权时，本机账号变更功能禁用，需在原启动环境管理变量。