用途 Superset 的 plugins 命令用于管理插件。一个插件包含两部分：技能（skills，落在代理读取的目录）和 MCP 工具（通过 Superset 代理调用）。插件的安装状态保存在账号上，因此在一处安装后，所有登录该账号的环境都会被视为已安装；凭证则不同，凭证留在服务端，不会写入本机。
主要能力
- 查看插件状态：superset plugins list 列出已安装插件及其状态；superset plugins list --available 列出市场上全部可用插件；superset skills list 列出本机技能及其路径。状态列需要关注，needs connection 表示技能已安装但未授权账号，工具会失败，这属于待连接步骤而非缺陷。
- 安装插件：superset plugins install linear 安装；加 --update 升级到市场当前版本；当两个市场存在同名插件时用 linear@superset 指定市场。安装会把插件记录到账号，并在本地生成其技能，同时提示是否需要连接。
- 连接账号：方式由插件清单决定。oauth2 方式下 superset plugins connect linear 会打印需要打开的 URL；输入凭据方式如 superset plugins connect sentry --inputs '{"api_key":"..."}'，也可通过 stdin 传入（echo '{"api_key":"..."}' | superset plugins connect sentry --inputs -）。真实凭证建议走 stdin，因为命令行参数会出现在 ps 和 shell 历史中。OAuth 无法在无头环境完成，需把 URL 交给用户，再用 superset plugins list 确认。若插件提供多种方式，命令会列出，应询问用户选择而非自行决定。
- 调用工具：按插件名（plugins list 的 PLUGIN 列）寻址，不接受连接 id，因为凭证属于插件指定的连接器，而一个连接器可能支撑多个插件。参数是最后一个位置参数而非选项，- 表示从 stdin 读取。示例：superset mcp tools --plugin linear、superset mcp call-tool list_issues --plugin linear、superset mcp call-tool create_issue --plugin linear '{"team":"ENG","title":"Export 500s"}'。工具名称和参数模式来自插件的服务器，会随版本变化，调用前应先列出工具。调用由 Superset 的 API 发出并附加凭证，因此本机无需令牌，受限网络的沙箱也能调用。
- 关闭与市场管理：superset plugins uninstall linear 卸载并清理其生成的技能；superset plugins disable linear 保留安装但停止生成技能；superset plugins marketplace list、marketplace add owner/repo、marketplace remove <name> 管理第三方市场。卸载只清理插件生成的技能，同目录手写技能不受影响；即使账号调用失败也会在本地移除并提示，此时应阅读提示：凭证撤销是账号移除的一部分，若移除未确认，本机技能已删但连接仍存在，需用 plugins list 检查并再次执行卸载。
失败解读
- plugins list 显示 needs connection：已安装未授权，运行 plugins connect。
- 工具调用返回 401/403：存储的凭证被撤销或过期，重新连接。
- 提示 is not installed：账号上已安装但此处无法解析，运行 plugins install --update。
- 多个市场同名：两次安装共享名称，用 name@marketplace 重新执行。
适用场景与限制 适用于需要通过统一命令安装插件、授权账号并以代理方式调用 MCP 工具的工作流。需注意：调用工具前先列出工具，避免猜测名称与参数；命令支持 stdin 时不要把密钥作为参数；不要把 superset plugins sync 当作修复缺失连接的手段，它只同步本机技能，与凭证无关；不要仅为“看看它做什么”而安装插件，安装会写入用户账号及其使用的每台机器，应先征得同意。