套件總覽

此 monorepo 包含兩個主要套件：@google/gemini-cli 和 @google/gemini-cli-core。

`@google/gemini-cli`

這是 Gemini CLI 的主要套件。它負責使用者介面、命令解析，以及所有面向使用者的功能。

當此套件發佈時，會被打包成單一可執行檔。這個 bundle 會包含所有套件的相依套件，包括 @google/gemini-cli-core。這表示無論使用者是透過 npm install -g @google/gemini-cli 安裝套件，還是直接用 npx @google/gemini-cli 執行，都會使用這個單一、獨立的可執行檔。

`@google/gemini-cli-core`

此套件包含與 Gemini API 互動的核心邏輯。它負責發送 API 請求、處理驗證，以及管理本地快取。

這個套件不會被打包。當發佈時，會以標準 Node.js 套件的形式發佈，並包含其自身的相依套件。這讓它可以在其他專案中作為獨立套件使用（如有需要）。所有在 dist 資料夾中的轉譯後 js 程式碼都會包含在套件內。

NPM Workspaces

本專案使用 NPM Workspaces 來管理此 monorepo 內的套件。這讓我們能夠從專案根目錄統一管理相依套件及執行多個套件的腳本，簡化了開發流程。

運作方式

根目錄的 package.json 檔案會定義本專案的 workspace：

{
  "workspaces": ["packages/*"]
}

這告訴 npm，packages 目錄下的每個資料夾都是獨立的套件（package），應作為 workspace 的一部分進行管理。

Workspace 的優點

簡化相依管理：從專案根目錄執行 npm install，會自動安裝 workspace 內所有套件的相依套件，並將它們連結在一起。這表示你不需要在每個套件的目錄下分別執行 npm install。
自動符號連結（symlinks）：workspace 內的套件可以相互依賴。當你執行 npm install 時，npm 會自動在這些套件之間建立符號連結（symlinks）。這代表當你修改某個套件時，其他依賴它的套件可以立即取得最新變更。
簡化腳本（script）執行：你可以透過 --workspace 旗標，從專案根目錄執行任一套件的腳本。例如，若要在 cli 套件中執行 build 腳本，可以執行 npm run build --workspace @google/gemini-cli。