前言¶

在 DeepSeek Harness（DSH）的插件生态中，skill 可以出现在多个层面。随着可用 skill 增多，需要频繁决定：某个 skill 是否全局启用，新对话默认加载哪些，当前会话临时启用哪些，哪些用户 skill 需要删除。

dsh-skill-manager 是一个面向 DeepSeek Harness 的 Skill 管理插件。它把上述操作集中到界面和少量接口里，方便在对话前、对话中和设置页管理 skill 可见性。

插件定位¶

• 名称：dsh-skill-manager
• 版本：0.1.0
• 许可证：MIT
• 仓库：https://github.com/CLAPEILL/dsh-skill-manager
• 依赖声明：peerDependencies 包含 react ^18.2.0 和 @deepseek-ai/cordis ^4.0.1

该插件用于全局启用/禁用 skill、按工作区设置新对话默认加载的 skill、在对话中调整当前会话 skill，以及删除用户 skill。

核心功能¶

下面介绍已核实的几项能力。

新对话前选择 skill¶

新对话屏幕会在 composer 上方显示“对话 Skill” chip。可以先选择本次会话可加载的 skill，再输入第一条消息。

可选操作包括：

• follow workspace default
• enable everything
• choose exactly which skills this conversation may load

选择后保存，再开始对话。

全局启用或禁用 skill¶

可以在设置中全局启用/禁用任意 skill。

被禁用的 skill 会从以下位置消失：

• 模型会话 skill 目录
• / 输入触发
• skill 工具
• /name gesture

禁用操作不触碰 skill 文件，重新启用后立即恢复。

按工作区设置默认 skill¶

可以在 Settings → Skill 管理 中为工作区设置新对话默认值：

• all available
• only these skills

该工作区的新对话会按所选默认值开始。

对话中调整 skill¶

对话头部有 Skill 按钮。点击后可查看当前会话有效 skill 集合，并选择：

• follow workspace default
• enable everything
• choose exactly which skills this chat may load

调整后，下一条消息会自动重新发布会话 skill 目录。

删除用户 skill¶

可以删除用户 skill，并永久移除以下路径中的 skill 文件：

• ~/.dsh/skills
• ~/.agents/skills

project、custom 和 bundled skills 不能通过此插件删除。

展示 skill 的中文说明¶

插件会从 skill 自身的 SKILL.md frontmatter 的 metadata 中读取并展示：

• intro
• detail

安装与依赖¶

安装命令为：

pnpm install

插件的 package.json 声明了以下 peerDependencies：

{
  "react": "^18.2.0",
  "@deepseek-ai/cordis": "^4.0.1"
}

由于插件会以当前 dsh 进程权限运行，安装前应检查源码与许可证。

典型用法¶

在设置中设置工作区默认¶

1、打开 Settings → Skill 管理。
2、为目标工作区选择 all available 或 only these skills。
3、保存设置。

在新对话前选择 skill¶

1、进入新对话屏幕。
2、在 composer 上方的“对话 Skill” chip 中选择 follow workspace default、enable everything 或 choose exactly which skills this conversation may load。
3、保存选择，然后输入第一条消息。

在对话中调整 skill¶

1、在对话头部点击 Skill 按钮。
2、查看当前会话有效 skill 集合。
3、选择 follow workspace default、enable everything 或 choose exactly which skills this chat may load。
4、发送下一条消息，使会话 skill 目录重新发布。

通过接口管理¶

以下修改类接口需要请求头：

x-dsh-skill-manager: 1

替换全局禁用集合：

POST /plugins/dsh-skill-manager/global
body: { names }

设置工作区新对话默认：

POST /plugins/dsh-skill-manager/workspace
body: { cwd, mode, selected }

覆盖单个会话 skill 集合：

POST /plugins/dsh-skill-manager/session
body: { sessionId, mode, selected }

删除用户 skill：

POST /plugins/dsh-skill-manager/delete
body: { name }

在 SKILL.md 中提供说明¶

在 SKILL.md frontmatter 的 metadata 中提供：

metadata:
  intro: <一句话中文简介，列表展示>
  detail: |-
    <详细中文介绍，详情弹窗展示：用途/适用场景/工作流程/典型触发语/产出物>

状态与限制¶

插件状态保存在：

<dshHome>/plugin-data/skill-manager/state.json

禁用 skill 不会修改 skill 文件；删除操作只作用于用户 skill。project、custom 和 bundled skills 不在可删除范围内。

适用场景¶

dsh-skill-manager 适合需要频繁调整 skill 可见性的 DeepSeek Harness 使用者，例如：

• 在不同工作区使用不同默认 skill
• 在单次对话中临时只启用部分 skill
• 全局关闭不再使用的 skill
• 清理用户 skill

使用注意：

• 删除用户 skill 会永久移除对应文件，操作前确认目标 skill。
• 修改类接口要求 x-dsh-skill-manager: 1 请求头。
• 安装前应检查源码与许可证。

获取¶

dsh-skill-manager 的价值在于把 skill 的全局、工作区和会话级管理放到同一界面。已核实事实中未提供目录页地址；GitHub 仓库地址为：

https://github.com/CLAPEILL/dsh-skill-manager