人脸识别相似度阈值设置变更记录

日期：2026-09-01
目标项目：/Users/liang/AndroidStudioProjects/ZhctTrayBindingMachine
关联 Use Case：UC-FACE-THRESHOLD-001

变更目标

在基础设置的人脸设置区域增加“人脸识别相似度阈值”设置项。未设置时页面显示并使用 70；允许输入 50～100 的整数，推荐值为 80；保存后立即用于下一次人脸搜索。设置项只显示数字，不追加“分”。

修改文件

文件	修改内容
`FaceRecognitionThresholdConfig.java`	默认值、范围、MMKV 读写、输入校验、异常值限制和 SDK 换算
`FaceRecognitionThresholdConfigTest.java`	默认值、边界、非法输入和浮点换算测试
`Constants.java`	新增阈值 MMKV 键
`strings.xml`	新增标题、范围/推荐值提示、输入占位和错误文案
`set_basic_fragment_layout.xml`	在人脸激活状态与检测超时之间增加设置项
`SetBasicFragment.java`	展示、数字弹框、校验、保存和即时刷新
`FaceSDKManager.java`	每次人脸搜索读取最新配置并用于相似度比较

关键规则

允许范围 50～100，默认值 70，推荐值 80。
未保存配置时不主动写入 MMKV；页面显示纯数字。
SDK 阈值按整数除以 100f 换算。
每次搜索读取最新值，保存后无需重启。
RGB 活体阈值、BaseConfig 和原有活体判断未修改。

测试驱动证据

测试先因配置类不存在而编译失败，证明测试能够捕获缺失实现。
实现后定向测试 BUILD SUCCESSFUL，新增 4 个测试全部通过。
根级带过滤条件的测试因 datalibrary 无同名测试而失败，改为明确的 :app:testDebugUnitTest 后通过；该失败不是业务代码失败。

最终验证结果

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew --no-daemon testDebugUnitTest assembleDebug：BUILD SUCCESSFUL in 13s。
40 个测试套件、141 个测试、0 跳过、0 失败、0 错误。
Debug APK：app/build/outputs/apk/debug/app-debug.apk，66,926,035 字节。
布局和文案 XML 通过 xmllint；全部差异通过 git diff --check。
BaseConfig.java 无差异，RGB/NIR/Depth 活体阈值读取保持不变。

环境说明

Gradle 5.1.1 / AGP 3.4.1 需使用 JDK 8 验证；gradlew 没有可执行位，因此使用 bash gradlew。没有修改脚本权限或项目 JDK 配置。

现有改动保护与人工验收

实施前已有的 ConsumptionStartActivity.java、ModeConfigurationPolicy.java、SettingActivity.java、ModeConfigurationPolicyTest.java 修改未被本任务触碰。仍需在目标设备人工确认弹框视觉、软键盘、取消行为和保存后的即时显示。

Git 边界

未执行拉取、暂存、提交、推送、建分支、切换分支、合并、变基、重置或清理。