feat(ppclock): 离线激活 keygen（ror2 公式+EFEF 反解 MAC）+ activate --auto；docs 终稿（firmware-analysis/protocol/PROGRESS），132 测试全绿

PROGRESS.md

@@ -1,21 +1,45 @@
 # 进度日志 (PROGRESS)
 
-## 2026-07-24
+## 2026-07-24（最终状态）
 
-### 已完成
-- 侦察：固件=DA14585 镜像（'pQ' 签名头，向量表基址 0x07FC0000，含 `H:mspppclock.tech` / `V:PP_da14585_4.2` / `WX:2549294317` / `MAC:%02X...` 字符串）
-- 侦察：APK=Kotlin Compose Multiplatform（classes.dex 6.3MB + libapp.so/libeditor.so）
-- 侦察：Web 上位机功能面（时钟/倒计时/传图6种抖动/6模板/睡眠/停车牌/WiFi配置/高级命令/固件下载）
-- 建立 GOVERNANCE.md / PLAN.md / DECISIONS.md / 详细计划 docs/superpowers/plans/2026-07-24-eink-4.2-reverse.md
-- git init + 骨架提交
+### 已完成（对照门禁）
 
-### 进行中
-- P0 工具链搭建
+| 门禁 | 状态 | 证据 |
+|------|------|------|
+| G1 架构摸清 | ✅ | docs/architecture.md + docs/protocol.md + docs/firmware-analysis.md；三线互证：GATT/分块/平面/时间帧/模式族/倒计时/抖动算法 Web↔APK 一致，固件跳表逐项吻合 |
+| G2 CLI 可用 | ✅ | 132 测试全绿；`--json` 固定 schema；CLI 零网络依赖（仅 BLE） |
+| G3 功能对齐 | ✅(协议级) | Web 功能清单 24 项全部有 CLI 对应（见下方清单）；真机验证因无设备在范围内降级为协议仿真（FakeTransport 逐帧断言） |
+| G4 固件可控 | ✅(工具级) | tools/fw.py 解析/修改/重打包字节级往返 + CRC32 验证；SUOTA 全流程文档化（firmware-analysis §5）+ `ppclock ota` 实现；实机首刷待硬件 |
+| G5 离线交付 | ✅ | 激活本地 keygen（activate --auto）；模板本地渲染（wqy 字体）；qrcode 本地库；无任何 CDN/服务器调用 |
 
-### 下一步
-1. 安装 jadx + Python 依赖（bleak/pillow/capstone/androguard/pytest）
-2. 抓取 mspppclock.tech 全部 JS，提取 BLE UUID 与命令协议
-3. jadx 反编译 APK 互证
+### 三线逆向关键结论
 
-### 阻塞/风险
-- 真机是否可用未知；Task 9（真机对齐）可能降级为协议仿真验证
+1. **协议**：双通道 GATT（EPD 图像+RXTX 命令），全部 opcode 见 docs/protocol.md §4。
+2. **激活可离线绕过**（firmware-analysis §4.3）：激活码 = `ror2(((MAC[i]<<1)&0xFF)^0xEF)%101`（i=0..5），EFEF 设备 ID 可无损反解 MAC；EF 不门禁任何命令。
+3. **SUOTA 可用**（§5）：藏在 0x221F 服务，任务 0xFC 四消息，接收方校验 pQ 头+长度+XOR 写 Flash 0x38000 备 bank。
+4. **固件 no-op 命令**：E9/EA/WIFI 在本固件版本被忽略（§3.3）。
+5. **图像走 SPI Flash**：cmd 03 擦写 0x2E000 起 8 sector 顺序存 30KB 双平面；cmd 04 写 RAM（无边界检查，CLI 端保证尺寸正确）。
+6. **驱动 IC**：SSD1683 兼容（400x300 三色）+ UC8151 备选；OTP 波形无 LUT 表；E6=红黑平面校准字节。
+
+### 交付物清单
+
+- `src/ppclock/`：CLI（protocol/image_pipeline/commands/transport/cli/templates/textbitmap/ota/keygen）
+- `tools/`：fw.py / fw_info.py / fw_pack.py / check_env.py
+- `docs/`：protocol.md / architecture.md / firmware-analysis.md
+- `analysis/`：web 抓取与协议原始报告、apk 反编译报告与中间产物、firmware 反汇编产物
+- `tests/`：132 测试全绿
+
+### 遗留（需实机）
+
+1. 真机功能回归（设备不在 BLE 范围内；扫到 17 台其他 BLE 设备无 NRF- 前缀）
+2. SUOTA 首刷验证（建议先用仅改版本字符串的镜像，firmware-analysis §5 风险提示）
+3. `--mac` 路径 activate --auto 的 NVDS 字节序（EFEF 路径无歧义，优先用）
+
+### 会话时间线
+
+- 08:14 目标设定（治理+规划+执行）
+- 治理：GOVERNANCE.md / PLAN.md / DECISIONS.md / git 骨架
+- P0：venv（bleak/pillow/pytest/capstone/androguard/pytest-asyncio/qrcode）+ Java21
+- P1：Web JS 协议提取（子代理）→ APK 反编译互证（子代理）→ 固件逆向（子代理）
+- P2：protocol/image/commands/transport/cli/templates/textbitmap 全 TDD 实现
+- P3：batch/本地模板/ota/keygen 增强；fw 工具链；文档终稿