Casually/dsh-plug-skills

dsh-plug-skills

DeepSeek Harness 的
Skills 管理器：在 Web UI 的「设置 → 插件 → Skills」标签页中发现
GitHub 上的 Agent Skills 仓库（SKILL.md 技能包），查看详情后一键安装 /
移除。交互模式参考
dsh-plug-manager
（插件市场）；MCP 服务管理请见姊妹插件
dsh-plug-mcp。

功能

- 设置 → 插件 → Skills（Web UI）
- 发现：按 GitHub topic 搜索技能仓库——agent-skills / dsh-skill /
claude-skills / ai-skills / skills / skill，可追加关键词、按最多
Star / 最近更新排序、翻页。另有两个模糊匹配选项：skills 与
skill——GitHub 搜索不支持通配符限定符，插件会并行搜索一组技能
相关 topic（skills = agent-skills + ai-skills + claude-skills +
skills；skill = dsh-skill + skill），合并去重后按 Star 排序展示
（一次消耗 2-4 个匿名搜索额度，注意限流）。
- 详情弹窗：仓库星标 / topics / 许可证 / README（内置安全 Markdown
渲染，只放行 http(s) 链接，相对图片改写为 raw.githubusercontent.com），
经 git trees 递归扫描列出仓库内全部 SKILL.md 技能包，解析每个技能的
frontmatter（name / description），勾选后一键安装。
- 安装：经 HTTPS 从 codeload.github.com 下载仓库 tarball（自动走
代理配置），解压后把选中的技能目录复制进 $DSH_HOME/skills/。
支持一次装多个、重名检测与可选覆盖。skill-filesystem 对技能根目录做
文件监视——装完立即生效，无需重启。
- 已安装：列出两个用户技能根目录（$DSH_HOME/skills、
$DSH_AGENTS_HOME/skills）中的全部技能（含 frontmatter 摘要、来源、
是否本插件安装），自定义确认弹窗后一键移除。
- GitHub 代理：直连 GitHub 受限时，可在页面上直接配置代理并测试
连通性（见下文「代理配置」）。
- 本地 JSON API（仅回环地址，由运行中的 web 服务器提供）：
/plug-skills/search、/plug-skills/repo、/plug-skills/local、
/plug-skills/install、/plug-skills/remove、/plug-skills/proxy、
/plug-skills/proxy-test。

代理配置

发现功能访问 api.github.com / raw.githubusercontent.com /
codeload.github.com。出厂部署不挂载平台级 fetch provider，本插件自行
发起请求：默认直连（Node fetch）；配置代理后经系统 curl 发出，因此
支持 http / https / socks5 / socks5h / socks4（Clash 的混合端口
与 SOCKS 端口都可用）。

代理来源按优先级生效：

1. 持久设置（UI「GitHub 代理」栏输入后点「应用」）——写入
DSH 主目录/plug-skills.json，立即生效且重启后保留；点「清除」移除；
2. 插件配置——在 profile 的 cordis.patch.yml 中为本插件加
config.proxy（持久生效）：
- id: plug-skills
name: dsh-plug-skills
config:
proxy: http://127.0.0.1:7890

3. 环境变量——DSH_PLUG_SKILLS_PROXY，或标准的 HTTPS_PROXY /
HTTP_PROXY / ALL_PROXY（大小写均可）。

「测试连接」会请求 api.github.com/zen 验证当前生效通道并报告延迟。
特殊值 direct 可强制直连（同样会被持久保存）。

数据与安全

- 技能装入 $DSH_HOME/skills/，安装登记（来源仓库 / 路径 / 时间）
记录在 $DSH_HOME/plug-skills.json；移除 = 删除技能目录并清理登记。
- 技能是提示词级内容：加载后进入模型上下文，等价于你亲手写的系统
指令——只安装你信任的技能仓库。
- 所有安装 / 移除均由你本人在本地界面点击触发，宿主进程直接执行文件
操作，不经过 agent、不额外审批；操作结果即时反馈。

安装

要求宿主有 curl（macOS / 主流 Linux 自带）才能使用代理功能；
dsh plugin 命令要求 PATH 中有 pnpm。

npm 安装（推荐）
dsh plugin --profile web add -w dsh-plug-skills

GitHub 源码（最新 main；也可 #vX.Y.Z 锁 tag）
dsh plugin --profile web add -w github:Casually/dsh-plug-skills

本地目录（开发自用，在本目录的父目录下执行）
dsh plugin --profile web add -w ./dsh-plug-skills

经 dsh plugin 命令安装后重启 DSH（dsh web）以组合新 bundle。
安装完成后，「Skills」标签页出现在设置 → 插件 下。

卸载

dsh plugin --profile web remove dsh-plug-skills

重启 DSH 以移除该层。已安装的技能不受影响（它们是数据，不是插件的
一部分）；如需清理，先在「已安装」页移除。

开发说明

- 运行时依赖仅 js-yaml（解析 SKILL.md 的 YAML frontmatter）。
- 宿主插件是纯 ESM；GitHub 抓取默认直连，代理经系统 curl；30 秒超时、
5 MB 响应上限、10 万字符文本上限（递归树扫描单独放宽到 300 万字符）。
- 浏览器端以预构建形式交付（client.js，window.__ModuleLoader__
格式），仅依赖平台的 react wire 模块。
- 给自己仓库打上 dsh-skill 或 agent-skills topic 标签，即可出现在
「发现」中。

许可证

MIT