人脸识别阈值输入配置变更记录

变更日期：2026-08-31

源码仓库：/Users/liang/AndroidStudioProjects/CusumptionMachine

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

需求变化

原方案通过 70～99 的滑块设置消费人脸识别阈值。本次根据确认后的交互要求，改为点击设置项后弹出数字输入框，并将可配置范围调整为 50～100。

未配置设备的默认值仍为 70，避免改变已有设备的默认识别行为。

实现内容

• 基础设置页移除人脸识别阈值滑块，改为显示当前阈值的可点击设置行；展示值只显示整数，不附加“分”单位。
• 新增独立的 InputFaceRecognitionThresholdPop，只负责当前值回显、输入校验和结果回调。
• 打开弹窗时，输入框回显当前已设置的阈值并默认全选。
• 输入框下方固定显示：“输入范围是 50~100，推荐 70 以上，80 最优。”
• 输入为空、不是整数、小于 50 或大于 100 时，不保存、不关闭弹窗，并提示“请输入 50～100 之间的整数”。
• 输入 50～100 的有效整数并确认后，设置页保存配置、刷新当前值并关闭弹窗。
• 取消弹窗时不修改原阈值。
• FaceSDKManager 继续在每次人脸库检索时读取一次最新阈值，因此修改后无需重启，从下一次识别开始生效。
• 识别判断仍为“最高分严格大于阈值才通过”；阈值 100 对应 SDK 分值 1.00f。

代码职责

• FaceRecognitionThresholdConfig：负责默认值、50～100 边界、持久化和 SDK 浮点分值转换。
• InputFaceRecognitionThresholdPop：负责输入界面、当前值回显、范围校验和有效值回调，不直接持久化。
• FragmentBasic：负责打开弹窗、保存有效值和刷新设置页显示。
• FaceSDKManager：每次检索读取最新配置快照并执行原有得分比较。

自动验证

执行命令：

JAVA_HOME=/Users/liang/Library/Java/JavaVirtualMachines/corretto-1.8.0_482/Contents/Home bash gradlew :app:testDebugUnitTest :app:assembleDebug

结果：BUILD SUCCESSFUL

• Debug 单元测试：28 个。
• 失败：0。
• 错误：0。
• 阈值定向测试：4 个，覆盖默认值 70、50～100 边界、有效范围判断和 SDK 分值转换。
• Debug APK：/Users/liang/AndroidStudioProjects/CusumptionMachine/app/build/outputs/apk/debug/app-debug.apk
• SHA-256：b6441cde9a536c83df6d38320913510934dadfaf3a88addc5cf321f2eff5b883
• git diff --check：通过，无空白错误。
• 新增 Java/XML 文件：UTF-8 兼容且无 BOM。

真机验收项

• 设置页以纯数字显示当前阈值，不带“分”单位；点击后输入框回显同一数值并默认全选。
• 提示词位于输入框下方且内容完整。
• 输入 49、101、空值时不能保存，弹窗保持打开。
• 输入 50、70、80、100 时可以保存，退出后重新进入仍显示保存值。
• 修改后不重启应用，下一次识别日志显示新阈值。

2026-08-31 首次实施时未连接设备，上述完整交互项当时待复核；2026-09-07 已补充验证本次“去掉分单位”的展示结果。

2026-09-07 补充调整

• 基础设置中的“人脸识别阈值”由“80分”调整为“80”，统一按纯数字展示。
• 本次仅修改 basic_set_face_recognition_threshold_value 的展示格式，不修改阈值保存值、默认值、50～100 范围或 SDK 阈值换算逻辑。
• 资源格式契约检查和 XML 语法检查通过。
• 强制重跑 Debug 单元测试共 68 个，失败 0、错误 0；Debug APK 构建成功。
• 在目标设备 adb-9d93b40abcebabf1-IR9Lse (2)._adb-tls-connect._tcp 上安装验证，基础设置页实际显示为“80”，未附加“分”单位。

交付边界

• 本次只调整消费人脸匹配阈值的设置交互和范围。
• 不修改人脸注册、活体检测、质量检测、服务端接口或人员库数据。
• 工作区中已有的离线订单相关修改保持不变。
• 未执行 Git 暂存、提交或推送。