AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплейс ва плагинҳо/Нашр кардани плагин

Нашр кардани плагин

v1.1.x · навсозӣ шуд 2026-07-19

Як плагин сохта шуд бо SDK-и васлкунӣШумо метавонед онро нашр кунед дар ду роҳ:

  • Private (for yourself) — ба нусхаи шумо бор кунед. Ин асар ҳеҷ гоҳ мефарояд.
  • Ҷомеа (барои ҳама) — тавассути шумо нашр кунед кабинети шахсӣ дар my.aihummer.ru, мағозаи барнома усул: бор кардани сохтмон, пур кардани саҳифаи мағоза, гузаштани баррасӣ ва он ба каталоги умумӣ, ки ҳар як нусха метавонист онро насб кунад.

Миқёс: насб кардани як .vsix бо даст (ҳамагӣ шахсӣ) барошӣ ба мағозаи барномаҳо нашр кардан (ҷомеа)

[!WARNING] Плагинҳои ҷомеаро ҳоло насб кардан мумкин нест — ин носозии пайваст нест. Калиде, ки феҳристи ҷомеа бо он имзо мешуд, бекор карда шуд; то баромадани калиди нав санҷиши имзо чунин сабтҳоро рад мекунад. Ҷудо аз ин, коди тарафи сеюм ҳоло дар сервери шумо ҳамчун хидмат иҷро намешавад: то пайдо шудани муҳити иҷрои ҷудогона танҳо ҳамгироиҳое иҷозат доранд, ки дар тарафи худ кор мекунанд ва аз тариқи шабака пайваст мешаванд.

Чӣ мебинед: пас аз пахши «насб кардан» паёми маъмулии «насб шуда истодааст» пайдо мешавад, вале плагин дар рӯйхати насбшудаҳо ҳеҷ гоҳ пайдо намешавад. Сабаби рад дар маҷаллаи дарвоза сабт мешавад — дар лавҳаи идора Маҷаллаҳо-ро кушоед.

Имрӯз чӣ кор мекунад:

  • плагинҳои AiHummer аз феҳристи расмӣ — мисли ҳарвақта насб мешаванд, дар онҳо имзои дигари эътибордор аст;
  • сервери MCP аз тариқи HTTP — ҳамчун манбаи абзорҳо бидуни барномасозӣ пайваст мешавад, код дар тарафи шумо мемонад;
  • ҳамгироӣ аз рӯи мушаххасоти OpenAPI — ҳамон, бидуни насби хидмат.

Боргузории дастии плагини худӣ санҷиши имзоро мегузарад, вале танҳо ҳамчун MCP-и дурдаст аз тариқи HTTP ё ҳамгироии OpenAPI кор мекунад; сохтае, ки бояд дар ҳамин сервер ҳамчун хидмат оғоз шавад, рад карда мешавад.

Ҳолати хусусӣ — боркунии канорӣ ба намунаи шумо

Инро танҳо вақте истифода баред, ки ба шумо плагин лозим бошад: пайвасткунаки дохилӣ, ҳамгироии фармоишӣ, сохтмони озмоишӣ.

Қадамҳо

  1. Бастабандӣ кунед ва бастаро имзо кунед 
    aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz
  2. Онро ба инстанс як аз ду роҳ бор кунед:
    • Интерфейси Идоракунӣ → Плагинҳо → “Бор кардани плагин” — баста ро кашидан; ё
    • CLI 
      aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
  3. Дар зери капот ин аст POST /v1/admin/modules/upload (бисёрқисмӣ, integrations:write): асар ба замин меафтад нигоҳдории блоби намуна (AIHUMMER_BLOB_DIR) зери blob: ішора, ва як сатр аз феҳрист сабт шудааст бо origin = local-private, visibility = private.
  4. Плагин дар бозор нишон дода мешавад ва тамғагузорӣ шудааст Хос ва тавассути насб мекунад роҳи оддӣ — якқатъаи systemd маҳдудшуда + дари саломатӣ.

Эътимод: калиди муқарраршуда ва анбори эътимод

Асули шахсӣ ҳамагӣ бояд имзо шавадВақте ки шумо плагини имзошуда бо калиди номаълумро бор мекунед, равзанаи идоракунандаи Admin ба шумо огоҳӣ медиҳад калиди муаллифро тасдиқ кунед ба анбори эътимоди намуна (як клик). Пас аз тасдиқ, имзо дар ҳар насб ва навсозӣ санҷида мешавад.

  • Ҳунарҳои аз расмӣ манбаъро муқоиса бо тафтиш кунед калиди сабтшуда ҳалқагӣ дар марказ — бо режими пешфарз эътимоднок, ҳеҷ қадами иловагӣ лозим нест.
  • Хос Ҳуҷҷатҳои қадимӣ бар зидди калидҳо дар анбори эътимоди намуна тасдиқ карда мешаванд.
  • Беимзо пакетҳо рад мешаванд — ҷуз дар режими таҳия барои такрори маҳаллӣ: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 тасдиқ намудани имзо ғайрифаъол мекунад ва барои танҳо барои рушди маҳаллӣ. Ҳеҷ гоҳ онро дар як нусхаи дастрас ба берун фаъол накунед.

Режими ҷомеа — чоп тавассути кабинети шахсӣ

Барои дастрас кардани плагин ба ҳар масалан, онро аз ҷониби худ нашр кунед кабинети шахсӣ дар my.aihummer.ru, ҳамон тавр ки шумо барномаро ба мағозаи барнома нашр мекунед. Шумо насбро бор мекунед, саҳифаи мағозаро пур мекунед ва барои барраси мефиристед; аввал санҷиши автоматии AI анҷом дода мешавад, пас модератор инсонӣ қарори ниҳоиро қабул мекунад, ва бо тасдиқ санад ба имзо расида, ба феҳристи ҷомеа нашр мешавад.

Роҳнамоии пурраи қадам ба қадам фаъол аст Як васлшударо пешниҳод кунедХулоса:

  1. Сохтан ва бастабандӣ плагини шумо бо SDK (aihummer plugin package) — ин асар аст имзо карда .tar.gz ба дастгирӣ гирифтани он manifest.json.
  2. Кушо «Плагинҳои ман» дар шӯро ва пешниҳоди худро эҷод кунед: боргузорӣ кунед афсона, пур кунед захира кардани метамаълумот (ном ва тавсифҳо ба русӣ ва англисӣ) версия, иконка, скриншотҳо, категория, пайванди ихтиёрии ҳадя, ҷадвали тағйирот) ва эълом кардан намуди қабилият.
  3. Барои баррасӣ фиристед. Мухторсозишуда Баррасии зеҳни сунъӣ тапшиқро муқоиса мекунад бо он сиёсати баррасӣ (амният, намоён) дурустӣ, комилӣ, мундариҷа), пас як модератори инсон гузоришро мехонад ва қарор қабул мекунад. Автоматика ҳеҷ гоҳ мустақилона нашр намекунад.
  4. Бо тасдиқ асар имзо карда ва нашр шуд ба ҷудо community-catalog.json барои CDN. Ҳар як ҳолате, ки илова шудааст Манбаи ҷомеа плагинро мебинад; ядро ба он тавассути эътимод дорад калиди сабти ҳалқшуда — қадами эътимод барои ҳар оператор лозим нест.

[!NOTE] Ҷараёни кӯҳнаи нашри оммавӣ аз кор бароварда шудааст; ҷараёни кабинети шахсии дар боло тавсифшуда — «Плагинҳои ман» — ягона роҳи нашр барои ҷомеа аст. Плагинҳои ҷамъиятӣ ройгонанд; шумо метавонед пайванди ихтиёрии хайрияро илова кунед.

[!NOTE] Плагинҳои тарафи аввал (Эйнштейн, SIP, Bitrix24, pocket-agent, os-client) ҳастанд ба ин шева нашр намешавад — онҳо бо хатти пайплайни AiHummer CI худ интиқол медиҳанд ва меоранд каталоги расмии сахтшуда. Ҷараёни кабинети шахсӣ барои ҷамъият (шиор сеюм) плагинҳо.

Миёнаравӣ

Ҳар як пешниҳоди ҷомеа тавассути санҷиши автоматикунонидашуда (комиланӣ, нишондиҳандаи қобилият, имзо ва скан кардани амният), пас як Баррасии хатари AIва ниҳоят як баррасии ҳатмии инсон аз ҷониби дастаи AiHummer. Ҳеҷ яке аз автоматизатсия ё AI ҳеҷ гоҳ танҳо нашр намекунад — қарор ҳамеша аз ҷониби модератор аст ва чизе бе тасдиқи онҳо ба каталог намерасад. Плагини нашршудаи баъдтар ба заҳролуд ё шикаста маълумшуда метавонад беэътиборшуда ва дар ҳамоҳангсозии навбатӣ аз феҳрист хориҷ шуд.

Феҳристи ҷомеа ҳамчун манбаи иловагӣ

Плагинҳои ҷомеа барои нашр ба як ҷудо community-catalog.json ин мекунад не каталоги пешрафтаи тарафаи аввалро навсозӣ мекунад. Як намуна онро ҳамчун манбаи иловагӣ илова мекунад Плагинҳо → Манбаъҳо (ё POST /v1/admin/modules/catalog/sources). Бубинед Насб ва навсозӣ ва Муқаддима ва сатҳҳо.

Ҳаёти плагин (Мағозаи Барномаҳо)

Бозор мисли мағозаи воқеии App Store кор мекунад — ҳар як плагин дорои шахсияти (як лугай доимӣ + муаллиф) таҳти он ки он интиқол дода мешавад навиштаҳо.

Нашрҳо ва навсозӣ

Навсозӣ ҳамчун як интиқол дода мешавад навсозии нав аз плагини аллакай нашршуда: ҳамон слаг, журнали тағйироти худ, баррасӣ ва назорати худ. Танҳо як Нусха метавонад дар баррасӣ бошад — шумо нусхаи нави худро пас аз қабули қарор оид ба нусхаи ҳозира пешниҳод мекунед. Вақте ки нусхаи нав нашр мешавад, нусхаи қаблӣ аломатгузорӣ мешавад. supersededва каталог ва ҳар як ҳолат ба навоварӣ кӯчонида шавад.

Нашри барномарезишуда

Пас аз он ки модератор тасдиқ мекунад, муаллиф назорат мекунад нашрроҲоло нашр кунед, ё онро барои вақти муайян ба нақша гиред — плагин дар лаҳзаи таъиншуда фаъол мешавад.

Нашрро бекор кардан

  • Танаффус — плагинро муддатан пинҳон кунед: он аз феҳристи умумӣ ва аз рӯи насбҳо берун мешавад (дар ҳамоҳангсозии навбатӣ), вале нигоҳ дошта мешавад ва метавонад бошад бознашршуда дар ҳар вақт
  • Аз феҳрист хориҷ кардан — плагинро барои ҳамеша аз бозори онлайн хориҷ кунед.

Ҳамон замон ки плагин номуҳр мешавад (истгоҳ ё номбар нашудааст), воридоти он ҳазф карда мешавад community-catalog.jsonва ҳолатҳо дар ҳамоҳангсозии навбатӣ онро намоиш намедиҳанд.

Муаллифият

Як плагин таҳти нашр қарор мегирад номи намоиши шумо (масалан, номи студияи шумо) — ё ностанишин. Каталоги оммавӣ ва интерфейси веби намуна номи интихобшударо ё “Насрнашуда” нишон медиҳанд; почтаи электронии воқеӣ/ID-и шумо ҳеҷ гоҳ ошкор намешавад.

Статистикаи рушдкунанда

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

Ҷоизаи нашр

Барои ҳар плагине, ки шумо бори аввал нашр мекунед, обунаи шумо ба AiHummer мегирад як моҳ ройгон (як маротиба барои ҳар як плагин дода мешавад).

Баъд куҷо