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-TW.md