在 DeepSeek Harness (DSH) 開發或代碼審查場景中，頻繁查看分支狀態、未提交的更改和 PR 詳情會打斷對話流。dsh-project-summary 插件通過在對話窗口右上角提供懸浮概要解決此問題。它不佔用整列，不替換現有右側欄，而是作爲一個輕量級面板顯示分支、變更、提交和 PR 信息。
插件概況¶
- 插件名稱：
dsh-project-summary - 所有者：callqh
- 分類：客戶端
- 許可證：MIT
核心功能¶
該插件提供以下信息展示與交互能力：
-
項目與分支信息
顯示倉庫名稱、當前分支、游離 HEAD，以及相對於本地 upstream 的領先/落後提交數。 -
工作區變更
顯示修改文件數、增加/刪除的行數。點擊“變更”可打開只讀的 diff 預覽。 -
GitHub 拉取請求
顯示當前分支關聯的 PR 標題、編號、狀態、目標分支和外鏈。在多個匹配結果中優先顯示開放 PR。 -
最近提交
顯示最近三條提交的短 hash、說明、作者和日期。 -
懸浮與佈局
展開寬度約 296px，可收起。插件會記住收起狀態，窄屏初次打開時默認收起。概要定位在對話區域，不覆蓋右側工具欄，並自動跟隨 DSH 的深淺主題。 -
自動刷新
展開時每 15 秒查詢本地 Git；PR 緩存 60 秒；頁面不可見時暫停讀取。 -
只讀與降級
插件不執行提交、推送、切分支或初始化倉庫。當沒有 Git 倉庫、沒有 PR 或 GitHub CLI (gh) 不可用時，會顯示相應提示。
安裝與啓用¶
插件通過 GitHub Release 的 tarball 安裝。請在 DSH 中向 Agent 發送以下命令：
請用 plugin_manager 安裝並啓用這個插件 bundle：
https://github.com/callqh/dsh-project-summary/releases/download/v0.1.1/dsh-project-summary-0.1.1.tgz
安裝後，打開使用 Git 倉庫目錄的主會話即可看到概要。
前置條件與依賴¶
- DSH 版本：初始適配版本爲 DSH
0.2.0-rc.2。 - GitHub CLI：若要顯示 PR 信息，需在 DSH Host 環境中安裝 GitHub CLI (
gh) 並登錄。插件僅查詢origin指向的 GitHub.com 倉庫。
安全與注意事項¶
- 只讀操作：插件僅進行只讀的 Git 查詢，不執行任何寫入操作。
- 憑據使用：安裝意味着信任 Host 插件讀取項目並使用現有的
gh憑據進行聯網查詢，但這不代表爲不可信倉庫提供了沙箱隔離。 - 隱私：無遙測、獨立數據庫或憑據存儲；瀏覽器只傳會話 ID。
- 兼容性：npm registry 暫未發佈，請使用 GitHub Release tarball。
此插件爲 DSH 提供了一種無需切換窗口即可監控 Git 狀態的方式。更多細節可查看 GitHub 倉庫 或 社區目錄。
