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; הוסף .exe ב-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.

פלטפורמות

העלה קובץ בינארי לכל פלטפורמה שאתה תומך בה: darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 או windows-amd64. macos- מתקבל כמילה נרדפת ל-darwin-. בוט מתקין את הקובץ הבינארי של הפלטפורמה שלו.

העלאה והגשה

אתה עובד דרך שרת ה-MCP של NeboAI; פרסום מסביר על החיבור ועל חשבונות מפתחים. בחר את חשבון המפתח שלך, ואז צור את התוסף ובקש אסימון העלאה.

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לאקובץ .tar.gz של התיקייה skills/. המערכת מתעלמת מרשומות מחוץ ל-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 ומדלג על בדיקות החתימה, כך שאפשר לעבוד ולשפר בלי לפרסם. ראה תוספים.