用途:在创建、调试、重构或审查 ASP.NET Core Minimal APIs 时使用,适合 Program.cs 使用 WebApplication.CreateBuilder(args) 且未配置 Controllers 目录、目标框架为 .NET 6.0 及以上的项目,也用于优化 API 性能或简化 Web API 架构。
主要能力:按感知、规划、执行、验证流程工作。先检查 .csproj 的 TargetFramework,分析 Program.cs 是简单端点还是模块化或垂直切片组织,并确认是否配置 OpenAPI(Swagger)。规划阶段评估是否引入路由组优化结构、是否用端点过滤器处理参数验证等横切关注点,并按 .NET 版本选择语法(如 .NET 7+ 的 TypedResults)。执行阶段编写简洁高性能代码,优先 Lambda 或扩展方法,使用强类型与 record DTO,集成依赖注入而非服务定位器。验证阶段检查 HTTP 状态码、OpenAPI 文档完整性与 CancellationToken 传递。
版本特性:.NET 6/7 提供最小托管、MapGroup 路由组、端点过滤器、Typed Results;.NET 8/9 提供防伪令牌、[FromForm] 表单绑定、HybridCache、OpenAPI 改进;.NET 10+ 涉及 Native AOT 优化与轻量中间件模式。
编码规范:用扩展方法模块化路由,优先 TypedResults 与 Results<T1, T2>,始终接收并传递 CancellationToken,服务直接定义在 Handler 参数中。
交付与限制:可提供版本适配的 API 代码、将 Program.cs 路由抽取为扩展方法的结构建议、Swagger/OpenAPI 配置建议,并验证代码在 .NET 6+ 环境运行、端点安全与高性能实践(避免闭包、减少分配)。具体安装命令、收费与平台信息暂未提供。