vertesia-plugin

Vertesia 插件開發環境為創建、測試和部署 Vertesia 平台模塊化擴展提供了全面的基礎。通過使用雙架構方法，開發人員可以在單一存儲庫中同時維護強大的基於 Hono 的後端（工具服務器）和功能豐富的 React 前端（UI 插件）。這種結構確保了服務器端邏輯（如數據處理或外部 API 集成）與客戶端用戶體驗嚴格分離，同時保持共享的構建配置。

• 使用 Rollup 進行服務器端 ESM 編譯與 Vite 進行優化 React 組件打包的雙重構建系統。
• 通過 @vertesia/build-tools 提供的高級導入鉤子，可在構建時自動解析並轉換 Markdown 技能定義、交互提示詞和內容模板。
• 支持多種資源類型，包括 ToolCollections、SkillCollections、InteractionCollections 和 RenderingTemplateCollections。
• 集成開發工作流，具備服務器端熱重載 (start:watch) 與前端 HMR 的 pnpm 命令支持。
• 可擴展的 UI 組件系統，支持獨立開發或作為 Vertesia 庫進行生產集成。
• 內置工具與交互的 Schema 驗證，通過 TypeScript 和 JSON Schema 接口確保類型安全。

開發人員應利用 tool-server 中的預定義入門目錄來定義插件邏輯，並使用 ?skills 和 ?templates 查詢參數實現模塊化組件的自動發現。工具服務器充當主要執行引擎，允許自定義 Hono 處理程序和 MCP 提供程序集成。在開發 UI 時，請確保通過項目特定配置處理資產解析，以保持獨立開發環境與集成插件部署之間的一致性。實際限制包括必須遵循資源自動發現的特定目錄結構，並遵守提供的 Rollup/Vite 配置模式以確保成功部署到 Vertesia 主機。