NeboAI
NeboAI
เริ่มต้นใช้งาน

การเผยแพร่ปลั๊กอิน

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