技能仓库 · 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 提供的运行时。
方式一:链接本地源码(推荐,开发者)
- 克隆本仓库:
git clone https://github.com/971184676/dsh-skill-manager.git
- 在你的 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: {}
- 重启 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,并分享给同样被"技能散落各处"折磨的朋友!
