Plugins 是 paradev 生态中的插件管理工具，核心用途是通过 Superset 命令行安装插件、连接插件所需账户，并经凭据代理调用插件的 MCP 工具。
一、主要能力 插件同时提供两类内容：技能（写入代理可读取的目录）和 MCP 工具（经 Superset 代理调用）。安装状态记录在账户上，因此在某处安装后，登录的所有环境均视为已安装；但凭据本身不随安装同步，始终保留在服务端，不会写入本机。
二、使用方式
- 查看现状：superset plugins list 查看已安装插件及其状态；--available 查看市场全部插件；superset skills list 查看本机技能及路径。状态列中 needs connection 表示技能已安装但账户未授权，工具调用会失败，需执行连接步骤。
- 安装：superset plugins install linear；--update 升级到市场当前版本；name@marketplace 用于两个市场存在同名插件时指定来源。安装会记录到账户并在本地生成技能，并提示是否仍需连接。
- 连接账户：插件清单决定方式。OAuth2 类型执行 superset plugins connect linear 后会输出待打开的 URL；需要 API key 等输入时用 --inputs 传 JSON，或通过 stdin 传入（推荐，避免参数暴露在进程列表和 shell 历史中）。OAuth 无法无头完成，需把 URL 交给用户后确认。若插件提供多种方式，命令会列出，应询问用户选择。
- 调用工具：用插件名（来自 plugins list 的 PLUGIN 列）定位，不接受连接 id。参数作为最后一个位置参数传入，- 表示从 stdin 读取。先执行 superset mcp tools --plugin linear 列出工具，再执行 superset mcp call-tool 调用。工具名与参数结构由插件服务器提供，可能随版本变化。调用由 Superset API 发出并附加凭据，因此本机无需 token，受限网络沙箱也可访问。
- 停用与清理：uninstall 卸载并回收该插件生成的技能，不删除同目录手写技能；即使账户调用失败也会本地移除并提示，此时凭据撤销可能未确认，需复查。disable 保留安装但停止生成技能。marketplace 子命令可列出、添加、移除第三方市场。
三、适用场景 适合需要为代理接入外部服务工具（如项目跟踪、错误监控等）、统一管理插件安装与凭据、或在受限网络环境中经代理调用 MCP 工具的用户。
四、限制与注意事项 不要未列出工具就直接调用，以免猜测名称和参数；不要在有 stdin 支持时把密钥作为命令参数；不要把 superset plugins sync 当作连接问题的修复手段；安装会写入用户账户及其所有机器，应先征得用户同意再安装。具体定价、支持平台与版本要求暂未提供。