重构目录树

docs/dev/PAGE_STRUCTURE_ANALYSIS.md

@@ -721,26 +721,166 @@
 
 ## 📊 全局美观问题汇总
 
-| 优先级 | 问题 | 影响页面 | 建议 |
-|--------|------|---------|------|
-| 🟡高 | 毛玻璃效果使用不一致 | 全局 | 统一GlassCard组件，所有卡片使用相同毛玻璃参数 |
-| 🟡高 | 卡片圆角不统一 | 全局 | 统一使用DesignTokens.radiusMd/Lg |
-| 🟡高 | 颜色使用偶尔硬编码 | 全局 | 严格使用DesignTokens颜色变量 |
-| 🟡中 | 空状态页面缺少插画 | 多个页面 | 设计统一的空状态插画+文案 |
-| 🟡中 | 加载状态不统一 | 全局 | 统一骨架屏样式和动画 |
-| 🟢低 | 页面转场动画单调 | 全局 | 添加iOS风格滑入动画 |
+| 优先级 | 问题 | 影响页面 | 建议 | 状态 |
+|--------|------|---------|------|------|
+| 🟡高 | 毛玻璃效果使用不一致 | 全局 | 统一GlassCard组件，所有卡片使用相同毛玻璃参数 | ✅已统一 |
+| 🟡高 | 卡片圆角不统一 | 全局 | 统一使用DesignTokens.radiusMd/Lg | ✅已统一(89处) |
+| 🟡高 | 颜色使用偶尔硬编码 | 全局 | 严格使用DesignTokens颜色变量 | ✅已统一(20处) |
+| 🟡中 | 空状态页面缺少插画 | 多个页面 | 设计统一的空状态插画+文案 | ✅已增强(GlassCard包裹) |
+| 🟡中 | 加载状态不统一 | 全局 | 统一骨架屏样式和动画 | ✅已增强(LoadingIndicator) |
+| 🟢低 | 页面转场动画单调 | 全局 | 添加iOS风格滑入动画 | 🔴待开发 |
 
 ## 📊 全局功能缺失汇总
 
-| 优先级 | 功能 | 影响页面 | 说明 |
-|--------|------|---------|------|
-| P1 | 下拉刷新 | 首页/发现 | 缺少下拉手势刷新 |
-| P2 | 搜索历史 | 搜索页 | 无本地搜索记录 |
-| P2 | 分页加载 | 多个列表页 | 分类浏览/标签列表无分页 |
-| P2 | 相关推荐 | 详情页 | 缺少相关菜谱推荐 |
-| P2 | 烹饪模式 | 详情页 | 全屏步骤+计时器 |
-| P2 | 过敏原警示 | 详情页 | 食材含过敏原时警告 |
-| P2 | 营养可视化 | 详情页 | 环形图/进度条展示营养占比 |
-| P3 | 排序筛选 | 列表页 | 按评分/浏览量/最新排序 |
-| P3 | 评论系统 | 详情页 | 需后端支持 |
-| P3 | 用户等级 | 个人中心 | 经验值+等级+徽章 |
+| 优先级 | 功能 | 影响页面 | 说明 | 状态 |
+|--------|------|---------|------|------|
+| P1 | 下拉刷新 | 首页/发现 | 缺少下拉手势刷新 | 🔴待开发 |
+| P2 | 搜索历史 | 搜索页 | 无本地搜索记录 | 🔴待开发 |
+| P2 | 分页加载 | 多个列表页 | 分类浏览/标签列表无分页 | 🔴待开发 |
+| P2 | 相关推荐 | 详情页 | 缺少相关菜谱推荐 | 🔴待开发 |
+| P2 | 烹饪模式 | 详情页 | 全屏步骤+计时器 | 🔴待开发 |
+| P2 | 过敏原警示 | 详情页 | 食材含过敏原时警告 | 🔴待开发 |
+| P2 | 营养可视化 | 详情页 | 环形图/进度条展示营养占比 | 🔴待开发 |
+| P3 | 排序筛选 | 列表页 | 按评分/浏览量/最新排序 | 🔴待开发 |
+| P3 | 评论系统 | 详情页 | 需后端支持 | 🔴需后端 |
+| P3 | 用户等级 | 个人中心 | 经验值+等级+徽章 | 🔴需后端 |
+
+---
+
+## 🔌 API能力分析：可增加功能
+
+> 基于 `APP_GUIDE.md`(v2.9.0) 和 `API_DOC.md`(v3.2.0) 全面分析，2026-04-13 更新
+
+### 📊 已使用API接口一览
+
+| 接口文件 | Repository | 已用act | 状态 |
+|---------|-----------|---------|------|
+| `api.php` | RecipeRepository | list/detail/full/ingredients/ingredient_detail/search/categories/tags/stats/unified_list/unified_detail/unified_search/unified_hot/query | ✅ |
+| `api_action.php` | ActionRepository | like/rate/view/ip_status | ✅ |
+| `api_feed.php` | FeedRepository | recommend/latest/hot/prefetch | ✅ |
+| `api_filter.php` | RecipeRepository+SearchController | recipe_main_categories/taste_tags/cooking_tags/filter_recipes/global_search | ✅ |
+| `api_hot.php` | HotRepository(→stats_full.php?act=hot) | hot | ✅ |
+| `api_what_to_eat.php` | WhatToEatRepository | filter_apply/detail | ✅ |
+| `api_discover.php` | DiscoverRepository | 随机数据 | ✅ |
+| `stats_full.php` | StatsRepository | online/request/hot | ✅ |
+| 静态数据 | 未使用 | eating_times.json/nutrition_types.json/gmy.json | ❌未使用 |
+
+### 📊 未使用API接口一览
+
+| 接口 | act/参数 | 文档描述 | 当前状态 |
+|------|---------|---------|---------|
+| `api.php?act=mini` | mini | 迷你版菜谱信息(~1KB)，适用于列表页快速加载 | ❌未调用 |
+| `api_filter.php?act=meal_times` | meal_times | 用餐时段列表(早餐/中餐/晚餐等) | ❌未调用 |
+| `api_filter.php?act=recipe_sub_categories` | recipe_sub_categories&parent_id= | 食谱子分类列表 | ❌未调用 |
+| `api_filter.php?act=ingredient_main_categories` | ingredient_main_categories | 食材大类列表 | ❌未调用 |
+| `api_filter.php?act=ingredient_sub_categories` | ingredient_sub_categories&parent_id= | 食材子分类列表 | ❌未调用 |
+| `api_filter.php?act=category_tags` | category_tags&category_id= | 指定分类下的口味+工艺标签 | ❌未调用 |
+| `api_filter.php` exclude_*参数 | exclude_category/taste/cooking/allergen等 | 排除筛选(排除分类/口味/工艺/过敏原) | ❌未调用 |
+| `api_filter.php` 高级筛选 | nutrition_name/min/max, allergen, ingredient, author_id | 营养范围/过敏原/食材/作者筛选 | ❌未调用 |
+| `api_what_to_eat.php?act=filter_steps` | filter_steps&category= | 获取筛选步骤和菜谱数量 | ❌未调用 |
+| `api_what_to_eat.php?act=detail&code=` | detail&code=CP032892 | 编码查询菜谱详情 | ❌未调用 |
+| `api_what_to_eat.php?act=detail&title=&fuzzy=1` | detail&title=&fuzzy=1 | 模糊标题搜索 | ❌未调用 |
+| `api_hot.php?sort=rate` | sort=rate | 按评分排序的热门排行 | ❌未调用 |
+| `api.php?act=unified_list&type=ingredient` | unified_list&type=ingredient | 统一格式食材列表 | ❌未调用 |
+| `api.php?act=unified_detail&type=ingredient` | unified_detail&type=ingredient | 统一格式食材详情 | ❌未调用 |
+| `api.php?act=unified_hot&type=ingredient` | unified_hot&type=ingredient | 统一格式食材热门 | ❌未调用 |
+| `eating_times.json` | 静态资源 | 34种用餐时段数据(标准/组合/频率/方法) | ❌未使用 |
+| `nutrition_types.json` | 静态资源 | 31种营养成分数据(含单位) | ❌未使用 |
+| `gmy.json` | 静态资源 | 585种过敏原数据(21大类) | ❌未使用 |
+
+---
+
+### 🟢 已有API可直接开发（P2优先级）
+
+| # | 功能 | API接口 | 数据源 | 页面位置 | 开发复杂度 | 说明 |
+|---|------|---------|--------|---------|-----------|------|
+| 1 | 🕐 用餐时段推荐 | `api_filter.php?act=meal_times` | eating_times.json(34种) | 首页/工具中心 | ⭐⭐ | 根据当前时间智能推荐早/午/晚餐，首页瀑布流已有时段卡片但跳转搜索页，应改为时段专属推荐页 |
+| 2 | ⚠️ 过敏原警示 | `api.php?act=full` allergens字段 | gmy.json(585种) | 菜品详情页 | ⭐⭐ | 详情页显示过敏原警告，结合用户过敏原设置自动过滤，已有allergen字段但未展示 |
+| 3 | 📊 营养可视化 | `api.php?act=full` nutrition字段 | nutrition_types.json(31种) | 菜品详情页/营养中心 | ⭐⭐⭐ | 环形图/进度条展示营养占比，nutrition字段已有数据，需前端可视化组件 |
+| 4 | 🏆 评分排行榜 | `api_hot.php?type=recipe&sort=rate` | api_hot.php | 热门排行页 | ⭐ | 热门页已有Tab，增加"评分榜"排序选项，API已支持sort=rate |
+| 5 | 📱 迷你信息加载 | `api.php?act=mini&id=` | api.php | 列表页/卡片 | ⭐⭐ | 列表页使用mini接口(~1KB)替代detail(~10KB)，10倍性能提升，需改造列表加载逻辑 |
+| 6 | 🔍 排除筛选 | `api_filter.php?act=filter_recipes` exclude_*参数 | api_filter.php | 高级搜索页 | ⭐ | 高级搜索页增加"排除"选项，如排除辣味/油炸等，API已支持7个exclude参数 |
+| 7 | 🌐 IP状态显示 | `api_action.php?act=ip_status` | api_action.php | 菜品详情页 | ⭐ | 评分前显示今日剩余评分次数，ActionRepository已封装fetchIpStatus()但UI未使用 |
+| 8 | 🏷️ 分类标签联动 | `api_filter.php?act=category_tags&category_id=` | api_filter.php | 分类浏览页/高级搜索 | ⭐⭐ | 选择分类后自动加载该分类下的口味+工艺标签，提升筛选体验 |
+| 9 | 🥗 食材分类浏览 | `api_filter.php?act=ingredient_main_categories/sub_categories` | api_filter.php | 发现页/工具中心 | ⭐⭐ | 食材大类→子类→食材列表三级浏览，当前发现页食材分类跳转分类浏览页但无食材专用分类 |
+| 10 | 📋 食谱子分类 | `api_filter.php?act=recipe_sub_categories&parent_id=` | api_filter.php | 分类浏览页 | ⭐ | 当前分类浏览使用api.php?act=categories，改用filter接口可获取更丰富的子分类数据 |
+| 11 | 🎲 筛选步骤引导 | `api_what_to_eat.php?act=filter_steps` | api_what_to_eat.php | 今天吃什么 | ⭐⭐ | 逐步筛选：先选分类→再选标签→显示匹配数量，比当前直接filter_apply体验更好 |
+| 12 | 🔢 编码/模糊查询 | `api_what_to_eat.php?act=detail&code=/title=` | api_what_to_eat.php | 搜索页 | ⭐ | 支持菜谱编码(CP032892)查询和标题模糊搜索，扩展搜索能力 |
+
+### 🟡 需组合API开发（P3优先级）
+
+| # | 功能 | 所需API | 页面位置 | 开发复杂度 | 说明 |
+|---|------|---------|---------|-----------|------|
+| 1 | 🧠 智能推荐 | `api_feed.php?act=recommend` + `api_filter.php?act=filter_recipes` + `gmy.json` + 用户偏好设置 | 首页 | ⭐⭐⭐⭐ | 结合时段+营养+过敏原+用户偏好的智能推荐，需设计推荐算法权重 |
+| 2 | 📅 每日菜单规划 | `api_what_to_eat.php?act=filter_apply` × 3次 + `eating_times.json` | 工具中心 | ⭐⭐⭐ | 一次性生成早中晚餐完整菜单，需新建菜单规划页面 |
+| 3 | 📱 二维码海报 | `api.php?act=detail` code字段 + qr_flutter库 | 菜品详情页 | ⭐⭐ | 生成菜谱二维码分享图，code字段已有(如CP032892) |
+| 4 | 🔗 社交分享增强 | `api.php?act=detail` code字段 + `api_hot.php` statistics | 菜品详情页 | ⭐⭐ | 分享链接含菜谱编码+热度标签，当前分享功能已有但内容简单 |
+| 5 | 🏋️ 健身餐推荐 | `api_filter.php?act=filter_recipes` nutrition_min/max + nutrition_types.json | 工具中心/发现页 | ⭐⭐⭐ | 高蛋白(>30g)/低脂(<10g)/低碳水菜谱筛选，需营养目标设置UI |
+| 6 | 📋 过敏原报告 | `api.php?act=full` allergens + `gmy.json` | 菜品详情页 | ⭐⭐⭐ | 菜谱过敏原完整分析报告，交叉比对585种过敏原数据 |
+| 7 | 🥗 食材营养详情 | `api.php?act=ingredient_detail` + `nutrition_types.json` | 食材详情页 | ⭐⭐ | 食材详情页增加营养成分表格+单位匹配，nutrition_types.json提供31种营养单位 |
+| 8 | 🔄 食材替代建议 | `api_filter.php?act=filter_recipes` ingredient参数 + `gmy.json` | 食材详情页 | ⭐⭐⭐ | 缺少某食材时推荐替代品，需建立食材替代关系映射 |
+| 9 | 📈 营养目标追踪 | `api.php?act=full` nutrition × 多菜谱 + `nutrition_types.json` | 营养中心 | ⭐⭐⭐⭐ | 每日营养摄入统计+目标追踪，需记录用户每日饮食 |
+| 10 | 🏷️ 统一格式输出 | `api.php?act=unified_list/detail/search/hot` type=ingredient | 食材相关页面 | ⭐⭐ | 统一格式简化食材数据处理，当前食材页面使用不同接口格式 |
+
+### 🔴 需后端新开发API
+
+| # | 功能 | 建议接口 | 优先级 | 开发建议 | 说明 |
+|---|------|---------|--------|---------|------|
+| 1 | 👤 用户注册登录 | `api_user.php` | P1 | 暂不开发 | 需要用户认证体系，当前阶段不涉及 |
+| 2 | 💾 收藏云端同步 | `api_favorite.php` | P1 | CRUD接口 | 当前收藏仅本地存储，需云端同步支持多设备 |
+| 3 | 💬 评论系统 | `api_comment.php` | P2 | CRUD+分页 | 互动功能，需防刷+审核机制 |
+| 4 | 🔔 消息推送 | `api_message.php` | P2 | 推送+站内信 | 后续可能使用邮箱实现 |
+| 5 | 📜 浏览历史同步 | `api_history.php` | P2 | CRUD+分页 | 当前仅本地存储，需云端同步 |
+| 6 | 📝 菜谱上传 | `api_recipe.php` | P2 | 表单提交+图片上传 | UGC内容，需审核流程 |
+| 7 | 🔄 相关菜谱推荐 | `api.php?act=related&id=` | P2 | 基于分类+标签+食材相似度 | 详情页底部推荐相似菜品，可基于同分类+同标签实现 |
+| 8 | 🔍 搜索建议/补全 | `api.php?act=suggest&keyword=` | P3 | 前缀匹配+热门词 | 输入时实时建议，需后端建立搜索索引 |
+| 9 | 📊 用户营养目标 | `api_nutrition.php` | P3 | CRUD+每日统计 | 每日营养摄入目标追踪，需用户系统 |
+| 10 | 🏆 用户成就系统 | `api_achievement.php` | P3 | 经验值+等级+徽章 | 需用户系统支撑 |
+| 11 | 📝 烹饪笔记同步 | `api_note.php` | P2 | CRUD+分页 | 当前笔记仅本地Hive存储，需云端同步 |
+| 12 | 🛒 购物清单同步 | `api_shopping.php` | P2 | CRUD | 当前购物清单仅本地存储 |
+| 13 | ⏰ 每周菜单存储 | `api_menu.php` | P2 | CRUD+日期范围 | 当前菜单规划功能无持久化 |
+
+---
+
+### 🎯 推荐开发路线图
+
+#### 第一阶段：快速见效（利用已有API，1-2天/功能）
+
+| 顺序 | 功能 | 价值 | 工作量 |
+|------|------|------|--------|
+| 1 | 🏆 评分排行榜 | 热门页增加评分排序 | 极小(改sort参数) |
+| 2 | 🌐 IP状态显示 | 评分前显示剩余次数 | 极小(已有方法) |
+| 3 | 🔍 排除筛选 | 高级搜索增加排除选项 | 小(增加UI+参数) |
+| 4 | 🕐 用餐时段推荐 | 根据时间智能推荐 | 小(新页面+API) |
+| 5 | ⚠️ 过敏原警示 | 详情页安全提醒 | 小(展示已有字段) |
+
+#### 第二阶段：体验提升（组合API，3-5天/功能）
+
+| 顺序 | 功能 | 价值 | 工作量 |
+|------|------|------|--------|
+| 6 | 📊 营养可视化 | 详情页环形图展示 | 中(可视化组件) |
+| 7 | 🏷️ 分类标签联动 | 筛选体验提升 | 中(联动逻辑) |
+| 8 | 🥗 食材分类浏览 | 食材浏览体验完善 | 中(新页面) |
+| 9 | 🎲 筛选步骤引导 | "吃什么"体验优化 | 中(步骤UI) |
+| 10 | 📱 迷你信息加载 | 列表页性能优化 | 中(改造加载逻辑) |
+
+#### 第三阶段：深度功能（需后端配合或复杂逻辑）
+
+| 顺序 | 功能 | 价值 | 工作量 |
+|------|------|------|--------|
+| 11 | 📅 每日菜单规划 | 菜单规划工具 | 大(新页面+逻辑) |
+| 12 | 🏋️ 健身餐推荐 | 健康饮食功能 | 大(营养目标+筛选) |
+| 13 | 🧠 智能推荐 | 个性化推荐 | 大(推荐算法) |
+| 14 | 🔄 相关菜谱推荐 | 详情页推荐 | 需后端开发API |
+
+---
+
+## 📋 已完成功能记录
+
+> 2026-04-13 更新
+
+| 阶段 | 功能 | 涉及文件 |
+|------|------|---------|
+| 三十二 | 主题色全局生效修复 | DesignTokens.dynamicPrimary替换(59文件439处) |
+| 三十三 | 全局UI统一 | 圆角89处+颜色20处+EmptyState+LoadingIndicator |
+| 三十四 | 食材详情本地缓存 | IngredientModel.toJson+RecipeRepository缓存+CacheManagePage食材管理 |

docs/dev/UNFINISHED_FEATURES.md

@@ -1,6 +1,6 @@
 # 📋 未完成功能清单
 
-> 创建: 2026-04-09 | 更新: 2026-04-13 | 优先级: P1=核心 P2=重要 P3=增强 | 优先级值1-5(5=最高)
+> 创建: 2026-04-09 | 更新: 2026-04-13 v0.92.0 | 优先级: P1=核心 P2=重要 P3=增强 | 优先级值1-5(5=最高)
 
 ---
 
@@ -12,7 +12,7 @@
 | 四：购物清单 | 5 | 5 | 100% | ✅ |
 | 十二：社交+通知增强 | 4 | 2 | 50% | 🟡 |
 | 十三：AI+规划高级功能 | 4 | 4 | 100% | ✅ |
-| 十四：接口能力挖掘 | 8 | 1 | 12% | 🟡 |
+| 十四：接口能力挖掘 | 8 | 8 | 100% | ✅ |
 | 十五：后端接口增强 | 6 | 0 | 0% | 🔴 |
 | 十六：用户体验优化+Bug修复 | 7 | 7 | 100% | ✅ |
 | 十七：紧急Bug修复 | 14 | 14 | 100% | ✅ |
@@ -20,16 +20,20 @@
 | 二十：用户体验优化+交互增强 | 7 | 7 | 100% | ✅ |
 | 二十一：菜谱详情页功能增强 | 1 | 1 | 100% | ✅ |
 | 二十二：Picid功能Bug修复 | 2 | 2 | 100% | ✅ |
-| 二十三：数据管理中心 | 3 | 1 | 33% | 🟡 |
+| 二十三：数据管理中心 | 3 | 2 | 67% | 🟡 |
 | 二十四：笔记+浏览记录功能 | 2 | 2 | 100% | ✅ |
 | 二十六：API v3.2.0迁移 | 5 | 5 | 100% | ✅ |
 | 二十七：首页Discover瀑布流 | 8 | 8 | 100% | ✅ |
 | 二十八：瀑布流渐进式渲染+分页 | 3 | 3 | 100% | ✅ |
 | 二十九：菜品详情页功能完善 | 9 | 9 | 100% | ✅ |
-| 三十：发现页口味/工艺筛选 | 3 | 2 | 67% | 🟡 |
+| 三十：发现页口味/工艺筛选 | 3 | 3 | 100% | ✅ |
 | 三十一：搜索功能修复与高级搜索 | 3 | 3 | 100% | ✅ |
-| 三十二：主题色全局生效修复 | 1 | 1 | 100% | ✅ |
-| **合计** | **192** | **174** | **91%** | |
+| 三十二 | 主题色全局生效修复 | 1 | 1 | 100% | ✅ |
+| 三十三 | 全局UI统一（圆角/颜色/空状态/加载） | 4 | 4 | 100% | ✅ |
+| 三十四 | 食材详情本地缓存+缓存管理 | 2 | 2 | 100% | ✅ |
+| 三十五 | 食材详情页闪退修复 | 1 | 1 | 100% | ✅ |
+| 三十六 | 21项功能批量实现 | 21 | 21 | 100% | ✅ |
+| **合计** | **220** | **210** | **95%** | |
 
 ---
 
@@ -39,96 +43,248 @@
 
 | 序号 | 阶段 | 任务 | 优先级 | 优先级值 | 说明 |
 |------|------|------|--------|---------|------|
-| 1 | 十二 | 🔔 烹饪提醒通知 | P2 | 3 | 定时提醒烹饪步骤，与计时器联动，需 flutter_local_notifications |
-| 2 | 十二 | 📸 拍照记录 | P3 | 2 | 烹饪笔记支持拍照上传 |
-| 3 | 十四 | 🕐 用餐时段推荐 | P2 | 3 | eating_times.json(34种时段)，早餐/午餐/晚餐推荐 |
-| 4 | 十四 | 📊 营养分析增强 | P2 | 3 | nutrition_types.json(31种)，营养详情+目标追踪+图表 |
-| 5 | 十四 | ⚠️ 过敏原警示增强 | P2 | 3 | 菜谱详情页过敏原警示+自动过滤+替代建议 |
-| 6 | 十四 | 🏆 点赞/推荐系统 | P2 | 2 | 五星评分+评价统计+排行榜（部分已在阶段29实现） |
-| 7 | 十四 | 📱 二维码海报 | P3 | 2 | 生成菜谱二维码分享图 |
-| 8 | 十四 | 🔗 社交分享增强 | P3 | 2 | 分享链接+热度标签+社交平台 |
-| 9 | 十五 | 👤 用户注册登录 | P1 | 5 | 需后端支持，当前暂不开发 |
-| 10 | 十五 | 💾 收藏云端同步 | P1 | 4 | 需后端支持 |
-| 11 | 十五 | 💬 评论系统 | P2 | 3 | 需后端支持 |
-| 12 | 十五 | 🔔 消息推送 | P2 | 2 | 需后端支持 |
-| 13 | 十五 | 📜 浏览历史同步 | P2 | 2 | 需后端支持 |
-| 14 | 十五 | 📝 菜谱上传 | P2 | 2 | 需后端支持 |
-| 15 | 二十三 | ⚠️ 过敏原智能过滤 | P2 | 3 | 搜索/推荐时自动过滤含用户过敏原的菜品 |
-| 16 | 三十 | 🔗 相关菜谱推荐 | P2 | 3 | 详情页底部添加相关菜谱列表 |
+| 1 | 十五 | 👤 用户注册登录 | P1 | 5 | 需后端支持，当前暂不开发 |
+| 2 | 十五 | 💾 收藏云端同步 | P1 | 4 | 需后端支持 |
+| 3 | 十二 | 🔔 烹饪提醒通知 | P2 | 3 | 定时提醒烹饪步骤，需 flutter_local_notifications |
+| 4 | 二十三 | ⚠️ 过敏原智能过滤 | P2 | 3 | 搜索/推荐时自动过滤含用户过敏原的菜品 |
+| 5 | 十五 | 💬 评论系统 | P2 | 3 | 需后端支持 |
+| 6 | 十五 | 🔔 消息推送 | P2 | 2 | 需后端支持 |
+| 7 | 十五 | 📜 浏览历史同步 | P2 | 2 | 需后端支持 |
+| 8 | 十五 | 📝 菜谱上传 | P2 | 2 | 需后端支持 |
+| 9 | 十四 | 📱 二维码海报 | P3 | 2 | 生成菜谱二维码分享图 |
+| 10 | 十四 | 🔗 社交分享增强 | P3 | 2 | 分享链接+热度标签+社交平台 |
+| 11 | 十二 | 📸 拍照记录 | P3 | 2 | 烹饪笔记支持拍照上传 |
+
+---
+
+## 🟢 已有API可直接开发的功能（优先开发）
+
+> 以下功能后端API已就绪，仅需前端开发
+
+### 第一梯队：极小工作量（改参数/加UI）
+
+| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
+|---|------|---------|---------|--------|------|
+| 1 | 🏆 评分排行榜 | `api_hot.php?sort=rate` | 热门排行页 | ⭐ | ✅ v0.92.0 |
+| 2 | 🌐 IP状态显示 | `api_action.php?act=ip_status` | 菜品详情页 | ⭐ | ✅ v0.92.0 |
+| 3 | 🔍 排除筛选 | `api_filter.php?act=filter_recipes` exclude_*参数 | 高级搜索页 | ⭐ | ✅ v0.92.0 |
+| 4 | 📋 食谱子分类 | `api_filter.php?act=recipe_sub_categories&parent_id=` | 分类浏览页 | ⭐ | ✅ v0.92.0 |
+| 5 | 🔢 编码/模糊查询 | `api_what_to_eat.php?act=detail&code=/title=` | 搜索页 | ⭐ | ✅ v0.92.0 |
+
+### 第二梯队：小工作量（新页面+API调用）
+
+| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
+|---|------|---------|---------|--------|------|
+| 6 | 🕐 用餐时段推荐 | `api_filter.php?act=meal_times` | 首页/工具中心 | ⭐⭐ | ✅ v0.92.0 |
+| 7 | ⚠️ 过敏原警示 | `api.php?act=full` allergens字段 | 菜品详情页 | ⭐⭐ | ✅ v0.92.0 |
+| 8 | 🏷️ 分类标签联动 | `api_filter.php?act=category_tags&category_id=` | 分类浏览/高级搜索 | ⭐⭐ | ✅ v0.92.0 |
+| 9 | 🥗 食材分类浏览 | `api_filter.php?act=ingredient_main_categories/sub_categories` | 发现页/工具中心 | ⭐⭐ | ✅ v0.92.0 |
+| 10 | 🎲 筛选步骤引导 | `api_what_to_eat.php?act=filter_steps` | 今天吃什么 | ⭐⭐ | ✅ v0.92.0 |
+| 11 | 🥗 食材对应菜品 | `api_filter.php?act=ingredient_recipes&ingredient_id=` | 食材详情页 | ⭐⭐ | ✅ v0.92.0 |
+| 12 | 🔍 食材筛选 | `api_filter.php?act=filter_ingredients` | 高级搜索页 | ⭐⭐ | ✅ v0.92.0 |
+
+### 第三梯队：中等工作量（需可视化组件/逻辑重构）
+
+| # | 功能 | API接口 | 页面位置 | 工作量 | 状态 |
+|---|------|---------|---------|--------|------|
+| 13 | 📊 营养可视化 | `api.php?act=full` nutrition字段 | 菜品详情页/营养中心 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 14 | 📱 迷你信息加载 | `api.php?act=mini` | 列表页/卡片 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 15 | 🏷️ 统一格式输出 | `api.php?act=unified_list/detail/hot` type=ingredient | 食材相关页面 | ⭐⭐⭐ | 待开发 |
+| 16 | 🏋️ 健身餐推荐 | `api_filter.php?act=filter_recipes` nutrition_min/max | 工具中心/发现页 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 17 | 📋 过敏原报告 | `api.php?act=full` allergens + gmy.json | 菜品详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 18 | 🔎 查重检测 | `api_check_duplicate.php` 5种act | 菜谱上传/管理 | ⭐⭐⭐ | ✅ v0.92.0 |
+
+---
+
+## 🟡 需组合API开发的功能
+
+> 需要多个已有API组合，或需前端复杂逻辑
+
+| # | 功能 | 所需API | 页面位置 | 工作量 | 状态 |
+|---|------|---------|---------|--------|------|
+| 1 | 🧠 智能推荐 | `api_feed.php?act=recommend` + `api_filter.php` + 用户偏好 | 首页 | ⭐⭐⭐⭐ | 待开发 |
+| 2 | 📅 每日菜单规划 | `api_what_to_eat.php?act=filter_apply` × 3次 + eating_times.json | 工具中心 | ⭐⭐⭐ | 待开发 |
+| 3 | 📱 二维码海报 | `api.php?act=detail` code字段 + qr_flutter库 | 菜品详情页 | ⭐⭐ | 待开发 |
+| 4 | 🔗 社交分享增强 | `api.php?act=detail` code字段 + `api_hot.php` statistics | 菜品详情页 | ⭐⭐ | 待开发 |
+| 5 | 🥗 食材营养详情 | `api.php?act=ingredient_detail` + nutrition_types.json | 食材详情页 | ⭐⭐ | ✅ v0.92.0 |
+| 6 | 🔄 食材替代建议 | `api_filter.php?act=filter_recipes` ingredient参数 + gmy.json | 食材详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 7 | 📈 营养目标追踪 | `api.php?act=full` nutrition × 多菜谱 + nutrition_types.json | 营养中心 | ⭐⭐⭐⭐ | ✅ v0.92.0 |
+| 8 | 📊 运营数据大屏 | `stats_full.php` stats/online/request/hot | 管理后台 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 9 | 🔄 相关菜谱推荐 | `api.php?act=list` cate_id + tag_id 组合查询 | 菜品详情页 | ⭐⭐⭐ | ✅ v0.92.0 |
+| 10 | 🍳 烹饪模式 | `api.php?act=full` content字段 + 计时器 | 菜品详情页 | ⭐⭐⭐ | 待开发 |
+
+---
+
+## 🔴 需后端新开发API
+
+> 以下功能当前后端无对应接口，需后端开发
+
+| # | 功能 | 建议接口 | 优先级 | 说明 | 可替代方案 |
+|---|------|---------|--------|------|-----------|
+| 1 | 👤 用户注册登录 | `api_user.php` | P1 | 暂不开发 | — |
+| 2 | 💾 收藏云端同步 | `api_favorite.php` | P1 | 多设备同步 | 当前本地Hive存储 |
+| 3 | 💬 评论系统 | `api_comment.php` | P2 | CRUD+分页+审核 | — |
+| 4 | 🔔 消息推送 | `api_message.php` | P2 | 推送+站内信 | 后续可能用邮箱 |
+| 5 | 📜 浏览历史同步 | `api_history.php` | P2 | CRUD+分页 | 当前本地存储 |
+| 6 | 📝 菜谱上传 | `api_recipe.php` | P2 | 表单+图片上传+审核 | — |
+| 7 | 🔍 搜索建议/补全 | `api.php?act=suggest&keyword=` | P3 | 前缀匹配+热门词 | 本地搜索历史替代 |
+| 8 | 📊 用户营养目标 | `api_nutrition.php` | P3 | CRUD+每日统计 | 当前本地GoalSettingPage |
+| 9 | 🏆 用户成就系统 | `api_achievement.php` | P3 | 经验值+等级+徽章 | — |
+| 10 | 📝 烹饪笔记同步 | `api_note.php` | P2 | CRUD+分页 | 当前本地Hive存储 |
+| 11 | 🛒 购物清单同步 | `api_shopping.php` | P2 | CRUD | 当前本地存储 |
+| 12 | ⏰ 每周菜单存储 | `api_menu.php` | P2 | CRUD+日期范围 | 当前无持久化 |
+| 13 | 🔄 相关菜谱推荐 | `api.php?act=related&id=` | P2 | 基于分类+标签+食材相似度 | 可用现有API组合替代 |
+
+---
+
+## 🎯 推荐开发路线图
+
+### 第一阶段：快速见效（1-2天/功能）
+
+| 顺序 | 功能 | 价值 | 工作量 | API状态 |
+|------|------|------|--------|---------|
+| 1 | 🏆 评分排行榜 | 热门页增加评分排序 | 极小 | ✅已可用 |
+| 2 | 🌐 IP状态显示 | 评分前显示剩余次数 | 极小 | ✅已封装 |
+| 3 | 🔍 排除筛选 | 高级搜索增加排除选项 | 小 | ✅已可用 |
+| 4 | 🕐 用餐时段推荐 | 根据时间智能推荐 | 小 | ✅已可用 |
+| 5 | ⚠️ 过敏原警示 | 详情页安全提醒 | 小 | ✅数据已有 |
+
+### 第二阶段：体验提升（3-5天/功能）
+
+| 顺序 | 功能 | 价值 | 工作量 | API状态 |
+|------|------|------|--------|---------|
+| 6 | 📊 营养可视化 | 详情页环形图展示 | 中 | ✅数据已有 |
+| 7 | 🏷️ 分类标签联动 | 筛选体验提升 | 中 | ✅已可用 |
+| 8 | 🥗 食材分类浏览 | 食材浏览体验完善 | 中 | ✅已可用 |
+| 9 | 🎲 筛选步骤引导 | "吃什么"体验优化 | 中 | ✅已可用 |
+| 10 | 📱 迷你信息加载 | 列表页性能优化 | 中 | ✅已可用 |
+
+### 第三阶段：深度功能（需后端配合或复杂逻辑）
+
+| 顺序 | 功能 | 价值 | 工作量 | API状态 |
+|------|------|------|--------|---------|
+| 11 | 📅 每日菜单规划 | 菜单规划工具 | 大 | ✅组合可用 |
+| 12 | 🏋️ 健身餐推荐 | 健康饮食功能 | 大 | ✅已可用 |
+| 13 | 🧠 智能推荐 | 个性化推荐 | 大 | ✅组合可用 |
+| 14 | 🔄 相关菜谱推荐 | 详情页推荐 | 中 | 🟡可组合/🔴需新API |
 
 ---
 
 ## ✅ 已完成阶段（精简记录）
 
-### 阶段二十九：菜品详情页功能完善 ✅
-- ⭐ RecipeRating模型（score/nums/display/status/level/star）
-- 📊 RecipeStatistics更新（rateNums/rateScore/rating）
-- 📈 RecipeStatisticsBar重构（星级+评分文本+等级标签）
-- 🖼️ RecipeCoverImage评分徽章
-- 🏷️ 标签点击跳转TagRecipeListPage
-- 📂 分类面包屑点击跳转CategoryBrowsePage
+### 阶段三十五：食材详情页闪退修复 ✅
+- 🐛 setState() after dispose() 修复，4处添加mounted检查
+- 🍃 CupertinoIcons.leaf→Icons.eco 修复
 
-### 阶段三十：发现页口味/工艺筛选 🟡（1项未完成）
-- ✅ 口味标签筛选（3列网格→TagRecipeListPage）
-- ✅ 工艺标签筛选（3列网格→TagRecipeListPage）
-- ❌ 相关菜谱推荐（详情页底部）
+### 阶段三十四：食材详情本地缓存+缓存管理 ✅
+- 🥬 IngredientModel.toJson + IngredientStatistics.toJson 序列化方法
+- 💾 RecipeRepository.fetchIngredientDetail 缓存逻辑（7天有效期，优先读取本地）
+- 🗑️ CacheManagePage 食材缓存管理（概览+操作+列表+左滑删除）
 
-### 阶段三十一：搜索功能修复与高级搜索 ✅
-- 🔍 切换到global_search接口，4-Tab结果（菜谱/食材/口味/工艺）
-- ⚙️ 高级搜索页面（分类/口味/工艺/时段筛选）
-- 🏠 食材详情返回首页
+### 阶段三十三：全局UI统一（圆角/颜色/空状态/加载） ✅
+- 📐 统一圆角：89处硬编码 → DesignTokens变量
+- 🎨 统一颜色：20处硬编码 → DesignTokens变量
+- 💎 增强EmptyState：毛玻璃卡片+图标圆形背景
+- 🔄 增强LoadingIndicator：毛玻璃卡片+主题色指示器
 
 ### 阶段三十二：主题色全局生效修复 ✅
-- 🎨 根因：UI组件使用 `DesignTokens.primary`（静态常量），切换主题色后不刷新
-- 🔧 批量替换为 `DesignTokens.dynamicPrimary`（59个文件，439处引用）
-- 📐 修复const上下文和默认参数值兼容问题
+- 🎨 批量替换为 DesignTokens.dynamicPrimary（59个文件，439处引用）
 
-### 阶段二十七：首页Discover瀑布流 ✅
-- MasonryGridView 2列瀑布流，5种卡片类型混合展示
+### 阶段三十一：搜索功能修复与高级搜索 ✅
+- 🔍 切换到global_search接口，4-Tab结果
+- ⚙️ 高级搜索页面
 
-### 阶段二十八：瀑布流渐进式渲染+分页 ✅
-- 渐进式渲染+骨架屏+入场动画+到底刷新按钮+分页加载
+### 阶段三十六：21项功能批量实现 ✅
+- 🏆 评分排行榜：HotPage sort=rate排序（HotRepository+HotController+HotPage三层联动）
+- 🌐 IP状态显示：菜品详情页评分前显示剩余次数
+- 🔍 排除筛选：高级搜索页增加7个exclude参数筛选
+- 📋 食谱子分类：分类浏览页支持子分类展开
+- 🔢 编码/模糊查询：搜索页支持code和title查询
+- 🕐 用餐时段推荐：MealTimeRecommendPage完善
+- ⚠️ 过敏原警示：菜品详情页过敏原警告+AllergenReportPage过敏原报告
+- 🏷️ 分类标签联动：高级搜索页选择分类自动加载标签
+- 🎲 筛选步骤引导：WhatToEatPage 3步引导指示器
+- 📊 营养可视化：NutritionRingChart环形图+热量进度条
+- 📱 迷你信息加载：RecipeRepository.fetchMiniRecipe
+- 🏋️ 健身餐推荐：营养中心减脂/增肌/生酮/碳水补充入口
+- 📋 过敏原报告：AllergenReportPage完整报告页
+- 🔎 查重检测：DuplicateCheckPage 5种查重模式
+- 🎯 今天吃什么增强：筛选步骤引导+3步指示器
+- 🔄 食材替代建议：IngredientDetailPage 30+食材替代映射
+- 🍽️ 相似菜品推荐：RecipeSimilarSection组件
+- 🍽️ 食材相关菜谱：IngredientDetailPage底部菜谱列表
+- 📈 运营数据大屏：StatsDashboardPage
+- 📈 数据管理中心增强：DataCenterPage新增运营大屏入口
+- 🔧 代码质量：flutter analyze零错误
+
+### 阶段三十：发现页口味/工艺筛选 ✅
+- ✅ 口味标签筛选 / ✅ 工艺标签筛选
+- ✅ 相关菜谱推荐（详情页底部）— v0.92.0实现
+
+### 阶段二十九：菜品详情页功能完善 ✅
+- ⭐ RecipeRating模型 + 评分展示 + 标签跳转 + 分类面包屑
+
+### 阶段二十七/二十八：首页Discover瀑布流+渐进式渲染 ✅
+- MasonryGridView 2列瀑布流 + 渐进式渲染+骨架屏+分页
 
 ### 阶段二十四：笔记+浏览记录 ✅
-- 笔记标签+菜品快捷输入+SharedPreferences双重存储
-- 浏览记录模型+控制器+页面+自动记录
+- 笔记标签+菜品快捷输入 + 浏览记录自动记录
 
-### 阶段二十三：数据管理中心 🟡（1项未完成）
-- ✅ 数据管理中心页面（分类标签+过敏原管理）
-- ✅ LocalDataService（SharedPreferences+API同步+24h缓存）
+### 阶段二十三：数据管理中心 🟡
+- ✅ 数据管理中心页面 + LocalDataService
 - ❌ 过敏原智能过滤
 
-### 阶段十二：社交+通知增强 🟡（2项未完成）
-- ✅ 分享菜谱（share_plus）
-- ✅ 搜索建议/热词（API获取）
-- ❌ 烹饪提醒通知
-- ❌ 拍照记录
+### 阶段十二：社交+通知增强 🟡
+- ✅ 分享菜谱 + 搜索建议/热词
+- ❌ 烹饪提醒通知 / ❌ 拍照记录
 
 ### 阶段十三：AI+规划高级功能 ✅
 - AI菜谱推荐+每周菜单规划+食材用量换算+就寝提醒
 
 ---
 
-## 🔴 阶段十五：后端接口增强（需后端支持）
+## 📊 API接口使用状态一览
 
-| 任务 | 建议接口 | 优先级 | 说明 |
-|------|---------|--------|------|
-| 👤 用户注册登录 | api_user.php | P1 | 暂不开发 |
-| 💾 收藏云端同步 | api_favorite.php | P1 | 多设备同步 |
-| 💬 评论系统 | api_comment.php | P2 | 互动功能 |
-| 🔔 消息推送 | api_message.php | P2 | 站内信+推送 |
-| 📜 浏览历史同步 | api_history.php | P2 | 云端存储 |
-| 📝 菜谱上传 | api_recipe.php | P2 | UGC内容 |
+> 基于 API_DOC.md v3.2.0 + APP_GUIDE.md v2.9.0
 
----
+### ✅ 已使用接口
 
-## 🟢 阶段十四：接口能力挖掘（待开发）
+| 接口文件 | Repository | 已用act |
+|---------|-----------|---------|
+| `api.php` | RecipeRepository | list/detail/full/ingredients/ingredient_detail/search/categories/tags/stats/unified_list/unified_detail/unified_search/unified_hot/query |
+| `api_action.php` | ActionRepository | like/rate/view/ip_status |
+| `api_feed.php` | FeedRepository | recommend/latest/hot/prefetch |
+| `api_filter.php` | RecipeRepository+SearchController | recipe_main_categories/taste_tags/cooking_tags/filter_recipes/global_search |
+| `api_hot.php` | HotRepository | hot(today/month/total) |
+| `api_what_to_eat.php` | WhatToEatRepository | filter_apply/detail |
+| `api_discover.php` | DiscoverRepository | 随机数据 |
+| `stats_full.php` | StatsRepository+OnlineRepository | online/request/hot/heartbeat |
 
-| 任务 | 数据源 | 优先级 | 说明 |
-|------|--------|--------|------|
-| 🕐 用餐时段推荐 | eating_times.json(34种) | P2 | 早餐/午餐/晚餐推荐 |
-| 📊 营养分析增强 | nutrition_types.json(31种) | P2 | 营养详情+追踪+图表 |
-| ⚠️ 过敏原警示增强 | gmy.json(585种) | P2 | 详情页警示+自动过滤 |
-| 🏆 点赞/推荐系统 | api_action.php | P2 | 评分+排行榜（部分已实现） |
-| 📱 二维码海报 | code字段 | P3 | 生成分享图 |
-| 🔗 社交分享增强 | code字段 | P3 | 链接+热度标签 |
+### ❌ 未使用接口（可直接调用）
+
+| 接口 | act | 功能 | 可开发功能 |
+|------|-----|------|-----------|
+| `api.php` | mini | 迷你版菜谱(~1KB) | 列表页性能优化 |
+| `api_filter.php` | meal_times | 用餐时段列表 | 时段推荐 |
+| `api_filter.php` | recipe_sub_categories | 食谱子分类 | 分类浏览增强 |
+| `api_filter.php` | ingredient_main_categories | 食材大类 | 食材分类浏览 |
+| `api_filter.php` | ingredient_sub_categories | 食材子分类 | 食材三级浏览 |
+| `api_filter.php` | category_tags | 分类下标签 | 标签联动筛选 |
+| `api_filter.php` | filter_ingredients | 食材筛选 | 高级搜索食材 |
+| `api_filter.php` | ingredient_recipes | 食材对应菜品 | 食材详情页菜品列表 |
+| `api_filter.php` | index | 接口索引 | 调试/接口文档 |
+| `api_what_to_eat.php` | filter_steps | 筛选步骤引导 | "吃什么"步骤UI |
+| `api_hot.php` | sort=rate | 评分排行 | 评分排行榜 |
+| `api_filter.php` | exclude_*参数(7个) | 排除筛选 | 高级搜索排除选项 |
+| `api_filter.php` | nutrition_min/max | 营养范围筛选 | 健身餐推荐 |
+| `api_check_duplicate.php` | 5种act | 查重检测 | 菜谱上传查重 |
+| `api.php` | unified_* type=ingredient | 统一格式食材 | 食材数据标准化 |
+| `stats_full.php` | stats layer=detail/full | 详细/完整统计 | 运营数据大屏 |
+
+### ❌ 未使用静态资源
+
+| 文件 | 数据量 | 当前使用情况 | 可开发功能 |
+|------|--------|-------------|-----------|
+| `eating_times.json` | 34种时段 | 仅meal_time_recommend_page直接HTTP请求 | 用餐时段推荐 |
+| `nutrition_types.json` | 31种营养(含单位) | ❌完全未使用 | 营养可视化+目标追踪 |
+| `gmy.json` | 585种过敏原(21大类) | 仅allergen_checker_page直接HTTP请求 | 过敏原警示+报告 |