跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

安装与管理插件

从市场、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 URLhttps://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插件参考不同;按具体客户端与版本核对,不能据此删除前述版本差异说明。