菜品识别画面稳定重新布防修复记录

变更日期

2026-07-23

问题现象

开启“画面稳定后识别”后，首次稳定可以进入菜品识别；之后移动或更换餐盘，即使画面再次稳定也不会自动识别，只有点击“重新识别”后才恢复。

根因

原稳定判定器只比较当前帧与上一采样帧，并在每次检查后覆盖上一帧基准。餐盘缓慢移动时，相邻两帧的变化可能始终不超过灵敏度阈值，最终画面虽然已经明显变化，判定器仍不会重新布防。

同时，原 8×8 哈希每个分区只读取一个固定像素，局部菜品变化可能避开采样点，进一步增加漏检概率。

问题位于菜品画面稳定判定流程，不在银歌菜品识别 SDK、人脸识别或 datalibrary。

修复方案

实施方案见：

• ../docs/2026-07-23-dish-recognition-frame-stability-rearm-fix-plan.md
• ../docs/2026-07-23-dish-recognition-frame-stability-rearm-fix-plan.html

核心采用双基准状态机：

• previousHash 用于判断相邻采样帧是否重新稳定。
• lastTriggeredHash 固定保存上一次成功提交识别的画面，用于累计判断餐盘是否发生变化。
• 当前画面相对上次触发画面的累计差异超过灵敏度后，锁存“画面已变化”。
• 画面已变化且相邻帧重新稳定时，再次触发菜品识别。
• 只有 SDK 接受请求后才提交新的触发基准；请求失败或预测超时会重新布防并自动重试。

代码变更

FrameStabilityDetector.java

• 将相邻帧稳定判断与上次触发画面变化判断拆分。
• 新增识别请求接受、拒绝状态回传。
• 支持慢速、分步移动造成的累计画面变化。
• 8×8 哈希改为分区平均亮度，并限制最大采样密度，避免创建全尺寸 Bitmap。
• 保持静止画面只触发一次。

DishRecognitionActivity.java

• aiAutoRecognition(...) 接受请求后确认本次稳定触发。
• SDK 拒绝请求或预测超时后重新布防。
• 自动识别暂停状态恢复后允许稳定画面重新进入识别。
• 稳定触发日志同时记录相邻帧差异、触发基准差异和灵敏度。

FrameStabilityDetectorTest.java

在原有覆盖上补充：

• 相邻变化较小、累计变化超过阈值时能够重新触发。
• 局部变化避开旧固定采样点时仍能被分区平均值检测。
• SDK 请求被拒绝后，稳定画面能够自动重试。

实际变更文件

• app/src/main/java/com/cpt/aidishrecognition/ai/FrameStabilityDetector.java
• app/src/main/java/com/cpt/aidishrecognition/activity/DishRecognitionActivity.java
• app/src/test/java/com/cpt/aidishrecognition/ai/FrameStabilityDetectorTest.java

本次没有修改设置页、人脸识别、datalibrary、支付流程或相机配置。

验证结果

• TDD 红灯验证：新增测试在实现前因缺少识别接受/拒绝回传接口而编译失败，确认测试能够约束新行为。
• FrameStabilityDetectorTest：7 项通过，0 失败。
• :app:testDebugUnitTest：36 项通过，0 失败，0 错误，0 跳过。
• :app:assembleDebug：BUILD SUCCESSFUL。
• git diff --check：通过。
• Debug APK：app/build/outputs/apk/debug/app-debug.apk。

待真机回归

• 首次放置餐盘，稳定后自动识别一次。
• 缓慢移动餐盘，停止后再次自动识别，不点击“重新识别”。
• 更换局部菜品，稳定后再次自动识别。
• 静止保持 10 秒，不重复触发。
• 分别使用灵敏度 1、5、10 验证现场触发效果。

结论

菜品稳定识别已从“只看相邻帧变化”修正为“相邻帧判断稳定、上次成功触发画面判断累计变化”。该修复解决慢速变化后无法重新进入识别的问题，并补齐 SDK 拒绝、预测超时和自动化恢复后的重新布防。