Маълумоти CLI

Он aihummer Асбоби сатри фармон идоракунии насби маҳаллӣ дар компютерро таъмин менамояд: он дарвозаеро оғоз ва навсозӣ мекунад (насб худ аз тариқи истиноди насби шахсӣ аз портали ҳисоби шумо иҷро карда мешавад), хидмати systemd дарвозаро назорат мекунад, ташхисҳоро иҷро мекунад, нусхабардориҳоро идора мекунад, танзимоти таъмини назоратро мехонад ва менависад ва иҷозатномаҳоро имзо мекунад. Ин саҳифа тамоми фармонҳоро рӯйхат мекунад.

Фармонҳо

Фармон	Он чӣ мекунад
`up` / `install`	Хидмати системд барои дарвоза оғоз кунед (`systemctl start`). Он ҳеҷ чиз насб намекунад — насб бо скрипти насб аз истиноди шахсии шумо амалӣ мешавад.
`update [--check]`	Навсозӣ ба нашри охирин (имзо санҷида шавад + бинарӣ иваз карда шавад + таҷдиди оғоз); `--check` танҳо ҳисобот медиҳад, ки оё навсозӣ дастрас аст ё не.
`restart`	Хизматрасонии дарвоза (`systemctl restart`).
`stop`	Хизматрасонии дарвозаиро қатъ кунед`systemctl stop`).
`logs [unit] [--no-follow]`	Журналро пайгирии як воҳиди systemd (`journalctl -u`); ба воҳиди гузаргоҳ муқаррар карда мешавад. Флаги `--no-follow` сатрҳои охирини журналро мебарорад ва хотима меёбад; бе он фармон журналро пайгирӣ мекунад.
`status`	Шарҳи умумии насб, ҳолати хидматҳо ва омодагии дарвоза (`/readyz`). Бахши «Компонентҳо» ҳолати воҳидҳои ихтиёрии сайдкарро (ҷустуҷӯ, браузер, шинохти нутқ, синтези нутқ, видео) нишон медиҳад; вақте ки `systemctl` дастнорас аст, вай ростқавлона мегӯяд, ки ҳолат номаълум аст, на «насб нашудааст».
`doctor`	Ташхис бо се хулоса: ҳама хуб аст, бо огоҳиҳо кор мекунад (N), ё мушкилот ёфт шуданд. Санҷишҳои Node.js ва маводи бақайдгирӣ дар флот огоҳӣ мебошанд, на нокомӣ.
`backup [dir]`	`pg_dump` стратегияи заминии PostgreSQL ба файл; вақте ки он гузошта нашавад, директорияи пешфарз истифода мешавад.
`restore <file>`	Барқарор кардани PostgreSQL аз файли дампе, ки тавлид шудааст аз ҷониби `backup`.
`uninstall [flags]`	Насбро хориҷ кунед (нигарида ба парчамҳои зерин). Талаб мекунад root — онро бо иҷро кунед `sudo`.
`set-password` / `admin-password`	Танзим/эҷоди пароли маъмури маҳаллӣ (`[--login admin] [--password X]`).
`settings {set\|get\|list}`	Танзимоти сатҳи назоратиро дар пойгоҳи додаҳо хондан/навиштан — ҳамин тавр тугмаҳои Феҳристи Танзимот аз CLI танзим карда мешаванд ба ҷои `gateway.env`.
`license {keygen\|sign\|show <token>}`	Идора кардани литсензияҳо: тавлиди калид, имзо кардан, рамзкушоӣ + санҷиши нишонаи додашуда.
`loadtest`	Машқҳои боркуниро бар зидди дарвоза иҷро кунед.
`plugin {init\|validate\|keygen\|package\|sign\|publish}`	SDK-и плагин: сохтан, санҷидан, калидҳо, бастабандӣ, имзо кардан ва нашр кардан.
`version`	Нусхаи онро чоп кунед.
`help`	Кӯмак нишон диҳед.

`uninstall` парчамҳо

Парчам	Таъсир
`--purge`	Ҳамчунин маълумотҳоро пурра нест кунед
`--yes`	Паёмномаи тасдиқро гузаред.
`--no-backup`	Пеш аз хориҷ кардан нусхаи эҳтиётӣ нагиранд.
`--backup-dir <dir>`	Нусхаи эҳтиётии пеш аз хориҷсозиро ба ин директория нависед.

Мисолҳои истифода

Насб кунед ва оғоз намоед

Насб тавассути пайванди насби шахсӣ аз портали ҳисоби шумо иҷро мешавад (нигаред Насб); баъд аз он CLI оғоз меёбад ва хидматро тафтиш мекунад:

sudo aihummer up
aihummer status

Навсозӣ

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

Назорати хизматрасонӣ ва сабтҳои лог

Фармудҳо ба воҳиди ягонаи системаи gateway systemd амал мекунанд(AIHUMMER_SERVICE, пешфарз aihummer-gateway); logs Ҳар ягон номи воҳиди systemd-ро қабул мекунад.

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

Ташхис

aihummer doctor

Захира ва барқарорсозӣ

backup мегардад pg_dump аз режими давлатӣ PostgreSQL ба файл restore файлро партоб мекунад.

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

[!TIP] Postgres манбаи ҳақиқат мебошад, аммо шумо AIHUMMER_MASTER_KEY ва луоб Феҳрист бояд алоҳида тавассути нусхабардорӣ поддержка шавад — бе калиди аслӣ, рамзгузорӣ шудааст сиёҳқутҳо барқарор карда намешаванд.

Пароли маъмуриро гузоред

Фармонро қабул мекунад [--login admin] [--password X] ва ниёзҳо AIHUMMER_DATABASE_URL — одатан аз gateway.env вақте ҳамчун корбари насб иҷро мешавад ё тавассути sudo.

sudo aihummer set-password --login admin

Танзимоти сатҳи идора

settings танзимоти каталогро мустақиман дар пойгоҳи додаҳо мехонад ва нависад — ҳамон захирае, ки интерфейси идораи веб (Идоракунӣ → Танзимот) таҳрир мекунад. Ин тавр тугмаҳои каталог аз CLI танзим мешаванд: gateway.env Арзишҳо барои онҳо нодида гирифта мешаванд.

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

settings list танҳо калидҳои каталогеро нишон медиҳад, ки барои корбар пешбинӣ шудаанд (калидҳои системавӣ ва дохилӣ пинҳон карда шудаанд); ҳар як калид бо манбаъаш тамға зада шудааст — [db] барои арзишҳое, ки шумо муқаррар мекунед, [unset] бо ин ки каталог бо режими пешфарз бошад.

Литенсияҳо

license show талаб мекунад <token> муноқиша ва AIHUMMER_LICENSE_PUBKEY муқоисавӣ: он рамзшиканӣ ва тасдиқ мекунад дода token — иҷозатномаи ҷории намуна намоиш дода намешавад.

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

Санҷиши бор

aihummer loadtest

Плагинҳо

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Барои SDK пурра ва барои нашр кардани он дар феҳристи муштарак аз портал («Плагинҳои ман»), нигаред SDK-и васлкунӣ ва Нашр кардани плагин.

[!WARNING] uninstall тапиши решавӣ талаб мекунад: иҷро кунед sudo aihummer uninstall. Ва sudo aihummer uninstall --purge --yes маълумотҳоро ҳазф мекунад ва гузариш мекунад пайдоиши тасдиқ — пеш аз ҳама боварӣ ҳосил кунед, ки нусхаи эҳтиётии тасдиқшуда доред.

Муҳит

Мутағйиршавандаҳо aihummer худ асбоб мехонад:

Тағирёбанда	Мақсад
`AIHUMMER_SERVICE`	Номи воҳиди gateway systemd (стандарти пешфарз `aihummer-gateway`) — ҳадаф `up`/`restart`/`stop`/`logs`.
`AIHUMMER_GATEWAY_URL`	URL-и дарвозаи барои `status`/`doctor`/`loadtest` (афзалиятӣ `http://127.0.0.1:8780`).
`AIHUMMER_DATABASE_URL`	Postgres DSN — лозим аст барои `backup`/`restore`/`set-password`/`settings`.
`AIHUMMER_LANG`	Забони барориш ва роҳнамои CLI: `ru` (пешфарз) ё `en`.

Аксар фармонҳо ба ҳуқуқҳои реша ниёз доранд (systemctl) — онҳоро бо sudo.

Баъд ба куҷо

Инстансро танзим кунед: Муҳити тағйирёбанда.
Қарор гиред, ки агент кадом асбобҳоро истифода карда метавонад: Феҳристи асбобҳо.