Պլագինի հրապարակում — AiHummer Փաստաթղթեր

Ստեղծվել է հավելվածը հետ Պլագինների զարգացման բազա? Դուք կարող եք հրապարակել սա երկու ճանապարհ:

Անձնական (նրա համար) — բեռնեք ձեր* օրինակին։ Արտեֆակտը երբեք թողնում է սա։
Համայնք (բոլորի համար) — հրապարակեք ձեր միջոցով անձնական կաբինետ ում my.aihummer.ru, հավելվածների խանութ շարք: ներբեռնել հավաքածուն, լրացնել խանութի էջը, անցնել ստուգում, և այն հայտնվում է հաստատված համայնքի կատալոգ, որը կարող է տեղադրվել յուրաքանչյուր օրինակից:

Անալոգիա՝ տեղադրում .vsix ընձեռ (անձնական) ընդդեմ հավելվածների խանութում հրապարակման (հասարակություն):

[!WARNING] Համայնքի պլագինները հիմա հնարավոր չէ տեղադրել — սա կապի խափանում չէ։ Բանալին, որով ստորագրվում էր համայնքի կատալոգը, հետ է կանչվել. մինչև նոր բանալու թողարկումը ստորագրության ստուգումը մերժում է այդ գրառումները։ Դրանից անկախ՝ երրորդ կողմի կոդը դեռ չի գործարկվում որպես ծառայություն ձեր սերվերի վրա. մինչև մեկուսացված գործարկման միջավայրի հայտնվելը թույլատրված են միայն այն ինտեգրումները, որոնք աշխատում են իրենց կողմում և միանում են ցանցով։

Ինչ կտեսնեք. «տեղադրել» սեղմելուց հետո կհայտնվի սովորական «տեղադրվում է» հաղորդագրությունը, բայց պլագինը երբեք չի հայտնվի տեղադրվածների ցանկում։ Մերժման պատճառը գրվում է դարպասի մատյանում — բացեք Մատյաններ կառավարման վահանակում։

Ինչն է աշխատում այսօր.

պաշտոնական կատալոգի AiHummer-ի պլագինները — տեղադրվում են սովորականի պես, դրանք ունեն այլ, գործող ստորագրություն;

MCP սերվեր HTTP-ով — միանում է որպես գործիքների աղբյուր առանց մշակման, կոդը մնում է ձեր կողմում;

ինտեգրում OpenAPI բնութագրով — նույնը, առանց տեղադրվող ծառայության։

Սեփական պլագինի ձեռքով բեռնումն անցնում է ստորագրության ստուգումը, բայց կգործարկվի միայն որպես հեռավոր MCP HTTP-ով կամ OpenAPI ինտեգրում. կառուցվածք, որը պետք է գործարկվի որպես ծառայություն նույն սերվերի վրա, մերժվում է։

Անհատական ռեժիմ՝ ձեր օրինակին տեղադրված կարգավորում

Օգտագործեք դա միայն այն ժամանակ, երբ ձեզ անհրաժեշտ է մի պլագին՝ ներքին միակցիչ, օգտատերերի ինտեգրում, փորձարկման հավաքածու։

Քայլեր

Փաթեթավորեք և ստորագրեք փաթեթը՝

aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

Բեռնեք դա օրինակին մեկը երկուսի մեջ եղած եղանակներից մեկով։
- Դասավորիչի ինտերֆեյս → Պլագիններ → «Ներբեռնել պլագին» — տեղափոխեք փաթեթը; կամ
- CLI:
```
aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
```
Վրա ծածկոցը սա է POST /v1/admin/modules/upload (բազմամասին, integrations:write): արձանագրությունը վայրէջք է կատարում օրինակների օբյեկտների պահոց (AIHUMMER_BLOB_DIR) տակ blob: հղում, և կատալոգի զանգվածը գրանցված է origin = local-private, visibility = private.
Պլագինը հայտնվում է շուկայում՝ թեգով Անհատ և սահմանում է միջոցով նորմալ ճանապարհը — sandboxացված systemd միավոր + վիճակի վերահսկում.

Հավատը՝ ամրագրված բանալին և վստահության պահոցը

Անհատական արվեստային գտածոներ պետք է ստորագրվի. Երբ դուք բեռնում եք լրակազմը, որը նշվում է անհայտ բանալիով, ադմինիստրատորի ինտերֆեյսը առաջարկում է ձեզ հաստատել հեղինակի բանալին քոնռում վստահված սերտիֆիկատների պահեստում օրինակի (մեկ մկնիկի կտտոցով): Հաստատումից հետո ստորագրությունը ստուգվում է յուրաքանչյուր տեղադրման և թարմացման ժամանակ:

Արվեստի առարկաներ from առաջինական աղբյուրի ստուգում ըստ կայունացված ռեգիստրային բանալին միջուկում — վստահել ըստ կանխկարգը, առանց լրացուցիչ գործողությունների։
Անհատ Արհեստաներն ստուգվում են պահարանի վստահության նշաններով։
Առանց ստորագրման պետակները մերժվում են — բացառությամբ տեղային արտացոլման մշակման ռեժիմի դեպքում: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 անջատում է ստորագրման ստուգումը և նախատեսված է մինակի համար միայն տեղային մշակման: Երբեք մի միացրեք սա այն օրինակին, որն հասանելի է դուրսից:

Համայնքի ռեժիմը՝ հրապարակել անձնական գրասենյակից

Ահա՛նպես բաշխելու համար հավելումը հասանելի յուրաքանչյուր օրինակ, հրապարակեք դա ձեր անձնական կաբինետ ում my.aihummer.ru, այն ամենը, ինչպես դուք հրապարակում եք հավելվածն Անդրոյիդ/Նախադրյալների խանութում։ Դուք բարձրացնում եք հավաքածուն, լրացնում խանութի էջը և ուղարկում ստուգման; նախ կատարում է ավտոմատացված ԱԻ ստուգում, ապա վերջնական որոշումը կայացնում է մարդ-մոդերատորը, և հաստատումից հետո արտեֆակտը ստորագրված է և հրապարակված է համայնքի կատալոգում։

Ամբողջական քայլ առ քայլ ուղեցույցը գտնվում է Ներկայացնել պլագին. Քարճ ասած:

Հավաքել և փաթեթավորել ձեր պլագինը SDK-ով (aihummer plugin package) — արձանագրությունը հանդիսանում է ստորագրված .tar.gz տարող այն manifest.json.
Բացեք «Իմ լրացումներ» բաժակաշարքում և ստեղծեք մատակարարում: բեռնել արտեֆակտ, լրացրեք պահպանել մետատվյալները (անունն ու նկարագրությունները ռուսերեն + անգլերեն) տարբերակ, պատկերակ, էկրանային նկարներ, կատեգորիա, կամավոր նվիրատվությունների հղում, փոփոխությունների ինքը) և հայտարարել հնարավորությունների մանիֆեստ.
Ուղարկել ստուգման։ Ավտոմատացված ԱԻ վերանայում ստուգում է ներկայացվածը համապատասխանության համար Հը գնահատման քաղաքականություն (անվտանգություն, մանիֆեստ) ճշտություն, ամբողջություն, պարունակություն), այնուհետև a մարդկային մոդերատոր կարդում է հաշվետվությունը և ընդունում է որոշումը։ Ավտոմատացումը երբեք ինքնուրույն չի հրապարակում։
Հաստատումից հետո արտեֆակտը հանդիսանում է ստորագրված և հրապարակվել է տարբեր community-catalog.json վերցված CDN. Յուրաքանչյուր օրինակ, որը ավելացրեց համայնքը տեսնում է պլագինը; միջուկը վստահում է նրան միջոցով կայունացված ռեգիստրային բանալին — յուրաքանչյուր օպերատորի համար վստահության քայլ պահանջվող չէ:

[!NOTE] Հրապարակման հին հանրային գործընթացը դադարեցված է. վերևի անձնական գրասենյակի հոսքը՝ «Իմ պլագինները», այժմ համայնքային հրատարակման միակ ուղին է: Համայնքային պլագինները անվճար են. կարող եք ավելացնել կամավոր նվիրատվության հղում:

[!NOTE] Առաջին կողմի հավելվածներ (Այնշտեյն, SIP, Bitrix24, pocket-agent, os-client) հանդիսանում են չեն հրապարակվում այսպես — դրանք ուղարկվում են սեփական AiHummer CI կոնվեյերով և հայտնվում են կպցված պաշտոնական կատալոգը։ Անձնական գրասենյակի հոսքը նախատեսված է համայնք (երրորդ կողմ) պլագիններ.

Մոդերացիա

Ամեն համայնք անցնում է միջով ավտոմատ ստուգում (լիություն, հնարավորությունների հայեցակարգման ձև, ստորագրություն և անվտանգության ստուգում), այնուհետև ԱԻ ռիսկերի վերանայում, և վերջապես, ա պարտադիր ձեռքով (մարդկային) վերանայում AiHummer թիմի կողմից: Ոչ ավտոմատացումը, ոչ ԱԻ-ն երբեք ինքնուրույն չեն հրապարակում — որոշումը միշտ կայացնում է մոդերատորը, և ոչինչ չի հայտնվում կատալոգում առանց նրանց հավանության։ Հրապարակված հավելյալը, որը հետագայում պարզվեց վիտաղ կամ կոտրված կարող է լինել չեղարկված և հանվել է կատալոգից հաջորդ համաժամացման ժամանակ։

Համայնքի կատալոգը որպես լրացուցիչ աղբյուր

Համայնքի հավելվածները հրապարակվել են տարբեր community-catalog.json այս անում է ոչ վերագրանցել առաջին աստիճանի վերահսկվող կատալոգը: Տեսականին ավելացնում է այն որպես հավելյալ աղբյուր Պլագիններ → Աղբյուրներ (կամ POST /v1/admin/modules/catalog/sources). Դիտել Տեղադրում և թարմացումներ և Գլխավոր և մակարդակներ.

Պլագինի (App Store) կյանքի զանգված

Մարկետպլեյսը գործում է ինչպես իրական App Store — յուրաքանչյուր հավելում ունի համապատկություն (կայուն նույնըչափիչ + հեղինակ), որի ներքո այն տրամադրվում է տարբերակներ.

Հրամաններ և թարմացումներ

Թարմացումը տրամադրվում է որպես նոր տարբերակ մեջ արդեն հրապարակված պլագինը՝ նույն կարճ արձանագրություն, սեփական փոփոխությունների օրագիր, սեփական գնահատականներ և մոդերացիա: Միայն մեկ տարբերակը կարող է գտնվել քննարկման փուլում նույն ժամանակում — դուք ուղարկում եք հաջորդը այն բանից հետո, երբ ընթացիկն ստանա որոշում: Երբ նոր տարբերակը հրապարակվում է, նախորդը նշանավորվում է superseded, և կատալոգը + յուրաքանչյուր օրինակ տեղափոխել նորին։

Նպատակավորված հրապարակում

Օտոմատորն այս հաստատելուց հետո, ավտորն վերահսկում է թողարկումը: հրապարակեք հիմա կամ պլանավորեք որոշակի ժամանակի համար — միացվողը կկատարվի նշանակված պահին.

Հրատարակությունից հանելը

ԱԿԱՆ ԽԱՆԴԱՐ — ժամանակավոր փակել ծրագրակազմի հավելումը՝ այն դուրս է գալիս հանրային կատալոգից և ինստանսներից (հաջորդ համաժամացման ժամանակ), բայց պահպնվում է և կարող է լինել վերատարած քանEVER ժամանակ։
Հեռացնել ցուցակից — մշտապես հեռացնել հավելվածը խանութից։

Ինչպես միայն plug-in-ը դառնում է մատչելի, այն գրառումը ջնջվում է community-catalog.jsonև դեպքերը դադարում են ցույց տալ դա հաջորդ համաժամացման ընթացքում:

Հեղինակություն

Պլագինը հրապարակվել է ըստ ձեր ցուցադրվող անունը (օրինակ՝ ձեր ստուդիայի անունը) — կամ անանուն. Հանրային կաթալոգը և ինտերֆեյսի վեբ-էջը ցուցադրում են ընտրված անունը կամ «Անանուն»; ձեր իրական էլեկտրոնային փոստի հասցեն/հայտնագիրը երբեք չի հրապարակվում։

Հեղինակային վիճակագրություն

Յուրաքանչյուր պլագին ունի ամփոփ վիճակագրություն: ներբեռնումներ, տեղադրումներ, գործող օրինակներ և ապատեղադրումներ, ինչպես նաև օրական գրաֆիկ: Միավորում կարգաբերումներ միայն — մեկ օրինակին ֆիքսված տվյալներ չեն տրամադրվում մշակողի համար:

Տպագրության համար պարգև

Համար յուրաքանչյուր բլագին, որը դուք հրապարակում եք առաջին անգամ, ձեր AiHummer բաժանորդագրությունը ստանում է մեկ անվճար ամիս (տրվում է ամեն մի լրագիրի համար մեկ անգամ)

Որտեղից հետո

Ուղարկել անձնական գրասենյակից — ամբողջական քայլ առ քայլ՝ մեթադատա, հնարավորությունների մանիֆեստ, ակնարկ և ԱԻ-ի մոդերացիա:
Պլագինների զարգացման բազա — հրապարակել դաշտերը և `aihummer փլագինի հրամանները.
Տեղադրում և թարմացումներ — տեղակայումը, վստահության մոդելը, ստորագրված թարմացումները և մակարդակավորումը։
Վերանայման քաղաքականություն և ստուգաթերթ — չափանիշները, որոնցով պլագինը ստուգվում է հրապարակումից առաջ։
Մարկետփլեյս՝ ակնարկ և մակարդակներ — պաշտոնական հակառակ համայնքի ռեեստրի։