团队安装与管理插件
团队管理员从 Marketplace 或本地插件包安装、更新和删除团队插件
团队插件由团队管理员安装和管理，仅对当前团队可见。团队成员可以在工作流、Agent 和工具选择器中使用已经安装的团队插件。
功能边界
团队插件和系统插件相互独立：
- 系统插件由系统管理员统一安装和配置，可以供多个团队使用。
- 团队插件由当前团队的管理员安装，只在当前团队内生效。
- 同一个插件可以同时以系统插件和团队插件的形式存在，工具列表会分别展示两条记录。带“系统”标识的是系统插件，另一条是当前团队安装的插件。
- 团队插件不会继承同 ID 系统插件的密钥、费用、状态、版本或其他配置，需要单独完成配置。
- 团队无法隐藏或修改系统插件的可见性。
团队插件支持更新和删除，没有“即将下线”状态。
使用前准备
开始安装前，请确认：
- 当前账号是团队管理员或团队所有者。普通团队成员可以使用已经安装的插件，无法安装、更新或删除插件。
- 从本地安装时，系统管理员已经开启“团队上传插件”功能。该开关只控制本地上传，关闭后仍可从 Marketplace 安装团队插件。
- 使用 Marketplace 时，部署环境能够访问 FastGPT Marketplace。
- 使用本地安装时，已准备符合 FastGPT 插件包规范的
.pkg文件，或包含多个.pkg文件的.zip文件。
插件开发和打包方式参见系统工具开发指南。
从 Marketplace 安装
- 进入 FastGPT 工作台，打开“工具”页面。
- 点击右上角的“添加插件”，选择“从插件市场安装”。
- 在 Marketplace 中通过名称、来源或分类查找插件。可以启用“只看未安装”筛选。
- 打开插件详情，检查插件说明、版本和所需权限。
- 选择版本并点击“安装”。安装完成后，插件会出现在团队工具列表中。
安装完成后，可以直接在工作流或 Agent 的工具选择器中添加该插件。工具需要密钥或其他运行参数时，首次使用前应先完成对应配置。
上传本地插件包
当“团队上传插件”功能已开启时，可以安装自行开发或通过其他渠道获得的插件包。
- 进入工作台的“工具”页面。
- 点击右上角的“添加插件”，选择“上传插件”。
- 选择一个或多个
.pkg文件，也可以选择包含多个.pkg文件的.zip文件。 - 等待系统上传并解析插件包。
- 检查插件名称、版本、权限和解析结果。解析失败的文件会单独显示错误，可以修复后重试。
- 确认安装。安装完成后，插件会出现在团队工具列表中。
上传和解析只用于预览待安装内容。完成确认后，插件才会正式安装到当前团队。
更新插件
Marketplace 中存在新版本时，插件卡片或详情会显示更新入口。
- 进入团队 Marketplace，找到需要更新的插件。
- 查看新版本说明和权限变化。
- 选择目标版本并执行更新。
- 更新完成后，重新测试引用该插件的工作流和 Agent。
使用本地插件包更新时，重新上传目标版本并确认安装。更新不会自动合并系统插件配置，团队插件仍使用自己的配置。
插件升级可能改变输入输出结构、密钥要求或行为。生产工作流升级前，建议先在测试应用中验证。
删除插件
团队管理员可以从工具卡片或插件详情中删除团队插件。确认删除时需要输入插件名称。
删除会执行以下操作：
- 调用插件服务，删除当前团队来源下的插件安装。
- 撤销当前团队后续运行该插件的权限。
- 从新的工具选择入口中移除该团队插件。
已有工作流和 Agent 节点不会被自动改写。它们再次运行时会因为插件已删除而失败。恢复使用需要重新从 Marketplace 安装，或重新上传插件包。
删除团队插件不会影响同 ID 的系统插件，也不会影响其他团队安装的插件。
识别系统插件与团队插件
当系统和团队安装了同一个插件时：
- 工具列表会同时显示两条记录，团队插件排在系统插件前面。
- 系统插件标题旁会显示“系统”标识，将鼠标移到标识上可以查看说明。
- 工作流和 Agent 会按插件来源保存引用，两条记录可以分别选择和配置。
- 删除团队插件只会删除团队安装版本，系统插件仍然可用。
建议在团队内部约定插件用途，避免在同一应用中混用配置或行为不同的同名插件。
常见问题
为什么没有“添加插件”按钮？
当前账号需要是团队管理员或团队所有者。普通成员只能使用已经安装的团队插件。
为什么没有“上传插件”选项？
系统管理员关闭了“团队上传插件”功能。该开关不影响 Marketplace 安装；如需上传本地插件包，请联系系统管理员开启该功能。
上传成功后为什么还不能使用？
上传后还需要在解析结果中确认安装。插件需要密钥或其他参数时，也需要完成配置后才能正常运行。
删除团队插件会删除系统插件吗？
不会。团队安装和系统安装使用独立来源，删除操作只影响当前团队的安装记录。
团队插件会使用系统插件配置的密钥吗？
不会。团队插件与系统插件完全独立，需要单独配置运行参数和密钥。
安全建议
- 只安装来源可信的插件包，并在安装前检查插件权限。
- 自定义插件接入外部 URL、账号或密钥时，应遵循团队的数据安全规范。
- 升级前检查版本说明，在测试应用中验证输入输出兼容性。
- 删除插件前检查其在工作流和 Agent 中的引用，避免影响线上任务。