前言¶
如果你在用 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.platform 为 web),注入 dsh-api-remotes、client-runtime、ui-settings、ui-conversation、locale 等客户端模块:
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