DSH Service Manager:在 DSH 裏統一管理 MCP 與 Skill

前言

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 服務器

  1. 無需直接改 YAML 的 CRUD:在表格裏添加、編輯、刪除、啓用/禁用服務器。
  2. 展開工具列表:每個已註冊工具一行,懸停可看完整英文描述。
  3. 工具抽屜:上方爲翻譯後的摘要,下方爲參數表;參數說明可翻譯,參數名保持英文(與調用時一致)。
  4. 重連狀態可見:保存後後臺刷新 include;頁面輪詢重連狀態,而不是長時間轉圈。
  5. 環境變量佔位:支持 ${ENV_VAR},密鑰留在環境變量而非明文寫在配置裏。
  6. 可選 dsh-context 集成:若已安裝 dsh-context,可看到各服務器工具定義佔用的 token 數,並跳轉到上下文面板;未安裝則該列不顯示。

Skill

  1. 瀏覽 DSH 可見的全部 Skill:摘要與正文分兩層展示。
  2. 用自有模型翻譯摘要:模型選擇器列出 DSH 中配置的 provider × model,默認跟你的默認模型,並記住選擇;譯文語言跟隨 DSH 界面語言;已是目標語言的文本直通,不浪費 token。
  3. 譯文 / 原文 切換整表,單卡 ↻ 重譯,工具欄可 重新翻譯全部;譯文緩存到磁盤,二次訪問不發請求。
  4. 翻譯失敗會標明 機翻,不假裝成功;不修改 SKILL.md,模型仍讀英文原文。
  5. 支持從頁面刪除 Skill;抽屜中路徑旁按鈕可在文件管理器中定位 SKILL.md。
  6. 配合 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

安裝步驟:

  1. 打開 Settings → Plugins,在安裝框粘貼下列任一條:
github:Baisbt/Baisbt-dsh-service-manager

或:

https://github.com/Baisbt/Baisbt-dsh-service-manager
  1. 安裝後 刷新頁面(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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜