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 簽署每個二進位檔和資訊清單,將實際的雜湊值、大小、簽章與下載網址寫入 plugin.json,並為每個平台建置一個已簽署的套件。

在機器人上

  • Nebo 會下載適用於自身平台的套件,檢查 SHA-256 雜湊值與簽章,然後安裝到 <data>/nebo/plugins/<slug>/<version>/。
  • Nebo 每個外掛只保留一個版本。安裝新版本會取代舊版本。
  • 外掛的資料資料夾 <data>/appdata/plugins/<slug>/ 在更新與解除安裝後都會保留。
  • Nebo 會在啟動一分鐘後檢查更新,之後每六小時檢查一次。如果擁有者為該外掛開啟了自動更新,更新會自行安裝;否則會通知擁有者。

發布前先測試

為你自己的電腦建置,並將二進位檔和 plugin.json 放到 <data>/user/plugins/<slug>/。放在這裡的外掛會覆寫市集上相同 slug 的版本,並略過簽章檢查,讓你不必發布就能反覆修改。請參閱外掛。