前言¶
DeepSeek Harness (DSH) 生态强调一切皆插件。常规的 dsh plugin add 仅对包含 dsh.bundle.patch 或完整插件代码的仓库有效。对于只包含 SKILL.md 的内容仓库，无法直接通过插件层激活。dsh-skills-nexus 旨在解决这一断层，将纯内容仓库转化为可用的 DSH Skill。
插件介绍¶
dsh-skills-nexus 是一个通用 DSH Skill 适配器。由维护者 xiaxi626 开发，基于 MIT 许可证。安装一次后，可通过一条命令注册任意包含 SKILL.md 的 GitHub 仓库。
核心机制：
1. 将 Skill 仓库克隆到 ~/.dsh/skills-nexus/repos/ 目录。
2. 在 ~/.dsh/skills/ 目录下创建符号链接。
3. 官方文件系统提供者自动发现并加载这些链接，无需编写 Cordis 插件代码或 package.json。
核心功能¶
- 通用适配：支持将纯
SKILL.md内容仓库注册为 DSH Skill。 - 符号链接管理：自动处理仓库克隆与链接创建。
- 命令集：提供
add,list,update,enable,disable,remove,doctor,completions等命令。 - Shell 补全：支持 bash, zsh, fish, powershell 的自动补全功能。
安装与启用¶
CLI 工具通过全局 npm 安装提供。请确保环境满足 Node.js 版本要求。
npm install -g github:xiaxi626/dsh-skills-nexus
安装完成后，即可在命令行中使用 dsh-skills-nexus 命令。
典型用法¶
1. 注册 Skill 仓库¶
通过 GitHub 仓库名或 URL 注册 Skill。仓库本身无需 package.json 或 cordis.patch.yml。
dsh-skills-nexus add github:owner/repo
2. 查看注册状态¶
列出所有已注册的 Skill 及其状态（源仓库、提交、子目录等）。
dsh-skills-nexus list
3. 更新与切换¶
刷新已注册的仓库，或启用/禁用特定的 Skill。
# 刷新仓库
dsh-skills-nexus update [name]
# 启用 Skill（默认操作）
dsh-skills-nexus enable <name>
# 禁用 Skill（移除符号链接，不删除克隆文件）
dsh-skills-nexus disable <name>
4. 移除 Skill¶
删除克隆文件、符号链接并取消注册。
dsh-skills-nexus remove <name>
5. 健康检查¶
对 Nexus 状态进行只读检查。
dsh-skills-nexus doctor
6. Shell 补全¶
为当前 Shell 加载自动补全脚本。
# bash
eval "$(dsh-skills-nexus completions --shell bash)"
# zsh
eval "$(dsh-skills-nexus completions --shell zsh)"
注意事项¶
- Node.js 版本：需要 Node.js >= 20.0.0。
- 安装方式：CLI 命令通过
npm install -g提供，而非dsh plugin add。dsh plugin add注册的插件层仅用于包安装，对 CLI 命令行发现是可选的。 - 目录结构：符号链接位于
~/.dsh/skills/。 - 纯内容仓库：无需
dsh.bundle.patch即可正常工作。
总结¶
dsh-skills-nexus 简化了 DSH 生态中内容仓库的集成流程。它跳过了复杂的插件打包步骤，直接利用符号链接机制将 Skill 暴露给 DSH 的文件系统提供者。对于维护大量 SKILL.md 内容的开发者，这是一个高效的统一管理工具。
