why913/dshx 预览 preview

why913/dshx

DeepSeek Harness(dsh)的 MCP / Skill / 记忆管理工具:写入前先连接自检,连不上不写;从 Claude Code / Codex 一键迁移;可装成 dsh 插件,在 Web 里用 /mcp 命令和卡片操作。

Project Overview项目介绍

dshx is a command-line tool and native DSH plugin built specifically for DeepSeek Harness, designed to simplify MCP server management, skill installation, and configuration migration from other coding agents. To install dshx, first run npm install -g @why913/dshx to get the CLI, then run dsh plugin --profile web add @why913/dshx to enable the in-DSH web commands and interactive cards. It supports importing existing MCP servers, skills, and global memory from Claude Code and Codex, so you don’t have to reconfigure everything from scratch when switching to DSH. Unlike manual YAML editing, dshx tests every MCP connection before writing the configuration, blocking bad entries that would otherwise cause silent failures in DSH.

For most users, adding an MCP server manually by editing DSH’s cordis.patch.yml file takes an average of six and a half minutes, and it’s easy to make formatting mistakes that break the configuration. dshx streamlines this process down to seconds, and preserves all existing comments in your YAML file, even restoring the empty array placeholder if you delete all entries. After installation, the DSH agent will automatically detect the dshx skill and use it to handle MCP-related tasks without extra manual input from you.

dshx adds an interactive /mcp command to the DSH web interface that lets you check the status of all your MCP servers at a glance, with clickable buttons to retest connections or migrate configurations from other agents. It requires Node.js version 22.19 or newer, and has been tested on DSH version 0.1.0-rc.6. It is released under the open-source MIT license, and has a few current limitations: it does not support MCP servers that require OAuth authentication, and you will need to manually restart DSH after changing configurations for changes to take effect.

dshx 是专为 DeepSeek Harness(dsh)开发的命令行工具和原生插件,可用于管理 MCP 服务器、安装更新技能,还支持从 Claude Code 和 Codex 迁移已有 MCP、技能和全局记忆配置。它通过一条命令即可添加 MCP 服务器,添加前会自动测试连接,拦截无法连通的错误配置,避免 dsh 静默加载失败,同时支持将 API Key 以环境变量引用形式存储,不会明文暴露在配置文件中。

对普通用户来说,手动修改 dsh 的 YAML 配置文件添加 MCP 服务器通常需要 6 分半钟,还容易因格式错误导致加载失败,用 dshx 可以将这个过程缩短到几十秒。它修改配置时会保留原有的注释,删除所有条目后会自动还原占位符,不会破坏原有配置结构。安装完成后,dsh 内置的智能体可以自动识别并调用 dshx 完成相关操作。

dshx 支持通过 Web 界面的 /mcp 命令巡检 MCP 服务器状态,支持点击按钮重测和批量迁移,操作结果以卡片形式展示。项目要求 Node.js 版本不低于 22.19,当前已在 dsh 0.1.0-rc.6 版本测试通过,采用 MIT 许可证开源。需要注意的是,它目前不支持 OAuth 认证的 MCP 服务器,修改配置后需要手动重启 dsh 生效。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @why913/dshx

把 why913/dshx 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dshx

中文 | English

dshx 的核心思路:Claude Code 和 Codex 里的 MCP 服务器经过 dshx 的握手与 tools/list 校验,能连上的才写进 dsh,403 或起不来的当场拦下。

给 DeepSeek Harness(dsh)配的命令行小工具,MCP、skill、记忆一把抓:

  • 一条命令增删 MCP 服务器,不用再手改 cordis.patch.yml
  • 写入前先真连一次,连不上的直接拒绝,坏配置进不了文件
  • API Key 走环境变量引用,不会明文留在配置里
  • skill 从 GitHub 一条命令装,记住来源 commit,能一键更新
  • import 三件套:把 Claude Code / Codex 的 MCP、skill、全局记忆全部搬过来
  • dsh Web 里有 /mcp 命令和可点的卡片,巡检和迁移都不用敲命令行
  • 自带 SKILL.md,装上之后 dsh 里的 agent 自己就会用这个工具
npm install -g @why913/dshx

# 加一个本地服务器
dshx mcp add everything -- npx -y @modelcontextprotocol/server-everything
# 连接测试 everything … 通过(2133ms,发现 13 个工具)
# 已写入 ~/.dsh/profiles/web/cordis.patch.yml

# 从 Claude Code / Codex 一键迁移
dshx mcp import --yes

为什么做这个

dsh 的 MCP 客户端本身不错(stdio / streamable-http、断线重连都有),但官方没给任何管理命令,加一个服务器只能手改 YAML:先找到 $DSH_HOME/profiles/xxx/cordis.patch.yml,再搞懂 patch 分层怎么写,还有个坑——原始文件里是个 [] 占位符,直接往后追加必报错。

我们拿 agent 实测过:手改一次要 6 分半。Claude Code 里同样的事就是 claude mcp add 一条命令的功夫。

另外手改还有个更隐蔽的问题:配置写错了 dsh 不报错,启动后静默挂载零个工具,你还得翻日志猜。dshx 在写入前就把握手和 tools/list 跑一遍,坏的根本写不进去。

命令或 URL 进来,dshx 跑握手和 tools/list,通过的 MCP 进 DSH,403 的被拦在门外。

真机迁移实测(就一台机器,不是什么通用基准):Claude Code + Codex 共 12 个 MCP 服务器,10 个迁移成功,2 个被拦下(一个 403,一个起不来)——拦下的这两个就是以前会让你翻半天日志的那种。另外说清楚:下载和跑那个包是 npx 的活,dshx 负责确认它真的会说 MCP,确认了才写配置。

安装

npm install -g @why913/dshx

想让 dsh 里的 agent 也能直接调(获得 mcp_add 等 5 个原生工具,外加 /mcp 命令和卡片):

dsh plugin --profile web add @why913/dshx

推荐再装个 skill,agent 遇到 MCP 相关的活会主动想起用 dshx:

dshx skill add ./skills/dshx       # 会记下来源,以后 skill update 才能用

skills 目录是热监听的,装完就生效,不用重启。实测 agent 能自己发现这个 skill,自己调 mcp_list / mcp_test / mcp_import,16 秒干完活。

用法

dshx mcp add <name> -- <command> [args...]     加本地 stdio 服务器
dshx mcp add --transport http <name> <url>     加远程 streamable-http 服务器
dshx mcp list                                  列出已配置的服务器
dshx mcp rm <name>                             删除
dshx mcp test <name>                           只测连接,不改配置
dshx mcp import [--yes]                        从 Claude Code / Codex 搬 MCP

dshx skill list                                列出 skill(顺带体检格式问题)
dshx skill add <owner/repo[/子目录] | 本地路径>  从 GitHub 或本地装 skill
dshx skill rm <name>                           删(只删自己装的,--force 才删别的)
dshx skill update <name>                       按记录的来源重新拉取
dshx skill import [--yes]                      从 ~/.claude/skills 搬 skill

dshx memory import [--yes]                     把 CC/Codex 全局记忆搬进 $DSH_HOME/AGENTS.md

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-checkpoint-diff 下一个 Next dsh-subagent-codex →