前言¶
DSH 采用「一切皆插件」的架构,开发者在调试智能体时需要同时管理 MCP 服务器配置和技能文件。常见做法是手动编辑配置文件(如 Codex 的 config.toml),容易因拼写错误或格式问题导致运行失败,且无法直观查看服务器的状态和工具列表。DSH 0.2.0-rc.2 引入了插件系统,但插件管理界面仅提供基础开关,缺少针对 MCP 服务器和技能的精细管理能力。
这是什么¶
dsh-mcp-skills-board 是一个为 DeepSeek Harness 设计的插件,提供 MCP 服务器与技能的可视化管理面板。它由 GlowStorm 维护,采用 MIT 许可证,定位为 Codex 风格的 MCP & Skills board。通过侧栏入口和插件页配置区,用户可以查看服务器状态、启停工具、扫描技能目录,并在界面中完成新建、编辑、导入导出等操作。
核心功能¶
MCP 服务器管理¶
插件在侧栏提供一个入口,在插件页配置区显示当前组合中所有 @deepseek-ai/dsh-mcp-client 行。每行显示状态灯、工具数量和工具名,支持逐行启停。添加服务器时,可选择 stdio 或 streamable-http 传输方式,并支持编辑和删除。
技能管理¶
插件会扫描 .dsh/skills、.agents/skills 和自定义根目录,按来源分组,并将当前项目置顶。每个技能显示为四态(启用/禁用/只读/预设),支持重命名、移动、复制和删除。技能详情页提供快速切换和编辑入口。
新建/编辑技能¶
新建技能时,需要填写名称、描述、使用场景和正文,并选择调用方式和创建位置。界面内置文件夹选择器,支持直接跳转和进入子目录。保存时,只重写受管的前置字段(名称、描述、使用场景、两个调用开关)和正文,保留自定义的 frontmatter 键。
导入/导出¶
插件支持读取 Codex 的 config.toml、Claude/Cursor 的 mcpServers JSON,或本插件导出的 JSON 文件。导出结果可复制到剪贴板或下载为文件。
模板与密钥¶
添加服务器时,可选择 filesystem、github、fetch、git、sqlite、brave-search 等模板,自动填好命令与参数。密钥支持 env 或 headers,并在表单中使用 @env:变量名 语法。保存后,密钥会生成 !!js process.env.变量名,不写入 patch 文件。
安装与启用¶
插件要求 DSH 版本在 >=0.2.0-rc.2 <0.3.0 范围内,安装时会进行兼容性检查。
dsh plugin --profile desktop add dsh-mcp-skills-board
也可以在「插件 → 添加插件」界面填写包名 dsh-mcp-skills-board,安装后刷新页面即可看到侧栏入口。
本地开发使用 link 安装:
dsh plugin --profile desktop add link:/absolute/path/to/dsh-mcp-skills-board
数据位置¶
MCP 服务器定义的唯一事实源是 $DSH_HOME/mcp-skills.json(默认 ~/.dsh/mcp-skills.json,权限 0600)。插件会根据该 JSON 生成一个带围栏的 patch 块,插入到 $DSH_HOME/profiles/<profile>/cordis.patch.yml 中。块外的内容保持原样,启停操作仅追加一条按 id 定向的 disabled: 覆盖。
技能文件写在所选技能根内(默认 ~/.dsh/skills),每个技能一个目录,包含一个 SKILL.md 文件。
典型用法¶
在插件页的「MCP 服务」分页中,查看当前组合中的服务器列表。点击右侧开关可以快速启停服务器。点击「添加服务器」按钮,选择模板(如 github),填写服务器名称和命令参数。保存后,patch 文件会自动更新。
在「技能」分页中,插件会自动扫描技能目录。点击技能右侧的状态按钮可以切换四态。点击技能名称可以打开详情页,编辑名称、描述或正文。使用搜索框(快捷键 /)可以快速定位技能。
点击「导入」按钮,选择 Codex 的 config.toml 文件,插件会解析 [mcp_servers.*] 段落并尝试映射到 MCP 服务器定义。点击「导出」按钮,可以复制或下载当前配置的 JSON 文件。
适用场景与注意¶
本插件适合需要在 DSH 中统一管理 MCP 服务器和技能文件的开发者。它通过界面简化了配置流程,减少了手动编辑错误,并提供了状态监控和批量操作能力。
安装前请检查源码与许可证,插件以当前 dsh 进程权限运行,确保只修改受管配置块和技能根目录内的文件。MCP 服务器删除操作仅针对本页添加的服务器,外部声明的行请修改其所在的配置层。
结尾¶
通过 dsh-mcp-skills-board,DSH 用户可以在界面中完成 MCP 服务器和技能的增删改查,减少对配置文件的依赖。更多信息和源码可访问项目主页。
- 目录页:https://www.skillhub.cn/plugins/JasperPengC/dsh-mcp-skills-board
- GitHub:https://github.com/JasperPengC/dsh-mcp-skills-board