前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在智能體開發與代碼協作的工作流中,開發者常在 DSH 對話窗口與 GitHub 倉庫之間頻繁切換。dsh-github-workbench 旨在解決這一問題,將 GitHub 的核心工作臺集成到 DSH 的側邊欄中,提供與瀏覽器體驗接近的交互,同時保持 DSH 工作流的連貫性。
介紹¶
該插件由 meyaomiao 維護,目前 GitHub 倉庫獲得 3 星。它主要解決開發者在 DSH 內無法直接操作 GitHub 倉庫的問題,提供倉庫目錄樹、Issues/PR/Actions 頁籤,並支持建 Issue、發 PR、評論、合併以及重跑 CI。
核心能力¶
掛載形態¶
插件支持雙形態掛載,運行時自動協商:
* 頁籤:若安裝了 dsh-better-sidebar,插件優先註冊爲側邊欄頁籤(DSH 0.3.x)。
* 獨立面板:若未安裝 dsh-better-sidebar,自動降級爲對話區右側可展開/收起的自繪面板。
代碼瀏覽¶
- 目錄樹:支持
git/trees?recursive=1遞歸拉取倉庫結構。 - 文件預覽:文本文件支持行號預覽,限制 <900KB;二進制或超大文件降級爲 GitHub 外鏈。
- 響應式:容器寬度 <600px 時,目錄樹自動收進“目錄”抽屜。
Issues / PR 管理¶
- 列表:支持搜索、排序(默認按最新創建,可切最近更新)、翻頁。PR 拆分爲開放、已關閉(未合併)、已合併。
- 寫操作:支持新建 Issue/PR、評論、編輯標題正文、編輯/刪除評論、關閉/重開。
- 合併:支持 merge / squash / rebase 三種合併方式,執行前有強確認彈窗。
- CI 控制:Actions runs 列表顯示實時狀態圖標。懸停可觸發重跑或取消(取消需確認),點擊直達原 run 頁。
倉庫切換與搜索¶
- 倉庫切換器:打開即列出 Token 可見倉庫(含 owner/協作/組織,過濾 archived,按推送排序)。支持輸入實時過濾。
- 公開搜索:輸入 ≥3 字符去抖觸發公開倉庫搜索,支持按 ⭐ 排序。
- 本地管理:可移除他人的倉庫(本地隱藏),在管理頁可恢復。
收件箱¶
- 提供 Issues / PR / Actions 三分欄視圖。
- Issues/PR 監視 Token 可見公開倉的新建單;Actions 僅盯當前倉 + 最近最多 5 個公開倉。
- 點行跳轉對應頁籤,“返回原倉頁”回到進箱前。未讀狀態顯示在頭部數字、側欄 tab 角標及獨立豎條。
鏈接接管與瀏覽器直達¶
- 鏈接接管:在設置中開啓“接管聊天中的 GitHub 鏈接”後,對話中的
github.com鏈接點擊即在工作臺打開,自動切倉並落到對應詳情頁。 - 瀏覽器直達:工具欄提供一鍵在系統瀏覽器打開當前倉庫的入口。
原生觀感¶
- 使用 16px Octicon 風格 SVG 圖標集。
- 顏色消費宿主
--dsw-*設計令牌,自動跟隨深淺主題與皮膚。 - 字號默認跟隨 DSH 側邊欄(12px),設置中可調 13/14。
安裝與啓用¶
安裝¶
使用官方 CLI 安裝:
dsh plugin --profile web add dsh-github-workbench
也可通過 npm 安裝:
npm i -g dsh-github-workbench
# 或
pnpm add -g dsh-github-workbench
或直接從 GitHub 裝載:
dsh plugin --profile web add github:meyaomiao/dsh-github-workbench
本地掛載方式(需 git clone 後 pnpm install/build):
git clone https://github.com/meyaomiao/dsh-github-workbench.git
cd dsh-github-workbench && pnpm install && pnpm build
dsh plugin --profile web add .
啓用¶
安裝完成後,需要在配置文件中啓用該插件。
- 編輯
~/.dsh/profiles/web/cordis.patch.yml文件。 - 添加以下內容:
# cordis.patch.yml 示例
- insert:
- id: github-workbench
name: 'dsh-github-workbench'
- 重啓 DSH Web 進程,並執行瀏覽器硬刷新。
注意事項與兼容性¶
Token 與隱私¶
- Token 僅存瀏覽器
localStorage或宿主pluginSettings,不上傳服務端,不進會話上下文。 - 權限要求:細粒度 Token 需 Contents R · Issues RW · Pull requests RW · Actions RW。經典 Token 需
repo,改 workflow 需另加workflow。 - 匿名訪問:無 Token 可瀏覽公開倉,匿名限制 60 次/h,不可寫。頁腳實時顯示 core 限額剩餘。
兼容性¶
- 0.3.x(當前主線):優先註冊 DSH 官方原生右側欄。兼容 DSH 0.1.5-rc.1 / 0.1.5-rc.2 及之後的 0.1.5 線。
- 0.2.x:僅維護態,修復 bug。兼容 DSH ≤ 0.1.2-rc.1。
- 已知問題:在 DSH 0.1.2 + better-sidebar 環境下,0.3.x 的頁籤會退化成獨立面板。若需舊頁籤形態,請使用 0.2.x。
依賴要求¶
- better-sidebar:聊天鏈接接管功能需要
better-sidebarv0.13+。 - 合併/刪評/取消 CI:上述操作均有確認彈窗。
總結¶
dsh-github-workbench 通過側邊欄掛載,爲 DSH 用戶提供了接近原生 IDE 或瀏覽器體驗的 GitHub 訪問方式。它不僅解決了頻繁切換窗口的痛點,還通過全量的列表管理和直接操作能力,提升了代碼審查與 CI 流程的效率。
- 倉庫地址:https://github.com/meyaomiao/dsh-github-workbench
- 目錄頁:https://www.skillhub.cn/plugins/meyaomiao/dsh-github-workbench