前言¶
DeepSeek Harness 的核心理念是「一切皆插件」。在使用 Agent 輔助工程研發時，開發者需要頻繁與 GitHub 進行交互，例如創建 PR、排查 CI 失敗或管理密鑰。傳統方式往往依賴手動在網頁端操作或配置明文 Token，不僅效率低，還存在安全隱患。
dsh-github-flow 是由 ItQianChen 維護的插件。它讓 DeepSeek Harness Agent 擁有操作 GitHub 的原生能力，通過原生複用宿主機的 gh CLI 安全登錄憑據，實現 PR/Issue/Actions 工作流治理、密鑰管理及全景工作臺，爲人機協作打造沉浸式 GitHub 工作環境。
安裝與前置要求¶
本插件依賴 GitHub CLI (gh) 進行認證，需先在宿主機安裝並登錄。
- 前置準備
安裝 GitHub CLI 並登錄：
# macOS
brew install gh
gh auth login
# Windows (PowerShell)
winget install --id GitHub.cli
gh auth login
- 安裝插件
在 DSH 終端根據環境選擇對應命令：
# DSH 桌面版
dsh plugin --profile desktop add dsh-github-flow
# DSH Web / CLI 環境
dsh plugin --profile web add dsh-github-flow
DSH 內置包管理器默認啓用了供應鏈安全策略。新版本發佈後的 24 小時內執行裸名安裝會自動回退至上一穩定版。若需立即安裝新版本，請顯式指定版本號（例如 `dsh-github-flow@0.3.0`）。
核心能力¶
該插件聚合爲 9 大領域核心工具，覆蓋 PR/Issue/Actions 工作流治理、密鑰與變量管理，並具備 Token 防溢出保護（默認 24KB 智能二分截斷）與高危操作二次確認機制。
PR 全生命週期管理¶
Agent 可以對 PR 進行創建、審查、合併、更新分支及衝突檢查等操作。
* 操作：支持列出 PR、查看詳情、獲取代碼差異、檢查 CI 門禁、創建 PR、合併（支持 squash/merge/rebase）、撤銷合併等。
* 特性：支持 Draft ↔ Ready 切換、創建反向提交、下載 PR 討論截圖。
CI 流水線排查與修復¶
用於定位 CI 構建失敗原因並輔助修復。
* 操作：支持查看 CI 運行歷史、精準提取失敗步驟日誌、重新觸發工作流、查看工作流清單與詳情、下載構建產物。
* 特性：提供 log_failed 等核心工具，幫助 Agent 快速診斷並定位問題代碼。
缺陷跟蹤與任務閉環¶
管理 Issue 的全生命週期。
* 操作：支持多條件檢索 Issue、創建與編輯 Issue、分配與鎖定、評論、關閉、物理刪除、跨倉庫遷移、從 Issue 一鍵切出開發分支。
* 特性：支持置頂、按分配人與提及狀態分段查看。
倉庫探索與跨庫檢索¶
無需 clone 倉庫即可進行探索。
* 操作：支持查看倉庫元數據、讀取 README、跨倉庫或全站搜索代碼/倉庫/Issue/PR。
* 特性：提供免 clone 讀取任意文件和目錄清單的能力，提升檢索效率。
底層 API 與發佈管理¶
- GitHub API：提供底層 REST/GraphQL 調用能力，支持
--jq過濾與自動翻頁。 - 版本發佈：支持查看、創建、上傳/下載構建資產到 Release，自動根據提交記錄生成發版說明。
CI/CD 密鑰與變量管理¶
安全地管理倉庫 Secrets 和 Actions 變量。
* 操作：支持查看密鑰/變量清單、設置/更新密鑰值、刪除密鑰。
* 特性：密文經子進程標準輸入傳遞，絕不暴露在命令行參數中；支持倉庫/組織/環境三級作用域。
Web UI 全景工作臺¶
內置沉浸式工作臺，提供 PR 門禁、CI 流水線、Issue 矩陣的全景視圖，無需在多個應用間切換。
典型用法¶
通過自然語言指令即可調用上述能力：
* PR 交互："幫我檢查當前倉庫有沒有需要我審查的 PR？"
* CI 修復："最近一次 Actions 工作流爲什麼掛了？提取失敗步驟日誌並幫我修復"
* Issue 管理："把剛纔復現的 Bug 提一個 Issue，打上 'bug' 和 'backend' 標籤"
* 代碼搜索："在當前倉庫搜索使用到 'createPrTool' 的代碼行"
* 版本發佈："給當前倉庫發佈 v0.2.0 版本，自動根據提交記錄生成發版說明"
* 密鑰更新："幫我把新的 NPM_TOKEN 更新到當前倉庫的 Secrets 裏"
注意事項¶
- 前置依賴：必須前置安裝並登錄 GitHub CLI (
gh)。 - 平臺支持：支持 macOS、Windows 和 Linux 平臺。
- 安全機制：高危操作（如刪除、合併、設置密鑰）需二次確認；Token 防溢出保護默認開啓。
- 兼容性：兼容 Cordis 框架。
總結¶
dsh-github-flow 解決了 Agent 在 GitHub 工作流中“看得見、進不去、改不動”的痛點。它通過複用 gh CLI 的安全憑據，提供了從代碼審查到 CI 修復、從 Issue 管理到密鑰維護的完整工具鏈，幫助開發者構建高效的沉浸式 GitHub 工作臺。
更多信息請參考：GitHub 倉庫
