前言¶
如果你在用 DeepSeek Harness(DSH)的 web 客戶端,下面這些操作大概不陌生:配置 MCP 服務器要手動編輯 $DSH_HOME/profiles/web/cordis.patch.yml,增刪 Skill 要直接改 $DSH_HOME/skills 下的 Markdown 文件,想確認當前會話跑在哪個 git 分支上還得切回終端。
這些事情本身不難,但散落在客戶端之外,來回切換成本不低。dsh-toolkit 要解決的就是這個問題:把 MCP 管理、Skill 管理和 Git 分支徽章三個功能打包成一個插件工具包,一條命令安裝,裝完即用。
這是什麼¶
dsh-toolkit 是一個 DSH 插件工具包(bundle),由 LongSir0419 維護,採用 MIT 協議,代碼託管在 GitHub(LongSir0419/dsh-toolkit)。npm 包名爲 @wanghailong0419/dsh-toolkit,package.json 中標註版本 0.1.10。
它本身不實現單個功能,而是把三個獨立插件捆綁在一起:
| 捆綁的包 | 版本約束 | 入口 |
|---|---|---|
@wanghailong0419/dsh-mcp-manager |
^0.1.3 | Settings → MCP Manager |
@wanghailong0419/dsh-skill-manager |
^0.1.4 | Settings → Skill Manager |
@wanghailong0419/dsh-git-branch-manage |
^0.1.3 | 會話頭部 → 分支徽章 |
安裝完成後,設置頁會自動多出 MCP Manager 和 Skill Manager 兩個區塊,會話頭部和新會話歡迎頁會多出 Git 分支徽章。
核心功能¶
MCP 管理¶
入口在 Settings → MCP Manager。先看列表概覽:每個 MCP 服務器一行,顯示連接狀態(綠點)和已註冊的工具數。點擊任意一行可以展開詳情,包括服務器名、模塊和配置 JSON,再點一次收起(輸入框和按鈕不觸發展開/收起)。
增刪改都在列表內聯完成:添加、編輯、刪除、重命名、啓用/禁用均可直接操作,配置寫入 $DSH_HOME/profiles/web/cordis.patch.yml。
另外兩個值得注意的設計:
1、連接測試。插件會做一次獨立的 MCP 握手(initialize + tools/list),驗證服務器可達性、工具數量和延遲,不用等到會話裏才發現配置有問題。
2、緩存優化。採用 stale-while-revalidate 策略,進入頁面即時顯示;本地增刪改直接更新狀態,不閃爍。
Skill 管理¶
入口在 Settings → Skill Manager。啓動後列出 $DSH_HOME/skills 下的所有 Skills,每條顯示名稱和描述。點擊一行展開詳情,可以看到 Skill 名稱和 SKILL.md 的內容。
編輯、重命名、新增、刪除同樣內聯完成:名稱和內容可以直接編輯,重命名會同步目錄名,刪除有確認步驟,避免誤刪。
啓用/禁用是即時生效的。禁用一個 Skill 時,插件會在其 frontmatter 寫入 disable-model-invocation: true,watcher 隨即將它從模型目錄排除,整個過程不需要重啓。
Git 分支徽章¶
會話頭部和新會話歡迎頁會顯示當前 git 分支,並跟隨你選擇的工作區/目錄:歡迎頁的徽章跟蹤當前所選目錄,頭部徽章跟蹤當前會話的工作目錄。
點擊徽章會彈出一個 IDEA 風格的分支樹(默認展示 7 天內活躍的分支),可以在這裏切換、創建、拉取、抓取、推送、刪除本地分支。
安裝與啓用¶
安裝只需一條命令。--profile web 指定裝到 web 平臺——這個工具包的客戶端平臺就是 web(package.json 中 dsh.client.platform 爲 web),注入 dsh-api-remotes、client-runtime、ui-settings、ui-conversation、locale 等客戶端模塊:
dsh plugin --profile web add @wanghailong0419/dsh-toolkit
安裝後需要重啓才生效:
dsh web
經過上面的步驟,重啓後打開設置頁,就能看到 MCP Manager 和 Skill Manager 兩個新區塊;會話頭部和新會話歡迎頁會出現分支徽章。
單獨安裝與升級¶
如果只需要其中一個插件,可以單獨安裝,例如只要 MCP 管理或 Skill 管理:
dsh plugin --profile web add @wanghailong0419/dsh-mcp-manager
dsh plugin --profile web add @wanghailong0419/dsh-skill-manager
不想要整套工具包時,一條命令移除:
dsh plugin --profile web remove @wanghailong0419/dsh-toolkit
升級同樣是一條命令:
dsh plugin --profile web update @wanghailong0419/dsh-toolkit
適用場景與注意事項¶
適合的對象比較明確:主要在 web 平臺使用 DSH、同時維護多個 MCP 服務器或一批 Skills、開發時需要隨時確認和切換 git 分支的用戶。如果你的 MCP 服務器和 Skills 數量很少且很少變動,手動編輯文件也夠用;一旦數量上來,圖形化管理會省不少事。
使用前有幾點需要留意:
1、插件以當前 dsh 進程的權限運行,可以直接讀寫 $DSH_HOME/profiles/web/cordis.patch.yml 和 $DSH_HOME/skills 下的文件。MCP 配置是直接寫入這個 YAML 的,如果你在文件裏手工維護過格式或其他內容,建議先備份。
2、安裝前應檢查插件源碼和許可證。項目採用 MIT 協議,源碼在 GitHub 公開,裝之前花幾分鐘看一遍是值得的習慣。
3、這個工具包只覆蓋 web 平臺,安裝後必須執行 dsh web 重啓才生效(Skill 的啓用/禁用是運行時即時生效,不需要重啓)。
另外說明一點:dsh-toolkit 收錄在社區維護的插件目錄中,這類目錄是獨立站點,與 DeepSeek、幻方沒有官方從屬關係,可以把它理解成社區索引,而不是官方應用商店。
小結¶
dsh-toolkit 的價值在於把三件高頻但分散的操作——MCP 服務器配置、Skill 維護、git 分支查看與切換——收進 DSH web 客戶端界面,且一條命令安裝、一條命令移除,試錯成本很低。
項目地址與目錄頁:
- GitHub:https://github.com/LongSir0419/dsh-toolkit
- 插件目錄頁:https://www.skillhub.cn/plugins/LongSir0419/dsh-toolkit