前言¶
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」可浏览该仓库内的技能列表。
安装目标¶
安装时可选择目标目录,默认全局:
- 全局:
<dshHome>/skills,默认由skill-filesystem监听。 - 当前项目:
<project root>/.dsh/skills;项目根为最近的.git祖先目录,若无则使用当前工作目录。 - 自定义目录:任意绝对路径;插件自行注册 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 描述的主流程:
- 在搜索框输入仓库名或技能相关关键词,或粘贴
owner/repo/ 完整 GitHub 地址。 - 在搜索结果中点击「Open」,查看仓库内符合发现规则的技能(
<root>/<name>/SKILL.md或<root>/<name>.md)。 - 勾选要安装的技能,选择目标:全局、当前项目或自定义绝对路径。
- 确认安装;写入标准根目录的技能由
skill-filesystem热加载,自定义目录由插件 provider 热刷新。 - 在「已安装」列表中按目录管理;需要时在折叠项里配置代理并用 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;在社区站点也可打开 插件目录页 查看收录信息。