dsh-skill-manager

dsh-skill-manager

在 DeepSeek Harness 的设置面板里加一个「Skill 管理」分区（左栏导航，排在「Agent 预设」下方）， 用来查看和打理本机的 agent skill。

界面

设置
├── 通用设置
├── 模型
├── 内置插件
├── Agent 预设
└── Skill 管理   ← 本插件，order 30

页面本身：

• 顶部是搜索框 + 刷新按钮；
• 汇总行告诉你一共几个 skill、其中几个被禁用、扫了几个根目录；
• 卡片按"位置"分组，样式对齐内置「内置插件」页：一行一个分组，左侧箭头、 主标题是位置、副标题说明这是什么 + 几个，组与组之间一条细线；默认全部收起， 点整行展开/收起；
  • 项目级按具体项目分组（一个项目的 .dsh/skills 与 .agents/skills 合成一组）， 标题用缩短后的项目路径（~\Desktop\agent-test）——两个同名项目也能分辨；
  • 用户级、随包内置、运行时按来源分组：用户 .dsh → 用户 .agents → 随包内置 → 运行时；
  • 一搜索就自动把所有组摊开（既然是在找东西，就不该再点一遍箭头）；
• 卡片高度统一：描述固定两行（超出截断，鼠标悬停看全文），没有 description 的也占满两行， 所以一屏里的卡片块块对齐；
• 卡片内容：名字、来源标签、描述、缩短后的 SKILL.md 路径（主目录显示成 ~，悬停看全路径）， 以及按可得性出现的操作按钮。

按钮	出现条件	干什么
启用 / 禁用	文件系统上可写的 skill	SKILL.md ⇄ SKILL.md.disabled 改名（可逆）
打开目录	磁盘上存在的 skill	资源管理器定位到它
查看 / 收起	磁盘上存在的 skill	就地预览 SKILL.md 正文
删除	文件系统上可写的 skill	删掉整个 skill（内联二次确认，不可恢复）

一屏只留一个"实体按钮"（启用/禁用，描边），定位、预览、删除都做成轻量文字动作。

随包内置的（bundled）与运行时 provider 提供的 skill 只展示、只读。

它怎么认 skill

DSH 的 skill 是文件系统资源，插件的扫描规则与 @deepseek-ai/dsh-skill-filesystem 对齐：

根目录	source	rank
/.dsh/skills	project-dsh	100
/.agents/skills	project-agents	200
$DSH_HOME/skills（默认 ~/.dsh/skills）	user-dsh	400
$DSH_AGENTS_HOME/skills（默认 ~/.agents/skills）	user-agents	500
$DSH_BUNDLED_SKILL_DIR	bundled	600

项目根取 DSH 进程的工作目录，外加工作区账本（ctx.workspaceRegistry）里登记过的每个路径。

每个根下认两种形态：目录包 /SKILL.md，以及平铺文件 .md。 以 . 开头的条目（含 .system）一律跳过。

清单来自两处合并：

1. ctx.skills.list() —— DSH 实际认得的 skill，含随包内置与运行时 provider 注册的；
2. 磁盘扫描 —— 文件到底在哪、能不能动。

两者缺一不可：被禁用的 skill 只存在于磁盘上（注册表看不到它），而运行时 provider 的 skill 只存在于注册表里（没有文件）。页面会标出每个条目的来源；注册表整个不可用时，页面会明确提示 "现在只有磁盘扫描结果"。

实测结论（0.2.0-rc.2）：宿主插件上下文里的 ctx.skills.list() 只返回随包内置与运行时 provider 的 skill，看不到 skill-filesystem 提供的那批 —— DSH 的 skill 注册表可以由 agent preset 或 host composition 挂载，而文件系统 provider 挂在前者。所以页面上的文件系统 skill 一律来自磁盘扫描，这不是降级。GET /skill-manager/api/registry 能把各 cwd 的原始返回摊开看。

启用 / 禁用的机制

DSH 本身没有 skill 开关。这里用改名实现，且是双向可逆的：

//SKILL.md          ⇄  //SKILL.md.disabled
/.md                ⇄  /.md.disabled

.disabled 后缀不匹配 provider 的发现规则（目录包只认 SKILL.md，平铺只认 *.md）， 所以改完名下一条扫描就看不到它了；文件一个字节都没动，随时能改回来。

安全边界

所有文件动作的目标都不是从请求体里信任的，而是重新扫描后核对过的：

• 目标必须落在已知 skill 根目录之内；
• 必须是根下一层的 skill 条目（目录包或平铺文件），根目录自身不行；
• bundled 根下的一律拒绝（403）；
• 客户端传的路径先 resolve() 规范化，.. 穿越会被前缀检查挡掉。

HTTP API

全部挂在 /skill-manager/api：

方法	路径	说明
GET	/health	自检：home、agentsHome、bundledDir、注册表是否可用
GET	/list	完整清单：projects / roots / skills / registryAvailable
GET	/registry	诊断：把 ctx.skills.list() 的原始返回按 cwd 逐个摊开
POST	/toggle	{ target } → 改名启停
POST	/delete	{ target } → 删除
POST	/read	{ target } → 返回 SKILL.md 正文（>512 KB 拒绝）
POST	/reveal	{ target } → 资源管理器定位（仅 Windows）

安装

先克隆到本地（路径里别带空格），再用 dsh plugin 以 file: 依赖把它装进 profile：

git clone https://github.com/Nay-1/dsh-skill-manager.git C:/dsh-plugins/dsh-skill-manager
dsh plugin --profile desktop add "file:C:/dsh-plugins/dsh-skill-manager"

desktop 是 profile 名，按你自己的改。装完确认 profile 的 package.json 里 dsh.profile.bundles 有 dsh-skill-manager —— 只有进了 bundles，cordis.patch.yml 那行插入才会生效（dsh plugin add 通常会自动加，加不上就手动补一行）。

改了源码之后

pnpm 的 file: 依赖是拷贝而不是软链，而且它只看 lockfile：直接再 add 一次只会得到 Already up to date，磁盘上的拷贝不会更新。必须先 remove 再 add：

dsh plugin --profile desktop remove dsh-skill-manager
dsh plugin --profile desktop add "file:C:/dsh-plugins/dsh-skill-manager"

另外 host 半和 client 半都只在 DSH 启动时加载一次（没有热重载），改完必须重启桌面端。

卸载：

dsh plugin --profile desktop remove dsh-skill-manager

然后从 dsh.profile.bundles 里删掉同名条目。

改源码后必须重装一次再重启 DSH：pnpm 的 file: 依赖是拷贝而不是软链。

结构

dsh-skill-manager/
├── package.json          插件清单；dsh.bundle.patch 指到 cordis.patch.yml
├── cordis.patch.yml      bundle 层：插入本插件
├── lib/index.js          host 半：扫描 + HTTP API + 文件动作
├── lib/client.js         client 半：settings.section 页面
├── test-host.mjs         host 半自测（62 项）
└── test-client.mjs       client 半自测（43 项）

node test-host.mjs      # 临时目录里造真实 skill 树，打 API
node test-client.mjs    # mock Module Loader / React / fetch，真渲染一遍页面

已知限制

• 项目根靠猜：DSH 的 host 插件拿不到"当前会话的工作目录"，只能拿进程 cwd 和 工作区账本。项目级 skill 因此可能比你预期多列或少列几个。
• 不改 provider：禁用是磁盘改名，不是给 skill 系统加开关；正在跑的会话里已经加载过的 skill 不受影响。
• 删除就是删除：rm -rf 掉 skill 目录，没有回收站。
• 预览只显示 SKILL.md 原文（不渲染 Markdown），够用来核对内容。
• 非 Windows 平台没有"打开目录"，接口会返回 revealed: false。