Нашри плагин тавассути кабинети шахсӣ

Маркетплейси community ба ҳар корбари бақайдгирифташуда имкон медиҳад, ки плагинро барои насби ҳама нашр кунад — ҳамон тавре ки шумо барномаро ба магазини барномаҳо нашр мекунед. Шумо метадодаҳои саҳифаи витринаро пур мекунед, эълон мекунед, ки плагинатон кадом ҳуқуқҳоро талаб мекунад, сборкаро бор мекунед ва онро ба санҷиш мефиристед. Ин саҳифа шуморо қадам ба қадам аз тамоми раванд мегузаронад.

[!NOTE] Ин раванд барои плагинҳои community (тарафи сеюм) аст, ки тавассути кабинети шахсии шумо дар my.aihummer.ru фиристода мешаванд. Плагинҳои худи AiHummer бо конвейери худ нашр мешаванд. Плагинҳои community ройгонанд; шумо метавонед ҳаволаи ихтиёрии хайрия илова кунед.

Пеш аз оғоз

Аккаунти бақайдгирифташудаи кабинети шахсӣ — сабти ном кунед ва онро тасдиқ кунед (нигаред ба Бақайдгирӣ). Ҳар корбар метавонад плагин фиристад.
Плагини сборкашуда — тарболи релизии имзошуда, ки бо Plugin SDK сохта шудааст (aihummer plugin package). Агар шумо ҳанӯз онро насохта бошед, аввал аз он ҷо шурӯъ кунед.
Иконка ва ҳадди ақал як скриншот, ва инчунин тавсифҳои тайёр ба забонҳои русӣ ва англисӣ.

Раванди нашр чӣ гуна кор мекунад (тасвири умумӣ)

Дархости шумо аз конвейери устувор мегузарад. Дар ҳар қадам шумо ҳолати онро дар кабинет мебинед.

Этап	Чӣ рӯй медиҳад	Кӣ амал мекунад
Сиёҳнавис	Шумо навиштро эҷод мекунед ва метадодаҳоро пур мекунед; ҳанӯз чизе ошкор нест.	Шумо
Фиристодашуда	Шумо онро ба санҷиш мефиристед.	Шумо
AI-санҷиш	Агенти автоматӣ плагинро аз рӯи сиёсати санҷиш месанҷад — амният, дурустии манифест, пуррагӣ, контент.	Автоматика
Модератсия	Модератори инсонӣ ҳисоботи AI, инчунин артефакт ва метадодаҳои шуморо мехонад ва қарор қабул мекунад.	Дастаи AiHummer
Нашршуда	Пас аз тасдиқ артефакт имзо мешавад ва ба каталоги community ва витринаи оммавӣ илова мешавад.	Дастаи AiHummer
Радшуда	Агар чизе нагузарад, шумо сабабҳоро мегиред; ислоҳ мекунед ва аз нав мефиристед.	Шумо → боз ба сиёҳнавис

[!IMPORTANT] AI ҳеҷ гоҳ плагинро худаш нашр намекунад. Қарори ниҳоиро ҳамеша инсон қабул мекунад, ва ҳеҷ чиз бе тасдиқи ӯ ба каталог намеафтад.

Қадами 1 — «Плагинҳои ман»-ро кушоед

Ба my.aihummer.ru ворид шавед, фасли «Плагинҳои ман»-ро кушоед ва «Нашр кардан» (ё «Плагини нав»)-ро пахш кунед. Ҳамин тавр сиёҳнавис эҷод мешавад, ки то фиристодани он метавонед онро озодона таҳрир кунед.

Қадами 2 — Метадодаҳои витринаро пур кунед

Ҳамаи майдонҳоро пур кунед. Метадодаҳои нопурра — яке аз маъмултарин сабабҳоест, ки дархостро ба такмил бармегардонад.

Майдон	Чӣ дохил кардан
Ном (RU + EN)	Номи намоишии плагин дар ду забон.
Тавсифи кӯтоҳ (RU + EN)	Як сатр барои корти каталог.
Тавсифи пурра (RU + EN)	Плагин чӣ мекунад, чӣ гуна аз он истифода бурдан, ба он чӣ лозим аст. Пурмаъно — на заглушка.
Категория	Яке аз маҷмӯаи иҷозатдодашударо интихоб кунед (масалан: Каналҳо, Ҳосилнокӣ, Интегратсияҳо, Овоз, Утилитаҳо).
Версия	Сатр дар формати semver, масалан `1.0.0`. Ҳар дархости нав бояд онро зиёд кунад.
Иконка	Тасвири квадратии эътибордор.
Скриншотҳо	Ҳадди ақал як; плагинро дар амал нишондиҳанда.
Литсензия	Литсензияи плагин (масалан MIT, Apache-2.0).
Сайт / репозиторий	Ҳаволаи ихтиёрии `https://` ба лоиҳаи шумо.
Ҳаволаи хайрия	Ихтиёрӣ. Ҳаволаи эътибордори `https://` ба хости хайрияи маъруф — масалан Boosty, Patreon, PayPal ё ЮMoney. Фишинг ва хостҳои худсарона рад карда мешаванд.
Чейнджлог (RU + EN)	Дар ин версия чӣ тағйир ёфт.

[!TIP] Тавсифҳоро барои корбари воқеӣ нависед, ки ҳеҷ гоҳ плагини шуморо надидааст. «Барои соддалавҳон» маҳз ҳамин лозим аст: бигӯед, ки он чӣ мекунад, кай онро ба кор бурдан ва ба он чӣ лозим аст.

Қадами 3 — Capability-манифестро эълон кунед

Capability-манифест дили модели амният аст. Ин эълони кӯтоҳ ва сохтории ҳамаи ҳуқуқҳоест, ки ба плагини шумо лозиманд — бо кадом хостҳо он муошират мекунад, кадом файлҳоро мерасад, оё фармонҳои берунаро иҷро мекунад, кадом каналҳо ва доступҳоро истифода мебарад.

Барои чӣ онро эълон кардан

Корбарон ҳуқуқҳои дархостшударо пеш аз насб мебинанд ва ба онҳо розигӣ медиҳанд — мисли дархости иҷозатҳо дар барномаи мобилӣ.
Инстанс манифестро истифода мебарад, то плагинро бо он чи ки эълон кардааст маҳдуд кунад.
Санҷандагон тафтиш мекунанд, ки ҳуқуқҳои эълоншуда бо он чи ки код воқеан мекунад мувофиқат мекунанд. Плагине, ки ба ҳуқуқи эълоннашуда даст мезанад, рад карда мешавад.

Принсипи ҳадди ақали ҳуқуқҳо

Танҳо он чиро эълон кунед, ки плагин воқеан истифода мебарад, ва ҳеҷ чизи изофӣ. Ҳуқуқҳои камтар — санҷиши тезтар, розигии осонтари корбар ва насбҳои бештар. Агар ба системаи файлҳо даст назанед — рӯйхати холӣ эълон кунед. Агар ҳеҷ гоҳ протсесс насозед — exec-ро ба false гузоред.

Формат

Capability-манифест объекти JSON бо ин майдонҳост:

Майдон	Навъ	Маъно
`network`	string[]	Хостҳое, ки плагин ба онҳо пайваст мешавад (allowlist-и дархостҳои содиротии он).
`filesystem`	string[]	Роҳҳое, ки он мехонад ё менависад, нисбат ба директорияи худи плагин.
`exec`	boolean	Оё он протсессҳо / фармонҳои беруна иҷро мекунад.
`channels`	string[]	Каналҳои мубодилаи паём, ки бо онҳо интегратсия мекунад (масалан `telegram`).
`credentials`	string[]	Секретҳо/калидҳои конфигуратсияи номдор, ки истифода мебарад (ҳеҷ гоҳ на арзиши секретҳо).
`description`	string	Тавсифи кӯтоҳ ва барои инсон хонои он ки ба он чӣ ва барои чӣ лозим аст.

Мисол:

{
  "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); арзиши воқеиро корбар ҳангоми насб медиҳад. Секретҳои захардкодшуда — раддияи автоматӣ.

Қадами 4 — Артефактро бор кунед

Сборкаи плагини худро бор кунед:

Формат: тарболи релизии .tar.gz, ки бо фармони aihummer plugin package сохта шудааст.
Он бояд manifest.json-и плагинро дар бар гирад (манифести SDK — навъ, версия, нуқтаи вуруд, capabilities-и эълоншуда, майдонҳои конфигуратсия).
Capability-манифесте, ки шумо дар Қадами 3 пур кардед, бояд бо он чи ки код ва manifest.json воқеан мекунанд мувофиқ бошад.

Иконка ва скриншотҳоро низ дар ҳамин ҷо замима мекунед, агар ҳанӯз накарда бошед.

[!TIP] Пеш аз боркунӣ aihummer plugin validate-ро дар ҷои худ иҷро кунед. Ин ҳамон контракти валидатсияест, ки маркетплейс истифода мебарад, бинобар ин манифесте, ки дар ҷои худ гузашт, дар ин ҷо низ қабул мешавад.

Қадами 5 — Ба санҷиш фиристед

Вақте ки ҳамаи майдонҳо пур ва артефакт бор шуд, «Ба санҷиш фиристодан»-ро пахш кунед. Кабинет аввал пуррагиро месанҷад; агар чизе намерасад — он маҳз чиро надоштанашро мегӯяд. Пас аз қабул ҳолат ба Фиристодашуда ва сипас ба AI-санҷиш мегузарад — дигар чизе кардан лозим нест.

Қадами 6 — Ҳолатро пайгирӣ кунед ва ҳукмро хонед

Плагинро дар «Плагинҳои ман» кушоед, то ҳолати онро пайгирӣ кунед. Ҳангоми ба охир расидани санҷиш яке аз инҳоро мебинед:

Дар модератсия — санҷиши автоматӣ гузашт ё танҳо чизҳои ночизро қайд кард; ҳоло инсон ба он нигоҳ мекунад. Танҳо интизор шавед.
Радшуда — чизе нагузашт. Шумо ҳукм, хулосаи кӯтоҳ ва пунктҳои мушаххаси нагузаштаро мебинед (бо сабаб барои ҳар кадом). Ин рӯйхати ислоҳоти шумост.
Нашршуда — тасдиқ, имзо ва дар прод. Плагини шумо ҳоло дар маркетплейси AiHummer пайдо мешавад ва ба ҳар инстансе, ки каталоги community дар он фаъол аст, насб мешавад.

Чӣ гуна радро хондан ва аз нав фиристодан

Плагинро кушоед; пунктҳои нагузашта ва сабабҳои онҳоро хонед.
Онҳоро ислоҳ кунед — аксаран ин яке аз инҳост: тавсифи нарасанда/суст, capability-манифести номувофиқ, секрети захардкодшуда, ҳаволаи бади хайрия ё версияе, ки зиёд накардаед.
Метадодаҳоро таҳрир кунед ва/ё артефакти навро бо версияи зиёдшуда бор кунед.
Дубора «Ба санҷиш фиристодан»-ро пахш кунед. Он аз ҳамон конвейер аз нав мегузарад.

[!NOTE] Рад ҷазо нест — балки чек-лист аст. Сиёсати санҷиш маҳз барои он оммавист, ки шумо тавонед ҳамаи талаботро пеш аз фиристодан иҷро кунед.

Минбаъд куҷо

Сиёсати санҷиш ва чек-лист — меъёрҳои дақиқе, ки плагини шуморо аз рӯи онҳо месанҷанд.
Plugin SDK — сохтани плагин ва manifest.json-и он.
Нашри плагин — side-load-и приватӣ ва дигар режимҳои нашр.
Насб ва навсозиҳо — корбарон чӣ гуна насб мекунанд ва модели эътимод чӣ гуна сохта шудааст.