AiHummer
Latviešu▾
PierakstītiesKonts
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Tirgus un spraudņi/Spraudņa publicēšana

Spraudņa publicēšana

v1.2.x · atjaunināts 2026-07-19

Izveidoja spraudni ar Spraudņa SDK? Jūs to varat publicēt divi veidi:

  • Privāts (tev pašam) — sānu ielāde savā instancē. Šis artefakts nekad pamet to.
  • Kopiena (visiem) — publicēt caur savu personīgā kabinets pie my.aihummer.ru, lietotņu veikals stils: augšupielādēt būvējumu, aizpildīt veikala lapu, iziet pārskatu, un tas nonāk parakstīts kopienas katalogs, no kura katra instance var instalēt.

Alegorija: instalēšana .vsix ar roku (privāti) pret publicēšanu lietotņu veikalā (kopienai).

[!WARNING] Kopienas spraudņus pašlaik nav iespējams uzstādīt — tā nav savienojuma kļūme. Atslēga, ar kuru tika parakstīts kopienas katalogs, ir atsaukta; līdz jaunas atslēgas izlaidumam paraksta pārbaude šādus ierakstus noraida. Neatkarīgi no tā trešo pušu kods vēl netiek darbināts kā pakalpojums jūsu serverī: kamēr nav izolētas izpildvides, atļautas ir tikai integrācijas, kas darbojas savā pusē un pieslēdzas pa tīklu.

Ko jūs redzēsiet: pēc pogas «uzstādīt» parādās ierastais paziņojums «uzstāda», bet spraudnis nekad neparādās uzstādīto sarakstā. Atteikuma iemesls nonāk vārtejas žurnālā — atveriet Žurnāli pārvaldības panelī.

Kas darbojas šodien:

  • AiHummer spraudņi no oficiālā kataloga — tie uzstādās kā parasti un tiem ir cits, derīgs paraksts;
  • MCP serveris pa HTTP — pieslēdzams kā rīku avots bez izstrādes, kods paliek jūsu pusē;
  • integrācija pēc OpenAPI specifikācijas — tas pats, bez uzstādāma pakalpojuma.

Sava spraudņa sānielāde iztur paraksta pārbaudi, taču darbosies tikai kā attālināts MCP pa HTTP vai OpenAPI integrācija; būvējums, kas jāpalaiž kā pakalpojums tajā pašā serverī, tiek noraidīts.

Privātais režīms — ielādēt sāniski savā instancē

Izmantojiet to tikai tad, kad jums nepieciešams spraudnis: iekšējais savienotājs, pielāgota integrācija, testa versija.

Soli

  1. Iepakot un parakstīt paku: 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Augšupielādējiet to uz instanci divos veidos:
    • Administratora lietotāja interfeiss → Spraudņi → “Augšupielādēt spraudni” — velciet saišķi; vai
    • Komandrindas interfeiss (CLI): 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Pagrabā tas ir POST /v1/admin/modules/upload (daudzdaļīgs, integrations:write): relikvija nonāk instanču bloba krātuve (AIHUMMER_BLOB_DIR) zem blob: atsauce, un katalogu rinda tiek reģistrēta ar origin = local-private, visibility = private.
  4. Spraudnis parādās tirgus vietā ar birku Privāts un instalē caur parasts ceļš — sandboxēta systemd vienība + veselības vārti.

Uzticamība: piespraustā atslēga un uzticamības veikals

Privātie artefakti jāparaksta. Kad jūs augšupielādējat spraudni, kas parakstīts ar nezināmu atslēgu, administrēšanas lietotāja saskarne piedāvā jums apstiprināt autora atslēgu instanču uzticības veikala (viens klikšķis). Kad tas apstiprināts, paraksts tiek pārbaudīts katrā instalācijā un atjauninājumā.

  • Artefakti no oficiāls avots pārbaudīt pret reģistra atslēga piesprausta kodolā — uzticams pēc noklusējuma, bez papildu soļiem.
  • Privāts artefakti tiek pārbaudīti pret atslēgām instanču uzticamības krātuvē.
  • Neparakstīts paketes tiek noraidītas — izņemot izstrādes režīmā lokālai atkārtošanai: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 atspējo paraksta pārbaudi un ir domāts tikai lokālai izstrādei. Nekad neieslēdziet to uz ārēji pieejama instancēm.

Kopienas režīms — publicēt caur personīgo kabinetu

Lai padarītu spraudni pieejamu katrs gadījumā, publicējiet to no sava personīgā kabinets pie my.aihummer.ru, tāpat kā jūs publicējat lietotni lietotņu veikalā. Jūs augšupielādējat būvējumu, aizpildāt veikala lapu un nosūtāt to pārskatīšanai; vispirms tiek veikta automatizēta AI pārbaude, pēc tam gala lēmumu pieņem cilvēka moderators, un pēc apstiprināšanas artefakts tiek parakstīts un publicēts kopienas katalogā.

Pilns soli pa solim ceļvedis ir pieejams Iesniegt spraudni. Īsumā:

  1. Veidot un iepakot jūsu spraudnis ar SDK (aihummer plugin package) — šis priekšmets ir parakstīts .tar.gz nēsājot savu manifest.json.
  2. Atver «Mani spraudņi» skapi un izveidot iesniegumu: augšupielādēt artefakts, aizpildiet glabāt metadatus (vārds un apraksti krievu + angļu, versija, ikona, ekrānuzņēmumi, kategorija, izvēles ziedošanas saite, izmaiņu žurnāls) un deklarēt spēju manifestācija.
  3. Nosūtīt pārskatīšanai. Automatizēts AI pārskats pārbauda iesniegumu attiecībā uz pārskata politika (drošība, manifests pareizība, pilnīgums, saturs), tad cilvēka moderators lasa ziņojumu un lemj. Automatizācija nekad nepulcē pati par sevi.
  4. Apstiprināšanā artefakts ir parakstīts un publicēts uz atsevišķs community-catalog.json uz CDN. Katra instance, kas ir pievienojusi kopienas avots redz spraudni; kodols tam uzticas caur piespraustā reģistra atslēga — nav nepieciešams neviens uzticības solis starp operatoriem.

[!NOTE] Vecā publiskās publicēšanas plūsma ir izbeigta; augstāk aprakstītā personīgā kabineta plūsma — “Mani spraudņi” — tagad ir vienīgais kopienas publicēšanas ceļš. Kopienas spraudņi ir bezmaksas; jūs varat pievienot izvēles ziedojumu saiti.

[!NOTE] Pirmās puses spraudņi (Einstains, SIP, Bitrix24, pocket-agent, os-client) ir nav publicēts šādā veidā — tos nosūta pa savu AiHummer CI kanālu un tie nonāk pievienotais oficiālais katalogs. Personīgā kabineta plūsma ir paredzēta kopiena (trešās puses) spraudņi.

Mērenība

Katrs kopienas iesniegums iziet cauri automātiska pārbaude (pilnīgums, spēju manifestācija, paraksts un drošības skenēšana), tad Mākslīgā intelekta riska pārskats, un beidzot a obligāta cilvēka pārbaude AiHummer komandas izstrādāts. Ne automatizācija, ne mākslīgais intelekts nekad neraksta publiski pats — lēmumu vienmēr pieņem moderators, un nekas nenonāk katalogā bez viņu apstiprinājuma. Publicētais spraudnis, kas vēlāk atklāts kā ļaunprātīgs vai bojāts, var tikt atsaukts un tika noņemts no kataloga nākamajā sinhronizācijā.

Kopienas katalogs kā papildu avots

Kopienas spraudņi tiek publicēti uz atsevišķs community-catalog.json tas dara ne pārrakstīt izvēlēto pirmās puses katalogu. Gadījums to pievieno kā papildu avotu Spraudņi → Avoti (vai POST /v1/admin/modules/catalog/sources). Skatīt Instalēšana un atjauninājumi un Pārskats un līmeņi.

Paplašinājuma dzīves cikls (App Store)

Tirgus darbojas kā īsts App Store — katram spraudnim ir identitāte (pastāvīgs slugs + autors), zem kura tas tiek nosūtīts versijas.

Versijas un atjauninājumi

Atjauninājums tiek izsūtīts kā jauna versija jau publicētam spraudnim: tas pats saīsinājums, savs izmaiņu žurnāls, savas atsauksmes un moderēšana. Tikai viens versija var būt pārskatē vienlaikus — jūs iesniedzat nākamo pēc tam, kad pašējā saņem lēmumu. Kad tiek publicēta jauna versija, iepriekšējā tiek atzīmēta superseded, un katalogs + katrs instances pārvietot uz jauno.

Ieplānotā publicēšana

Pēc tam, kad to apstiprina moderators, autors kontrolē izdošanu: publicēt tūlīt vai ieplānot noteiktam laikam — spraudnis tiek aktivizēts norādītajā brīdī.

Atcelšana no publicēšanas

  • Pauze — pagaidu slēpt spraudni: tas tiek noņemts no publiskā kataloga un no instancēm (nākamajā sinhronizācijā), bet tiek saglabāts un var būt pārlikts jebkurā laikā.
  • Noņemt no saraksta — pilnībā noņemt spraudni no tirgus vietas.

Tiklīdz spraudnis tiek atsaukts (pārtraukts vai noņemts no saraksta), tā ieraksts tiek noņemts no community-catalog.json, un gadījumi pārstāj to rādīt nākamajā sinhronizācijā.

Autortiesības

Spraudnis ir publicēts zem jūsu parādāmais vārds (piem., jūsu studijas nosaukums) — vai anonīmi. Publiskais katalogs un instances tīmekļa lietotāja interfeiss rāda izvēlēto vārdu vai “Anonīms”; jūsu patiesais e-pasts/ID nekad netiek atklāts.

Izstrādātāja statistika

Katram spraudnim ir kopsavilkuma statistika: lejupielādes, instalēšana, aktīvās instances un atinstalēšana, kā arī dienas diagramma. Tikai kopsavilkuma skaitļi — izstrādātājam netiek atklāta informācija par katru atsevišķo instanci.

Publicēšanas atlīdzība

Par katru spraudni, ko jūs publicējat pirmoreiz, jūsu AiHummer abonements saņem viens bezmaksas mēnesis (piešķirts katram spraudnim tikai vienu reizi).

Kur tālāk