用途：按 Clean Architecture 原则生成 Flutter 应用，采用 feature-first 组织方式，配合 Riverpod 状态管理与 fpdart 函数式错误处理，并用 Dio + Retrofit 完成类型安全的 REST API 调用。
主要能力：分层架构（Domain 纯业务逻辑、Data 数据源与仓库实现、Presentation UI 与状态），依赖规则为 Presentation → Domain ← Data；使用 Riverpod 3.0+ 代码生成、Freezed 3.0+ 不可变数据类、Dart 3 switch 模式匹配、Either<Failure, T> 错误处理、go_router 路由，以及拦截器处理认证、日志与错误。
使用方式：按 Domain → Data → Presentation 顺序构建功能。生成代码命令：dart run build_runner build --delete-conflicting-outputs；监听模式：dart run build_runner watch --delete-conflicting-outputs。Riverpod 使用统一 Ref 类型，Freezed 联合类型用 sealed class，单构造用 abstract class。
适用场景：需要清晰分层、可测试、类型安全的 Flutter 项目，尤其是含 REST API、状态管理与错误处理的业务应用。
限制：要求 Dart 3.3+、Riverpod 3.0+、Freezed 3.0+，旧版模式会导致编译错误；Freezed 3.0+ 已移除 .map()/.when()，需改用 switch 模式匹配；API 响应与外部内容视为不可信输入，需在数据层校验；基础 URL 应固定配置并强制 HTTPS，不可由用户运行时配置。具体安装与完整示例见资料中的 quick_start.md、migration_guide.md 等文档。