dsh-toolkit:一条命令为 DSH 装上 MCP 管理、Skill 管理与 Git 分支徽章

前言

如果你在用 DeepSeek Harness(DSH)的 web 客户端,下面这些操作大概不陌生:配置 MCP 服务器要手动编辑 $DSH_HOME/profiles/web/cordis.patch.yml,增删 Skill 要直接改 $DSH_HOME/skills 下的 Markdown 文件,想确认当前会话跑在哪个 git 分支上还得切回终端。

这些事情本身不难,但散落在客户端之外,来回切换成本不低。dsh-toolkit 要解决的就是这个问题:把 MCP 管理、Skill 管理和 Git 分支徽章三个功能打包成一个插件工具包,一条命令安装,装完即用。

这是什么

dsh-toolkit 是一个 DSH 插件工具包(bundle),由 LongSir0419 维护,采用 MIT 协议,代码托管在 GitHub(LongSir0419/dsh-toolkit)。npm 包名为 @wanghailong0419/dsh-toolkit,package.json 中标注版本 0.1.10。

它本身不实现单个功能,而是把三个独立插件捆绑在一起:

捆绑的包 版本约束 入口
@wanghailong0419/dsh-mcp-manager ^0.1.3 Settings → MCP Manager
@wanghailong0419/dsh-skill-manager ^0.1.4 Settings → Skill Manager
@wanghailong0419/dsh-git-branch-manage ^0.1.3 会话头部 → 分支徽章

安装完成后,设置页会自动多出 MCP Manager 和 Skill Manager 两个区块,会话头部和新会话欢迎页会多出 Git 分支徽章。

核心功能

MCP 管理

入口在 Settings → MCP Manager。先看列表概览:每个 MCP 服务器一行,显示连接状态(绿点)和已注册的工具数。点击任意一行可以展开详情,包括服务器名、模块和配置 JSON,再点一次收起(输入框和按钮不触发展开/收起)。

增删改都在列表内联完成:添加、编辑、删除、重命名、启用/禁用均可直接操作,配置写入 $DSH_HOME/profiles/web/cordis.patch.yml

另外两个值得注意的设计:

1、连接测试。插件会做一次独立的 MCP 握手(initialize + tools/list),验证服务器可达性、工具数量和延迟,不用等到会话里才发现配置有问题。

2、缓存优化。采用 stale-while-revalidate 策略,进入页面即时显示;本地增删改直接更新状态,不闪烁。

Skill 管理

入口在 Settings → Skill Manager。启动后列出 $DSH_HOME/skills 下的所有 Skills,每条显示名称和描述。点击一行展开详情,可以看到 Skill 名称和 SKILL.md 的内容。

编辑、重命名、新增、删除同样内联完成:名称和内容可以直接编辑,重命名会同步目录名,删除有确认步骤,避免误删。

启用/禁用是即时生效的。禁用一个 Skill 时,插件会在其 frontmatter 写入 disable-model-invocation: true,watcher 随即将它从模型目录排除,整个过程不需要重启。

Git 分支徽章

会话头部和新会话欢迎页会显示当前 git 分支,并跟随你选择的工作区/目录:欢迎页的徽章跟踪当前所选目录,头部徽章跟踪当前会话的工作目录。

点击徽章会弹出一个 IDEA 风格的分支树(默认展示 7 天内活跃的分支),可以在这里切换、创建、拉取、抓取、推送、删除本地分支。

安装与启用

安装只需一条命令。--profile web 指定装到 web 平台——这个工具包的客户端平台就是 web(package.json 中 dsh.client.platformweb),注入 dsh-api-remotesclient-runtimeui-settingsui-conversationlocale 等客户端模块:

dsh plugin --profile web add @wanghailong0419/dsh-toolkit

安装后需要重启才生效:

dsh web

经过上面的步骤,重启后打开设置页,就能看到 MCP Manager 和 Skill Manager 两个新区块;会话头部和新会话欢迎页会出现分支徽章。

单独安装与升级

如果只需要其中一个插件,可以单独安装,例如只要 MCP 管理或 Skill 管理:

dsh plugin --profile web add @wanghailong0419/dsh-mcp-manager
dsh plugin --profile web add @wanghailong0419/dsh-skill-manager

不想要整套工具包时,一条命令移除:

dsh plugin --profile web remove @wanghailong0419/dsh-toolkit

升级同样是一条命令:

dsh plugin --profile web update @wanghailong0419/dsh-toolkit

适用场景与注意事项

适合的对象比较明确:主要在 web 平台使用 DSH、同时维护多个 MCP 服务器或一批 Skills、开发时需要随时确认和切换 git 分支的用户。如果你的 MCP 服务器和 Skills 数量很少且很少变动,手动编辑文件也够用;一旦数量上来,图形化管理会省不少事。

使用前有几点需要留意:

1、插件以当前 dsh 进程的权限运行,可以直接读写 $DSH_HOME/profiles/web/cordis.patch.yml$DSH_HOME/skills 下的文件。MCP 配置是直接写入这个 YAML 的,如果你在文件里手工维护过格式或其他内容,建议先备份。

2、安装前应检查插件源码和许可证。项目采用 MIT 协议,源码在 GitHub 公开,装之前花几分钟看一遍是值得的习惯。

3、这个工具包只覆盖 web 平台,安装后必须执行 dsh web 重启才生效(Skill 的启用/禁用是运行时即时生效,不需要重启)。

另外说明一点:dsh-toolkit 收录在社区维护的插件目录中,这类目录是独立站点,与 DeepSeek、幻方没有官方从属关系,可以把它理解成社区索引,而不是官方应用商店。

小结

dsh-toolkit 的价值在于把三件高频但分散的操作——MCP 服务器配置、Skill 维护、git 分支查看与切换——收进 DSH web 客户端界面,且一条命令安装、一条命令移除,试错成本很低。

项目地址与目录页:

  • GitHub:https://github.com/LongSir0419/dsh-toolkit
  • 插件目录页:https://www.skillhub.cn/plugins/LongSir0419/dsh-toolkit
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜