输出契约
| 通道 | 内容 |
|---|---|
| stdout | 默认输出人类可读文本；加 -o json 出美化 JSON、-c/--compact 出紧凑单行 JSON，供脚本解析。logs、exec 始终直出原始文本/退出码。 |
| stderr | 只放提示、进度、错误信息。 |
| 退出码 | 0 成功 · 1 业务错误 · 2 未登录/令牌失效 · 3 网络不可达 |
人直接看默认文本即可；脚本里加 -o json 喂解析器，stderr 留作日志：
nae apps -o json 2>/dev/null | jq '.[].AppID'
退出码可直接驱动控制流：
nae whoami >/dev/null 2>&1 || echo "令牌无效，需重新登录" >&2
本文档各命令的「返回示例」展示的是
-o json的结构；默认text形态是同一份数据的人类可读呈现。
全局选项
| 选项 | 说明 |
|---|---|
-o, --output <format> |
输出格式：text（默认，人类可读）/ json |
-c, --compact |
紧凑 JSON（单行，隐含 -o json，便于逐行处理） |
--base-url <url> |
覆盖平台地址（亦可 NAE_BASE_URL） |
--token <token> |
覆盖访问令牌（亦可 NAE_TOKEN） |