Pateikti įskiepį per asmeninę paskyrą

Tas bendruomenės turgavietė leidžia bet kuriam užsiregistravusiam klientui paskelbti papildinį, kurį visi gali įdiegti — taip pat, kaip jūs paskelbiate programėlę programėlių parduotuvėje. Užpildote parduotuvės puslapio metaduomenis, nurodote, kokių leidimų reikia jūsų papildiniui, įkeliate versiją ir siunčiate ją peržiūrai. Šiame puslapyje viskas yra paaiškinta žingsnis po žingsnio.

[!NOTE] Šis srautas skirtas bendruomenė (trečiosios šalies) įskiepius pateikė per jūsų asmeninė kabina prie my.aihummer.ru. Pirmosios šalies AiHummer papildiniai yra pristatomi savo pačių tiekimo grandine. Bendruomenės papildiniai yra nemokamas; jūs gali pridėti pasirenkamą aukojimo nuorodą.

Prieš pradėdami

A užregistruota asmeninė paskyra — užsiregistruokite ir patvirtinkite tai (žr.) Registracija). Bet kuris klientas gali pateikti.
A sukurta įskiepis — pasirašytas išleidimo archyvas, sukurtas su Įskiepio SDK (aihummer plugin package). Jei turite dar nieko nesukurtas, pradėk nuo to.
Vienas piktograma ir bent vienas ekrano vaizdas, ir jūsų aprašymai paruošti abu Rusų ir anglų.

Kaip veikia leidyba (bendras vaizdas)

Jūsų pateikimas juda fiksuotu kanalu. Galite stebėti jo būseną kabinete kiekviename žingsnyje.

Scena	Kas vyksta	Kas vaidina
Juodraštis	Jūs sukuriate įrašą ir užpildote metaduomenis; niekas dar nėra vieša.	Tu
Pateikta	Jūs siunčiate tai peržiūrai.	Tu
DI peržiūra	Automatinis agentas tikrina įskiepį pagal peržiūrėti politiką — saugumas, aiškumo teisingumas, išsamumas, turinys.	Automatizavimas
Tarpininkavimas	Žmogiškasis moderatorius perskaito dirbtinio intelekto ataskaitą, jūsų artefaktą ir metaduomenis bei priima sprendimą.	AiHummer komanda
Išleista	Patvirtinus, artefaktas pasirašomas ir pridedamas prie bendruomenės katalogo bei viešosios prekyvietės srauto.	AiHummer komanda
Atmesta	Jei kažkas nepasiseka, gausite priežastis; pataisykite ir pateikite iš naujo.	Jūs → atgal į juodraštį

[!IMPORTANT] DI niekada publikuoja savarankiškai. Galutinį sprendimą visada priima žmogus, ir niekas nepatenka į katalogą be jų patvirtinimo.

1 veiksmas — Atidarykite „Mano papildiniai“

Prisijungti prie my.aihummer.ru, atidarykite «Mano įskiepiai» skirsnis, ir spustelėkite «Paskelbti» (arba «Naujas įskiepis»). Tai sukuria juodraštis galite redaguoti laisvai, kol ją pateiksite.

2 žingsnis — Užpildykite parduotuvės metaduomenis

Užpildykite kiekvieną lauką. Nepilna metaduomenų informacija yra viena dažniausių priežasčių, dėl kurios pateikimas grąžinamas.

Laukas	Ką įvesti
Vardas (RU + EN)	Įskiepio rodomas pavadinimas abiem kalbomis.
Trumpas aprašymas (RU + EN)	Viena eilutė katalogo kortelei.
Pilnas aprašymas (RU + EN)	Ką daro įskiepis, kaip jį naudoti, ko jam reikia. Reikšminga — ne laikina vieta.
Kategorija	Pasirinkite vieną iš leidžiamo rinkinio (pvz., Kanalai, Produktyvumas, Integracijos, Balsas, Komunalinės paslaugos).
Versija	A semver eilutė, pvz. `1.0.0`. Kiekvienas naujas pateikimas turi jį padidinti.
Piktograma	Galiojantis kvadratinis vaizdas.
Ekrano nuotraukos	Bent vienas; rodant papildinį veikiant.
Licencija	Priedo licencija (pvz., MIT, Apache-2.0).
Pagrindinis puslapis / saugykla	Neprivaloma `https://` nuoroda į jūsų projektą.
Aukojimo nuoroda	Pasirenkama. Galiojanti `https://` nuoroda į a gerai žinomas aukojimų šeimininkas — pavyzdžiui, Boosty, Patreon, PayPal arba YooMoney. Phishingas ar atsitiktiniai talpyklos paslaugų teikėjai atmetami.
Pakeitimų žurnalas (RU + EN)	Kas pasikeitė šiame leidime.

[!TIP] Parašykite aprašymus tikram vartotojui, kuris niekada nematė jūsų įskiepio. “Dummies” yra visiškai teisinga: pasakyk, ką tai daro, kada tai naudoti ir ko tai reikia.

3 žingsnis — Paskelbkite galimybių manifestą

Tas galimybių manifestas yra saugumo modelio šerdis. Tai trumpa, struktūruota deklaracija apie visos leidimai, kurių reikia jūsų papildiniui — su kuriais serveriais jis bendrauja, su kokiais failais jis dirba, ar jis vykdo išorines komandas, kokias kanalus ir kredencialus naudoja.

Kodėl tai deklaruoti

Klientai mato prašomas teises prieš jie įdiegia ir sutikti su jų, kaip mobiliosios programėlės leidimų raginimą.
Atvejis naudoja manifestą, kad apriboti papildinys tam, ką jis deklaravo.
Recenzentai tikrina, kad jūsų pareiškė galimybės atitikti kas kodas iš tikrųjų daro. Įskiepis, kuris siekia leidimo, kurio jis nepareiškė, yra atmesta.

Mažiausios privilegijos principas

Deklaruoti tik ką jūsų papildinys iš tikrųjų naudoja, ir nieko daugiau. Mažiau leidimų reiškia greitesnį peržiūrą, lengvesnį kliento sutikimą ir daugiau įdiegimų. Jei nenaudojate failų sistemos, nurodykite tuščią sąrašą. Jei niekada nepaleidžiate proceso, nustatykite exec į false.

Formatas

Pajėgumų manifestas yra JSON objektas su šiais laukais:

Laukas	Tipas	Reikšmė
`network`	eilutė[]	Vietovardžiai, prie kurių prijungiamas papildinys (jo išeigos leistinų sąrašas).
`filesystem`	eilutė[]	Kelių, kuriuos jis skaito arba rašo, santykinai savo paties papildinio katalogui.
`exec`	loginis	Ar tai sukuria išorinius procesus / vykdo komandas.
`channels`	eilutė[]	Pranešimų kanalai, su kuriais jis integruojamas (pvz. `telegram`).
`credentials`	eilutė[]	Vardytos slaptos/konfigūracijos raktai, kuriuos jis naudoja (niekada slaptų reikšmių).
`description`	eilutė	Trumpa, žmogui suprantama santrauka apie tai, ko tai reikia ir kodėl.

Pavyzdys:

{
  "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] Daryti ne neįdėkite tikrų paslapčių, žetonų ar raktų niekur — ne į manifestą, ne metaduomenyse, ne artefakte. Nurodykite kredencialus tik vardu (pvz.) api_token); klientas pateikia tikrąją vertę įdiegimo metu. Užkoduota slapti dalykai yra automatinis atmetimas.

4 žingsnis — Įkelti artefaktą

Įkelkite savo įskiepio versiją:

Formatas: a .tar.gz išleidimo archyvas sukurtas aihummer plugin package.
Jame turi būti įskiepio manifest.json (SDK manifestas — tipas, versija, įėjimo taškas, deklaruotas capabilities, konfigūracijos laukus).
Gebėjimų manifestas, kurį užpildėte 3 žingsnyje, turi būti nuoseklus su kuo kodas ir manifest.json iš tikrųjų daro

Jūs taip pat pridedate piktograma ir ekranvaizdžiai čia, jei dar to nepadarei.

[!TIP] Bėgti aihummer plugin validate vietoje prieš įkeliant. Patvirtinimo sutartis tai tas pats, kurį naudoja turgavietė, todėl manifestas, kuris praėjo vietoje, bus priimama čia taip pat.

5 žingsnis — Siųsti peržiūrai

Kai kiekvienas laukas yra užpildytas ir artefaktas įkeltas, spustelėkite „Pateikti peržiūrai“. Kabinetas pirmiausia atlieka pilnumo patikrinimą; jei kažko trūksta, jis tiksliai nurodo, ko. Kai priimama, būsena pasikeičia į Pateikta o tada DI peržiūra — jums nieko daugiau daryti nereikia.

6 žingsnis — Stebėkite būseną ir perskaitykite nuosprendį

Atidaryti įskiepį «Mano įskiepiai» kad galėtumėte stebėti jo būseną. Kai peržiūra bus baigta, pamatysite vieną iš:

Saikingai — automatizuotas peržiūros testas praeitas arba pažymėtos tik smulkios problemos; a Žmogus dabar tai žiūri. Tiesiog palauk.
Atmesta — kažkas nepavyko. Jūs pamatysite nuosprendis, santrauka ir konkretūs daiktai, kurie nepraėjo (su priežastimi kiekvienam). Tai yra jūsų pataisymų sąrašas.
Išleista — patvirtinta, pasirašyta ir veikianti. Jūsų papildinys dabar pasirodo AiHummer turgus ir įdiegia į bet kurią egzempliorių, kuris yra įgalintas bendruomenės katalogas.

Kaip perskaityti atmetimą ir pateikti iš naujo

Atidarykite įskiepį; skaitykite nesėkmingi daiktai ir jų priežastys.
Pataisykite juos – dauguma yra viena iš: trūkstamas/silpnas aprašymas, neatitinkanti galimybė manifestas, įkoduota paslaptis, bloga aukojimo nuoroda arba versija, kurios neturėjote padidėjimas.
Redaguokite metaduomenis ir/arba įkelkite naujas artefaktas su padidinta versija.
Spustelėti „Pateikti peržiūrai“ vėl. Jis grįžta per tą pačią tiekimo grandinę.

[!NOTE] Atmetimas nėra bausmė — tai kontrolinis sąrašas. peržiūrėti politiką yra vieša būtent todėl, kad jūs gali atitikti kiekvieną reikalavimą prieš tu paklūsti.

Kur toliau

Peržiūros politika ir kontrolinis sąrašas — tikslus kriterijai, pagal kuriuos tikrinamas jūsų įskiepis.
Įskiepio SDK — sukurkite įskiepį ir jo manifest.json.
Įskiepio publikavimas — privatus šalutinis įkėlimas ir kiti leidybos režimai.
Įdiegimas ir atnaujinimai — kaip klientai įdiegti ir kaip veikia pasitikėjimo modelis.