openless/docs/remote-input-recording-recovery.md

远程输入：息屏与录音恢复

手机录音页新增「录音时保持亮屏」，默认开启，并在当前浏览器记住选择。只在前台录音期间申请屏幕唤醒锁，结束、取消、断线或离开页面时释放。浏览器不支持，或系统因省电等原因拒绝时，页面会提示，录音仍可使用。

       [ 点击开始 / 点击结束 ]
              录音状态

录音时保持亮屏           [ 开 ]
息屏会结束本段录音，电脑继续处理已收到的部分。

电脑落字                 [ 开 ]

息屏后会发生什么

• 自动息屏、手动锁屏、切到后台或麦克风被系统中断时，手机尽可能发送结束录音，电脑继续识别已经收到的音频。
• 如果手机来不及通知，电脑在断线时收尾；连接仍在但连续 15 秒没有有效音频时，也会结束采集并开始识别。
• 识别已经开始后，手机断线不会取消电脑上的识别与历史记录写入。主动取消、关闭远程输入、重置 PIN 仍会撤销会话。
• 回到页面后重新认证并查询上次会话，找回结果或提示到电脑历史中重试。不会自动重新打开麦克风。

这不能让浏览器在锁屏后持续采集，也不能补回尚未传到电脑的音频。电脑退出、崩溃或磁盘不可写时，不能保证自动完成识别。

录音与结果保留

已收到的远程音频使用现有录音目录和保留设置写入 WAV。识别失败时，音频可供现有自动重试及桌面历史重新转录使用；识别成功后，除非开启保留成功录音，否则按现有策略删除音频。文字仍按历史记录设置保留。

手机只保存上次会话 ID 和单独生成的随机恢复凭据。恢复查询要求有效配对，不提供历史列表；仅凭公开会话 ID 无法读取结果。服务内最多保留最近 64 个会话的恢复权限，最长 24 小时，取消会话、重启服务或重置 PIN 后失效。此后请在电脑历史记录中查看。

真机验收（待补）

记录手机型号、系统与浏览器版本、电脑平台、识别模式及测试 commit；分别检查 iPhone Safari 和 Android Chrome。

• 开关默认开启；关闭、刷新后仍关闭；录音中切换立即生效，结束后恢复系统自动息屏。
• 点按和按住模式各录音 1–2 分钟：允许自动息屏、手动锁屏、切后台后，电脑保留已收到的部分并完成识别；回到手机能看到结果。
• 识别过程中断开网络再重连；检查电脑历史以及手机找回的文字。
• 模拟识别失败，检查 WAV 保留与历史重新转录；检查保留天数和录音数量上限。
• 低电量或浏览器拒绝保持亮屏时，提示明确且能开始录音。
• 识别中主动取消或重置 PIN，确认没有迟到落字，旧恢复凭据失效。

自动化测试覆盖模拟浏览器事件、两分钟 PCM、归档与失败重试、恢复鉴权和权限撤销；这些检查不能代替手机锁屏与省电行为的真机验收。