插件

用插件给 Agent 扩展技能、MCP 服务器与生命周期钩子——安装需显式同意，钩子在本机执行命令，启用前请先审阅。

插件是什么

插件是一个打包的扩展单元：一个插件可以同时带来技能、MCP 服务器与生命周期钩子。与「扩展（MCP）」专指接入工具不同，插件是更完整的组合包——作者把一套能力连同它的配置一起发布，你安装一次即可使用。

在哪里管理

打开 设置 → 插件：

• 安装：从 git URL 安装插件（来源可以是作者仓库或你自己的 fork）；
• 作用域：插件分全局（所有项目可用）与项目（仅当前项目）两种作用域，按需选择；
• 启用 / 停用：每个插件独立开关，停用后其技能与钩子不再生效，配置保留；
• 自动更新：可按插件开关；出于安全考虑默认关闭——更新会带入新代码，建议手动核对变更后再更新。

钩子：插件里最需要留意的部分

生命周期钩子会在特定事件发生时在本机执行命令（例如会话开始前、提交前后）。这是插件能力最强的部分，也是风险最集中的部分：

• 启用插件前，先到其来源仓库审阅钩子脚本的内容——确认它执行什么命令、读写哪些文件、访问哪些网络地址；
• 只安装来源可信的插件；来源不明或无法审阅的插件不要启用。

权限与卸载

• 插件带来的 MCP 工具与扩展一样受「允许 / 询问 / 拒绝」三态管控（见权限与安全）；
• 卸载插件会移除其技能、服务器与钩子，不留监听或残留进程。

下一步

• 插件里的技能怎么用、怎么自己写：见技能。
• 插件接入的 MCP 服务器与单独添加的扩展机制相同：见扩展（MCP）。

本页基于上游开源文档（Apache-2.0）改写，已修改；来源与变更见 /legal/provenance。