| name | fkit-theme |
| description | 实现和维护 FlutterKit 主题、深色模式、主题颜色预设、持久化恢复、系统栏同步与国际化。用户要求修改主题、深浅色、颜色 JSON、语言切换、文案资源或 ThemeDemo 时使用。 |
FKit Theme
必读资料
先阅读 AGENTS.md,再读取:
docs/flutter-kit/框架核心/theme.md
docs/flutter-kit/框架核心/dark-mode.md
docs/flutter-kit/框架核心/localization.md
docs/flutter-kit/框架核心/design-system.md
docs/tdesign-flutter/全局配置/深色模式.md
核对 ThemeInitializer、Application、main.dart、ThemeColorPreset、主题 Repository/DataSource 和现有主题测试。
主题工作流
- 从
assets/json/ 中的主题 JSON 与 ThemeColorPreset 确认浅色、深色名称和回退关系。
- 保持 ThemeInitializer → Application →
Obx → TDesign/Material/AppTheme → System UI 的现有更新链路。
- 通过 Repository 持久化主题模式、颜色和语言;不要在 View 直接写存储。
- 使用语义颜色与字体,不为深色模式复制两套业务 Widget。
- 修改主题 token 时验证所有引用方、预览和 ThemeDemo。
国际化工作流
- 公共文案放 Core localization,业务文案放对应 Feature localization。
- 同步 key、中文、英文映射和聚合注册,避免页面硬编码可翻译文案。
- 保持接口返回文本和动态业务内容不进入静态翻译表。
验证
运行主题初始化、AppTheme、主题 Demo、语言响应性等相关测试。检查浅色、深色、跟随系统、颜色预设恢复、系统栏和 Preview,再执行静态分析与 git diff --check。