本文面向希望基于此项目进行二次开发的 Flutter 工程师，从技术栈选型、核心架构设计、关键模块实现到二开实践路径，提供一份完整的技术地图。

---

一、技术栈总览

本项目是一个 Flutter 全平台 CMS 内容展示前端，一套 Dart 代码同时编译为 iOS、Android、Web、macOS、Windows 等多端应用：

层面	技术	版本	用途
框架	Flutter	3.x (Dart 3.12+)	全平台 UI 框架
语言	Dart	3.x	类型安全 + 空安全
状态管理	flutter_bloc + Cubit	9.x	响应式状态（Cubit 模式）
服务定位	GetIt	9.x	轻量 IoC 容器（单例管理）
路由	GoRouter	17.x	声明式路由 + ShellRoute
国际化	flutter_intl (intl)	0.21.x	ARB 翻译文件 + 代码生成
HTTP 客户端	Dio + Retrofit	5.x / 4.x	REST 通信 + 类型安全客户端
API 代码生成	swagger_parser	1.43.x	OpenAPI → Dart 模型 + 客户端
数据缓存	cached_query	3.x	Query/Mutation 缓存管理
响应式适配	flutter_screenutil	5.x	手机端设计稿适配（Web 端禁用）
Markdown	flutter_markdown	0.7.x	内容解析
HTML 渲染	flutter_widget_from_html	0.17.x	富文本渲染
加密	encrypt + crypto	5.x / 3.x	AES 加密（Token 持久化）
JWT	jose	0.3.x	JWT Token 解析
图片缓存	cached_network_image	3.x	网络图片缓存
骨架屏	shimmer	3.x	加载占位动画
环境变量	flutter_dotenv	6.x	.env 文件管理
日志	logger	2.x	结构化日志