docs(05): 落 W11/W12 批次与实机验收、SAF 双扩展名 bug 的修复、GMS ANR 与 dump 重试两个新坑

devdocs/05-开发进度与交接.md

@@ -494,3 +494,39 @@ APK = 主树 `a6b4bae` 的产物（`app/build/outputs/apk/debug/app-debug.apk`
 2. **`pending_full` 的 `clientMsgId` 接线**（后端已就绪，见上）。
 3. **`GET /admin/observability/logs` 接线**（给「最近日志」补历史引导）。
 4. 搜索 / 编辑删除 / `after` 仍未动；可观测性 `observability_audit` 后端仍未做（审计仍是 REST）。
+
+## W11–W12 批次 + 一个实机抓到的真 bug（2026-10-05 凌晨）
+
+| 模块 | 内容 | 测试 | 提交 |
+|---|---|---|---|
+| W12 | 「最近日志」接上 `GET /admin/observability/logs` 引导读取（历史 + 帧增量；**viewer 有历史、无增量**） | 567 → 591 | `642bdb1` → `a7dbee8` |
+| W11 | **附件预览**：点芯片开弹层（云端按需拉、256 KB / 5000 行先到者为准、分块渲染）＋「用其它应用打开」「保存到下载目录」（FileProvider） | 567 → 610 | `27b6910` → `60b0eac` |
+| — | **修**：保存附件被 SAF 补成双扩展名（`.md` → `.md.txt`） | 634 | `ffa7ed2` |
+
+**合并后 634 测试 / 0 失败**（= 567 + 24 + 43，加法逐轮吻合）。
+
+### 这两块的实机验证（这次抓得很细）
+
+- **W12**：概览页三路并发 `GET /admin/observability/{logs?limit=200, metrics, trace?limit=100}` **全 200** —— logs 的 REST 引导**确实发出去了**，这就是 W10 那个「只显示进页面之后」缺口的闭环证据。
+- **W11 附件预览**（用的就是 `E2E-DOC` 会话里那条真实附件）：
+  - 点芯片 → 弹层里**显示的正是从服务端取回的内容**（我那张纸条的正文）；logcat 硬证据：
+    `GET /api/v1/documents/809320….md` → **200（95 字节）**；
+  - **零 `FileUriExposedException`**；
+  - 「用其它应用打开」在这台**裸模拟器没有能读 `text/plain` 的应用**时，如实回了一句「没有应用能打开……可以『保存到下载目录』后再处理」，**没有静默失败**；
+  - 「保存到下载目录」→ SAF 的建议名 = **内容寻址存储名**（界面里同时如实写明「原始文件名不会返回给客户端」）→ 落盘 95 字节、内容与弹层一致。
+- **抓到的真 bug（已修）**：保存那条一开始落盘成 `…e.md.txt` —— `CreateDocument` 传的是**嗅探基类型**（`.md` 也报 `text/plain`），SAF 就按它补了 `.txt`。**修法：保存这条路传 `*/*`**（没有可补的扩展名），而**打开那条路继续用 mime**（那里要的正是「能读懂这段内容的类型」）。重测落盘为 `…e.md`。
+
+### 新坑
+
+- **GMS 自己会 ANR**：模拟器上 `Google Play services isn't responding` 会挡在界面前面（**与我们的 App 无关**，6 GB 内存也照样偶发）。对策：`adb shell am force-stop com.google.android.gms`，立刻清掉接着干活。
+- **`uiautomator dump` 的静默失败要包重试**：本轮把它包成「重试 3 次 + 检查文件非空」才稳定下来。
+- **「预览 / 打开 / 保存」三条出口的类型选择是不一样的**（见上），别互相套用。
+
+### 仍欠（按顺序）
+
+1. **`F7` / 原始文件名**：契约不给 `originalName` ⇒ 保存只能用内容寻址的存储名；已把这件事**写在界面上**（不编假名）。若后端补 `originalName`，客户端只需改一处。
+2. **`pending_full` 的 `clientMsgId` 接线**（后端已就绪 —— `05` 旧条目里的 G5）。
+3. 搜索 / 消息编辑删除 / `after`。
+4. `observability_audit` 帧（后端未做，审计仍是 REST）。
+
+> 另：`E2E-DOC` 测试会话**暂时保留**当后端异常的现场证据（纯附件回合没有助手消息 + 两次 `knowledge` 工具失败，见 `02` 的最新登记）；对面回执说可删就删。