用途:将始于 Google AI Studio(通常面向 Cloud Run 或预览环境)的项目,转换为以静态资源方式部署到 Domo App Platform 的自定义应用。判断项目是否属于 AI Studio 来源的线索包括:README 提及 Google AI Studio、Gemini API、Build 模式或 Cloud Run;存在 cloudbuild.yaml、Dockerfile 或 Cloud Run 部署说明;使用 process.env.GEMINI_API_KEY 等占位变量;结构上依赖服务器或容器运行而非静态托管。
主要能力:确保存在标准构建流水线(推荐 Vite,dev/build/preview 脚本,构建输出到 dist/;CRA 默认输出 build/,不符合契约);将 base 设为相对路径(如 Vite 的 base: './'),避免 /assets/... 这类绝对路径;路由改用 HashRouter 以适配静态托管,否则刷新深层路由会 404;移除对 AI Studio 环境注入的依赖,客户端不得携带明文密钥,如需调用 Gemini/LLM 应改用 domo.js 提供的 Domo AI API 或经后端(如 Domo Code Engine)代理注入密钥,并将 process.env.* 替换为 Vite 的 import.meta.env.VITE_*,同时添加 .env.example 记录非敏感变量。
必要用法:部署契约为依次执行 npm run build、cd dist、domo publish;若需要 manifest 等配置文件,应使其被复制进 dist/,默认做法是添加 postbuild 脚本。交付时应给出变更文件清单、本地运行命令,以及确认构建产出 dist/、子路径下资源可加载、路由可用、客户端无密钥的检查清单。
限制:Domo App Platform 不托管在站点根路径,需按子路径处理;浏览器端无法安全保存密钥;资料未提供具体 Domo 配置细节、价格、平台支持范围或实际效果验证。