---
url: /antigravity/plugins.md
description: >-
  了解 Antigravity 2.0 插件（Plugins）的目录结构、清单配置 plugin.json 及其支持的组件（技能包、规则、MCP
  服务器、钩子）与添加方式。
---

# 插件系统 (Plugins)

插件（Plugins）是带命名空间的绑定包。它允许您通过将技能包（skills）、规则（rules）、MCP 服务器以及钩子（hooks）整合进单个数据包，来扩展 Antigravity 的功能。

## 目录结构 (Directory Structure)

如果您想创建自己的插件或检查现有的插件，它们均遵循特定的目录结构。一个插件包含一个 `plugin.json` 标识文件以及代表不同自定义类型的可选子目录：

```
plugins/<plugin-name>/
├── plugin.json       # 必填的插件标识文件
├── mcp_config.json   # 可选：MCP 服务器定义
├── hooks.json        # 可选：钩子定义
├── skills/           # 可选：技能包
│   └── <skill-name>/
│       └── SKILL.md
└── rules/            # 可选：规则
    └── <rule-name>.md
```

### 清单文件 (`plugin.json`)

每个插件的根目录下必须包含一个 `plugin.json` 文件。该文件将该目录标识为一个插件：

```json
{
  "name": "my-custom-plugin"
}
```

`name` 字段是可选的，如果省略，默认使用目录名称。

## 支持的组件 (Supported Components)

插件可以包含以下组件：

* **技能包 (Skills)**：位于 `skills/` 子目录下。每个技能包必须包含一个 `SKILL.md` 文件，其中写入给 Agent 的指令。
* **规则 (Rules)**：位于 `rules/` 子目录下。这些是 Markdown 文件，定义了 Agent 行为的约束或指南。
* **MCP 服务器 (MCP Servers)**：通过插件根目录下的 `mcp_config.json` 进行配置。这允许您将 Antigravity 连接 to 外部工具和服务。
* **钩子 (Hooks)**：通过插件根目录下的 `hooks.json` 进行配置。这允许您在特定事件发生时运行脚本或命令。

## 如何添加插件 (How to Add Plugins)

您可以通过以下两种方式向 Antigravity 添加插件：

### 1. 使用内置插件 (Build with Google)

Antigravity 随附了由 Google 创建的一系列内置插件。您可以直接在用户界面中浏览并添加这些插件：

* 导航至 **Customizations**（自定义）页面。
* 有关可用的 Google 官方插件的更多详细信息，请参阅 [基于 Google 技术构建 (Build with Google Page)](/antigravity/build-with-google)。

### 2. 手动添加插件 (Manually Adding Plugins)

您还可以通过将自定义插件文件夹放置在指定的插件存放路径中来手动添加插件。Antigravity 会自动扫描这些目录来发现并加载您的自定义配置：

* **工作空间级别 (Workspace Level)**：将您的插件文件夹放置在打开的工作空间根目录下的 `.agents/plugins/` 或 `_agents/plugins/` 目录中。这使得该插件仅在此特定工作空间中工作时可用。
* **全局级别 (Global Level)**：将您的插件文件夹放置在用户主目录下的 `~/.gemini/config/plugins/` 目录中。这使得该插件在所有工作空间中均处于活动状态。