파일 준비하기
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/ | 직원에게 플러그인 사용법을 알려주는 스킬입니다. 항목이 skills/로 시작하는 .tar.gz 파일로 한 번만 업로드합니다. |
| 바이너리 | 플랫폼마다 실행 파일 하나입니다. 각각 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>") 토큰은 5분 동안 유효하며 업로드 횟수에 제한이 없습니다. 플랫폼마다 바이너리를 업로드하세요. 그중 하나와 함께 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이며 최대 1MB입니다. |
skills | 아니요 | skills/ 폴더의 .tar.gz 파일입니다. skills/ 밖의 항목은 무시됩니다. |
각 바이너리는 플러그인의 현재 version에 저장되며, 같은 플랫폼을 다시 업로드하면 교체됩니다. 새 버전을 출시하려면 먼저 plugin(action: "update", id, version)으로 버전을 변경한 다음 업로드하세요. 업로드 요청 하나는 100MB로 제한됩니다.
모든 플랫폼을 업로드했으면 해당 버전을 제출하세요.
이미 등록된 플러그인이라면 새 버전만 검토를 기다립니다. 승인된 버전은 계속 등록되어 설치할 수 있으며, 봇은 그 버전으로 업데이트됩니다. 승인되면 목록이 새 버전으로 전환되고, 새 버전이 거부되면 승인된 버전이 그대로 유지됩니다.
버전은 완전할 때만 공개됩니다. 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는 시작 1분 후와 그 이후 6시간마다 업데이트를 확인합니다. 소유자가 해당 플러그인의 자동 업데이트를 켜 두었다면 업데이트가 자동으로 설치되고, 그렇지 않으면 소유자에게 알림이 갑니다.
출시 전에 테스트하기
내 컴퓨터용으로 빌드하고 바이너리와 plugin.json을 <data>/user/plugins/<slug>/에 넣으세요. 이곳의 플러그인은 같은 slug의 마켓플레이스 버전보다 우선하며 서명 확인을 건너뛰므로, 게시하지 않고도 반복해서 수정할 수 있습니다. 플러그인을 참고하세요.