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