GitHub 账号关联 qichuang321/dsh-github-link

GitHub 账号关联

把当前 DeepSeek 账号与本机 GitHub 身份关联，并给智能体一个受控的 github 工具：读取仓库、查看 Issue、创建 Issue、发表评论。

安装

dsh plugin --profile web add github:qichuang321/dsh-github-link

安装后重启/刷新 DSH Web UI，打开 设置 → GitHub 账号。仓库是纯 JavaScript，无需构建步骤。

它做了什么，没做什么

- 绑定记录保存在本机 DSH 的 credentials 服务里，按当前 DeepSeek 账号 ID 隔离。
- 不会修改 DeepSeek 官方账号资料，也不会把 GitHub token 发给浏览器。
- gh-cli 方式不复制 token：每次操作时通过 gh auth token 读取本机 CLI 登录，因此撤销/轮换 CLI 登录即可失效。
- 智能体只能调用插件暴露的仓库与 Issue 操作，不能推送代码。

三种关联方式

1. 本机 GitHub CLI（推荐，最接近“自动关联”）

插件会检测 gh auth status。如果本机已经执行过：

gh auth login

打开 设置 → GitHub 账号，点击「一键关联」即可。无需创建 OAuth App，也不会把 token 存进 DSH。

插件配置里已有 autoLinkGhCli 开关。本机这份配置为 true：启动时如果还没有绑定，会自动复用 GitHub CLI 登录完成关联。若不想自动关联，把它改成 false；在设置页点「解除关联」也会写入一个 opt-out，直到下次手动关联前都不会再自动关联。

2. Personal Access Token

在 GitHub 创建 token（推荐 fine-grained，只授权需要的仓库），粘贴到设置页。Token 会写入 DSH credentials，不写入 localStorage。

3. OAuth App 设备授权

1. GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
2. 勾选 Enable Device Flow
3. 把 Client ID 填到插件配置：

- id: github-account-link
name: 'dsh-github-link'
config:
clientId: 'Iv1.xxxxxxxxxxxx'
scopes: 'read:user public_repo'

这是没有 Client Secret 的设备流；适合不想使用本机 CLI 的场景。

配置

| 字段 | 默认值 | 说明 |
| clientId | 空 | OAuth App Client ID；为空时设备授权按钮不可用。 |
| scopes | read:user public_repo | 设备授权请求的 scope。本机 CLI 方式使用 gh 已有 scope。 |
| allowMutations | true | 是否允许智能体创建 Issue / 评论。 |
| autoLinkGhCli | 代码默认 false；本机配置为 true | 启动时若已登录 CLI 且没有绑定，是否自动关联。解除关联会 opt-out。 |

智能体工具

工具名：github

| action | 作用 |
| status | 查看 DeepSeek / GitHub 关联状态，不需要已关联。 |
| list_repos | 列出当前 GitHub 账号可见的仓库。 |
| list_issues | 读取 owner/name 的 Issue / PR。 |
| create_issue | 创建 Issue，需要 title。 |
| comment_issue | 评论 Issue / PR，需要 number 和 body。 |

示例：

列出我的 GitHub 仓库查看 qichuang321/dsh-plugin-browser 的 open issues 在 owner/repo 创建一个 issue，标题是“...”，正文是“...”

安全与排查

- 解除关联会删除 DSH 内的记录并停止自动关联，不会退出 GitHub CLI，也不会自动吊销 GitHub 上的 token。
- 如果 GitHub CLI 切换了账号，旧绑定会显示为不可用；重新关联即可。
- 如果提示 401，说明 token 已失效；重新关联。
- 如果提示 403 / rate limit，查看 GitHub API 速率限制后重试。
- 如果设置页显示 404，确认插件已安装且 DSH Web 已重新加载。

验证

安装后：

1. 设置 → GitHub 账号 能看到页面。
2. 若本机 gh 已登录，点击「一键关联」后显示 GitHub 用户名和 scope。
3. 在对话中让智能体调用 github 工具执行 status 或 list_repos。

文件

- index.js：Host 入口，注册路由与智能体工具。
- host/service.js：绑定、凭据、账号隔离与操作编排。
- host/github-api.js：GitHub REST / Device Flow 客户端。
- host/gh-cli.js：本机 GitHub CLI 检测与 token 读取。
- client.js：设置页 UI。