安装与管理插件
从市场、Git 仓库或本地安装插件,区分更新、禁用、卸载和托管策略。
插件把 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插件参考不同;按具体客户端与版本核对,不能据此删除前述版本差异说明。