用途：把前端、全栈及 AI Agent 项目部署到 IGA Pages，并提供开发期间所需的 CLI 与项目开发能力。分为两部分：CLI（iga 工具，负责认证、建项目、开发、构建、部署、检查、环境变量与集成）以及项目开发（functions、API 路由、Agent 与 Blob SDK）。
前置要求：@iga-pages/cli 需 >=1.1.9，Node.js 需 >=20；用 iga --version 检查，缺失或过旧时先用 npm i -g @iga-pages/cli@latest 安装升级。
登录：远程操作前先运行 iga whoami 复用已有登录；仅在凭证缺失、过期或被拒时登录。本地 IDE 用 iga login 走浏览器；远程交互终端用 iga login --remote 走设备码；无人值守自动化用 iga login --accessKey <YOUR_AK> --secretKey <YOUR_SK>（AK/SK 来自火山引擎 IAM 控制台）。--remote 与 AK/SK 互斥。
常用命令：iga pages init --type agent --list --json 与 iga pages init <directory> --type agent --template <ID> 用模板创建 Agent 项目；iga pages deploy --name <my-app> 部署（首次自动建项目），已关联项目直接 iga pages deploy；iga pages link 关联/创建 Pages 项目；iga pages dev 本地开发（存在 api/ 时必须用它以同时服务框架与 /api/*）；iga pages build 生产构建。环境变量用 iga pages env list/add/update/remove/pull；集成用 iga pages integration list/link supabase/unlink。执行 iga 命令时按技能要求加 VE_SKILL_ID=iga-pages/1.0.13 前缀。
框架：支持 Next.js、Vite、Vue CLI、Create React App、Angular、Hexo、Docusaurus、VitePress、VuePress、Astro、Nuxt；列表外框架（如 Remix）不支持。纯静态资源也可部署，默认以项目根目录为输出目录。Git 部署仅支持 GitHub。
限制：须在项目根目录执行 pages link/dev/build/deploy；脚手架会创建子目录，需先 cd 进入。不要提交 .iga/；存在 api/ 时不要用 npm run dev 等启动；不要把 package.json 的 scripts.dev 设为 iga pages dev（会死循环）。env/integration 命令需先成功 link；env add/update/remove 只改远程配置，下次部署才生效，需用 env pull 刷新 .env.local。@iga-pages/agent 与 @iga-pages/blob 只能在 IGA Pages Functions 或全栈框架服务端处理器中使用。部署输出若含带 ?iga_token=...&iga_time=... 的预览 URL，需完整分享含查询串的地址。更多细节见 references 下 frameworks.md、functions.md、agent-sdk.md、blob-sdk.md、env.md、integration.md、logs.md。