फ़ाइलें तैयार करें
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 से साइन करता है, असली हैश, साइज़, सिग्नेचर और डाउनलोड URL plugin.json में लिखता है, और हर प्लेटफ़ॉर्म के लिए एक साइन किया हुआ पैकेज बनाता है।
बॉट पर
- Nebo अपने प्लेटफ़ॉर्म का पैकेज डाउनलोड करता है, SHA-256 हैश और सिग्नेचर की जाँच करता है, और उसे
<data>/nebo/plugins/<slug>/<version>/में इंस्टॉल करता है। - Nebo हर प्लगइन का एक ही वर्ज़न रखता है। नया वर्ज़न इंस्टॉल करने पर पुराना बदल जाता है।
- प्लगइन का डेटा फ़ोल्डर,
<data>/appdata/plugins/<slug>/, अपडेट और अनइंस्टॉल के बाद भी बना रहता है। - Nebo शुरू होने के एक मिनट बाद और फिर हर छह घंटे में अपडेट की जाँच करता है। अगर मालिक ने उस प्लगइन के लिए ऑटोमैटिक अपडेट चालू किए हैं, तो अपडेट अपने आप इंस्टॉल हो जाता है; वरना मालिक को सूचना मिलती है।
शिप करने से पहले टेस्ट करें
अपनी मशीन के लिए बिल्ड करें और बाइनरी व plugin.json को <data>/user/plugins/<slug>/ में रखें। वहाँ रखा प्लगइन उसी slug वाले मार्केटप्लेस वर्ज़न की जगह ले लेता है और सिग्नेचर जाँच छोड़ देता है, ताकि आप बिना प्रकाशित किए बार-बार सुधार कर सकें। प्लगइन देखें।