前言¶

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