docs+release: CHANGELOG/llms.txt/SDK README/API.md，0.1.0 候选

CHANGELOG.md

@@ -0,0 +1,29 @@
+# CHANGELOG
+
+## [0.1.0] — 2026-07-30
+
+首个 SDK 化发布。4.2寸墨水屏设备（DA14585 BLE，400×300 黑白红三色）的**完全离线**开发包：
+协议三线逆向（Web JS/APK/固件反汇编）+ 实机互证，全部功能经真机验证。
+
+### SDK
+- **`PPClient` 统一门面**：`via_local`（本机 bleak）/ `via_bridge(host, mac)`（经 bridge 远程 BLE）/ `via_uri` / `scan_devices`
+- 设备操作全集：对时（含 `tz` 时区偏移）、模式/切换、传图（6 抖动+调整+槽位）、本地 6 模板渲染上传、倒计时（时钟/日历/前缀/日历中文字）、休眠、停车牌、轮播、LUT、WiFi 透传、raw 直发、SUOTA OTA
+- **离线激活**：`activate_auto`——EFEF 取设备 ID → MAC 反解 → 本地 keygen（破解厂商云激活，实机验证）
+- `transports`（base/local/bridge）与 `firmware`（image 解析重打包/ota）分包；`Transport` 协议开放自定义传输
+- **BLE bridge 一等公民**：`ppclock-bridge` 命令（bleak 单文件服务端，Windows/Linux 原生运行），JSONL/TCP RPC，解决本机无蓝牙或 USB/IP 透传断流场景
+
+### CLI（同一能力面）
+`ppclock` 17 子命令 + `--json` 机器契约 + `batch` JSONL 单连接批量（agent 编排友好）+ `--via bridge://` / `PPCLOCK_VIA`
+
+### 固件工具
+镜像解析/修改/重打包（'pQ' 头 + zlib CRC32，字节级往返一致）；SUOTA 客户端（fef5 自定义 UUID 映射，实机推至产品头门禁）；工厂线刷布局已解析（pP 引导+双 bank+pR 产品头，docs/firmware-layout.md）
+
+### 测试与文档
+- 165 自动化测试全绿（协议/图像/命令/CLI/bridge/keygen/ota/fw/client 八个域）
+- AI-native 文档：`docs/sdk/API.md` + `llms.txt`
+- 逆向证据链：analysis/（web/apk/firmware 三域）+ docs/（架构/协议/固件分析/布局/实测记录）
+
+### 已知限制
+- 停车牌命令设备端不显示（厂商固件家族渲染差异，K1 待查）
+- 本机设备为裸闪存布局（无 'pR' 产品头），SUOTA 止于设备内部门禁；线刷恢复布局路径已成文备查
+- 轮播/WiFi 配置在本固件版本为 no-op（固件证据）