AiHummer
Norsk▾
Logg påKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Markedsplass og plugins/Publisering av en plugin

Publisering av en plugin

v1.1.x · oppdatert 2026-07-19

Bygget en plugin med Plugin SDK? Du kan publisere det i to veier:

  • Privat (for deg selv) — last inn siden i din instans. Artefakten aldri lar det.
  • Samfunn (for alle) — publiser gjennom din personlig skap at my.aihummer.ru, app-butikk stil: last opp byggingen, fyll ut butikk-siden, bestå gjennomgangen, og det lander i signert fellesskapskatalog som hver instans kan installere fra.

Analogi: installere en .vsix for hånd (privat) vs publisering til en app-butikk (fellesskap).

[!WARNING] Fellesskapets programtillegg kan ikke installeres nå — det er ikke en tilkoblingsfeil. Nøkkelen som signerte fellesskapskatalogen er trukket tilbake; inntil en ny nøkkel kommer, avviser signaturkontrollen disse oppføringene. Uavhengig av det kjøres tredjepartskode ennå ikke som en tjeneste på serveren din: inntil et isolert kjøremiljø finnes, tillates bare integrasjoner som kjører hos seg selv og kobler til over nettet.

Det du ser: etter klikk på «installer» vises den vanlige meldingen «installerer», men tillegget dukker aldri opp i listen over installerte. Årsaken til avslaget havner i gateway-loggen — åpne Logger i administrasjonspanelet.

Det som virker i dag:

  • tillegg fra AiHummer i den offisielle katalogen — de installeres som vanlig og har en annen, gyldig signatur;
  • en MCP-server over HTTP — koblet til som verktøykilde uten utvikling, koden blir hos deg;
  • en integrasjon via OpenAPI-spesifikasjon — det samme, ingen tjeneste å installere.

Sidelasting av ditt eget tillegg består signaturkontrollen, men kjøres bare som fjern-MCP over HTTP eller OpenAPI-integrasjon; et bygg som må startes som tjeneste på samme server, avvises.

Privat modus — last inn fra siden til din instans

Bruk dette når bare du trenger pluginen: en intern kobling, en tilpasset integrasjon, en testversjon.

Trinn

  1. Pakk og signer bunten: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Last det opp til instansen på en av to måter:
    • Admin UI → Plugins → «Last opp plugin» — dra bunten; eller
    • CLI: 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Under panseret er dette POST /v1/admin/modules/upload (flerdelt, integrations:write): artefakten lander i instans blob-lagring (AIHUMMER_BLOB_DIR) under en blob: ref, og en katalograd registreres med origin = local-private, visibility = private.
  4. Pluginet vises i markedsplassen med tag Privat og installerer via normal sti — sandboxet systemd-enhet + helsegitter.

Tillitt: den fastsatte nøkkelen og tillitslageret

Private gjenstander må signeres. Når du laster opp en plugin signert med en ukjent nøkkel, vil Admin UI be deg om å godkjenne forfatterens nøkkel inn i instansens tillitslager (ett klikk). Når det er godkjent, verifiseres signaturen ved hver installasjon og oppdatering.

  • Artefakter fra offisiell kilde verifisere mot registeroppføring festet i kjernen — tillitsfull som standard, ingen ekstra trinn.
  • Privat artefakter verifiseres mot nøkler i forekomstens tillitslager.
  • Uunderskrevet pakker blir avvist — unntatt i utviklingsmodus for lokal iterasjon: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 deaktiverer signaturverifisering og er ment kun for lokal utvikling. Aktiver det aldri på en eksternt tilgjengelig instans.

Fellesskapsmodus — publiser gjennom personlig kabinett

For å gjøre en plugin tilgjengelig for hver for eksempel, publiser det fra din personlig skap at my.aihummer.ru, på samme måte som du publiserer en app i en appbutikk. Du laster opp bygget, fyller ut butikk-siden og sender det til gjennomgang; en automatisk AI-sjekk kjører først, deretter gjør en menneskelig moderator den endelige avgjørelsen, og ved godkjenning blir artefakten signert og publisert i fellesskapskatalogen.

Den fullstendige, trinn-for-trinn veiledningen finnes på Send inn et tillegg. Kort sagt:

  1. Bygg og pakk ditt plugin med SDK-en (aihummer plugin package) — artefakten er en signert .tar.gz som bærer sin manifest.json.
  2. Åpne «Mine tillegg» i skapet og opprett en innsending: last opp artefakt, fyll ut lagre metadata (navn og beskrivelser på RU + EN, versjon, ikon, skjermbilder, kategori, valgfri donasjonslenke, endringslogg) og deklarere kapabilitetsmanifest.
  3. Send til gjennomgang. En automatisert AI-gjennomgang sjekker innleveringen mot det gjennomgangspolicy (sikkerhet, manifest) korrekthet, fullstendighet, innhold), deretter en menneskelig moderator leser rapporten og bestemmer. Automatiseringen publiserer aldri på egen hånd.
  4. Ved godkjenning artefaktet er signert og publisert til en separat community-catalog.json på CDN-en. Hver forekomst som har lagt til fellesskapskilde ser pluginen; kjernen stoler på den via festet registertast — ingen per-operatør tillitstrinn nødvendig.

[!NOTE] Den gamle offentlige publiseringsflyten er pensjonert; den personlige-kabinettflyten ovenfor — «Mine plugins» — er nå den eneste publiseringsveien for fellesskapet. Fellesskapsplugins er gratis; du kan legge til en valgfri donasjonslenke.

[!NOTE] Førsteparts-plugins (Einstein, SIP, Bitrix24, pocket-agent, os-client) er ikke publisert på denne måten — de sendes på sin egen AiHummer CI-pipeline og lander i den festede offisielle katalogen. Flyten for personlig kabinett er for samfunn (tredjepart) plugins.

Moderasjon

Hver bidrag fra samfunnet går gjennom en automatisk sjekk (fullstendighet, kapabilitetsmanifestet, signatur og en sikkerhetsskanning), deretter en Vurdering av AI-risiko, og til slutt en obligatorisk menneskelig gjennomgang av AiHummer-teamet. Verken automasjonen eller AI-en publiserer noen gang på egen hånd — beslutningen er alltid en moderators, og ingenting når katalogen uten deres godkjenning. En publisert plugin som senere viser seg å være skadelig eller defekt kan bli tilbakekalt og ble fjernet fra katalogen ved neste synkronisering.

Fellesskapskatalogen som en ekstra kilde

Fellesskapsplugins publiseres til en separat community-catalog.json det gjør ikke overskrive den kuraterte førsteparts-katalogen. En instans legger den til som en ekstra kilde i Plugins → Kilder (eller POST /v1/admin/modules/catalog/sources). Se Installer og oppdateringer og Oversikt og nivåer.

Plugin-livssyklus (App Store)

Markedet fungerer som en ekte App Store — hver plugin har en identitet (en permanent slug + forfatter) under hvilken den sendes versjoner.

Versjoner og oppdateringer

En oppdatering leveres som en ny versjon av en allerede publisert plugin: samme slug, sin egen endringslogg, sine egne anmeldelser og moderering. Bare en versjonen kan være under vurdering på et tidspunkt — du sender inn den neste etter at den nåværende får en avgjørelse. Når en ny versjon publiseres, blir den forrige merket superseded, og katalogen + hver enkelt forekomst flyttes til den nye.

Planlagt publisering

Etter at en moderator godkjenner det, forfatteren kontrollerer utgivelsen: publiser nå, eller planlegg det til et bestemt tidspunkt — pluginen går live på det avtalte tidspunktet.

Avpublisering

  • Pause — midlertidig skjul pluginen: den forsvinner fra den offentlige katalogen og fra instanser (ved neste synkronisering), men beholdes og kan være gjenutgitt når som helst.
  • Fjerne fra liste — fjern pluginen fra markedsplassen for godt.

Så snart en plugin ikke er offentliggjort (pauset eller fjernet fra listen), blir oppføringen dens fjernet fra community-catalog.json, og forekomster slutter å vise det på neste synkronisering.

Forfatterskap

Et tillegg publiseres under ditt visningsnavn (f.eks. navnet på studioet ditt) — eller anonymt. Den offentlige katalogen og instansens nettgrensesnitt viser det valgte navnet eller «Anonym»; din ekte e-post/ID blir aldri eksponert.

Utviklerstatistikk

Hver plugin har aggregerte statistikker: nedlastinger, installasjoner, aktive forekomster og avinstallasjoner, pluss et daglig diagram. Kun aggregerte tall — ingen data per forekomst blir gjort tilgjengelig for utvikleren.

Publiseringsbelønning

For hver plugin du publiserer for første gang, ditt AiHummer-abonnement får én gratis måned (tildelt én gang per plugin).

Hvor neste