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 服务器连接、记忆存储、技能定义和命令调度集中化，减少了手动配置的繁琐，是构建复杂智能体的实用扩展。