Փլագինի հրապարակումն անձնական կաբինետի միջոցով

{
  "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."
}

**Community-մարկետփլեյսը** թույլ է տալիս ցանկացած գրանցված օգտատիրոջ հրապարակել իր փլագինը, որպեսզի բոլորը կարողանան այն տեղադրել, — ճիշտ այնպես, ինչպես դուք հավելված եք հրապարակում App Store-ում: Դուք լրացնում եք քարտի մետատվյալները, հայտարարում, թե ինչ իրավունքներ են պետք փլագինին, վերբեռնում կառուցվածքը (build) և ուղարկում ստուգման: Այս էջը քայլ առ քայլ ձեզ կուղեկցի ողջ գործընթացով: > [!NOTE] > Այս հոսքը նախատեսված է **community (երրորդ կողմի)** փլագինների համար, որոնք > ուղարկվում են ձեր [անձնական կաբինետի](/hy/v1.0/portal/overview) միջոցով > **my.aihummer.ru**-ում: AiHummer-ի սեփական փլագիններն ունեն իրենց առանձին > հոսքագիծը: Community-փլագինները **անվճար են**. կարող եք ավելացնել > ոչ պարտադիր դոնաթի հղում: ## Նախքան սկսելը 1. **Գրանցված անձնական կաբինետի հաշիվ** — գրանցվեք և հաստատեք այն (տես [Գրանցում](/hy/v1.0/portal/registration)): Փլագին կարող է ուղարկել ցանկացած օգտատեր: 2. **Կառուցված փլագին** — ստորագրված ռելիզային tarball, որը հավաքվել է [Plugin SDK](/hy/v1.0/marketplace/sdk)-ի օգնությամբ (`aihummer plugin package`): Եթե դեռ չեք հավաքել այն, սկսեք այնտեղից: 3. **Պատկերակ (icon) և առնվազն մեկ սքրինշոթ**, ինչպես նաև պատրաստի նկարագրություններ **և՛ ռուսերեն, և՛ անգլերեն**: ## Ինչպես է աշխատում հրապարակումը (ընդհանուր պատկերը) Ձեր հայտն անցնում է ֆիքսված հոսքագծով: Ամեն քայլում կաբինետում տեսնում եք դրա կարգավիճակը: | Փուլ | Ինչ է կատարվում | Ով է գործում | |---|---|---| | **Սևագիր** | Դուք ստեղծում եք գրառումը և լրացնում մետատվյալները. առայժմ ոչինչ հրապարակային չէ: | Դուք | | **Ուղարկված** | Դուք ուղարկում եք այն ստուգման: | Դուք | | **AI-ստուգում** | Ավտոմատ գործակալը ստուգում է փլագինն ըստ [ստուգման քաղաքականության](/hy/v1.0/marketplace/review-policy)՝ անվտանգություն, մանիֆեստի ճշտություն, ամբողջականություն, բովանդակություն: | Ավտոմատիկա | | **Մոդերացիա** | Մարդ-մոդերատորը կարդում է AI-ի հաշվետվությունը, ինչպես նաև ձեր արտեֆակտն ու մետատվյալները, և որոշում է կայացնում: | AiHummer-ի թիմ | | **Հրապարակված** | Հաստատումից հետո արտեֆակտը ստորագրվում է և ավելացվում community-կատալոգ ու հրապարակային ցուցափեղկ: | AiHummer-ի թիմ | | **Մերժված** | Եթե ինչ-որ բան չի անցնում, դուք ստանում եք պատճառները. ուղղում եք և կրկին ուղարկում: | Դուք → նորից սևագիր | > [!IMPORTANT] > AI-ն **երբեք** ինքնուրույն չի հրապարակում: Վերջնական որոշումը միշտ կայացնում է > մարդ, և ոչինչ չի հասնում կատալոգ առանց նրա հաստատման: ## Քայլ 1 — Բացեք «Իմ փլագինները» Մուտք գործեք **my.aihummer.ru**, բացեք **«Իմ փլագինները»** բաժինը և սեղմեք **«Հրապարակել»** (կամ **«Նոր փլագին»**): Այսպես ստեղծվում է **սևագիր**, որը կարող եք ազատ խմբագրել, մինչև այն ուղարկեք ստուգման: ## Քայլ 2 — Լրացրեք քարտի մետատվյալները Լրացրեք բոլոր դաշտերը: Ոչ լրիվ մետատվյալները այն ամենահաճախ հանդիպող պատճառներից են, որոնց համար հայտը վերադարձվում է լրամշակման: | Դաշտ | Ինչ նշել | |---|---| | **Անվանում (RU + EN)** | Փլագինի ցուցադրվող անունը երկու լեզվով: | | **Կարճ նկարագրություն (RU + EN)** | Մեկ տող՝ կատալոգի քարտի համար: | | **Ամբողջական նկարագրություն (RU + EN)** | Ինչ է անում փլագինը, ինչպես օգտվել դրանից, ինչ է պետք դրան: Իմաստալից — ոչ թե խցան (placeholder): | | **Կատեգորիա** | Ընտրեք թույլատրված հավաքածուից մեկը (օրինակ՝ Ալիքներ, Արտադրողականություն, Ինտեգրումներ, Ձայն, Կոմունալ գործիքներ): | | **Տարբերակ** | [semver](https://semver.org) ֆորմատի տող, օրինակ՝ `1.0.0`: Ամեն նոր հայտ պետք է այն մեծացնի: | | **Պատկերակ** | Վավեր քառակուսի պատկեր: | | **Սքրինշոթներ** | Առնվազն մեկը՝ ցույց տալով փլագինը գործողության մեջ: | | **Լիցենզիա** | Փլագինի լիցենզիան (օրինակ՝ MIT, Apache-2.0): | | **Կայք / պահոց** | Ոչ պարտադիր `https://` հղում ձեր նախագծի վրա: | | **Դոնաթի հղում** | Ոչ պարտադիր: Վավեր `https://` հղում **հայտնի դոնաթ-հոսթի** վրա — օրինակ Boosty, Patreon, PayPal կամ YooMoney: Ֆիշինգը և կամայական հոսթերը մերժվում են: | | **Changelog (RU + EN)** | Ինչ է փոխվել այս տարբերակում: | > [!TIP] > Գրեք նկարագրությունները իրական օգտատիրոջ համար, ով երբեք չի տեսել ձեր փլագինը: > «Սկսնակների համար» ձևակերպումը հենց այն է, ինչ պետք է. ասեք, թե ինչ է անում այն, > երբ այն կիրառել, և ինչ է դրան պետք: ## Քայլ 3 — Հայտարարեք capability-մանիֆեստը **Capability-մանիֆեստը** անվտանգության մոդելի սիրտն է: Դա ձեր փլագինին **անհրաժեշտ բոլոր իրավունքների** կարճ, կառուցվածքային հայտարարությունն է՝ ինչ հոսթերի հետ է այն շփվում, ինչ ֆայլերի է դիպչում, արտաքին հրամաններ գործարկո՞ւմ է, ինչ ալիքներ ու հասանելիություններ է օգտագործում: ### Ինչու հայտարարել այն - Օգտատերերը տեսնում են պահանջվող իրավունքները **տեղադրելուց առաջ** և համաձայնում դրանց, ինչպես բջջային հավելվածի թույլտվության հարցումը: - Ինստանսն օգտագործում է մանիֆեստը՝ փլագինը **սահմանափակելու** այն ամենով, ինչ նա հայտարարել է: - Ստուգողները ստուգում են, որ ձեր **հայտարարած** իրավունքները **համընկնեն** այն բանի հետ, ինչ իրականում անում է կոդը: Փլագինը, որ ձգում է չհայտարարված իրավունքի, մերժվում է: ### Նվազագույն իրավունքների սկզբունքը Հայտարարեք **միայն** այն, ինչ իրապես օգտագործում է ձեր փլագինը, և ոչ ավելին: Ավելի քիչ իրավունքներ նշանակում է ավելի արագ ստուգում, ավելի հեշտ օգտատիրական համաձայնություն և ավելի շատ տեղադրումներ: Եթե չեք դիպչում ֆայլային համակարգին՝ նշեք դատարկ ցուցակ: Եթե երբեք չեք գործարկում պրոցեսներ՝ դրեք `exec`-ը `false`: ### Ֆորմատը Capability-մանիֆեստը JSON-օբյեկտ է հետևյալ դաշտերով: | Դաշտ | Տիպ | Իմաստ | |---|---|---| | `network` | string[] | Հոսթերը, որոնց միանում է փլագինը (նրա ելքային հարցումների allowlist-ը): | | `filesystem` | string[] | Ուղիներ, որոնք այն կարդում կամ գրում է՝ իր փլագինի դիրեկտորիայի նկատմամբ: | | `exec` | boolean | Գործարկո՞ւմ է արդյոք արտաքին պրոցեսներ / հրամաններ: | | `channels` | string[] | Հաղորդագրման ալիքներ, որոնց հետ ինտեգրվում է (օրինակ՝ `telegram`): | | `credentials` | string[] | Անվանված գաղտնիքներ/կոնֆիգուրացիայի բանալիներ, որ այն օգտագործում է (երբեք ոչ գաղտնիքների արժեքները): | | `description` | string | Կարճ, մարդընթեռնելի ամփոփում այն մասին, ինչ և ինչու է դրան պետք: | Օրինակ. ```json { "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] > **Մի՛** դրեք իրական գաղտնիքներ, թոքեններ կամ բանալիներ ոչ մի տեղ — ոչ մանիֆեստում, > ոչ մետատվյալներում, ոչ արտեֆակտում: Հայտարարեք հասանելիությունները **միայն > անունով** (օրինակ՝ `api_token`). իրական արժեքն օգտատերը մուտքագրում է տեղադրման > պահին: Կոշտ կոդավորված (hardcoded) գաղտնիքները ավտոմատ մերժում են: ## Քայլ 4 — Վերբեռնեք արտեֆակտը Վերբեռնեք փլագինի կառուցվածքը. - **Ֆորմատ.** `.tar.gz` ռելիզային tarball, որը հավաքվել է [`aihummer plugin package`](/hy/v1.0/marketplace/sdk#the-cli)-ով: - Այն պետք է պարունակի փլագինի **`manifest.json`**-ը (SDK-մանիֆեստ — տիպ, տարբերակ, մուտքի կետ, հայտարարած `capabilities`, կոնֆիգուրացիայի դաշտեր): - Քայլ 3-ում ձեր լրացրած capability-մանիֆեստը պետք է **համաձայնեցված** լինի այն բանի հետ, ինչ իրականում անում են կոդն ու `manifest.json`-ը: Պատկերակն ու սքրինշոթներն այստեղ էլ եք կցում, եթե դեռ չեք արել դա: > [!TIP] > Վերբեռնելուց առաջ տեղում գործարկեք `aihummer plugin validate`: Դա նույն > վավերացման կոնտրակտն է, որն օգտագործում է մարկետփլեյսը, ուստի տեղում անցած > մանիֆեստը կընդունվի նաև այստեղ: ## Քայլ 5 — Ուղարկեք ստուգման Երբ բոլոր դաշտերը լրացված են և արտեֆակտը վերբեռնված է, սեղմեք **«Ուղարկել ստուգման»**: Կաբինետը նախ ստուգում է ամբողջականությունը. եթե ինչ-որ բան պակասում է՝ այն ճշգրիտ կասի, թե ինչ: Ընդունումից հետո կարգավիճակը փոխվում է **Ուղարկված**-ի, այնուհետև՝ **AI-ստուգում**-ի — ուրիշ ոչինչ անել պետք չէ: ## Քայլ 6 — Հետևեք կարգավիճակին և կարդացեք վճիռը Բացեք փլագինը **«Իմ փլագիններ»**-ում՝ կարգավիճակին հետևելու համար: Ստուգման ավարտին կտեսնեք տարբերակներից մեկը. - **Մոդերացիայում** — ավտոստուգումն անցել է կամ նշել է միայն մանրուքներ. այժմ փլագինին նայում է մարդ: Պարզապես սպասեք: - **Մերժված** — ինչ-որ բան չի անցել: Կտեսնեք **վճիռ, կարճ ամփոփում և չանցած կոնկրետ կետերը** (յուրաքանչյուրի պատճառով): Սա ձեր ուղղումների ցանկն է: - **Հրապարակված** — հաստատված, ստորագրված և պրոդում: Ձեր փլագինն այժմ հայտնվում է [AiHummer-ի մարկետփլեյսում](https://aihummer.ru) և տեղադրվում ցանկացած ինստանս, որտեղ միացված է community-կատալոգը: ### Ինչպես կարդալ մերժումը և կրկին ուղարկել 1. Բացեք փլագինը. կարդացեք **չանցած կետերը** և դրանց պատճառները: 2. Ուղղեք դրանք — հաճախ դա մեկն է հետևյալից. բացակայող/թույլ նկարագրություն, անհամաձայնեցված capability-մանիֆեստ, hardcoded գաղտնիք, վատ դոնաթ-հղում կամ չմեծացված տարբերակ: 3. Խմբագրեք մետատվյալները և/կամ վերբեռնեք **նոր արտեֆակտ մեծացված տարբերակով**: 4. Կրկին սեղմեք **«Ուղարկել ստուգման»**: Հայտը կրկին կանցնի նույն հոսքագծով: > [!NOTE] > Մերժումը պատիժ չէ, այլ չեկ-լիստ: [Ստուգման > քաղաքականությունը](/hy/v1.0/marketplace/review-policy) հրապարակային է հենց այն > բանի համար, որ դուք կարողանաք բավարարել բոլոր պահանջները **նախքան** ուղարկելը: ## Ուր հետո - [Ստուգման քաղաքականություն և չեկ-լիստ](/hy/v1.0/marketplace/review-policy) — ճշգրիտ չափանիշները, որոնցով ստուգվում է ձեր փլագինը: - [Plugin SDK](/hy/v1.0/marketplace/sdk) — փլագինի և դրա `manifest.json`-ի կառուցումը: - [Փլագինի հրապարակում](/hy/v1.0/marketplace/publishing) — մասնավոր side-load և հրապարակման այլ ռեժիմներ: - [Տեղադրում և թարմացումներ](/hy/v1.0/marketplace/install-updates) — ինչպես են օգտատերերը տեղադրում և ինչպես է կառուցված վստահության մոդելը: