dsh-skill-manage：DeepSeek Harness 技能管理插件

前言¶

DeepSeek Harness (DSH) 支持通过配置文件或 .zip 包管理技能，但官方工具链中缺少对技能的启用、停用和删除控制。在现有方案下，开发者通常需要手动编辑文件来隐藏或禁用技能，操作繁琐且容易出错。dsh-skill-manage 插件为 DSH 补全了这一缺失的闭环，提供了可视化的设置面板以及供智能体直接调用的工具接口。

插件简介¶

这是一个面向 DeepSeek Harness (dsh) 的客户端插件，由开发者 lijian-ui 维护。它允许用户在设置面板中查看、启用、停用、删除技能，或通过 .zip 文件导入新技能。同时，它注册了一个名为 skill_manage 的智能体工具，支持在会话中通过代码创建、修改或删除技能文件。

所属分类：客户端
许可证：MIT
GitHub 地址：https://github.com/lijian-ui/dsh-skill-manage

核心功能¶

该插件实现了以下核心能力：

技能列表与搜索：按全局或工作区范围分组展示技能，支持搜索过滤。
启用/停用控制：提供开关切换，无需重启应用即可实时生效。
删除技能：通过确认对话框永久移除技能文件。
添加技能：支持上传 .zip 压缩包，自动解压并安装到全局技能目录。
技能详情：渲染技能内容为 Markdown，并展示前置元数据表。
Agent 工具 skill_manage：LLM 可直接调用的工具，支持 create、modify 和 delete 操作，并指定作用域（global 或 workspace）。

安装与启用¶

安装此插件需要 DSH 版本 >= 0.1.6-alpha.1。

确保你的 DSH Web 应用或官方桌面应用已更新至上述版本。
执行安装命令。注意 --profile 参数用于区分 Web 和桌面环境，插件是按配置文件隔离的。

dsh plugin --profile web add @lijian-ui/dsh-skill-manage

安装完成后，请重启 DSH 应用以加载插件。

典型用法¶

1. 通过设置面板操作¶

安装完成后，打开 DSH（Web 或桌面端），进入 Settings → Skill Manage。

启用/停用：点击技能卡片上的开关，即可在“启用”和“停用”状态间切换。插件通过重命名 SKILL.md 为 SKILL.md.disabled 来实现这一逻辑，DSH 的官方文件扫描机制会因此忽略该文件。
删除：点击删除按钮，按确认移除技能。
查看详情：点击技能卡片，查看其渲染后的 Markdown 内容及元数据。
搜索与导入：使用搜索框过滤技能，点击 “Add skill” 并选择 .zip 归档文件即可导入。

2. 通过 Agent 工具操作¶

在 DSH 的智能体会话中，LLM 可以调用 skill_manage 工具进行编程化操作。该工具的参数如下：

参数	类型	必需	描述
`action`	`create` \| `modify` \| `delete`	是	执行的操作类型
`name`	string	是	技能名称（仅允许小写字母、数字和连字符）
`description`	string	仅 create	技能描述
`when_to_use`	string	否	技能触发条件
`content`	string	仅 create	技能正文（Markdown 格式）
`scope`	`global` \| `workspace`	否（默认 `global`）	作用域：`global` 写入 `~/.dsh/skills`，`workspace` 写入项目目录

delete：复用了 GUI 的删除逻辑。
workspace 作用域：插件会从当前会话的工作目录向上遍历，寻找包含 .git 目录的项目根目录，并将技能写入 <project>/.dsh/skills。

适用场景与注意¶

版本兼容性：插件 0.2.0 版本包含破坏性变更，RPC 协议已对齐官方 create 工厂，依赖项已移至 peerDependencies。如果你的环境使用的是旧版 dsh-desktop 0.5.0，可能存在兼容性问题。
配置文件隔离：Web 和桌面是两个独立的配置文件，插件安装后仅对当前激活的 Profile（web 或 desktop）可见。
权限与安全：插件以当前 DSH 进程的权限运行，读写技能文件。建议在安装前查看源码并确认许可证。

总结¶

dsh-skill-manage 解决了 DSH 在技能管理上的核心痛点，将原本需要手动编辑文件的操作转化为直观的 UI 交互和标准的 LLM 工具调用。对于需要精细化管理技能链路或通过智能体自动部署技能的开发者而言，这是一个实用的工具。