餐盘模式切换业务对照与补漏记录

• 日期：2026-09-29
• 项目：AIDishRecognition
• 对照源：/Users/liang/Desktop/yingeoai-sdk-restaurant-demo
• 状态：切换及防误计费链路已修复并完成静态、单元测试及构建验证；完整餐盘商品业务仍需数据接入与真机验收。

对照结论

1. 模型与运行参数：两端均以 CLASSIFICATION 启用餐盘分类、强制 A1，支持通用/加速模式回退，并使用多目标、实时学习 SDK 配置。当前项目通过统一管理器重初始化；本次补充再次进入识别时核对实际已加载配置，避免复用模式不符的存活连接。
2. 结果与商品：原程序按商品编码精确查询商品；当前项目已禁止餐盘数字类别编码按旧 dish_id 兜底。对历史库中“缺少 UUID、用 dish_id 充当编码”的缓存/数据库命中也按歧义结果拒绝；其余与商品 dish_uuid 精确绑定的结果可补全价格和进入支付清单。
3. 切换失败与旧结果：本次补充失败时恢复先前保存的设置，并在切换期间丢弃旧模型排队回调；识别页清空旧识别结果、金额和自动支付状态。
4. 自动支付：本次补充餐盘结果混合已绑定和未绑定类别时禁止按部分金额自动支付；菜品模式的既有规则不变。人工支付及人工加菜仍沿用当前项目原有流程。
5. 学习与图库：原程序支持餐盘模式的独立学习图库、按模式分目录同步和餐盘商品学习；当前项目为防止污染菜品学习数据，餐盘模式暂时禁止现有菜品学习入口，尚未接入餐盘专用学习、图库和后台同步链路。因此现阶段只能验证已有精确编码绑定的商品，不能通过当前项目现场新增餐盘类别绑定。
6. 规格区分：原程序有可选的餐盘尺寸样本、分组和规格确认；当前项目未移植。若业务要按餐盘尺寸区分价格或商品，需另行定义商品映射和学习数据方案。

本次代码变更

• SettingsRecognitionFragment：切换失败恢复原持久化选择。
• AiSdkManager：就绪入口核对已加载与目标配置，不一致时重新初始化。
• DishRecognitionActivity：切换期间废弃旧回调；餐盘含未知类别时禁止自动支付。
• RecognitionBusinessPolicy 及测试：集中餐盘自动支付防护规则。
• DishCatalogRepository：拒绝餐盘类别数字与历史菜品主键发生歧义的缓存/数据库匹配。

验证

• 新增策略测试先出现预期编译失败，补齐策略后通过；目标测试共 6 项、失败 0 项。
• ./gradlew :app:testDebugUnitTest :app:assembleDebug --no-daemon --quiet：退出码 0。
• git diff --check：退出码 0。
• 未安装 APK，未进行真机操作，也未执行 Git 写操作。

真机测试边界

建议先验证双向切换、失败回退、旧结果清空、餐盘类别 1 不再误显示“菜包 ¥0.80”、未绑定类别不计价及混合类别不自动支付。商品名称/价格与支付联动的正向测试，必须先确认 SDK 餐盘 goodsCode 与服务端商品 dish_uuid 有真实精确绑定。餐盘现场学习、图库同步和尺寸规格目前不属于已完成能力，不能据此宣称完整餐盘业务验收通过。

归档检查

本记录仅放在提示词工程 change_records/，与同名 Markdown 同步；代码仓未新增文档目录。