android: phase Z wrap-up (docs, release build, camera feature optional, APK)

docs/android_app/HANDOFF_DEVELOPMENT.md

@@ -61,27 +61,44 @@ android/app/src/main/kotlin/com/mag160c/thermal/
 ├─ ui/UiInsets.kt            单例：底部导航高度 px（渲染器用它留白）
 ├─ ui/theme/Theme.kt         M3 动态取色（Android12+）
 ├─ ui/live/                  ★实时画面（最核心）
-│  ├─ LiveViewModel.kt      状态机/演示模式/多点测温/追踪开关/拍照/录像/inset上报
-│  ├─ LiveScreen.kt         稳定单分支相机布局：顶栏4控制项+底部快门区(相册/拍照/录像)+SurfaceView
+│  ├─ LiveViewModel.kt      状态机/多点测温/追踪开关/拍照/录像/inset上报/PIP状态/
+│  │                        远程服务端开关+rawHook→RemoteHost
+│  ├─ LiveScreen.kt         稳定单分支相机布局：顶栏5控制项(FFC/变倍/追踪/调色板/画中画)
+│  │                        +底部快门区(相册/拍照/录像)+SurfaceView+PIP浮层
+│  ├─ PipCameraView.kt      可见光PIP相机引擎（Camera2最小实现，异常只记日志）
 │  └─ LiveRenderer.kt       SurfaceView 软件渲染：图像恒90°旋转(3:4竖)钉在竖屏框架固定区域,
 │                           文字恒屏幕水平；色标条/圆圈标记/中心温OSD
 ├─ ui/gallery/              相册页（MediaStore DCIM/MAG160C 扫描 + 内嵌JPEG缩略图 + 运行时媒体权限）
-├─ ui/analyze/              MDT 离线分析（缩放/调色板重渲染/备注回写/PDF报告）
-├─ ui/settings/             设置页（默认调色板/发射率/报警温度/语言/关于，SharedPreferences私有）
+├─ ui/analyze/              MDT 离线分析（缩放/调色板重渲染/温度条+点击测温/备注回写/PDF报告）
+├─ ui/settings/             设置页（默认调色板/发射率/报警温度/语言/云同步/远程预览两行/关于）
+├─ ui/remote/               远程预览客户端（Phase F）
+│  ├─ RemoteClientListScreen.kt 主机列表（UDP发现/手动IP/重新扫描）
+│  ├─ RemoteViewerViewModel.kt  本地管线渲染远端原始帧（调色板/变倍本地化）
+│  ├─ RemoteViewerScreen.kt     查看页（与实时页同构图，快门区换成红色"断开"）
+│  └─ RemoteRendererHost.kt     与 LiveRenderer 同构图的渲染器（LiveRenderer 已冻结）
+├─ net/                     网络互连（Phase F，纯 java.net，可 JVM 单测）
+│  ├─ RemoteContract.kt     端口/魔数/JSON data/帧封包与流式重组 FramePacketReader
+│  ├─ RemoteHost.kt         服务端：UDP 47510 广播 + TCP 47511 单客户端流
+│  └─ RemoteClient.kt       客户端：发现(去重3s) + 连接/行模式→帧模式/10s判死
+├─ cloud/CloudApi.kt        云接口占位（Retrofit，opt-in 默认关闭，api() 未开启即抛异常）
 ├─ media/
-│  ├─ Mdt.kt                MDT 容器格式（JPG + DDT段[info块+原始帧] + 152B Tail）
+│  ├─ Mdt.kt                MDT 容器格式（JPG + DDT段[info块+原始帧] + 152B Tail）+ parse
 │  ├─ PhotoSaver.kt         MediaStore 保存（DCIM/MAG160C，无权限也可写自有文件）
 │  ├─ Mp4Recorder.kt        MP4录像（Surface 输入 H.264，MediaCodec+MediaMuxer）
+│  ├─ DebugLog.kt           现场调试日志（落盘 DCIM→Download→私有目录 + logcat 镜像）
 │  └─ PdfReport.kt          PDF 巡检报告（PdfDocument）
 ├─ usb/
 │  ├─ UsbTransport.kt       UsbManager 枚举(VID 0x833C)/权限/claim/EP
-│  ├─ MagProtocol.kt        命令码 0x6BB6B6xx、响应 0x5BB5B5xx
-│  └─ IrSession.kt          连接/启动流/读线程→FrameStream→RenderPipeline→回调；FFC回调
+│  ├─ MagProtocol.kt        命令码 0x6BB6B6xx（小端）/响应 0x5BB5B5xx
+│  └─ IrSession.kt          连接/启动流/读线程→FrameStream→RenderPipeline→回调；
+│                           FFC回调；rawHook（远程预览）/recorderHook（录像）；
+│                           deviceLifetimeMs（675）；cali缓存MD5对照
 ├─ core/
 │  ├─ OfficialTables.kt     自动生成：PALETTE256_ARGB(官方铁虹)/T2E(646)/T2E274/E2T
-│  ├─ Palettes.kt           12调色板（铁虹=官方，其余标准曲线近似）
+│  ├─ VendorPalettes.kt     官方运行时时序生成器的移植结果（11/12 精确表，生成物）
+│  ├─ Palettes.kt           12调色板（0..10=官方精确表，11 红热=近似）
 │  ├─ RenderPipeline.kt     ★官方渲染管线 Kotlin 移植（与C参考逐字节一致）
-│  ├─ TempMath.kt           温度换算（counts→毫度，T2E）
+│  ├─ TempMath.kt           温度换算（counts→毫度，T2E）+ tempMapFromPixels（MDT温度图）
 │  └─ FrameStream.kt        流帧重组（0x1BB1B11B 搜索）
 └─ task/TaskParser.kt       任务巡检 sqlite/xml 解析
 assets/mag160c.ddt          官方 DDT 标定文件（1.8MB，渲染必需）
@@ -180,12 +197,31 @@ git -C C:\Project\MAG160C commit -m "android: ..."
 ## 7. 当前状态与待办
 
 **已完成**：核心管线移植（字节级验证）、USB 层、实时画面（相机式布局：
-顶栏4控制项 FFC/变倍/追踪/调色板 + 底部快门区 相册/拍照/录像 + 底导航）、
+顶栏5控制项 FFC/变倍/追踪/调色板/画中画 + 底部快门区 相册/拍照/录像 + 底导航）、
 图标文字按物理持机朝向补偿旋转（加速度计）、拍照 MDT 容器→MediaStore、
-MP4 录像、媒体库、离线分析查看器、PDF 报告、任务解析、设置页、Android16 沉浸
-（状态栏隐藏+竖屏锁定+挖孔安全区）、乱码多次修复。
+MP4 录像、媒体库、离线分析（含温度条+点击测温）、PDF 报告、任务解析、设置页、
+Android16 沉浸（状态栏隐藏+竖屏锁定+挖孔安全区）、乱码多次修复。
 （演示模式 2026-09-09 按用户要求撤下，见 §4.3。）
 
+**执行计划 2026-09-10 七阶段全部落地**（docs/android_app/execution_plan.md）：
+- Phase A：GetLifeTime(675) 查询→`deviceLifetimeMs` + 心跳 stats 带 lifetime；
+  cali 缓存与内置 DDT 的 MD5 一致性日志；真机自检清单
+  `docs/android_app/real_device_checklist.md`（24 步，含预期日志行）。
+- Phase B：`Mdt.parse` 返回 `MdtFile`（jpg 按 FFD9 裁尾、text 去 NUL 填充、
+  framePixels 齐全）；`TempMath.tempMapFromPixels` 毫度图；分析页温度条
+  （中心/最低/最高）+ 点击测温探针。**注意：分析页图像按原生横向绘制，
+  探针映射是直接映射，不要照抄实时页的 90° 逆映射。**
+- Phase C：厂商调色板——结论是 **libcxsdk.so 无静态表**，全部由
+  `CFunctions::SetColorPalette` 运行时算术生成；移植该函数后 11/12 个表
+  已达官方精确（0..10，铁虹与官方表 256/256 一致），索引 11 红热保留近似。
+  详见 `analysis/sdk_re/android_app/palette_extraction_findings.md`。
+- Phase D：云模块占位（Retrofit 2.11.0，`AppSettings.cloudEnabled` 默认 false，
+  `CloudClient.api()` 未开启即 check 抛异常——**不允许静默联网**）。
+- Phase E：可见光 PIP（Camera2 最小实现，三档尺寸、可拖动、双击关闭；
+  相机任何异常只记 `[pip]` 日志并收窗，绝不影响热像主画面）。
+- Phase F：局域网远程预览（UDP 47510 发现 + TCP 47511 控制与原始帧流，
+  **客户端本地管线渲染**，调色板/变倍不过网；单测含真实 TCP loopback 端到端）。
+
 **布局约定（最终，勿回退）**：
 - Activity **锁定竖屏**（`portrait`），构图钉死手机竖屏框架：顶栏/热像区域/快门区/底导航
   绝对位置永不随手机物理旋转变化（屏显方向永远对应镜头方向）。
@@ -194,12 +230,16 @@ MP4 录像、媒体库、离线分析查看器、PDF 报告、任务解析、设
 - 顶栏 `uiTopPx` 必须挂在 `safeDrawing` inset **之前**（包含挖孔安全区，否则真机热像
   顶端被顶栏盖住）；`uiBottomPx` = 底导航高 + 快门区高。
 
-**待办**（记录在 session_state.md）：
-1. 真机 USB 实测：温度绝对值标定、FFC/录像/MDT 保存端到端。
-2. 网络互连远程预览（用户需求：UDP 自动发现 + 手动内网 IP 连另一台插热像仪的手机）。
-3. 离线 MDT 温度解码（ConvertResponse2Temperature + 标定参数）。
-4. 厂商 12 调色板精确提取（运行时抓取或逆向）。
-5. 可见光 PIP 融合、云模块（预留结构）。
+**禁改清单**（详见 execution_plan.md §0，改前先读）：Manifest 的
+`screenOrientation="portrait"`、`MagProtocol` 命令字节序（MagProtocolTest 锁定）、
+`IrSession` 握手序列、`LiveRenderer` 构图逻辑、`analysis/` 目录。
+
+**待办**：
+1. 真机 USB 实测：温度绝对值标定、FFC/录像/MDT 保存端到端——照
+   `docs/android_app/real_device_checklist.md` 24 步走。
+2. 红热调色板（索引 11）精确表：官方 APK 的预览图是占位副本，需真机抓帧反推。
+3. 双机远程预览实测（清单第 16-24 步）。
+4. 云服务真实接口对接（当前仅占位，需账号与接口文档）。
 
 ## 8. 文件路径速查