AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Markkinapaikka ja lisäosat/Laajennuksen julkaiseminen

Laajennuksen julkaiseminen

v1.1.x · päivitetty 2026-07-19

Rakenna laajennus kanssa Liitännäisen SDK? Voit julkaista sen kaksi tapaa:

  • Yksityinen (itsellesi) — sivulataa omaan instanssiisi. Artefakti ei koskaan jättää sen.
  • Yhteisö (kaikille) — julkaise kautta sinun henkilökohtainen kaappi luona my.aihummer.ru, sovelluskauppa tyyli: lataa versio, täytä kauppasivu, läpäise tarkastus, ja se päätyy allekirjoitettu yhteisökatalogi, jonka jokainen instanssi voi asentaa.

Analogia: asentaminen .vsix käsin (yksityinen) vs julkaiseminen sovelluskauppaan (yhteisö).

[!WARNING] Yhteisön liitännäisiä ei voi juuri nyt asentaa — kyse ei ole yhteysviasta. Avain, jolla yhteisökatalogi allekirjoitettiin, on peruttu; kunnes uusi avain julkaistaan, allekirjoituksen tarkistus hylkää nämä merkinnät. Tästä riippumatta kolmannen osapuolen koodia ei vielä ajeta palveluna palvelimellasi: kunnes eristetty ajoympäristö on olemassa, sallitaan vain integraatiot, jotka toimivat omalla puolellaan ja yhdistävät verkon yli.

Mitä näet: ”asenna”-napin jälkeen näkyy tavallinen viesti ”asennetaan”, mutta liitännäinen ei koskaan ilmesty asennettujen luetteloon. Hylkäyksen syy kirjautuu yhdyskäytävän lokiin — avaa Lokit hallintapaneelissa.

Mikä toimii tänään:

  • AiHummerin liitännäiset virallisesta katalogista — ne asentuvat kuten ennenkin ja niissä on toinen, voimassa oleva allekirjoitus;
  • MCP-palvelin HTTP:n yli — kytketään työkalulähteeksi ilman kehitystyötä, koodi pysyy sinun puolellasi;
  • OpenAPI-määrittelyyn perustuva integraatio — sama asia, ei asennettavaa palvelua.

Oman liitännäisen sivulataus läpäisee allekirjoituksen tarkistuksen, mutta se ajetaan vain etä-MCP:nä HTTP:n yli tai OpenAPI-integraationa; käännös, joka pitäisi käynnistää palveluna samalla palvelimella, hylätään.

Yksityinen tila — lataa sivusta omaan instanssiisi

Käytä tätä vain, kun tarvitset plugia: sisäinen liitäntä, mukautettu integraatio, testiversio.

Askeleet

  1. Pakkaa ja allekirjoita paketti: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Lataa se instanssiin kahdella tavalla:
    • Admin-käyttöliittymä → Laajennukset → “Lataa laajennus” — vedä kimppu; tai
    • Komentorivi: 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Konepellin alla tämä on POST /v1/admin/modules/upload (moniosainen, integrations:write): artefakti laskeutuu instanssi blob-tallennus (AIHUMMER_BLOB_DIR) alapuolella blob: ref, ja luettelorivi on rekisteröity origin = local-private, visibility = private.
  4. Laajennus näkyy markkinapaikalla tunnisteilla merkittynä Yksityinen ja asentaa kautta normaali polku — hiekkalaatikkoitu systemd-yksikkö + terveystarkastusportti.

Luottamus: kiinnitetty avain ja luottamuskauppa

Yksityiset esineet täytyy allekirjoittaa. Kun lataat lisäosan, joka on allekirjoitettu tuntemattomalla avaimella, järjestelmänvalvojan käyttöliittymä kehottaa sinua hyväksy kirjoittajan avain instanssin luottamusvarastoon (yksi klikkaus). Kun se on hyväksytty, allekirjoitus tarkistetaan jokaisessa asennuksessa ja päivityksessä.

  • Artifaktit lähtien virallinen lähteen tarkistus vastaan rekisteriavaimen kiinnitetty ydin — luotettu oletuksena, ei ylimääräistä vaihetta.
  • Yksityinen artefaktit tarkistetaan instanssin luottamusvaraston avaimia vastaan.
  • Allekirjoittamaton paketit hylätään — paitsi kehitystilassa paikalliseen iterointiin: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 poistaa allekirjoituksen vahvistuksen käytöstä ja on tarkoitettu Vain paikalliseen kehitykseen. Älä koskaan ota sitä käyttöön ulkoisesti saavutettavassa instanssissa.

Yhteisötila — julkaise henkilökohtaisen hallintapaneelin kautta

Tehdä liitännäinen saataville jokainen esimerkki, julkaise se omastasi henkilökohtainen kaappi luona my.aihummer.ru, samalla tavalla kuin julkaiset sovelluksen sovelluskaupassa. Lataat rakennelman, täytät kauppasivun ja lähetät sen tarkistettavaksi; ensin suoritetaan automaattinen tekoälytarkastus, sitten ihmismoderaattori tekee lopullisen päätöksen, ja hyväksynnän jälkeen artefakti allekirjoitetaan ja julkaistaan yhteisön luetteloon.

Koko, vaihe vaiheelta etenevä läpikäynti löytyy Lähetä lisäosa. Lyhyesti sanottuna:

  1. Rakenna ja pakkaa liitännäisesi SDK:n kanssa (aihummer plugin package) — esine on allekirjoitettu .tar.gz kantaa sen manifest.json.
  2. Avaa «Omat lisäosat» kaapissa ja luo lähetys: lataa esine, täytä tallenna metadata (nimi & kuvaukset RU + EN, versio, kuvake, kuvakaappaukset, luokka, valinnainen lahjoituslinkki, muutosloki) ja julista ominaisuusilmoitus.
  3. Lähetä tarkastettavaksi. Automaattinen tekoälyn arviointi tarkistaa lähetyksen vastaavuuden se arviointipolitiikka (turvallisuus, ilmentää) täsmällisyys, täydellisyys, sisältö), sitten a ihmismoderaattori lukee raportin ja päättää. Automaatio ei koskaan julkaise yksin.
  4. Hyväksynnässä artefakti on allekirjoitettu ja julkaistu erillinen community-catalog.json CDN:llä. Jokainen tapaus, joka on lisännyt yhteisön lähde näkee lisäosan; ydin luottaa siihen kautta kiinnitetty rekisteriavain — ei tarvita per-operaattorin luottamuksen vaihetta.

[!NOTE] Vanha julkinen julkaisupolku on poistettu käytöstä; yllä kuvattu henkilökohtaisen kaapin polku — “Omat lisäosat” — on ainoa yhteisön julkaisupolku. Yhteisön lisäosat ovat ilmaisia; voit lisätä vapaaehtoisen lahjoituslinkin.

[!NOTE] Ensimmäisen osapuolen lisäosat (Einstein, SIP, Bitrix24, pocket-agent, os-client) ovat ei julkaistu tällä tavalla — ne lähetetään omalla AiHummer CI -putkellaan ja päätyvät kiinnitetty virallinen luettelo. Henkilökohtaisen kaapin prosessi on tarkoitettu yhteisö (kolmannen osapuolen) laajennukset.

Kohtuullisuus

Jokainen yhteisön lähetys käy läpi automaattinen tarkistus (täydellisyys, kyvykkyysilmestys, allekirjoitus ja turvallisuustarkastus), sitten tekoälyn riskien tarkastelu, ja lopuksi a pakollinen ihmisen tarkastus AiHummer-tiimin toimesta. Ei automaatio eikä tekoäly koskaan julkaise itsenäisesti — päätös on aina moderaattorin, eikä mikään päädy luetteloon ilman heidän hyväksyntäänsä. Julkaistu liitännäinen, joka myöhemmin todetaan haitalliseksi tai vialliseksi, voidaan peruutettu ja poistettiin luettelosta seuraavassa synkronoinnissa.

Yhteisön luettelo lisälähteenä

Yhteisön lisäosat julkaistaan erillinen community-catalog.json se tekee ei ylikirjoittaa kuratoidun ensisijaisen katalogin. Instanssi lisää sen ylimääräisenä lähteenä Laajennukset → Lähteet (tai POST /v1/admin/modules/catalog/sources). Katso Asenna ja päivitykset ja Yleiskatsaus ja tasot.

Laajennuksen elinkaaren vaihe (App Store)

Markkinapaikka toimii kuin oikea App Store — jokaisella lisäosalla on identiteetti (pysyvä tunniste + kirjoittaja), jonka alla se toimitetaan versiot.

Versiot ja päivitykset

Päivitys toimitetaan muodossa uusi versio jo julkaistun lisäosan: sama tunniste, oma muutospäiväkirja, omat arvostelut ja moderointi. Vain yksi versio voi olla tarkastelussa kerrallaan — lähetät seuraavan sen jälkeen, kun nykyiseen on tehty päätös. Kun uusi versio julkaistaan, edellinen merkitään superseded, ja luettelo + kaikki esiintymät siirretään uuteen.

Aikataulutettu julkaisu

Sen jälkeen kun moderaattori hyväksyy sen, tekijä hallitsee julkaisua: julkaise nyt tai ajasta se tietylle ajalle — lisäosa tulee näkyviin sovittuna hetkenä.

Poistaminen julkaisemattomaksi

  • Tauko — piilottaa lisäosa tilapäisesti: se poistuu julkisesta luettelosta ja instansseista (seuraavassa synkronoinnissa), mutta säilytetään ja voi olla uudelleenjulkaistu milloin tahansa.
  • Poistaa listalta — poistaa laajennus markkinapaikalta lopullisesti.

Heti kun liitännäinen on julkaisematon (tauolla tai poistettu listalta), sen merkintä poistetaan community-catalog.json, ja tapaukset lakkaavat näkymästä seuraavassa synkronoinnissa.

Tekijyys

Laajennus on julkaistu alaisuudessa näyttönimesi (esim. studionne nimi) — tai nimettömästi. Julkinen luettelo ja instanssin verkkokäyttöliittymä näyttävät valitun nimen tai ”Nimetön”; todellinen sähköpostiosoitteesi/tunnuksesi ei koskaan paljastu.

Kehittäjät tilastot

Jokaisella lisäosalla on kokonaisstatistiikka: lataukset, asennukset, aktiiviset instanssit ja poistoasennukset, sekä päivittäinen kaavio. Vain yhteenlasketut luvut — kehittäjälle ei paljasteta yksittäisiä instanssitietoja.

Julkaisupalkkio

Varten jokainen lisäosa, jonka julkaiset ensimmäistä kertaa, AiHummer-tilauksesi saa yksi ilmainen kuukausi (myönnetään kerran per laajennus).

Minne seuraavaksi