android: visible-light PIP overlay (camera2, draggable, 3 sizes)

docs/android_app/real_device_checklist.md

@@ -24,6 +24,18 @@
 | 10 | 切到"相册"页 | （无 DebugLog；纯 UI） | 列表出现步骤 8 的照片缩略图（MDT 尾部校验通过才显示） |
 | 11 | 点该照片进入分析页 | （无 DebugLog；纯 UI） | 图片可缩放/平移；调色板重渲染可用；**图像顶部出现温度条**（`中心 x.x℃   最低 x.x℃   最高 x.x℃`）；点图任意位置出现白色圆点+温度标签，再点同一点可清除；备注可编辑保存 |
 | 12 | 分析页生成 PDF 报告 | （无 DebugLog；纯 UI） | 报告文件在 DCIM/MAG160C 或 Download/MAG160C 生成，可打开 |
+| 13 | 实时页顶栏第 5 项点"画中画"（首次会弹相机权限，点允许） | `[pip] camera opened id=<id>` → `[pip] repeating preview started` | 右上角（色标条左侧）出现 128×96dp 白框小窗，显示可见光画面；顶栏该项高亮为"画中画·开" |
+| 14 | 拖动 PIP 小窗到其它角落；单击小窗（循环 96/128/160dp）；双击小窗关闭 | `[pip] released`（双击关闭时） | 小窗跟手移动且不出界；单击在三档宽度间循环；双击后小窗消失，顶栏恢复"画中画"未开启态；日志有 `released` |
+| 15 | PIP 开启时按 Home 回到桌面再返回 | `[pip] released`（进入后台时） | 返回后若 PIP 仍为开启态，画面重新出现（重新 open）；无崩溃 |
+
+## 相机（PIP）失败时的表现（设计如此，不算 bug）
+
+PIP 的相机是可选功能，任何相机异常都只记日志并关闭小窗，**不影响热像主画面**：
+
+- 无相机硬件 / 权限被拒 → `[pip] no camera available` / `[pip] camera permission not granted`，
+  小窗空白或未出现；
+- 相机被其它应用占用 → `[pip] camera error=<N>` + `[pip] released`；
+- 上述情况下主画面、拍照、录像、分析全部照常工作。
 
 ## 失败时的快速定位（沿用第 11 轮起的诊断路径）
 

docs/android_app/session_state.md

@@ -413,7 +413,17 @@
       proguard-rules.pro 新建（-keep cloud.**；原文件缺失但被 build.gradle
       引用）。新增 CloudClientTest（4 项，锁"默认关闭/api() 拒绝"契约）。
       debug + release(R8) 双构建通过，29 单测全绿。APK 已更新。
-- [ ] Phase E：可见光 PIP 融合
+- [x] Phase E（2026-09-10）：可见光 PIP 融合：Manifest 加 CAMERA 权限 +
+      camera.any uses-feature（orientation 未动）；LiveState 加
+      pipOn/pipSizeIndex/pipXf/pipYf + togglePip/cyclePipSize/setPipPos；
+      新增 ui/live/PipCameraView.kt（Camera2 最小实现，TextureView 预览，
+      全部异常只记 DebugLog("pip",…) 并 release，绝不崩溃）；顶栏第 5 项
+      "画中画"+ ic_pip.xml（双弧圆+右下实心矩形）；浮层三档 96/128/160dp
+      （高=宽×3/4），位置相对热像视口、右边缘额外留 32dp 色标条位，
+      拖动/单击换档/双击关闭；PIP 关闭、离页、ON_STOP 三处释放相机；
+      运行时权限用 rememberLauncherForActivityResult。真机项已写入
+      real_device_checklist.md（第 13-15 步 + 失败表现）。APK 已更新。
+- [ ] Phase F：网络互连远程预览
 
 
 ## 里程碑日志