Агляд маркетплейса і ўзроўні — AiHummer Дакументацыя

Маркетплейс плагінаў — гэта тое, як AiHummer выходзіць за межы свайго ўбудаванага рантайму. Яго каталог сінхранізуецца з CDN, усталяванні робяцца ў адзін клік з адмін-інтэрфейсу, і кожны плагін працуе хост-натыўна — у мадэлі няма ніякага Docker. Плагіны бываюць трох узроўняў, якія адрозніваюцца тым, як яны выконваюцца і што яны могуць рабіць.

Тры ўзроўні з аднаго погляду

Узровень	Што гэта	Як працуе	Уліковыя даныя
Tier 1	Асобныя хост-натыўныя сэрвісы (каналы, голас)	Свой уласны ізаляваны юніт systemd + порт	Агульныя (працоўная прастора)
Tier 2	Унутрыпрацэсныя інструменты/навыкі	Унутры працэсу шлюза	Асабістыя або агульныя
Tier 3	Тыпы крыніц без кода (OpenAPI, MCP)	Сінтэзуюцца шлюзам, без кода	Асабістыя (OAuth для кожнага карыстальніка) або агульныя

Tier 1 — асобныя хост-натыўныя сэрвісы

Плагіны ўзроўню 1 — гэта паўнавартасныя сэрвісы самі па сабе: канальныя канектары і галасавыя кампаненты, такія як плагіны SIP, Bitrix24, Einstein і iOS-проксі. Кожны з іх разгортваецца як свой уласны ізаляваны юніт systemd, які слухае на сваім уласным порце, і шлюз размаўляе з ім праз HTTP. Гэта прынцып «хост-натыўна, а не Docker» у дзеянні — плагін з’яўляецца кіраваным сістэмным сэрвісам, а не кантэйнерам.

Канальныя канектары, даступныя зараз: Telegram, MAX (новы расійскі месенджар, канал max) і Bitrix24 (унутраны канал абмену паведамленнямі для супрацоўнікаў, а не кліенцкі омніканал). У прэв’ю і ў планах: Discord, Slack, Teams, Matrix, Signal, Email і WhatsApp.

[!NOTE] Плагіны ўзроўню 1 не ўбудоўваюцца ў бінарны файл шлюза. Яны ўсталёўваюцца і кантралююцца як асобныя сэрвісы systemd і даступныя па URL, таму кожны з іх мае свой уласны порт.

Tier 2 — унутрыпрацэсныя інструменты/навыкі

Плагіны ўзроўню 2 — гэта інструменты/навыкі, скампіляваныя ў шлюз і запушчаныя ўнутры яго працэсу. Паколькі яны выконваюцца ўнутрыпрацэсна ад імя дзеючага карыстальніка, яны могуць выкарыстоўваць асабістыя або агульныя ўліковыя даныя: асабісты рэжым прыпісвае дзеянне канкрэтнаму чалавеку (яго ўліковыя даныя і атрыбуцыю ходу), агульны рэжым выкарыстоўвае адны ўліковыя даныя на ўсю працоўную прастору.

[!NOTE] Асабістыя інтэграцыі з вонкавымі акаўнтамі (Google, Microsoft, Todoist, Asana, Jira, ClickUp, GitLab, Spotify, Fitbit, Oura, SmartThings і іншыя) пастаўляюцца як Tier 3 без кода — OAuth-інтэграцыі для кожнага карыстальніка, якія кожны карыстальнік падключае да свайго ўласнага акаўнта.

Tier 3 — тыпы крыніц без кода

Плагіны ўзроўню 3 не патрабуюць ніякага інтэграцыйнага кода наогул. Існуе два тыпы крыніц:

OpenAPI — пакажыце на любую спецыфікацыю OpenAPI 3.x, і AiHummer сінтэзуе адзін інструмент на аперацыю.
MCP — падключыце любы сервер MCP праз stdio або HTTP і выставіце яго tools/list.

Абодва ператвараюць існуючы сэрвіс у інструменты агента без таго, каб вы пісалі або разгортвалі які-небудзь код.

Праз механізм OpenAPI з OAuth для кожнага карыстальніка ўжо даступны вялікі набор асабістых інтэграцый — кожны карыстальнік падключае іх да свайго ўласнага акаўнта: Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings і іншыя. Гл. Інтэграцыі без кода для поўнага кіраўніцтва.

Каталог і CDN

Каталог маркетплейса сінхранізуецца з CDN, таму спіс плагінаў, якія можна ўсталяваць, падтрымліваецца ў актуальным стане без ручной упакоўкі з вашага боку. З адмін-інтэрфейсу вы праглядаеце каталог, усталёўваеце ў адзін клік і дазваляеце кожнай усталёўцы аўтаабнаўляцца паводле свайго ўласнага раскладу.

Афіцыйны і супольнасны

Каталог падзелены на два рэестры, якія не змешваюцца:

Official (першапраўны) — модулі ад AiHummer. Крыніца замацаваная і давераная па змаўчанні (правяраецца адносна замацаванага ключа рэестра); у Web-UI гэтыя плагіны нясуць значок Official і займаюць першыя месцы.
Community (іншапраўны) — плагіны ад вонкавых распрацоўшчыкаў, апублікаваныя праз публічны рэестр. Ён дадаецца як асобная крыніца (community-catalog.json), якая не перазапісвае афіцыйны каталог; у спісах гэтыя плагіны паказваюцца без значка і сартуюцца па колькасці спамповак.

Абодва рэестры выкарыстоўваюць той самы кантракт маніфеста і той самы шлях усталявання; яны адрозніваюцца крыніцай і якарам даверу (гл. Усталяванне і абнаўленні).

Куды далей

Усталяванне і абнаўленні — жыццёвы цыкл усталявання ў адзін клік і ізаляваныя юніты systemd.
Plugin SDK — пабудуйце свой уласны плагін з адзінага manifest.json.
Публікацыя плагіна — афіцыйны і супольнасны рэестр, два рэжымы публікацыі.
Інтэграцыі без кода — OpenAPI і MCP падрабязна.