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