CoupleChef

情侣厨伴（CoupleChef）是一个面向情侣双端协作的 Android 应用，目标是解决“今天吃什么”的决策问题，并结合库存、营养、点菜偏好和计划提醒进行推荐。

当前状态

• 开发阶段：MVP 持续迭代中
• 维护者：mmoyager
• 当前使用场景：家庭内部（两人）

技术栈

• Kotlin
• Jetpack Compose
• Room (本地数据)
• ZXing (二维码生成/识别)
• TensorFlow Lite + ML Kit Image Labeling (离线识别能力)
• Nearby Connections (双人端侧通信)
• 可插拔 LLM Provider（Gemini/OpenAI 兼容/智谱/转发服务）

已实现模块（持续更新）

• 四个一级页：饮食、推荐、计划、我的
• 饮食工作台：统一待确认清单（采购语境解析 / 做饭语境解析）
• 推荐流程：本地规则 + AI 增强推荐（可中断并使用部分结果）
• 点菜与计划：未来计划、提醒调度、倒计时展示
• 我的：资料编辑、口味档案、二维码绑定、连接管理、照片墙、设置
• 伴侣同步：Nearby 连接 + 同步状态提示

快速运行

Set-Location "G:\Documents\cc\CoupleChef"
.\gradlew.bat :app:assembleDebug
.\gradlew.bat :app:installDebug

本地检查

Set-Location "G:\Documents\cc\CoupleChef"
.\gradlew.bat :app:assembleDebug :app:testDebugUnitTest
.\gradlew.bat :app:lintDebug

交互说明（关键）

• 当你在 我的 页进入二级子页面时，底部四栏导航会随主页面滑出隐藏。
• 只有返回 我的 一级页后，底部四栏导航才会随主页面滑入显示，防止跨层误切页。

目录结构（简化）

• app/src/main/java/com/couplechef/data 数据层（Room/Repository/Sync）
• app/src/main/java/com/couplechef/ui 页面与导航
• app/src/main/java/com/couplechef/ml 离线识别能力
• app/src/main/java/com/couplechef/llm Provider 配置与调用

项目清理约定

• 保留：app/src、Gradle 配置、README.md、CONTRIBUTING.md、LICENSE
• 不保留：本地构建产物和缓存目录（如 app/build、build、.gradle、.kotlin）
• 文档统一入口：仅使用 README.md，不再维护误拼写文档

说明

• 当前 Launcher 图标仍使用默认模板资源，后续将替换为自定义情侣主题 logo。
• 文案以中文为主，同时保留英文资源占位，便于后续扩展。