前言¶

DSH 的 skill 机制让开发者可以自定义行为，但现有的 skill 文件系统只能读取，无法集中编辑和管理。本地 skill 存放在 ~/.dsh/skills 和 <项目>/.dsh/skills，分散在多个目录，需要逐个打开编辑。

dsh-skill-manager 插件在 DSH 的「设置」里提供了一个统一的技能管理界面，支持浏览、编辑、新建、删除和启停全局及项目 skill。

插件定位¶

dsh-skill-manager 是一个本地目录型插件，由 Wyxcn445 维护。它通过在 DSH 设置中集成一个「Skill 管理」面板，解决 skill 文件分散、难以批量管理的问题。

核心功能¶

双来源合并¶

插件同时展示全局根（~/.dsh/skills）与当前项目的 skill，按 DSH 的优先级规则合并同名条目。

无损编辑¶

直接编辑 SKILL.md 全文（frontmatter + 正文），保存时原样写回，不做 YAML 重排。

两个开关¶

模型可调用（disable-model-invocation）、用户可调用（user-invocable），点击即时写盘。

新建骨架¶

在任意扫描根下生成 <name>/SKILL.md，自动带好合法 frontmatter。

删除有备份¶

删除前把整个目录/文件复制到 ~/.dsh/skill-manager-backups/<时间戳>/。

诊断提示¶

name 不是 kebab-case、缺 description、调用开关取值非法等会被标出来。

自定义根¶

额外扫描任意目录，配置存于 ~/.dsh/skill-manager-config.json。

扫描根与优先级¶

与 @deepseek-ai/dsh-skill-filesystem 保持一致，rank 小者优先：

「项目根」取最近的含 .git 的祖先目录；没有 .git 时用你填写的目录本身。

skill 格式¶

目录型 <name>/SKILL.md 或单文件 <name>.md，只认扫描根下的一层。frontmatter 示例：

---
name: my-skill
description: Use when the user asks to …
whenToUse: 可选，补充触发场景
disable-model-invocation: true   # 可选，阻止模型看到它
user-invocable: false            # 可选，阻止 /my-skill 手动调用
---

name 必须是小写 kebab-case，description 必填，否则 DSH 会跳过该 skill。

安装与启用¶

在 DSH 里用 plugin_manager 安装（target 填本目录绝对路径）：

action: install_bundle
target: C:\Users\32474\Desktop\开源项目\dsh-skill-manager

安装后打开 设置 → Skill 管理（在「规则管理」下面）。

本地目录安装是 link 到本目录，不是拷贝。移动或删除本目录会让插件失效，需要重新安装。

典型用法¶

1. 顶部「项目」框填入要扫描的项目路径（默认取第一个工作区），留空则只扫描全局 skill。
2. 左侧列表点选 skill，右侧即可编辑 SKILL.md 全文，Ctrl+S 保存。
3. 卡片上的「模型 / 用户」两个胶囊开关可即时启停，无需手动改 frontmatter。
4. 「＋ 新建 skill」会在选定的根下生成 <name>/SKILL.md 骨架。
5. 「删除」会先整份备份到 ~/.dsh/skill-manager-backups/<时间戳>/。

适用场景与注意¶

适合需要批量管理多个 skill 的开发者，特别是使用项目级 skill 的团队。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

生态背景¶

DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

短结尾¶

dsh-skill-manager 提供了集中管理 DSH Skills 的本地界面，支持浏览、编辑、新建、删除和启停，适合需要精细控制 skill 的开发者。