CLI 命令参考
查找会话、Run、端点、任务、扩展与 API 的主要命令。
日常命令#
| 命令 | 用途 |
|---|---|
| zioon chat | 交互式聊天。 |
| zioon run PROMPT | 提交任务并跟踪到终态。 |
| zioon attach RUN_ID | 接回某次 Run 的输出。 |
| zioon resume RUN_ID | 恢复可恢复的中断 Run。 |
| zioon abort RUN_ID | 显式停止 Run。 |
| zioon session list / get / transcript | 查看会话与记录。 |
| zioon session fork / attach / watch | 分叉会话或跟踪其运行与事件。 |
| zioon task list / get / run / runs / cancel | 管理已有自动化任务的执行。 |
| zioon auth login / status / logout | 管理命令行登录。 |
| zioon profile list / show | 查看端点配置。 |
| zioon extensions --help | 扩展初始化、发布、安装与调用。 |
| zioon api --help | 使用现有账号发送 JSON API 请求。 |
常用参数#
| 参数 | 作用 |
|---|---|
| --runtime-profile NAME | 选择本地端点配置。 |
| --url URL --account | 以账号登录访问指定 Runtime。 |
| --profile ID | 选择有权限的服务端交互配置。 |
| --model-profile ID | 选择已有模型配置。 |
| --session ID | 在既有会话中提交工作。 |
| --project ID | 选择已经绑定和授权的设备项目。 |
| --preset | read-only、workspace-write 或 trusted-automation。 |
| --tool / --file-root | 进一步限定工具和文件范围，不增加权限。 |
| --jsonl | 输出可解析 JSON Lines。 |
| --raw-events | 读取原始诊断事件。 |
端点配置#
端点配置位于 ~/.zion-next/cli.json。发行版内置正式地址，已有配置覆盖内置默认值。需要开发环境时，把真实地址登记为单独 profile：
端点配置示例
{
"version": 1,
"defaultProfile": "zioon-cloud",
"profiles": {
"dev": {
"url": "http://127.0.0.1:18080",
"auth": { "type": "account" }
}
}
}终端
zioon auth login dev
zioon extensions list --runtime-profile dev配置文件只保存地址和认证方式。自动化工作负载可使用部署已注册的 bearer 环境变量或 token-file profile；账号登录与执行资源授权仍独立。
脚本如何判断结果#
| 退出码 | 含义 |
|---|---|
| 0 | 命令成功；run / attach 的 Run 已完成。 |
| 1 | 命令或 Run 失败。 |
| 2 | Run 中断。 |
| 130 | Run 已停止。 |
检查最终 run.snapshot 的 run.status 与输出。交互式聊天内某轮失败会显示错误，可继续输入。api 的 HTTP 成功不代表返回的 Run 已完成。
最后核对：2026-10-28 · 能力以实际部署与账号权限为准