asakumizy/dsh-local-skills

dsh-local-skills

一个 DeepSeek Harness 插件，在 Web UI 中为你提供一个本地 SKILL 浏览器。

- 获取本地 skill — 扫描本地目录（默认 ~/.dsh/local-skills，可用 skillDirs 配置更多目录），识别目录形式的 /SKILL.md 和扁平 .md 两种 skill 文件（带 YAML frontmatter）。
- 实时更新 — 用 chokidar 监听这些目录，skill 新增 / 修改 / 删除后，模型目录和网页 UI 都会实时刷新。
- 在网页查看 skill — 在 Settings（设置）里新增一个 Skills（技能） 页面，列出所有可用 skill 的名称、描述和适用场景。
- 使用按钮 — 每个 skill 都有「使用」按钮，点击后会告诉你如何让模型使用这个 skill（输入 /name 或直接点名 skill），并可以一键复制示例提示。

Skill 文件格式

目录形式（推荐，可带资源文件）：

name: code-review
description: Review code for correctness, style, and security
whenToUse: When the user asks to review or audit a diff
disable-model-invocation: true   # 可选：禁止模型自动调用
user-invocable: false            # 可选：禁止用户直接调用

（这里是 skill 的正文说明）

扁平形式：直接把上面的内容保存为 code-review.md。

name 必须是 kebab-case（小写字母、数字、连字符），如 code-review。

安装

dsh plugin --profile web add

安装后重启 web：

dsh web

配置

在 web 的 Plugins 设置页（或 cordis.patch.yml）里配置 local-skills：

- skillDirs: 要扫描的额外目录（绝对路径或 ~ 开头的路径）；留空则默认扫描 ~/.dsh/local-skills。
- watch: 是否实时监听文件变化（默认 true）。
- providerName: skill 的 provider 标签（默认 local-skills）。

也可以在 ~/.dsh/profiles/web/cordis.patch.yml 里覆盖：

- id: local-skills
config:
skillDirs:
- ~/my-skills
- D:/work/skills

工作原理

- Host 半（lib/index.js）：一个 SkillProvider，注册进 host 的 ctx.skills 注册表；扫描目录 + chokidar 监听 + control.invalidate() 实时失效。
- Client 半（lib/client.js）：一个 Settings 区块，读取已有的 skill.list API（它会合并 host 全局与当前 preset 作用域的 skill），每 3 秒轮询一次并订阅会话切换，实现实时展示。

平台兼容性（web / desktop / tui / headless）

- Host 半（lib/index.js）是纯 Cordis 插件，只依赖 ctx.skills（由 dsh-base 在任何 profile 都提供），因此天然兼容 web、desktop（内嵌 Web 界面的桌面 App）、tui、headless 等任意 profile —— 只要该 profile 装了本插件 bundle 且挂了 dsh-skill 就会生效，缺 skills 服务时只是不激活、不会崩。
- Client 半（lib/client.js，dsh.client.platform: "web"）是浏览器 bundle，在 web 浏览器和任何以浏览器内核渲染的桌面端都会显示「设置 → 技能」页；纯终端（tui）没有浏览器 UI，不加载 client 半。
- 安装到任意 profile：dsh plugin --profile  add （pnpm 需要可用），或手动把包放进 $DSH_HOME/profiles/node_modules 并把包名加入该 profile 的 dsh.profile.bundles。

skills.sh