NeboAI
NeboAI
はじめる

プラグインの配布

プラグインを出荷するとは、プラットフォームごとに1つのバイナリをビルドし、それぞれをプラグインのマニフェストとスキルとともにアップロードし、バージョンを審査に申請することです。バージョンが承認されると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/社員にプラグインの使い方を教えるスキル。エントリーがskills/で始まる.tar.gzとして一度だけアップロードします。
バイナリプラットフォームごとに1つの実行ファイル。それぞれ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>")

トークンの有効期間は5分で、何回でもアップロードできます。各プラットフォームのバイナリをアップロードし、そのうち1回で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はい6つのプラットフォームのキーのいずれか。
configいいえplugin.json。最大1 MB。
skillsいいえskills/フォルダの.tar.gz。skills/の外にあるエントリーは無視されます。

各バイナリは、プラグインの現在のversionに対して保存され、同じプラットフォームを再度アップロードすると置き換わります。新しいバージョンを出荷するには、まずplugin(action: "update", id, version)でバージョンを変更してからアップロードします。アップロードのリクエストは、1回につき100 MBまでです。

すべてのプラットフォームをアップロードしたら、そのバージョンを申請します。

すでに掲載中のプラグインでは、新しいバージョンだけが審査待ちになります。承認済みのバージョンは引き続き掲載され、インストールでき、ボットの更新先もそのバージョンです。承認されると掲載が新しいバージョンに切り替わり、新しいバージョンが却下された場合は承認済みのものが公開されたままになります。

バージョンは、すべてそろったときにだけ公開されます。plugin.jsonのplatformsに記載したすべてのプラットフォームに、承認済みのバイナリが必要です。最後の1つが承認されるまで、ユーザーには以前のバージョンが届き続け、一度も掲載されたことのないプラグインは未掲載のままです。プラグインをインストールしたボットには、新しいバージョンが公開されたときに一度だけ通知が届きます。

plugin(action: "submit", id: "<plugin id>", version: "1.0.0")

審査と署名

申請されたバージョンはすべてスキャンされます。アップロードしただけでは、審査も配信もされません。バージョンが承認されると、NeboAIが各バイナリとマニフェストにEd25519で署名し、実際のハッシュ、サイズ、署名、ダウンロードURLをplugin.jsonに書き込み、プラットフォームごとに署名付きパッケージを1つ作成します。

ボット上では

  • Neboは自分のプラットフォーム用のパッケージをダウンロードし、SHA-256ハッシュと署名を確認して、<data>/nebo/plugins/<slug>/<version>/にインストールします。
  • Neboは各プラグインのバージョンを1つだけ保持します。新しいバージョンをインストールすると、古いものは置き換わります。
  • プラグインのデータフォルダ<data>/appdata/plugins/<slug>/は、アップデートやアンインストールの後も残ります。
  • Neboは起動の1分後、その後は6時間ごとにアップデートを確認します。オーナーがそのプラグインの自動アップデートをオンにしている場合、アップデートは自動でインストールされます。そうでない場合は、オーナーに通知されます。

出荷前にテストする

自分のマシン向けにビルドし、バイナリとplugin.jsonを<data>/user/plugins/<slug>/に置きます。そこにあるプラグインは、同じスラッグのマーケットプレイス版より優先され、署名の確認もスキップされるので、公開せずに試行を繰り返せます。プラグインをご覧ください。