dsh-plugin-schemes

Readme

# dsh-plugin-schemes

[DeepSeek Harness](https://github.com/deepseek-ai/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](SKILL.md)（agent 入口）与 [REFERENCE.md](REFERENCE.md)（细则），样例见 [EXAMPLES.md](EXAMPLES.md)。

---

## 一键安装（给别人用）

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

### 方式 A：安装脚本

```powershell
# Windows（PowerShell）
.\install.ps1
```

```bash
# macOS / Linux
bash install.sh
```

### 方式 B：git clone 一行

```bash
git clone --depth 1 https://github.com/<你的_用户名>/dsh-plugin-schemes.git ~/.agents/skills/dsh-plugin-schemes
```

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

```bash
npx skills add <你的_用户名>/dsh-plugin-schemes -g -y
```

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

---

## 发布到 GitHub（作者侧）

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

```bash
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](https://skills.sh/)，让方式 C 的 `npx skills add` 生效。

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

---

## License

[MIT](./LICENSE)