命令行界面参考

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                 # 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

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

这 `aihummer` 命令行工具管理主机本地安装：它启动和更新网关（安装本身是通过您的账户门户的个人安装链接完成的）、控制网关 systemd 服务、运行诊断、处理备份、读取和写入控制平面设置，以及签署许可证。此页面列出了所有命令。 ## 命令 | 命令 | 它的作用 | |---|---| | `up` / `install` | 启动网关 systemd 服务 (`systemctl start`)。它不安装任何东西——安装由您个人链接中的安装脚本完成。 | | `update [--check]` | 更新到最新版本（验证签名 + 替换二进制文件 + 重启）； `--check` 只报告是否有更新可用。 | | `restart` | 重启网关服务（`systemctl restart`). | | `stop` | 停止网关服务(`systemctl stop`). | | `logs [unit] [--no-follow]` | 跟踪一个 systemd 单元的日志（`journalctl -u`); 默认为网关单元。`--no-follow` 打印日志尾部并退出；不带该标志时命令持续跟踪。 | | `status` | 安装概览、服务状态与网关就绪情况（`/readyz`）。**组件** 部分报告可选 sidecar 单元的状态（搜索、浏览器、语音转文字、文字转语音、视频）；当 `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}` | 在数据库中读/写控制平面设置——这是如何从命令行配置设置目录选项的方式，而不是 `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>` | 将卸载前的备份写入此目录。 | ## 使用示例 ### 安装并启动 安装通过您账户门户上的个人安装链接完成（参见 [安装](/zh/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 sudo aihummer update ``` ### 服务控制和日志 这些命令作用于单一的网关 systemd 单元（`AIHUMMER_SERVICE`，默认 `aihummer-gateway`); `logs` 接受任何 systemd 单元名称。 ```bash 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 ``` ### 诊断 ```bash aihummer doctor ``` ### 备份与恢复 `backup` 经营一个 `pg_dump` 将 PostgreSQL 状态平面导出到文件中； `restore` 拿那个转储文件。 ```bash 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`. ```bash sudo aihummer set-password --login admin ``` ### 控制平面设置 `settings` 直接在数据库中读取和写入设置-目录旋钮——与 Web 管理界面（管理 → 设置）编辑的存储相同。这就是如何从命令行界面配置目录旋钮的方法： `gateway.env` 它们的值会被忽略。 ```bash 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` 变量：它解码并验证 **给定** 令牌——它不会显示实例当前的许可证。 ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### 负载测试 ```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 (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 以及如何从门户（“我的插件”）发布到共享目录，请参见 [插件开发工具包](/zh/v1.0/marketplace/sdk) 和 [发布插件](/zh/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` 需要 root：运行 `sudo aihummer uninstall`. 和 > `sudo aihummer uninstall --purge --yes` 删除数据并跳过 > 确认提示 — 请先确保您有经过验证的备份。 ## 环境 变量 `aihummer` 工具本身读取为： | 变量 | 目的 | |---|---| | `AIHUMMER_SERVICE` | 网关 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`。 | 大多数命令需要 root（`systemctl`) — 与它们一起运行 `sudo`. ## 接下来去哪儿 - 配置实例： [环境变量](/zh/v1.0/reference/env-vars). - 决定代理可以使用哪些工具： [工具目录](/zh/v1.0/reference/tools-catalog).