银歌餐盘识别模式与餐饮版 SDK 3.2.3 集成记录

• 日期：2026-09-29
• 项目：AIDishRecognition
• 最终状态：DONE_WITH_CONCERNS
• 状态说明：业务模式切换、SDK 重初始化、设置页联动、学习入口隔离和 Maven 依赖迁移均已完成；单元测试和 Debug APK 构建通过。尚未在安装餐饮版 AI 插件的目标设备上执行真实相机与餐盘模型回归，因此保留真机验收项。

变更目标

将 yingeoai-sdk-restaurant-demo 中的餐盘分类模式接入当前项目，并将银歌 SDK 从本地 libs 中的 3.0.3 AAR 切换为厂商 Maven 仓库提供的餐饮版 com.yingeo.ai:sdk-restaurant:3.2.3。

实现摘要

1. 在识别设置中新增“菜品识别/餐盘识别”业务模式与“通用/加速”运行模式。
2. 餐盘识别使用 BusinessMode.CLASSIFICATION，运行时强制模型通道为 A1；用户原先选择的菜品模型通道继续保留，切回菜品识别后恢复使用。
3. 业务模式、模型通道或运行模式发生有效变化时，由 AiSdkManager 统一暂停识别并清空结果、调用 unInitAiService()、应用新配置并重新初始化；成功后通知设置页和识别页恢复。
4. 重复点击当前已选业务模式不触发 SDK 重启。
5. 餐盘模式隐藏模型通道设置；首页隐藏菜品学习入口，并对学习页直达及识别页学习操作增加模式保护。
6. 增加餐饮版插件类型不匹配状态，避免安装非餐饮版插件时继续进入识别流程。
7. 新增厂商 Maven 仓库配置，访问令牌仅从用户级 Gradle 属性或环境变量读取，不写入业务仓库。
8. 删除不再引用的 app/libs/YingeoAiSDK_V3_RESTAURANT_v3.0.3.aar。

关键配置

构建环境需在 ~/.gradle/gradle.properties 中配置 yingeoSdkToken，或设置环境变量 YINGEO_SDK_TOKEN。仓库地址默认使用厂商 HTTPS 地址，也可通过 yingeoSdkMavenUrl 或 YINGEO_SDK_MAVEN_URL 覆盖；非本机 HTTP、URL 内嵌凭证、查询参数和片段会被拒绝。

主要变更文件

• settings.gradle、app/build.gradle
• app/libs/YingeoAiSDK_V3_RESTAURANT_v3.0.3.aar（删除）
• AiRuntimeConfig、AiSdkManager、AiDishActivationManager
• AiReadinessPolicy、AiReadyState、AiReadinessGuard
• SettingsRecognitionFragment 与对应布局、文案
• DishRecognitionActivity、DishManagementActivity、NewDishLearningActivity、MainActivity
• AiRuntimeConfigTest、AiReadinessPolicyTest

测试与验证

TDD 过程

• AiRuntimeConfigTest 首次运行因策略类尚不存在而编译失败，确认红灯；实现后目标测试通过。
• 插件类型不匹配映射先增加回归测试，再实现新就绪状态与映射。

自动化验证

• ./gradlew :app:testDebugUnitTest :app:assembleDebug --no-daemon：退出码 0，BUILD SUCCESSFUL in 10s。
• ./gradlew :app:dependencyInsight --dependency sdk-restaurant --configuration debugRuntimeClasspath --no-daemon：退出码 0，仅解析 com.yingeo.ai:sdk-restaurant:3.2.3。
• git diff --check：退出码 0，无输出。
• 构建存在项目既有 liantian.jar 的 D8 Expected stack map table 警告，但未阻断 APK 生成。

真机验收建议

1. 确认目标设备安装的银歌插件为餐饮版且与 SDK 3.2.3 兼容。
2. 从菜品识别切换到餐盘识别，确认准备提示、成功提示和“餐盘识别已就绪”状态。
3. 确认后续相机帧继续通过原自动识别入口返回餐盘结果，重复点击餐盘识别不会再次重启 SDK。
4. 切回菜品识别，确认原模型通道恢复且菜品学习入口重新显示。
5. 验证通用/加速模式，以及切换期间旧结果不会混入新订单。

文档归档检查

• 本记录仅保存在提示词工程 work_android/AIDishRecognition/change_records/。
• Markdown 与 HTML 使用相同 basename，并在同一任务内同步创建。
• 业务代码仓未新增 docs/、doc/、prompt/ 或其他文档产物目录。

Git 操作

未执行 stage、commit、push、branch、merge、rebase、reset 或 clean。