人脸识别阈值动态配置变更记录

记录日期：2026-08-31

项目仓库：/Users/liang/AndroidStudioProjects/CusumptionMachine

实施分支：fix-menu-dish-list-refresh-crash

变更背景

消费人脸库检索原先使用 BaseConfig 中固定的 0.7f 阈值，即 70 分。识别成功条件为检索最高分严格大于阈值。网络状态不会改变该判断，但现场环境、摄像头和人员特征质量不同，需要允许设备管理员在安全范围内调整匹配严格程度。

实施内容

• 在基础设置的“人脸识别超时间”下方增加“人脸识别阈值”滑块。
• 滑块范围为 70～99，步长为 1，默认值为 70，并实时显示当前整数分值。
• 用户停止拖动后通过 SharedPreferences 持久化保存。
• 新增 FaceRecognitionThresholdConfig，集中管理默认值、上下限、异常值限制和整数分值到 SDK 浮点阈值的转换。
• FaceSDKManager 每次执行消费人脸库检索时读取一次最新阈值快照，因此设置后无需重启，从下一次识别开始生效。
• 保留原有“检索最高分大于阈值才识别成功”的判断规则。
• 将原先跨检索共享且拼写错误的 threholdScore 字段改为单次检索局部变量，确保同一次识别的日志和判断使用一致阈值。

影响文件

• app/src/main/java/com/cpt/cusumption/utils/FaceRecognitionThresholdConfig.java
• app/src/test/java/com/cpt/cusumption/utils/FaceRecognitionThresholdConfigTest.java
• app/src/main/java/com/cpt/cusumption/utils/Constants.java
• app/src/main/java/com/cpt/cusumption/fragment/FragmentBasic.java
• app/src/main/java/com/cpt/cusumption/manager/FaceSDKManager.java
• app/src/main/res/layout/fragment_basic_layout.xml
• app/src/main/res/values/strings.xml

自动验证

• 按 TDD 先运行 FaceRecognitionThresholdConfigTest，确认生产配置类缺失时出现 8 个预期编译错误。
• 实现后定向运行阈值测试：2 个测试通过，失败 0、错误 0。
• 执行完整 Debug 单元测试与 Debug APK 构建：BUILD SUCCESSFUL。
• Debug 单元测试共 24 个，跳过 0、失败 0、错误 0。
• git diff --check 通过。
• Debug APK：app/build/outputs/apk/debug/app-debug.apk。
• APK SHA-256：cb477cf1fdfb34ac50240cdeed1755238298daf49c18e3ffef4750df92526277。

真机验收要求

• 首次进入基础设置时阈值显示 70，滑块不能低于 70 或高于 99。
• 修改为 85 后退出并重新进入设置页，仍显示 85。
• 修改阈值后不重启应用，下一次识别日志立即记录新阈值。
• 低于或等于新阈值的检索结果不能通过；高于新阈值的结果可继续查询用户并返回识别成功。
• 提高阈值后再恢复 70，确认现有识别行为恢复。

交付边界

• 本次只调整 app 模块中的消费人脸匹配阈值。
• 不修改 registerlibrary 人脸注册阈值，不修改活体检测、质量检测和人脸检测置信度。
• 不修改服务端接口、人员库、特征模型和非人脸支付流程。
• 未安装 APK，未执行 Git 暂存、提交或推送。