命令行界面
直接运行 anyy 会进入 TUI。需要设置、诊断、管理数据或在脚本中只问一次时，可以使用对应的子命令。
进入交互界面
anyy
Anyy 会读取当前 Profile，连接它的常驻 Gateway，然后打开终端界面。也可以在启动前指定 Profile 和新会话使用的 Role：
anyy --profile personal --role research
如果已经知道会话 ID，可以直接恢复：
anyy --resume SESSION_ID
交互命令和快捷键见 TUI。
在脚本中只问一次
anyy chat 不打开 TUI，而是把一条请求发给常驻 Gateway：
anyy chat "整理我现在的任务"
需要沿用已有上下文时加上 --session：
anyy chat --session SESSION_ID "下一步应该做什么？"
脚本应优先使用 --json。涉及状态变更的工具仍遵守当前审批规则；--yes 只对命令明确支持的确认步骤生效。
先确认 Gateway 在线
anyy chat 走的是常驻 Gateway。连接失败时先运行 anyy gateway status。
选对 Profile
全局选择参数要写在子命令前面：
anyy --profile work status
anyy --profile work chat "列出今天的优先事项"
| 参数 | 用途 |
|---|---|
--profile NAME | 选择一个命名 Profile |
--profile-root PATH | 改用另一处 Profile 根目录 |
--role ROLE | 指定新会话的初始 Role |
--home PATH | 让支持该参数的命令直接使用某个 Profile 目录 |
--socket PATH | 在支持时覆盖 Gateway Socket |
--no-color | 关闭终端彩色输出 |
日常使用选择 --profile 即可。--home 与 --socket 更适合诊断或明确的非标准部署。
常用命令分组
| 要做的事 | 命令 |
|---|---|
| 完成设置 | anyy setup、anyy setup model、anyy setup channel |
| 检查状态 | anyy status、anyy doctor、anyy config |
| 管理常驻进程 | anyy gateway start|restart|status|stop |
| 打开网页界面 | anyy dashboard |
| 管理能力 | anyy tools、anyy browser |
| 管理定时工作 | anyy cron、anyy heartbeat status |
| 保护和维护数据 | anyy backup、anyy maintenance |
以当前安装版本的 anyy --help 为准；使用不熟悉的子命令前，先运行 anyy COMMAND --help。
给脚本使用的输出
支持 JSON 的命令可以这样调用：
anyy status --json
anyy backup list --json
anyy heartbeat status --json
JSON 模式输出单个结构化结果，适合程序读取。面向人的输出可能包含颜色、符号和更自然的说明，不应依赖其排版做解析。
常见问题
| 现象 | 处理方法 |
|---|---|
| 打开了错误的数据 | 把 --profile NAME 放在子命令前，再用 anyy status 核对 |
| 单次聊天无法连接 | 先 anyy gateway status，必要时 anyy gateway start |
| 参数不被接受 | 对准确的子命令运行 --help，并非所有参数都是全局参数 |
| 脚本解析排版输出失败 | 改用 --json |
完整命令目录见 CLI 命令参考。