前言¶
DeepSeek Harness(DSH)采用插件化架构。在开发智能体或管理技能时,直接维护 ~/.dsh/skills 目录下的文件需要手动操作。此插件在 DSH 的设置页面提供了一个管理界面,支持批量导入技能目录,并利用 AI 模型自动解析技能名称与描述,解决了技能命名不规范和重复导入的问题。
核心功能¶
技能列表¶
插件会列出 ~/.dsh/skills 下已导入的目录束(包含 SKILL.md 的目录)与扁平 Markdown 技能文件。列表展示技能名称、描述、有效性以及来源目录。
多目录导入¶
在导入时,可以同时选择多个技能目录。插件会读取目录内的文件(自动跳过 .git 等系统文件),并通过 RPC 传输到 DSH 进程。
AI 名称解析¶
导入前可选择已配置的 AI 模型(默认为 harness 默认模型)。模型会解析技能的名称与一句话描述。解析结果会强制规范化为 DSH 对话框支持的命名格式。
目录自动重命名¶
导入后,如果目录名与解析出的名称不一致,插件会将目录重命名为规范化的名称(小写 kebab-case)。同时重写 SKILL.md 的 frontmatter,保证名称、描述与目录名一致。
同名保护¶
导入时会检查目标目录。如果已存在同名技能,导入会自动跳过,不会覆盖已有内容。
安装¶
使用 DSH 的插件安装命令。如果当前 profile 不是 web,请替换命令中的 --profile web。
dsh plugin add github:tianLee-gitter/lt-lt-lt-dsh-skill-manager --profile web
安装完成后,需要重启 dsh web 并刷新浏览器页面。
使用¶
- 打开 DSH 设置页面,进入「技能管理」。
- 选择用于解析名称的 AI 模型(可选,默认使用 harness 默认模型)。
- 点击「导入技能…」,在文件选择器中一次选中多个技能目录。
- 查看导入结果。成功项显示名称、描述和目录重命名情况;失败项会列出原因(如缺少
SKILL.md、同名已存在、名称无法规范化等)。 - 导入成功后,在对话框中使用
/名称引用该技能。
配置¶
插件的配置位于包内的 cordis.patch.yml 文件中。以下是默认配置项:
dshHome:技能根目录,默认为~/.dsh。maxAiInputBytes:AI 解析时的输入截断大小,默认 6000。maxAiOutputTokens:AI 输出 token 上限,默认 300。aiTimeoutMs:AI 请求超时时间,默认 30000。
注意事项¶
- 命名规范:技能名称必须匹配正则
^[a-z0-9]+(?:-[a-z0-9]+)*$,即小写 kebab-case。AI 解析结果会强制符合此规范。 - 同名处理:同名技能不会覆盖,只会跳过。
- Profile 依赖:安装命令默认使用
webprofile,若环境不同需自行修改。 - 安全性:导入时浏览器读取文件经 RPC 传输,请确保文件来源安全。
- 停用插件:如需停用,可取消
cordis.patch.yml中# disabled: true行的注释,然后重启dsh web。