用途：在 ASP.NET Core 中构建或维护基于控制器的 Web API，适用于需要控制器特有扩展或约定、迁移或审查现有控制器与过滤器的场景。若只是新建简单 API，建议改用 dotnet-minimal-apis，而非习惯性选择控制器。
主要能力：控制器结构（用 C# 12+ 主构造函数注入依赖，控制器只处理 HTTP 关注点）；显式模型绑定来源（[FromRoute]、[FromQuery]、[FromHeader]）；用 record 与 required 成员定义请求 DTO；用 FluentValidation 处理复杂验证规则；通过 ApiBehaviorOptions 统一 Problem Details 响应；用 AddApiVersioning 配置 URL 路径版本控制；用 IExceptionHandler 实现全局异常处理，返回一致的错误契约。
使用方式：保持控制器精简，将 HTTP 关注点映射到应用服务或处理器，避免在 action 中嵌入数据访问和业务规则；使用清晰的 DTO 边界、显式验证和可预测的 HTTP 状态行为；在控制器和端点两级审查认证与授权；有意识地处理 OpenAPI 生成、版本控制和错误契约。
适用场景：需要控制器约定、高级模型绑定、验证扩展、OData 等控制器中心特性的 API 项目。
限制：资料未提供安装命令、收费、价格、平台或效果信息；具体实现细节需参考 patterns.md 与 anti-patterns.md。