เตรียมไฟล์
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 | manifest สำหรับการทำงาน อัปโหลดครั้งเดียวพร้อมไบนารีไฟล์แรก ดูที่ข้อมูลอ้างอิง 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 จะลงลายเซ็นไบนารีแต่ละไฟล์และ manifest ด้วย 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 เดียวกัน และข้ามการตรวจลายเซ็น คุณจึงปรับปรุงซ้ำได้โดยไม่ต้องเผยแพร่ ดูที่ ปลั๊กอิน