在线文档：https://flutter.dusksnow.top 归档来源：FlutterKit 文档站
docs/help/归档范围：简介、Core、Navigation、Feature、扩展 同步时间：2026-07-20
本目录用于开发 FlutterKit 业务时快速查阅，目录和页面名称与在线文档侧边栏保持一致。内容以项目当前实现和在线文档为准；TDesign 组件 API 请查阅 docs/tdesign-flutter/。
| 开发任务 | 建议阅读顺序 |
|---|---|
| 新建业务模块或页面 | 模块化设计 → Feature 概览 → 创建页面 → 页面模板 |
| 编写 View 与组件 | 完整布局规范与扩展 → View 规范 → 设计系统 → TDesign Flutter → 具体 TDesign 组件文档 |
| 编写 Logic 与状态 | Logic 规范 → State 规范 → 基础父类 → 状态管理 |
| 接入接口或数据 | 数据层 → 数据模型 → 网络请求 → 结果处理 |
| 使用数据库或存储 | 数据层 → 数据库 或 本地存储 |
| 配置路由与传参 | 导航概览 → 路由配置 → 参数与结果回传 |
| 主题、深色与样式 | 完整布局规范与扩展 → 设计系统 → 主题系统 → 深色模式 → Widget 链式扩展 |
| 页面适配与预览 | 屏幕适配 → 安全区适配 → 预览 |
项目级高频强约束统一维护在仓库根目录 AGENTS.md。本目录保存完整概念、API、流程和示例；不要在多个 README 中复制同一段实现说明。
- Core / 框架核心
- 设计系统
- 主题系统
- 深色模式
- 国际化
- Widget 链式扩展
- 动画链式扩展
- 基础父类
- 网络父类
- 分页父类
- 刷新父类
- Tab 父类
- 底部弹窗
- 数据层
- 数据库
- 本地存储
- 数据模型
- 网络请求
- 结果处理
- 状态管理
- UI 组件
- 工具类
- TDesign Flutter
- 修改代码前先按任务范围阅读对应栏目，确认职责、调用链与目录边界。
- 编写页面 UI 前先查阅设计系统、主题、链式扩展及具体 TDesign 组件文档。
- 文档与源码不一致时，以可运行源码和测试为准，并同步修正文档站与本归档。