CLI 工作流

CLI 工作流这一组回答“每天怎么用 Gemini CLI”。它不是配置参考，而是把交互式 REPL、一次性 prompt、文件引用、Shell、Web、会话恢复、计划和回滚机制串起来。

学习顺序：先掌握 gemini、-p、@file、!command 和 /help，再进入 session、checkpoint、plan mode。

学习路径

flowchart LR
    Start["启动与参数"] --> Commands["Slash / @ / !"]
    Commands --> Files["文件与 Shell"]
    Files --> Web["Web search / fetch"]
    Web --> Session["Session"]
    Session --> Plan["Plan / Todo"]
    Plan --> Checkpoint["Checkpoint / Rewind"]
    Checkpoint --> Config["上下文与配置"]

    style Commands fill:#dbeafe,stroke:#3b82f6
    style Plan fill:#fef3c7,stroke:#f59e0b
    style Checkpoint fill:#dcfce7,stroke:#22c55e

这个顺序的核心是先学会“怎么和 CLI 交互”，再学会“怎么让它安全做事”。如果直接跳到自动化或 MCP，很容易把权限、上下文和恢复机制混在一起。

日常最小动作

gemini
gemini -p "summarize README.md"
gemini -r "latest" "继续刚才的任务"

交互式会话里常用：

@src/file.ts      把文件放进上下文
!npm test         直接执行 Shell 命令
/help             查看内置命令
/memory reload    重新加载 GEMINI.md 等上下文文件
/mcp list         查看 MCP server

按场景阅读

先把 CLI 用顺

从启动参数、一次性 prompt、slash commands 和快捷键开始。

再接文件与命令

学习 @ 文件引用、Shell 命令、Web search / fetch 的安全边界。

最后控制风险

进入 session、任务规划、checkpoint、rewind 和 Plan mode。

页面清单

页面	解决的问题
CLI reference	`gemini` 参数、prompt、resume、sandbox、输出格式
命令系统	slash commands、`@` 文件引用、`!` Shell
快捷键	清屏、退出、输入模式、shell mode
文件管理	文件上下文、目录、ignore、多目录 workspace
Shell 命令	命令执行、输出截断、高风险边界
Web search / fetch	联网查资料、读取 URL、事实核验
会话与历史	保存、恢复、分享和清理 session
任务规划	计划、todo、验证命令、完成标准
Checkpoint 与 rewind	修改前恢复点、`/restore`、回退边界
Plan mode	只读规划、执行准入、风险审查

下一步

CLI 工作流读完后，进入：上下文与配置。