前言¶
在 DeepSeek Harness（DSH）环境中开发智能体时，读取 GitHub 上的代码、Issue 或 PR 是常见需求。直接在沙箱中通过 Shell 调用 gh CLI 或 curl 往往受限于 TLS 证书或代理配置，容易导致请求失败或消耗不必要的 Token。
dsh-github-router 插件旨在解决这个问题。它将 GitHub 的访问逻辑封装在插件内部，提供了一套结构化的工具，让 Agent 可以通过简单的参数调用获取数据，而无需处理底层的网络异常。
插件简介¶
这是一个 DeepSeek Harness 插件，用于为智能体提供只读的 GitHub 访问能力。它由 AngelosZou 维护，目前开源。
核心定位： 代理工具集，解决沙箱环境下的 GitHub 网络访问问题。
许可协议： MIT
核心价值： 将 API 调用、gh CLI 命令、Git 协议、网页 HTML 抓取等多种路由方式统一在工具内部处理，确保访问稳定。
核心功能¶
插件提供以下工具和路由机制：
工具集
- github_probe：探测当前主机可用的 GitHub 访问路由及其性能。
- github_pr：获取 PR 的完整信息，包括元数据、讨论、审查、提交和变更文件。
- github_issue：获取 Issue 的元数据、正文、标签和评论。
- github_file：获取指定分支或标签下的文件内容或目录列表。
- github_api：提供 GET 请求的逃逸接口，用于调用任意 GitHub API 端点。
路由机制
插件支持在工具内部进行路由选择，包括：
- API (api.github.com)
- gh CLI
- Git 协议
- 网页 HTML
- 镜像站
此外，还包含 github-router 技能，用于管理这些路由逻辑。
安装与启用¶
在安装前，请确保环境满足依赖要求：Node.js >= 22.19。
使用官方安装命令添加插件：
dsh plugin --profile web add dsh-github-router
安装完成后，重启 DSH 后端，即可在 Agent 的工具列表中看到 github_probe、github_pr、github_issue、github_file、github_api 以及 github-router 技能。
典型用法¶
以下是该插件提供的具体调用示例：
# 探测当前可用的路由
github_probe
# 获取指定 PR 的完整信息
github_pr { owner: "o", repo: "r", number: 12 }
# 获取 PR 信息，并指定本地仓库路径以读取提交和差异
github_pr { owner: "o", repo: "r", number: 12, localRepo: "C:/src/r" }
# 获取指定 Issue
github_issue { owner: "o", repo: "r", number: 34 }
# 获取指定分支下的文件内容
github_file { owner: "o", repo: "r", path: "src/index.js", ref: "main" }
# 调用 GitHub API
github_api { path: "/repos/o/r/commits", query: { per_page: 5 } }
注意事项与适用场景¶
功能限制
- 该插件仅提供只读能力，不包含任何写操作、推送或评论功能。
- 代码托管在 <DSH_HOME>/storages/dsh-github-router/ 下，本地克隆的仓库仅通过只读命令（如 git log、diff、show）访问，不会修改用户仓库。
网络与配置
- 匿名 API 使用受到 IP 限制（每小时 60 次）。建议配置 GitHub Token 以提升限额。
- 镜像站功能默认关闭，仅在用户明确配置后启用。
- 插件提供框架声明的设置页面，可配置 Token、代理、超时时间、缓存策略等。
适用对象
- 需要在 DSH 环境中稳定获取 GitHub 代码或数据的开发者。
- 受限于代理或 TLS 配置，无法直接在 Agent Shell 中访问 GitHub 的场景。
总结¶
dsh-github-router 通过将复杂的网络路由逻辑封装在工具内部，为 DeepSeek Harness Agent 提供了稳定、结构化的 GitHub 读取能力。如果你需要让智能体自动分析代码仓库或 Issue，这是一个可以直接集成的解决方案。
