日常开发：本地调试、构建和发布

这一节说明如何让 Agent 帮你完成本地调试、生产构建、预览验证和发布前检查。它不是脚本命令清单；你只要说明要验证哪个页面、要构建什么产物、要同步哪些入口或资源，Agent 会读取项目脚本、选择合适命令、检查结果并反馈风险。

适合交给 Agent 的任务

• 启动本地开发服务，拿到可访问地址。
• 排查本地启动、预览或构建失败。
• 做生产构建并检查产物。
• 预览构建产物，确认页面和数据调用正常。
• 发布前检查菜单、资源、SQL、BFF 和数据集调用的影响。
• 同步平台菜单，或更新页面使用的线上资源引用。

准备工作

• 已经打开目标项目，并确认这是要调试或发布的应用。
• 知道要验证的页面、路由或功能。
• 涉及构建时，确认本地代码已经保存，依赖已经安装。
• 涉及发布时，准备好构建产物地址、页面入口或资源更新要求。

常用 Prompt

启动本地调试

请帮我启动当前项目的本地调试服务。
请先检查项目里有哪些可用脚本，再选择适合本地开发的启动方式。
启动后告诉我访问地址、是否有版本提示、是否有明显报错。

AI 可能调用：rabetbase run、rabetbase run start、rabetbase run dev。

排查本地调试失败

本地页面没有正常启动。请帮我排查原因。
重点检查 package 脚本、依赖安装状态、端口占用、CLI/SDK 版本提示和最近的错误日志。
请先给出原因判断，再告诉我修复步骤。

AI 可能调用：rabetbase run、rabetbase doctor、rabetbase run start、rabetbase run dev。

做生产构建

请帮我为当前项目做一次生产构建。
构建前先确认本地代码和数据接口配置是否完整。
构建后检查产物目录、JS/CSS 文件、资源路径和是否有构建错误。

AI 可能调用：rabetbase api pull、rabetbase run build。

预览构建产物

请帮我预览刚构建出来的产物。
请确认主要页面能打开，关键路由能访问，数据请求没有明显报错。
如果预览需要监听构建变化，也请说明会怎么处理。

AI 可能调用：rabetbase run preview。

做发布前检查

请帮我对这次改动做发布前检查。
请检查本地构建产物、页面路由、数据集调用、SQL/BFF 依赖、菜单入口和资源引用。
只列出通过项、风险项和阻断项，先不要执行发布或同步。

AI 可能调用：rabetbase run build、rabetbase dataset operations、rabetbase sql detail、rabetbase bff status、rabetbase menu sync。

同步菜单或更新线上资源

本次构建产物已经准备好。
页面入口是「<页面名称或路由>」。
资源地址是：
JS：<JS 资源地址>
CSS：<CSS 资源地址>
请帮我把页面入口和资源引用同步到平台。
执行前先预览会影响哪些菜单或资源；确认没有覆盖风险后再执行。

AI 可能调用：rabetbase menu sync、rabetbase menu update。

写 Prompt 时要补充的信息

• 页面位置：页面名称、路由、组件文件或菜单入口。
• 调试目标：启动、排错、预览、构建，还是发布前检查。
• 构建产物：产物目录、JS/CSS 地址或需要交付的文件。
• 发布约束：先预览、不覆盖菜单、不改无关文件、不立即同步。
• 验收方式：要打开哪些页面、检查哪些数据或确认哪些交互。

完成检查

• 本地服务可访问，或失败原因已经明确。
• 构建产物生成，JS/CSS 和资源路径清楚。
• 预览页面能打开，关键数据调用没有明显报错。
• 发布前风险、阻断项和需要人工确认的事项已经列出。
• 菜单或资源同步已经先预览，再按确认结果执行。

下一步：如果发布涉及新增页面入口，继续看「代码生成与菜单」；如果页面依赖的数据结构还不清楚，回到「API 与数据集：拉配置、看清数据」。