Send inn en plugin via personlig kabinet

Den fellesskapsmarked lar enhver registrert kunde publisere en plugin for alle å installere — på samme måte som du publiserer en app til en app-butikk. Du fyller ut metadata for butikk-siden, oppgir hvilke tillatelser pluginen din trenger, laster opp bygget, og sender det til gjennomgang. Denne siden går gjennom hele prosessen steg for steg.

[!NOTE] Denne flyten er for fellesskap (tredjepart) plugins sendt inn gjennom din personlig skap at my.aihummer.ru. Førsteparts AiHummer-plugins leveres på sin egen pipeline. Fellesskaps-plugins er fri; du kan legge til en valgfri donasjonslenke.

Før du starter

A registrert personlig-kabinettkonto — registrer deg og bekreft det (se Registrering). Enhver kunde kan sende inn.
A bygget plugin — en signert utgivelsespakke produsert med Plugin SDK (aihummer plugin package). Hvis du har har ikke bygget en ennå, start der først.
En ikon og minst ett skjermbilde, og beskrivelsene dine klare i begge Russisk og engelsk.

Hvordan publisering fungerer (det store bildet)

Innsendingen din beveger seg gjennom en fastlagt prosess. Du kan følge statusen i skapet på hvert trinn.

Scene	Hva skjer	Hvem handler
Utkast	Du oppretter oppføringen og fyller ut metadata; ingenting er offentlig ennå.	Du
Sendt inn	Du sender det til gjennomgang.	Du
AI-gjennomgang	En automatisert agent sjekker pluginen mot gjennomgangspolicy — sikkerhet, manifest korrekthet, fullstendighet, innhold.	Automatisering
Moderasjon	En menneskelig moderator leser AI-rapporten pluss artefaktet ditt og metadataene og bestemmer.	AiHummer-team
Publisert	Ved godkjenning blir artefakten signert og lagt til i fellesskapskatalogen + den offentlige markedsføringsstrømmen.	AiHummer-team
Avvist	Hvis noe feiler, får du grunnene; fikse og sende på nytt.	Du → tilbake til utkast

[!IMPORTANT] Kunstig intelligens aldri publiserer på egen hånd. Et menneske tar alltid den endelige avgjørelsen, og ingenting når katalogen uten deres godkjenning.

Trinn 1 — Åpne «Mine plugins»

Logg inn på my.aihummer.ru, åpne «Mine tillegg» seksjon, og klikk «Publiser» (eller «Ny plugin»). Dette skaper en utkast du kan redigere fritt til du sender det inn.

Trinn 2 — Fyll ut butikkens metadata

Fyll ut alle felt. Ufullstendig metadata er en av de vanligste årsakene til at en innsending blir sendt tilbake.

Felt	Hva du skal skrive inn
Navn (RU + EN)	Pluginens visningsnavn på begge språkene.
Kort beskrivelse (RU + EN)	En linje for katalogkortet.
Full beskrivelse (RU + EN)	Hva pluginen gjør, hvordan man bruker den, hva den trenger. Meningsfull — ikke en plassholder.
Kategori	Velg ett fra den tillatte mengden (f.eks. Kanaler, Produktivitet, Integrasjoner, Tale, Verktøy).
Versjon	A semver streng, f.eks. `1.0.0`. Hver ny innsending må øke den.
Ikon	Et gyldig kvadratisk bilde.
Skjermbilder	Minst én; viser pluginen i aksjon.
Lisens	Pluginens lisens (f.eks. MIT, Apache-2.0).
Hjemmeside / arkiv	Valgfri `https://` lenke til prosjektet ditt.
Donasjonslenke	Valgfritt. Gyldig `https://` lenke til en velkjent donasjonsvert — for eksempel Boosty, Patreon, PayPal eller YooMoney. Phishing eller vilkårlige verter blir avvist.
Endringslogg (RU + EN)	Hva endret seg i denne versjonen.

[!TIP] Skriv beskrivelsene for en ekte bruker som aldri har sett plug-inen din. “dummies” er helt riktig: si hva det gjør, når du skal bruke det, og hva det trenger.

Trinn 3 — Deklarer kapabilitetsmanifestet

Den kapabilitetsmanifest er hjertet i sikkerhetsmodellen. Det er en kort, strukturert erklæring av hver tillatelse pluginen din trenger — hvilke verter det kommuniserer med, hvilke filer det berører, om det kjører eksterne kommandoer, hvilke kanaler og legitimasjon det bruker.

Hvorfor erklære det

Kunder ser de forespurte tillatelsene før de installerer og samtykke til dem, akkurat som en mobilapps tillatelsesforespørsel.
Forekomsten bruker manifestet til å begrense tillegget til det det erklærte.
Anmeldere sjekker at din erklært kapasiteter kamp hva koden faktisk gjør. En plugin som ber om en tillatelse den ikke har deklarert er avvist.

Prinsippet om minste privilegium

Erklære bare hva pluginen din faktisk bruker, og ikke mer. Færre tillatelser betyr raskere gjennomgang, enklere kundesamtykke og flere installasjoner. Hvis du ikke berører filsystemet, oppgi en tom liste. Hvis du aldri starter en prosess, sett exec til false.

Formatet

Kapasitetsmanifestet er et JSON-objekt med disse feltene:

Felt	Type	Betydning
`network`	streng[]	Vertsnavnene pluginen kobler til (dens egress-tillatelsesliste).
`filesystem`	streng[]	Stier den leser eller skriver til, i forhold til sin egen pluginkatalog.
`exec`	boolsk	Om det starter eksterne prosesser / kjører kommandoer.
`channels`	streng[]	Meldingskanaler den integreres med (f.eks. `telegram`).
`credentials`	streng[]	Navngitte hemmeligheter/konfigurasjonsnøkler den bruker (aldri de hemmelige verdiene).
`description`	streng	En kort, menneskeleselig oppsummering av hva det trenger og hvorfor.

Eksempel:

{
  "network": ["api.example.com", "cdn.example.com"],
  "filesystem": ["./cache"],
  "exec": false,
  "channels": ["telegram"],
  "credentials": ["api_token"],
  "description": "Calls the Example API to sync tasks and posts replies to Telegram. Caches responses under its own ./cache directory. No process spawning, no other hosts."
}

[!WARNING] Gjøre ikke sett ekte hemmeligheter, tokens eller nøkler hvor som helst — ikke i manifestet, ikke i metadataene, ikke i artifakten. Oppgi legitimasjon bare i navnet (f.eks. api_token); kunden oppgir den faktiske verdien ved installasjonstidspunktet. Hardkodet hemmeligheter er en automatisk avvisning.

Trinn 4 — Last opp artefakten

Last opp plugin-bygget ditt:

Format: en .tar.gz utgivelsespakke produsert av aihummer plugin package.
Det må inneholde pluginens manifest.json (SDK-manifestet — type, versjon, inngangspunkt, deklarert capabilities, konfigurasjonsfelter).
Kapasitetsmanifestet du fylte ut i trinn 3 må være konsekvent med hva koden og manifest.json faktisk gjøre

Du legger også ved ikon og skjermbilder her hvis du ikke allerede gjorde det.

[!TIP] Løp aihummer plugin validate lokalt før opplasting. Valideringskontrakten er den samme som markedet bruker, så en manifest som fungerer lokalt vil være akseptert her også.

Trinn 5 — Send til gjennomgang

Når hvert felt er fylt ut og artefakten er lastet opp, klikk «Send inn til gjennomgang». Kabinettet utfører først en fullstendighetskontroll; hvis noe mangler, forteller det deg nøyaktig hva. Når det er godkjent, flytter statusen seg til Sendt inn og så AI-gjennomgang — du trenger ikke å gjøre noe mer.

Trinn 6 — Følg statusen og les en dom

Åpne pluginen i «Mine tillegg» å følge statusen. Når gjennomgangen er ferdig, vil du se en av:

I moderasjon — den automatiserte gjennomgangen bestod eller merket bare små ting; en mennesket ser nå på det. Bare vent.
Avvist — noe mislyktes. Du vil se en dom, et sammendrag, og spesifikke elementer som ikke bestod (med grunnen for hver). Dette er din fikse-liste.
Publisert — godkjent, signert og aktiv. Plugin-en din vises nå på AiHummer-markedsplass og installeres i hvilken som helst instans som har det fellesskapskatalogen aktivert.

Hvordan lese et avslag og sende inn på nytt

Åpne pluginen; les mislykkede varer og deres grunner.
Fiks dem — de fleste er en av: en manglende/svak beskrivelse, en uoverensstemmende evne manifest, en hardkodet hemmelighet, en dårlig donasjonslenke, eller en versjon du ikke gjorde økning.
Rediger metadataene og/eller last opp en nytt artefakt med en økt versjon.
Klikk «Send inn til gjennomgang» igjen. Det går tilbake gjennom den samme prosessen.

[!NOTE] Et avslag er ikke en straff — det er en sjekkliste. gjennomgangspolicy er offentlig nettopp slik at du kan møte alle krav før du overgir deg.

Hvor neste

Gjennomgå policy og sjekkliste — den eksakte kriterier pluginen din blir sjekket mot.
Plugin SDK — bygg pluginen og dens manifest.json.
Publisering av en plugin — privat side-laste og de andre publiseringsmodusene.
Installer og oppdateringer — hvordan kunder installer og hvordan tillitsmodellen fungerer.