前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在开发智能体时，如果需要频繁调用 GitHub API（如读取代码、创建 Issue、管理 PR），直接在 Prompt 中编写指令或通过代码实现会带来维护成本。dsh-github-toolkit 提供了一套现成的解决方案，通过 18 个预定义的工具函数封装 GitHub 操作，并通过 Web 界面管理敏感凭证。
插件简介¶
这是一个为 DeepSeek Harness 设计的 GitHub 工具插件，由开发者 QDchuan 维护。它包含 18 个面向 Agent 的 github_* 工具，以及一个 Web 设置页面。该插件的特点是将 PAT 存储在 DSH 的凭证存储中，而非硬编码在配置文件里，确保安全性且无需重启即可生效。
核心功能¶
- 18 个 Agent 工具：覆盖认证、仓库、文件、Issue、PR、搜索及 CI 检查等场景。
- Web 设置页：在浏览器界面中配置 PAT 和默认参数，无需终端操作。
- 凭证安全：Token 通过引用从 DSH 凭证存储解析，配置文件中不包含明文密钥。
- 读写权限控制：通过开关控制写工具的注册，避免 Agent 意外执行破坏性操作。
工具列表¶
插件提供以下 18 个工具，分为只读和写操作两类：
- 认证与状态：
github_auth_status - 仓库与文件：
github_get_repository,github_read_file,github_write_file - 搜索：
github_search - Issues：
github_list_issues,github_get_issue,github_create_issue,github_comment,github_update_issue - Pull Requests：
github_list_pull_requests,github_get_pull_request,github_create_pull_request,github_create_review - 代码与分支：
github_list_commits,github_list_branches,github_get_checks - 通用接口：
github_api
安装与启用¶
使用以下命令安装插件到 Web Profile：
dsh plugin --profile web add dsh-github-toolkit
安装完成后，刷新 Web UI，进入 Settings -> GitHub 页面。
配置流程¶
- 打开 Settings -> GitHub。
- 粘贴 GitHub Personal Access Token (PAT)。
- 点击 Test connection 验证令牌有效性（此时会直接调用 API 检查）。
- 点击 Save token 保存。
- （可选）设置默认的
owner和repository，或配置 API 地址、超时时间等。
注意事项¶
- 版本依赖：需要 DeepSeek Harness 0.1.5-rc.1 或更高版本，以及 Node.js 22+。
- 无运行依赖：插件无需构建步骤，宿主环境使用 Node 内置
fetch，浏览器端仅需react和静态 UI 原语。 - 错误提示：工具执行失败时会提示具体的修复方案（例如 401 提示轮换令牌，403 提示权限或 SAML SSO 问题，422 提示 GitHub 字段级错误）。
- 许可证：MIT License。
