CLI nuoroda

sudo aihummer up
aihummer status

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

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # vartų vieneto žurnalas (numatytasis; seka toliau)
aihummer logs --no-follow     # išspausdinti žurnalo pabaigą ir išeiti
aihummer logs aihummer-stt    # kito systemd vieneto žurnalas
sudo aihummer stop

aihummer doctor

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

sudo aihummer set-password --login admin

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

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

Tas `aihummer` Komandinės eilutės įrankis valdo pagrindinę šeimininko diegimą: jis paleidžia ir atnaujina vartus (pats diegimas atliekamas naudojant asmeninę diegimo nuorodą iš jūsų paskyros portalo), valdo gateway systemd paslaugą, vykdo diagnostiką, tvarko atsargines kopijas, skaito ir rašo kontrolės plokštės nustatymus bei pasirašo licencijas. Šiame puslapyje pateikiami visi komandos. ## Komandos | Komanda | Ką tai daro | |---|---| | `up` / `install` | Paleiskite gateway systemd paslaugą (`systemctl start`). Nieko neįdiegia — diegimą atlieka diegimo scenarijus iš jūsų asmeninės nuorodos. | | `update [--check]` | Atnaujinkite į naujausią versiją (patikrinkite parašą + pakeiskite binarinį failą + perkraukite); `--check` tėra praneša, ar yra atnaujinimas. | | `restart` | Paleiskite iš naujo tinklo vartų paslaugą (`systemctl restart`). | | `stop` | Sustabdykite vartų paslaugą (`systemctl stop`). | | `logs [unit] [--no-follow]` | Sekite vieno systemd vieneto žurnalą (`journalctl -u`); pagal numatytuosius nustatymus nustatyta į šliuzo įrenginį. `--no-follow` išspausdina žurnalo pabaigą ir išeina; be vėliavėlės komanda seka toliau. | | `status` | Įdiegimo apžvalga, paslaugų būsena ir vartų parengtis (`/readyz`). Skiltis **Komponentai** praneša neprivalomų šoninių vienetų būseną (paieška, naršyklė, kalbos atpažinimas, kalbos sintezė, vaizdo įrašas); kai `systemctl` neprieinamas, sąžiningai sakoma, kad būsena nežinoma, o ne „neįdiegta“. | | `doctor` | Diagnostika su trimis verdiktais: viskas gerai, veikia su įspėjimais (N) arba rasta problemų. Node.js ir registracijos medžiagos patikros yra įspėjimai, o ne klaidos. | | `backup [dir]` | `pg_dump` PostgreSQL valstybės plokštuma į failą; numatytoji direktorija naudojama, kai ji nepateikiama. | | `restore <file>` | Atkurkite PostgreSQL iš sukaupto failo, sugeneruoto `backup`. | | `uninstall [flags]` | Pašalinkite diegimą (žr. toliau pateiktus žymėjimus). Reikalingos root teisės – paleiskite tai su `sudo`. | | `set-password` / `admin-password` | Nustatyti/sugeneruoti vietinio administratoriaus slaptažodį (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Skaityti/rašyti valdymo plokštės nustatymus duomenų bazėje — taip nustatymai katalogo valdikliai yra konfigūruojami iš CLI vietoje `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Valdyti licencijas: generuoti raktą, pasirašyti, dekoduoti ir patikrinti duotą žetoną. | | `loadtest` | Paleiskite apkrovos testą prieš vartus. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Papildinio SDK: sukurti karkasą, patikrinti, raktai, paketas, pasirašyti ir paskelbti. | | `version` | Išspausdinkite versiją. | | `help` | Rodyti pagalbą. | ### `uninstall` vėliavos | Vėliava | Poveikis | |---|---| | `--purge` | Taip pat pašalinkite duomenis (visiškas pašalinimas). | | `--yes` | Praleiskite patvirtinimo raginimą. | | `--no-backup` | Nepadarykite atsarginės kopijos prieš pašalindami. | | `--backup-dir <dir>` | Užrašykite prieš pašalinimą sukurtą atsarginę kopiją į šį katalogą. | ## Naudojimo pavyzdžiai ### Įdiegti ir paleisti Įdiegimas atliekamas naudojant asmeninę diegimo nuorodą iš jūsų paskyros portalo (žr. [Įdiegimas](/lt/v1.0/getting-started/installation)); po to CLI startuoja ir tikrina paslaugą: ```bash sudo aihummer up aihummer status ``` ### Atnaujinti ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Paslaugų valdymas ir žurnalai Komandos veikia vienoje vartų systemd vieneto`AIHUMMER_SERVICE`, numatytoji `aihummer-gateway`); `logs` priima bet kurį systemd vieneto pavadinimą. ```bash sudo aihummer restart aihummer logs # vartų vieneto žurnalas (numatytasis; seka toliau) aihummer logs --no-follow # išspausdinti žurnalo pabaigą ir išeiti aihummer logs aihummer-stt # kito systemd vieneto žurnalas sudo aihummer stop ``` ### Diagnostika ```bash aihummer doctor ``` ### Atsarginė kopija ir atkūrimas `backup` vykdo `pg_dump` iš PostgreSQL valstybės plokštumos į failą; `restore` paima tą išmetimo failą. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres yra tiesos šaltinis, bet jūsų `AIHUMMER_MASTER_KEY` ir kriaukšlė > katalogas turi būti atsarginis atskirai – be pagrindinio rakto, užšifruotas > paslapčių neįmanoma susigrąžinti. ### Nustatykite administratoriaus slaptažodį Komanda priima `[--login admin] [--password X]` ir poreikius `AIHUMMER_DATABASE_URL` — paprastai paimta iš `gateway.env` kai vykdoma kaip diegimo vartotojas arba per `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Valdymo plokštės nustatymai `settings` tiesiogiai skaito ir rašo Settings-catalog valdiklius duomenų bazėje — toje pačioje saugykloje, kurią redaguoja žiniatinklio administratoriaus sąsaja (Management → Settings). Štai kaip katalogo valdikliai konfigūruojami iš CLI: `gateway.env` vertės jiems yra ignoruojamos. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` rodo tik naudotojui matomus katalogo raktus (sistemos ir vidaus raktai slepiami); kiekvienas raktas pažymėtas jo šaltiniu — `[db]` už nustatytas reikšmes, `[unset]` priešingu atveju pagal katalogo numatytuosius nustatymus. ### Licencijos `license show` reikalauja `<token>` argumentas ir `AIHUMMER_LICENSE_PUBKEY` kintamasis: jis dekoduoja ir patikrina **duotas** žetonas — jis nerodo esamos instancijos licencijos. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Krovimo testas ```bash aihummer loadtest ``` ### Įskiepiai ```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 (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 ``` Pilnajam SDK ir publikavimui į bendrą katalogą iš portalo („Mano įskiepiai“), žr. [Įskiepio SDK](/lt/v1.0/marketplace/sdk) ir [Įskiepio publikavimas](/lt/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` reikalauja teisių root: paleisti `sudo aihummer uninstall`. Ir > `sudo aihummer uninstall --purge --yes` pašalina duomenis ir praleidžia > patvirtinimo raginimas – įsitikinkite, kad turite patikrintą atsarginę kopiją. ## Aplinka Kintamieji `aihummer` įrankis pats skaito: | Kintamasis | Tikslas | |---|---| | `AIHUMMER_SERVICE` | Vartų systemd vieneto pavadinimas (numatytasis `aihummer-gateway`) — taikinys `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Šliuzo URL adresas `status`/`doctor`/`loadtest` (numatytoji `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — reikalingas pagal `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI išvesties ir žinyno kalba: `ru` (numatytoji) arba `en`. | Daugumai komandų reikia šaknies („`systemctl`) — vykdykite juos su `sudo`. ## Kur toliau - Sukonfigūruokite egzempliorių: [Aplinkos kintamieji](/lt/v1.0/reference/env-vars). - Nuspręskite, kokius įrankius agentas gali naudoti: [Įrankių katalogas](/lt/v1.0/reference/tools-catalog).