# cute_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 修复：路由拦截问题
- 新增：搜索功能
- 优化：骨架屏加载效果

---