前言¶
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 內容的開發者，這是一個高效的統一管理工具。
