AiHummer
Беларуская▾
УвайсціАсабісты кабінет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплэйс і плагіны/Апублікаванне плагіна

Апублікаванне плагіна

v1.0.x · абноўлена 2026-07-19

Створаны плагін з SDK для убудоўВы можаце апублікаваць гэта ў два шляхі:

  • Прыватна (для сябе) — загрузіць з боку ў ваш экземпляр. Артефакт ніколі пакідае гэта.
  • Супольнасць (для ўсіх) — публікуйце праз ваш асабісты кабінет ў my.aihummer.ru, крамa прыкладанняў стыль: загрузіць зборку, запоўніць старонку крамы, прайсці праверку і яна апынецца ў падпісаны супольнасцю каталог, з якога можна ўсталяваць любую копію.

Аналогія: усталяванне .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. Загрузіце гэта на экземпляр адным з двух спосабаў:
    • Адмін UI → Плагіны → «Загрузіць плагін» — цягнуць звязку; або
    • 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 + кантроль здароўя.

Давер: замацаваны ключ і сховішча даверу

Прыватныя артэфакты павінна быць падпісанаКалі вы загружаеце плагін, падпісаны невядомым ключом, інтэрфейс адміністратара прапануе вам зацвердзіць ключ аўтара у краму даверу экземпляра (адзін клік). Пасля зацвярджэння подпіс правяраецца пры кожнай устаноўцы і абнаўленні.

  • Артыфакты з афіцыйны верыфікаваць крыніцу адносна запіс рэестра замацаваны у ядры — аўтаматычна даверана, без дадатковых крокаў.
  • Салдат Артыфакты правяраюцца па ключах у краме даверу інстанцыі.
  • Непадпісана пакеты адхіляюцца — акрамя рэжыму распрацоўкі для лакальных ітэрацый: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 адключае праверку подпісу і прызначаны толькі для мясцовага развіцця. Ніколі не ўключайце яго на вонкава даступным вузле.

Рэжым супольнасці — публікацыя праз асабісты кабінет

Каб зрабіць убудову даступнай для кожны Напрыклад, апублікуйце яго са свайго асабісты кабінет ў my.aihummer.ru, такім жа чынам, як вы размяшчаеце прыкладанне ў краме прыкладанняў. Вы загружаеце зборку, запаўняеце старонку крамы і адпраўляеце на праверку; спачатку запускаецца аўтаматычная праверка ШІ, затым чалавек-мадэратар прымае канчатковае рашэнне, і пасля зацвярджэння артефакт падпісваецца і публікуецца ў каталагу супольнасці.

Поўны пакрокавы рэкамендацыйны матэрыял знаходзіцца на Адправіць убудовуКаротка:

  1. Стварыць і ўпірацаваць ваш плагін з SDK (aihummer plugin package) — артэфакт гэта падпісана .tar.gz нясячы свой manifest.json.
  2. Адкрыць «Мае ўбудовы» у кабінеце і стварыць прадстаўленне: загрузіць артыфакт, запоўніце захоўваць метададзеныя (імя і апісанні на рускую і англійскую мовы, версія, значок, скрыншоты, катэгорыя, неабавязковая спасылка на донацыю, журнал змяненняў) і абвясціць з’ява здольнасцей.
  3. Адправіць на праверку Аўтаматызаваны Агляд ШІ правярае падачу адносна гэты палітыка агляду (бяспека, манифест правільнасць, поўнасць, змест), тады a чалавечы мадэратар чытае справаздачу і вырашае. Аўтаматызацыя ніколі не публікуе самастойна.
  4. Па зацвярджэнні гэты артэфакт ёсць падпісана і апублікавана на аддзяляць community-catalog.json на CDN. Кожны выпадак, які дадаецца крыніца супольнасці бачыць убудову; ядро давярае ёй праз закрэплены ключ рэестра — крок даверу для кожнага аператара не патрэбны.

[!NOTE] Стары публічны паток публікацыі спынены; паток праз асабісты кабінет вышэй — «Мае плагіны» — цяпер адзіны шлях публікацыі для супольнасці. Супольнасныя ўбудовы бясплатныя; можна дадаць неабавязковую спасылку на ахвяраванне.

[!NOTE] Уласныя плагіны (Айнштэйн, SIP, Bitrix24, pocket-agent, os-client) з’яўляюцца не апублікавана такім чынам — яны перапраўляюць праз уласны CI-пайплайн AiHummer і прызямляюцца ў прыкрыты афіцыйны каталог. Поток асабістага кабінета прызначаны для супольнасць (трэцяя бок) плагіны

Умеранасць

Кожная супольная прапанова праходзіць праз аўтаматызаваная праверка (поўнасць, манифест магчымасцей, подпіс і праверка бяспекі), тады Агляд рызык ШІ, і нарэшце а абавязковы чалавечы агляд камандай AiHummer. Ні аўтаматызацыя, ні ШІ ніколі не публікуюць самастойна — рашэнне заўсёды прымае мадэратар, і нічога не трапляе ў каталог без іх адабрэння. Апублікаваны плагін, які пазней будзе знойдзены як шкоднасны або няспраўны, можа быць адменены і быў выдалены з каталога пры наступнай сінхранізацыі.

Супольнасны каталог як дадатковы крыніца

Супольнасныя ўбудовы публікуюцца ў аддзяляць community-catalog.json гэта робіць не перазапісаць адабраны каталог першай асобы. Экземпляр дадае яго як дадатковы крыніцу ў Плагіны → Крыніцы (альбо POST /v1/admin/modules/catalog/sources). Гл. Устаноўка і абнаўленні і Агляд і ўзроўні.

Жыццёвы цыкл плагіна (App Store)

Гандлёвая пляцоўка працуе як сапраўдны App Store — кожны плагін мае асоба (пастаянны слуг + аўтар), пад якім ён адпраўляецца версіі.

Версіі і абнаўленні

Абнаўленне адпраўляецца як новая версія ужо апублікаванага ўбудовы: той жа слуг, уласны журнал змен, уласны агляд і мадэрацыя. Толькі адзін версія можа знаходзіцца на разглядзе ў любы момант — вы дасылаеце наступную пасля таго, як будзе прынята рашэнне па бягучай. Калі новая версія апублікавана, папярэдняя адзначаецца superseded, і каталог + кожная копія перамяшчаецца на новую.

Запланаванае публікаванне

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

Зняцце з публікацыі

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

Як толькі убудова становіцца непублічнай (прыпыненай або выдаленай са спісу), яе запіс выдаляецца з community-catalog.json, і прыклады спыняць паказваць яго пры наступнай сінхранізацыі.

Аўтарства

Плагін апублікаваны пад ваша імя для паказу (напрыклад, назва вашай студыі) — або ананімнаПублічны каталог і вэб-інтэрфейс паказваюць абраны імя або «Ананім»; ваш сапраўдны электронны адрас/ідэнтыфікатар ніколі не раскрываецца.

Статыстыка распрацоўшчыка

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

Апублікаванае ўзнагароджанне

Для кожны плагін, які вы публікуеце ўпершынюваша падпіска AiHummer атрымлівае адзін бясплатны месяц (прадастаўляецца адзін раз на кожны плагін).

Дзе далей