Vercel 状态指南
介绍如何在 GIIP 平台上查看 Vercel 部署状态并监控部署历史。
📋 概述
Vercel 状态页面用于一目了然地查看在 GIIP 中注册的 Vercel 配置以及每个配置的最新部署状态。打开此页面后，会自动跳转到当前所选项目（csn）的 Vercel 管理列表（/project/[csn]/vercel）。如果没有选择项目，则跳转到默认项目。
🔍 主要构成要素
1. Vercel 配置卡片列表
每个已注册的 Vercel 配置都以卡片形式显示。卡片显示配置名称（vcConfigName）、关联的 Vercel 项目名称（vcVercelProjectName）以及描述。已停用的配置会变暗，并标有 已停用（Inactive） 徽章。
2. 最新部署状态徽章
每张卡片以彩色徽章显示其最近一次部署的状态。
READY（绿色）：部署完成BUILDING（蓝色）：构建进行中ERROR（红色）：部署失败CANCELED（黄色）：部署已取消QUEUED（紫色）：排队等待中
如果存在部署 URL，可点击在新标签页中打开实际部署的站点。卡片底部显示部署总数（deploymentCount）和最后同步日期（vcLastSyncAt）。
3. 卡片操作按钮
每张卡片可执行以下操作。
- 查看部署：跳转到该配置的部署历史详情页。
- 同步：从 Vercel 获取最新部署信息并刷新。
- 编辑：修改配置。
- 删除：删除配置（删除前会显示确认对话框）。
4. 部署历史表格
在配置卡片上点击 [查看部署] 后，该配置的部署列表以表格形式显示。列包括 URL、状态（State）、创建时间（Created）、创建者（Creator）和目标（Target）。可在顶部调整状态筛选（全部／READY／BUILDING／ERROR／CANCELED／QUEUED）和显示数量（10／20／50）。
🛠️ 使用技巧
- 添加新配置：使用右上角的 [添加配置] 按钮注册新的 Vercel 配置。
- 刷新：部署状态不会自动实时更新。需要最新状态时，请点击卡片或详情页上的 [同步] 按钮，从 Vercel 重新获取数据。
- 切换项目：在顶部更改项目后，会自动切换到该项目的 Vercel 列表。
💡 注意事项
- 此页面本身仅用于重定向。会短暂显示“正在跳转到 Vercel 管理页面...”消息，然后转到项目的 Vercel 列表。
- 如果部署列表为空，可能是尚未执行同步，或 Vercel 令牌无效。
API 参考
有关此功能的 API 详细规范，请参考专用指南。
故障排除
| 症状 | 原因 | 解决 |
|---|---|---|
| 页面一直停留在“正在跳转...” | 会话中没有 csn，或登录会话已过期 | 重新登录或选择项目后再次访问。 |
| 没有任何配置卡片 | 当前项目没有注册的 Vercel 配置 | 使用 [添加配置] 按钮注册新的 Vercel 配置。 |
| 不显示最新部署状态 | 尚未同步，因此没有部署历史 | 点击卡片上的 [同步] 按钮从 Vercel 获取数据。 |
部署状态显示为 ERROR | Vercel 构建失败 | 在部署 URL 或 Vercel 仪表板中查看构建日志。 |
| 同步失败 | Vercel 令牌已过期或无效 | 在配置 [编辑] 中更新有效令牌后再次同步。 |
版本: 1.0
最后更新: 2026-07-22
源文件: giipv3/public/help/vercel-status.zh-CN.md