dsh-plugin-scaffold

Readme

# dsh-plugin-scaffold

这是一个用于开发 **DeepSeek Harness 插件** 的 skill，任何 AI agent 都可以使用。

[在 skillhub 中可以找到并使用](https://skillhub.cn/skills/user_62a0c738/dsh-plugin-scaffold)。

它的目标很直接：

> 你只需要说清楚插件要做什么业务，剩下的事情交给这个 skill。

这个 skill 负责业务逻辑之外的工程部分，包括：

- 判断该用哪种插件形态
- 生成项目目录和文件
- 生成 `package.json`
- 生成构建脚本
- 生成门禁脚本
- 生成说明文档
- 生成依赖和导出配置
- 告诉你如何本地验证、安装和发布

你不需要先搞懂 DSH 的内部结构，也不用记住各种配置字段。

## 它适合什么时候用

当你需要做这些事时：

- 创建一个新的 DSH 插件
- 给 DSH 增加一个后端工具或服务
- 给 DSH Web 页面增加浏览器 UI
- 完全替换 DSH Web 的默认布局
- 本地验证一个插件
- 发布一个插件到 git 或 npm

只要目标跟 DeepSeek Harness 插件有关，就可以使用这个 skill。

## 插件形态怎么理解

| 形态 | 插件改动面 |
|---|---|
| `pure` | 只涉及 Node 后端，没有 Web UI 端 |
| `bundle` | 只涉及 Node 后端，但是将多个插件或服务打包成一个插件 |
| `bundle-client` | 同时包含 Node 后端和 Web UI 端 |

如果需要完全替换 DSH Web 默认布局，也不增加新形态。它仍然属于
`bundle-client`，只是由 AI agent 在实现业务时自行判断，并在 client 侧
注册 `ctx.slots.register({ name: 'root' })`。

## 目录结构

```text
.
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── contracts.md
│   ├── gotchas.md
│   └── verification.md
├── scripts/
│   └── scaffold.py
└── tests/
    └── test_scaffold.py
```

## 本地开发

运行测试：

```bash
python3 -m unittest discover -s tests
```

## 贡献

见 [CONTRIBUTING.md](CONTRIBUTING.md)。

## License

[MIT](LICENSE)