SuperAPI AI 工具集

python-backend-fastapi

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:该技能适用于涉及 FastAPI 端点、路由、依赖、中间件的新增或修改,请求/响应校验与 OpenAPI 正确性(Pydantic v2),数据库结构变更(Alembic 修订),后端日志与请求追踪,以及带内存约束和坏行报告的 ETL/解析/导入管道。

主要能力与工作方式:先给出简短计划再改代码,优先按文件路径和仓库既有模式操作;仅在真正阻塞时提 1–3 个澄清问题;以可验证目标为准,如测试、迁移、可复现 API 调用和确定性输出。复杂或高风险变更可内部执行 Chain-of-Verification(草稿→3–5 个验证问题→独立回答→修订),只呈现最终结果与可选的不确定项。

标准流程:先做上下文发现,定位现有路由、依赖注入约定、错误处理、响应模式、服务层边界、迁移约定和日志格式,不臆造模式。再以 API 契约为先,用 Pydantic v2 定义请求与响应模型,确保 OpenAPI 反映真实状态码、响应形状和可选字段,保持处理器轻薄:解析校验、委托服务、映射响应。业务逻辑放入服务模块并配 pytest 单元测试,覆盖正常路径、校验、未找到、冲突等边界。使用 FastAPI Depends 做依赖注入和请求级依赖,若项目使用 request-id 则贯穿依赖与服务。每次结构变更创建新的 Alembic 修订,迁移需幂等安全,避免非确定性操作,同时提供 upgrade 与 downgrade,并保证依赖顺序正确;破坏性数据变更需标注风险与操作步骤。日志使用 Python 标准库 logging,包含 request id 和关键字段,避免记录密钥与 PII。ETL/解析按文件甚至按行流式处理,避免全量载入内存;无效记录写入 CSV,字段为 timestamp、file、line、error、original_row,original_row 尽量保留原始输入。

完成标准:端点行为符合契约,测试存在且通过,结构变更含升降级迁移,关键路径有日志,新端点提供示例 curl 或 httpie 调用及预期响应。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息。