Sayhi-bzb/Agent-HTML

解決的問題

Agent-HTML 解決了 AI 代理輸出使用 Markdown 的限制。雖然 Markdown 適合文字與程式碼，但無法處理複雜的視覺需求，例如儀表板、互動式資料檢視、產品原型或主題式報告。此專案讓代理能產生持久且互動式的 React 藝術品，而非僅是簡單的文件。

工作原理

系統採用「畫布」架構，由以下幾個部分組成：

• agent-html：一個可攜式的工作區，代理在此撰寫 React 與 TypeScript 藝術品。
• @agent-html/react：提供無頭 Artifact 與 Block 元件的協定，可在 HTML 表面建立穩定且可定位的區域。
• 畫布主機：基於 Vite 的環境，用於渲染藝術品、提供驗證診斷、管理主題預設，並處理區塊層級提示路由。
• 本地資源：一組與藝術品共存的 UI 原語、鉤子與模式，確保一致性。

適用對象

專為需要輸出功能型使用者介面（如操作儀表板、看板或資料報告）而非僅是聊天回應的 AI 代理工作流程開發者設計。

主要亮點

• 可檢視的表面：利用 Block 元資料，允許針對藝術品的特定區域進行目標式審查與聚焦回饋。
• 豐富的表現力：支援佈局、狀態、互動、圖表與表格。
• 持久的上下文：將規則、資源與藝術品儲存在檔案系統中，防止其在聊天歷史中遺失。
• 精準修訂：支援將後續提示路由至 HTML 表面的特定區塊，實現精確編輯。