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ệp | Mục đích |
|---|---|
PLUGIN.md | Trang 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.json | Tệ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ân | Mộ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ẫu | Bắt buộc | Ý nghĩa |
|---|---|---|
file | có | Tệp nhị phân. |
platform | có | Một trong sáu khóa nền tảng. |
config | không | Tệp plugin.json, tối đa 1 MB. |
skills | không | Tệ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.