全站加速
全站加速
- 文档首页
全站加速IGA PagesAI 资源使用 IGA Pages Plugin
复制全文
下载 pdf
文档反馈
问问助手IGA Pages Plugin 面向 AI 编程客户端，为其中的 AI 助手提供 IGA Pages 项目开发、部署和问题排查能力。安装后，AI 助手可以按任务加载 IGA Pages 指导、连接 MCP 工具，并在本地开发命令不适用时给出提醒。
什么是 IGA Pages Plugin
IGA Pages Plugin 是面向 AI 编程客户端的组件包。安装一次后，客户端会按自身支持范围加载以下组件，无需再分别安装 Skill、MCP 或 Hook：
| 组件 | 用途 |
|---|---|
| IGA Pages Skill | 为 AI 助手提供框架适配、项目开发、CLI、部署、环境变量和排障指导。AI 助手根据任务按需读取。 |
| IGA Pages MCP | 连接 IGA Pages 平台，供 AI 助手查询或操作项目配置、环境变量、部署、预览地址和日志。使用时需要单独完成 MCP OAuth 授权。 |
| Hook（本地开发自动提醒） | 在项目需要 IGA Pages 本地运行环境时，提醒 AI 助手使用 iga pages dev。不同客户端的提醒时机可能不同。 |
如需比较控制台、Plugin、MCP、Skill、CLI 和 IDE 插件的用途与组合关系，参见选择 IGA Pages 开发工具。
支持的 AI 编程客户端
Plugin 仅支持下表列出的 AI 编程客户端。安装前，请确认目标客户端及所需能力在支持范围内：
| AI 编程客户端 | Skill | MCP | 开发提醒 |
|---|---|---|---|
| Claude Code | ✅ | ✅ | ✅ |
| Codex CLI | ✅ | ✅ | ✅ |
| Cursor | ✅ | ✅ | ✅ |
| OpenCode 2 | ✅ | ✅ | ✅ |
| GitHub Copilot CLI | ✅ | ✅ | ✅ |
| Grok Build | ✅ | ✅ | ✅ |
| Kimi Code CLI | ✅ | ✅ | ❌ |
| Gemini CLI | ✅ | ✅ | ✅ |
| ChatGPT | ❌ | ❌ | ❌ |
| OpenCode 1 | ❌ | ❌ | ❌ |
前提条件
开始前，请确认满足以下条件：
- 执行本地开发、构建和 CLI 工作流时，准备可用的 shell，并安装 Node.js 20 或更新版本。
- 查询或操作 IGA Pages 项目、部署和日志时，准备具有相应权限的 IGA Pages 账号。
安装 Plugin
通用安装方式
对于兼容 plugins 安装器的 AI 编程客户端，在终端运行以下命令并按提示选择客户端。OpenCode 2、Grok Build 和 Gemini CLI 请改用下方各自的原生命令。该通用命令不适用于 ChatGPT。
npx plugins add volc-iga-pages/iga-pages-plugin
确认目标客户端后，按终端提示完成安装。
使用原生命令安装
- OpenCode 2：
opencode plugin add github:volc-iga-pages/iga-pages-plugin - Grok Build：
grok plugin install volc-iga-pages/iga-pages-plugin --trust - Gemini CLI：
gemini extensions install https://github.com/volc-iga-pages/iga-pages-plugin
安装完成后，需要启用 Plugin 并完成以下检查：
- 重新打开 AI 助手会话。
- 按客户端提示启用 Plugin，并批准 Hook。
- 使用
/skills list确认iga-pagesSkill 已加载。 - 使用
/mcp查看并启用 IGA Pages MCP 连接，按提示完成 OAuth 登录和授权。
使用 Plugin
在项目根目录打开新的 AI 助手会话，然后直接描述需要完成的任务。您可以提出以下 3 类任务：
- 部署项目：
把这个项目部署到 IGA Pages，完成后给我访问地址。 - 开发 AI Agent 应用：
用 IGA Pages 开发一个支持持久化会话的 AI 聊天应用。 - 排查运行问题：
检查这次部署的日志，帮我定位接口返回 500 的原因。
如任务需要查询或操作 IGA Pages 中的项目、部署、环境变量或日志，请按 AI 助手提示完成账号登录与授权。
说明
- Plugin 不包含 CLI。需要执行本地开发、构建或 CLI 工作流时，AI 助手会根据 Skill 指导使用单独安装的 IGA Pages CLI。
- CLI 登录与 MCP OAuth 授权相互独立；没有本地 shell 的环境只能执行 MCP 连接实际提供的操作。可用 MCP 工具以连接返回的工具列表为准。
使用本地开发提醒
当检测到项目包含 API，或使用 IGA Agent 或 Blob 能力，Plugin 中的 Hook 会提醒 AI 助手使用以下命令来启用 IGA Pages 本地开发环境，避免 AI 助手按普通前端项目的方式启动本地开发服务。
iga pages dev
说明
- Hook 只提供提示，不执行命令，也不会替换 AI 助手准备执行的命令。
- 确保您使用支持相应 Hook 的客户端版本，并在安装后启用 Plugin 和 Hook。
不同客户端向 AI 助手加入提醒的时机如下：
| AI 编程客户端 | 本地开发提醒 |
|---|---|
| Claude Code、Codex CLI、Cursor | 命令执行前提醒 |
| GitHub Copilot CLI、Grok Build | 命令返回后提醒 |
| OpenCode 2 | 准备模型上下文时加入提醒 |
| Gemini CLI | 会话启动、恢复或清空时加入提醒，不逐条拦截命令 |
| Kimi Code CLI | 无自动提醒，可按 Skill 指导使用 iga pages dev |
相关文档
- 选择 IGA Pages 开发工具：比较控制台、Plugin、MCP、Skill、CLI 和 IDE 插件的用途与选择方式。
- 使用 IGA Pages MCP：查看 MCP 支持的任务、MCP 工具和独立接入方式。
- IGA Pages Skill：查看 Skill 的安装和使用方式。
- IGA Pages CLI 使用手册：查看 CLI 命令和本地工作流。
- IGA Pages IDE 插件使用手册：查看基于 Open VSX 的图形化 CLI 插件。