前言¶

DeepSeek Harness（dsh）可以把 MCP、skill 和记忆作为运行时能力接入，但实际使用中仍需要处理几件具体事务：新增一个 MCP 服务器、检查服务器是否可用、从 Claude Code / Codex 迁移已有配置、管理 skill 的来源与更新。

dshx（仓库地址 why913/dshx）是一个面向 dsh 的社区管理工具：写入前先做连接自检，连不上就不写；支持从 Claude Code / Codex 迁移 MCP、skill 和全局记忆；也可以装成 dsh 插件，在 dsh Web 里使用 /mcp 命令和卡片操作。

这是什么¶

@why913/dshx 是一个非官方社区项目，与 DeepSeek 无关联，采用 MIT 许可证。它主要覆盖三类对象：

• MCP 服务器：增删、列表、连接测试、迁移。
• skill：从 GitHub 或本地安装、删除、更新、迁移。
• 全局记忆：从 Claude Code / Codex 迁移到 dsh。

它既可以作为命令行工具使用，也可以安装为 dsh 插件，在 dsh Web 里提供 /mcp 命令。

核心功能¶

1. 一条命令增删 MCP 服务器，并支持列出和测试。
2. 写入前先真实连接一次；连不上直接拒绝，坏配置不写入文件。
3. API Key 支持环境变量引用，避免明文留在配置里。
4. skill 可从 GitHub 或本地路径安装，并记录来源以便更新。
5. 支持从 Claude Code / Codex 迁移 MCP、skill、全局记忆。
6. dsh Web 提供 /mcp 命令和可点击卡片。
7. 自带 SKILL.md，使 dsh agent 可发现并调用该工具。

安装与启用¶

环境要求：

• Node.js >=22.19
• @deepseek-ai/dsh-tools 是 peer 依赖，由宿主提供
• dsh 当前处于 developer preview；资料说明当前在 @deepseek-ai/dsh 0.1.0-rc.6 上测试通过

先安装命令行工具：

npm install -g @why913/dshx

如果要让 dsh Web 里出现 /mcp 命令和插件能力，执行：

dsh plugin --profile web add @why913/dshx

还可以安装文档给出的本地 skill 示例，让 dsh agent 更容易发现并调用 dshx：

dshx skill add ./skills/dshx

这里的 ./skills/dshx 是相对当前路径的本地示例；如果 skill 不在当前目录，需要按实际路径执行。

注意：dshx 修改配置后不会自动重启 dsh，改完需要重载 dsh 才生效。

典型用法¶

以下命令从 dshx 命令行执行。

增加 MCP 服务器¶

增加本地 stdio 服务器：

dshx mcp add everything -- npx -y @modelcontextprotocol/server-everything

增加远程 streamable-http 服务器：

dshx mcp add --transport http <name> <url>

执行时，dshx 会先进行连接自检；通过后才写入 dsh 配置。

查看、删除、测试 MCP 服务器¶

dshx mcp list
dshx mcp rm <name>
dshx mcp test <name>

dshx mcp test <name> 只测试连接，不修改配置。

从 Claude Code / Codex 迁移 MCP¶

先预览可迁移内容：

dshx mcp import

确认后再写入：

dshx mcp import --yes

MCP、skill、memory 三个 import 命令默认都是预览；加 --yes 才真正写入。

管理 skill¶

dshx skill list
dshx skill add <owner/repo[/子目录] | 本地路径>
dshx skill rm <name>
dshx skill update <name>
dshx skill import [--yes]

安装前，dshx 会做格式体检：缺少 name 或 description、名称不是 kebab-case、使用旧的 disableModelInvocation 驼峰键，都会被拒绝。

迁移全局记忆¶

dshx memory import
dshx memory import --yes

在 dsh Web 里使用¶

在 dsh Web 会话中，可以使用：

/mcp
/mcp <server>
/mcp import
/mcp import <server>
/mcp import all
/mcp help

/mcp 用于巡检 MCP 服务器；/mcp import 系列用于列出和执行迁移。由于 /mcp 拿不到 dsh 的真实连接状态，它会自建诊断连接来报告结果。

适用场景与注意¶

适合已经在使用 dsh，希望减少手工维护 MCP 配置、统一迁移 Claude Code / Codex 的 MCP 与 skill、或在 Web 里快速巡检 MCP 服务器的开发者。

使用前注意以下几点：

• 插件会以当前 dsh 进程可访问的文件与环境权限运行；安装前建议检查源码、命令行为与 MIT 许可证。
• 斜杠命令只在 dsh Web 里可用；在 headless CLI 或终端里，应使用 dshx mcp ...。
• /mcp 报告的是自建诊断连接，不代表 dsh 当前的活连接和重连状态。
• 不支持需要 OAuth 的 MCP 服务器。
• 修改已有服务器的字段时，资料说明只能通过 --force 整条重写。
• 使用 $VAR 写法提供的值会存成环境变量引用；如果源配置里本来就是明文 token，迁移后仍可能是明文。
• dshx 不会替你重启 dsh，改完配置需要重载 dsh。

相关链接¶

• 仓库：https://github.com/why913/dshx
• 目录页：https://www.skillhub.cn/plugins/why913/dshx