前言¶
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。
