docs(plans): 留痕 K33-H 画中画回前台复位

docs/plans/PROGRESS.md

@@ -20789,3 +20789,30 @@ Running Gradle task 'assembleDebug'...
 ```
 
 解读：静态检查零告警，410 条测试全部通过，debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
+
+## 2026-10-20 ReelShort：K33-H 画中画回前台复位
+
+- 分支：`fix/flutter-k33-pip-resume`
+- 功能提交：`bc8f3bc fix(flutter): 回前台复位残留画中画状态`
+- develop 合并提交：`9b99d96 merge: 合并 K33-H 画中画回前台复位`，已推送。
+- `PlayerLogic.onLifecycle`：回前台时若 `pip || pipPreparing` 为 true，先复位两者再 `notify()` + `notifyImmersive()`，随后照常做票据重取与 `setAppResumed(true)`。
+- 修复部分机型退出画中画不回调 `onPipChanged(false)` 导致 `chromeHidden` 恒 true、播放浮层与首页底栏全部消失的问题；未改原生代码、未改正常进出画中画流程，当前剧/集与进度不变，feed 与全屏页同时生效。
+- 测试：新增 `should_clear_stale_pip_when_app_returns_to_foreground`，模拟 pip 残留后 resumed，断言 pip/pipPreparing 复位、chromeHidden 为 false、onImmersiveChanged 最后为 false。
+
+门禁原始输出：
+
+```text
+$ dart analyze lib test
+Analyzing lib, test...
+No issues found!
+
+$ flutter test
+00:39 +411: All tests passed!
+
+$ flutter build apk --debug
+Running Gradle task 'assembleDebug'...
+   1.953s
+✓ Built build/app/outputs/flutter-apk/app-debug.apk
+```
+
+解读：静态检查零告警，411 条测试全部通过，debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。