portal-ai-plugins安装教程5分钟快速上手在Claude Code、Codex和Cursor中接入Portal CLI【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-pluginsportal-ai-plugins 是 Spotify 开源的 Portal AI 插件市场让你用 5 分钟在 Claude Code、Codex 和 Cursor 中接入 Portal CLI完成认证配置、搜索软件目录、生成服务简报、运行只读诊断并安全调用 Portal 动作让 AI 编码助手直接操作你的 Portal 实例。portal-ai-plugins 是什么一句话概括它把 Spotify Portal 的工作流打包成插件装进你的 AI 编码环境。安装后你用自然语言下达指令助手在后台通过npx spotify/portal-cli调用上游 CLI 完成实际操作。核心能力一览工作流作用触发方式setup配置 Portal CLI 认证/portal:setupdoctor只读诊断检查插件/CLI/认证是否就绪/portal:doctorsearch自然语言搜索软件目录和技术文档/portal:searchservice生成服务简报负责人、健康度、事故、文档/portal:serviceactions发现、预览并安全调用 Portal 动作/portal:actionsfeedback向 Portal 团队提交反馈/portal:feedback每个工作流的完整实现都放在skills/目录下例如 skills/setup/SKILL.md 和 skills/search/SKILL.md欢迎对照源码了解细节。安装前准备先确认你的环境开始之前只需确认两件事已安装 Node.js 和 npmPortal CLI 依赖它们运行node --version npm --version已安装三款 Agent 中的任意一款Claude Code、Codex 或 Cursor。无需其他依赖——插件会自动通过 npm 拉取上游 CLI 包认证流程也在浏览器中完成全程不会要求你在聊天里粘贴任何 token 或授权码这一点在 skills/setup/SKILL.md 中被列为首要安全规则。在 Claude Code 中安装插件一键接入步骤打开终端执行两条命令添加市场并安装插件claude plugin marketplace add spotify/portal-ai-plugins claude plugin install portalportal可选如果你还想要省 token 的 shunt 插件后文详解追加一行claude plugin install shuntportal然后开启一个新会话输入/portal:setup助手会自动走完整的认证流程检查 CLI 是否具备auth、actions、owner、search、service五个命令 → 列出已有实例 → 必要时在浏览器中登录 → 选中实例并验证 → 最后用actions list --json确认可读访问。完成后它会给你一份包含 CLI 来源、实例名称、认证状态的完成报告。在 Codex 中安装插件最快配置方法Codex 的安装方式略有不同先添加市场再进入插件面板codex plugin marketplace add spotify/portal-ai-plugins codex启动后打开/plugins找到Spotify Portal并安装。然后开始一个新任务直接对助手说Set up Spotify Portal for me.助手会按照与 Claude Code 相同的 setup 工作流完成认证。在 Cursor 中安装插件团队市场配置Cursor 走团队市场 设置面板的路径在你的 Cursor 团队市场Team Marketplace中注册spotify/portal-ai-plugins仓库打开Cursor 设置 → Plugins找到并安装Spotify Portal即可。 提示Cursor 没有插件列表 CLI 命令后续检查安装状态也通过设置面板查看见 skills/doctor/SKILL.md。安装后第一件事运行只读诊断装完别急着干活先跑一次体检。在 Claude Code 中运行/portal:doctor或对其他两款 Agent 说检查 Portal 是否就绪。诊断是纯只读的——不会安装、不会认证、不会修改任何状态。它会依次检查检查项关注点插件portal 是否已安装、版本是否最新CLINode/npm 运行时、五个核心命令是否齐全认证实例名称、后端 URL多个实例时报告歧义而非擅自选择动作访问actions list --json是否成功最终输出一张紧凑的状态表。任何一项被标记为 blocked就按表中下一步提示处理即可。上手实战三个最常用工作流 搜索软件目录—— 用/portal:search直接问谁在维护订单服务这类自然语言问题。助手会保留精确的实体引用和结果类型结果稀少时自动放宽词重试一次但绝不编造不存在的服务。 生成服务简报—— 用/portal:service一次性拿到服务负责人、值班人、Slack 频道、Runbook、构建部署状态和历史事故。详见 skills/service/SKILL.md。⚙️ 安全调用动作—— 用/portal:actions发现可用动作。涉及变更的操作会强制执行先--dry-run --json预览 → 展示将发生的变化 → 用户确认后才执行的流程破坏性操作还需显式授权详见 skills/actions/SKILL.md。进阶玩法shunt 插件帮你省下 82%–94% 的 token这个市场还附带一个 Claude Code 专属插件shunt把 I/O 密集型任务批量读大文件、生成样板代码分流给跑在廉价 worker 模型上的 AiKA 模式。它的三层设计值得一看Hooks拦截对超过 350 行大文件的整文件读取重定向到 bulk-readerScripts负责调用 AiKA 并清理输出Skills教会 Claude 何时、如何调用脚本。官方基准测试16.2 万行 Java 单体仓库显示单文件场景 token 从 33,684 降到 5,737省 82%源码测试对场景省 94%。完整说明见 plugins/shunt/README.md测试与基准数据在 plugins/shunt/evals/benchmarks.json。⚠️ 注意shunt 依赖 portal 插件提供的 Portal CLI且实例需启用 AiKA 模式安装前建议先完成/portal:setup。常见问题排查清单症状排查方向安装后命令没有反应开启新会话或在 Claude Code 中运行/reload-plugins命令缺少auth/search等CLI 版本过旧需要新版 Portal CLI列出多个实例后卡住这是故意的插件不会擅自替你选择实例请明确指定一切正常但想复查随时运行/portal:doctor它是纯只读的更多设计约定如保持 doctor 只读、保留 JSON 与 dry-run 防护记录在 AGENTS.md 中。写在最后portal-ai-plugins 的价值在于零配置感三款 Agent 各两条命令接入认证交给浏览器安全边界交给 dry-run 和只读诊断。按照本文步骤操作5 分钟内你的 AI 编码助手就能替你搜索软件目录、生成服务简报并安全调用 Portal 动作。项目全貌可从 README.md 了解欢迎动手试试【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考