Esitage plugin isikliku kabineti kaudu

See kogukonna turg lubab igal registreeritud kliendil avaldada pistikprogrammi, mida kõik saavad installida — samamoodi nagu avaldate rakenduse rakenduste poodi. Te täidate poe lehe metaandmed, deklareerite, milliseid õigusi teie pistikprogramm vajab, laadite üles koostamise ja saadate selle läbivaatamiseks. See leht juhendab kogu protsessi samm-sammult.

[!NOTE] See voo on mõeldud kogukond (kolmanda osapoole) pistikprogrammid, mis esitatakse teie kaudu isiklik kabinet juures my.aihummer.ru. Esimese osapoole AiHummeri pistikprogrammid tarnitakse omaenda torujuhtmel. Ühiskonna pistikprogrammid on tasuta; sina võib lisada vabatahtliku annetuslingi.

Enne kui alustad

A registreeritud isiklik kabineti konto — registreeru ja kinnita see (vaata Registreerimine). Ükskõik milline klient võib esitada.
A ehitatud plugin — allkirjastatud vabastustarja toodetud koos Plugina SDK (aihummer plugin package). Kui teil on veel ei ole ühtegi ehitanud, alusta sellest kõigepealt.
Üks ikoon ja vähemalt üks ekraanipilt, ja teie kirjeldused valmis mõlemad Vene ja inglise.

Kuidas avaldamine töötab (üldpilt)

Teie esitatud töö liigub läbi fikseeritud torujuhtme. Selle olekut saate jälgida kapis iga sammu juures.

Lav	Mis juhtub	Kes tegutseb
Mustand	Sa lood kirje ja täidad metaandmed; miski ei ole veel avalik.	Sina
Esitatud	Sa saadad selle ülevaatamiseks.	Sina
Tehisintellekti ülevaade	Automatiseeritud agent kontrollib pistikprogrammi võrreldes ülevaatamispoliitika — turvalisus, ilmsiku õigsus, täielikkus, sisu.	Automatiseerimine
Vahendamine	Inimese moderaator loeb AI aruannet koos sinu artefakti ja metadata ning teeb otsuse.	AiHummeri meeskond
Avaldatud	Kinnitamisel allkirjastatakse artefakt ja lisatakse kogukonna kataloogi ning avalikku turuvoogu.	AiHummeri meeskond
Tagasilükatud	Kui midagi ebaõnnestub, saad põhjused; paranda ja esita uuesti.	Sina → tagasi mustandisse

[!IMPORTANT] Tehisintellekt kunagi avaldab ise. Inimene teeb alati lõpliku otsuse, ja miski ei jõua kataloogi ilma nende heakskiiduta.

Samm 1 — Ava «Minu lisad»

Logi sisse my.aihummer.ru, ava «Minu pistikprogrammid» jaotis ja klõpsa «Avalda» (või «Uus pistikprogramm»). See tekitab mustand sa saad vabalt redigeerida kuni selle esitad.

Samm 2 — Täida poe metaandmed

Täida kõik väljad. Mitte täielik metainfo on üks kõige tavalisemaid põhjuseid, miks esitus tagasi lükkatakse.

Väli	Mida sisestada
Nimi (RU + EN)	Pistikprogrammi kuvatav nimi mõlemas keeles.
Lühike kirjeldus (RU + EN)	Üks rida kataloogi kaardile.
Täielik kirjeldus (RU + EN)	Mida pistikprogramm teeb, kuidas seda kasutada, mida see vajab. Sisukas — mitte kohatäide.
Kategooria	Valige lubatud komplektist üks (nt Kanalid, Tootlikkus, Integratsioonid, Hääl, Utiliidid).
Versioon	A semver string, nt `1.0.0`Iga uus esitlus peab seda suurendama.
Ikoon	Kehtiv ruudukujuline pilt.
Ekraanipildid	Vähemalt üks; näidates pluginat töös.
Litsents	Plugina litsents (nt MIT, Apache-2.0).
Avaleht / hoidla	Valikuline `https://` link teie projekti.
Annetuse link	Valikuline. Kehtiv `https://` link a-le kuulus annetuste võõrustaja — näiteks Boosty, Patreon, PayPal või YooMoney. Phishing või suvalised hostid lükatakse tagasi.
Muudatuste ajalugu (RU + EN)	Mis selles versioonis muutus.

[!TIP] Kirjuta kirjeldused tõelise kasutaja jaoks, kes pole sinu pistikprogrammi kunagi näinud. “Selleks” “dummies” on täiesti õige: ütle, mida see teeb, millal seda kasutada ja mida see vajab.

Samm 3 — Teata võimekuse manifestist

See võimekuse manifest on turvamudeli süda. See on lühike, struktureeritud deklaratsioon iga luba, mida teie plugin vajab — milliste hostidega see räägib, milliseid faile see puudutab, kas see käivitab väliseid käske, milliseid kanaleid ja volitusi see kasutab.

Miks seda deklareerida

Kliendid näevad nõutud õigusi enne kui nad paigaldavad ja nõusolek neile, täpselt nagu mobiilirakenduse loataotluse hüpik.
Eksemplar kasutab manifesti selleks, et piirama pluginile sellele, mida see kuulutas.
Arvustajad kontrollivad, et teie deklaratsioon võimalused matš mis kood tõesti teeb. Pistikprogramm, mis proovib saavutada õigust, mida ta ei ole deklareerinud, on tagasilükatud.

Vähemate õiguste printsiip

Deklaratsioon ainult mida teie plugin tegelikult kasutab, ja mitte midagi enamat. Vähem õigusi tähendab kiiremat ülevaatust, lihtsamat kliendi nõusolekut ja rohkem installimisi. Kui te ei puutu failisüsteemiga, deklareerige tühi nimekiri. Kui te kunagi ei käivita protsessi, seadke exec kuni false.

Vorming

Võimekuse manifest on JSON-objekt järgmiste väljadega:

Väli	Tüüp	Tähendus
`network`	string[]	Hostinimed, millega plugin ühendub (selle väljamineku lubade nimekiri).
`filesystem`	string[]	Teed, mida see loeb või kirjutab, oma pistikprogrammi kataloogi suhtes.
`exec`	buleean	Kas see käivitab väliseid protsesse / täidab käske.
`channels`	string[]	Sõnumside kanalid, millega see integreerub (nt `telegram`).
`credentials`	string[]	Nimetatud saladused/konfiguratsiooni võtmed, mida see kasutab (kunagi mitte saladuste väärtusi).
`description`	string	Lühike, inimesele loetav kokkuvõte sellest, mida see vajab ja miks.

Näide:

{
  "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] Tee ei ärge pange tõelisi saladusi, märke ega võtmeid kuhugi — mitte manifesti, mitte metaandmetes, mitte artefaktis. Deklareeri mandaadid ainult nime poolest (nt. api_token); klient esitab tegeliku väärtuse paigaldamise ajal. Koodis fikseeritud saladused on automaatne tagasilükkamine.

Samm 4 — Laadi artefakt üles

Laadige üles oma pistikprogrammi versioon:

Vorming: a .tar.gz väljalaske tarballi tootnud aihummer plugin package.
See peab sisaldama pistikprogrammi manifest.json (SDK manifest — tüüp, versioon, sisenemispunkt, deklareeritud capabilities, konfiguratsiooni väljad).
Võimekuse manifest, mille täitsite 3. sammus, peab olema järjepidev millisega kood ja manifest.json tõesti teha

Sa lisad ka ikoon ja ekraanipildid siin, kui te pole seda juba teinud.

[!TIP] Jookse aihummer plugin validate kohapeal enne üleslaadimist. Kinnitamise leping on sama, mida turuplatvorm kasutab, nii et manifest, mis kohalikult läbi läheb, on ka siin aktsepteeritud.

Samm 5 — Saada ülevaatamiseks

Kui kõik väljad on täidetud ja artefakt on üles laaditud, klõpsake «Esita ülevaatamiseks». Kapitul teeb kõigepealt täielikkuse kontrolli; kui midagi puudub, ütleb see täpselt, mis. Kui see on aktsepteeritud, liigub staatus järgmisele tasemele Esitatud ja siis Tehisintellekti ülevaade — sul ei ole vaja midagi muud teha.

Samm 6 — Jälgi staatust ja loe otsust

Ava pistikprogramm «Minu pistikprogrammid» jälgida selle staatust. Kui ülevaatus on lõppenud, näete üht järgmistest:

Mõõdukalt — automatiseeritud ülevaatus läbis või märkis ainult väikseid asju; a Inimene vaatab seda praegu. Lihtsalt oota.
Tagasilükatud — midagi ebaõnnestus. Sa näed otsus, kokkuvõte ja konkreetsed esemed, mis ei läbinud (iga põhjusega). See on sinu paranduste nimekiri.
Avaldatud — heaks kiidetud, allkirjastatud ja aktiivne. Teie plugin kuvatakse nüüd AiHummeri turg ja installib end igasse eksemplari, mis kas kogukonna kataloog on lubatud.

Kuidas lugeda tagasilükkamist ja uuesti esitada

Ava pistikprogramm; loe ebaõnnestunud üksused ja nende põhjused.
Paranda need — enamik on üks järgmistest: puuduv/nõrk kirjeldus, sobimatu võimekus manifest, kõvakoodiga saladus, halb annetuse link või versioon, mida sa ei teinud kasv
Muuda metaandmeid ja/või laadi üles uus artefakt suurendatud versiooniga.
Klõps «Esita ülevaatamiseks» taas. See läheb tagasi sama torujuhtme kaudu.

[!NOTE] Tagasilükkamine ei ole karistus — see on kontroll-loend. ülevaatamispoliitika on avalik just selleks, et sa saab täita kõik nõuded enne sa allud.

Kuhu edasi

Ülevaate poliitika ja kontrollnimekiri — täpselt kriteeriumid, mille alusel teie pistikprogramm kontrollitakse.
Plugina SDK — ehita plugin ja selle manifest.json.
Plugina avaldamine — privaatne külglaadimine ja teised avaldamise režiimid.
Paigalda ja uuendused — kuidas kliendid installi ja kuidas usaldusmudel töötab.