插件

连接外部服务，为任务添加专门的工具。

插件把文档处理、图像生成、外部数据和其他工具接入 EvoX。本页介绍如何选择工具、限定任务范围、调用并验收结果；如果想先了解技能与插件的区别，阅读技能与插件。

了解插件的状态

内置插件、自定义插件和 MCP 服务器在扩展管理界面中管理。找到一个插件后，不要只看它是否“已安装”，还要检查连接状态和可用工具。

• 已安装：插件已加入当前环境，不代表所需账号或服务已经连接。
• 已连接：服务连接已建立，仍需确认它公开了哪些工具。
• 可用或已就绪：完成调用所需的准备；具体任务是否能执行，还受账号权限、文件范围和确认流程限制。
• 不可用：先查看状态信息，排查配置、凭证、进程或网络问题，再重新测试。

图中状态用于说明管理界面，不代表你的设备已经安装或连接了这些插件。

准备可用插件

先按插件与应用连接完成安装、账号连接和工具检查，再回到任务中使用。这里从“工具已经就绪”开始，说明如何交付和检查结果。

核对任务所需连接

调用前确认账号、目标项目或文件夹，以及工具列表是否包含所需操作。连接步骤和凭证字段见插件与应用连接，手动服务器见MCP 服务器。

在任务中使用插件

直接描述任务

说明目标、数据来源和范围，让 EvoX 在当前可用工具中完成工作。例如：

查找已连接文档服务中本周更新的项目记录，整理标题和摘要，保留来源链接。只读取，不修改原文。

如果任务涉及外部写入，把目标和确认点说清楚：

根据这些记录起草一份更新说明，先给我检查，确认后再写入指定文档。

这些是请求方式示例。插件必须实际公开相应的读取或写入工具，才能完成操作。

明确选择插件

协作模式可以从插件列表选择所需插件。会话和编码模式使用该入口与插件声明支持的 @插件 或专用命令调用工具；通过 /mcp 检查服务器状态，调用前核对工具范围。

当多个服务都能处理同类任务时，说明使用哪个连接、哪个项目或文件夹，避免来源含糊。插件被关闭、未连接或缺少凭证时，先修复该连接，再继续任务。

查看 MCP 与技能

/mcp 打开统一的 MCP 状态面板，用于检查服务器及其连接状态。编码模式中的 /skills 进入技能管理。

技能提供可复用的操作方法；MCP 服务器提供可调用工具。它们可配合完成任务，但技能入口不等于插件目录，也不代表已经获得外部服务权限。

区分未安装、已关闭和连接失败

找不到插件工具时，先查看状态，再决定下一步。已经安装但连接失败的插件不需要重新安装。

刷新失败时仍显示的旧状态只说明此前的连接结果。连接恢复后，检查工具列表是否包含本次任务所需的操作，再继续。

权限与数据范围

安装插件不会自动授权所有操作。读取数据、修改数据以及发送或发布内容，是不同的动作，应分别核对。

• 账号范围：插件只能访问已连接账号获得授权的资源，项目归属不会自动赋予账号权限。
• 工具范围：插件只能调用公开的工具；不能因为安装了文档插件，就推断它能控制整个应用。
• 外发范围：调用前确认哪些文本、文件或图片会传到服务端。
• 写入范围：发送、删除、发布、购买和创建远端资产应保留人工确认。

使用图像和语音等插件前，还需检查供应商配置和调用费用，具体参见图像生成和语音。

任务结束后的连接管理

检查产物、写入记录和授权范围，确认没有额外发送或修改。需要停止使用时，按停用与移除处理连接；本地停用与服务端撤销授权分别管理。

排查常见问题

接下来

• 技能与插件：入门概念与使用方式。
• 权限：理解任务执行的确认边界。
• 设置：查找服务与产品配置。