Насб ва навсозӣ

GET  /v1/admin/modules
POST /v1/admin/modules/install

{ "slug": "einstein", "version": "" }

download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Насби як плагин дар AiHummer танҳо як клик дар интерфейси маъмур аст, аммо паси он клик як давраи ҳаётии детерминистӣ ва маҳаллии мизбонӣ вуҷуд дорад. Платформа плагинро зеркашӣ мекунад, қадамҳои насби эълоншудаи онро иҷро мекунад, **як воҳиди systemd бо маҳдудият**, ва танҳо пас аз он ки плагин ба санҷиши саломатӣ ҷавоб медиҳад, онро солим меҳисобад. Ҳар насб пас аз он худаш ба навсозии худ идома медиҳад. ## Насби бо як клик аз интерфейси маъмурӣ Шумо замимаҳоро аз интерфейси идоракунӣ насб ва идора мекунед, ки бо API модули идоракунӣ дастгирӣ мешавад: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` Слагги модул бояд дар бадани дархости JSON бошад, на дар роҳ: ```json { "slug": "einstein", "version": "" } ``` Ҳеҷ чиз бо дасти худ пайваст кардан лозим нест: як плагинро аз феҳрист интихоб кунед, насбро пахш кунед ва таҷҳизоти насбкунӣ корро ба ӯҳда мегирад. > [!NOTE] > Насб кардани пайвасткунаки канал дар беруни маҷмӯи асосӣ (танҳо барои Telegram) > талаб мекунад фаъол **Оғозкунанда**, **Тиҷорат** ё **Ширкат** иҷозатнома > Дар нақшаи Ҷомеа чунин дархост бармегардад **HTTP 402 "навсозии талабшаванда"** > (код `plan_limit`) — бинед [Литсензиядоркунӣ](/tg/v1.0/commercial/licensing). > [!NOTE] > Он **Эйнштейн** плагини хотира аст **дарунсохт**: он ба таври худкор насб мешавад, > Ҷавҳари "Встроенное" дорад ва наметавонад хориҷ ё қатъ карда шавад. ## Ҷараёни SystemdDeployer Зери капот **СистемдДеплойер** ин қадамҳоро иҷро мекунад: 1. **Боргирии як файли фишурдашуда** барои плагини интихобшуда. 2. **Рӯйхати молҳоро иҷро кунед `install[]` қадамҳо** иқроршуда аз ҷониби плагин. 3. **Яке воҳиди systemd-и маҳдудшударо иҷро кунед** барои плагин. 4. **Раёсат `/healthz`** то хидмат ҳисоботи саломатӣ диҳад. ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` Танҳо вақте `/healthz` муваффақ мешавад насбкунӣ ҳамчун фаъол нишон дода мешавад — плагине, ки насб нашудааст, ба таври хомӯш ҳамчун насбшуда ҳисоб намешавад. ## Systemd маҳалли меҳмон, дар санбокс — на Docker Ҳар як иловапардоз ҳамчун иҷро мешавад **хидмати системд бо муҳити маҳдудшудаи худ**Ҳеҷ контейнерие нест, ҳеҷ Docker ва ҳеҷ оркестраторе нест: плагин хидмати идорашавандаи Linux бо воҳиди худ, порт ва маҳдудиятҳои сандбокс мебошад, ки мисли қисми дигар насб аз ҷониби systemd назорат мешавад. > [!WARNING] > AiHummer аз заминаи мизбон мебошад. Плагинҳо ҳамчун хидматҳои systemd дар муҳити ҷудошуда насб мешаванд. > аз як ҳалқаи нашршуда — **ҳеҷ гоҳ ҳамчун контейнерҳои Docker.** Агар роҳнамо ба шумо гӯяд > Ҷиҳати 'иқдом кардани контейнери плагин', он AiHummer-ро тавсиф намекунад. ## Пӯшидани дастрасӣ бо /healthz Фароварандаи плагинро санҷида мебарад `/healthz` нуқтаи анҷом пеш аз эъломи муваффақият. Ин даргоҳи саломатӣ аст, ки насб бо як кликро бехатар мекунад: плагини шикаста ё нодуруст танзимшуда ҳангоми насб ошкор мешавад, на пас аз пайдо шудан дар истеҳсолот. ## Навсозии худкор пеш аз насб Навсозӣҳо идора карда мешаванд **барои васлкунӣ**Ҳар як плагини насбшуда метавонад ба таври худкор дар ҷадвали худ навсозӣ шавад, бинобар ин нигоҳ доштани плагинҳо дар ҳолати нав набарои ҳар вақте, ки версияи нав ба феҳрист мерасад, насби дастӣ лозим нест. Ҳамин қадамҳои зеркашӣ → насб → воҳиди рендер → санҷиши саломатӣ барои навсозӣ низ мисли насби аввал амал мекунанд. > [!TIP] > Зеро навсозии худкор барои ҳар насб амал мекунад, шумо метавонед баъзе плагинҳоро нигоҳ доред. > гузоштани дигарон барои пайгирии навтарин — ҳар насб сохт ва муҳити зиндагии худро идора мекунад. ## Феҳристи манбаъҳои гуногун Каталог дигар ба як URL ягона маҳдуд нест. **каталоги ҷомеа** плагинҳои тарафи сеюм ҳамчун барномаҳои дохилӣ фиристода мешаванд **манбаи пешфарз** (дар вақти насбшуда) — шумо онро худатон илова намекунед. Дар **Плагинҳо → Манбаъҳо** (Интерфейси идоракунӣ, ё `POST /v1/admin/modules/catalog/sources`) шумо метавонед манобеи иловагии худро илова кунед. Дарвозаи синхронсозӣ ҳар манбаи фаъолро дар оғози кор ва дар давраи навсозии худкор ҳамоҳанг мекунад. - Он **манбаи расмӣ** (модулҳои тарафи аввал) аз пешфарз пайваст ва боэътимод мебошанд — як объекти ҷудогона ки мебошад **навишта нашудааст** аз манбаъҳои дигар. - Он **каталоги ҷомеа** иқтидори манбаи пешфарз мебошад; **манбаъҳои хусусӣ** меўбошанд аз ҷониби оператор илова шудааст. Ҳар як сабти феҳрист дорои як `origin`, ва он `origin` муқаррар мекунад, ки кадом нишона тасдиқ карда мешавад бар зидди (расмӣ → калиди часпондашуда, шахсӣ → анбори эътимод). Барои нашр дар феҳристи ҷамъиятӣ, бинед [Нашр кардани плагин](/tg/v1.0/marketplace/publishing). ## Намунаи эътимод ва калиди пайвастшуда Насб имзои плагинро тавассути манбааш тафтиш мекунад: - **расмӣ** → бар асоси санҷиш тасдиқ шудааст **калиди сабт дар ядро маҳкам карда шудааст**Ба ӯ эътимод дода мешавад пешфарз, бе фаъолияти оператор. - **шаҳсӣ** (боргирии тараф) → баррасӣ кардашуда бар зидди **омонияти нигаҳдории намуна**; ин Калиди муаллиф аз ҷониби оператор ҳангоми боргузорӣ тасдиқ мешавад (як клик). - **дисавторӣшуда** → рад карда шуд, ғайр аз ҳолати таҳия (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, танҳо рушди маҳаллӣ) > [!WARNING] > **Плагинҳои ҷомеаро ҳоло насб кардан мумкин нест — ин носозии пайваст нест.** > Калиде, ки феҳристи ҷомеа бо он имзо мешуд, бекор карда шуд; то баромадани > калиди нав санҷиши имзо чунин сабтҳоро рад мекунад. Ҷудо аз ин, коди тарафи > сеюм ҳоло дар сервери шумо ҳамчун хидмат иҷро намешавад: то пайдо шудани муҳити > иҷрои ҷудогона танҳо ҳамгироиҳое иҷозат доранд, ки дар тарафи худ кор мекунанд > ва аз тариқи шабака пайваст мешаванд. > > **Чӣ мебинед:** пас аз пахши «насб кардан» паёми маъмулии «насб шуда истодааст» > пайдо мешавад, вале плагин дар рӯйхати насбшудаҳо **ҳеҷ гоҳ пайдо намешавад**. > Сабаби рад дар маҷаллаи дарвоза сабт мешавад — дар лавҳаи идора **Маҷаллаҳо**-ро > кушоед. > > **Имрӯз чӣ кор мекунад:** > > - **плагинҳои AiHummer** аз феҳристи расмӣ — мисли ҳарвақта насб мешаванд, дар > онҳо имзои дигари эътибордор аст; > - **сервери MCP аз тариқи HTTP** — ҳамчун манбаи абзорҳо бидуни барномасозӣ > пайваст мешавад, код дар тарафи шумо мемонад; > - **ҳамгироӣ аз рӯи мушаххасоти OpenAPI** — ҳамон, бидуни насби хидмат. > > Боргузории дастии плагини худӣ санҷиши имзоро мегузарад, вале танҳо ҳамчун > **MCP-и дурдаст аз тариқи HTTP** ё ҳамгироии OpenAPI кор мекунад; сохтае, ки > бояд дар ҳамин сервер ҳамчун хидмат оғоз шавад, рад карда мешавад. ## Навсозии имзошуда Як навсозӣ **борҳо ҳамон дарҳои имзодорро такрор мекунад** чунки насби аввал: ҳангоми гузаштан ба нусхаи нав имзо боз аз рӯи ҳамон нуқтаи эътимод санҷида мешавад. Як навсозӣ **намегузарад** санҷиш — шумо наметавонед бо навсозӣ эътимодро баланд бардоред. ## Нишони расмӣ ва дараҷа Дар каталоги Web UI, плагинҳои AiHummer дорои як **Расмӣ** нишон ва мақом аввал. Замимаҳои тарафи сеюм бе нишон нишон дода мешаванд ва ҷудо карда мешаванд **барои шумораи зеркашӣ**Парчами расмӣ аз як вуруд гирифта шудааст `origin` (расмӣ) — онро дасти худ дар манифест таъин кардан мумкин нест. ## Баъд ба куҷо - [Назари умумӣ ба бозор ва сатҳҳо](/tg/v1.0/marketplace/overview-tiers) — чӣ се сатҳи плагин вуҷуд доранд. - [SDK-и васлкунӣ](/tg/v1.0/marketplace/sdk) — `manifest.json` ки `install[]` қадамҳое, ки ин давраи ҳаёт мегузарад. - [Нашр кардани плагин](/tg/v1.0/marketplace/publishing) — боргирии хусусӣ ва Нашриёт тавассути кабинети шахсӣ. - [Интегратсияҳои бе рамз](/tg/v1.0/marketplace/zero-code) — илова кардани асбобҳои OpenAPI/MCP бе хидмат барои насб.