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