dsh-skill-manager (plugin)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 🧰 DSH 技能管理器 · dsh-skill-manager

> 在 **设置 → 技能** 里集中管理 DSH 当前可调用的全部技能。
> **随 DSH 启动常驻运行，Windows / macOS / Linux 全平台适配。**

一个 DeepSeek Harness 插件，让 DSH 的技能库「看得见」：列表、搜索、查看完整文档、复制、打开文件夹、**软删除到回收站（可恢复）**、一键试用。

**English**: A DeepSeek Harness plugin that puts DSH's skill library in view — list, search, view (Markdown-rendered), copy, open the folder, soft-delete to a recoverable trash, and try a skill out — for the 设置 → 技能 page.

---

## ✨ 功能一览

| 功能 | 说明 |
| --- | --- |
| 📚 **技能总览** | 设置 → 技能，当前会话可调用的全部技能一屏列全 |
| 🔍 **即时搜索** | 按名称 / 简介 / 用途（whenToUse）/ 来源 / 调用状态实时过滤，中英文皆可 |
| 🔃 **排序 / 统计** | 可按名称 / 来源排序；顶部实时显示总数与「内置 / 扩展」分布 |
| 🏷️ **类型标签** | 内置 / 扩展 / 项目 / 插件，一眼分清来源 |
| 🧩 **卡片信息** | 名字下方直接展示单行简介 + 用途（whenToUse），并可标注「内部引用」 |
| 👀 **查看详情** | 弹层展示完整文档，内容**按 Markdown 渲染**（标题 / 代码块 / 列表 / 引用 / 表格 / 链接），不再是一坨纯文本 |
| 🏷️ **详情元信息** | 弹层顶部展示来源 / 版本 / 可调用状态 / 用途（whenToUse），一眼判断是否适用 |
| 🧭 **空态引导** | 无技能时提示放置位置；加载失败可一键重试 |
| 📋 **复制内容** | 一键把完整文档复制到剪贴板 |
| 📂 **打开文件夹** | Windows 资源管理器 / macOS Finder / Linux 文件管理器，直达技能目录 |
| 🗑️ **软删除 + 回收站** | 删除 = 移入回收站（可恢复），列表新增「回收站」入口，支持**恢复 / 彻底删除**；内置技能自动保护 |
| 🚀 **立即试用** | 一键关闭设置、新建会话，选好工作区后输入框自动预填 `/技能名 `（事件驱动，即点即用） |
| ⚡ **列表性能** | 简介按技能名缓存 + 只读 markdown 头部，多次刷新列表不再重读每个技能文件 |
| 🔄 **热拔插** | 技能增删后点「刷新」立即同步，无需重启 DSH |

**为什么省事？**

- ⚡ **免手动加载**：随 DSH 启动自动挂载，设置里常驻，开箱即用
- 🖥️ **三平台一致体验**：Windows / macOS / Linux 自动适配（打开文件夹、删除均按平台选原生命令）
- 🎯 **零学习成本**：入口就在设置面板里，和其他设置项一样自然
- 🔌 **纯原生实现**：不依赖 bash / shell 脚本，删除走 node:fs，打开文件夹走系统文件管理器

---

## 📦 安装

> 环境要求：DSH Web 版（`dsh web` / `dsh --profile web`），建议 `0.1.0-rc.6+`。零额外运行时依赖。

### 方式 A：插件命令（推荐）

```bash
dsh plugin --profile web add dsh-skill-manager
```

由 `dsh plugin` 自动完成依赖安装与 bundles 接线（插件声明了 `dsh.bundle`），之后重启 DSH 即可。从 GitHub 安装（注意包在 `plugin/` 子目录）：

```bash
dsh plugin --profile web add "github:DaLongggggg/dsh-skill-manager#master:plugin"
```

也可发布 npm 后用 `dsh plugin --profile web add dsh-skill-manager`（发布于 npm 时免构建授权）。

### 方式 B：GitHub Release 预构建 tarball

若仓库发布版本提供了 `.tgz`，可直接用 tarball：

```bash
dsh plugin --profile web add https://github.com/DaLongggggg/dsh-skill-manager/releases/latest/download/dsh-skill-manager-1.1.0.tgz
```

### 方式 C：手动链接 + 补丁行

1. 把 `plugin/` 目录放到本机任意路径；
2. 在 `$DSH_HOME/profiles/node_modules` 下创建指向 `plugin/` 的链接：
   - macOS / Linux：`ln -s /path/to/plugin "$HOME/.dsh/profiles/node_modules/dsh-skill-manager"`
   - Windows（PowerShell，无需管理员）：`New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-skill-manager" -Target "E:\workspace\dsh-skill-manager\plugin"`
3. 编辑 `$DSH_HOME/profiles/web/cordis.patch.yml` 追加（与包内 `cordis.patch.yml` 一致）：
   ```yaml
   - insert:
       - id: dsh-skill-manager
         name: dsh-skill-manager
   ```
4. 重启 DSH，打开左下角「设置 → 技能」即见 🎉

---

## 📂 目录结构

```
dsh-skill-manager/
├── README.md              # 本文档
├── LICENSE                # MIT 协议
├── CHANGELOG.md           # 变更日志
└── plugin/                # ✅ 正式分发内容（dsh.bundle 静态插件）
    ├── package.json       #   包元数据 + dsh.bundle + dsh.client 声明 + peerDependencies
    ├── cordis.patch.yml   #   补丁层：把本插件行插入 profile 层栈
    ├── lib/
    │   ├── index.js       #   Host 半部（Typert Remote 服务：list/detail/openFolder/delete/trashList/trashRestore/trashPurge/diag）
    │   └── client.js      #   浏览器 bundle（设置页 UI + Markdown 渲染 + 回收站）
    └── test/
        └── run-tests.mjs  #   单元测试（node plugin/test/run-tests.mjs）
```

---

## 🔧 注意事项

- **删除安全边界**：仅允许删除 `$DSH_HOME/skills` 与 `~/.agents/skills` 内的扩展技能；内置 / 项目技能不可删除。
- **软删除**：删除会把技能文件夹移动到分类根目录旁的 `.skill-trash/`（`$DSH_HOME/.skill-trash` 或 `~/.agents/.skill-trash`），可在「回收站」恢复或彻底删除；彻底删除不可恢复。
- **回收站路径**：每条回收站记录写有 `_dsh-meta.json`（技能名 / 来源 / 原始根目录），恢复时按此回到原位。

## 🧩 兼容版本与依赖

- 建议 **DSH Web `0.1.0-rc.6` 或更新**（依赖设置页 slot 与 Typert Gateway）。
- 运行时依赖：`@deepseek-ai/cordis`、`@deepseek-ai/dsh-typert-registry`（均为 peerDependency，已用语义化范围兼容 `0.1.0-rc.x` 预发布）。

## 📤 发布与安装渠道

- **GitHub Release tarball**（推荐）：每个版本附带预构建 `dsh-skill-manager-.tgz`，可直接
  `dsh plugin --profile web add https://github.com/DaLongggggg/dsh-skill-manager/releases/latest/download/dsh-skill-manager-.tgz`
- **npm**：发布后 `dsh plugin --profile web add dsh-skill-manager`（免构建授权，市场展示下载量）。包内 `repository` 字段已回指本仓库，npm 与仓库会自动关联。
- **源码**：`dsh plugin --profile web add "github:DaLongggggg/dsh-skill-manager#master:plugin"`（包在 `plugin/` 子目录）。

## ⚠️ 已知限制

- 详情 Markdown 渲染为**轻量实现**：不支持嵌套列表、定义列表、脚注、数学公式；复杂表格可能换行（水平滚动）。
- 列表「简介」依赖对技能文件头部的读取：若文件无 frontmatter 或读取失败，会回退显示 `description`。
- 回收站条目依赖随文件夹写入的 `_dsh-meta.json`：若被手动删除/修改，该条目在回收站中不可识别。

## 🔒 安全说明

- 纯本地操作：不向任何外部服务上报数据。
- 删除/打开文件夹仅作用于用户技能根目录（`$DSH_HOME/skills`、`~/.agents/skills`），内置/项目技能只读访问。
- 源码无混淆、无凭据外传、无异常安装期行为；安装无 postinstall/prepare 副作用。

## 📜 License

MIT © dsh-skill-manager contributors