插件形态规范 JasperGuWP/dsh-plugin-schemes

dsh-plugin-schemes

DeepSeek Harness(dsh) 的插件开发总规范：把「扩展 dsh 的五种形态」及其安装 / 打包 / 发布方式、选型决策树、通用设计铁律，固化成一套可发布、可一键安装的规则。

本仓库本身就是一个 Skill（五种形态里的第 4 种），也随带一份给人看的规范文件（REFERENCE.md），供人与 agent 共同遵循。

五种形态一览

| 形态 | 载体 | 何时用 |
| Bundle 组合包 | npm 包，dsh.bundle.patch | 分发通用工具 / 服务 / 模型适配器 / UI，跨机器长期启用 |
| 本地插件（Patch） | TS/JS + cordis.patch.yml | 项目私有、快速迭代、不发布 |
| Agent Preset | agent.cordis.yml 目录 | 给某类会话一套定制工具 + 人设 + 提示词 |
| Skill | SKILL.md 目录 | 面向模型的指令 / 知识（本仓库即此形态） |
| 动态 Cordis 插件 | 运行时 package | 临时 / 一次性 / 演示 |

完整规范与决策树见 SKILL.md（agent 入口）与 REFERENCE.md（细则），样例见 EXAMPLES.md。

一键安装（给别人用）

安装到一个 dsh 技能发现根即可（~/.agents/skills 或 ~/.dsh/skills）。

方式 A：安装脚本

Windows（PowerShell） .\install.ps1

macOS / Linux
bash install.sh

方式 B：git clone 一行

git clone --depth 1 https://github.com//dsh-plugin-schemes.git ~/.agents/skills/dsh-plugin-schemes

方式 C：开放技能生态（skills.sh）

npx skills add /dsh-plugin-schemes -g -y

安装后重启 dsh / 新开会话，skill 目录会出现 dsh-plugin-schemes。之后 agent 遇到插件开发任务会按描述自动加载并遵循。

发布到 GitHub（作者侧）

1. 建空仓库（如 github.com//dsh-plugin-schemes），不要勾选初始化 README。
2. 本地初始化并推送：

cd dsh-plugin-schemes
git init
git add .
git commit -m "dsh plugin development rules: five forms + decision tree"
git branch -M main
git remote add origin https://github.com//dsh-plugin-schemes.git
git push -u origin main

3. 可选：给仓库打 GitHub 主题标签 dsh-plugin，让它进 harness 插件库（用 browse_dsh_plugins 工具 / dsh-plugin-market 浏览器可见）。
4. 可选：发布到 skills.sh，让方式 C 的 npx skills add 生效。

提交前请把 install.ps1 / install.sh 里的 RepoUrl 默认值改成你的真实仓库地址，或让使用者显式传入。

License

MIT