前言¶
DeepSeek Harness (DSH) 的核心理念之一是「一切皆插件」。在本地開發或構建智能體工作流時，開發者往往需要處理 Git 變更、管理分支、瀏覽代碼、跟蹤計劃，並連接 GitHub 進行協作。這些操作通常分散在不同的插件面板中，增加了上下文切換的負擔。dsh-git-nexus 插件旨在解決這一問題，它將 SCM 變更管理、分支操作、GitHub 認證、Workflow 板以及文件瀏覽功能合併爲一個獨立的 Web 面板。
插件介紹¶
dsh-git-nexus 是一個由 JFWaskin 維護、基於 MIT 許可證的開源社區插件。它將原本可能需要多個插件才能完成的 Git 管理（SCM 變更面板 + 分支管理）與 GitHub 訪問權限、Workflow 跟蹤板和文件瀏覽功能整合進一個自包含的 Web 插件中。
核心功能¶
該插件提供以下已覈實的能力：
- SCM 變更管理：查看工作區狀態、逐文件 Diff、暫存/取消暫存/丟棄變更、提交。
- 分支操作：列表、切換、創建、刪除。
- 遠程同步：支持 Push、Pull、Sync（先 Pull 後 Push）以及 Fetch。
- 提交日誌：提供帶邊界限制的結構化提交歷史。
- 文件瀏覽：列出跟蹤文件並支持搜索，可讀取任意文本文件。
- Workflow 板：提供持久化的步驟板（Claude Code 風格的計劃跟蹤）。
- GitHub 集成：使用 OAuth Device Flow 登錄（獲取全量
repo權限，權限可撤銷），支持 Scope Seal，並能創建 PR。
安裝與啓用¶
安裝該插件需要將本地路徑掛載到 DSH。
dsh plugin --profile web add "file:/absolute/path/to/dsh-git-nexus"
安裝完成後，重啓 Web Profile 以加載插件：
dsh web
插件會出現在 Settings → Plugins 中，在 Git 管理的工作區會話頭部顯示對應的面板膠囊。
典型用法¶
在 Web 面板中配置 GitHub 集成：
- 點擊面板中的 GitHub 標籤頁，點擊 Connect。
- 在 GitHub 網站上，進入 Settings → Developer settings → OAuth Apps → New OAuth App。
- 填寫應用名稱、主頁和回調 URL（Device Flow 忽略回調設置，可隨意填寫）。
- 複製生成的 Client ID，粘貼到插件面板的輸入框中。
- 返回插件面板，點擊 Connect 後，打開終端打印的 URL 並輸入用戶代碼完成授權。
適用場景與注意¶
該插件針對 DSH 0.1.0-rc.6 的 Web Profile 開發。作爲發佈在 dsh-plugin 話題下的社區插件，使用前請確認其源碼與許可證。
安全與執行細節：
* GitHub 認證使用 OAuth Device Flow，不會在磁盤上寫入長期有效的 Personal Access Token (PAT)。
* 每一個 Git 或文件命令均通過獨立的 /bin/sh -c 子進程執行，帶有 30 秒超時和 2MB 輸出限制。
* 分支名、路徑和提交消息經過 Shell 轉義，拒絕控制字符。
* GitHub Token 僅存儲在 ~/.dsh/storages/dsh-git-nexus/settings.json，權限爲 0600。
結語¶
dsh-git-nexus 通過單面板整合了 Git 全生命週期管理、GitHub 操作和 Workflow 跟蹤，適合需要在 DSH Web 界面中保持上下文連貫的開發者。更多細節可參考項目目錄或 GitHub 倉庫。
