前言¶
DeepSeek Harness(DSH)运行时,MCP 服务器和技能库的配置分散在配置文件中。通过该插件,可以在设置页面统一管理两者,无需手动编辑 YAML。插件维护者 chihy525 专注于解决技能包管理和工具配置的碎片化问题。
插件简介¶
这是一个位于 DSH 设置页面的管理面板,用于管理 MCP 服务器和技能库。
核心功能¶
1. 管理 MCP 服务器¶
在设置页面的 MCP & Skills 菜单下进入 MCP Servers 面板:
- 列表与状态:显示所有服务器,支持启用/禁用。HTTP 服务器会自动检测可达性,区分插件激活与服务器实际运行状态。
- 连接测试:支持 stdio 和 streamable-http 传输方式。点击测试会执行握手和工具列表获取。
- 工具统计与估算:点击 Collect 或 Test 后,会快照服务器的工具列表,卡片显示
tools: N · ~X tokens。工具数量和令牌估算基于社区规则(约 4 字节/令牌)。 - 配置项:支持为 streamable-http 配置授权头,以及为 stdio 和 http 配置环境变量。
2. 管理 技能库¶
在设置页面的 MCP & Skills 菜单下进入 Skills 面板:
- 浏览与查看:支持浏览标准技能根目录(
.dsh/skills、.agents/skills、~/.dsh/skills、~/.agents/skills)。点击 View 可查看完整的 SKILL.md 内容。 - 模板创建:从模板创建技能,支持 kebab-case 命名、描述和
whenToUse字段。 - 分组视图:提供三种视图:按集合、按根、平面。默认按集合分组。
- 批量操作:支持批量启用/禁用模型调用,或删除整个集合。
3. 技能分组与规则¶
技能按来源分组,分为自动检测或基于规则。
- 规则编辑器:支持 10 种匹配器类型(如名称正则、路径子串、Frontmatter 键值、元数据深度路径等)。
- 建议与测试:提供 Feature Suggestions 列表,建议未分组的技能。支持 Suggest(列出后确认应用)和 Auto(立即应用)两种模式。点击 Test 可验证规则匹配效果。
典型用法¶
创建技能¶
- 在技能库页面点击创建。
- 从模板中选择,填写名称(如
browser-skill)和描述。 - 可选填写
whenToUse字段。 - 保存后可在集合或平面视图中查看。
配置 MCP 服务器¶
- 进入
MCP Servers面板,点击添加。 - 输入服务器信息,配置传输方式。
- 在授权头或环境变量区域,按
Key: Value格式添加配置。 - 点击 Test 连接进行验证。
自定义分组规则¶
- 在
Skills页面点击“分组规则”。 - 添加新规则,选择匹配器类型(如
hasKey)。 - 切换“Suggest / Auto”模式。
- 返回 Skills 页面查看“Feature suggestions”,选中技能后点击“Apply selected”。
数据存储与权限¶
- 依赖:需要
@deepseek-ai/cordis(^4.0.1)。 - 数据路径:设置保存在
~/.dsh/dsh-mcp-skill-manager/settings.,技能数据保存在catalog.,集合数据保存在collections.。 - 权限要求:需要写入权限以创建或编辑配置,系统会自动创建备份。
适用场景¶
适合需要精细化管理 MCP 服务器连接状态、工具调用成本估算以及大量技能包(如 superpowers、hack-skills)分类的用户。
结尾¶
该插件为 DSH 用户提供了集中式的 MCP 和技能管理入口,通过可视化的分组和统计功能,降低了配置复杂度。更多细节请参考 GitHub 仓库。