dsh-skill-manager

Readme

# dsh-skill-manager

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

## 功能

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

## 安装

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

**兼容 Profile**：`web`（DSH Web GUI）。



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

## 更新

```bash
# 方式一：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 可选元数据

```yaml
---
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