在 DeepSeek Harness (DSH) 的开发流程中,管理 Agent 的技能包(SKILL.md)通常涉及手动下载、解压和路径配置。dsh-plug-skills 提供了一个集中的管理界面,允许用户在 Web UI 中直接浏览 GitHub 上的 Agent Skills 仓库,查看详情后进行一键安装或移除。
核心功能¶
发现与浏览¶
插件在 Web UI 的「设置 → 插件 → Skills」标签页提供搜索功能。支持按 GitHub Topic 搜索,包括 agent-skills、dsh-skill、claude-skills、ai-skills、skills 和 skill。搜索结果支持按星标数或最近更新排序,并支持翻页。
此外,插件提供模糊匹配选项:*skills 和 *skill。前者会并行搜索 agent-skills、ai-skills、claude-skills、skills 等 topic 并去重;后者搜索 dsh-skill 和 skill。注意,模糊匹配会消耗 2-4 个匿名搜索额度,存在限流风险。
技能详情与安装¶
点击仓库可查看详情,包括星标数、Topics、许可证以及仓库的 Markdown README。插件会递归扫描仓库内的所有 SKILL.md 文件,解析其 Frontmatter(包含 name 和 description)。
用户勾选需要安装的技能包后,点击安装即可。技能会被解压并复制到 $DSH_HOME/skills/<目录名>。安装过程支持批量安装、重名检测与可选覆盖。得益于 skill-filesystem 插件,技能安装后立即生效,无需重启 DSH。
已安装技能管理¶
在「已安装」标签页,可以查看 $DSH_HOME/skills 和 $DSH_AGENTS_HOME/skills 下的所有技能。界面会显示技能摘要、来源仓库及是否由本插件安装。移除时需在界面确认,会同步清理相关目录。
代理配置¶
由于网络环境限制,插件支持多种方式配置 GitHub 代理。默认直连(使用 Node fetch),配置代理后改为通过系统 curl 发起请求,支持 http、https、socks5、socks5h、socks4 协议。
代理配置按优先级生效:
1. 持久设置:在 Web UI 的「GitHub 代理」栏输入地址并点击应用,配置会写入 $DSH_HOME/plug-skills.json。
2. 插件配置:在 profile 的 cordis.patch.yml 中设置 config.proxy。
3. 环境变量:设置 DSH_PLUG_SKILLS_PROXY,或标准的 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY。
UI 提供测试连接功能,请求 api.github.com/zen 验证延迟。特殊值 direct 可强制直连。
安装与启用¶
插件使用 npm 安装,要求宿主环境已安装 curl(macOS/Linux 默认包含)和 pnpm。
dsh plugin --profile web add -w dsh-plug-skills
安装完成后,重启 DSH (dsh web) 以加载新 bundle。随后在「设置 → 插件」中即可看到「Skills」标签页。
安全与数据说明¶
安全性:技能本质上是提示词级内容,加载后直接进入模型上下文,等同于用户手写的系统指令。建议仅安装信任来源的技能包。安装和移除操作由用户在本地界面触发,宿主进程直接执行文件操作。
数据存储:技能目录位于 $DSH_HOME/skills。安装记录保存在 $DSH_HOME/plug-skills.json。
限制:递归扫描内容有字符限制(默认 10 万字符,单独放宽至 300 万)。本地 API 端点仅限回环地址访问。
结语¶
dsh-plug-skills 将分散在 GitHub 上的技能包管理集中化,通过简单的点击操作实现技能的发现、安装与热加载,降低了 Agent 开发与维护的门槛。