⚡

Gemini配置管理Skill gemini-config-management

这个技能用于管理Google Gemini CLI工具的配置设置，包括全局和项目级别的settings.json文件、受信任文件夹安全策略、策略引擎规则以及环境变量覆盖。它帮助用户配置、管理和故障排除Gemini CLI的配置，确保安全和高效的运行。关键词：Gemini配置管理, settings.json配置, 受信任文件夹, 安全策略, 配置优先级, 环境变量。

DevOps 0 次安装 0 次浏览 更新于 3/11/2026

name: gemini-config-management description: 配置Google Gemini CLI的专家指南。涵盖全局与项目settings.json、受信任文件夹、策略引擎和环境变量。在配置Gemini设置、管理受信任文件夹、设置安全策略或故障排除配置优先级时使用。委托给gemini-cli-docs获取官方参考。 allowed-tools: 读取, 全局搜索, Grep, 技能

Gemini配置管理

🚨 强制要求：首先调用gemini-cli-docs

停止 - 在提供任何关于Gemini配置的响应之前：

  1. 调用 gemini-cli-docs 技能
  2. 查询 特定的配置主题（例如，“受信任文件夹”、“settings.json架构”）
  3. 基于 所有响应完全依赖于加载的官方文档

跳过此步骤将导致过时或不正确的信息。

概述

管理Google Gemini CLI配置的专家技能。它处理设置的层次结构、安全策略和环境覆盖。

何时使用此技能

关键词： gemini配置, settings.json, .gemini文件夹, 受信任文件夹, 文件夹信任, 安全策略, 环境变量, 范围, 全局设置, 项目设置, 遥测, UI配置

在以下情况下使用此技能：

  • 配置 settings.json（全局 ~/.gemini/settings.json 或项目 .gemini/settings.json）
  • 管理 受信任文件夹（security.folderTrust.enabled）
  • 设置 策略引擎 规则
  • 配置 UI与遥测（鼠标支持、粘性标题、禁用遥测）
  • 故障排除配置优先级（用户 > 项目 > 默认）
  • 配置代理设置或网络行为

配置范围

Gemini CLI使用级联配置系统：

  1. 全局范围： ~/.gemini/settings.json（用户范围的默认值）
  2. 项目范围： .gemini/settings.json（每个项目的覆盖）
  3. 环境变量： GEMINI_*（运行时覆盖）

受信任文件夹安全

受信任文件夹 功能是一个关键的安全边界。

  • 启用方式： 在 settings.json 中设置 "security.folderTrust.enabled": true。
  • 状态：
    • 受信任： 完全访问（MCP、扩展、shell执行）。
    • 不受信任： 受限的“安全模式”（无shell、无MCP、只读）。
  • 存储： 决策保存在 ~/.gemini/trustedFolders.json。

关键词注册表（委托给gemini-cli-docs）

主题 查询关键词
设置架构 settings.json schema, configuration options
受信任文件夹 trusted folders, folder trust, safe mode
策略引擎 policy engine, execution policies, allow list
网络 proxy settings, network configuration, timeout
UI与遥测 telemetry configuration, mouse support, sticky headers

快速决策树

你想做什么？

  1. 启用受信任文件夹 -> 查询 gemini-cli-docs：“启用受信任文件夹设置”
  2. 编辑全局设置 -> 查询 gemini-cli-docs：“全局settings.json位置”
  3. 项目覆盖 -> 查询 gemini-cli-docs：“项目特定设置 .gemini”
  4. 配置UI/遥测 -> 查询 gemini-cli-docs：“遥测配置设置”
  5. 调试配置 -> 查询 gemini-cli-docs：“调试配置加载”

故障排除

问题： “我的设置没有应用。” 检查： 文件夹是否受信任？如果不受信任，项目设置被忽略。 操作： 运行 /permissions 检查信任状态。

测试场景

场景1：全局设置

查询：“Gemini CLI全局设置文件在哪里？” 预期行为：

  • 技能在“settings.json”或“全局设置”上激活
  • 提供 ~/.gemini/settings.json 路径 成功标准：用户收到正确的路径和配置选项

场景2：受信任文件夹

查询：“如何在Gemini CLI中启用受信任文件夹？” 预期行为：

  • 技能在“受信任文件夹”上激活
  • 委托给gemini-cli-docs获取安全设置 成功标准：用户收到security.folderTrust配置

场景3：配置调试

查询：“我的Gemini设置没有应用，如何调试？” 预期行为：

  • 技能在“设置未应用”上激活
  • 检查信任状态建议 成功标准：用户收到故障排除步骤，包括 /permissions 检查

参考

官方文档： 查询 gemini-cli-docs 获取：

  • “配置”
  • “受信任文件夹”
  • “策略引擎”

版本历史

  • v1.1.0 (2025-12-01)：添加测试场景部分
  • v1.0.0 (2025-11-25)：初始发布