安装与管理插件

从市场、Git 仓库或本地安装插件，区分更新、禁用、卸载和托管策略。

This page has not been translated into English yet. The original Chinese version is shown below.

插件把 Skills、Agents、Hooks、MCP 等组件打成可安装包。安装前检查来源和组成，尤其是会运行脚本或连接外部服务的组件。

发现与安装

copilot plugin marketplace list
copilot plugin marketplace browse awesome-copilot
copilot plugin install PLUGIN-NAME@MARKETPLACE-NAME

替换示例中的插件与市场名称。交互会话可以使用 /plugin 面板和 /plugin install。当前插件参考只把 awesome-copilot 作为内置默认市场，不可删除；安装教程仍写 awesome-copilot 与 copilot-plugins 两个默认市场，存在版本差异。

新安装若要使用 github/copilot-plugins，按当前参考显式注册：

copilot plugin marketplace add github/copilot-plugins

旧版本曾使用该市场的安装会进行一次迁移，写入用户 extraKnownMarketplaces 并启用其自动更新。

支持的安装来源

格式	示例
市场条目	plugin@marketplace
GitHub 仓库根	OWNER/REPO
仓库子目录	OWNER/REPO:PATH/TO/PLUGIN
Git URL	https://github.com/OWNER/REPO.git
本地目录	./my-plugin 或绝对路径

用 copilot plugin install SPECIFICATION 安装，copilot plugin list --json 查看结果。JSON 是平坦数组，每项包含 name、enabled、source，以及可选 marketplace、version、installedFrom；旧 { plugins, errors } 结构不再适用。

管理生命周期

copilot plugin update PLUGIN-NAME
copilot plugin update --all
copilot plugin disable PLUGIN-NAME
copilot plugin enable PLUGIN-NAME
copilot plugin uninstall PLUGIN-NAME

禁用保留安装，卸载移除插件。操作使用 manifest 的 name，不使用安装路径。copilot plugins 是复数兼容别名；旧跨资源 --kind / --mcp / --skill 等参数已移除，改用相应 mcp、skill、instruction、lsp 命令。

MDM 或组织固定的条目显示 Managed，不能本地改为冲突值。仓库 enabledPlugins 正在决定启用状态时，终端 enable / disable 会指出控制它的配置文件，而非写入无效的全局覆盖。

更新时机

awesome-copilot 插件在可信工作目录的会话开始时自动更新。autoUpdate: false 或 COPILOT_AUTO_UPDATE=false 可关闭；CI 默认跳过。用户添加的市场可在用户 extraKnownMarketplaces 条目中 opt-in，适用于交互和 -p，不适用于 SDK / server 会话。

仓库级市场 autoUpdate 不会启用或重定向自动更新。同名来源中内置市场优先，其次托管条目，再次个人条目；托管条目整体替换同名用户配置，可能移除个人 opt-in。

本地开发缓存

直接 copilot plugin install ./my-plugin 会缓存组件；改源文件后重新执行安装以刷新。通过本地目录型 marketplace 引用的路径插件则直接读取真实目录，修改后 /restart 或新会话生效，不必 plugin update。这两种本地方式不能混为一谈。

创建格式见插件结构，共享目录见插件市场。

其他客户端的安装方式

插件概念页另列出 cloud agent 在仓库 .github/copilot/settings.json 中通过 enabledPlugins 声明安装；非默认市场通过 extraKnownMarketplaces 添加。Copilot app 从 Customize → Plugins 浏览安装。企业标准见插件标准。

概念页仍将 copilot-plugins 与 awesome-copilot 都列为默认市场，与本页引用的CLI插件参考不同；按具体客户端与版本核对，不能据此删除前述版本差异说明。