重构目录树

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请求 | 过敏原警示+报告 |