用途:对当前编码代理主机执行只读健康检查,诊断 Spotify Portal 插件、CLI、认证与操作访问问题,不安装、不认证、不选择实例、不调用会改变状态的 Portal 操作。
主要能力与用法:
- 检查主机插件。Claude 用 claude plugin list --json,Codex 用 codex plugin list --available --json;Cursor 通过 Cursor Settings → Plugins 查看,不假设存在 Cursor 插件列表 CLI。确认 portal 是否安装并启用,记录版本;若版本最新但命令描述陈旧,建议在 Claude Code 中执行 /reload-plugins 或新开会话。若主机版本不支持 JSON 语法,先加 --help 运行对应命令。
- 验证 CLI 运行时与命令面:node --version、npm --version、npx @spotify/portal-cli --help、npx @spotify/portal-cli auth --help。CLI 应暴露 auth、actions、owner、search、service;缺失命令视为 CLI 版本阻塞。
- 检查认证但不改变选择:npx @spotify/portal-cli auth list、npx @spotify/portal-cli auth show。用户提供实例名时用文档中的 auth show 实例参数检查;存在多个实例且未指定目标时报告歧义,不代为选择。绝不请求或打印凭据、令牌或授权码。
- 验证只读 Portal 访问:npx @spotify/portal-cli actions list --json。成功即证明 CLI 能认证、到达所选实例并枚举可用操作;不要调用任何操作。
报告:返回紧凑表格,列为 Check、Status、Evidence or next action,覆盖 Plugin、CLI、Authentication、Actions 四项。当必需检查被阻塞或未验证时,不报告整体就绪。
限制:仅诊断,不改变状态;不处理凭据;不自动选择实例;具体平台支持与版本要求以实际主机为准,资料未提供更多细节。