首页刷卡诊断日志变更记录

日期：2026-09-01
目标项目：/Users/liang/AndroidStudioProjects/ZhctTrayBindingMachine

变更目标

复用高级设置中的现有日志开关，为首页正常绑盘流程补齐刷卡原始数据、解析结果、异常和状态拦截证据，以便区分串口未上报、协议解析失败和识别会话状态不匹配。

实施内容

• 将“性能测试记录”调整为“绑盘诊断记录”，提示调整为“开启后记录刷卡原始数据和流程轨迹”；原有 MMKV 配置键和默认关闭行为保持不变。
• BindingTraceRecorder 新增旁路诊断入口，统一写入 /sdcard/Log/binding_trace_YYYYMMDD.txt。
• CARD_RAW_DATA 记录串口原始十六进制数据及长度。
• CARD_RESULT_RECEIVED 记录解析类型、卡号和原始帧。
• CARD_RESULT_IGNORED 记录空结果、类型不匹配或流程状态不匹配。
• CARD_ERROR 记录 CRC 或其他读卡异常及对应原始数据。
• 每条诊断包含识别会话号、流程状态和识别活动状态，并在 Debug Logcat 中输出。

业务与数据边界

• 诊断开关关闭时不新增刷卡原始数据日志。
• 诊断异常被隔离，不改变串口协议、解析规则、绑盘状态机、接口参数、页面跳转和识别超时。
• 原始帧可能包含卡片标识，仅保存在设备本地且由管理员主动开启；问题确认后应关闭诊断开关。

验证结果

• git diff --check：通过。
• xmllint --noout app/src/main/res/values/strings.xml：通过。
• JDK 8 下 bash gradlew --no-daemon :app:compileDebugJavaWithJavac：BUILD SUCCESSFUL in 21s。
• 按用户要求未新增或运行复杂单元测试。

现场验收步骤

1. 构建并安装包含本变更的 Debug APK。
2. 在高级设置开启“绑盘诊断记录”。
3. 回到首页扫码进入识别页，只刷一次卡。
4. 检查 /sdcard/Log/binding_trace_YYYYMMDD.txt，按事件判断串口上报、解析、状态拦截和成功绑定链路。

现有改动与 Git 边界

• strings.xml 中已有的人脸阈值文案改动被完整保留；其他既有未提交改动未被本任务调整。
• 未执行拉取、暂存、提交、推送、建分支、切换分支、合并、变基、重置或清理。