前言¶
DeepSeek Harness (DSH) 的 Web 客戶端採用插件架構。在開發智能體時,管理 MCP(Model Context Protocol)服務器和本地技能文件通常需要直接編輯 JSON 配置或使用命令行。dsh-toolbox-ui 提供了一個浮層面板,允許在對話進行中直接管理這些配置,無需重啓或中斷會話。
插件簡介¶
dsh-toolbox-ui 是由 Imzl-zl 維護的客戶端插件,採用 MIT 許可證。它將 MCP 管理面板與技能管理面板集成在一個界面中,支持全局與項目級配置的雙向操作。
核心功能¶
MCP 管理面¶
- 狀態與詳情:查看連接狀態、傳輸方式、連接參數與已註冊工具。展開工具條目可查看完整的輸入 JSON Schema。
- 操作:支持啓停、重連、添加、編輯、移除 MCP。憑據類字段默認掩碼,點擊眼睛圖標可臨時顯示並複製有效值。
- 配置導入:支持從其他客戶端(Claude Code, Cursor, VS Code 等)導入配置,支持跨工作區搬運或導出 JSON。
- 作用域:支持全局(Web profile)與項目級(
.dsh/mcp.json)雙作用域,支持屏蔽全局 MCP。
技能管理面¶
- 作用域與遮蔽:查看本機每個技能的真實作用域與同名遮蔽情況。
- 操作:支持啓停、刪除、讀取正文與診斷。
- 模型自動調用開關:一鍵切換技能的
disable-model-invocation狀態,直接修改SKILL.md文件。 - 文件定位:按磁盤上的真實位置定位技能(不按技能名),支持從 skillhub.cn 市場安裝(需顯式確認)。
通用特性¶
- 入口:支持右下角懸浮按鈕(可拖拽)和側欄「工具箱」兩種入口。
- 主題:跟隨 DSH 主題,適配窄屏與移動端。
- 更新:每天最多查一次 npm,提供更新提示,但不自動升級。
安裝與啓用¶
使用官方 CLI 安裝:
dsh plugin --profile web add dsh-toolbox-ui@^1.7.2
安裝完成後需重啓 dsh web 服務。
典型用法¶
- 打開面板:點擊右下角懸浮按鈕,或側欄底部的「工具箱」。
- 添加 MCP:在 MCP 面板頂部點擊「添加 MCP」填寫表單,或使用「導入 MCP」粘貼配置。
- 管理技能:在技能面板中,點擊技能條目查看狀態,或點擊「模型自動調用」開關進行修改。
- 升級插件:當面板提示有新版本時,可執行:
dsh plugin --profile web update dsh-toolbox-ui
適用場景與注意事項¶
本插件以當前 DSH 進程的權限運行,直接操作配置文件。
- 語言:面板語言跟隨 DSH 設置(通用 → 語言),未手動選擇時默認使用瀏覽器語言推斷。
- 熱更新:在項目內修改配置並保存時,改動會立即對齊到正在運行的會話,無需重啓 Host。
- 連接保持:MCP 連接不隨會話結束而斷開,僅進入空閒等待狀態,下次會話可直接複用。
- 兼容性:僅支持 DSH 版本 0.1.5-rc.1 及以上。
- 數據隔離:不會修改其他配置,卸載也不會刪除已有的 MCP 條目與項目的
.dsh/mcp.json。
結語¶
對於需要頻繁調整 MCP 服務器或管理大量本地技能的開發者,dsh-toolbox-ui 提供了一個直觀、高效的集中管理入口。
- GitHub: https://github.com/Imzl-zl/dsh-toolbox-ui
- Catalog: https://www.skillhub.cn/plugins/Imzl-zl/dsh-toolbox-ui