技能管理器 tuogusa/dsh-skill-manager

dsh-skill-manager

DeepSeek Harness (DSH) 技能管理器（host + client 一体包）。

功能

- 设置 → 技能：列出全部用户技能（含来源目录：项目/DSH-Home/用户目录）
- 按名称/描述搜索，显示技能大小与文件数、user-invocable / disable-model-invocation 标记
- 复制技能路径、删除用户技能（仅限已知用户技能根之下，防路径逃逸）
- 会话级撤回：删除技能时先移入同盘隐藏回收目录，当前会话内可一键恢复；也支持“彻底删除”和查看最近删除列表
- 版本检测与更新：支持在 SKILL.md 中声明 version / repository / sourcePath，从 GitHub/Gitee 检查最新 Release；有新版本时显示更新按钮，已最新时显示版本号

安装

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

兼容 Profile：web（DSH Web GUI）。

然后按 dsh 引导添加 pnpm-workspace.yaml 的 allowBuilds 条目，重启 DSH 并 Ctrl+Shift+R 刷新浏览器。

更新

方式一：CLI 更新（推荐）
dsh plugin --profile web update dsh-skill-manager

方式二：重新从 GitHub 源安装/更新
dsh plugin --profile web add github:tuogusa/dsh-skill-manager

说明：dsh plugin 是 pnpm 的前置转发器，update 会按当前依赖声明重新解析该包；通过 github:tuogusa/dsh-skill-manager 安装时，会更新到仓库默认分支的最新提交。本插件的“技能更新”功能更新的是用户技能（SKILL.md 中声明 repository 的 Release），不是插件自身；插件自身请用上面的 CLI 命令更新。

结构

- lib/index.js — 主机侧：/api/skill-manager/list、/api/skill-manager/delete、/api/skill-manager/trash、/api/skill-manager/undo、/api/skill-manager/purge、/api/skill-manager/check-update、/api/skill-manager/update
- lib/update.js — 更新检测/版本比较/清单/下载解压工具
- lib/client.js — 浏览器侧：设置 → 技能 分区
- test/delete-undo.test.mjs — 删除/撤回/彻底删除的验证测试
- test/update.test.mjs — 更新检测/更新流程的验证测试（npm test）

删除/撤回 API

- POST /api/skill-manager/delete { path } → 移入会话回收站，返回 { undoId }
- GET /api/skill-manager/trash → 当前会话可撤回的删除列表
- POST /api/skill-manager/undo { id } → 恢复技能到原路径
- POST /api/skill-manager/purge { id } → 彻底删除回收站中的技能

回收目录位于各技能根目录的同级隐藏目录 .dsh-skill-manager-trash；插件重启时会自动清理，保证“仅当前会话可撤回”。

更新检测/更新 API

- POST /api/skill-manager/check-update { path } 或 {} → 检查单个/全部技能更新，返回更新状态
- POST /api/skill-manager/update { path } → 下载最新 Release 并整体替换技能目录，失败自动回滚

SKILL.md 可选元数据

name: demo
description: ...
version: 1.2.0
repository: https://github.com/owner/repo
sourcePath: . # 可选；仓库内技能所在子目录，默认仓库根目录

本地清单

更新状态会缓存到 $DSH_HOME/.dsh-skill-manager.json，避免每次打开设置页都请求外网。

扫描根（与 dsh-skill-filesystem 一致）

- /.agents/skills、/.dsh/skills
- $DSH_HOME/skills、~/.agents/skills

License

MIT