dshx：MCP 客戶端集線器與 DeepSeek Harness 擴展管理套件

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在使用 Web GUI 進行開發時，連接 MCP 服務器、維護記憶庫、管理技能和斜槓命令通常需要手動編輯配置文件，缺乏統一的入口。dshx 作爲一個擴展套件，提供了 MCP 客戶端集線器（支持 stdio / Streamable HTTP / SSE）以及 Web 管理控制台，同時集成了技能、斜槓命令、項目與全局記憶以及提示詞管理功能。

核心功能¶

dshx 將功能劃分爲多個模塊，每個模塊通過模型工具（Model Tools）暴露能力，同時通過 Web 控制台提供可視化管理。

MCP 集線器：支持連接 stdio、Streamable HTTP 和 SSE 三種協議的 MCP 服務器。具備完整的狀態機（連接中/已連接/重連中/錯誤），支持指數退避的自動重連，並提供實時日誌（環形緩衝區）和工具列表。發現到的工具會自動橋接到模型，命名爲 mcp__<服務器>__<工具>。模型工具包括 mcp_status 和 mcp_restart。
記憶管理：支持全局記憶（存儲在 $DSH_HOME/dshext/memory/*.md）和項目記憶（存儲在 <工作區>/.dsh/memory/*.md）。記憶會在每次模型請求前注入系統提示詞。模型工具包括 memory_list、memory_read、memory_write 和 memory_delete。項目範圍的寫入遵循會話沙箱策略（需要審批與權限升級）。
技能與命令管理：技能和斜槓命令均以文件形式管理。技能文件位於 $DSH_HOME/skills 或 <工作區>/.dsh/skills；命令文件爲 YAML 格式，位於 $DSH_HOME/dshext/commands 或 <工作區>/.dsh/commands。技能變更會即時反映在會話中，命令通過 /cmd <name> 調用，支持參數替換。
提示詞管理：提供提示詞庫管理，支持配置提示詞的順序和啓用狀態，並包含一個系統提示詞構建器。
Web 管理控制台：插件會在 DSH Web GUI 中注入一個“⚙ 擴展管理”浮動按鈕，點擊即可訪問管理界面。控制台綁定在本地地址 http://127.0.0.1:3080/dshext/，提供 MCP、技能、命令、記憶、提示詞五個標籤頁以及 JSON API。

安裝與啓用¶

安裝 dshx 需要在安裝前移除舊的本地手動配置行以避免重複註冊。

執行以下命令將 dshx 添加到 Web 服務器配置：

    dsh plugin --profile web add github:YZz-S/dshx

重啓 dsh web 服務。

安裝完成後，Web 界面會出現擴展管理入口，DSH 也會自動加載上述模塊。

典型用法¶

配置 MCP 服務器¶

通過 Web 管理控制台的“MCP”標籤頁添加服務器。例如，添加一個 GitHub MCP 服務器（stdio 協議）：

{
  "servers": [
    {
      "id": "github",
      "name": "GitHub",
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your_token_here" }
    }
  ]
}

添加後，模型即可直接調用該服務器提供的工具，例如 mcp__github__search_repos。

定義斜槓命令¶

在 Web 管理控制台的“命令”標籤頁或編輯器中創建 YAML 文件：

# $DSH_HOME/dshext/commands/review.yaml
name: review
description: Review the current changes
hint: '[path]'
prompt: |
  Review {{args}} and output an issue list ordered by severity.

定義後，用戶可通過 /review 調用該命令，模型工具 command_define 也可用於動態定義命令。

適用場景與注意¶

dshx 適合需要在一個統一的 Web 界面中管理多種 MCP 服務器以及智能體長期記憶和能力的開發者。

技術棧：純 ESM JavaScript，無需構建步驟，依賴隨 DSH 安裝分發。
安全性：憑據僅通過環境變量或配置值傳遞，無硬編碼；控制台僅綁定本地 127.0.0.1。
權限：項目範圍的寫入（如寫入項目記憶）遵循會話沙箱策略，需要審批。
生態背景：本插件通過 DeepSeek Harness 的插件機制工作，社區目錄（https://www.skillhub.cn/plugins/YZz-S/dsh-dshx）提供索引，插件本身由社區維護。

總結¶

dshx 通過 Web 控制台將 MCP 服務器連接、記憶存儲、技能定義和命令調度集中化，減少了手動配置的繁瑣，是構建複雜智能體的實用擴展。