人脸识别初始化请求兼容性修复变更记录

1. 发生原因

旧 Runtime 没有区分启动页的正式初始化请求与业务 Session 的等待请求。ensureReady(...) 能在未初始化状态创建不带在线许可证的模型任务；启动页随后只能加入该任务，自己的许可证参数没有生效，并继承了前一个任务已经消耗的超时时间。日志中的 -10001 是应用层 45 秒模型超时，不是厂商 SDK 原始错误码。

2. 初始化注意点

• 只有启动流程可以创建模型初始化任务，业务页面只能检查或等待。
• 只有参数和目标兼容的请求才能共享任务；本项目通过“启动创建、业务等待”保证兼容。
• 在线授权与模型加载分阶段计时，模型不能继承授权阶段已消耗的时间。
• 成功、失败和超时只分发一次；迟到回调不能覆盖当前状态。
• 页面销毁只取消自己的回调，不中断进程级共享初始化。
• 初始化失败保留真实错误码与消息，业务请求不悄悄重试。

3. 如何初始化

1. 启动页取得许可证后调用 FaceRecognitionRuntime.initialize(context, license, callback)。
2. Runtime 创建唯一启动代次，并调用带许可证的在线初始化。
3. 先启动 15 秒授权计时；授权成功后取消该计时。
4. 从模型实际加载时重新启动完整的 45 秒模型计时。
5. 成功进入 READY 并通知等待者；失败进入 FAILED 并保存原错误。
6. 业务只调用 ensureReady(...)：已就绪立即继续、初始化中加入等待、尚未启动返回 -10003、失败返回上次真实错误。

4. 源码变更

FaceRecognitionRuntime

• 增加 STARTUP 与 SESSION_WAIT 请求类型。
• initialize(...) 成为唯一初始化入口，ensureReady(...) 只检查或等待。
• 增加尚未启动错误码 -10003，并保存最近一次真实失败信息。
• 保留代次隔离、回调取消和 ApplicationContext 边界。

InitFaceModelManager

• 在线授权 15 秒与模型加载 45 秒分别计时。
• 授权成功后重新开始完整模型计时。
• 阶段代次与一次性门闩过滤旧定时任务和迟到 SDK 结果。

回归测试

覆盖业务请求不抢初始化、启动页使用自己的许可证、共享启动任务、取消等待互不影响，以及失败后返回原错误且不偷偷重试。本次未修改启动页、Session、弹框、支付核销页面及原业务回调。

5. TDD 与自动验证

新增测试先在旧实现上失败，证明 ensureReady(...) 会错误启动模型；完成职责分离后转为通过。失败信息保留功能同样经历先失败再通过。

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

• BUILD SUCCESSFUL，约 5 秒。
• Debug 单元测试 54 个，失败、错误、跳过均为 0。
• Runtime 回归测试 12 个，全部通过；Debug APK 构建成功。
• git diff --check 通过；修改源码均为 UTF-8 无 BOM。

构建仅保留项目既存的 flatDir、Build Tools、SDK namespace 和第三方 YNHAPI 字节码版本警告，本次没有新增编译失败。

6. 真机待验

• 冷启动授权成功后，模型加载获得完整 45 秒窗口。
• 初始化中进入业务时只等待同一启动任务。
• 未启动或失败时弹框安全收尾，不重启应用、不杀进程。
• 人脸支付、重试、取消、超时和相机资源释放正常。
• 日志正确区分 -10000、-10001、-10003 与厂商真实错误码。

7. Git 状态

未执行暂存、提交、推送，也未创建或切换分支。