用途:在后端 REST 接口变更后,重新生成 OpenAPI 规范文件和前端类型化 API 客户端,避免手动维护前后端接口定义。
主要能力:启动后端 REST 服务并轮询健康检查直至就绪,抓取最新 OpenAPI 规范,强制重新生成前端 hooks,随后执行类型检查、lint 与格式化。
使用方式(须在单个 shell 代码块中运行,以保证 REST_PID 变量有效): cd autogpt_platform/backend && poetry run rest & REST_PID=$! WAIT=0; until curl -sf http://localhost:8006/health > /dev/null 2>&1; do sleep 1; WAIT=$((WAIT+1)); [ $WAIT -ge 60 ] && echo "Timed out" && kill $REST_PID && exit 1; done cd ../frontend && pnpm generate:api:force kill $REST_PID pnpm types && pnpm lint && pnpm format
规则:始终使用 pnpm generate:api:force,而非 pnpm generate:api;不要手动编辑 src/app/api/generated/ 下的文件;生成的 hooks 命名遵循 use{Method}{Version}{OperationName}。
适用场景:AutoGPT 平台前端与后端接口同步、CI 或本地开发中需要刷新 API 类型定义时。
限制:具体平台、依赖版本、安装要求与更完整的触发条件官方资料暂未提供。