dsh-dual-plugin-guide：雙格式插件開發指南

在 DeepSeek Harness (DSH) 和 Agent Plugins 1.0 的生態中，同時維護兩套插件包會增加開發負擔。dsh-dual-plugin-guide 插件旨在解決這個問題，它教導智能體如何編寫一套插件代碼，使其同時兼容 DSH 靜態插件包和 Agent Plugins 1.0。

插件簡介¶

這是一個由 Fectivnfy112357 維護的元插件，屬於“工作流”分類。它本身通過 DSH 和 Agent Plugins 1.0 兩種格式安裝，作爲開發者學習如何構建雙格式插件的教程。

核心功能¶

兼容性教學：引導開發者編寫能夠同時適配 DSH 靜態插件包（通過 dsh plugin 安裝）和 Agent Plugins 1.0（通過 plugin.json + skills/ 加載）的插件。
骨架生成：提供 scaffold.mjs 腳本，能夠生成符合雙格式規範的有效骨架代碼。

安裝與啓用¶

通過 DSH 官方命令安裝：

dsh plugin --profile web add dsh-dual-plugin-guide

安裝並重啓配置文件後，該技能會出現在智能體的技能目錄中。

典型用法¶

智能體安裝該技能後，可參考其內容構建自己的雙格式插件。對於需要快速起手的項目，可以使用插件自帶的 scaffold.mjs 腳本生成骨架：

npx skills add Fectivnfy112357/dsh-dual-plugin-guide
# 或使用插件內的腳本
node skills/dsh-dual-plugin-guide/scripts/scaffold.mjs

工作原理與結構¶

該插件通過共享同一套 skills/ 目錄樹來同時服務於三種加載器：

DSH：通過 cordis.patch.yml 中的 dsh.bundle.patch 將技能註冊到運行時。
Agent Plugins 1.0：直接讀取 plugin.json 和 skills/ 目錄。
Standard Skills：通過 npx skills 發現 skills/ 目錄。

lib/index.js 是一個極簡的 Cordis 插件，它注入 skills 並將 SKILL.md 註冊到 ctx.skills，確保相對引用路徑正確解析。

dsh-dual-plugin-guide/
├── package.json       # 包含 DSH bundle 配置與 peerDependencies
├── plugin.json        # Agent Plugins 1.0 清單
├── cordis.patch.yml   # DSH bundle 的 patch 文件
├── lib/index.js       # Cordis 入口，註冊 SKILL.md
└── skills/dsh-dual-plugin-guide/
    ├── SKILL.md       # 指導內容（單一來源）
    ├── scripts/       # scaffold.mjs 骨架生成器
    └── references/    # 事實清單（事件、服務、工具等）

適用場景與注意¶

適用場景：需要同時開發兼容 DSH 靜態插件包和 Agent Plugins 1.0 的開發者。
權限注意：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（MIT）。
依賴注意：需要 @deepseek-ai/dsh 依賴（可選）。

總結¶

通過此插件，開發者可以掌握在單一代碼庫中同時服務 DSH 和 Agent Plugins 1.0 生態的方法，減少維護成本。