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 主机。