用途:在 Flutter 项目开发中,帮助代理或开发者获取准确的 API 载荷结构,避免猜测字段名。适用于项目根目录存在本地 OpenAPI 文件(如 openapi.json),或 Firebase 项目存在 Firestore 规则或架构文件的场景。
主要能力:一是从本地 OpenAPI 文件生成 Dart 模型;二是为 Firebase 项目读取 Firestore 架构提示。
使用方式:先确保项目根目录存在本地 OpenAPI 文件,优先使用脚手架生成的文件。若 API 正在运行而文件缺失或过期,先导出到磁盘,不要将 URL 传入该技能: curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json
FastAPI 模型生成: python scripts/sync_openapi.py --project-root <root> 该命令仅依据本地 openapi.json 生成 lib/models/api_models.dart,可选参数 --openapi path/rel.json 指定其他文件。
Firebase: python scripts/fetch_firestore_schema.py --project-root <root>
在仓库中导入生成的模型,不要猜测字段名。
限制:需本地 OpenAPI 文件,不能传入 URL;Firestore 功能依赖 Firebase 项目存在规则或架构文件;其他细节暂未提供。