技能管理器 EricXu20266/dsh-skillmanager

dsh-skillmanager

🌐 中文 | English

DSH 技能管理器——用图形界面查看和管理 DSH 的技能：列表、分组、启用/禁用、新建引导、LLM 审查。技能的创建与编辑交给宿主智能体（LLM）执行，本插件负责「看得清、管得住」。

DSH 的技能管理机制（背景）

DSH 的技能体系没有中心化注册表——文件即注册：把 <name>/SKILL.md 放进扫描根，宿主自动发现并纳入模型可用目录。

扫描目录（skill-filesystem 服务商默认根）

| 目录 | 来源标记 | 说明 |
| ~/.dsh/skills | user-dsh | DSH 自身技能目录 |
| ~/.agents/skills | user-agents | Agent Skills 开放规范共享目录（Claude Code、Codex、Cursor 等大量工具采用），跨工具复用 |
| <项目根>/.dsh/skills | project-dsh | 项目级 DSH 专属 |
| <项目根>/.agents/skills | project-agents | 项目级共享 |
| $DSH_BUNDLED_SKILL_DIR | bundled | 内置技能（可选） |

~/.agents 是 Anthropic 提出的 Agent Skills 开放规范的共享配置根（不是 Claude Code 的 ~/.claude），DSH 主动兼容——放进 ~/.agents/skills 的技能，任何兼容工具都能用。

调用方式（双通道）

1. 模型主动调用：每轮会话注入 <available_skills> 目录（技能名 + 500 字符截断描述），模型用 skill 工具加载完整指令
2. 用户显式调用：对话里输入 /<技能名>（kebab-case），宿主把技能完整指令注入上下文

权限开关（frontmatter）

| frontmatter | 模型调用 | 用户斜杠 |
| （缺省） | ✅ | ✅ |
| disable-model-invocation: true | ❌ | ✅（唯一入口） |
| user-invocable: false | ✅ | ❌ |

生效前提

技能要真正可用，会话必须挂载 skill-filesystem + tool-skill 插件——web 配置档默认 preset 为 standard（已挂载）；minimal 极简 preset 只有两个工具，没有技能能力。

插件作用：图形化管理

DHS 原生对技能只有「文件系统 + 会话注入」，你很难直观看到和管理。本插件在侧边栏提供「技能管理」面板：

- 技能列表：扫描文件系统（~/.dsh/skills、~/.agents/skills、$DSH_BUNDLED_SKILL_DIR），解析 SKILL.md frontmatter——不依赖 preset 是否加载服务商，管理以文件系统为准（面板看到 = 文件已落盘）
- 三视图：全部 / 按来源（user-dsh、user-agents、project、bundled）/ 按合集（metadata.group + subgroup）
- 双开关：「模型可以调用」「用户可调用」独立启停（写 frontmatter，DHS 原生读取）
- 合集管理：设置/清除 group/subgroup，组内一键全部启用/禁用
- 详情：触发时机、正文预览、文件路径
- 新建技能：引导 DSH 在 ~/.dsh/skills/<name>/ 创建（LLM 按提示词写入 SKILL.md）
- LLM 审查：一键生成审查提示词交给 DSH（指令质量/安全风险/改进建议），需要修改时直接编辑文件
- i18n：zh / en 双语

安装

从 GitHub 安装（首次需要允许构建，dsh 会给出提示，把包 key 加入 profile 的 pnpm-workspace.yaml allowBuilds）
dsh plugin add github:EricXu20266/dsh-skillmanager

或从 npm 安装（预构建产物，无需授权）
dsh plugin add dsh-skillmanager

使用

安装后重启 dsh 会话，侧边栏出现「技能管理」入口。新增/修改技能文件后 watcher 自动发现，无需重启。

开发

pnpm install
pnpm build # tsc 编译 host 侧 → lib/
pnpm bundle:client # tsdown 打包 client 侧 → client/client.js

开发期若配置档通过 file: 依赖引用本仓库，改代码后需手动同步构建产物到配置档的 node_modules（pnpm file: 依赖只复制一次，不感知源码变化），并重启 host。

许可

MIT