準備檔案
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 簽署每個二進位檔和資訊清單,將實際的雜湊值、大小、簽章與下載網址寫入 plugin.json,並為每個平台建置一個已簽署的套件。
在機器人上
- Nebo 會下載適用於自身平台的套件,檢查 SHA-256 雜湊值與簽章,然後安裝到
<data>/nebo/plugins/<slug>/<version>/。 - Nebo 每個外掛只保留一個版本。安裝新版本會取代舊版本。
- 外掛的資料資料夾
<data>/appdata/plugins/<slug>/在更新與解除安裝後都會保留。 - Nebo 會在啟動一分鐘後檢查更新,之後每六小時檢查一次。如果擁有者為該外掛開啟了自動更新,更新會自行安裝;否則會通知擁有者。
發布前先測試
為你自己的電腦建置,並將二進位檔和 plugin.json 放到 <data>/user/plugins/<slug>/。放在這裡的外掛會覆寫市集上相同 slug 的版本,並略過簽章檢查,讓你不必發布就能反覆修改。請參閱外掛。