技能仓库 971184676/dsh-skill-manager

技能仓库 · DSH Skill Manager

让 DSH 里「看不见、复用不了」的技能重新可见、可用。 一个装进 DeepSeek Harness 的「全机器技能库管理器」——把散落在 Claude / Codex / Gemini / DSH 等各个 AI 工具里的技能收拢到一处，统一查看、分类、安装、删除。

Make the skills you already downloaded visible and reusable inside DSH. A machine-wide skill library manager for the DeepSeek Harness — discover, de-duplicate, categorize, install, and remove skills across every AI tool on your machine.

😩 你是不是也这样？

痛点一：DSH 里看不到技能库 你在别处下载了一大堆 skill，但装进 DSH 之后——看不见。不知道装了哪些、叫什么、干什么用。技能对 DSH 来说像是一个「黑盒目录」。

痛点二：下载的 skill 复用不了 明明已经下载到电脑上了，换一个工具就用不了；或者根本想不起来自己装过什么，于是又去下载一遍。技能躺在硬盘上，却等于不存在。

痛点三：多个 Agent 的技能目录一片混乱 你同时用 Claude、Codex、Gemini、DeepSeek Harness，于是：

- 技能散落在 ~/.claude/skills、~/.codex/skills、~/.gemini/skills、~/.agents/skills 好几个地方
- 同一个技能装了好几份，重复、占空间、版本还不一致
- 想知道「我到底装了多少」只能一个个文件夹翻
- 想清理某个技能，得手动去对应文件夹里删——搞不好删错工具的那份

技能仓库把这一切收进 DSH 侧边栏一个面板：一次扫描，全机器技能尽收眼底。

💡 它是怎么帮上忙的

| 你遇到的 | 技能仓库做的 |
| 技能看不见 | 侧边栏面板列出全部技能——名称、描述、分类、装在哪些工具里，一目了然 |
| 装了却用不上 | 技能可见即可复用：只要位于 DSH 加载的根目录，在对话中就能直接调用 |
| 到处找技能 | 全机器扫描 ~/.claude、~/.codex、~/.gemini、~/.agents 及 DSH 内置目录 |
| 重复/版本不一 | 按 name 合并去重，一条记录列出全部安装位置 |
| 清理混乱 | 统一面板删除（进回收站可恢复），不用再去猜哪个目录对应哪个工具 |

关于「在对话中调用」：调用本身由 DSH 原生技能机制完成——它会自动加载技能根目录。本插件负责让这些技能可见、可管、装对位置；一旦就位，你在对话里就能像平常一样使用它们。这不是「另一个调用入口」，而是把原本看不见、想不起、用不上的技能重新接回你的工作流。

✨ 核心能力

| 能力 | 说明 |
| 🧲 全机器扫描 | 自动发现各 AI 工具的技能目录，一次扫完 |
| 🧩 合并去重 | 同一技能装在多个工具里 → 合并为一条，列出全部安装位置 |
| 🏷 自动分类 | 内置规则引擎（前缀 + 关键词）自动归类；可自定义分类 |
| ➕ 添加 | 从本地文件夹或 Git 仓库一键安装 |
| 🗑 安全删除 | 删除先进回收站，可恢复；只读源自动保护 |
| 📤 导出清单 | 一键导出 Markdown / CSV / JSON 清单 |
| ⭐ 收藏与别名 | 给常用技能加星、改中文名 |
| 🌐 中英双语 | 界面、导出清单均支持中英 |
| 🔒 安全加固 | 路径穿越防护、命令注入防护、大小/深度限制 |

🖼️ 它长什么样

图（面板截图）：左侧分类栏 + 中间技能列表 + 详情抽屉。

支持的技能来源（默认自动扫描）：

| 工具 | 默认扫描路径 | 可编辑 |
| DSH / Claude | ~/.claude/skills | ✅ |
| Codex | ~/.codex/skills、~/.codex/vendor_imports | ✅ |
| Gemini | ~/.gemini/skills | ✅ |
| AGENTS 通用标准 | ~/.agents/skills | ✅ |
| DSH 内置办公技能 | <安装目录>/resources/runtime/office-skills | ❌ 只读 |

可在配置里自定义扫描根，也可开启扫描 Claude 插件市场缓存（默认只读）。

🚀 安装

⚠️ 前置条件：已安装 DeepSeek Harness（DSH） 0.2.0-rc.2 或更新版本。本插件是 DSH 的一个 Cordis 插件，依赖 DSH 提供的运行时。

方式一：链接本地源码（推荐，开发者）

1. 克隆本仓库：
git clone https://github.com/971184676/dsh-skill-manager.git

2. 在你的 DSH profile（~/.dsh/profiles/desktop/package.json）里，把插件链接进去： {
"dsh": { "profile": { "bundles": [ "…", "@local/skill-manager" ] } },
"dependencies": { "@local/skill-manager": "link:/abs/path/to/skill-manager" }
}

并在该 profile 的 cordis.patch.yml 里加入一行:
- insert:
- id: skill-manager
name: '@local/skill-manager'
config: {}

3. 重启 DSH，左侧栏出现「技能」面板。

方式二：通过 DSH 的 plugin_manager

在 DSH 的创造模式里让它帮你安装并验证（见下方「让 Agent 帮你装」）。

🤖 让 Agent 帮你装（创造模式）

在 DSH 里新建任务 → 选创造模式，然后说：

把这个技能仓库装进 DSH 并验证面板能打开

⚙️ 配置

在 cordis.patch.yml 的 config 里可调：

| 配置项 | 默认 | 说明 |
| home | DSH home 下 skill-manager | 清单 / 回收站 / 日志的存放目录 |
| extraRoots | [] | 额外的扫描根目录数组 |
| includePluginCache | false | 是否把 Claude 插件市场缓存也纳入扫描（只读） |
| cacheTtlMs | 15000 | 扫描缓存有效期 |

你的分类、别名、收藏等个人数据保存在 home 目录下的 catalog.json，不会污染技能文件夹。

🔐 安全设计

开源前经过一轮安全审查，关键防护：

- 路径穿越防护 —— 安装时校验目标路径不逃逸出选定根目录
- 命令注入防护 —— git 以数组参数调用，不经 shell 字符串拼接
- 删除进回收站 —— 移入 trash 而非硬删，支持恢复 / 彻底清除
- 只读源保护 —— 内置 / 市场等只读技能禁止删除
- 资源上限 —— 扫描深度、文件大小、安装体积、回收站条数均有限制，防 DoS
- 名称白名单 —— 技能名需匹配 ^[a-z0-9]+(?:-[a-z0-9]+)*$
- 无硬编码路径 —— 全部基于 homedir() / DSH home 解析，不含任何个人信息
- 零外部依赖 —— 仅用 Node 内置模块 + DSH 官方 peerDependencies

ℹ️ Git 安装支持 https://、git@、ssh:// 以及 file://（本地仓库）。若不需要本地仓库能力，可自行移除该分支。

🧩 内置分类（可自定义）

飞书办公 Cloudflare/云平台 视频与动画 Office 文档 技能管理 前端与设计 开发方法论 未分类

- 规则：前缀精确 > 关键词 > 兜底
- 分类可增删改名，单个技能也可手动改分类（手动优先于自动）

📁 项目结构

skill-manager/
├── index.js # Host 服务:扫描 / 分类 / 安装 / 删除 / 导出 ├── client.js # Client 面板:React 侧边栏 UI(中英双语) ├── remote.js # Typert Remote 协议描述 ├── cordis.patch.yml # 插件挂载行 ├── lib/ │ ├── remote-marker.js # 手写 ESM 的 Remote 标记装配 │ └── yaml.js # 轻量 YAML 读取 └── package.json

🛠️ 开发

无需安装依赖 —— 运行时全部由 DSH 提供改完代码后,在 DSH 里重启/刷新即可生效

- Host 半边（index.js）是 TypertRemoteService，提供 ctx.remote.skillManager 命名空间。
- Client 半边（client.js）由 Web 页面从同一个包的 ./client 导出加载。
- 本包是手写 ESM，因此 @Remote 标记是编程式装配（applyRemoteMarkers），而非装饰器解析。

📄 License

MIT © 技能仓库 contributors

⭐ Star 一下

如果这个项目帮到你了，欢迎点个 ⭐ Star，并分享给同样被「技能散落各处」折磨的朋友！