第五节命令行入口

[!ref] 详解见用户手册「下载、运行与系统要求」节。

命令行版本与桌面版共享同一份会话与配置，互相之间可以接力。

桌面主程序（AVLCode，Windows 为 AVLCode.exe）内置终端入口：

命令	用途
`AVLCode tui`	在终端里启动 TUI 版本，与桌面版共享同一份会话
`AVLCode zagent-tui`	直接启动批处理对话 TUI，适合脚本化驱动

CLI 整合二进制（zBoxFull）提供五个服务入口：

命令	用途
`zBoxFull zWorkspace`	工作区服务
`zBoxFull zAgent`	一次性 LLM 对话（JSONL 批处理）
`zBoxFull zSkill`	技能管理与签名（SM2/SM3）
`zBoxFull zChannel`	随行通讯（独立运行 / dry-run / 主 App 回调）
`zBoxFull zMCP`	外部工具服务连接调试
`zBoxFull install`	把五个服务入口的符号链接安装到指定目录，装后可直接以 `zWorkspace` 等短名调用

tui / zagent-tui 由桌面主二进制内置，无需额外安装 zBoxFull 发行包。

参数	含义
`--config <path>` / `-c <path>`	Provider 配置文件路径；缺省时按 `ZAGENT_PROVIDER_CONFIG` 环境变量 → 随包默认配置的顺序解析
`--session <ID>`	恢复指定会话（读回记录并重放）。留空则自动生成新会话 ID；指定的会话不存在 / 已损坏时提示后用该 ID 开新会话（保留你的命名语义）

按键	作用
{{kbd:Enter}}	发送
{{kbd:F2}}	新会话
{{kbd:Esc}} / {{kbd:Ctrl+C}}	运行中：中止 Agent；空闲：退出
{{kbd:y}} / {{kbd:a}} / {{kbd:n}}	Hook 批准挂起时：本次允许 / 永久允许（写工作区批准文件，与桌面端互认）/ 拒绝。{{kbd:Esc}} 同 `n`，30 秒未选自动拒绝

所有命令在本地处理，不会作为普通消息发给模型。

命令	参数	说明
`/goal`	`[<目标> \| budget <N> \| pause \| resume \| complete \| clear]`	会话目标，与桌面端同源；无参数 = 查看当前目标
`/compact`	`[N]`	折叠历史；可保留最近 N 条原文。折叠快照随会话落盘，`/resume` 后仍在
`/sessions`	无	列出当前工作区最近 10 条会话（按更新时间倒序，当前会话标 `*`）。只读
`/resume`	`<会话 ID>`	切换到指定会话。会话 ID 不能含 `?[]/\`；切换失败时原会话完全不变*，只贴一行错误
`/login`	`<user>` / `<user> <password>` / `phone <手机号>`	登录。无参数打印用法；`<user>` 形态下一次 {{kbd:Enter}} 输入密码（不回显、不进聊天历史）；`phone` 走短信验证码，触发风控时图形验证码存成 PNG 并在状态栏给出路径
`/sso`	`[paste <url>]` / `[cancel]`	SSO 登录：起本地回调并显示授权 URL；浏览器回跳受阻时用 `paste` 手工粘回 URL，`cancel` 取消
`/logout`	无	登出
`/usage`	无	查询用量与可用点数（需已登录）
`/redeem`	`<兑换码>`	兑换点券（需已登录）
`/feedback`	`<内容>`	提交反馈（需已登录）
`/attach`	`[<路径> [ro\|rw]]`	会话级沙箱附加。无参数 = 列出当前清单（只读，降级模式下也可用）；相对路径按工作区根解析；mode 缺省为 `ro`；同一路径再次附加以新 mode 覆盖
`/detach`	`<路径>`	解除该路径的附加

/attach 与 /detach 的拒绝口径（与桌面端一致）：路径不存在、文件系统根、工作区内部路径一律拒绝；外部 / 无工具链模式下不支持附加推送。

启动时会拉取并显示公告横幅。状态栏常驻提示当前可用按键与命令，并在右侧显示工具链状态。

第五节 命令行入口