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 生态的方法，减少维护成本。