DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。開發者常需要在本地搭建 Git 服務以配合工作流。dsh-git-server 插件將一套完整的自助 Git 服務裝進了 dsh,提供了 HTTP clone/push 以及工單、PR、wiki 等功能,且全程使用 dsh 原生界面。
核心功能¶
- 完整自助 Git 服務:支持 HTTP clone/push,涵蓋倉庫、工單、PR、wiki、發版、標籤、里程碑、webhook。
- dsh 原生管理頁:側欄底部「Git」入口進入全屏頁,支持建倉、刪倉、克隆地址管理。倉庫瀏覽支持多標籤,包含文件樹+語法高亮、提交歷史、分支、工單、PR、Wiki、發版、標籤、里程碑、設置。界面基於 React + dsh 主題,支持中英雙語。
- 協作閉環:提供通知中心(評論、指派、@提及未讀)、跨倉庫「我的工單/PR」聚合、PR 評審、
fixes #Npush 自動關單、提交與工單互相跳轉。 - 工程能力:支持分支保護(禁刪/禁強推)、協作者權限分檔(只讀/可寫/管理)、發版二進制附件、倉庫內代碼搜索、webhook 測試投遞與投遞記錄、文件永久鏈接深鏈。
- 賬號打通:賬戶來源依賴
user-management插件(必須先安裝)。Git 憑據與頁面登錄均走 user-management 校驗,網頁註冊關閉,賬號僅由 dsh 管理。 - 一鍵啓停與數據:啓用/停用/端口/數據目錄在設置頁配置,改完即生效。默認監聽
0.0.0.0,支持局域網訪問。數據目錄包含倉庫、數據庫和日誌,備份該目錄即備份全部數據。
安裝與啓用¶
本插件依賴 user-management 插件提供登錄與賬戶,安裝前請確保已安裝該插件:
dsh plugin --profile web add @weibaohui/user-management -w
dsh plugin --profile web add @weibaohui/dsh-git-server -w
安裝完成後,重啓 dsh web 即可生效。
典型用法¶
- 打開 Web UI → 設置 → Git 服務器。默認已啓用,監聽
0.0.0.0:3400。如需停用,可在設置頁取消勾選。此處亦可修改端口、數據目錄或查看root密碼。 - 側欄底部點擊「Git」進入全屏管理頁,在此處新建倉庫(或從 URL 導入/鏡像倉庫)。
- 使用 Git 命令操作倉庫:
git clone http://127.0.0.1:3400/root/drill-repo.git
cd drill-repo
git checkout -b feature
# ... 進行開發 ...
git push origin feature
Git 憑據使用 `user-management` 中註冊的用戶名和密碼。
- 倉庫瀏覽、工單、PR、wiki、發版、標籤、里程碑等日常操作,全部在原生管理頁完成。
注意事項¶
- 本插件依賴
user-management插件,必須先安裝。 - 賬號僅由 dsh 管理。
- Git 憑據與頁面登錄均走 user-management 校驗。
總結¶
通過這個插件,開發者可以在 DSH 生態中直接獲得一個功能完備的 Git 服務,無需額外維護複雜的服務器配置。所有操作均可通過 dsh 原生界面完成,實現了從開發到協作的閉環。