Plugina avaldamine — AiHummer Dokumendid

Ehitas pistikprogrammi koos Plugina SDK? Sa võid selle avaldada kaks viisi:

Privaatne (enda jaoks) — paigalda sinu eksemplari. Artefakti kunagi laseb selle.
Kogukond (kõigile) — avalda läbi oma isiklik kabinet juures my.aihummer.ru, rakenduste pood stiil: laadige üles versioon, täitke poodide leht, läbige ülevaatus ja see jõuab allkirjastatud kogukonna kataloog, millest iga eksemplar saab installida.

Analoogia: paigaldamine .vsix käsitsi (privaatne) vs avaldamine rakenduste poes (ühiskond)

[!WARNING] Kogukonna pistikprogramme ei saa praegu paigaldada — see ei ole ühendusetõrge. Võti, millega kogukonna kataloogi allkirjastati, on tagasi võetud; kuni uus võti välja tuleb, lükkab allkirjakontroll need kirjed tagasi. Sellest sõltumatult ei käivitata kolmanda osapoole koodi veel teenusena teie serveris: kuni isoleeritud käituskeskkonda pole, on lubatud ainult integratsioonid, mis töötavad omal poolel ja ühenduvad üle võrgu.

Mida näete: pärast „paigalda” vajutamist ilmub tavapärane teade „paigaldatakse”, kuid pistikprogramm ei ilmu kunagi paigaldatute loendisse. Keeldumise põhjus läheb lüüsi logisse — avage halduspaneelis Logid.

Mis täna töötab:

AiHummeri pistikprogrammid ametlikust kataloogist — need paigalduvad tavapäraselt ja kannavad teist, kehtivat allkirja;

MCP-server üle HTTP — ühendatakse tööriistaallikana ilma arenduseta, kood jääb teie poolele;

OpenAPI-spetsifikatsiooni järgi integratsioon — sama, ilma paigaldatava teenuseta.

Oma pistikprogrammi kõrvallaadimine läbib allkirjakontrolli, kuid käivitub ainult kaug-MCP-na üle HTTP või OpenAPI-integratsioonina; ehitis, mis tuleks käivitada teenusena samas serveris, lükatakse tagasi.

Privaatrežiim — külglaadimine oma eksemplari

Kasuta seda ainult siis, kui ainult sina vajad pistikprogrammi: sisemine ühendus, kohandatud integratsioon, testversioon.

Sammud

Paki ja allkirjasta pakk

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

Laadige see üles üks kahest viisist:

Admin UI → Pluginad → “Laadi plugin üles” — lohista pakk; või

KLI:

aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz

Selle sisu all see on POST /v1/admin/modules/upload (mitmeosaline, integrations:write): artefakt maandub eksemplari blobi salvestus (AIHUMMER_BLOB_DIR) all blob: ref, ja kataloogi rida on registreeritud koos origin = local-private, visibility = private.
Plugin ilmub turul sildistatud Privaatne ja paigaldab kaudu tavaline tee — liivakastitud systemd üksus + tervise värav.

Usaldus: kinnitatud võti ja usalduspoeg

Privaatseid esemeid peab olema allkirjastatud. Kui laadite üles plugina, mis on allkirjastatud tundmatu võtmega, kuvab Admin UI teate heaks kiita autori võti juhuks usalduspoes (üks klõps). Pärast heakskiitu kontrollitakse allkirja iga paigaldamise ja värskenduse puhul.

Esemed alates ametlik allikat kontrollida võrreldes sellega registrivõti kinnitatud tuumas — vaikimisi usaldatud, lisasammuta.
Privaatne artifakte kontrollitakse instantsi usalduspoes olevate võtmete vastu.
Allakirjutamata komplekte lükatakse tagasi — välja arvatud arendustingimustes kohalikuks iteratsiooniks: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 keelab allkirja kontrollimise ja on mõeldud ainult kohaliku arenduse jaoks. Ära kunagi luba seda väliselt ligipääsetaval instantsil.

Kogukonna režiim — avalda läbi isikliku kabineti

Et muuta pistikprogramm kättesaadavaks iga näide, avalda see oma isiklik kabinet juures my.aihummer.ru, samamoodi nagu avaldate rakenduse rakenduste poele. Te laadite üles ehituse, täidate poelehe ja saadate selle ülevaatuseks; esmalt käib läbi automatiseeritud AI kontroll, seejärel teeb lõpliku otsuse inimmoderaator ja heakskiidu korral allkirjastatakse artefakt ja avaldatakse kogukonna kataloogis.

Täielik samm-sammuline juhend on kohal Esita pistikprogramm. Lühidalt:

Ehita ja paki sinu plugin SDK-ga (aihummer plugin package) — artefakt on allkirjastatud .tar.gz kandes seda manifest.json.
Ava «Minu pistikprogrammid» kapi sees ja loo esituse: laadi üles artefakt, täida salvesta metainfo (nimi ja kirjeldused vene ja inglise keeles, versioon, ikoon, ekraanipildid, kategooria, valikuline annetuse link, muudatused) ja deklaratsiooni võimekuse manifest.
Saada ülevaatamiseks. Automatiseeritud Tehisintellekti ülevaade kontrollib esitust võrreldes see ülevaatamispoliitika (julgeolek, deklaratsioon) täpsus, täielikkus, sisu), siis a inimese moderaator loeb aruannet ja otsustab. Automatiseerimine ei avalda kunagi iseseisvalt.
Heakskiidul see kunstiteos on allkirjastatud ja avaldatud eraldiseisev community-catalog.json CDN-is. Igal eksemplaril, mis on lisanud kogukonna allikas näeb pistikprogrammi; tuum usaldab seda kaudu fikseeritud registrivõti — ei ole vaja operaatori usaldusetappi.

[!NOTE] Vana avalik avaldamisvoog on lõpetatud; ülaltoodud isikliku kabineti voog — “Minu pistikprogrammid” — on ainus kogukonna avaldamise tee. Kogukonna pistikprogrammid on tasuta; võite lisada vabatahtliku annetuse lingi.

[!NOTE] Esimese osapoole pluginad (Einstein, SIP, Bitrix24, pocket-agent, os-client) on ei avaldata sellisel viisil — need liiguvad oma AiHummer CI torujuhtme kaudu ja maanduvad kinnitatud ametlik kataloog. Isikliku kabineti voog on mõeldud kogukond (kolmanda osapoole) pluginad.

Vahendamine

Iga kogukonna esitlus läbib automatiseeritud kontroll (täielikkus, võimekuse manifest, allkiri ja turvakontroll), siis Tehisintellekti riski ülevaade, ja lõpuks üks kohustuslik inimlik ülevaatus AiHummeri meeskonna poolt. Ei automatiseerimine ega tehisintellekt kunagi ei avalda midagi iseseisvalt — otsus on alati moderaatori oma ja midagi ei jõua kataloogi ilma nende heakskiiduta. Avaldatud pistikprogramm, mis hiljem osutub pahatahtlikuks või riknenuks, võib olla tühistatud ja eemaldati järgmisel sünkroniseerimisel kataloogist.

Ühiskonna kataloog lisallikana

Kogukonna pistikprogrammid avaldatakse eraldiseisev community-catalog.json see teeb ei kirjutab üle kureeritud esmapoolse kataloogi. Näide lisab selle täiendava allikana Pistikprogrammid → Allikad (või POST /v1/admin/modules/catalog/sources). Vaata Paigalda ja uuendused ja Ülevaade ja tasemed.

Pistikprogrammi elutsükkel (App Store)

Turuplats töötab nagu tõeline App Store — iga pistikprogrammiga on identiteet (püsiv lühinimi + autor), mille all see laevad versioonid.

Versioonid ja uuendused

Uuendus tuleb koos uus versioon juba avaldatud pistikprogrammi puhul: sama slug, oma muudatuslind, oma arvustused ja modereerimine. Ainult üks versioon võib olla korraga ülevaatamisel — sa esitad järgmise alles pärast seda, kui praegusele on tehtud otsus. Kui uus versioon avaldatakse, märgitakse eelmine superseded, ja kataloog + iga näide liigub uuele.

Ajakava alusel avaldamine

Pärast seda, kui moderaator selle kinnitab, autor kontrollib vabastamist: avalda kohe või ajasta see kindlaks ajaks — pistikprogramm läheb otseülekandesse määratud ajal.

Avaldamata jätmine

Peatus — peida plugin ajutiselt: see kaob avalikust kataloogist ja instantsidelt (järgmisel sünkroniseerimisel), kuid säilitatakse ja võib olla uuesti avaldatud igal ajal.
Eemalda noteering — eemalda pistikprogramm turuplatsilt jäädavalt.

Niipea kui pistikprogramm on avaldamata (peatatud või eemaldatud), eemaldatakse selle kirje community-catalog.json, ja juhtumid lõpetavad selle näitamise järgmise sünkroonimise ajal.

Autorlus

Plugin on avaldatud all teie kuvamine nimi (nt teie stuudio nimi) — või anonüümselt. Avalik kataloog ja instantsi veebiliides näitavad valitud nime või „Anonüümne“; sinu tegelik e-post/ID ei ole kunagi nähtav.

Arendaja statistika

Igal pistikprogrammil on kogusummade statistika: allalaadimised, installatsioonid, aktiivsed eksemplarid ja desinstallatsioonid, pluss igapäevane diagramm. Koondandmed ainult — arendajale ei kuvata andmeid üksikute eksemplaride kohta.

Avaldamise preemia

Selleks iga plugin, mille te esmakordselt avaldate, teie AiHummeri tellimus saab üks tasuta kuu (antakse kord plugina kohta).

Kuhu edasi

Esita läbi isikliku konto — täielik samm-sammult: metaandmed, võimekuse manifest, tehisintellekti ülevaade ja modereerimine.
Plugina SDK — manifesti väljad ja aihummer plugin käsud.
Paigalda ja uuendused — mitmeallikaga, see usaldusmudel, allkirjastatud värskendused, järjestamine.
Ülevaate poliitika ja kontrollnimekiri — kriteeriumid a plugin kontrollitakse enne avaldamist.
Turul: ülevaade ja tasemed — ametlik vs kogukonna register.