DaLongggggg/dsh-skill-manager#plugin

在 设置 → 技能 里集中管理 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：插件命令（推荐）

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

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

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：

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 一致）：

   - 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-<ver>.tgz，可直接 dsh plugin --profile web add https://github.com/DaLongggggg/dsh-skill-manager/releases/latest/download/dsh-skill-manager-<ver>.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