# VoltAgent 設計規格與首頁分析

語言：繁體中文（台灣用語，zh-TW）。內容整理：2026-10-15。官網參考日期：2026-10-11。

## 參考來源

- 公開來源：https://voltagent.dev/
- 對應完整預覽：`official-drafts/voltagent.html`
- 預覽 SHA-256：`600a26b7999def266a5d9a6754f19a0280bb9c3e8ffdf663b84e5038ce81d94c`
- 本次更新為文字在地化，不代表重新檢查了今日官網。品牌完整預覽、原始截圖與原生生成紀錄保留來源原貌。

## 目前首頁的視覺與結構

來源：https://voltagent.dev/。原始取樣時間保留於 UTC 紀錄，oct10 工作檔名不表示所有檢查都在 10 月 10 日完成。

現行首頁以近黑點陣網格、薄荷綠、細邊程式碼／產品卡構成，頁首有開源公告。10 月 11 日新參照的桌面導覽包含 GitHub 10.8K、Discord 圖示與 Try VoltOps，已保留其完整原始 SVG／導覽內容，首屏及捲動導覽皆完成實際複查；數字僅代表取樣當時。首屏為 The end-to-end／AI 代理工程平台、企業多代理說明、Get Started、npm 指令與右側原始連線圖。初次桌面文字留白，已另以真正顯示的官網桌面相位校正，不將舊留白當成完整首屏。

完整順序為 Core Framework／VoltOps Console、程式碼與 console、公司列、Tool calling／Unified API／Dynamic Prompting／Persistent Memory 四卡、見證、Supervisor agent orchestration、Chain API 工作流、RAG／context 四卡、40+ apps、贊助者、社群三卡及完整頁尾。

已新送原生 Stitch 並以真實來源素材校正。見證在離開區域後會從 DOM 卸載，另保留桌面／窄版可見時的完整 wrapper、62 張圖片元素與真實引言，並追加 9 個原始公開圖檔。Seth Rose 頭像在官網實際也 broken／404，保留原 URL，不製作虛構頭像。

主代理已逐段檢查目前雜湊的桌面 14 段與窄版 14 段，並實際查看全部 8 張對照圖與桌面頁首；9755／11459px 範圍完整、沒有橫向溢位。Seth 頭像在來源與本機各有兩個取樣相位仍破圖，不能寫成零破圖。桌面首屏五個後段標題下移 25.890625px，與來源見證延遲掛載有關；已掛載的 26 個見證 h3 也造成初始 DOM 標題數不同。

保留原有 DESIGN.md、PROMPTS.md、STITCH-PROMPT.md；本檔為目前官網的日期限定補充。研究頁免費瀏覽、無付費執行時依賴，未執行購買或訂閱。

驗證範圍為匿名公開首頁、1280×720 與 390×844、DPR 1、桌面 UA。實體手機、其他地區、完整互動與部署尚未驗證；accepted=false，不宣稱與官方一致。

## 套用至自己的專案

製作 AI 代理工作流程儀表板，包含執行時間軸、步驟詳細資訊與易讀的工具呼叫範例。整體採近黑色，翠綠色表示執行進度，以文字區分完成、等待與失敗。

可先拆出下列核心元件：AI 代理執行步驟，包含執行時間、狀態與可展開的輸入輸出資訊。先核對目前預覽的內容層級與構圖，再建立可重複使用的色彩、字型、間距及元件狀態。較早的延伸設計變數位於 `design-md/voltagent/DESIGN.md`；與本次觀察不一致時，以日期限定的實際觀察為準，不把延伸值冒充當日量測。

## 繁體中文與台灣用語

介面文案、按鈕、提示、錯誤訊息、圖片替代文字、設計規格與交付說明，一律使用繁體中文（台灣用語）。保留品牌名稱、字型名稱、檔名、網址、API 識別字與可執行程式碼。HTML 使用 zh-Hant-TW；數字與日期以 zh-TW 格式呈現，幣別及時區依原資料標示，不擅自換算。

使用「專案、元件、資料、建立、預設、載入、登入、連結、儲存、影片、伺服器、滑鼠」等台灣用語。繁體中文可依實際環境採 `Noto Sans TC`、`PingFang TC` 或 `Microsoft JhengHei`，原字型未涵蓋中文字時記錄替代方式。檢查長中文標題與混合中英文換行，不沿用英文固定字寬或大寫字距作為中文限制。

## 響應式與操作要求

以原有尺寸紀錄作視覺對照；新專案另檢查 390px、768px、1440px 的版面。保留語意閱讀順序、可見鍵盤焦點與具名稱的控制項，主要觸控區域建議至少 44px。支援載入、空白、錯誤、停用與已選取狀態，並提供減少動態效果的替代呈現。

以上是新專案的實作建議，不表示原預覽已完成全部互動或無障礙驗收。來源的價格、資料、活動及服務狀態皆屬原日期畫面內容，示範使用時應標明範例，不推論為即時結果。

## 已知差異與限制

- 新穩定桌面主視覺及已載入的桌面、窄版客戶引言補充舊整頁階段。桌面官網內容載入後頁高由 9729px 變為 9755px；輪播、圖表及顯示動畫尚未同步。
- 一個精確 Twitter 頭像網址回傳 404，仍無法取得，未捏造替代圖。圖表動態、程式碼與主控台分頁、GitHub 數量、選單及服務尚未驗證。
- Seth Rose 的原始 Twitter 頭像在官網及本機皆回傳 404，兩邊各有 2 個取樣階段可見；未替換圖片，也不宣稱零破圖。
- 桌面第 0 階段下方 5 個標題低 25.890625px；官網初始 9729px 在客戶引言載入後增至 9755px。官網初始 15 個標題與本機 41 個的差異，包含已載入的 26 個客戶引言 H3，窄版也有相同載入與計數差異。最終取樣範圍相符不代表像素一致。
- 商標、客戶引言、YouTube 卡片、整合圖示旋轉、流程點與 Discord 文字動態不同步；GitHub 的 10.8K 僅為原日期官網範例。
- 程式碼與主控台分頁、導覽、剪貼簿，以及實際代理、雲端與服務尚未驗證。
- 原始比對未涵蓋其他寬度、實體裝置、地區、完整互動及動態，以及正式部署。

## 交付與驗證

交付實作檔案、設計變數、繁體中文文案、可操作的核心元件與實際檢查結果。逐項列出仍未完成的互動與服務，不以相同頁高、少量幾何資料或供應者宣稱取代完整視覺檢查。原始比對仍為有差異的參考，未宣稱官方授權或完全一致。