Iesniegt spraudni caur personīgo kabinetu

Tas kopienas tirgus ļauj jebkuram reģistrētam klientam publicēt spraudni, ko ikviens var instalēt — tāpat kā jūs publicējat lietotni lietotņu veikalā. Jūs aizpildāt veikala lapas metadatus, deklarējat, kādas atļaujas jūsu spraudnim nepieciešamas, augšupielādējat jauno versiju un nosūtāt to pārskatīšanai. Šī lapa soli pa solim iziet cauri visam procesam.

[!NOTE] Šis plūsma ir priekš kopiena (trešās puses) spraudņi iesniegti caur jūsu personīgā kabinets pie my.aihummer.ru. Pirmās puses AiHummer spraudņi tiek piegādāti ar savu pašu datu apstrādes plūsmu. Kopienas spraudņi ir bezmaksas; jūs var pievienot izvēles ziedojumu saiti.

Pirms sākat

A reģistrēts personīgās kabineta konts — reģistrējieties un apstipriniet to (skatīt Reģistrācija). Jebkurš klients var iesniegt.
A izveidots spraudnis — parakstīta izlaišanas tarbolla izveidota ar Spraudņa SDK (aihummer plugin package). Ja jums ir vēl nav uzbūvēts neviens, sāc tur vispirms.
Neviens ikona un vismaz viens ekrānuzņēmums, un jūsu apraksti gatavi abi Krievu un angļu.

Kā darbojas publikācija (lielais attēls)

Jūsu iesniegums pārvietojas caur fiksētu plūsmu. Jūs varat katrā posmā uzraudzīt tā statusu kabinetā.

Skatuve	Kas notiek	Kas rīkojas
Meliorējums	Jūs izveidojat ierakstu un aizpildāt metadatus; vēl nekas nav publisks.	Tu
Iesniegts	Jūs to nosūtāt pārskatīšanai.	Tu
AI pārskats	Automatizēts aģents pārbauda spraudni pret pārskata politika — drošība, pareizības atklājums, pilnīgums, saturs.	Automatizācija
Mērenība	Cilvēka moderators izskata mākslīgā intelekta ziņojumu, jūsu artefaktu un metadatus un pieņem lēmumu.	AiHummer komanda
Publicēts	Pēc apstiprināšanas artefakts tiek parakstīts un pievienots kopienas katalogam + publiskā tirgus plūsmai.	AiHummer komanda
Noraidīts	Ja kaut kas neizdodas, jūs saņemat iemeslus; labojiet un iesniedziet atkārtoti.	Jūs → atpakaļ uz Melnrakstu

[!IMPORTANT] Mākslīgais intelekts nekad publisko pats. Cilvēks vienmēr pieņem galīgo lēmumu, un nekas netiek iekļauts katalogā bez viņu apstiprinājuma.

1. solis — Atveriet «Mani spraudņi»

Pierakstīties my.aihummer.ru, atveriet «Mani spraudņi» sadaļa, un noklikšķiniet «Publicēt» (vai «Jauns spraudnis»). Tas rada melnraksts jūs varat brīvi rediģēt, līdz to iesniedzat.

2. solis — Aizpildiet veikala metadatus

Aizpildiet katru lauku. Nepilnīga metadatu informācija ir viens no visbiežākajiem iemesliem, kāpēc iesniegums tiek noraidīts.

Lauks	Ko ievadīt
Vārds (RU + EN)	Paplašinājuma displeja nosaukums abās valodās.
Īss apraksts (RU + EN)	Viena rinda katalogu kartītei.
Pilns apraksts (KR + EN)	Ko spraudnis dara, kā to lietot, kas tam nepieciešams. Jēgpilns — nevis viettura teksts.
Kategorija	Izvēlieties vienu no atļautā komplekta (piemēram, Kanāli, Produktivitāte, Integrācijas, Balss, Palīgprogrammas).
Versija	A semver virkne, piem. `1.0.0`. Katrs jauns iesniegums to jāpalielina.
Ikona	Derīgs kvadrāta attēls.
Ekrānuzņēmumi	Vismaz viens; rādot spraudni darbībā.
Licence	Spraudņa licence (piem., MIT, Apache-2.0).
Sākumlapa / krātuve	Neobligāts `https://` saite uz jūsu projektu.
Ziedojumu saite	Pēc izvēles. Derīgs `https://` saite uz a zināms ziedojumu saimnieks — piemēram, Boosty, Patreon, PayPal vai YooMoney. Pikšķerēšana vai patvaļīgi saimnieki tiek noraidīti.
Izmaiņu žurnāls (RU + EN)	Kas šajā versijā ir mainījies.

[!TIP] Uzraksti aprakstus īstam lietotājam, kurš nekad nav redzējis tavu spraudni. “dumji” ir tieši tas, kas nepieciešams: pasakiet, ko tas dara, kad to izmantot un kas tam nepieciešams.

3. solis — Deklarēt iespēju manifestu

Tas spēju manifestācija ir drošības modeļa kodols. Tā ir īsa, strukturēta deklarācija par katra atļauja, kas nepieciešama jūsu spraudnim — ar kuriem serveriem tas sazinās, kuras datnes tas pieskaras, vai tas izpilda ārējas komandas, kurus kanālus un akreditācijas datus tas izmanto.

Kāpēc to deklarēt

Klienti redz pieprasītās atļaujas pirms viņi uzstāda un piekrist viņiem, tieši kā mobilās lietotnes atļauju uzvedne.
Instances izmanto manifestu, lai ierobežot spraudnis tam, ko tas deklarēja.
Pārskatītāji pārbauda, vai jūsu deklarēts spējas spēle kas ir kods patiesībā dara. Spraudnis, kas pieprasa atļauju, ko tas nav deklarējis, ir noraidīts.

Minimālo privilēģiju princips

Deklarēt tikai ko jūsu spraudnis patiesi izmanto, un ne vairāk. Mazākas atļaujas nozīmē ātrāku pārskatīšanu, vieglāku klienta piekrišanu un vairāk instalāciju. Ja jūs nepieskaraties failu sistēmai, norādiet tukšu sarakstu. Ja jūs nekad neizveidojat procesu, iestatiet exec uz false.

Formāts

Iespēju manifests ir JSON objekts ar šādām laukiem:

Lauks	Veids	Nozīme
`network`	virkne[]	Resursdatori, pie kuriem spraudnis pieslēdzas (tā izejošās piekļuves atļauto saraksts).
`filesystem`	virkne[]	Ceļi, kurus tas lasa vai raksta, attiecībā pret tā paša spraudņa direktoriju.
`exec`	boolēans	Vai tas palaidīs ārējās procesus / izpildīs komandas.
`channels`	virkne[]	Ziņojumapmaiņas kanāli, ar kuriem tas integrējas (piemēram, `telegram`).
`credentials`	virkne[]	Nosauktās slepenās/config atslēgas, kuras tas lieto (nekad slepenās vērtības).
`description`	virkne	Īss, cilvēkam saprotams kopsavilkums par to, kas tam nepieciešams un kāpēc.

Piemērs:

{
  "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] Darīt ne neliec īstas noslēpumus, žetonus vai atslēgas nekur — ne manifestā, ne metadatos, ne artefaktā. Deklarēt akreditācijas datus tikai pēc vārda (piemēram api_token); klients nodrošina faktisko vērtību uzstādīšanas laikā. Iekodēts noslēpumi ir automātiska noraidīšana.

4. solis — Augšupielādēt artefaktu

Augšupielādējiet sava spraudņa versiju:

Formāts: a .tar.gz izlaišanas tarballs, ko izveidoja aihummer plugin package.
Tam jāietver spraudņa manifest.json (SDK manifest — veids, versija, ieejas punkts, deklarēts capabilities, konfigurācijas lauki).
Iespēju manifests, ko aizpildījāt 3. solī, ir jābūt konsekvents ar ko kods un manifest.json patiesībā darīt

Jūs arī pievienojat ikona un ekrānuzņēmumi šeit, ja jūs vēl neesat to izdarījis.

[!TIP] Skriet aihummer plugin validate lokāli pirms augšupielādes. Validācijas līgums ir tas pats, ko izmanto tirgus laukums, tāpēc manifests, kas vietēji tiek apstiprināts, būs šeit arī pieņemts.

5. solis — Nosūtīt pārskatīšanai

Kad visi lauki ir aizpildīti un artefakts ir augšupielādēts, noklikšķiniet „Iesniegt pārskatīšanai“. Skapis vispirms veic pilnības pārbaudi; ja kaut kas trūkst, tas tieši pateiks, kas. Kad tas tiek pieņemts, statuss pāriet uz Iesniegts un tad AI pārskats — jums nav jāveic nekas cits.

6. solis — Sekot statusam un izlasīt spriedumu

Atveriet spraudni «Mani spraudņi» sekot tā statusam. Kad pārskats būs pabeigts, jūs redzēsiet vienu no:

Ar mēru — automatizētā pārbaude izturēta vai tikai atzīmētas nelielas lietas; a cilvēks to tagad skatās. Tikai pagaidi.
Noraidīts — kaut kas neizdevās. Jūs redzēsiet spriedums, kopsavilkums un tas konkrēti priekšmeti, kas nav izturējuši (ar iemeslu katram). Tas ir jūsu labojumu saraksts.
Publicēts — apstiprināts, parakstīts un aktīvs. Jūsu spraudnis tagad parādās uz AiHummer tirgus laukums un instalējas jebkurā instancē, kas ir ieslēgts kopienas katalogs.

Kā izlasīt atteikumu un iesniegt atkārtoti

Atveriet spraudni; lasiet neizdevušās preces un viņu iemesli.
Salabojiet tos — lielākā daļa ir viena no: trūkstošs/vājš apraksts, neatbilstoša spēja manifestācija, iepriekš kodēta slepenā informācija, slikta ziedošanas saite vai versija, kuru jūs neizdarījāt pieaugums.
Rediģējiet metadatus un/vai augšupielādējiet jauns artefakts ar palielinātu versiju.
Klikšķis „Iesniegt pārskatīšanai“ atkal. Tas atgriežas caur to pašu cauruļvadu.

[!NOTE] Noraidīšana nav sods — tā ir kontrolsaraksts. pārskata politika ir publisks tieši tāpēc, lai jūs var izpildīt katru prasību pirms tu iesniedz.

Kur tālāk

Pārskatīt politiku un kontrolsarakstu — precīzs kritēriji, pēc kuriem tiek pārbaudīts jūsu spraudnis.
Spraudņa SDK — izveidot spraudni un tā manifest.json.
Spraudņa publicēšana — privātā sānu ielāde un citi publicēšanas režīmi.
Instalēšana un atjauninājumi — kā klienti instalēt un kā darbojas uzticības modelis.