Trusted folders

你是 Gemini CLI 信任資料夾顧問。

【角色】
Gemini CLI 信任資料夾顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。

【輸入】
- 我要處理的專案來源（自有 / 團隊 / 第三方）：___
- 專案裡是否有可執行指令碼 / 設定：___
- 對安全的要求：___
- 是否多人共用環境：___
- 經驗水平：___

【工作流程】
1. 說明信任資料夾的作用和風險
2. 判斷哪些目錄該信任
3. 對來源不明的專案保持不信任
4. 給設定和審查方式
5. 給安全建議

【輸出規範】
▌一、信任機制說明
▌二、該 / 不該信任的目錄
▌三、設定與審查
▌四、安全建議

【硬約束】
- 來源不明的專案預設不信任
- 信任前審查專案裡的指令碼和設定
- 信任範圍最小必要，不全開
- 不要替我臆測情況或編造不存在的設定項，資訊不全先問清
- 不確定的設定或欄位一律以官方文件為準，禁止照搬過時寫法

Trusted folders 用來處理 Gemini CLI 對目前 workspace 的信任判斷。CLI 引數裡也有 --skip-trust，可跳過目前 workspace 的 trust check。

啟用方式

Trusted folders 預設關閉。要啟用，在使用者級 settings.json 中加入：

{
  "security": {
    "folderTrust": {
      "enabled": true
    }
  }
}

啟用後，第一次進入目錄會出現 trust dialog。可選項通常包括信任目前目錄、信任父目錄，或不信任。決定會寫入 ~/.gemini/trustedFolders.json。

如果使用 IDE integration，IDE 的 trust signal 會優先於本地 trust 檔案。這意味著 VS Code 工作區的信任狀態可能影響 Gemini CLI 是否進入受限模式。教學裡同時講 IDE 和 CLI 時，要把這條邊界寫清楚。

Discovery 會顯示什麼

在你做信任決定前，Gemini CLI 會掃描目前 workspace 的潛在設定，並在 dialog 中提示：

• custom commands。
• MCP servers。
• hooks。
• local skills。
• workspace settings overrides。
• 高風險設定警告，例如自動批准工具或關閉 sandbox。
• 設定解析錯誤，例如 malformed settings.json。

這一步的價值是讓你知道“信任後會載入什麼”，而不是盲目點確認。

適合信任的目錄

• 你自己的專案儲存庫。
• 已經清楚檔案結構和敏感邊界的目錄。
• 已經設定 .geminiignore 的專案。
• 低風險 demo 專案。

不適合直接信任

• 下載來的陌生程式碼。
• 含生產金鑰或客戶資料的目錄。
• 大量未知指令碼目錄。
• 不受版本控制的臨時資料夾。

建議

第一次進入新專案時，先只讀分析。確認目錄邊界後，再考慮信任和更高許可權。

不信任時的限制

不信任目錄時，Gemini CLI 會進入受限 safe mode：不會載入專案 .gemini/settings.json，不會載入專案 .env，不會連線專案 MCP server，不載入自定義命令，extension 管理受限，自動 memory loading 關閉，並且工具 auto-acceptance 不生效。

這也是 trusted folders 的核心價值：它不是“允許 Gemini 讀目前資料夾”這麼簡單，而是決定是否載入工作區提供的可執行能力。陌生儲存庫裡最危險的往往不是 Markdown，而是 hooks、MCP server、自動批准工具和專案級 settings。

CI 和 headless

CI 沒法彈出 trust dialog。如果啟用了 Folder Trust 而 workspace 未被信任，CLI 會退出。自動化環境可以臨時使用：

gemini --skip-trust

或設定：

GEMINI_CLI_TRUST_WORKSPACE=true

這類跳過只應該用於你已經控制的 CI workspace，不應該出現在普通本地教學的預設命令裡。

驗收方式

先在一個 demo 目錄啟用 trust，確認 ~/.gemini/trustedFolders.json 出現記錄。再在一個未信任目錄放入測試 MCP 或 custom command，確認 Gemini CLI 不載入它。最後透過 /permissions 修改目前目錄 trust 決策，驗證團隊文件中的恢復路徑可用。

如果團隊文件建議信任父目錄，要額外列出影響面。信任 monorepo 根目錄會覆蓋多個 package；信任某個 app 子目錄則隻影響目前 app。商業專案裡預設優先信任最小目錄，除非你明確需要根層 commands、MCP 或 settings。

接下來去哪

官方來源

• Gemini CLI trusted folders