核心

Gemini CLI 的核心套件 (packages/core) 是 Gemini CLI 的後端部分，負責處理與 Gemini API 的通訊、管理工具，以及處理從 packages/cli 傳送過來的請求。有關 Gemini CLI 的總覽，請參閱主要文件頁面。

瀏覽本節

Gemini CLI 的 packages/cli 部分提供使用者介面，而 packages/core 則負責：

與 Gemini API 互動： 安全地與 Google Gemini API 通訊，傳送使用者提示，並接收模型回應。
提示詞工程： 為 Gemini 模型建構有效的提示，可能包含對話歷史、工具定義，以及來自 GEMINI.md 檔案的指令脈絡。
工具管理與協調：
- 註冊可用工具（例如，檔案系統工具、shell 指令執行）。
- 解讀來自 Gemini 模型的工具使用請求。
- 使用提供的參數執行請求的工具。
- 將工具執行結果返回給 Gemini 模型以進行後續處理。
會話與狀態管理： 追蹤對話狀態，包括歷史記錄和任何連貫互動所需的相關脈絡。
設定： 管理核心特定的設定，例如 API 金鑰存取、模型選擇和工具設定。

核心在安全性方面扮演著至關重要的角色：

API 金鑰管理： 它處理 GEMINI_API_KEY，並確保在與 Gemini API 通訊時安全地使用它。
工具執行： 當工具與本機系統互動時（例如 run_shell_command），核心（及其底層工具實作）必須謹慎行事，通常會涉及沙箱機制以防止意外的修改。

為確保長時間的對話不會超過 Gemini 模型的 token 限制，核心包含了一個聊天歷史壓縮功能。

當對話接近設定模型的 token 限制時，核心會在將對話歷史傳送給模型之前自動進行壓縮。這種壓縮設計上在傳達的資訊方面是無損的，但它減少了使用的 token 總數。您可以在 Google AI 文件中找到每個模型的 token 限制。

Gemini CLI 包含一個模型備援機制，以確保即使預設的「pro」模型受到速率限制，您仍然可以繼續使用 CLI。

如果您正在使用預設的「pro」模型，且 CLI 偵測到您正受到速率限制，它會自動在當前會話中切換到「flash」模型。這讓您可以在不受干擾的情況下繼續工作。

檔案探索服務負責在專案中尋找與當前脈絡相關的檔案。它被 @ 指令以及其他需要存取檔案的工具所使用。

記憶體探索服務負責尋找並載入為模型提供脈絡的 GEMINI.md 檔案。它以階層方式搜尋這些檔案，從目前的工作目錄開始，向上移動到專案根目錄和使用者的家目錄。它也會在子目錄中搜尋。

這讓您可以擁有全域、專案層級和元件層級的脈絡檔案，這些檔案會被結合起來，為模型提供最相關的資訊。您可以使用 /memory 指令來 show（顯示）、add（新增）和 refresh（重新整理）已載入的 GEMINI.md 檔案內容。