183 lines
9.8 KiB
Markdown
183 lines
9.8 KiB
Markdown
# mom_kitchen - 小妈厨房
|
||
|
||
一款基于 Flutter 的 iOS26 风格美食应用，支持多平台（Android/iOS/HarmonyOS/Web）
|
||
|
||
## 📱 APP 介绍
|
||
|
||
### 一句话介绍（10条）
|
||
1. 小妈厨房：基于 Flutter 的 iOS26 风格美食应用，支持多平台，集成个性化设置、热量追踪、智能购物清单、瀑布流发现页和农场游戏等功能。
|
||
2. 小妈厨房：你的私人美食顾问，提供多平台支持、个性化设置、营养分析、智能购物清单、瀑布流发现和农场游戏等全方位服务。
|
||
3. 小妈厨房：iOS26 风格的多平台美食应用，集个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏于一体。
|
||
4. 小妈厨房：支持多平台的美食应用，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏功能。
|
||
5. 小妈厨房：基于 Flutter 开发的 iOS26 风格美食应用，支持多平台，包含个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏。
|
||
6. 小妈厨房：多平台美食应用，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏等全面功能。
|
||
7. 小妈厨房：iOS26 风格的美食应用，支持多平台，集成个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏。
|
||
8. 小妈厨房：基于 Flutter 的多平台美食应用，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏。
|
||
9. 小妈厨房：支持多平台的 iOS26 风格美食应用，集个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏于一体。
|
||
10. 小妈厨房：你的全方位美食助手，支持多平台，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏。
|
||
|
||
### APP 关键字（20个）
|
||
美食应用, 食谱管理, iOS26风格, Flutter, 多平台, 个性化设置, 热量追踪, 营养分析, 智能购物清单, 瀑布流布局, 农场游戏, 烹饪工具, 多语言支持, 智能推荐, 健康饮食, 食材管理, 食谱搜索, 美食灵感, 生活方式, 家庭烹饪
|
||
|
||
### 50字内介绍（5条）
|
||
1. 小妈厨房是基于 Flutter 开发的 iOS26 风格美食应用，支持多平台，集成个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏等功能。
|
||
2. 小妈厨房是一款支持多平台的美食应用，采用 iOS26 风格设计，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏。
|
||
3. 基于 Flutter 的小妈厨房是 iOS26 风格的多平台美食应用，集成个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏等全面功能。
|
||
4. 小妈厨房是支持多平台的 iOS26 风格美食应用，基于 Flutter 开发，提供个性化设置、热量追踪、营养分析、智能购物清单、瀑布流发现和农场游戏。
|
||
5. 小妈厨房是一款多平台美食应用，采用 iOS26 风格设计，基于 Flutter 开发，集成个性化设置、热量追踪、智能购物清单、瀑布流发现和农场游戏。
|
||
|
||
### 100字内介绍（5条）
|
||
1. 小妈厨房是基于 Flutter 开发的 iOS26 风格美食应用，支持 Android、iOS、HarmonyOS 和 Web 多平台运行。它集成了个性化设置（主题颜色、字体大小、深色模式等）、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等全面功能，为用户提供全方位的美食体验。
|
||
2. 作为一款支持多平台的美食应用，小妈厨房采用 iOS26 风格设计，基于 Flutter 开发。它提供个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等功能，满足用户从食谱发现到食材采购的全方位需求。
|
||
3. 小妈厨房是 iOS26 风格的多平台美食应用，基于 Flutter 开发。它集成了个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等功能，为用户提供从食谱管理到健康饮食的全面服务。
|
||
4. 基于 Flutter 开发的小妈厨房是一款支持多平台的 iOS26 风格美食应用。它提供个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等功能，为用户打造一站式的美食体验。
|
||
5. 小妈厨房是一款支持多平台的美食应用，采用 iOS26 风格设计，基于 Flutter 开发。它集成了个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等功能，为用户提供全方位的美食服务。
|
||
|
||
### 300-500字介绍（2条）
|
||
1. 小妈厨房是一款基于 Flutter 开发的现代化美食应用，采用 iOS26 风格设计，支持 Android、iOS、HarmonyOS 和 Web 多平台运行。它集个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等全面功能于一体，为用户提供全方位的美食体验。
|
||
|
||
应用的个性化设置系统支持主题颜色、字体大小、深色模式、动画强度和多语言等多种自定义选项，让每个用户都能打造专属于自己的美食世界。热量追踪与营养分析功能帮助用户监控饮食健康，智能购物清单让食材采购变得更加高效，瀑布流发现页则为用户推荐个性化的食谱和食材，农场游戏功能则增添了烹饪的乐趣。
|
||
|
||
小妈厨房注重用户体验，采用响应式设计，适配不同屏幕尺寸。它支持多语言（简体中文、繁体中文、English），满足全球用户的需求。应用采用现代化的技术架构，包括 GetX 状态管理、本地缓存、后台静默加载和错误处理机制，确保应用运行流畅稳定。
|
||
|
||
无论是烹饪新手还是美食达人，小妈厨房都能为你提供专业的美食服务，让烹饪变得简单、有趣又健康。
|
||
|
||
2. 小妈厨房是一款专为美食爱好者打造的应用，采用 iOS26 风格设计，基于 Flutter 开发，支持多平台运行。它以用户为中心，集成了个性化设置、热量追踪与营养分析、智能购物清单、瀑布流发现页和农场游戏等全面功能，为用户提供一站式的美食解决方案。
|
||
|
||
应用的个性化设置系统允许用户自定义主题颜色、字体大小、深色模式、动画强度和语言等，打造专属于自己的美食世界。热量追踪与营养分析功能帮助用户监控饮食健康，智能购物清单让食材采购变得更加高效，瀑布流发现页为用户推荐个性化的食谱和食材，农场游戏功能则增添了烹饪的乐趣。
|
||
|
||
小妈厨房采用现代化的技术架构，包括 GetX 状态管理、本地缓存、后台静默加载和错误处理机制，确保应用运行流畅稳定。它支持多语言，满足全球用户的需求，采用响应式设计，适配不同屏幕尺寸。
|
||
|
||
无论是寻找新食谱、管理食材、追踪营养，还是体验农场游戏的乐趣，小妈厨房都能为你提供全方位的服务，让烹饪成为一种享受，让美食成为生活的亮点。
|
||
|
||
---
|
||
|
||
## 🎨 个性化设置
|
||
|
||
### 访问路径
|
||
```
|
||
个人中心 → 设置 → 个性化设置
|
||
```
|
||
|
||
### 功能列表
|
||
| 功能 | 说明 | 范围 |
|
||
|------|------|------|
|
||
| 🎨 主题颜色 | 5 种预设颜色（蓝/橙/蓝紫/草绿/深红） | 全局 |
|
||
| 📝 字体大小 | 12pt - 24pt 可调 | 全局 |
|
||
| 🌙 深色模式 | 一键切换 | 全局 |
|
||
| ✨ 动画强度 | 0-2 倍速 | 全局 |
|
||
| 🌐 语言 | 简体中文/繁体中文/English | 全局 |
|
||
| 🔄 恢复默认 | 一键重置所有设置 | - |
|
||
|
||
### 开发者 API
|
||
```dart
|
||
// 获取控制器
|
||
final controller = Get.find<PersonalizationController>();
|
||
|
||
// 设置主题颜色
|
||
controller.setThemeColor(Color(0xFF2196F3));
|
||
|
||
// 调整字体大小
|
||
controller.setFontSize(18.0);
|
||
|
||
// 切换深色模式
|
||
controller.toggleDarkMode();
|
||
|
||
// 设置动画强度
|
||
controller.setAnimationIntensity(1.5);
|
||
|
||
// 切换语言
|
||
controller.setLanguage('en');
|
||
|
||
// 恢复默认
|
||
controller.resetToDefaults();
|
||
```
|
||
|
||
### 文件结构
|
||
```
|
||
lib/src/
|
||
├── controllers/
|
||
│ └── personalization_controller.dart # 控制器
|
||
├── pages/
|
||
│ └── personalization_page.dart # 页面 UI
|
||
└── routes/
|
||
└── app_routes.dart # 路由注册
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 已完成功能
|
||
|
||
### 阶段三：热量追踪 + 营养分析 ✅
|
||
- 膳食记录控制器（周/月聚合）
|
||
- 营养可视化图表（fl_chart）
|
||
- 目标设置页面
|
||
|
||
### 阶段四：购物清单 ✅
|
||
- 购物清单 CRUD 操作
|
||
- 分类筛选（8 种食材分类）
|
||
- 进度条显示完成度
|
||
- 多入口访问（发现页/我的页/菜谱卡片）
|
||
|
||
### 阶段六：主页体验优化 🔵
|
||
- ✅ 搜索功能（历史记录/热门搜索）
|
||
- ✅ 骨架屏加载效果
|
||
- ✅ 卡片交互按钮优化
|
||
|
||
### Bug 修复 🔴
|
||
- ✅ B.5 发现页购物清单点击无反应
|
||
|
||
|
||
---
|
||
|
||
## 📊 项目进度
|
||
|
||
总任务：38 | 已完成：19 | 完成率：50%
|
||
|
||
详细进度查看：[UNFINISHED_FEATURES.md](docs/dev/UNFINISHED_FEATURES.md)
|
||
|
||
---
|
||
|
||
## 🛠 开发指南
|
||
|
||
### 代码规范
|
||
- 优先使用 Cupertino (iOS) 组件
|
||
- 每个文件头部添加标准注释
|
||
- 遵循 iOS 26 Liquid Glass 设计风格
|
||
- 使用 DesignTokens 统一样式
|
||
|
||
### 路由注册
|
||
所有页面必须在 `app_routes.dart` 中注册：
|
||
1. 添加 `GetPage` 到 `pages` 列表
|
||
2. 添加 `PageInfo` 到 `registerAllPages()`
|
||
3. 设置 `PageStandardsMiddleware` 中间件
|
||
|
||
### 主题定制
|
||
使用 `DesignTokens` 和 `DarkDesignTokens`：
|
||
```dart
|
||
// 主题色
|
||
DesignTokens.primary
|
||
DesignTokens.secondary
|
||
|
||
// 背景色
|
||
DesignTokens.background
|
||
DesignTokens.card
|
||
|
||
// 圆角
|
||
DesignTokens.borderRadiusLg
|
||
DesignTokens.borderRadiusMd
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 更新日志
|
||
|
||
详细变更查看：[CHANGELOG.md](CHANGELOG.md)
|
||
|
||
最新版本：0.33.0 (2026-04-09)
|
||
- Bug 修复：路由拦截问题
|
||
- 新增：搜索功能
|
||
- 优化：骨架屏加载效果
|
||
|
||
---
|