Публікацыя плагіна праз асабісты кабінет

Community-маркетплейс дазваляе любому зарэгістраванаму карыстальніку апублікаваць свой плагін, каб яго змаглі ўсталяваць усе, — гэтак жа, як вы публікуеце дадатак у App Store. Вы запаўняеце метаданыя карткі, дэкларуеце, якія правы патрэбны плагіну, загружаеце зборку і адпраўляеце яе на праверку. Гэтая старонка правядзе вас праз увесь працэс крок за крокам.

[!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 і іншыя рэжымы публікацыі.
Устаноўка і абнаўленні — як карыстальнікі ўсталёўваюць плагіны і як уладкавана мадэль даверу.