NeboAI
NeboAI
Bắt đầu

Phát hành plugin

Phát hành một plugin nghĩa là xây dựng một tệp nhị phân cho mỗi nền tảng, tải từng tệp lên cùng tệp kê khai và kỹ năng của plugin, rồi gửi một phiên bản để xét duyệt. NeboAI ký các tệp nhị phân khi phiên bản được phê duyệt, và mọi bot đều xác minh chúng trước khi chạy.

Chuẩn bị các tệp

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
TệpMục đích
PLUGIN.mdTrang giới thiệu trên chợ ứng dụng mà mọi người đọc trước khi cài đặt. Gửi dưới dạng manifestContent.
plugin.jsonTệp kê khai khi chạy. Tải lên một lần cùng tệp nhị phân đầu tiên. Xem Tài liệu tham khảo plugin.json.
skills/Các kỹ năng dạy nhân viên cách dùng plugin. Tải lên một lần dưới dạng tệp .tar.gz có các mục bắt đầu bằng skills/.
Tệp nhị phânMột tệp thực thi cho mỗi nền tảng. Đặt tên mỗi tệp theo binaryName; thêm .exe trên Windows.
---
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.

Nền tảng

Tải lên một tệp nhị phân cho mỗi nền tảng bạn hỗ trợ: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 hoặc windows-amd64. macos- được chấp nhận như từ đồng nghĩa với darwin-. Mỗi bot cài tệp nhị phân dành cho nền tảng của chính nó.

Tải lên và gửi

Bạn làm việc qua máy chủ MCP của NeboAI; phần Phát hành hướng dẫn cách kết nối và tài khoản nhà phát triển. Chọn tài khoản nhà phát triển của bạn, rồi tạo plugin và yêu cầu một token tải lên.

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>")

Token có hiệu lực năm phút và dùng được cho bao nhiêu lượt tải lên cũng được. Tải lên tệp nhị phân cho từng nền tảng. Gửi config (tệp plugin.json) và skills cùng với một trong số đó.

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
Trường biểu mẫuBắt buộcÝ nghĩa
filecóTệp nhị phân.
platformcóMột trong sáu khóa nền tảng.
configkhôngTệp plugin.json, tối đa 1 MB.
skillskhôngTệp .tar.gz của thư mục skills/. Các mục nằm ngoài skills/ bị bỏ qua.

Mỗi tệp nhị phân được lưu theo version hiện tại của plugin, và tải lên lại cùng nền tảng sẽ thay thế nó. Để phát hành phiên bản mới, trước tiên hãy đổi phiên bản bằng plugin(action: "update", id, version), rồi tải lên. Mỗi yêu cầu tải lên giới hạn ở 100 MB.

Khi đã tải lên đủ mọi nền tảng, hãy gửi phiên bản đó.

Với một plugin đã được niêm yết, chỉ phiên bản mới phải chờ xét duyệt. Phiên bản đã được phê duyệt vẫn được niêm yết và cài đặt được, và đó là phiên bản các bot cập nhật lên. Khi được phê duyệt, trang niêm yết chuyển sang phiên bản mới; nếu phiên bản mới bị từ chối, phiên bản đã được phê duyệt vẫn hoạt động.

Một phiên bản chỉ được đưa vào hoạt động khi đã đầy đủ: mọi nền tảng mà plugin.json của bạn liệt kê trong platforms phải có tệp nhị phân được phê duyệt trước. Cho đến khi tệp cuối cùng được phê duyệt, mọi người vẫn nhận phiên bản trước, và một plugin chưa từng được niêm yết vẫn không được niêm yết. Các bot đã cài plugin sẽ được thông báo về phiên bản mới một lần, khi nó được đưa vào hoạt động.

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

Xét duyệt và ký

Mọi phiên bản được gửi đều được quét; một lượt tải lên đơn thuần không bao giờ được xét duyệt hay phân phối. Khi một phiên bản được phê duyệt, NeboAI ký từng tệp nhị phân và tệp kê khai bằng Ed25519, ghi giá trị băm, kích thước, chữ ký và URL tải xuống thật vào plugin.json, và đóng gói một gói đã ký cho mỗi nền tảng.

Trên một bot

  • Nebo tải gói cho nền tảng của nó, kiểm tra giá trị băm SHA-256 và chữ ký, rồi cài vào <data>/nebo/plugins/<slug>/<version>/.
  • Nebo giữ một phiên bản cho mỗi plugin. Cài phiên bản mới sẽ thay thế phiên bản cũ.
  • Thư mục dữ liệu của plugin, <data>/appdata/plugins/<slug>/, vẫn còn sau khi cập nhật và gỡ cài đặt.
  • Nebo kiểm tra bản cập nhật một phút sau khi khởi động và sau đó cứ sáu giờ một lần. Bản cập nhật tự cài đặt khi chủ sở hữu đã bật cập nhật tự động cho plugin đó; nếu không, chủ sở hữu sẽ được thông báo.

Kiểm thử trước khi phát hành

Xây dựng cho máy của chính bạn và đặt tệp nhị phân cùng plugin.json vào <data>/user/plugins/<slug>/. Plugin ở đó sẽ ghi đè phiên bản trên chợ ứng dụng có cùng slug và bỏ qua việc kiểm tra chữ ký, nên bạn có thể thử nghiệm liên tục mà không cần phát hành. Xem Plugin.