用途：把编码、代码审查、诊断、规划和结构化输出任务委派给独立的 Gemini 会话执行，适合自动化脚本或上层 agent 调用。
主要能力：Gemini CLI 默认是交互式 REPL，自动化走 headless 模式（non-TTY 环境或显式传 -p/--prompt）。可配合 --output-format json 拿到可解析的单对象结果（含 response、session_id、stats、error），或用 stream-json 输出 JSONL 事件流（init、message、tool_use、tool_result、error、result）。会话可用 -r latest 或 -r "<session-id>" 续接，--list-sessions / --delete-session 管理本地会话。
必要用法：新建会话示例 gemini -p "任务" --output-format json --approval-mode auto_edit --model pro；续接最近会话用 -r latest；继续指定会话用 -r "<session-id>" 或 --resume 5。管道输入有两种写法：cat logs.txt | gemini -p "..." 或 cat prompt.md | gemini --output-format json（不传 -p，让 non-TTY 管道触发 headless）。
常用参数：-p 强制非交互；-o json/stream-json/text；-m 可选 auto/pro/flash/flash-lite；--approval-mode 分 default/auto_edit/yolo/plan；--include-directories 追加目录；--sandbox 沙箱；--worktree 为实验特性。退出码：0 成功、1 通用错误或 API 失败、42 输入错误、53 超过 turn 上限。
适用场景：复杂编码用 pro + auto_edit；只读分析/代码审查用 plan；快速问答用 flash-lite；工具链消费事件流用 stream-json。
限制与注意：自动化应显式传 --model 与 --approval-mode，否则默认 auto 会漂移、default 会卡在确认提示；不要用已废弃的 --yolo、--allowed-tools；不要用位置参数传 prompt。前置条件、认证方式、具体模型 ID 及部分实验特性细节资料未完全展开，使用前需自行确认环境。