Маълумотномаи CLI

sudo aihummer up
aihummer status

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

# Apply the update
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer license keygen        # generate a signing key
aihummer license sign          # sign a license
aihummer license show          # show the current license

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) or publicly (PR to the catalog)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

Абзори сатри фармони `aihummer` насби host-native-ро идора мекунад: он gateway-ро ба кор меандозад ва навсозӣ мекунад (худи насб тавассути пайванди шахсӣ аз кабинети шахсӣ иҷро мешавад), хидматҳои systemd-ро контрол мекунад, диагностика иҷро мекунад, нусхабардориҳоро коркард мекунад ва литсензияҳоро имзо мекунад. Ин саҳифа ҳар фармонро рӯйхат мекунад. ## Фармонҳо | Фармон | Чӣ кор мекунад | |---|---| | `up` / `install` | Хидмати systemd-и gateway-ро ба кор андозед (`systemctl start`). Ҳеҷ чизро насб намекунад — насбро скрипти насби пайванди шахсӣ иҷро мекунад. | | `update [--check]` | Ба релизи охирин навсозӣ кунед; `--check` танҳо гузориш медиҳад, ки оё навсозӣ дастрас аст. | | `restart` | Хидматҳоро аз нав оғоз кунед. | | `stop` | Хидматҳоро қатъ кунед. | | `logs [svc]` | Логҳоро пайгирӣ кунед; номи хидматро барои филтр гузаронед. | | `status` | Ҳолати хидматро нишон диҳед. | | `doctor` | Диагностика / санҷишҳои саломатиро иҷро кунед. | | `backup [dir]` | Нусхаи захиравӣ созед (ихтиёрӣ ба директорияи ҳадаф). | | `restore <file>` | Аз файли нусхаи захиравӣ барқарор кунед. | | `uninstall [flags]` | Насбро ҳазф кунед (нигаред ба парчамҳои поён). Root талаб мекунад — тавассути `sudo` иҷро кунед. | | `set-password` / `admin-password` | Пароли админи маҳаллиро таъин кунед. | | `license {keygen\|sign\|show}` | Литсензияҳоро идора кунед (тавлиди калид, имзо, нишон додан). | | `loadtest` | Санҷиши боргузориро бар зидди gateway иҷро кунед. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK-и плагин: scaffold, валидатсия, калидҳо, package, имзо ва нашр (хусусӣ/оммавӣ). | | `version` | Версияро чоп кунед. | | `help` | Кӯмакро нишон диҳед. | ### Парчамҳои `uninstall` | Парчам | Таъсир | |---|---| | `--purge` | Инчунин маълумотро ҳазф кунед (ҳазфи пурра). | | `--yes` | Дархости тасдиқро гузаред. | | `--no-backup` | Пеш аз ҳазф нусхаи захиравӣ нагиред. | | `--backup-dir <dir>` | Нусхаи захиравии пеш аз uninstall-ро ба ин директория нависед. | ## Мисолҳои истифода ### Насб ва боло кардан Насбро пайванди шахсӣ аз кабинети шахсӣ иҷро мекунад (нигаред ба [Насб](/tg/v1.0/getting-started/installation)); пас аз он CLI хидматро ба кор меандозад ва месанҷад: ```bash sudo aihummer up aihummer status ``` ### Навсозӣ ```bash # Only check whether a newer release exists aihummer update --check # Apply the update aihummer update ``` ### Контроли хидмат ва логҳо ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Диагностика ```bash aihummer doctor ``` ### Нусхабардорӣ ва барқарорсозӣ ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres манбаи ҳақиқат аст, аммо `AIHUMMER_MASTER_KEY` ва директорияи blob-и > шумо бояд алоҳида нусхабардорӣ шаванд — бидуни калиди master, сирҳои рамзшуда > барқарор шуда наметавонанд. ### Таъини пароли админ ```bash aihummer set-password ``` ### Литсензияҳо ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Санҷиши боргузорӣ ```bash aihummer loadtest ``` ### Плагинҳо ```bash 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) or publicly (PR to the catalog) aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz aihummer plugin publish --public --dir ./my-plugin --key author.key \ --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \ --description "..." --icon https://you.example/icon.svg ``` Барои SDK-и пурра ва ҳар ду реҷаи нашр нигаред ба [SDK-и плагин](/en/v1.0/marketplace/sdk) ва [Нашри плагин](/en/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` root талаб мекунад: `sudo aihummer uninstall`-ро иҷро кунед. Ва > `sudo aihummer uninstall --purge --yes` маълумотро ҳазф мекунад ва дархости > тасдиқро мегузарад — аввал боварӣ ҳосил кунед, ки нусхаи захиравии тасдиқшуда > доред. ## Минбаъд ба куҷо - Танзим кунед, ки CLI чиро насб мекунад: [Тағйирёбандаҳои муҳит](/en/v1.0/reference/env-vars). - Қарор диҳед, ки агент кадом асбобҳоро истифода бурда метавонад: [Каталоги асбобҳо](/en/v1.0/reference/tools-catalog).