dsh-skill-install:在 DSH 设置页安装 GitHub 技能

前言

DeepSeek Harness(DSH)通过 Skill 机制把可复用的工作流、提示与工具封装成 SKILL.md,供智能体在对话中按需加载。技能往往散落在各个 GitHub 仓库里,手动克隆、解压、拷贝到 <dshHome>/skills 或项目 .dsh/skills 既繁琐,也容易和内置 skill-filesystem 的监听路径对不齐。dsh-skill-install 是社区插件,在 Web 端「Settings → Skills」提供搜索仓库、勾选技能、选择安装目录的一整套流程,并与内置技能文件系统联动,装完即可生效,无需重启 Harness。

这是什么

dsh-skill-install 由维护者 Joey-K-tsubame 发布,仓库为 Joey-K-tsubame/dsh-skill-install。定位是 DeepSeek Harness 的技能安装器:在设置页按名称搜索 GitHub 仓库,或直接粘贴 owner/repo、完整 GitHub URL;打开匹配仓库后列出其中的 SKILL.md 技能,勾选后安装到全局、当前项目或自定义目录。插件与内置 skill-filesystem 集成,全局与项目目录下的安装由监听器热加载;自定义目录则通过 ctx.skills.registerProvider 注册独立提供方。当前 package 版本为 0.1.8,许可证 MIT。

核心功能

下面按 README 已写明的能力归纳,不做超出资料的扩展。

搜索与打开仓库

单一输入框支持两类来源:按技能或仓库名称搜索(返回具体匹配的仓库,而非全站发现流);或粘贴 owner/repo、https://github.com/owner/repo。点击「Open」可浏览该仓库内的技能列表。

安装目标

安装时可选择目标目录,默认全局:

  1. 全局:<dshHome>/skills,默认由 skill-filesystem 监听。
  2. 当前项目:<project root>/.dsh/skills;项目根为最近的 .git 祖先目录,若无则使用当前工作目录。
  3. 自定义目录:任意绝对路径;插件自行注册 skill provider,并在安装、移除或变更时刷新。

已安装与当前加载

界面提供按目标目录分组的已安装列表,支持一键移除。另有只读视图展示当前已合并加载的技能集合(内置 skill-filesystem 与本插件合并结果)。

代理(可折叠)

可配置代理地址、测试连通性或清除。设置后请求经系统 curl 发出;未设置则直连。

运行时与集成要点

  • 宿主插件为纯 ESM,无外部运行时依赖(js-yaml 以 js-yaml.mjs 自包含打包)。
  • 从 GitHub tarball 解压依赖系统 tar(Windows 10 1809+ 已内置);使用代理需要系统 curl。
  • 路由与 provider 通过 ctx.effect 注册,禁用或重载插件时自动卸载。

安装与启用

安装前若从本地目录添加,需先退出 Desktop 应用;--profile 为必填项。安装后需重启 Harness,新 bundle 才会 compose,「Settings → Skills」才会出现新页面。从 GitHub 安装时本包无外部运行时依赖,不需要 allowBuilds 代码执行审批。

# 本地目录 — 先退出 Desktop;--profile 必填
dsh plugin --profile <profile> add ./dsh-skill-install

# 从 GitHub
dsh plugin --profile <profile> add github:<owner>/dsh-skill-install

package.json 中 engines 要求 Node ^22.19.0 || >=24.0.0,DSH >=0.2.0-rc.2-0 <0.3.0-0;manifest 标明与 0.2.1-rc.2 兼容。请以你本机 Harness 版本对照后再装。

典型用法

经过上面的安装与重启,在 Web 设置中进入 Settings → Skills,按下面顺序操作即可复现 README 描述的主流程:

  1. 在搜索框输入仓库名或技能相关关键词,或粘贴 owner/repo / 完整 GitHub 地址。
  2. 在搜索结果中点击「Open」,查看仓库内符合发现规则的技能(<root>/<name>/SKILL.md 或 <root>/<name>.md)。
  3. 勾选要安装的技能,选择目标:全局、当前项目或自定义绝对路径。
  4. 确认安装;写入标准根目录的技能由 skill-filesystem 热加载,自定义目录由插件 provider 热刷新。
  5. 在「已安装」列表中按目录管理;需要时在折叠项里配置代理并用 curl 测试后再拉取 GitHub 资源。

若访问 GitHub 受限,先展开代理配置、填写地址并测试连通性,再执行搜索与安装。

适用场景与注意

适合经常在多个 GitHub 仓库间切换、需要把第三方 SKILL.md 快速落到 DSH 标准技能目录的 Harness 用户。也适合需要在单仓库内只挑选部分技能、或把技能装到项目级 .dsh/skills 的团队。

使用时请注意:

  • 插件以当前 DSH 进程权限运行,安装前应自行审查目标仓库源码与许可证(本插件为 MIT,被安装的技能未必相同)。
  • 搜索只返回匹配仓库,不提供全站技能市场;技能质量与维护由上游仓库负责。
  • 社区目录页 skillhub.cn 上的 dsh-skill-install 与 GitHub 仓库为社区收录,与 DeepSeek / 幻方无官方从属关系;安装命令以 README 为准。

结尾

dsh-skill-install 把「找仓库 → 列技能 → 选目录 → 即时生效」收敛到设置页一条链路,减少手工拷贝与路径错误。需要进一步了解参数与实现细节时,可查阅 GitHub 仓库 与其中 中文 README;在社区站点也可打开 插件目录页 查看收录信息。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜