前言¶
在 DeepSeek Harness (DSH) 的开发流程中,技能通常以 SKILL.md 文件的形式存在于本地文件系统或官方注册表中。当需要对技能进行调试、修改配置或检查状态时,开发者往往需要在终端或文件管理器中手动查看和编辑这些文件。dsh-skill-studio 将技能管理器直接集成到了 Web 设置面板中,允许开发者通过浏览器界面浏览、查看全文、编辑配置,并控制技能的调用状态。
它是什么¶
这是一个由 zhengjy01 维护的工作流类插件。它通过 Web 设置面板,让用户能够查看 DSH 发现的所有技能,阅读完整的 SKILL.md 文件,直接编辑文件内容,并通过开关控制技能的启用状态以及模型/用户的调用权限。
核心功能¶
该插件主要提供以下能力:
- Web 管理界面:在“设置 → Skill 管理器”中,可以列出所有技能的名称、描述、源根目录、嵌套标志以及模型/用户调用状态。点击任意技能可查看完整内容,编辑后保存会写回文件,并通过开关启用/禁用技能或调整调用接口。
- 命令行工具:插件暴露了
skillmgr_list、skillmgr_get、skillmgr_save和skillmgr_policy等工具,支持在 Agent 脚本中调用。 - 混合目录扫描:插件同时扫描标准根目录(如项目
.dsh/skills或用户~/.dsh/skills,支持一层嵌套)和官方注册表ctx.skills。即使主机平面文件系统提供程序被禁用,磁盘上的技能也能被显示。 - 配置修改机制:启用/禁用功能通过修改
SKILL.md的前几行(disable-model-invocation/user-invocable)实现,其他前几行内容保持不变。修改会被 DSH 在重新发现时自动读取。 - 安全限制:仅对有真实文件路径的技能提供编辑功能(运行时或打包技能显示为只读),且路由仅限回环访问。
安装与启用¶
安装该插件需要使用 DSH 的 Web 配置文件。执行以下命令:
dsh plugin --profile web add github:zhengjy01/dsh-skill-studio
安装完成后,需要重启 dsh web 进程以激活插件。该插件不依赖构建步骤,lib/ 目录包含纯 ESM 代码。
典型用法¶
Web 界面操作:进入 Web 设置页面的“设置 → Skill 管理器”,可以看到带有来源徽章和调用状态的技能列表。点击技能可查看正文并编辑(保存后写回文件),通过切换按钮控制启用/模型可调用/用户可调用状态。
Agent 指令:也可以直接向 Agent 下达指令,利用 skillmgr_* 工具完成任务。例如:
* 列出所有 skill,并告诉我哪些被禁用了
* 帮我禁用 session-knowledge 技能
注意事项¶
- 前几行格式:
SKILL.md的前几行name字段必须与技能名称匹配(kebab-case),破坏前几行格式可能导致 DSH 在重新发现时跳过该技能。 - 编辑范围:编辑仅限于技能注册表报告的文件路径,插件不接受任意路径输入。
- 依赖与权限:除 DSH 对等包外无额外运行时依赖。插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
结尾¶
经过上面的步骤,即可在 Web 界面完成对 DSH 技能的集中管理。该插件为技能开发与调试提供了更直观的途径。