kitchen/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

[0.98.9] - 2026-04-18

✨ 新增 — 菜谱分享本地存储 + 3天自动过期清理

菜谱分享数据推送（Flutter → PHP）

• 📤 RecipeShareService：新增菜谱分享数据推送服务，将菜谱数据推送到 recipe_share.php 本地存储
• 🔄 先推送后生成：二维码海报生成前先推送数据到服务器，推送失败仍显示海报（降级策略）
• 📱 完整数据推送：推送菜谱标题/简介/封面/分类/食材/营养/评分等完整信息
• 🎯 CRUD接口：支持创建/更新/删除菜谱分享数据

recipe_share.php 重构

• 💾 本地JSON存储：从调用外部API改为本地JSON文件存储（cache/kitchen/recipe_*.json）
• ⏰ 3天自动过期：数据写入时自动设置3天过期时间，读取时自动检查并清理过期文件
• 🧹 清理接口：新增 ?act=cleanup 接口，手动清理所有过期数据
• 📋 数据目录共享：与 kitchen.php 共享 cache/kitchen/ 目录

二维码海报组件改进

• 🎨 加载提示：推送数据时显示 CupertinoActivityIndicator 加载动画
• 📦 RecipeModel传递：showQrPosterSheet 新增 recipe 参数，支持完整菜谱数据传递
• 🔗 recipe_action_bar：新增 recipe 字段，详情页传递完整菜谱对象

修改文件

• lib/src/services/data/recipe_share_service.dart — 新增菜谱分享数据推送服务
• lib/src/widgets/recipe_detail/interaction/recipe_qr_poster.dart — 改为先推送数据再生成二维码
• lib/src/widgets/recipe_detail/interaction/recipe_action_bar.dart — 新增 recipe 参数
• lib/src/pages/home/recipe_detail_page.dart — 传递 recipe 到操作栏
• docs/api/recipe_share.php — 重构为本地存储，新增3天过期清理功能

[0.98.8] - 2026-04-18

✨ 新增 — 二维码分享URL生成 + PHP分享页面

二维码URL生成

• 🔗 QR URL重构：二维码URL从硬编码改为通过 ApiConfig.baseUrl 动态生成
• 📱 URL格式：https://eat.wktyl.com/api/recipe_share.php?code=CP00001 或 ?id=123
• 🆔 双重参数：支持 code（菜谱编码）和 recipeId（数字ID）两种查询方式
• 🔄 降级策略：优先使用 code，无 code 时使用 recipeId，均无则生成 app scheme URL

PHP分享页面（recipe_share.php）

• 🍳 美观分享页：iOS风格设计，深色模式自适应，毛玻璃效果，流畅动画
• 📊 访问统计：自动记录每次扫码访问，按菜谱统计浏览量
• 📝 访问日志：记录IP、UA、来源等，保留最近200条
• 🏷️ OG标签：支持微信/社交媒体分享预览（标题/描述/封面图）
• 🔌 API代理：通过调用 api.php 获取数据，不直接查询数据库
• 📈 管理接口：?act=stats 查看统计、?act=log 查看日志、?act=api 返回JSON

修改文件

• lib/src/widgets/recipe_detail/interaction/recipe_qr_poster.dart — QR URL生成逻辑重构，新增 recipeId 参数
• lib/src/widgets/recipe_detail/interaction/recipe_action_bar.dart — 新增 recipeId 传递
• lib/src/pages/home/recipe_detail_page.dart — 传入 recipe.id 到二维码组件
• docs/api/recipe_share.php — 新增PHP分享页面

[0.98.7] - 2026-04-18

✨ 新增 — 口味偏好持久化 + 菜品详情页偏好标注

口味偏好持久化

• 💾 TastePreferenceService：新增口味偏好持久化服务，所有偏好值写入 SharedPreferences
• 🥗 饮食类型/辣度/口味/烹饪水平/人数/健康目标：6项偏好值全部持久化，应用重启后自动恢复
• 🔄 PreferencePage 接入：偏好设置页改用 TastePreferenceService 读写，移除本地 State 临时变量
• 🧹 枚举统一：DietType/SpiceLevel/CookingLevel/ServingSize/HealthGoal 统一定义在 TastePreferenceService 中

菜品详情页偏好标注

• 💚 我的偏好卡片：在菜品详情页过敏原警告下方新增「我的偏好」标注卡片
• 🌶️ 辣度匹配：对比用户辣度偏好与菜品口味标签，标注「很匹配/一般/不太匹配」
• 👅 口味匹配：对比用户甜/咸/酸偏好与菜品口味，计算匹配度
• 👨‍🍳 难度匹配：对比用户烹饪水平与菜品难度，标注匹配度
• 🥗 饮食类型匹配：检测菜品食材是否包含用户饮食禁忌（素食/纯素/低碳水/生酮/清真等）
• ⚠️ 过敏原标注：只标注用户选择的过敏原，显示「安全」或「含过敏原」

修改文件

• lib/src/services/user/taste_preference_service.dart — 新增口味偏好持久化服务
• lib/src/pages/profile/settings/preference_page.dart — 接入 TastePreferenceService
• lib/src/widgets/recipe_detail/info/recipe_taste_preference.dart — 新增菜品偏好标注组件
• lib/src/pages/home/recipe_detail_page.dart — 集成偏好标注组件
• lib/src/app_binding.dart — 注册 TastePreferenceService

[0.98.6] - 2026-04-18

✨ 新增与改进

软件信息页面

• 🖼️ 头部卡片图标：将 emoji 替换为应用图标 icon_128x128.png，图标与文本左右居中对齐
• 📦 assets/icons 注册：在 pubspec.yaml 中添加 assets/icons/ 资源目录

参考文献页面

• 📚 新增参考文献：从 8 条扩充至 18 条，覆盖 BMI、过敏原、特殊人群、烹饪安全、慢病防控、GI 数据库等
• 🏷️ 分类标签优化：分类名增加 emoji 前缀（🥗 营养健康、⚠️ 过敏原、⚖️ 体重管理等）

偏好设置页面（重写）

• 🥗 饮食类型：普通/素食/纯素/低碳水/生酮/地中海/清真
• 🌶️ 辣度偏好：不吃辣/微辣/中辣/重辣/变态辣
• 👅 口味偏好：甜度/咸度/酸度滑块调节
• 👨‍🍳 烹饪水平：厨房小白/入门选手/熟练厨师/厨艺大师
• 🍚 每餐人数：1-2人/3-4人/5人+
• 🎯 健康目标：减脂/增肌/控糖/心血管/肠胃/免疫/骨骼（多选）
• ✅ 偏好摘要卡片：底部汇总所有偏好设置
• 🔄 重置功能：一键重置所有偏好

路由修复

• 🐛 修复 /about 路由未注册：在 PageRegistry.registerAll 中补充 about/privacyPolicy/guide 路由
• 🐛 修复 app_routes.dart 乱码：'分类浏览' 替换损坏的 Unicode 字符

[0.98.5] - 2026-04-18

✨ 新增 — 软件信息页面 + 了解我们页面

软件信息页面

• 📱 新增软件信息页面：展示应用版本、技术栈、构建信息、后端服务、设备信息、更新日志
• 🎨 毛玻璃头部卡片：渐变背景 + BackdropFilter 毛玻璃效果，展示应用名称和版本
• ⚙️ 技术栈展示：2×2 网格布局展示 Dart / GetX / Hive / Dio 技术栈
• 🔨 构建信息：版本号、内部版本号、打包时间、Build SDK，支持点击复制
• 🖥️ 后端服务信息：展示 PHP / Nginx / API 地址
• 📱 设备信息：操作系统、设备类型、Dart 版本（动态获取）、渲染引擎（三层检测+标注）、屏幕尺寸和像素密度
• 🎨 渲染引擎检测：三层检测机制（API → 引擎 → 平台），使用 defaultTargetPlatform + TargetPlatform.ohos 精准识别
• 🐛 修复鸿蒙端设备信息显示 Unknown：PlatformUtils.isHarmonyOS 改用 Platform.isOhos 替代字符串匹配
• 🐛 修复鸿蒙端渲染引擎显示默认：改用 defaultTargetPlatform 枚举匹配，鸿蒙端正确显示 Impeller (平台)
• 📋 更新日志：展示版本更新记录
• 🔓 隐藏开发者模式：连续点击 Flutter 标签 5 次激活开发者模式
• 📄 开源框架弹窗：展示所有依赖的开源协议
• 🔗 关于页面入口修改：软件信息从打开 URL 改为跳转 AppInfoPage

了解我们页面

• 📖 了解我们页面：新增 LearnUsPage，展示开发者信息、团队信息、官网链接和ICP备案号
• 🔗 关于页面入口：关于页面"了解我们"入口从打开外部链接改为跳转新页面
• 🎨 iOS风格UI：使用 CupertinoPageScaffold + DesignTokens 统一主题，支持深色模式
• 📋 链接确认弹窗：点击外部链接时弹出 CupertinoAlertDialog 确认，支持复制链接

修改文件

• lib/src/pages/profile/app_info_page.dart — 新增软件信息页面
• lib/src/pages/profile/learn_us_page.dart — 新增了解我们页面
• lib/src/pages/profile/about_page.dart — 软件信息/了解我们入口改为跳转新页面

[0.98.4] - 2026-04-18

🐛 修复 — 小妈菜园交互优化 + 商店布局修复

变更

• 🔇 消息限流机制：添加 Toast 限流（5秒内最多2次，10秒内最多3次），重复消息自动过滤，避免气泡弹出过于频繁
• 🔄 消息系统统一：所有 Get.snackbar 替换为 ToastService，统一使用项目消息服务
• 📐 商店布局重构：种子商店卡片从单行布局改为上下分行（名称+购买按钮同行，信息标签换行），使用 Wrap 防止溢出
• 📤 分享功能确认：FarmShareUtil 已支持图片+文本分享（Share.shareXFiles + text），无需修改

修改文件

• lib/src/controllers/farm/farm_game_controller.dart — 添加消息限流、替换 Get.snackbar
• lib/src/controllers/farm/farm_shop_controller.dart — 替换 Get.snackbar 为 ToastService
• lib/src/pages/tools/farm/farm_shop_page.dart — 重构卡片布局，信息标签和购买按钮分行

📌 已移除较早版本记录(0.98.3及之前)，功能已归档至软件特性清单。