NeboAI
NeboAI
开始使用

发布插件

发布插件意味着为每个平台构建一个二进制文件,把每个文件连同插件的清单和技能一起上传,然后提交一个版本供审核。版本通过审核后,NeboAI 会对二进制文件签名,每个机器人在运行前都会验证它们。

准备文件

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 的版本,并跳过签名校验,因此你无需发布就能反复迭代。参见插件。