# VoltAgent AI 介面實作指令

語言：繁體中文（台灣用語，zh-TW）。指令重新產出：2026-10-15。對應官網參考日期：2026-10-11。

將同資料夾的 DESIGN.md 與此指令一起交給 AI，並補上自己的產品需求。網站單份下載的品牌檔名也可使用；保留規格中的參考日期與限制。

```text
請先讀取隨附的 VoltAgent 設計規格與專案現有程式碼。以 2026-10-11 的公開首頁研究作為視覺參考，來源為 https://voltagent.dev/，這不代表今日最新官網。

我的需求：請在此填入產品名稱、目標使用者、頁面功能、內容及資料來源。

一、依參考建立視覺結構
來源：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 代理執行步驟，包含執行時間、狀態與可展開的輸入輸出資訊。沿用專案現有技術、路由及元件慣例；先整理色彩、字型、間距、圓角與狀態，再完成頁面。保留規格中實際量測的數值，未知內容明確標示為建議，不自行杜撰來源資料、價格、引言或成功結果。

三、台灣繁體中文與排版
介面文案、按鈕、提示、錯誤訊息、圖片替代文字、設計規格與交付說明，一律使用繁體中文（台灣用語）。保留品牌名稱、字型名稱、檔名、網址、API 識別字與可執行程式碼。HTML 使用 zh-Hant-TW；數字與日期以 zh-TW 格式呈現，幣別及時區依原資料標示，不擅自換算。
採用「專案、元件、資料、建立、預設、載入、登入、連結、儲存、影片」等台灣用語。中文字型缺字時提供可取得的替代字型並說明字寬差異。參考品牌的原始圖片與截圖保留來源內容；你新建立的文案與示範資料使用台灣繁體中文，不將商標或品牌服務當成我自己的產品。

四、操作與檢查
所有可見操作都必須有可理解的結果。依需求支援預設、焦點、已選取、停用、載入、空白與錯誤狀態。使用語意標記、具名稱的控制項、可見鍵盤焦點，以及至少 44px 的主要觸控區域。尊重減少動態效果設定；影片與動畫提供可閱讀的靜態替代。
在 390px、768px、1440px 檢查中文長標題、混合語言、圖片失敗與內容變動。程式碼及資料表可在自己的容器捲動，不讓文件整體被撐開。不要假裝已連接帳戶、付款、模型 API 或其他尚未接上的後端；示範資料須明確標示。

五、保留已知限制
- 新穩定桌面主視覺及已載入的桌面、窄版客戶引言補充舊整頁階段。桌面官網內容載入後頁高由 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 僅為原日期官網範例。
- 程式碼與主控台分頁、導覽、剪貼簿，以及實際代理、雲端與服務尚未驗證。
- 原始比對未涵蓋其他寬度、實體裝置、地區、完整互動及動態，以及正式部署。

六、交付
以繁體中文列出完成的檔案、設計變數、操作方式、實際驗證結果與尚未處理的限制。逐次修改時保留無關路由及資料行為，說明可觀察的修改前後差異，不把尚未檢查項目宣稱為通過。
```