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 工作流讀完後，進入：上下文與配置。