前言¶
DeepSeek Harness(DSH)自帶 MCP 橋接能力,但沒有獨立的 MCP 管理界面。要新增一個 MCP 服務器,通常得手寫 YAML;要確認是否連上,往往得回到會話裏再試一次。Skill 以磁盤上的 SKILL.md 存在,英文摘要讀一遍就容易忘。
社區插件 DSH Service Manager(倉庫 Baisbt/Baisbt-dsh-service-manager,維護者 Baisbt)補的是這一頁:在側邊欄用 服務管理 查看、增刪改查 MCP,瀏覽 Skill,並用你在 DSH 裏配置的模型翻譯摘要。它通過官方 cordis:include 機制加載插件自有的 MCP 配置,不會改寫你手寫的 cordis.patch.yml。
這是什麼¶
DSH Service Manager 是 DSH 的 Web 側欄插件(package.json 當前版本 0.13.2,許可證 MIT)。定位可以概括爲:一頁集中管理 MCP 服務器與 Skill——表格裏完成 MCP 的增刪改和啓停,展開行看工具列表;Skill 列表支持譯文/原文切換和批量翻譯。另註冊 Agent 工具 mcp_service,在對話裏也能列出、安裝、刪除或啓停 MCP(敏感操作走 DSH 一次性授權)。
核心功能¶
MCP 服務器¶
- 無需直接改 YAML 的 CRUD:在表格裏添加、編輯、刪除、啓用/禁用服務器。
- 展開工具列表:每個已註冊工具一行,懸停可看完整英文描述。
- 工具抽屜:上方爲翻譯後的摘要,下方爲參數表;參數說明可翻譯,參數名保持英文(與調用時一致)。
- 重連狀態可見:保存後後臺刷新 include;頁面輪詢重連狀態,而不是長時間轉圈。
- 環境變量佔位:支持
${ENV_VAR},密鑰留在環境變量而非明文寫在配置裏。 - 可選
dsh-context集成:若已安裝 dsh-context,可看到各服務器工具定義佔用的 token 數,並跳轉到上下文面板;未安裝則該列不顯示。
Skill¶
- 瀏覽 DSH 可見的全部 Skill:摘要與正文分兩層展示。
- 用自有模型翻譯摘要:模型選擇器列出 DSH 中配置的 provider × model,默認跟你的默認模型,並記住選擇;譯文語言跟隨 DSH 界面語言;已是目標語言的文本直通,不浪費 token。
- 譯文 / 原文 切換整表,單卡 ↻ 重譯,工具欄可 重新翻譯全部;譯文緩存到磁盤,二次訪問不發請求。
- 翻譯失敗會標明
機翻,不假裝成功;不修改SKILL.md,模型仍讀英文原文。 - 支持從頁面刪除 Skill;抽屜中路徑旁按鈕可在文件管理器中定位
SKILL.md。 - 配合
dsh-context時,卡片可顯示近 7 天該 Skill 被加載的次數。
Agent 工具 mcp_service¶
| 動作 | 作用 | 需授權 |
|---|---|---|
list |
服務器、傳輸方式、狀態、工具數量 | 否 |
install |
添加或更新服務器 | 是 |
remove |
刪除服務器 | 是 |
enable / disable |
啓停服務器 | 否 |
拒絕、取消或無可用應答方時不改動配置(fail closed);畸形參數在進入提示前即被拒絕。
界面使用 DSH 設計 token,明/暗主題隨應用切換。
安裝與啓用¶
環境要求(摘自 README):
- DeepSeek Harness:
>= 0.2.0-rc.1且< 0.3.0 pnpm在PATH中(DSH 插件管理會用到)- Windows、macOS 或 Linux 桌面版 DSH
安裝步驟:
- 打開 Settings → Plugins,在安裝框粘貼下列任一條:
github:Baisbt/Baisbt-dsh-service-manager
或:
https://github.com/Baisbt/Baisbt-dsh-service-manager
- 安裝後 刷新頁面(
Ctrl+R)。側邊欄會出現 服務管理。
README 說明:npm 包名安裝將在包發佈後可用。若要從不同來源重裝同一包,需先清理
node_modules中殘留,否則可能出現ERR_PNPM_EPERM(詳見倉庫 FAQ)。
DSH 插件目錄站(SkillHub 等)與 DeepSeek / 幻方無官方從屬關係;安裝源以你在 DSH 設置裏填寫的 GitHub 地址爲準。
典型用法¶
MCP:點中行展開工具列表;若有帶工具的服務器已展開,工具欄會出現模型選擇器,選模型後可翻譯工具摘要。
Skill:摘要默認英文;選好模型後點 重新翻譯全部 填充卡片;用 譯文 / 原文 切換整表,單卡 ↻ 只重譯該條。
打開配置目錄:頁面提供入口,用系統文件管理器打開當前 profile 文件夾(Windows explorer.exe、macOS open、Linux xdg-open);插件只打開目錄,不替你改已有文件。
對話裏裝 MCP:對 Agent 說明意圖(例如安裝某個 filesystem MCP),由 mcp_service 的 install 處理;需你在 DSH 授權界面確認。
插件會寫入哪些文件¶
僅在你當前 profile 下寫入插件自有文件,不碰 cordis.patch.yml、cordis.yml、.credentials.yaml。
| 路徑 | 含義 |
|---|---|
<profile>/mcp-servers.yml |
生成的 MCP 行,cordis:include 目標 |
<profile>/.dsh-service-manager/servers.json |
服務器列表源數據 |
<profile>/.dsh-service-manager/translations.json |
翻譯緩存(按原文哈希) |
<profile>/.dsh-service-manager/settings.json |
模型選擇等設置 |
<profile>/.dsh-service-manager/diagnostics.json |
Agent 工具與加載探針診斷 |
<profile> 爲 ~/.dsh/profiles/<name>;Windows 桌面 profile 示例爲 %USERPROFILE%\.dsh\profiles\desktop。
架構上,插件自帶的 cordis.patch.yml 註冊 service-manager(Host:路由、Agent 工具、翻譯)與 service-manager-mcp(cordis:include 指向 ./mcp-servers.yml)。頁面通過 /api/service-manager/* 讀寫;寫入後刷新 include 子樹以觸發 MCP 橋重連。
適用場景與注意¶
適合:經常在 DSH 裏切換、試用多個 MCP;Skill 較多、希望用中文快速掃摘要又不想改 SKILL.md;希望在對話中用自然語言安裝 MCP 且接受授權流程。
安全邊界(README 強調):
- Host 半段在 DSH 進程內運行,位於工作區沙箱之外;安裝第三方插件前應自行審閱源碼與 MIT 許可證。
- 建議密鑰使用
${ENV_NAME},由加載時從環境讀取。 - 敏感 MCP 變更(install / remove)必須經 DSH 一次性授權。
結尾¶
DSH Service Manager 把「手寫 YAML + 會話裏試連」收成側邊欄裏的 服務管理:MCP 表格化運維、工具與 Skill 摘要可譯、可選 dsh-context 看 token 與使用頻次,並用 mcp_service 把部分操作延伸進對話。若你正在 DSH 0.2.0-rc.1 系列上做多 MCP、多 Skill 開發,可先按上文安裝命令啓用,再對照倉庫截圖與 FAQ 排查重裝問題。
- 社區目錄頁:https://www.skillhub.cn/plugins/Baisbt/Baisbt-dsh-service-manager
- 源碼與文檔:https://github.com/Baisbt/Baisbt-dsh-service-manager