Gemini CLI 扩展

Gemini CLI 支持通过扩展来配置和增强其功能。

工作原理

启动时，Gemini CLI 会在以下两个位置查找扩展：

1. <workspace>/.gemini/extensions
2. <home>/.gemini/extensions

Gemini CLI 会加载这两个位置的所有扩展。如果同名的扩展同时存在于两个位置，则工作区目录中的扩展具有优先权。

在每个位置中，每个扩展都是一个包含 gemini-extension.json 文件的目录。例如：

<workspace>/.gemini/extensions/my-extension/gemini-extension.json

gemini-extension.json

gemini-extension.json 文件包含扩展的配置信息，其结构如下：

{
  "name": "my-extension",
  "version": "1.0.0",
  "mcpServers": {
    "my-server": {
      "command": "node my-server.js"
    }
  },
  "contextFileName": "GEMINI.md"
}

• name: 扩展名称。用于唯一标识扩展，应与扩展目录名称一致。
• version: 扩展版本号。
• mcpServers: 配置 MCP 服务器的映射表。键是服务器名称，值是服务器配置。这些服务器会在启动时加载，效果与在 settings.json 文件 中配置的 MCP 服务器相同。如果扩展和 settings.json 文件都配置了同名的 MCP 服务器，则以 settings.json 文件中的定义为准。
• contextFileName: 包含扩展上下文信息的文件名。该文件会从工作区加载上下文。如果未指定此属性但扩展目录中存在 GEMINI.md 文件，则会自动加载该文件。

当 Gemini CLI 启动时，它会加载所有扩展并合并它们的配置。如果存在任何冲突，将以工作区配置为准。