技能分类管理器 LIU20030725/dsh-skill-manager

dsh-skill-manager

DSH（DeepSeek Harness）技能分类管理器：自由分类 / 标签 / Collections（集合文件夹）+ 设置面板「技能管理」。
在 DeepSeek Harness 中按分类、标签和集合管理和组织你的 agent 技能。

把散乱的上百个 agent skills 按你的方式分类整理：给每个技能打上分类（category）和标签（tags），放进可点击的集合文件夹（Collections），在 DSH Web 的设置面板里一目了然地浏览、筛选、启用/停用。

功能特性

- 🗂️ 自由分类：给技能 frontmatter 写入 metadata.category，分类可自由创建、随时修改；
- 🏷️ 标签：写入 metadata.tags（逗号分隔，支持多个）；
- 📁 集合文件夹（Collections）：把多个技能组织成命名集合（如「AI视频工作流」），一个技能可属于多个集合；
- 顶部筛选区点击集合芯片 → 左侧只显示该集合内的技能；
- 集合内可直接点击技能查看简介、启用/停用、移除；
- 🔍 浏览与筛选：搜索、按分类筛选、按集合筛选；
- 👁️ 点击预览：左侧点击技能行即展开简介卡片（描述 / 适用场景 / 标签 / 启用状态）；
- 🔌 启用 / 停用：一键写入 frontmatter 的 disable-model-invocation（DSH 原生识别——停用后模型不再自动加载该技能），面板与命令均可操作；
- 🎯 输入框集合挑选：输入 / + 文件夹名 → 显示 📁 集合文件夹 → 点击弹出该文件夹的技能列表（带简介、可「← 返回」、保留滚动位置）；
- ⌨️ 斜杠命令：/skillmgr ... 全部功能可在对话输入框直接使用，命令不经模型；
- 💾 纯本地、无服务依赖：分类写进技能文件本身（兼容任何 agent），集合存本地 JSON。

图片演示

环境要求

- DeepSeek Harness（dsh web）0.1.0-rc.6+
- Node.js ≥ 20

安装

1) 安装（推荐：bundle 插件）

本插件声明了 dsh.bundle manifest，可直接用 DSH 的命令安装：

dsh plugin --profile web add github:LIU20030725/dsh-skill-manager

手动方式（在 DSH 的 web profile 目录，通常是 ~/.dsh/profiles/web）：

cd ~/.dsh/profiles/web
pnpm add github:LIU20030725/dsh-skill-manager

💡 若 github:LIU20030725/dsh-skill-manager 依赖解析失败，可改用完整 git URL：
pnpm add git+https://github.com/LIU20030725/dsh-skill-manager.git

2) 挂载插件

编辑该目录下的 cordis.patch.yml，在顶层数组中加入：

- insert:
- id: skill-manager
name: 'dsh-skill-manager'

3) 重启 Web

停止当前 dsh web 进程后重新启动（若有 dsh-web-service 守护会自动拉起）
dsh web
或
node /node_modules/@deepseek-ai/dsh/lib/bin.js web

重启后刷新页面：设置 → 技能管理 面板出现；对话输入 /skillmgr help 可查看命令。

⚠️ 必须重启：客户端面板 bundle 与宿主命令注册均在 Web 启动时加载，配置热更新无法加载新插件。

使用

设置面板「技能管理」

1. 左侧：全部技能列表；顶部「全部 / 分类芯片 / 📁集合芯片」筛选；点技能行展开简介卡片；
2. 右侧：选中技能后可
- 设置分类（自由输入或从已有分类中选择）；
- 设置标签（逗号分隔）；
- 勾选所属集合（加入/移出）；
- 启用 / 停用（写入 disable-model-invocation）；
3. 底部集合区：新建集合、点击展开查看集合内技能（可点技能查看详情、直接启用/停用、移除）。

输入框集合挑选

在对话输入框中输入 / 后继续输入集合（文件夹）名（如 /AI视频），下拉菜单「集合技能」分组会显示匹配的 📁 集合文件夹（含每个集合的技能数量；输入 / 时还会显示「未分类技能」文件夹）。

点击某个 📁 文件夹，会弹出一个小下拉页展示该集合内的所有技能（带简介）：

- 点选技能 → 输入框自动填入 /技能名，回车直接调用；
- 左上角「← 返回」→ 回到全部集合列表（保持原滚动位置）；
- 支持 ↑↓ 方向键选择、Enter 确认、Esc 关闭。

适合技能很多、记不清每个技能用途时，按文件夹逐级浏览挑选。

斜杠命令（全部功能等价）

/skillmgr help
/skillmgr catalog # 全部技能 + 集合（JSON） /skillmgr get # 单个技能详情（JSON） /skillmgr set-category # 设置分类；- 清除 /skillmgr set-tags # 设置标签；- 清除 /skillmgr set-enabled # 启用 / 停用 /skillmgr collection list # 列出集合 /skillmgr collection create # 新建集合 /skillmgr collection rename # 重命名 /skillmgr collection delete # 删除集合 /skillmgr collection add # 把技能加入集合 /skillmgr collection remove # 从集合移除技能 /skillmgr collection clear # 清空集合

数据与存储

- 分类 / 标签：直接写入技能文件 SKILL.md 的 YAML frontmatter（metadata: 下的 category / tags），不依赖嵌套目录，兼容所有 agent：

name: ai-video-script
description: 生成 AI 视频脚本 metadata: category: 视频创作
tags: [视频, 脚本]

- 启用/停用：写入顶层 disable-model-invocation: true（DSH 原生字段）。
- 集合（Collections）：存于 $DSH_HOME/skill-manager/collections.json（默认 ~/.dsh/skill-manager/collections.json）。

管理范围

可管理任何带磁盘路径、可写的技能（SKILL.md 所在文件），典型位置：

| 来源 | 路径 |
| 用户技能（本插件默认推荐） | ~/.agents/skills//SKILL.md、$DSH_HOME/skills//SKILL.md |
| 项目技能 | /.dsh/skills、/.agents/skills |
| DSH 内置技能 | node_modules/...（只读，面板中可见但写入会报错） |

卸载

cd ~/.dsh/profiles/web
pnpm remove dsh-skill-manager
并从 cordis.patch.yml 删除对应 insert 行，重启 dsh web

删除本插件不会删除技能文件里的分类/标签（它们属于技能本身），也不会删除 collections.json（如需清理手动删除该文件）。

工作原理（给开发者）

- 宿主半边（lib/index.js）：cordis 插件，inject: ['skills', 'commands']；通过 ctx.skills.list/get 以 scope: agent 读取会话可见的技能目录，读写 frontmatter 用 yaml，集合存本地 JSON；注册 skillmgr 斜杠命令。
- 浏览器半边（lib/client.js）：按 DSH 客户端插件 bundle 规范（window.__ModuleLoader__.load）打包，注册 settings.section（「技能管理」）；数据与操作通过 ctx.remote.commands.execute 调用宿主命令（与 DSH 自带 /permission 同一条可靠通道）。
- 开发脚本：scripts/test-manual.mjs（mock ctx 自测命令逻辑）、scripts/make-catalog.mjs（生成本地技能目录报告）。

常见问题（FAQ）

Q: 面板显示 0 个技能？
A: 确认插件已随 Web 重启加载；命令按当前会话 agent 的作用域查询技能，若在全新会话中先创建/打开一个会话再打开面板。

Q: 内置技能（node_modules 里的）不能打标签？
A: 是的，内置技能是只读的。请把要管理的技能放在 ~/.agents/skills 或 $DSH_HOME/skills。

Q: 停用技能后有什么效果？
A: 写入 disable-model-invocation: true，DSH 模型目录不再包含该技能（模型不会自动加载），但它仍保留在你的库中、仍可手动调用。

Q: 改了代码如何生效？
A: 把改动同步到 profile 的 node_modules/dsh-skill-manager（或重新 pnpm add file:）后重启 dsh web。

License

MIT