前言¶

在 DSH 裏寫代碼、跑任務時，經常遇到的一個麻煩是：GitHub 上的情況不在視野裏。想知道某個倉庫的 description 是不是還空着、CI 有沒有開、最近有沒有 fork 忘了清理，得切回瀏覽器或者終端裏敲 gh。切換次數多了，上下文就斷了。

dsh-github-panel 把這件事收進側面的 GitHub 圖標裏：它調用你已經登錄在本機上的 GitHub CLI（gh），把連接狀態、倉庫統計、待辦清單和可以安全執行的元數據修改，彙總到一頁。不需要粘貼 token，不需要 API key，也不需要再登錄一次——登錄態在 gh 和系統鑰匙串裏。

這個插件由 zayyehtut 維護，分類是聯網工具，屬於社區提交的目錄項目。下面按「是什麼、有什麼能力、怎麼裝、怎麼用、有什麼限制」幾塊介紹。

這是什麼¶

一句話定位：一個 DSH 插件，在 Web UI 左側欄加一個 GitHub 面板，讀取並操作「當前這臺 PC 上已經登錄的那個 GitHub 賬號」。

它解決的痛點有兩個：一是不用離開 Harness 就能覈對賬號和倉庫狀態；二是倉庫管理動作（改描述、加 topics、歸檔、改名）可以直接在面板裏做，不用打開網站找入口。

核心功能¶

README 裏列出的能力如下，按頁面分區描述。

1、連接狀態一眼可見。面板顯示 Connected as @you，走的是哪個賬號、token 有哪些 scope，由 GitHub 報告後顯示。

2、倉庫統計。總數、公開數、私有數、已歸檔數，以及有多少倉庫寫了 description、有多少寫了 topics。

3、Needs attention 清單。缺 description 或 topics 的倉庫、空倉庫、不再使用的 fork、profile README、空 bio、用不上的 pinned 倉庫、重複的 gist，都歸到這一欄，作爲動手的起點。

4、可搜索的倉庫列表。可以按條件篩選，然後在行內編輯 description 或 topics、歸檔或取消歸檔、改名，或者直接在 GitHub 上打開該倉庫。

5、Profile 與 pins 說明。README 明確列出 GitHub API 能改什麼、不能改什麼，不能改的給鏈接跳到對應的 GitHub 設置頁面。

6、健康報告。按倉庫檢查 README、License、.gitignore、CI、測試和疑似密鑰，並給出可以一鍵執行的安全修復。

安裝與啓用¶

有三條安裝路徑，按你的使用環境選一條。

方式一：DeepSeek Harness 應用裏直接裝，README 稱之爲最簡單。

github:zayyehtut/dsh-github-panel

在左側邊欄打開 Plugins，點 Add plugin，把上面這串填進 package 字段，然後點 Install，再點 Enable now。如果 GitHub 圖標沒有立刻出現，重載一次窗口。

方式二：用命令行，通過 dsh web 安裝。官方命令如下，裝完需要重啓 dsh web；如果你用的是自定義 profile，把 web 換成你的 profile 名。

dsh plugin --profile web add github:zayyehtut/dsh-github-panel

方式三：走社區目錄 dsh-market。插件已經提交到該目錄，等它出現後搜索 GitHub panel 即可一鍵安裝。

README 還給出了一條提醒：如果用的是桌面版 DeepSeek Harness，請用方式一。桌面版管理自己的 profile，通過命令行裝到 profiles/web 的東西不會顯示在桌面版裏。

安裝前需要滿足三個條件，README 用表格列了出來：

1、DeepSeek Harness 0.2.1 或更高版本（README 在 0.2.1-rc.5 上測試過）。

2、本機已安裝 GitHub CLI。

3、已經通過 CLI 登錄 GitHub。

自查命令分別是 dsh --version、gh --version、gh auth status。

典型用法¶

安裝啓用後第一次運行，流程是固定的。

1、點左側邊欄（Plugins 和 Automation tasks 旁邊）的 GitHub 圖標。

2、面板顯示連接賬號和倉庫計數。

3、如果提示未連接：在終端裏跑 gh auth login，回到面板點 Re-check。

4、用倉庫列表上方的篩選條件縮小範圍，從 Needs attention 清單開始處理。

改 description 或 topics 這類動作，面板會先從 GitHub 重新讀一遍倉庫狀態，並校驗要寫入的內容，然後才提交。改完之後可以在列表裏直接看到結果。

排查問題時，README 給了一張症狀表，摘幾條常用的：

1、圖標不見了 —— 到 Plugins 頁面確認 bundle 已啓用，重載窗口，確認 DSH 是 0.2.1 或更高版本。

2、提示 “Not connected on this PC” —— 跑 gh auth login，用 gh auth status 確認，再點 Re-check。

3、賬號顯示不對 —— 用 gh auth switch（或對正確賬號跑 gh auth login），再點 Re-check。

4、一直停在 “Loading your GitHub account…” —— 檢查網絡能否訪問 GitHub API，並在終端裏確認 gh api user 能跑通。

5、沙箱主機裏找不到 gh —— 把 DSH_GITHUB_CONFIG_DIR 設置爲存放 gh 配置的目錄，或者確認 PATH 上的 gh 屬於運行 Harness 的那個用戶。

6、改動報 permission 錯誤 —— token 需要 repo scope，並且你對目標倉庫有 admin 權限。

安全與隱私¶

這段值得單獨看，因爲面板有讀寫能力。README 的說法如下：

• 面板由你自己的 Harness 進程提供服務，只監聽 127.0.0.1。
• 面板從不讀取 token，只負責啓動 gh；登錄憑據在操作系統的 keyring 裏，由 gh 自己持有。
• 面板不向磁盤寫任何東西，操作日誌只存在內存裏，Harness 重啓後即消失。
• 不提供刪除倉庫的功能。pinned 倉庫和 profile 名稱 / bio 走外鏈，因爲 GitHub API 對這兩類沒有寫權限。

適用場景與注意¶

適合下面這些情況：GitHub 賬號下倉庫數量多到不好憑記憶維護，希望在一個頁面裏看到「哪些倉庫需要補描述、哪些已經沒用了」；或者希望改 description、topics、歸檔狀態時不用去網站找入口。

幾條限制需要提前知道：

1、README 明確寫着 “This project is not actively maintained”：issue 不會被分診，沒有響應時間承諾。壞了或者要改，README 建議的做法是指派給你的 AI agent，讓它診斷並修補你自己的副本或 fork；上游 PR 可能一直沒有人 review。

2、本體是純 ESM JavaScript，沒有構建步驟，index.js 是宿主側（loopback 路由、啓動 gh），client.js 是客戶端側（側欄圖標和麪板 UI），另有 cordis.patch.yml 用於插入插件行。

3、平臺方面，README 說在 Windows 10/11 上測試過；macOS 和 Linux 走 PATH 上的 gh，未做測試。

4、package.json 裏標記了 "private": true，因此不要直接把它當作可發佈的 npm 包引用；如果你打算長期使用，建議 clone 倉庫後自行維護一份副本，README 也給了開發用的手動掛載配置（在 profile 的 package.json 里加 link: 依賴並放進 bundle 列表）。

5、插件以當前 DSH 進程的權限運行。安裝之前，建議先讀一遍源碼、確認 index.js 和 client.js 的行爲與你的倉庫權限相符，再決定是否啓用寫操作（改 description、topics、歸檔、改名）。許可證是 MIT。

結尾¶

dsh-github-panel 的價值在於把「GitHub 狀態覈對」和「倉庫元數據維護」這兩件事收斂到一個面板裏，且不引入新的登錄態。它不追求功能多，接口和權限邊界都寫在 README 裏，是否採用取決於你對 gh 已有登錄的依賴程度。

目錄頁：https://www.skillhub.cn/plugins/zayyehtut/dsh-github-panel

GitHub：https://github.com/zayyehtut/dsh-github-panel