第五节 命令行入口
[!ref] 详解见用户手册「下载、运行与系统要求」节。
命令行版本与桌面版共享同一份会话与配置，互相之间可以接力。
5.1 主子命令
| 命令 | 用途 |
|---|---|
avl tui |
在终端里启动 TUI 版本，与桌面版共享同一份会话 |
avl zagent-tui |
直接启动批处理对话 TUI，适合脚本化驱动 |
avl workspace |
工作区操作 |
avl agent |
一次性 LLM 对话（JSONL 批处理） |
avl skill |
技能管理与签名 |
avl channel |
随行通讯（独立运行 / dry-run / 主 App 回调） |
avl mcp |
外部工具服务连接调试 |
avl install |
在当前目录安装 5 个子命令的入口符号链接 |
tui/zagent-tui由主二进制内置，无需额外安装 zBoxFull 发行包。
5.2 通用参数
| 参数 | 含义 |
|---|---|
| `--workspace <id | path>` |
--config <path> |
显式指定配置目录 |
--log-level <level> |
error / warn / info / debug |
--no-color |
关闭彩色输出 |
-h / --help |
帮助 |
-V / --version |
版本号 |
5.3 退出码
| 码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 通用错误 |
| 2 | 参数错误 |
| 64 | 配置错误 |
| 65 | 数据错误 |
| 69 | 服务不可用 |
| 70 | 软件错误（应反馈） |