convex-self-hosting

convex-self-hosting 技能提供了一套标准化且可重复的框架，用于将 Convex 静态托管集成到现代 Web 应用中。此技能专为开发者与 AI 代理设计，确保基础设施设定（例如配置 Convex 静态资源、设定上传 API 及定义 HTTP 路由）符合 get-convex/self-hosting 的最新开发实践。它作为代码库与 Convex 运行时之间的运作桥梁，促进从开发到生产环境的顺利过渡。

• 自动与上游 Convex 集成指南同步，包含手动设定要求与包版本验证。

• 支持 Vite、Next.js 及 Expo web 导出等多平台，确保正确的构建流程与环境变量处理。

• 提供灵活的路由配置，支持根路径托管或如 /app 等自定义前缀，以支持单页应用 (SPA) 后备机制。

• 标准化部署工作流程，包含一次性部署与后端更新后接静态资源上传的分离部署方案。

• 针对常见问题（如静态路由 404 错误、部署 URL 错误或缓存冲突）提供主动式故障排除。

• 与 convex-agent-plugins 集成，维持严格的 TypeScript 验证、安全的函数定义及优化的数据访问模式。

• 在进行任何变更前，代理必须执行上游检查脚本，确保所有配置反映最新文档。

• 用户在执行任何修改前，必须理清项目特定需求，例如首选的打包工具与托管路径。

• 所有实现均要求强制性的执行后报告，包含上游文档提交时间戳、所选包安装路径、已修改文件列表以及后续步骤建议。

• 技能严格执行仅限内部的上传 API 策略，并建议避免将此类端点暴露于公共 HTTP 流量中。

• 输入包含目标项目类型、路径要求与部署策略；输出包含更新后的 convex.config.ts、http.ts、staticHosting.ts 文件以及配置好的 package.json 脚本。