即時預覽
這是什麼
用於檢視已生成網站、文件或結構化輸出的反饋介面。
白話解釋
隔著烤箱玻璃門看麵包膨脹,遠比等到最後才打開門確認來得踏實。即時預覽就是 Hermes 的玻璃門:一個能顯示已生成網站、文件或圖片的實際渲染結果的面板,當底層檔案變更時會自動更新,無需手動重新開啟。
為什麼重要
呈現實際輸出——網站、文件、結構化資料——而非讓使用者從原始內容推測生成結果長什麼樣子,正是即時預覽要解決的問題。當子代理正在反覆建構某個東西時尤其有用,因為即時看到進行中的結果,遠比每次變更後手動開啟檔案來得高效。它與 artifacts 緊密相關:如果沒有可定址的生成輸出可以指向,就沒有東西可以渲染。
運作方式
單一啟用的預覽目標保存在 nanostores 原子中(apps/desktop/src/store/preview.ts 的 $previewTarget),記錄它是 HTML 檔案、圖片、純文字還是遠端 URL,以及 HTML 檔案應以即時預覽還是原始原始碼方式渲染。預覽僅在使用者主動點擊工具結果中的預覽連結時才會開啟——絕不會自行彈出。開啟後會自動重新整理而無需再次點擊:本地檔案目標會直接在磁碟上監聽,有任何變更就會重新載入;而遠端開發伺服器 URL 目標則會在背景工具呼叫報告該工作階段的檔案編輯完成時重新載入(apps/desktop/src/app/session/hooks/use-preview-routing.ts)。對於正在執行的本地開發伺服器,該面板還可以透過閘道觸發「preview.restart」背景任務,並內嵌顯示其進度和完成狀態。