Publicera ett plugin

Byggde ett plugin med [Plugin-SDK](/sv/v1.0/marketplace/sdk)? Du kan publicera det i **två sätt**: - **Privat (för dig själv)** — sidoladda in i *din* instans. Artefakten aldrig lämnar det. - **Gemenskap (för alla)** — publicera genom din [personligt skåp](/sv/v1.0/portal/overview) vid **my.aihummer.ru**, appbutik stil: ladda upp byggnaden, fyll i butikssidan, klara granskningen, och den landar i signerad communitykatalog som varje instans kan installera från. Analogi: installera en `.vsix` för hand (privat) vs publicering till en appbutik (gemenskap). > [!WARNING] > **Community-plugin går inte att installera just nu — det är inte ett > anslutningsfel.** Nyckeln som signerade community-katalogen har dragits > tillbaka; tills en ny nyckel levereras avvisar signaturkontrollen de posterna. > Fristående från det körs tredjepartskod ännu inte som en tjänst på din server: > tills en isolerad körmiljö finns tillåts bara integrationer som körs på sin > egen sida och ansluter över nätet. > > **Det du ser:** efter klick på ”installera” visas det vanliga meddelandet > ”installerar”, men insticket **dyker aldrig upp** i listan över installerade. > Orsaken till avslaget hamnar i gatewayens logg — öppna **Loggar** i > administrationspanelen. > > **Det som fungerar i dag:** > > - **plugin från AiHummer** i den officiella katalogen — de installeras som > vanligt och bär en annan, giltig signatur; > - **en MCP-server över HTTP** — ansluten som verktygskälla utan utveckling, > koden stannar hos dig; > - **en integration via OpenAPI-specifikation** — samma sak, ingen tjänst att > installera. > > Att sidoladda ditt eget plugin klarar signaturkontrollen, men det körs bara som > **fjärr-MCP över HTTP** eller OpenAPI-integration; ett bygge som måste startas > som tjänst på samma server avvisas. ## Privatläge — sidoladda in i din instans Använd detta när endast du behöver plugin: en intern kontakt, en anpassad integration, en testversion. ### Steg 1. Paketera och underteckna paketet: ```bash aihummer plugin package ./my-plugin aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz ``` 2. Ladda upp det till instansen på ett av två sätt: - **Admin UI → Tillägg → "Ladda upp tillägg"** — dra buntet; eller - CLI: ```bash aihummer plugin publish --private --instance https://your-instance \ --token <admin-token> my-plugin-1.0.0.tar.gz ``` 3. Under huven är detta `POST /v1/admin/modules/upload` (multipart, `integrations:write`): artefakten landar i **instans bloblagring** (`AIHUMMER_BLOB_DIR`) under en `blob:` ref, och en katalograd registreras med `origin = local-private`, `visibility = private`. 4. Pluginet visas i marknadsplatsen med tagg **Privat** och installerar via normal väg — [sandboxad systemd-enhet + hälsogrind](/sv/v1.0/marketplace/install-updates). ### Förtroende: den fastnålade nyckeln och förtroendebutiken Privata artefakter **måste undertecknas**. När du laddar upp ett plugin som är signerat med en okänd nyckel, uppmanar Admin UI dig att **godkänn författarens nyckel** in i instansens förtroendelager (ett klick). När det godkänts verifieras signaturen vid varje installation och uppdatering. - Artefakter från **officiell** källverifiera mot **registreringsnyckel fastnålad i kärnan** — betrodd som standard, inget extra steg. - **Privat** artefakter verifierar mot nycklar i instansens betrodda lagringsplats. - **Ounderskriven** paket avvisas — utom i utvecklingsläge för lokal iteration: `AIHUMMER_PLUGIN_DEV_UNSIGNED=1`. > [!WARNING] > `AIHUMMER_PLUGIN_DEV_UNSIGNED=1` inaktiverar signaturverifiering och är avsedd > endast för lokal utveckling. Aktivera det aldrig på en externt åtkomlig instans. ## Community-läge — publicera genom det personliga kontot För att göra ett plugin tillgängligt för **varje** exempel, publicera det från din **personligt skåp** vid **my.aihummer.ru**, på samma sätt som du publicerar en app till en appbutik. Du laddar upp bygget, fyller i butikssidan och skickar det för granskning; en automatiserad AI-kontroll körs först, sedan gör en mänsklig moderator det slutgiltiga beslutet, och vid godkännande signeras artefakten och publiceras i gemenskapskatalogen. Den fullständiga steg-för-steg-genomgången finns på [Skicka in ett tillägg](/sv/v1.0/marketplace/submit-plugin). Kort sagt: 1. **Bygg och paketera** din plugin med SDK:n ([`aihummer plugin package`](/sv/v1.0/marketplace/sdk)) — artefakten är en undertecknad `.tar.gz` bärande dess `manifest.json`. 2. **Öppna «Mina tillägg»** i skåpet och skapa en insändning: **ladda upp artefakt**, fyll i **lagra metadata** (namn & beskrivningar på RU + EN, version, ikon, skärmdumpar, kategori, valfri donationslänk, ändringslogg) och deklarera [kapabilitetsmanifest](/sv/v1.0/marketplace/submit-plugin#step-3--declare-the-capability-manifest). 3. **Skicka för granskning.** En automatiserad **AI-granskning** kontrollerar inskickningen mot det [granskningspolicy](/sv/v1.0/marketplace/review-policy) (säkerhet, manifest) korrekthet, fullständighet, innehåll), då en **mänsklig moderator** läser rapporten och bestämmer. Automatiseringen publicerar aldrig på egen hand. 4. **Vid godkännande** artefakten är **undertecknad** och publicerad till en **separera `community-catalog.json`** på CDN. Varje instans som har lagt till community source ser plugin; core litar på det via **fastnålad registernyckel** — inget förtroendesteg per operatör behövs. > [!NOTE] > **Det gamla offentliga publiceringsflödet har pensionerats**; flödet via det > personliga kabinettet ovan — «Mina tillägg» — är den enda publiceringsvägen för > community-tillägg. Community-tillägg är **gratis**; du kan lägga till en > frivillig donationslänk. > [!NOTE] > **Förstapartstillägg** (Einstein, SIP, Bitrix24, pocket-agent, os-client) är > inte publicerat på detta sätt — de skickas på sin egen AiHummer CI-pipeline och landar i > den fastnålda officiella katalogen. Flödet för personligt skåp är för **gemenskap > (tredjepart)** plugins. ## Moderering Varje bidrag från samhället går igenom en **automatiserad kontroll** (fullständighet, kapabilitetsmanifestet, signaturen och en säkerhetsskanning), sedan en **AI-riskgranskning**, och slutligen en **obligatorisk manuell granskning** av AiHummer-teamet. Varken automatiseringen eller AI:n publicerar någonsin på egen hand — beslutet är alltid en moderators, och ingenting når katalogen utan deras godkännande. Ett publicerat plugin som senare visar sig vara skadligt eller trasigt kan bli **återkallad** och togs bort från katalogen vid nästa synkronisering. ## Gemenskapens katalog som en extra källa Community-plugins publiceras till en **separera** `community-catalog.json` det gör **inte** skriv över den noggrant utvalda förstapartskatalogen. Ett exempel lägger till det som en extra källa i **Plugins → Källor** (eller `POST /v1/admin/modules/catalog/sources`). Se [Installera & uppdateringar](/sv/v1.0/marketplace/install-updates#multi-source-catalog) och [Översikt och nivåer](/sv/v1.0/marketplace/overview-tiers#official-and-community). ## Pluginlivscykel (App Store) Marknadsplatsen fungerar som en riktig App Store — varje plugin har en **identitet** (en permanent slug + författare) under vilken det levereras **versioner**. ### Versioner och uppdateringar En uppdatering levereras som en **ny version** av ett redan publicerat plugin: samma slug, sin egen ändringslogg, sina egna recensioner och sin egen moderering. Endast **en** versionen kan vara under granskning vid ett tillfälle — du skickar in nästa efter att den nuvarande fått ett beslut. När en ny version publiceras markeras den föregående `superseded`, och katalogen + varje instans flyttas till den nya. ### Schemalagd publicering Efter att en moderator godkänner det, **författaren kontrollerar utsläppet**: publicera nu, eller schemalägg det till en specifik tid — tillägget går live vid den utsatta tidpunkten. ### Avpublicera - **Paus** — tillfälligt gömma plugin: den tas bort från den offentliga katalogen och från instanser (vid nästa synkronisering), men behålls och kan vara **återpublicerad** när som helst. - **Ta bort från listan** — ta bort pluginen från marknadsplatsen för gott. Så snart ett plugin avpubliceras (pausas eller tas bort från listan), tas dess post bort från `community-catalog.json`, och instanser slutar visa det vid nästa synkronisering. ### Författarskap Ett tillägg publiceras under **ditt visningsnamn** (t.ex. namnet på din studio) — eller **anonymt**. Den offentliga katalogen och instansens webbgränssnitt visar det valda namnet eller ”Anonym”; din verkliga e-post/ID exponeras aldrig. ### Utvecklarstatistik Varje plugin har **aggregerade statistik**: nedladdningar, installationer, aktiva instanser och avinstallationer, samt ett dagligt diagram. Endast aggregerade siffror — inga per-instansdata exponeras för utvecklaren. ### Publiceringsbelöning För **varje plugin du publicerar för första gången**, din AiHummer-prenumeration får **en gratis månad** (beviljas en gång per plugin). ## Vart härnäst - [Skicka in via det personliga kontoret](/sv/v1.0/marketplace/submit-plugin) — den fullständiga steg-för-steg: metadata, kapacitetsmanifest, AI-granskning och moderation. - [Plugin-SDK](/sv/v1.0/marketplace/sdk) — manifestfält och `aihummer plugin`-kommandon. - [Installera & uppdateringar](/sv/v1.0/marketplace/install-updates) — flerkällig, den tillitsmodell, signerade uppdateringar, ranking. - [Granska policy och checklista](/sv/v1.0/marketplace/review-policy) — kriterierna a plugin kontrolleras innan publicering. - [Marknadsplats: översikt och nivåer](/sv/v1.0/marketplace/overview-tiers) — officiell vs-communityregister.