docs+repo: 正式化发布——三份 README 重写为正式版说明、DEVELOPMENT.md 取代交接文档、历史档案统一更名 worklog、全库清理交接字样；脱敏：用户本机路径/设备序列号/内网 Git 地址全部泛化，.tools 本地缓存(13MB,pyc内嵌路径)移出追踪并忽略；123 单测全绿
This commit is contained in:
ZXCLI
@@ -26,7 +26,7 @@
|
||||
- 协议/渲染/温度算法全部已逆向：analysis/protocol_spec.md + csdk/（逐像素验证过的官方管线）
|
||||
- csdk 的 mag160c_render 无平台依赖：USB 帧 → 320×240 RGB24 + 探针测温（毫度）
|
||||
- DDT 标定文件：可从设备经 0x6BB6B66D/E 下载（官方 prepareProcessImage 同款），仓库有
|
||||
build-artifacts/mag160c_official.ddt（1.8MB，SN 160043865）
|
||||
build-artifacts/mag160c_official.ddt（1.8MB，the calibration unit）
|
||||
- MDT 文件格式：reverse_apk_features.md §4（152B Tail + 5 段布局 + ROI 256B 记录）
|
||||
- 温度：毫度 int；MDT 解码走 ConvertResponse2Temperature + T2E(Revise) + CorrectTemperature
|
||||
|
||||
@@ -119,7 +119,7 @@
|
||||
- [x] **顶栏适配挖孔屏**：`WindowInsets.safeDrawing.only(Top)` 顶部安全区 padding
|
||||
- [x] 去掉 display-rotation 依赖（uiRotation/drawRotationDeg 已删，tapImage/probeToScreen
|
||||
用固定 90° 映射）
|
||||
- [x] 完整交接文档：docs/android_app/HANDOFF_DEVELOPMENT.md（含给新模型的读取提示词）
|
||||
- [x] 开发指南：docs/android_app/DEVELOPMENT.md
|
||||
|
||||
## 用户反馈修复 第五轮（2026-09-07，布局约定最终定稿：构图钉死竖屏框架）
|
||||
|
||||
@@ -200,8 +200,8 @@
|
||||
勿把演示模式加回来。
|
||||
- [x] 工具链在本机重装并重建 APK（2026-09-09）：JDK Temurin 21 `C:\Tools\jdk-21`、
|
||||
SDK `C:\Tools\android-sdk`（platform 36 / build-tools 36.0.0 / platform-tools，许可已接受）、
|
||||
Gradle 用工程 wrapper（8.14.3）；交接文档旧路径 C:\Tools\gradle-8.14.3 / Zulu /
|
||||
AppData SDK 属另一台开发机已失效（HANDOFF §2/§5 已改为本机路径）。
|
||||
Gradle 用工程 wrapper（8.14.3）；旧文档路径 C:\Tools\gradle-8.14.3 / Zulu /
|
||||
AppData SDK 属另一台开发机已失效（DEVELOPMENT §2/§5 已改为本机路径）。
|
||||
assembleDebug+test 全过；dex 抽查中文 UTF-8 正常、无 startDemo 残留；
|
||||
build-artifacts/mag160c-app-debug.apk 已更新（11.8MB），可直接装真机。
|
||||
- 待办不变（真机 USB 实测温度标定、网络互连远程预览、离线MDT温度解码、
|
||||
@@ -252,7 +252,7 @@
|
||||
## 用户反馈修复 第十三轮（2026-09-10，真机日志分析：端点静默 + 重枚举）
|
||||
|
||||
- [x] **用户回传 debug 日志**（vivo V2509A, Android16）：相机识别/DDT/66b 响应全正常
|
||||
（SN 160043865），但 66c/66f 响应超时、FFC/START 第一轮写失败（write=-1，
|
||||
（the calibration unit），但 66c/66f 响应超时、FFC/START 第一轮写失败（write=-1，
|
||||
端点疑似 halt）、流端点 19 秒 0 字节；00:51:10 相机重新枚举（权限再次弹出）
|
||||
——相机在会话中途疑似断电/复位；且新旧两个 Activity 的会话同时在抢同一设备
|
||||
（claimInterface 互相夺走）。
|
||||
@@ -353,7 +353,7 @@
|
||||
## 用户反馈修复 第十七轮（2026-09-10，根因确认：命令字节序反转）
|
||||
|
||||
- [x] **第 16 轮日志**：官方序列下 GetParameter1 仍唯一有响应（60B BasePara1 完整
|
||||
解析成功：serial=160043865 devType=3=core160 160x120@15fps），66c/66f/673 全部
|
||||
解析成功：serial=<SN> devType=3=core160 160x120@15fps），66c/66f/673 全部
|
||||
800ms 超时 → 与"字节内容"相关而非流程顺序。
|
||||
- [x] **根因**：`MagProtocol.cmd4/cmd8` 用 `ByteBuffer.putInt` —— **默认大端**！
|
||||
官方 `GlobalFunc.intToByteArray` 是小端。66b=0x6BB6B66B 是回文数，大小端
|
||||
@@ -441,7 +441,7 @@
|
||||
单测 44 个全绿，含 **loopback 端到端测试**（真实 TCP：hello→welcome→
|
||||
start→stream-start→5 帧逐字节往返→ffc→stop→stream-stop）与粘包/截断/
|
||||
坏长度/重同步用例。debug+release 双构建通过。真机双机步骤写入清单第 16-24 步。
|
||||
- [x] Phase Z（2026-09-10）：收尾完成。docs 更新（本文件 + HANDOFF_DEVELOPMENT
|
||||
- [x] Phase Z（2026-09-10）：收尾完成。docs 更新（本文件 + DEVELOPMENT.md
|
||||
§3 结构表加入 net/ cloud/ ui/remote/ 与 VendorPalettes/PipCameraView，
|
||||
§7 状态与待办重写 + 禁改清单）；全量 `assembleDebug test`（44 单测全绿）
|
||||
+ `assembleRelease`（R8）通过；APK 已覆盖提交
|
||||
@@ -491,7 +491,7 @@
|
||||
|
||||
## 用户反馈修复 第三十九轮（2026-10-07 凌晨，"官方背景条纹更不明显"结案：GPU 画布假设被真机 A/B 推翻，真因 = 我们开着官方从不开启的 7×7 细节增强）
|
||||
|
||||
按 38 轮交接清单执行（首验软件画布 → 正式修复 → A/B 验收 → NUC 域收尾）。
|
||||
按 38 轮待办清单执行（首验软件画布 → 正式修复 → A/B 验收 → NUC 域收尾）。
|
||||
完整数据与口径见 `rendering_diff_phone_20261006.md` §17.7。测量脚本
|
||||
`%TEMP%\mag160c_re\final39*.py`（38 轮存档数字全部复现：官方 FULL 0.10/0.28、
|
||||
暗区 0.15、照片 JPEG 0.25——口径互锁）。
|
||||
@@ -525,7 +525,7 @@
|
||||
|
||||
## 用户反馈修复 第三十八轮（2026-10-07 凌晨，原始帧录制 + 逐级重放全链路定案 + 显示链与官方对齐）
|
||||
|
||||
按第三十七轮交接清单执行。用户中途解锁手机并配合真机操作。完整数据表与
|
||||
按第三十七轮待办清单执行。用户中途解锁手机并配合真机操作。完整数据表与
|
||||
排除清单见 `docs/android_app/rendering_diff_phone_20261006.md` §17。
|
||||
|
||||
- [x] **原始帧录制调试开关**：`usb/RawFrameRecorder`（单文件，帧头 magic/seq/
|
||||
@@ -562,11 +562,11 @@
|
||||
拉回我们 App：切官方前先 force-stop 我们，USB 弹窗用 `TAB×2+ENTER` 过
|
||||
（横屏 input tap 坐标不可靠）。
|
||||
|
||||
## 用户反馈修复 第三十七轮（2026-10-06 深夜，"官方背景条纹更不明显"——逆向排除全部候选，定位为逐行固定偏移；交接轮）
|
||||
## 用户反馈修复 第三十七轮（2026-10-06 深夜，"官方背景条纹更不明显"——逆向排除全部候选，定位为逐行固定偏移；记录轮）
|
||||
|
||||
用户："很明显啊，官方背景里面的条纹就是要更不明显，你看看逆向出来的代码，是不是还漏掉了什么"。
|
||||
本轮**只做了调查与测量，无代码改动**。完整证据与数据表见
|
||||
`docs/android_app/rendering_diff_phone_20261006.md` §16，交接清单也在那里（16.3）。
|
||||
`docs/android_app/rendering_diff_phone_20261006.md` §16，待办清单也在那里（16.3）。
|
||||
|
||||
- 逆向：官方每帧链路（CalibrationMain_RTV + BlindCompensation + TempRangeStat +
|
||||
GrayEnlarge/HistDeRedundance）、内参（0x3808=1、0x380c=1、0x3804=baseLineAcc=4、
|
||||
@@ -1574,6 +1574,6 @@ SDK 内部默认档——无法据此对齐具体档位，故本应用把它做
|
||||
- 每完成一个阶段：更新本文件勾选 + git commit（不 push）。
|
||||
- 中断恢复：读本文件 → 按"下一步"继续 → 环境检查命令：
|
||||
```powershell
|
||||
Test-Path C:\Users\ZXC\AppData\Local\Android\Sdk\ndk\<ver>
|
||||
Test-Path %LOCALAPPDATA%\Android\Sdk\ndk\<ver>
|
||||
Get-Command java; Get-Command gradle
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user