Publicarea unui plugin — AiHummer Documentație

Construit un plugin cu SDK pentru plugin? Poți să-l publici în două moduri:

Privat (pentru tine) — încărcați lateral în instanța dvs. Artefactul niciodată o lasă.
Comunitate (pentru toată lumea) — publică prin intermediul tău cabinet personal la my.aihummer.ru, magazin de aplicații stil: încarcă versiunea, completează pagina magazinului, treci de revizuire și ajunge în catalog de comunitate semnat de la care fiecare instanță poate instala.

Analogie: instalarea unui .vsix manual (privat) vs publicare într-un magazin de aplicații (comunitate).

[!WARNING] Pluginurile comunității nu pot fi instalate acum — nu este o problemă de conexiune. Cheia cu care se semna catalogul comunității a fost retrasă; până la livrarea unei chei noi, verificarea semnăturii respinge aceste intrări. Separat de asta, codul terț încă nu rulează ca serviciu pe serverul dumneavoastră: până la apariția unui mediu de execuție izolat sunt permise doar integrările care rulează la ele și se conectează prin rețea.

Ce veți vedea: după apăsarea butonului „instalează” apare obișnuitul mesaj „se instalează”, dar pluginul nu apare niciodată în lista celor instalate. Motivul refuzului ajunge în jurnalul gateway-ului — deschideți Jurnale în panoul de administrare.

Ce funcționează astăzi:

pluginurile de la AiHummer din catalogul oficial — se instalează normal, au o altă semnătură, validă;

un server MCP prin HTTP — conectat ca sursă de unelte fără dezvoltare, codul rămâne la dumneavoastră;

o integrare prin specificație OpenAPI — la fel, fără serviciu de instalat.

Încărcarea laterală a propriului plugin trece verificarea semnăturii, dar va rula doar ca MCP la distanță prin HTTP sau integrare OpenAPI; o compilare care trebuie pornită ca serviciu pe același server este respinsă.

Mod privat — încărcați lateral în instanța dvs.

Folosește aceasta doar când ai nevoie de plugin: un conector intern, o integrare personalizată, o versiune de test.

Pași

Ambalați și semnați pachetul:

aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

Încarcă-l în instanță în unul din două moduri:
- Admin UI → Module → „Încărcare modul” — trageți pachetul; sau
- CLI:
```
aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
```
Sub capotă, acesta este POST /v1/admin/modules/upload (multipart, integrations:write): artefactul aterizează în magazin de bloburi pentru instanță (AIHUMMER_BLOB_DIR) sub un blob: ref, și un rând din catalog este înregistrat cu origin = local-private, visibility = private.
Pluginul apare în piață etichetat Privat și instalează prin intermediul cale normală — unitate systemd izolată + poartă de sănătate.

Încredere: cheia fixată și depozitul de încredere

Artefacte private trebuie să fie semnat. Când încarci un plugin semnat cu o cheie necunoscută, interfața de administrare te avertizează să aproba cheia autorului în magazinul de încredere al instanței (un singur clic). Odată aprobată, semnătura este verificată la fiecare instalare și actualizare.

Artefacte din oficial verificați sursa împotriva cheie de registru fixată în miez — de încredere implicit, fără pas suplimentar.
Privat artefactele se verifică față de cheile din magazinul de încredere al instanței.
Nesemnat pachetele sunt respinse — cu excepția modului dev pentru iterare locală: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 dezactivează verificarea semnăturii și este destinat doar pentru dezvoltare locală. Nu îl activați niciodată pe o instanță accesibilă din exterior.

Mod comunitar — publică prin cabinetul personal

Pentru a face un plugin disponibil pentru fiecare instanță, publică-l de la tine cabinet personal la my.aihummer.ru, în același mod în care publici o aplicație într-un magazin de aplicații. Încarci versiunea construită, completezi pagina magazinului și o trimiți pentru revizuire; mai întâi rulează un control automatizat AI, apoi un moderator uman ia decizia finală, iar după aprobare, artefactul este semnat și publicat în catalogul comunității.

Ghidul complet, pas cu pas, este disponibil pe Trimite un plugin. Pe scurt:

Construiți și împachetați pluginul tău cu SDK-ul (aihummer plugin package) — artefactul este un semnat .tar.gz purtând al său manifest.json.
Deschide «Pluginurile mele» în dulap și creează o trimitere: încarcă artefact, completează stoca metadate (nume și descrieri în RU + EN, versiune, pictogramă, capturi de ecran, categorie, link opțional pentru donații, jurnal de modificări) și declara manifest de capabilitate.
Trimite pentru revizuire. Automatizat Revizuire AI verifică trimiterea împotriva politică de recenzie (securitate, manifest) corectitudine, completitudine, conținut), apoi un moderator uman citește raportul și decide. Automatizarea nu publică niciodată de una singură.
La aprobare artefactul este semnat și publicat într-un separa community-catalog.json pe CDN. Fiecare instanță care a adăugat sursa comunității vede pluginul; nucleul îl consideră de încredere prin cheie de registry fixată — nu este necesar niciun pas de încredere per-operator.

[!NOTE] Vechiul flux de publicare publică a fost retras; fluxul din cabinetul personal de mai sus — „Pluginurile mele” — este acum singura cale de publicare pentru comunitate. Plugin-urile comunitare sunt gratuite; puteți adăuga un link opțional de donație.

[!NOTE] Pluginuri de prima parte (Einstein, SIP, Bitrix24, pocket-agent, os-client) sunt nu publicat în acest fel — acestea sunt livrate prin propria lor conductă AiHummer CI și ajung în catalogul oficial fixat. Fluxul cabinetului personal este pentru comunitate (terță parte) pluginuri.

Moderație

Fiecare trimitere a comunității trece printr-un verificare automată (completitudine, manifestul capacității, semnătura și o scanare de securitate), apoi un Revizuirea riscului AI, și, în final, un revizuire umană obligatorie de echipa AiHummer. Nici automatizarea, nici AI-ul nu publică vreodată de unul singur — decizia aparține întotdeauna unui moderator, și nimic nu ajunge în catalog fără aprobarea lor. Un plugin publicat care ulterior se dovedește a fi malițios sau defect poate fi revocat și a fost eliminat din catalog la următoarea sincronizare.

Catalogul comunității ca sursă suplimentară

Pluginurile comunitare sunt publicate pe un separa community-catalog.json care face nu suprascrie catalogul curatat de primă parte. O instanță îl adaugă ca sursă suplimentară în Module → Surse (sau POST /v1/admin/modules/catalog/sources). Vezi Instalare și actualizări și Prezentare generală și niveluri.

Ciclul de viață al pluginului (App Store)

Piața funcționează ca un adevărat App Store — fiecare plugin are un identitate (un slug permanent + autor) sub care este livrat versiuni.

Versiuni și actualizări

O actualizare se livrează ca un nouă versiune al unui plugin deja publicat: același slug, propriul jurnal de modificări, propriile recenzii și moderare. Doar unu versiunea poate fi în revizuire într-un moment — trimiteți următoarea după ce cea curentă primește o decizie. Când este publicată o versiune nouă, cea anterioară este marcată superseded, iar catalogul + fiecare instanță se mută la cel nou.

Publicare programată

După ce un moderator îl aprobă, autorul controlează eliberarea: publică acum sau programează-l pentru un anumit moment — pluginul devine activ la momentul stabilit.

Nepublicare

Pauză — ascunde temporar pluginul: acesta dispare din catalogul public și de pe instanțe (la următoarea sincronizare), dar este păstrat și poate fi republicat în orice moment.
Îndepărtează de pe listă — elimină pluginul din piață pentru totdeauna.

De îndată ce un plugin este nepublicat (pus pe pauză sau retras din listă), intrarea sa este eliminată din community-catalog.json, iar instanțele încetează să o afișeze la următoarea sincronizare.

Autorat

Un plugin este publicat sub numele tău afișat (de exemplu, numele studioului tău) — sau anonim. Catalogul public și interfața web a instanței afișează numele ales sau „Anonim”; adresa ta reală de email/ID nu este niciodată expusă.

Statistici dezvoltator

Fiecare plugin are statistici agregate: descărcări, instalări, instanțe active și dezinstalări, plus un grafic zilnic. Numai cifre agregate — niciun fel de date pe instanță nu sunt expuse dezvoltatorului.

Recompensă pentru publicare

Pentru fiecare plugin pe care îl publici pentru prima dată, abonamentul tău AiHummer primește o lună gratuită (acordat o dată pentru fiecare plugin).

Unde următor

Trimite prin cabinetul personal — complet pas cu pas: metadate, manifestul capabilităților, revizuirea și moderarea AI.
SDK pentru plugin — câmpuri de manifest și aihummer comenzi plugin`.
Instalare și actualizări — multi-sursă, model de încredere, actualizări semnate, clasificare.
Verifică politica și lista de verificare — criteriile a plugin-ul este verificat înainte de publicare.
Piață: prezentare generală și niveluri — oficial vs registrul comunității.