dsh-skill-manager-97118467

让 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 里看不到、调不了技能吗?

一句话: 如果你的 DSH 技能列表是空的 / 侧边栏没有技能入口 / 对话里调用技能报错,而你明明往 ~/.claude/skills、~/.agents/skills、~/.codex/skills、~/.gemini/skills 里装过技能——这个项目就是为修这个问题写的。

可直接用来搜索的关键词: DSH 看不到技能 · DSH 技能列表为空 · dsh skill not showing · DeepSeek Harness skills empty · skill unknown or no longer available · skill tool returns nothing · dsh-skill-filesystem inactive · dsh-client-ui-skill absent · SKILL.md 不生效 · 技能库不显示 · AI 技能管理 · machine-wide skill manager

📖 逐条排障手册 → docs/TROUBLESHOOTING.md(4 个断点分别判断、装完仍看不到的检查清单)

If your DeepSeek Harness shows no skills, this project fixes that.

Search terms this page answers: dsh skill not showing · deepseek harness skills empty · skill unknown or no longer available · dsh skill tool returns nothing · dsh-skill-filesystem inactive · dsh-client-ui-skill absent · SKILL.md not loaded · machine-wide AI skill manager · claude code codex gemini skills unified

😩 你是不是也这样?

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

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

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

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

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

💡 它是怎么帮上忙的

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

✨ 核心能力

🖼️ 它长什么样

图(面板截图):左侧分类栏 + 中间技能列表 + 详情抽屉。

支持的技能来源(默认自动扫描):

可在配置里自定义扫描根,也可开启扫描 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 目录下的 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 服务:扫描 / 分类 / 安装 / 删除 / 导出(依赖 DSH 运行时)
├── client.js          # Client 面板:React 侧边栏 UI + `/` 选择器(中英双语)
├── remote.js          # Typert Remote 协议描述(20 个方法)
├── cordis.patch.yml   # 插件挂载行
├── lib/
│   ├── skill-model.js       # 纯领域逻辑:frontmatter / 发现 / 合并 / 分类(零依赖,可单测)
│   ├── remote-marker.js     # 手写 ESM 的 Remote 标记装配
│   └── yaml.js              # 轻量 YAML 读取
├── test/
│   └── skill-model.test.js  # 单元测试(node --test,零依赖)
├── tools/
│   └── check-inject.mjs     # 注入依赖守卫(拦截"侧边栏不显示"那类故障)
└── package.json

🛠️ 开发

# 无需安装依赖 —— 运行时全部由 DSH 提供

npm test                        # 单元测试(21 项,零依赖)
node tools/check-inject.mjs     # 校验注入依赖完整性

• 领域逻辑(lib/skill-model.js)不依赖 DSH,可在任意 Node 环境直接测试。
• Host 半边(index.js)是 TypertRemoteService,提供 ctx.remote.skillManager 命名空间。
• Client 半边(client.js)由 Web 页面从同一个包的 ./client 导出加载。
• 本包是手写 ESM,因此 @Remote 标记是编程式装配(applyRemoteMarkers),而非装饰器解析。
• CI 在每次 push / PR 上跑:单元测试 + manifest 校验 + 注入守卫 + 语法检查。

📄 License

MIT © 技能仓库 contributors

⭐ Star 一下

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