CLI 命令参考（规范命令树）

每个操作只有一个规范路径，写作 abx 组 动词。在此之上只有一小组固定的顶层快捷方式，对应最常用的命令。 这组快捷方式写死在代码里：不能通过配置增加、改名或删除，也没有按用户配置的别名表。

顶层命令仅有这些：abx sandbox、abx template、abx config、abx mcp、abx provider、abx create、abx list、abx info、abx kill、abx exec、abx connect、abx upload、abx download、abx run、abx deploy。

abx --help 分三段列出：Command groups（sandbox、template、config、mcp）、Providers（provider）、 Sandbox shortcuts（十个快捷方式，每个都写作 "Same as 'abx …'"）。该列表与本页不一致时，测试会失败。

快捷方式

没有顶层的 abx init 和 abx install：请用 abx template init、abx template install（凭证配置是 abx config init）。

规范命令树

abx
├── sandbox
│   ├── create [DESCRIPTION]            list            info SANDBOX_ID        kill [SANDBOX_ID]
│   ├── exec SANDBOX_ID COMMAND...      connect SANDBOX_ID
│   ├── upload SANDBOX_ID LOCAL REMOTE  download SANDBOX_ID REMOTE LOCAL
│   ├── capabilities SANDBOX_ID
│   ├── files    list | mkdir | mv | rm | search | stat
│   ├── process  list | info | signal            （只查看/控制；启动进程用 exec --background）
│   ├── command  list | run                      （沙箱内服务端注册的具名命令）
│   └── system   env | info | metrics | packages | ports
├── template     init | search | info | list | build | push | create | delete | deploy | install
├── config       init | get | set | list | delete
├── mcp          deploy | install | start | status | stop
└── provider     list | show | info | install | uninstall | update | default | config | doctor | test

abx provider --help 由 Provider 文档负责（见Providers）；本页只涉及固定命令面中的 provider 组本身。

用法行（取自 abx … --help）：

全局选项

-j/--json、-q/--quiet、-v/--verbose、--no-color、--log-level [debug|info|warning|error]、--ci、 --version、-h/--help。它们写在命令之前（abx --json list）。

没有全局 --timeout，也没有 --profile。沙箱生命周期是 abx create 独有的 --timeout SECONDS； 命令超时是 abx exec 的 --timeout SECONDS。

运行命令：abx exec

abx exec SANDBOX_ID -- python --version                 # 等待完成，退出码即远端退出码
abx exec SANDBOX_ID --cwd /app --env DEBUG=1 --timeout 300 -- pytest -q
abx exec SANDBOX_ID --stream -- pip install numpy        # 实时输出 stdout/stderr
abx exec SANDBOX_ID --background -- python -m http.server 8000   # 打印 pid 后立即返回
abx exec SANDBOX_ID "ls /app | wc -l"                    # 单个带引号的参数按命令行处理（支持管道）

-- 之后的命令按原样执行，不经过 shell；单个带引号的参数按命令行解析，仅当含管道或重定向时才套 shell。 需要变量展开时使用 sh -c '...'。后台进程用 abx sandbox process list|info|signal 查看或发信号。

abx connect SANDBOX_ID 打开逐行 REPL：每一行都是一个新进程（cd、导出的变量等状态不会保留），它不是 PTY。

具名命令：abx run / abx sandbox command

只有一种机制：注册在沙箱内服务端的命令（CommandRegistry、GET /commands、POST /commands/{name}）。 它们不写在 template.yaml 里。

abx sandbox command list SANDBOX_ID                                  # 名称、参数、说明
abx run SANDBOX_ID build --arg target=staging --arg n=2              # 等价于 abx sandbox command run
abx run SANDBOX_ID add --json-args '{"x": 1, "y": 2}'                # 带类型的值

字符串结果原样打印，其他值以 JSON 打印（--json 时包装为 {"result": ...}）。命令在服务端执行失败时退出码为 1； 名称不存在退出码为 2；沙箱里没有运行中的服务端时提示 "No SandboxServer reachable" 并以非零退出。

初始化：abx config init

abx config init 默认只询问凭证和区域。两个选项追加配置段：

缺少相应设置时，功能会打印一行指向 abx config init --build 或 abx config init --llm 的提示。 无终端（或带 --yes/--ci）时命令不会提示输入，而是打印等价的 abx config set …。

已移除的写法