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/<dir>，安装登记（来源仓库 / 路径 / 时间） 记录在 $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