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 腳本。