前言¶
在 DSH 中使用本地 skill 时,经常需要先确认文件名称、描述和适用场景,再决定如何把 skill 交给模型。asakumizy/dsh-local-skills 是一个 DeepSeek Harness(DSH)插件,为 Web UI 提供一个本地 SKILL 浏览页,把本地目录中的 skill 文件整理到设置页中,并给出调用方式。
这是什么¶
它由 asakumizy 维护,许可证为 MIT。插件的定位是:在 DSH Web UI 中浏览本地 SKILL,查看名称、描述和适用场景,并通过“使用”按钮获取调用提示。
核心功能¶
本地 SKILL 浏览器¶
插件扫描本地目录,识别两种 skill 文件形式:
- 目录形式:
<name>/SKILL.md - 扁平形式:
<name>.md
这些文件需要带 YAML frontmatter,且 name 必须是 kebab-case,例如 code-review。
实时刷新¶
新增、修改、删除 skill 后,模型目录和网页 UI 会实时刷新。该行为由 watch 配置控制,默认 true。
网页查看¶
插件在 Settings 中提供 Skills 页面,列出可用 skill 的名称、描述和适用场景。
使用按钮¶
页面中的 skill 条目提供“使用”按钮。点击后会说明如何调用该 skill:输入 /name 或直接点名 skill,并可一键复制示例提示。
安装与启用¶
README 给出的安装命令使用占位符 <path-to-this-package>,执行前需要替换为本包路径。
1、安装到 web profile:
dsh plugin --profile web add <path-to-this-package>
2、重启 Web:
dsh web
如果要安装到任意 profile,可以使用:
dsh plugin --profile <name> add <path>
README 提到这种方式下 pnpm 需要可用。也可以手动把包放进:
$DSH_HOME/profiles/node_modules
并把包名加入该 profile 的 dsh.profile.bundles。
配置¶
安装到 web profile 后,可以在 web 的 Plugins 设置页或 cordis.patch.yml 中配置 local-skills。
常用配置项:
skillDirs:要扫描的额外目录,使用绝对路径或~开头的路径;留空则默认扫描~/.dsh/local-skillswatch:是否实时监听文件变化,默认true
在 ~/.dsh/profiles/web/cordis.patch.yml 中可以这样覆盖:
- id: local-skills
config:
skillDirs:
- ~/my-skills
- D:/work/skills
平台兼容¶
Host 半依赖 ctx.skills / dsh-skill,可适配 web、desktop、tui、headless 等 profile;如果该 profile 缺少 skills 服务,插件不激活,不会崩。
Client 半声明 dsh.client.platform 为 web,只在 web 浏览器中显示设置页;纯终端(tui)没有浏览器 UI,不加载 client 半。
适用场景与注意¶
适合本地维护 SKILL 文件、希望在 DSH Web UI 中查看并复制调用提示的用户。插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。