{"meta":{"title":"GitHub Copilot CLI 插件参考","intro":"查找 CLI 插件的命令和配置详细信息。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/reference","title":"参考资料"},{"href":"/zh/copilot/reference/copilot-cli-reference","title":"Copilot CLI 参考"},{"href":"/zh/copilot/reference/copilot-cli-reference/cli-plugin-reference","title":"命令行接口 (CLI) 插件参考"}],"documentType":"article"},"body":"# GitHub Copilot CLI 插件参考\n\n查找 CLI 插件的命令和配置详细信息。\n\n> \\[!NOTE]\n> 可以通过在终端中输入 `copilot plugin [SUBCOMMAND] --help` 来查找有关使用插件的帮助。\n\n有关插件是什么以及它们如何跨 Copilot 客户端工作的概述，请参阅 [关于 GitHub Copilot 插件](/zh/copilot/concepts/agents/about-plugins)。\n\n## CLI 命令\n\n可以在终端中使用以下命令来管理插件 Copilot CLI。\n`copilot plugin` 和 `copilot plugins` 可以互换使用——对于子命令，使用读起来更顺的一种即可。\n\n| 命令                                                        | 说明                                                                          |\n| --------------------------------------------------------- | --------------------------------------------------------------------------- |\n| `copilot plugin install SPECIFICATION`                    | 安装插件。 请参阅下面 [`install` 命令的插件规范](#plugin-specification-for-install-command)。 |\n| `copilot plugin uninstall NAME`                           | 删除插件                                                                        |\n| `copilot plugin list`                                     | 列出已安装的插件                                                                    |\n| `copilot plugin update NAME`                              | 更新命名插件。 用于 `--all` 一次性更新所有已安装的插件。                                           |\n| `copilot plugin enable NAME`                              | 启用以前禁用的插件                                                                   |\n| `copilot plugin disable NAME`                             | 在不卸载插件的情况下禁用该插件                                                             |\n| `copilot plugin marketplace add SPECIFICATION`            | 注册商城。 市场自己的名称（从其 `marketplace.json` 清单中）变为其注册密钥-没有设置自定义本地名称的选项。             |\n| `copilot plugin marketplace list`                         | 列出已注册的交易平台                                                                  |\n| `copilot plugin marketplace browse NAME`                  | 浏览应用市场插件                                                                    |\n| `copilot plugin marketplace update [NAME]` （别名 `refresh`） | 重新获取应用市场的插件目录。 省略 `NAME` 以刷新每个已注册市场的目录。                                     |\n| `copilot plugin marketplace remove NAME`                  | 注销市场。 如果仍安装了来自应用市场的插件，则会拒绝；传入 `--force` 以一并卸载这些插件。                          |\n\n以非交互方式，`copilot plugins enable NAME --plugin`、`copilot plugins disable NAME --plugin` 和 `copilot plugins remove NAME --plugin` 都提供相同的启用、禁用和卸载操作。\n`--plugin` 是默认类型，可以省略这三个命令。 有关非交互式 [](/zh/copilot/reference/copilot-cli-reference/cli-command-reference#using-copilot-plugins-list) 和 `--mcp` 类型的信息，请参阅 `--skill`；它们将这些命令扩展到 MCP 服务器和技能。\n\n> \\[!NOTE]\n> 由组织或 MDM 管理策略（`enabledPlugins`、`extraKnownMarketplaces`）固定的插件或应用市场项目无法在本地重新启用、禁用或重新指向——该条目将以托管值为准。               `/plugins` 仪表板会用 `Managed` 标记标出这些行，并拒绝冲突的切换操作。 请参阅“[GitHub Copilot CLI 配置目录](/zh/copilot/reference/copilot-cli-reference/cli-config-dir-reference#mdm-managed-settings)”。\n\n### `install` 命令的插件规范\n\n| Format                      | 示例                           | 说明            |\n| --------------------------- | ---------------------------- | ------------- |\n| Marketplace                 | `plugin@marketplace`         | 来自已注册市场的插件    |\n| GitHub                      | `OWNER/REPO`                 | 存储库的根目录GitHub |\n| GitHub  子目录                 | `OWNER/REPO:PATH/TO/PLUGIN`  | 存储库中的子目录      |\n| Git URL                     | `https://github.com/o/r.git` | 任何 Git 网址     |\n| 本地路径                        |                              |               |\n| `./my-plugin` 或 `/abs/path` | 本地目录                         |               |\n\n### `copilot plugins install` 选项\n\n除了从规范安装插件之外， `copilot plugins install` 还可以通过文件、URL 或目录 `--skill`安装单个技能。 技能安装不是插件安装，也不通过应用市场——有关技能本身的详情，请参阅 [GitHub Copilot CLI 命令参考](/zh/copilot/reference/copilot-cli-reference/cli-command-reference#skills-reference)。\n\n| Option                                                                  | 说明                                               |                                           |\n| ----------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------- |\n| `--plugin`                                                              | 安装插件（默认值）。                                       |                                           |\n| `--skill`                                                               | 从本地路径或 URL 安装技能包。                                |                                           |\n| `--scope SCOPE`                                                         | 对于文件或 URL `--skill`，安装方式为：`user`（默认）或 `project`。 |                                           |\n| `project` 将安装范围限定到当前存储库的 `.github/skills` 目录而不是用户帐户，并且仅适用于文件或 URL 技能安装。 |                                                  |                                           |\n| `--config-dir=DIRECTORY`                                                | 配置目录的路径。 此选项已弃用。 改用 `COPILOT_HOME`。              | <!-- markdownlint-disable-line GHD046 --> |\n\n安装目录会将目录注册为自定义技能源，而不是复制它;安装文件或 URL 会将技能的内容复制到个人或项目技能目录中。\n\nMCP 服务器从由策略配置的注册表中安装，该过程需要身份验证和交互式输入密钥。 请使用 `/plugins` 仪表板（在线模式）或 `/mcp` 斜杠命令来添加 MCP 服务器，而不是使用 `copilot plugins install`。\n\n### `copilot plugins update` 选项\n\n| Option  | 说明         |\n| ------- | ---------- |\n| `--all` | 更新每个已安装的插件 |\n\n第一方插件（即从内置的 `copilot-plugins` 和 `awesome-copilot` 市场安装的插件）会在受信任的工作目录中于每次会话开始时自动更新。 使用 `autoUpdate` 设置（设置为 `false`）或 `COPILOT_AUTO_UPDATE=false` 环境变量禁用此行为。 默认情况下，CI 中也会跳过自动更新。 请参阅“[GitHub Copilot CLI 配置目录](/zh/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)”。\n\n你自己添加的 marketplace 可以通过在其 `extraKnownMarketplaces` 条目上设置 `autoUpdate: true`，选择加入相同的会话启动自动更新。 此选择加入仅适用于交互式会话和 `-p` 会话 - SDK 和服务器会话不会自动更新。 它会遵循你自己的用户设置或受管控的（MDM/服务器）设置，但存储库级 `autoUpdate` 设置会被接受但忽略——它不能为某个市场启用自动更新，也不能将自动更新重定向到该市场。 在同名冲突时，内置的第一方市场项优先生效，其次是托管条目（它会替换整个同名的用户条目，因此如果托管条目中没有 `\"autoUpdate\": true`，就会移除用户的选择启用），最后才是用户自己的条目。 请参阅 [存储库设置](/zh/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson)。\n\n### `copilot plugins marketplace` 子命令\n\n内置默认市场随运行时一起提供，无法删除。\n\n| 子命令                            | 说明                                              |\n| ------------------------------ | ----------------------------------------------- |\n| `list [--json]`                | 列出所有已注册的市场，包括内置的默认市场                            |\n| `add SOURCE`                   | 添加应用市场（`owner/repo`、`owner/repo#ref`、URL 或本地路径） |\n| `remove NAME [--force]`        | 删除应用市场；`--force` 还会卸载从该市场安装的插件                  |\n| `browse NAME [--json]`         | 列出市场目录提供的插件                                     |\n| `update [NAME]` （别名 `refresh`） | 刷新某个市场的插件目录；如果省略 `NAME`，则刷新全部市场的插件目录            |\n\n在交互式模式下，运行 `/plugins marketplace update [NAME]` （别名 `/plugins marketplace refresh`）或在插件仪表板的“市场”选项卡中按 `r` ，刷新每个已注册的市场目录。\n\n## `plugin.json`\n\n所有插件都包含一个插件目录，该目录至少包含一个位于 `plugin.json` 插件目录根目录的清单文件。 请参阅“[为 GitHub Copilot CLI 创建插件](/zh/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)”。\n\n### 必填字段\n\n| 领域     | 类型  | 说明                                                                                                                        |\n| ------ | --- | ------------------------------------------------------------------------------------------------------------------------- |\n| `name` | 字符串 | kebab-case 插件名称（仅限字母、数字和连字符）。 最大 64 个字符。 选择支持[Open Plugin Spec 支持](#open-plugin-spec-support)的插件也可以使用点号（例如 `acme.tools`）。 |\n\n### 可选元数据字段\n\n| 领域                                     | 类型     | 说明                                                                                                |\n| -------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- |\n| `$schema`                              | 字符串    | 将其设置为标准的 Agent Plugins（开放插件规范）v1.0.0 架构 URL，以启用该规范的语义。 请参阅 [开放插件规范支持](#open-plugin-spec-support)。 |\n| `description`                          | 字符串    | 简要说明。 最大 1024 个字符。                                                                                |\n| `version`                              | 字符串    | 语义版本（例如 `1.0.0`， ）。                                                                               |\n| `author`                               | 对象     |                                                                                                   |\n| `name` （必需）、 `email` （可选）、 `url` （可选）。 |        |                                                                                                   |\n| `homepage`                             | 字符串    | 插件主页 URL。                                                                                         |\n| `repository`                           | 字符串    | 源存储库 URL。                                                                                         |\n| `license`                              | 字符串    | 许可证标识符（例如， `MIT`）。                                                                                |\n| `keywords`                             | 字符串\\[] | 搜索关键字。                                                                                            |\n| `category`                             | 字符串    | 插件类别。                                                                                             |\n| `tags`                                 | 字符串\\[] | 其他标记。                                                                                             |\n\n### 组件路径字段\n\n这些命令告知 CLI 在何处查找插件的组件。 所有选项都是可选的。 如果省略，CLI 将使用默认约定。\n\n| 领域           | 类型                     | 默认        | 说明                                                                                                              |\n| ------------ | ---------------------- | --------- | --------------------------------------------------------------------------------------------------------------- |\n| `agents`     | 字符串 \\| 字符串\\[]          | `agents/` | 智能体目录的路径（`.agent.md` 文件）。                                                                                       |\n| `skills`     | 字符串 \\| 字符串\\[]          | `skills/` | 技能目录的路径（`SKILL.md` 文件）。                                                                                         |\n| `commands`   | 字符串 \\| 字符串\\[]          | —         | 命令目录路径。                                                                                                         |\n| `hooks`      | string \\| 对象           | —         | 挂钩配置文件或内联挂钩对象的路径。                                                                                               |\n| `extensions` | 字符串 \\| string\\[] \\| 对象 | —         | 扩展目录的路径。 使用 `{ paths: [...], exclusive: true }` 可禁用内置扩展。 在 [“打开插件规范”模式下](#open-plugin-spec-support)，此字段具有不同的含义。 |\n| `mcpServers` | string \\| 对象           | —         | MCP 配置文件的路径（例如 `.mcp.json`），或内联服务器定义。                                                                           |\n| `lspServers` | string \\| 对象           | —         | 指向 LSP 配置文件的路径，或内联服务器定义。                                                                                        |\n\n### 示例 `plugin.json` 文件\n\n```json copy\n{\n  \"name\": \"my-dev-tools\",\n  \"description\": \"React development utilities\",\n  \"version\": \"1.2.0\",\n  \"author\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\"\n  },\n  \"license\": \"MIT\",\n  \"keywords\": [\"react\", \"frontend\"],\n  \"agents\": \"agents/\",\n  \"skills\": [\"skills/\", \"extra-skills/\"],\n  \"hooks\": \"hooks.json\",\n  \"mcpServers\": \".mcp.json\"\n}\n```\n\n## 开放插件规范支持\n\n在 `$schema` 中声明规范的 `plugin.json`，即可让插件在标准插件加载之外额外支持 [代理插件（开放插件规范）](https://agent-plugins.org) v1.0.0 格式：\n\n### LSP 服务器配置\n\n若要在插件中包含 LSP（语言服务器协议）服务器，请在插件目录中创建`lsp-config/servers.json`文件，或使用该`lspServers`字段指定路径或内联对象`plugin.json`。\n\n示例 `lsp-config/servers.json`（或通过 `lspServers` 在 `plugin.json` 中内联）：\n\n```json\n{\n    \"lspServers\": {\n        \"my-lsp\": {\n            \"command\": \"my-language-server\",\n            \"fileExtensions\": { \".myext\": \"mylang\" }\n        }\n    }\n}\n```\n\n对于跨平台支持，请使用`bash`，而不是`powershell``command`：\n\n```json\n{\n    \"lspServers\": {\n        \"my-lsp\": {\n            \"bash\": \"${PLUGIN_ROOT}/scripts/start-lsp.sh\",\n            \"powershell\": \"${PLUGIN_ROOT}/scripts/start-lsp.ps1\",\n            \"fileExtensions\": { \".myext\": \"mylang\" }\n        }\n    }\n}\n```\n\n| 领域                      | 类型     | 必需 | 说明                                                      |\n| ----------------------- | ------ | -- | ------------------------------------------------------- |\n| `command`               | 字符串    | \\* | 用于启动语言服务器的可执行文件。                                        |\n| `bash`                  | 字符串    | \\* | 用于启动服务器的 Bash 脚本（Linux/macOS）：通过 `bash -c SCRIPT`. 执行 。 |\n| `powershell`            | 字符串    | \\* | 用于启动服务器（Windows;）的 PowerShell 脚本通过 `pwsh -c SCRIPT` 执行。 |\n| `cwd`                   | 字符串    | 否  | 工作目录。 相对于配置文件的绝对路径或相对路径。 支持 `${PLUGIN_ROOT}`。           |\n| `args`                  | 字符串\\[] | 否  | 传递给 `command` 的参数（对 `bash` 和 `powershell` 会被忽略）。        |\n| `env`                   | 对象     | 否  | 在生成服务器时要设置的环境变量。                                        |\n| `fileExtensions`        | 对象     | 是的 | 文件扩展名到语言 ID 的映射（例如 `{ \".ts\": \"typescript\" }`）。          |\n| `rootUri`               | 字符串    | 否  | 项目根目录相对于 git 根目录（默认值：`.`）。                              |\n| `initializationOptions` | 任意     | 否  | 在 LSP `initialize` 请求中发送到服务器的选项。                        |\n\n(\\*) `command`、`bash`或`powershell`中至少有一项为必填项。 如果同时指定了 `bash` 和 `powershell`，则会自动选择适合平台的一个（Windows上的 PowerShell、Bash 其他地方）。\n\n使用 `${PLUGIN_ROOT}` 引用插件目录中的路径。\n\n## `marketplace.json`\n\n可以通过创建一个 `marketplace.json` 文件并将其保存到 `.github/plugin/` 存储库的目录来创建插件市场，供用户用来发现和安装插件。 还可以将 `marketplace.json` 文件存储在本地文件系统中。 例如，将文件保存为 `/PATH/TO/my-marketplace/.github/plugin/marketplace.json` 允许你使用以下命令将其添加到 CLI：\n\n```shell\ncopilot plugin marketplace add /PATH/TO/my-marketplace\n```\n\n> \\[!NOTE]\n> Copilot CLI 还会在 `.claude-plugin/` 目录中查找 `marketplace.json` 文件。\n\n有关详细信息，请参阅“[为 GitHub Copilot CLI 创建插件市场](/zh/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)”。\n\n### 示例 `marketplace.json` 文件\n\n```json copy\n{\n  \"name\": \"my-marketplace\",\n  \"owner\": {\n    \"name\": \"Your Organization\",\n    \"email\": \"plugins@example.com\"\n  },\n  \"metadata\": {\n    \"description\": \"Curated plugins for our team\",\n    \"version\": \"1.0.0\"\n  },\n  \"plugins\": [\n    {\n      \"name\": \"frontend-design\",\n      \"description\": \"Create a professional-looking GUI ...\",\n      \"version\": \"2.1.0\",\n      \"source\": \"./plugins/frontend-design\"\n    },\n    {\n      \"name\": \"security-checks\",\n      \"description\": \"Check for potential security vulnerabilities ...\",\n      \"version\": \"1.3.0\",\n      \"source\": \"./plugins/security-checks\"\n    }\n  ]\n}\n```\n\n> \\[!NOTE]\n> 每个插件的 `source` 字段值是插件目录的路径，相对于存储库的根目录。 不需要在路径的开头使用 `./` 。 例如，`\"./plugins/plugin-name\"` 和 `\"plugins/plugin-name\"` 指向同一目录。\n\n### `marketplace.json` 字段\n\n#### 顶级字段\n\n| 领域                            | 类型  | 必需 | 说明                                                                                   |\n| ----------------------------- | --- | -- | ------------------------------------------------------------------------------------ |\n| `name`                        | 字符串 | 是的 | 串式命名法的市场名称。 最大 64 个字符。 对于 `acme.tools` 插件，也接受使用句点（例如，[](#open-plugin-spec-support)）。 |\n| `owner`                       | 对象  | 是的 |                                                                                      |\n| `{ name, email? }` — 市场所有者信息。 |     |    |                                                                                      |\n| `plugins`                     | 数组  | 是的 | 插件条目列表（请参阅下表）。                                                                       |\n| `metadata`                    | 对象  | 否  | `{ description?, version?, pluginRoot? }`                                            |\n\n#### 插件输入字段（数组中的 `plugins` 对象）\n\n| 领域            | 类型            | 必需 | 说明                                                                                   |\n| ------------- | ------------- | -- | ------------------------------------------------------------------------------------ |\n| `name`        | 字符串           | 是的 | kebab-case 插件名称。 最大 64 个字符。 点号也适用于 [Open Plugin Spec](#open-plugin-spec-support) 插件。 |\n| `source`      | string \\| 对象  | 是的 | 获取插件的途径（相对路径、GitHub 或 URL）。                                                          |\n| `description` | 字符串           | 否  | 插件说明。 最大 1024 个字符。                                                                   |\n| `version`     | 字符串           | 否  | 插件版本。                                                                                |\n| `author`      | 对象            | 否  | `{ name, email?, url? }`                                                             |\n| `homepage`    | 字符串           | 否  | 插件主页 URL。                                                                            |\n| `repository`  | 字符串           | 否  | 源存储库 URL。                                                                            |\n| `license`     | 字符串           | 否  | 许可证标识符。                                                                              |\n| `keywords`    | 字符串\\[]        | 否  | 搜索关键字。                                                                               |\n| `category`    | 字符串           | 否  | 插件类别。                                                                                |\n| `tags`        | 字符串\\[]        | 否  | 其他标记。                                                                                |\n| `commands`    | 字符串 \\| 字符串\\[] | 否  | 命令目录路径。                                                                              |\n| `agents`      | 字符串 \\| 字符串\\[] | 否  | 代理目录路径。                                                                              |\n| `skills`      | 字符串 \\| 字符串\\[] | 否  | 技能目录路径。                                                                              |\n| `hooks`       | string \\| 对象  | 否  | 挂钩配置的路径或内联挂钩对象。                                                                      |\n| `mcpServers`  | string \\| 对象  | 否  | 安装插件时要激活的 MCP 服务器。 接受内联服务器映射，或 JSON 配置文件路径。 当插件源未交付自己的 MCP 配置时使用。                    |\n| `lspServers`  | string \\| 对象  | 否  | LSP 配置或内联服务器定义的路径。                                                                   |\n| `strict`      | 布尔            | 否  | 当 `true`（默认值）时，插件必须符合完整的架构和验证规则。 当 `false` 时，使用宽松验证，允许更大的灵活性，特别是对于直接安装或旧版插件。         |\n\n#### 插件源类型\n\n`source`插件条目上的字段接受相对路径字符串，或描述GitHub存储库或 Git URL 源的对象：\n\n```json\n{\n    \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"owner/repo\",\n        \"ref\": \"v1.0.0\",\n        \"path\": \"plugins/my-plugin\"\n    }\n}\n```\n\n除了`github``url`（或而不是）`sha`外，源类型还接受可选`ref`字段以将安装固定到确切提交：\n\n```json\n{\n    \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"owner/repo\",\n        \"sha\": \"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3\",\n        \"path\": \"plugins/my-plugin\"\n    }\n}\n```\n\n`sha` 必须是完整的 40 个字符的提交 SHA 值。 固定到某个 `sha`，以实现可重现的安装，并且不受强制推送或标签/分支变动的影响。\n\n## 文件位置\n\n| 物品                                                                                                                            | 路径                                                                                                                               |\n| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |\n| 已安装的插件                                                                                                                        |                                                                                                                                  |\n| `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` （通过市场安装）和 `~/.copilot/installed-plugins/_direct/SOURCE-ID/` （直接安装）     |                                                                                                                                  |\n| 市场缓存                                                                                                                          | 平台缓存目录： `~/.cache/copilot/marketplaces/` （Linux）、 `~/Library/Caches/copilot/marketplaces/` （macOS）。 可使用 `COPILOT_CACHE_HOME` 覆盖。 |\n| 插件清单                                                                                                                          |                                                                                                                                  |\n| `.plugin/plugin.json`、 `plugin.json`、 `.github/plugin/plugin.json`或 `.claude-plugin/plugin.json` （按此顺序选中）                     |                                                                                                                                  |\n| 市场清单                                                                                                                          |                                                                                                                                  |\n| `marketplace.json`、 `.plugin/marketplace.json`、 `.github/plugin/marketplace.json`或 `.claude-plugin/marketplace.json` （按此顺序选中） |                                                                                                                                  |\n| Agents                                                                                                                        |                                                                                                                                  |\n| `agents/`（默认值，可在清单中覆盖）                                                                                                        |                                                                                                                                  |\n| 技能                                                                                                                            |                                                                                                                                  |\n| `skills/`（默认值，可在清单中覆盖）                                                                                                        |                                                                                                                                  |\n| 挂钩配置                                                                                                                          |                                                                                                                                  |\n| `hooks.json` 或 `hooks/hooks.json`                                                                                             |                                                                                                                                  |\n| MCP 配置                                                                                                                        |                                                                                                                                  |\n| `.mcp.json`、`.github/mcp.json`                                                                                                |                                                                                                                                  |\n| LSP 配置                                                                                                                        |                                                                                                                                  |\n| `lsp.json` 或 `.github/lsp.json`                                                                                               |                                                                                                                                  |\n| 插件数据                                                                                                                          |                                                                                                                                  |\n| `${COPILOT_PLUGIN_DATA}` （也可提供 `${CLAUDE_PLUGIN_DATA}`）。 指向每个已安装插件唯一的持久可写目录。 将此用于特定于插件的运行时数据，而不是安装插件缓存目录中的路径。                 |                                                                                                                                  |\n\n## 加载顺序和优先级\n\n如果安装多个插件，则某些自定义代理、技能、MCP 服务器或通过 MCP 服务器提供的工具可能具有重复的名称。 在这种情况下，CLI 会根据优先顺序确定要使用的组件。\n\n* **智能体和技能**采用“先找到者优先”的优先级。\n\n  如果项目级自定义代理或技能的名称或 ID 与所安装的插件中的名称或 ID 相同，则插件中的代理或技能将被无提示忽略。 该插件无法替代项目级或个人配置。 自定义代理使用其 ID 删除重复数据，该 ID 派生自其文件名（例如，如果文件命名 `reviewer.agent.md`，则代理 ID 为 `reviewer`）。 技能通过其在 `SKILL.md` 文件中的名称字段进行去重。\n\n* **MCP 服务器** 使用最后胜出优先权。\n\n  如果安装一个插件，该插件使用与已安装的 MCP 服务器相同的服务器名称来定义 MCP 服务器，则插件的定义优先。 可以使用 `--additional-mcp-config` 命令行选项替代使用插件安装的相同名称的 MCP 服务器配置。 如果两个或多个插件声明具有相同名称的 MCP 服务器，CLI 将使用上次加载的插件中的版本，并显示一个警告，命名每个先前定义的插件。\n\n* **内置工具和智能体**始终存在，不能被用户定义的组件覆盖。\n\n下图说明了加载顺序和优先规则。\n\n```text\n┌──────────────────────────────────────────────────────────────────┐\n│  BUILT-IN - HARDCODED, ALWAYS PRESENT                            │\n│  • tools: bash, view, apply_patch, glob, rg, task, ...           │\n│  • agents: explore, task, code-review, general-purpose, research │\n└────────────────────────┬─────────────────────────────────────────┘\n                         │\n  ┌──────────────────────▼──────────────────────────────────────────────┐\n  │  CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID)                 │\n  │  1. ~/.copilot/agents/           (user, .github convention)         │\n  │  2. <project>/.github/agents/    (project)                          │\n  │  3. <parents>/.github/agents/    (inherited, monorepo)              │\n  │  4. <project>/.claude/agents/    (project)                          │\n  │  5. <parents>/.claude/agents/    (inherited, monorepo)              │\n  │  6. PLUGIN: agents/ dirs         (plugin, by install order)         │\n  │  7. Remote org/enterprise agents (remote, via API)                  │\n  └──────────────────────┬──────────────────────────────────────────────┘\n                         │\n  ┌──────────────────────▼──────────────────────────────────────────────┐\n  │  AGENT SKILLS - FIRST LOADED IS USED (dedup by name)                │\n  │  1. <project>/.github/skills/        (project)                      │\n  │  2. <project>/.agents/skills/        (project)                      │\n  │  3. <project>/.claude/skills/        (project)                      │\n  │  4. <parents>/.github/skills/ etc.   (inherited)                    │\n  │  5. ~/.copilot/skills/               (personal-copilot)             │\n  │  6. ~/.agents/skills/                (personal-agents)              │\n  │  7. PLUGIN: skills/ dirs             (plugin)                       │\n  │  8. COPILOT_SKILLS_DIRS env + config (custom)                       │\n  │  --- then commands (.claude/commands/), skills override commands ---│\n  └──────────────────────┬──────────────────────────────────────────────┘\n                         │\n  ┌──────────────────────▼──────────────────────────────────────────────┐\n  │  MCP SERVERS - LAST LOADED IS USED (dedup by server name)           │\n  │  1. ~/.copilot/mcp-config.json       (lowest priority)              │\n  │  2. PLUGIN: MCP configs              (plugins)                      │\n  │  3. --additional-mcp-config flag     (highest priority)             │\n  └─────────────────────────────────────────────────────────────────────┘\n```\n\n## 延伸阅读\n\n* [关于企业管理的插件标准](/zh/copilot/concepts/agents/about-enterprise-plugin-standards)\n* [GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli)\n* [GitHub Copilot CLI 命令参考](/zh/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot 命令行界面编程参考](/zh/copilot/reference/copilot-cli-reference/cli-programmatic-reference)"}