dshx

[English](#english) · [中文](#中文)

An extension suite for the DeepSeek Harness (DSH) Web GUI: an MCP client hub (stdio / Streamable HTTP / SSE) with a web management console, plus skill, slash command, project & global memory, and prompt management. Plain ESM JavaScript, no build step.

English

• [中文](#中文) · [↑ Back to dshx](#dshx)

Modules

Installation

#### Method 1 — install as a dsh bundle (persistent)

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

Restart dsh web. The dsh.bundle entry in package.json applies cordis.patch.yml, which mounts the six rows above.

> If you previously added the dshx rows manually to your profile's > cordis.patch.yml (the local ./packages/dshx/... variant), remove those > rows first — both share the row ids dshx-* and mounting them twice would > register the tools and routes twice.

#### Method 2 — manual local install (no npm / GitHub)

1. Copy lib/*.mjs to a directory inside your profile, e.g. $DSH_HOME/profiles/web/packages/dshx/lib/; 2. Add the rows from cordis.patch.yml to $DSH_HOME/profiles/web/cordis.patch.yml, replacing name: dshx/<module> with name: ./packages/dshx/lib/<file>.mjs; 3. Restart dsh web (or let the patch watcher hot-apply it).

Dependencies (@deepseek-ai/*, @modelcontextprotocol/sdk, chokidar, js-yaml) all ship with every dsh installation and resolve through the profile's node_modules — the plugin itself has no npm dependencies.

Quick start

1. Open the Web GUI and click the floating ⚙ 扩展管理 button (or visit http://127.0.0.1:3080/dshext/). 2. MCP tab → 添加 MCP 服务器 → pick a transport: - stdio: command npx, args -y @modelcontextprotocol/server-github (env GITHUB_TOKEN as JSON); - Streamable HTTP: URL http://localhost:3000/mcp + optional JSON headers; - SSE: URL http://localhost:3001/sse + optional JSON headers. 3. The card turns green (connected, N 个工具) and the model can call mcp__<id>__<tool> immediately. Logs and the tool list are on the card. 4. Use the other tabs to write memory / skills / commands / prompt sections, or just ask the model to do it (memory_write, skill_create, command_define, …).

MCP server configuration

Server configs live in $DSH_HOME/dshext/mcp.json (managed by the console or the model tools) — example:

{
  "servers": [
    { "id": "github", "name": "GitHub", "transport": "stdio",
      "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "…" } },
    { "id": "web", "name": "Web", "transport": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "headers": { "Authorization": "Bearer …" } },
    { "id": "legacy", "name": "Legacy SSE", "transport": "sse",
      "url": "http://localhost:3001/sse" }
  ]
}

Custom slash commands

# $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.

User-level commands register as /review; project commands are callable via /cmd review (and /cmd alone lists everything).

Model-facing tools

mcp_status · mcp_restart · memory_list · memory_read · memory_write · memory_delete · skill_create · skill_edit · skill_delete · command_define — plus every discovered MCP tool as mcp__<server>__<tool>.

Data files

Development & tests

# syntax check every module
node --check lib/*.mjs

# 18 smoke checks (mock cordis ctx; real file round-trips; needs the dsh
# dependency tree resolvable — run from an installed copy, or give this
# package a node_modules junction to $DSH_HOME/profiles/node_modules)
node test/selfcheck.mjs

# fixture stdio MCP server used to verify the hub end to end
node test/test-mcp-server.mjs   # then add it in the console:
#   transport stdio, command <path-to-node>, args <this file>

Security

See [SECURITY.md](SECURITY.md). Credentials are environment variables / config values only — nothing is hardcoded; the console binds to the same local-only DSH web server (127.0.0.1).

License

[MIT](LICENSE) © 2026 DeepSeekHarnessPlugins contributors

---

中文

[English](#english) · [↑ 返回 dshx](#dshx)

面向 DeepSeek Harness（DSH）Web GUI 的扩展套件： MCP 客户端集线器（stdio / Streamable HTTP / SSE 三种协议，含状态、日志、工具面板与 Web 管理台）， 以及 技能、斜杠命令、项目/全局记忆、提示词 四类管理能力。纯 ESM JavaScript，无需构建。

模块一览

安装

方式一 · dsh bundle 安装（持久化，推荐）

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

重启 dsh web。package.json 的 dsh.bundle 会应用 cordis.patch.yml 挂载上面六行。

> 若你此前在 profile 的 cordis.patch.yml 里手动加过 dshx 行（./packages/dshx/... 本地变体），请先删除——两种方式共用 dshx-* 行 id，重复挂载会重复注册工具与路由。

方式二 · 本地手动安装

1. 把 lib/*.mjs 复制到 profile 内目录（如 $DSH_HOME/profiles/web/packages/dshx/lib/）； 2. 把 cordis.patch.yml 中的行写进 $DSH_HOME/profiles/web/cordis.patch.yml，将 name: dshx/<模块> 换成 name: ./packages/dshx/lib/<文件>.mjs； 3. 重启 dsh web（补丁层支持热重载，通常无需重启）。

依赖（@deepseek-ai/*、@modelcontextprotocol/sdk、chokidar、js-yaml）随 dsh 自带，经 profile 的 node_modules 解析，插件本身零 npm 依赖。

快速开始

1. 打开 Web GUI，点击右下角「⚙ 扩展管理」（或访问 http://127.0.0.1:3080/dshext/）； 2. MCP 标签 → 添加 MCP 服务器，三种协议任选： - stdio：命令 npx、参数 -y @modelcontextprotocol/server-github（env 填 JSON）； - Streamable HTTP：URL + 可选 JSON 请求头； - SSE：URL + 可选 JSON 请求头； 3. 卡片变绿（connected，N 个工具），模型即可直接调用 mcp__<id>__<tool>； 4. 其余标签页管理记忆/技能/命令/提示词，也可以直接让模型调用 memory_write、skill_create、command_define 等工具代办。

数据文件位置

测试

node --check lib/*.mjs     # 全部模块语法检查
node test/selfcheck.mjs    # 18 项冒烟自检（mock cordis 上下文 + 真实文件往返）
node test/test-mcp-server.mjs  # stdio MCP 测试服务器（在管理台添加后可验证全链路）

安全与许可

见 [SECURITY.md](SECURITY.md)。凭据只通过环境变量/配置传入，无任何硬编码；管理台绑定 dsh 本地 Web 服务（127.0.0.1）。[MIT](LICENSE) © 2026 DeepSeekHarnessPlugins contributors