准备文件
notes-sync/
├── PLUGIN.md # marketplace listing
├── plugin.json # runtime manifest
├── skills/
│ └── notes-sync/
│ └── SKILL.md
└── dist/
├── darwin-arm64/notes-sync
├── linux-amd64/notes-sync
└── windows-amd64/notes-sync.exe | 文件 | 用途 |
|---|---|
PLUGIN.md | 人们在安装前阅读的市场页面。以 manifestContent 发送。 |
plugin.json | 运行时清单。随第一个二进制文件上传一次。参见“plugin.json 参考”。 |
skills/ | 教员工使用该插件的技能。以 .tar.gz 形式上传一次,其中的条目都以 skills/ 开头。 |
| 二进制文件 | 每个平台一个可执行文件。每个都以 binaryName 命名;Windows 上要加 .exe。 |
--- name: Example Notes description: Search, read and create notes in Example Notes. version: 1.0.0 category: productivity --- # Example Notes Connect each employee to its own Example Notes account. Employees can search notebooks, read notes and create new ones.
平台
为你支持的每个平台上传一个二进制文件:darwin-arm64、darwin-amd64、linux-arm64、linux-amd64、windows-arm64 或 windows-amd64。macos- 可作为 darwin- 的同义词。机器人会安装适合它自身平台的二进制文件。
上传并提交
你通过 NeboAI MCP 服务器操作;发布一文介绍了如何连接以及开发者账户。选择你的开发者账户,然后创建插件并申请上传令牌。
plugin(action: "create", name: "Example Notes", description: "Search, read and create notes in Example Notes.",
category: "productivity", version: "1.0.0", manifestContent: "<PLUGIN.md>")
plugin(action: "binary-token", id: "<plugin id>") 令牌有效期为五分钟,期间可上传任意次数。上传每个平台的二进制文件。在其中一次上传时一并发送 config(即 plugin.json)和 skills。
TOKEN=<token from binary-token> ID=<plugin id> tar czf skills.tar.gz -C notes-sync skills curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \ -H "Authorization: Bearer $TOKEN" \ -F file=@notes-sync/dist/darwin-arm64/notes-sync \ -F platform=darwin-arm64 \ -F config=@notes-sync/plugin.json \ -F skills=@skills.tar.gz curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \ -H "Authorization: Bearer $TOKEN" \ -F file=@notes-sync/dist/linux-amd64/notes-sync \ -F platform=linux-amd64 curl -X POST "https://neboai.com/api/v1/developer/apps/$ID/binaries" \ -H "Authorization: Bearer $TOKEN" \ -F file=@notes-sync/dist/windows-amd64/notes-sync.exe \ -F platform=windows-amd64
| 表单字段 | 必填 | 含义 |
|---|---|---|
file | 是 | 二进制文件。 |
platform | 是 | 六个平台键之一。 |
config | 否 | plugin.json,最大 1 MB。 |
skills | 否 | skills/ 文件夹的 .tar.gz 压缩包。skills/ 之外的条目会被忽略。 |
每个二进制文件都按插件当前的 version 存储,再次上传同一平台会替换它。要发布新版本,先用 plugin(action: "update", id, version) 修改版本号,然后再上传。每个上传请求最大 100 MB。
所有平台都上传完毕后,提交该版本。
对于已上架的插件,只有新版本需要等待审核。已通过审核的版本会继续上架、可以安装,机器人也会更新到这个版本。审核通过后,上架页面切换到新版本;如果新版本被拒绝,已通过的版本继续在线。
版本只有完整时才会上线:你的 plugin.json 在 platforms 下列出的每个平台,都必须先有一个通过审核的二进制文件。在最后一个通过审核之前,人们拿到的仍是上一个版本,从未上架过的插件也会保持未上架。已安装该插件的机器人会在新版本上线时收到一次通知。
plugin(action: "submit", id: "<plugin id>", version: "1.0.0")
审核与签名
每个提交的版本都会被扫描;单纯上传永远不会被审核或分发。版本通过审核后,NeboAI 会用 Ed25519 对每个二进制文件和清单签名,把真实的哈希值、大小、签名和下载 URL 写入 plugin.json,并为每个平台构建一个已签名的软件包。
在机器人上
- Nebo 会下载适合其平台的软件包,校验 SHA-256 哈希值和签名,然后安装到
<data>/nebo/plugins/<slug>/<version>/。 - 每个插件 Nebo 只保留一个版本。安装新版本会替换旧版本。
- 插件的数据文件夹
<data>/appdata/plugins/<slug>/在更新和卸载后都会保留。 - Nebo 会在启动一分钟后检查更新,之后每六小时检查一次。如果所有者为该插件开启了自动更新,更新会自行安装;否则会通知所有者。
发布前先测试
为你自己的电脑构建,然后把二进制文件和 plugin.json 放到 <data>/user/plugins/<slug>/。放在这里的插件会覆盖市场上同一 slug 的版本,并跳过签名校验,因此你无需发布就能反复迭代。参见插件。