Chuyển đến nội dung chính

dsh-agent-skills

Đã xác minh

dsh-agent-skills · v0.1.14 · MIT · Giao diện web

Discover and manage Claude Code, Codex, Gemini CLI, and other Agent Skills inside DeepSeek Harness.

Cài đặt

dsh plugin add dsh-agent-skills

Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.

Mã nguồn

Thẻ

Tác giả

Readme

dsh-agent-skills

npm npm downloads license DeepSeek Harness plugin dsh-recommend

在 DeepSeek Harness 的设置页中查看、启停和管理本地 Agent Skills。

Agent Skills 设置页面

功能

  • 自动扫描 ~/.agents/skills、~/.claude/skills、~/.codex/skills、~/.config/opencode/skills 和 ~/.gemini/skills
  • 支持自定义技能目录
  • 按目录或单个技能启停
  • 搜索、查看描述并监听技能文件变化
  • 不修改原始 SKILL.md

安装

npm(推荐)

dsh plugin --profile web add dsh-agent-skills

安装后打开「设置 → Agent Skills」,点击「开启接管 DSH 技能」,再点击「重启 DSH」。

兼容性:dsh 0.1.x(含 0.1.7-rc)与 0.2.0-rc.1 起的 0.2.x 都可以用。

DSH 插件市场

在「设置 → 插件市场」中搜索 Agent Skills,或查看 DSH 插件市场。

GitHub

dsh plugin --profile web add github:minivv/dsh-agent-skills

Git 安装可能需要授权 pnpm 执行构建脚本。

使用

  1. 在「设置 → Agent Skills」中检查自动发现的目录,或点击「+ 添加目录」。
  2. 使用目录和技能开关控制可用技能。
  3. 出现技能变更提示后,点击「刷新页面」。
  4. 修改技能文件后,点击「重新扫描」或等待自动刷新。

点击「取消接管」并重启 DSH,可恢复 DSH 原来的技能来源。

设置保存在 $DSH_HOME/agent-skills/state.json。

技能格式

skills/
├── my-skill/
│   └── SKILL.md
└── another-skill.md

SKILL.md 需要 YAML frontmatter,name 使用小写 kebab-case:

---
name: my-skill
description: Explain when this skill should be used.
---

# Instructions

卸载

先在设置页点击「取消接管」和「重启 DSH」,再运行:

dsh plugin --profile web remove dsh-agent-skills

如果设置页无法打开,先恢复 DSH 技能来源:

DSH_INSTALL_ROOT="$(npm root -g)/@deepseek-ai/dsh" \
  node ~/.dsh/profiles/web/node_modules/dsh-agent-skills/scripts/uninstall-preset.mjs

dsh plugin --profile web remove dsh-agent-skills

开发

要求 Node.js 20+。

npm install
npm run typecheck
npm run build
npm test
npm pack --dry-run

兼容性

同一个版本同时支持 DSH 的两条发布线(0.1.5-rc.* 与 0.1.6-alpha.*,以及更早的 0.1.0-rc.*):

  • wire codec 同时提供旧版读取的 schema 和新版要求的 create(),客户端与宿主两面共用同一张描述表;
  • 宿主提供的 @deepseek-ai/* 依赖按名字解析,peerDependencies 只是兼容区间声明,不会把旧版依赖装进你的 profile。

「开启接管 DSH 技能」会自动识别 preset 的三种历史布局,不需要手动指定路径:

DSH 版本 preset 文件位置
早期(config/agent-presets) <@deepseek-ai/dsh>/config/agent-presets/<id>/agent.cordis.yml
0.1.0 ~ 0.1.6-alpha(dsh-agent-presets 包) <@deepseek-ai/dsh-agent-presets>/presets/<id>/agent.cordis.yml
0.1.7-rc.2 起(dsh-web-app 包) <@deepseek-ai/dsh-web-app>/presets/<id>.patch.yml

其他行为约定:

  • preset 包的解析始终优先「正在使用的那份」:升级 DSH 后常见的 dsh-agent-presets 残留即使与 dsh-web-app 同级共存,也不会被误选中改写;
  • Windows 与 POSIX 同等支持,路径比较统一按平台归一化后判定;
  • 接管只改写 skill-filesystem 行的 name,preset 行自带的 config(例如 cordis preset 的 customSkillDirs)保持原样,并且仍会被接管后的 provider 扫描;
  • 不含 skill-filesystem 行的 preset(如 minimal)不会被改动。

DSH 升级到新发布线后无需重新安装插件;只有 DSH 重新安装/升级覆盖 preset 文件时会丢失技能接管,重新点一次「开启接管 DSH 技能」即可。

注意

  • 技能名必须匹配 [a-z0-9]+(?:-[a-z0-9]+)*
  • DSH 升级后如果开关失效,重新开启接管并重启 DSH

链接

相关插件

  • dsh-activity-bell —— 侧边栏活动铃铛:会话跑完后铃铛显示红色角标,点一下把工作区列表换成按天分组的最近活动列表,没看过的完成项带绿点。

License

MIT