前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。在开发或调试过程中,智能体技能往往分散在项目的 .dsh 目录、.agents 目录、用户目录或运行时配置中。如果不具备统一的浏览和检索入口,定位某个技能的 SKILL.md 全文或其作用域会变得繁琐。
是什么¶
dsh-skills-manager 是一个 DeepSeek Harness 客户端插件,它通过读取宿主的 ctx.skills 注册表,在设置页新增「技能管理」视图。该视图直接展示当前环境中合并后的全部 agent skill 信息,不依赖手动维护列表。
核心功能¶
该插件提供了以下能力:
- 技能目录概览:列出当前环境合并后的全部技能,包含名称、描述、来源(项目/用户/内置/运行时)、提供方、调用策略以及作用域。
- 搜索与筛选:支持按名称、描述或适用场景进行实时搜索;支持按「全部 / 模型可用 / 用户可用」进行筛选。
- 详情查看:点击技能后,详情面板会在卡片下方展开,展示
whenToUse、文件路径、资源目录、metadata以及完整的SKILL.md正文。 - 一键复制:提供按钮一键复制技能正文或本地路径。
- 自动刷新:页面每 30 秒轮询一次技能状态,同时支持手动刷新。当技能来源发现不完整时会显示提示。
- 主题适配:支持亮色/暗色主题自适应,使用 DSH 原生风格。
安装与启用¶
通过命令行安装该插件:
dsh plugin --profile web add github:zhangzheng25/dsh-skills-manager
安装完成后重启 DSH,打开 设置 → 技能管理 即可看到该页面。
典型用法¶
- 在技能列表中输入关键词进行搜索。
- 使用筛选器查看特定类型的技能。
- 点击技能卡片,在下方展开详情面板阅读
SKILL.md内容。 - 点击复制按钮,将技能正文或路径复制到剪贴板。
适用场景与注意¶
该插件目前仅作为只读管理界面使用。
- 权限限制:当前版本无法通过本插件启用、禁用或编辑已有技能。DSH 的 skill 注册表由各提供方(主要是
dsh-skill-filesystem)拥有,注册表本身不提供删除或禁用已有技能的能力。 - 图标限制:设置页导航图标由
dsh-client-ui-settings-general硬编码,非内置 ID 统一显示齿轮图标。 - 开发建议:在安装前,建议检查源码与许可证。
总结¶
dsh-skills-manager 解决了在多源技能环境下难以快速定位和查阅 SKILL.md 正文的问题。它通过读取宿主注册表实现轻量级的技能浏览与管理,适合需要在 DSH 中集中管理大量 agent 技能的开发者。