第三方开发者指南
UnityAI 开放插件系统,允许第三方开发者将自己的 AI 能力接入平台,为用户提供服务并获得收益。
插件架构
UnityAI 使用 Process + iframe 架构:
- 插件作为独立 HTTP 服务运行
- 支持 Python、Node.js 等任意可启动 HTTP 服务的语言
- UI 通过 iframe 嵌入 Unity Lab
- 适合完整 Web 应用、大模型推理、需要 GPU 的任务
部署模式
| 模式 | 说明 | 适合 |
|---|---|---|
| 托管 | 上传代码包,平台自动部署管理 | 轻量插件、快速上架 |
| 自托管 | 开发者自行部署,提供 URL | 有独立服务器、需要自主控制 |
详见 托管与部署指南
开发流程
1. 注册账号
访问 https://www.unityai.chat 注册用户账号。注册完成后,发送邮件至 contact@hamashuzi.com 申请开发者权限。
邮件中请包含:
- 注册时使用的用户名
- 计划开发的插件简要描述
- 部署模式选择(托管 / 自托管)
2. 开发插件
参考 Process 插件开发教程 — HTTP 服务 + JWT 认证 + iframe UI。
3. 测试验证
本地启动 HTTP 服务,验证 /health 及业务端点,确认可在浏览器中独立访问。
4. 提交发布
托管模式
bash
POST /api/plugin-store/submit
Content-Type: multipart/form-data
- metadata: {"hosting_mode":"managed", "process_config":{...}, ...}
- file: 项目压缩包 (.tar.gz / .zip)自托管模式
bash
POST /api/plugin-store/submit
Content-Type: multipart/form-data
- metadata: {"hosting_mode":"self_hosted", "self_hosted_url":"https://...", ...}
- file: (可选)详细字段参考:第三方插件开发指南
5. 审核上线
超管审核通过后:
- 托管模式:平台自动部署,用户启动时 spawn 进程
- 自托管模式:平台验证 URL 连通性,用户启动时直接加载
收益模式
- 按使用付费:用户每次使用插件,你获得收益
- 订阅模式:提供月度/年度订阅服务
- 免费增值:基础功能免费,高级功能付费
- 平台分成:平台抽成 30%,你获得 70%
