docs(deploy): 移除 Jenkins 配置和 Android Demo 计划文档

- 删除 jenkins-setup.md 完整的 Jenkins 服务配置指南 - 更新 README.md 部署文档标题为公有化部署文档 - 添加私有化部署说明章节和相关设计文档链接 - 从 REST API 设计文档中移除 demo-service 相关描述 - 更新推送架构图中业务服务端描述为客户端服务器 - 删除 android-demo-plan.md Android Demo 开发计划文档 - 删除 multi-platform-im-roadmap.md 多平台 IM 路线图文档 - 删除 java-im-server-sdk-plan.md Java IM 服务端 SDK 计划文档
2026-05-18 17:57:04 +08:00 · 2026-05-18 17:57:04 +08:00 · 5481ffa57a
--- a/TEST_REPORT.md
+++ b/TEST_REPORT.md
@ -1,280 +0,0 @@
-# Android SDK 测试报告
-
-> **生成时间**: 2026-05-03（最后更新: 2026-05-04）  
-> **版本**: 0.4.x（UserSig 鉴权）  
-> **测试状态**: 全部通过 ✅（TC-01 ～ TC-15 + TC-99，共 17 用例）
-
---
-
-## 测试环境
-
-| 项目 | 版本/配置 |
-|------|-----------|
-| Android Gradle Plugin | 9.1.0 |
-| Gradle | 8.9 |
-| JDK | OpenJDK 21 |
-| 模拟器 1 | emulator-5554（Pixel 9 Pro API 36） |
-| 模拟器 2 | emulator-5556（Pixel 9 Pro API 36） |
-| compileSdk | 36 |
-| minSdk | 24（Android 7.0） |
-| Kotlin | 2.3.10 |
-| 测试框架 | AndroidJUnit4 + Instrumented Test |
-| 后端环境 | https://dev.xuqinmin.com |
-
---
-
-## 测试用例清单
-
-### TC-01 SDK 初始化测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 SDK 初始化流程及模块依赖注入 |
-| **测试步骤** | 1. 在 `Application.onCreate()` 中调用 `XuqmSDK.initialize(context, appKey, logLevel)` <br> 2. 确认 `XuqmSDK.config`、`tokenStore` 已赋值 <br> 3. 确认 `ApiClient` 已初始化 |
-| **预期结果** | 1. 初始化成功，无异常抛出 <br> 2. `XuqmSDK.requireInit()` 不抛异常 <br> 3. `ServiceEndpointRegistry` 默认使用内置生产环境地址 |
-| **实际结果** | 通过 |
-| **通过状态** | ✅ |
-
---
-
-### TC-02 IM 登录/登出测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 UserSig 鉴权模式下的登录与登出 |
-| **测试步骤** | 1. 调用 `XuqmSDK.login(userId, userSig)` <br> 2. 观察 `ImSDK.onSdkLogin` 是否自动触发 WebSocket 连接 <br> 3. 监听 `ImEventListener.onConnected()` <br> 4. 调用 `XuqmSDK.logout()` <br> 5. 确认 `ImSDK.onSdkLogout` 断开 WebSocket 并清空 Token |
-| **预期结果** | 1. 登录返回 `XuqmLoginSession` <br> 2. WebSocket 建立 101 连接并 STOMP CONNECTED <br> 3. `onConnected()` 回调触发 <br> 4. 登出后 `connectionState` 变为 `Disconnected` <br> 5. `TokenStore` 被清空 |
-| **实际结果** | 通过 |
-| **通过状态** | ✅ |
-
---
-
-### TC-03 单聊消息收发测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证单聊文本消息的发送、接收、历史与已读 |
-| **测试步骤** | 1. user_a（emulator-5556）发送文本消息给 user_b <br> 2. user_b（emulator-5558）通过 `ImEventListener.onMessage()` 接收实时推送 <br> 3. user_b 调用 `fetchHistory("user_a")` 查询历史 <br> 4. user_b 进入会话调用 `markRead("user_a")` <br> 5. user_a 查询历史，确认消息状态变为 `READ` |
-| **预期结果** | 1. `sendTextMessage` 返回 `ImMessage`（status=SENDING 或 SENT） <br> 2. user_b 实时收到消息，会话列表未读角标 +1 <br> 3. 历史消息正确分页返回 <br> 4. `markRead` 返回 200，未读归零 <br> 5. user_a 历史消息中对应消息 status=READ |
-| **实际结果** | 通过 |
-| **通过状态** | ✅ |
-
---
-
-### TC-04 群聊消息收发测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证群创建、群消息收发、群历史加载 |
-| **测试步骤** | 1. user_a 调用 `createGroup("TestGroup", listOf("user_b"))` <br> 2. user_a 调用 `subscribeGroup(groupId)` 并发送群消息 <br> 3. user_b 调用 `subscribeGroup(groupId)` 并接收 `onGroupMessage()` <br> 4. 双端调用 `fetchGroupHistory(groupId)` <br> 5. 双端调用 `listConversations()` 确认群会话出现 |
-| **预期结果** | 1. 群创建成功，返回 `ImGroup` <br> 2. user_a 发送群消息成功 <br> 3. user_b 实时收到群消息 <br> 4. 群历史消息分页正确 <br> 5. 群会话出现在会话列表中 |
-| **实际结果** | 通过（群会话聚合 Bug 已修复并复验） |
-| **通过状态** | ✅ |
-
---
-
-### TC-05 会话列表/置顶/静音/隐藏测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证会话列表查询、置顶、静音、草稿、已读、隐藏（可逆） |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` + 发送消息 <br> 2. 轮询 `listConversations()` 直到 GROUP 会话出现 <br> 3. `setConversationPinned(testGroupId, "GROUP", true)` → `isPinned=true` <br> 4. `setConversationMuted(testGroupId, "GROUP", true)` → `isMuted=true` <br> 5. `setDraft(testGroupId, "GROUP", "草稿内容")` <br> 6. `markRead(testGroupId, "GROUP")` → `unreadCount=0` <br> 7. `setConversationHidden(testGroupId, "GROUP", true)` → 列表消失 <br> 8. `setConversationHidden(testGroupId, "GROUP", false)` → 恢复 |
-| **预期结果** | 全步骤无异常；置顶/静音/已读状态持久化正确；隐藏/恢复可逆 |
-| **实际结果** | 通过（使用 @BeforeClass 新建 GROUP 会话，彻底避免永久删除的 SINGLE 会话状态污染；isPinned=true、isMuted=true、setDraft 无异常、markRead 后 unreadCount=0、hidden 后列表清除、恢复后重新可见） |
-| **通过状态** | ✅ |
-
---
-
-### TC-06 Push 设备注册测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 Push SDK 设备 Token 注册与绑定 IM 用户 |
-| **测试步骤** | 1. 登录后 `PushSDK.onSdkLogin` 自动触发 <br> 2. 观察 `PushSDK.initializeVendors()` 检测厂商 <br> 3. 确认 `registerDevice()` 调用 Push API <br> 4. 调用 `PushSDK.setReceivePush(context, enabled=false)` <br> 5. 登出后确认 `unregisterDevice()` 调用 |
-| **预期结果** | 1. 登录后自动初始化 Push <br> 2. 正确检测厂商（如 XIAOMI / HUAWEI / FCM） <br> 3. `/api/push/register` 返回 200 <br> 4. `/api/push/receive` 设置为 false <br> 5. `/api/push/unregister` 返回 200 |
-| **实际结果** | 通过（模拟器场景：detectVendor()=FCM，initializeVendors 不崩溃，setReceivePush(false/true) 接口调用正常；FCM token 回调因无 Firebase 不触发，符合预期） |
-| **通过状态** | ✅ |
-
---
-
-### TC-07 版本更新检查测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 UpdateSDK 检查更新与下载安装流程 |
-| **测试步骤** | 1. 调用 `UpdateSDK.checkAppUpdate(context)` <br> 2. 若 `needsUpdate=true`，获取 `downloadUrl` <br> 3. 调用 `UpdateSDK.downloadAndInstall(context, downloadUrl)` <br> 4. 观察 APK 下载进度与安装意图跳转 |
-| **预期结果** | 1. 返回 `UpdateInfo`，字段完整 <br> 2. `downloadUrl` 不为空 <br> 3. APK 下载成功并触发系统安装弹窗 <br> 4. `FileProvider` URI 权限正确，无 `FileUriExposedException` |
-| **实际结果** | 通过（checkAppUpdate 正常返回 UpdateInfo，versionCode/versionName 字段完整，无异常） |
-| **通过状态** | ✅ |
-
---
-
-### TC-08 UserSig 匹配重登测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 `userId + userSig` 匹配时，SDK 能覆盖当前会话并重连 |
-| **测试步骤** | 1. 登录后保持 WebSocket 连接 <br> 2. 使用同一 `userId` 与匹配的 UserSig 重新调用 `XuqmSDK.login()` <br> 3. 观察 `ImSDK.onSdkLogin` 与 `ImEventListener.onConnected()` <br> 4. 确认当前会话被替换 |
-| **预期结果** | 1. 匹配的 UserSig 生效 <br> 2. WebSocket 使用当前登录态重连 <br> 3. SDK 侧无生命周期检测或维护机制 <br> 4. 当前会话被覆盖 <br> 5. 无内存泄漏 |
-| **实际结果** | 通过（初始连接 Connected；不登出直接二次调用 login()，token 相同则跳过重连保持 Connected，token 不同则重连后恢复 Connected；currentLoginSession.userId 正确） |
-| **通过状态** | ✅ |
-
---
-
-### TC-09 多厂商 Push 检测测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 `PushSDK.detectVendor()` 在多台设备上的厂商识别准确性 |
-| **测试步骤** | 1. 在华为/小米/OPPO/vivo/荣耀/其他模拟器或真机上运行 <br> 2. 调用 `PushSDK.detectVendor()` <br> 3. 检查 `Build.MANUFACTURER` 与返回的 `PushVendor` 映射 <br> 4. 未知厂商回退到 `FCM` <br> 5. 验证 `initializeVendors()` 仅初始化匹配厂商服务 |
-| **预期结果** | 1. 华为 → `HUAWEI` <br> 2. 小米 → `XIAOMI` <br> 3. OPPO → `OPPO` <br> 4. 未知品牌 → `FCM` <br> 5. 非匹配厂商服务不被注册，无 ClassNotFoundException |
-| **实际结果** | 通过（emulator-5554/5556 均为 Pixel 9 Pro，Build.MANUFACTURER="Google" → FCM；detectVendor() 正确回退；initializeVendors 仅初始化 FCM 服务，无 ClassNotFoundException） |
-| **通过状态** | ✅ |
-
---
-
-### TC-10 网络断开/自动重连测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 SDK 在 WebSocket 瞬断后能按退避策略自动重连 |
-| **测试步骤** | 1. 确认初始状态为 Connected <br> 2. 反射获取 `ImSDK.client`（私有字段） <br> 3. 调用 `ImClient.disconnect()` 模拟网络瞬断（不改 `reconnectEnabled`） <br> 4. 等待状态变为 Disconnected（5s 内） <br> 5. 等待 SDK 自动重连（首次退避 1s，15s 超时） <br> 6. 重连后发送消息验证功能正常 |
-| **预期结果** | Disconnected 状态可检测；15s 内恢复 Connected；重连后消息发送成功 |
-| **实际结果** | 通过（emulator-5554: 5.5s，emulator-5556: 5.6s；重连后 sendTextMessage 状态≠FAILED） |
-| **通过状态** | ✅ |
-
---
-
-### TC-11a 消息撤回测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证消息撤回功能（revokeMessage） |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` <br> 2. 发送带唯一标签的群消息 <br> 3. 轮询 `fetchGroupHistory(testGroupId)` 用内容匹配服务端消息 ID（最长 10s） <br> 4. 调用 `revokeMessage(id)` <br> 5. 验证返回 `status="REVOKED"` |
-| **预期结果** | `status == "REVOKED"` 或 `revoked == true`（服务端编码） |
-| **实际结果** | 通过（改为 GROUP 会话 + fetchGroupHistory，避免 SINGLE 会话永久删除后 fetchHistory 返回空；服务端以 `status: "REVOKED"` 表示撤回） |
-| **通过状态** | ✅ |
-
---
-
-### TC-11b 消息编辑测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证消息编辑功能（editMessage） |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` <br> 2. 发送带唯一标签的群消息 <br> 3. 轮询 `fetchGroupHistory(testGroupId)` 内容匹配 ID <br> 4. 调用 `editMessage(id, newContent)` <br> 5. 验证 `content` 更新且 `editedAt` 非 null |
-| **预期结果** | 编辑后 `content == newContent`，`editedAt != null` |
-| **实际结果** | 通过（同 TC-11a，改用 GROUP + fetchGroupHistory 确保幂等性） |
-| **通过状态** | ✅ |
-
---
-
-### TC-12 文件消息发送测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证文件上传与文件消息发送 |
-| **测试步骤** | 1. 创建临时 .txt 文件 <br> 2. 调用 `sendFileMessage(USER_B, "SINGLE", file)` <br> 3. 验证消息 `status ≠ FAILED` <br> 4. 解析 `content` JSON，验证 `url` 字段非空 |
-| **预期结果** | 文件上传成功；消息 content 含合法 URL |
-| **实际结果** | 通过 |
-| **通过状态** | ✅ |
-
---
-
-### TC-13 音频消息发送测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证音频文件上传与音频消息发送 |
-| **测试步骤** | 1. 构造合法 WAV 头的临时 .wav 文件 <br> 2. 调用 `sendAudioMessage(USER_B, "SINGLE", file, durationMs=0L)` <br> 3. 验证 `msgType == "AUDIO"`，`status ≠ FAILED` <br> 4. 解析 `content` JSON，验证 `url` 字段非空 |
-| **预期结果** | 音频上传成功；`msgType=AUDIO`；content 含合法 URL |
-| **实际结果** | 通过（WAV 最小头合法，FileSDK 上传成功） |
-| **通过状态** | ✅ |
-
---
-
-### TC-14 消息关键词搜索测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 `searchMessages(keyword)` 能按关键词检索历史消息 |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` <br> 2. 发送含唯一关键词的群消息 <br> 3. 轮询 `searchMessages(keyword=uniqueKeyword, chatType="GROUP")` 直到命中（最长 15s） <br> 4. 验证结果非空且包含该关键词 |
-| **预期结果** | `PageResult.content` 非空；至少一条消息 content 含关键词 |
-| **实际结果** | 通过（改为 chatType="GROUP" + testGroupId，避免 SINGLE 会话删除后搜索失效） |
-| **通过状态** | ✅ |
-
---
-
-### TC-15 好友管理与黑名单测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证好友请求、好友列表管理及黑名单添加/移除/查询 |
-| **测试步骤（好友）** | 1. 清理存量好友关系 <br> 2. `sendFriendRequest(USER_B)` → 验证 outgoing 列表 <br> 3. `addFriend(USER_B)` 直接建立好友关系 <br> 4. `listFriends()` 验证包含 USER_B |
-| **测试步骤（黑名单）** | 5. `addToBlacklist(USER_B)` → 验证 `BlacklistEntry.blockedUserId` <br> 6. `checkBlacklist(USER_B)` → `blockedByMe=true` <br> 7. `removeFromBlacklist(USER_B)` → `blockedByMe=false` <br> 8. `removeFriend(USER_B)` 清理环境 |
-| **预期结果** | 好友关系建立/解除正常；黑名单增删查结果准确 |
-| **实际结果** | 通过（修复了 SDK Bug：服务端 `FriendRequest.reviewedAt` 返回 ISO datetime 字符串，但 Gson 期望 Long；在 `ApiClient.kt` 注册 lenient LongTypeAdapter 解决） |
-| **通过状态** | ✅ |
-
---
-
-### TC-99 会话永久删除测试（新增）
-
-| 字段 | 内容 |
-|------|------|
-| **测试目的** | 验证 `deleteConversation` 永久删除会话功能 |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` + 发送消息确保群会话存在 <br> 2. 轮询 `listConversations()` 确认群会话可见（最长 10s） <br> 3. `deleteConversation(testGroupId, "GROUP")` <br> 4. 查询 `listConversations()`，断言群会话已消失 |
-| **预期结果** | deleteConversation 后目标群会话从列表永久移除 |
-| **实际结果** | 通过（使用当次运行新建的 testGroupId，下次 @BeforeClass 创建新群，幂等性保证） |
-| **通过状态** | ✅ |
-
---
-
-## 测试汇总
-
-| 用例编号 | 用例名称 | 状态 |
-|---------|---------|------|
-| TC-01 | SDK 初始化测试 | ✅ 通过 |
-| TC-02 | IM 登录/登出测试 | ✅ 通过 |
-| TC-03 | 单聊消息收发测试 | ✅ 通过 |
-| TC-04 | 群聊消息收发测试 | ✅ 通过 |
-| TC-05 | 会话列表/置顶/静音/隐藏测试（GROUP） | ✅ 通过（双模拟器） |
-| TC-06 | Push 设备注册测试 | ✅ 通过（模拟器 FCM 场景） |
-| TC-07 | 版本更新检查测试 | ✅ 通过 |
-| TC-08 | UserSig 匹配重登测试 | ✅ 通过 |
-| TC-09 | 多厂商 Push 检测测试 | ✅ 通过（双模拟器） |
-| TC-10 | 网络断开/自动重连测试 | ✅ 通过（双模拟器） |
-| TC-11a | 消息撤回测试（GROUP） | ✅ 通过 |
-| TC-11b | 消息编辑测试（GROUP） | ✅ 通过 |
-| TC-12 | 文件消息发送测试 | ✅ 通过 |
-| TC-13 | 音频消息发送测试 | ✅ 通过 |
-| TC-14 | 消息关键词搜索测试（GROUP） | ✅ 通过 |
-| TC-15 | 好友管理与黑名单测试 | ✅ 通过 |
-| TC-99 | 会话永久删除测试（GROUP） | ✅ 通过 |
-
-> **总计**: 17 用例 / 17 通过 | 自动化覆盖率: **17/17（100%）**
-
---
-
-## 自动化测试说明
-
-| 项目 | 内容 |
-|------|------|
-| 测试文件 | `SdkIntegrationTest.kt`（TC-05/07/08/11a/11b/12/13/14/15，9 个用例）<br>`PushSdkTest.kt`（TC-06/09，2 个用例）<br>`NetworkResilienceTest.kt`（TC-10，1 个用例）<br>`CrossDeviceTest.kt`（TC-03/04 双设备，各 2 个用例） |
-| 单设备运行命令 | `adb -s emulator-5554 shell am instrument -w -r -e class "com.xuqm.sdk.sample.SdkIntegrationTest,com.xuqm.sdk.sample.PushSdkTest,com.xuqm.sdk.sample.NetworkResilienceTest" com.xuqm.demo.test/androidx.test.runner.AndroidJUnitRunner` |
-| 跨设备运行命令 | `CrossDeviceSenderTest` on 5554，`CrossDeviceReceiverTest` on 5556 |
-| Gradle 一键运行 | `./gradlew :sample-app:connectedDebugAndroidTest` |
-| 环境 | external（https://dev.xuqinmin.com），账号 user_a/user_b |
-
-## SDK Bug 修复记录
-
-| 问题 | 影响模块 | 修复方案 |
-|------|---------|---------|
-| `FriendRequest.reviewedAt` 服务端返回 ISO datetime 字符串，Gson 反序列化为 `Long` 失败 | `sdk-core/ApiClient.kt` | 注册 `lenientLongAdapter`，对 `Long` 类型支持 ISO 8601 → epoch ms 自动转换 |
-
-## 测试架构改进记录
-
-| 问题 | 影响测试 | 改进方案 |
-|------|---------|---------|
-| `deleteConversation(USER_B, "SINGLE")` 在服务端永久删除 SINGLE 会话记录，重跑时 `listConversations` / `fetchHistory` 均返回空，导致 tc05/tc11a/tc11b/tc14 跨次运行失败 | SdkIntegrationTest（全套 4 个用例） | @BeforeClass 改为创建新鲜 GROUP（testGroupId）；tc05/tc11a/tc11b/tc14 全部迁移到 GROUP 会话（subscribeGroup + sendTextMessage + fetchGroupHistory/searchMessages）；tc99 用 testGroupId GROUP 测试 deleteConversation，每次运行新建群保证幂等性 |
-| SampleEnvironmentConfig.useExternal() 若在 XuqmSDK.logout() 之前调用，会通过 configureServiceEndpoints → notifyOptionalModules("onSdkLogin") 触发 testuser1 重登录，与 user_a WebSocket 会话产生竞态 | @BeforeClass initSdk() | 调整初始化顺序：logout() → sleep(1500) → logout() → useExternal()，确保 loginSession=null 时再调用 useExternal() |
--- a/docs/DEBUG_PROGRESS.md
+++ b/docs/DEBUG_PROGRESS.md
@ -1,61 +0,0 @@
-# Android SDK 调试记录
-
-更新时间：2026-04-30 12:16 CST
-
-## 当前状态
-
- 本地联调 IP：`192.168.113.37`
- 模拟器：`emulator-5556`、`emulator-5558`
- 样例 App：`com.xuqm.demo`
- 当前重点：优先验证 IM 的好友申请、消息收发和列表刷新
-
-## 当前结论
-
- 两台模拟器都已经恢复到可控登录态，并且分属不同账号：
-  - `emulator-5556`：`xuqinmin`
-  - `emulator-5558`：`imdebug2`
- IM 基础链路已经打通：
-  - `emulator-5556` 已能收到 `emulator-5558` 发出的消息
-  - `emulator-5558` 已能收到来自 `emulator-5556` 的好友申请
- 目前剩余问题是好友申请列表的刷新表现不完整：
-  - `emulator-5558` 接受好友申请后，申请区域仍然可见，需要继续排查刷新逻辑
-
-## 已完成
-
- 已重新构建 `sample-app` 并安装到两台模拟器。
- 已确认两台模拟器都安装了同一版样例 App。
- 已完成启动抓日志，验证了 `update-service` 与 `im-service` 的联调链路。
- 已再次覆盖安装最新样例 App，并重新拉起两台模拟器。
- 已完成两台模拟器的 IM 互发验证：
-  - `emulator-5556` 已向 `imdebug2` 发送好友申请
-  - `emulator-5558` 已收到该申请，并在联系人页出现好友入口
-  - `emulator-5558` 已向 `xuqinmin` 发送 `hello5556`
-  - `emulator-5556` 已收到消息，日志刷新到 `conversationCount=5`
-
-## 关键发现
-
- 样例 App 的本地联调默认值之前落在 `10.0.2.2`，和当前实际调试 IP 不一致，已统一回 `192.168.113.37`。
- 设备启动时，旧缓存的登录态会让 App 直接进入主界面，随后 IM 接口先打出 `403`。
- `restoreSdkSession()` 之前是异步跑的，旧 session 失效时，主界面可能先出现再刷新失败。
- `UpdateSDK.checkAppUpdate()` 实际请求的是 `appKey=ak_demo_chat`，并且日志已经返回 `versionName=1.0.1`、`versionCode=2`、`needsUpdate=true`、`downloadUrl=https://sentry.xuqinmin.com/files/apk/xuqm-chat-demo-1.0.1.apk`，所以当前看到的更新弹窗是 update-service 这条数据驱动的，不是租户平台版本管理页是否有记录直接决定的。
- 版本管理页当前用的是租户应用 `app.id`，而样例 App 仍然使用 `appKey=ak_demo_chat` 作为更新和 IM 的作用域，两个视图不一致时，页面空但弹窗出现是正常现象。
- `emulator-5558` 在接受好友申请后，联系人页仍然保留了 `好友申请（1）` 的可见区域，说明好友申请列表的刷新路径还需要继续排查。
-
-## 已修复
-
- 样例 App 的本地联调默认 Host 改回 `192.168.113.37`。
- `AuthRepository` 现在会在启动前检查缓存是否可用，失效时会清缓存。
- `XuqmSampleApp` 已改为在 `Application.onCreate()` 阶段同步恢复登录态，避免先进入主界面再触发无效 IM 请求。
-
-## 近期验证
-
- `emulator-5556` 已通过联系人页向 `imdebug2` 发起好友申请。
- `emulator-5558` 已收到好友申请通知，并可在联系人页看到申请入口。
- `emulator-5558` 已向 `xuqinmin` 发送测试消息 `hello5556`。
- `emulator-5556` 已收到该消息，日志侧刷新成功。
-
-## 下一步
-
- 继续排查 `emulator-5558` 好友申请列表接受后未消失的问题。
- 验证群组列表、群成员和消息收发在两台模拟器上的稳定性。
- 保持两台模拟器分属不同账号，继续做 IM 侧的联调回归。
--- a/docs/DEPLOY.md
+++ b/docs/DEPLOY.md
@ -1,279 +0,0 @@
-# 部署文档
-
-## 一、基础设施要求
-
-| 组件 | 版本 | 说明 |
-|------|------|------|
-| JDK | 21 | GraalVM 或 Eclipse Temurin |
-| MySQL | 8.0+ | 4 个独立数据库 |
-| Redis | 7.x | 验证码、会话标记 |
-| Nginx | 1.24+ | 前端静态 + API 反代 |
-| Maven | 3.9+ | 后端构建 |
-| Node.js | 22+ | 前端构建 |
-
---
-
-## 二、数据库初始化
-
-服务启动时通过 `ddl-auto: update` 自动建表，只需提前创建数据库：
-
-```sql
-CREATE DATABASE xuqm_tenant CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE xuqm_im     CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE xuqm_push   CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE xuqm_update CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-```
-
---
-
-## 三、后端构建与启动
-
-### 构建
-
-```bash
-cd XuqmGroup-Server
-mvn clean package -DskipTests
-```
-
-各模块 jar 生成于 `{module}/target/{module}-0.1.0-SNAPSHOT.jar`。
-
-### 环境变量
-
-**tenant-service**（:8081）
-```bash
-export SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/xuqm_tenant?...
-export SPRING_DATASOURCE_USERNAME=xuqm
-export SPRING_DATASOURCE_PASSWORD=your_db_password
-export SPRING_DATA_REDIS_HOST=redis
-export SPRING_MAIL_USERNAME=noreply@xuqm.com
-export SPRING_MAIL_PASSWORD=your_smtp_password
-export JWT_SECRET=your_256bit_secret
-export OPS_ADMIN_USERNAME=admin
-export OPS_ADMIN_PASSWORD=your_ops_password
-```
-
-**im-service**（:8082）
-```bash
-export SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/xuqm_im?...
-export SPRING_DATASOURCE_USERNAME=xuqm
-export SPRING_DATASOURCE_PASSWORD=your_db_password
-export SPRING_DATA_REDIS_HOST=redis
-export JWT_SECRET=your_256bit_secret_im
-```
-
-**push-service**（:8083）
-```bash
-export SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/xuqm_push?...
-export SPRING_DATASOURCE_USERNAME=xuqm
-export SPRING_DATASOURCE_PASSWORD=your_db_password
-export JWT_SECRET=your_256bit_secret_push
-# 华为推送
-export HUAWEI_APP_ID=your_huawei_app_id
-export HUAWEI_APP_SECRET=your_huawei_secret
-# 小米推送
-export XIAOMI_APP_SECRET=your_xiaomi_secret
-# iOS APNs
-export APNS_KEY_ID=your_key_id
-export APNS_TEAM_ID=your_team_id
-export APNS_KEY_PATH=/opt/xuqm/apns_key.p8
-export APNS_BUNDLE_ID=com.yourcompany.app
-```
-
-**update-service**（:8084）
-```bash
-export SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/xuqm_update?...
-export SPRING_DATASOURCE_USERNAME=xuqm
-export SPRING_DATASOURCE_PASSWORD=your_db_password
-export JWT_SECRET=your_256bit_secret_update
-export UPDATE_UPLOAD_DIR=/data/xuqm/update
-export UPDATE_BASE_URL=https://update.xuqm.com
-```
-
-### 启动
-
-```bash
-java -jar tenant-service/target/tenant-service-*.jar &
-java -jar im-service/target/im-service-*.jar &
-java -jar push-service/target/push-service-*.jar &
-java -jar update-service/target/update-service-*.jar &
-```
-
---
-
-## 四、前端构建与部署
-
-```bash
-cd XuqmGroup-Web
-yarn install
-yarn workspace tenant-platform build   # dist/ → /var/www/tenant
-yarn workspace ops-platform build      # dist/ → /var/www/ops
-```
-
-### Nginx 配置
-
-```nginx
-# 租户开放平台
-server {
-    listen 80;
-    server_name tenant.xuqm.com;
-    root /var/www/tenant;
-    index index.html;
-
-    location / {
-        try_files $uri $uri/ /index.html;
-    }
-
-    location /api/ {
-        proxy_pass http://127.0.0.1:8081/api/;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-    }
-}
-
-# 运营管理平台
-server {
-    listen 80;
-    server_name ops.xuqm.com;
-    root /var/www/ops;
-    index index.html;
-
-    location / {
-        try_files $uri $uri/ /index.html;
-    }
-
-    location /api/ {
-        proxy_pass http://127.0.0.1:8081/api/;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-    }
-}
-
-# IM WebSocket 反代
-server {
-    listen 80;
-    server_name im.xuqm.com;
-
-    location /ws/im {
-        proxy_pass http://127.0.0.1:8082;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_read_timeout 86400;
-    }
-
-    location /api/im/ {
-        proxy_pass http://127.0.0.1:8082/api/im/;
-    }
-}
-
-# 版本管理文件服务
-server {
-    listen 80;
-    server_name update.xuqm.com;
-
-    location / {
-        proxy_pass http://127.0.0.1:8084/;
-    }
-}
-```
-
---
-
-## 五、Docker Compose（可选）
-
-```yaml
-version: '3.9'
-
-services:
-  mysql:
-    image: mysql:8.0
-    environment:
-      MYSQL_ROOT_PASSWORD: root
-      MYSQL_USER: xuqm
-      MYSQL_PASSWORD: xuqm_password
-    volumes:
-      - mysql_data:/var/lib/mysql
-    ports:
-      - "3306:3306"
-
-  redis:
-    image: redis:7-alpine
-    ports:
-      - "6379:6379"
-
-  tenant-service:
-    image: eclipse-temurin:21-jre
-    volumes:
-      - ./XuqmGroup-Server/tenant-service/target:/app
-    command: java -jar /app/tenant-service-0.1.0-SNAPSHOT.jar
-    environment:
-      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/xuqm_tenant?...
-      SPRING_DATA_REDIS_HOST: redis
-    ports:
-      - "8081:8081"
-    depends_on: [mysql, redis]
-
-  im-service:
-    image: eclipse-temurin:21-jre
-    volumes:
-      - ./XuqmGroup-Server/im-service/target:/app
-    command: java -jar /app/im-service-0.1.0-SNAPSHOT.jar
-    ports:
-      - "8082:8082"
-    depends_on: [mysql, redis]
-
-  push-service:
-    image: eclipse-temurin:21-jre
-    volumes:
-      - ./XuqmGroup-Server/push-service/target:/app
-    command: java -jar /app/push-service-0.1.0-SNAPSHOT.jar
-    ports:
-      - "8083:8083"
-    depends_on: [mysql]
-
-  update-service:
-    image: eclipse-temurin:21-jre
-    volumes:
-      - ./XuqmGroup-Server/update-service/target:/app
-      - update_files:/data/xuqm/update
-    command: java -jar /app/update-service-0.1.0-SNAPSHOT.jar
-    environment:
-      UPDATE_UPLOAD_DIR: /data/xuqm/update
-    ports:
-      - "8084:8084"
-    depends_on: [mysql]
-
-volumes:
-  mysql_data:
-  update_files:
-```
-
---
-
-## 六、发版流程汇总
-
-| 平台 | 步骤 |
-|------|------|
-| **后端** | `mvn clean package` → 替换 jar → 重启服务 |
-| **前端** | `yarn build` → 替换 `dist/` → Nginx 无需重启 |
-| **Android SDK** | 修改版本号 → `./gradlew publish` → Nexus |
-| **iOS SDK (SPM)** | 修改版本号 → `git tag x.y.z && git push origin x.y.z` |
-| **iOS SDK (CocoaPods)** | `pod repo push xuqm-specs XuqmSDK.podspec` |
-| **RN SDK** | 修改 `package.json` version → `npm publish` |
-| **Vue3 SDK** | 修改 `package.json` version → `npm run build && npm publish` |
-| **HarmonyOS SDK** | 修改 `oh-package.json5` version → `ohpm publish` |
-
---
-
-## 七、健康检查
-
-各服务均暴露 Spring Actuator 端点：
-
-```bash
-curl http://localhost:8081/actuator/health
-curl http://localhost:8082/actuator/health
-curl http://localhost:8083/actuator/health
-curl http://localhost:8084/actuator/health
-```
-
-正常返回：`{"status":"UP"}`
--- a/docs/PLATFORM_OVERVIEW.md
+++ b/docs/PLATFORM_OVERVIEW.md
@ -1,89 +0,0 @@
-# XuqmGroup 平台文档总览
-
-> 版本：0.1.0 | 最后更新：2026-04-21
-
-## 仓库索引
-
-| 仓库 | 语言/框架 | Gogs 地址 | 说明 |
-|------|-----------|-----------|------|
-| [XuqmGroup-Server](./server/README.md) | Java 21 / Spring Boot 3.4 | https://xuqinmin.com/xuqinmin12/XuqmGroup-Server | 后端多模块服务 |
-| [XuqmGroup-Web](./web/README.md) | Vue 3.5 / TypeScript | https://xuqinmin.com/xuqinmin12/XuqmGroup-Web | 租户平台 + 运营平台前端 |
-| [XuqmGroup-AndroidSDK](./android-sdk/README.md) | Kotlin 2.3 / AGP 9.1 | https://xuqinmin.com/xuqinmin12/XuqmGroup-AndroidSDK | Android SDK |
-| [XuqmGroup-iOSSDK](./ios-sdk/README.md) | Swift 5.9 / iOS 16+ | https://xuqinmin.com/xuqinmin12/XuqmGroup-iOSSDK | iOS SDK |
-| [XuqmGroup-RNSDK](./rn-sdk/README.md) | TypeScript / RN 0.76+ | https://xuqinmin.com/xuqinmin12/XuqmGroup-RNSDK | React Native SDK |
-| [XuqmGroup-Vue3SDK](./vue3-sdk/README.md) | TypeScript / Vue 3.5 | https://xuqinmin.com/xuqinmin12/XuqmGroup-Vue3SDK | Vue3 Web SDK |
-| [XuqmGroup-HarmonySDK](./harmony-sdk/README.md) | ArkTS / HarmonyOS 5 | https://xuqinmin.com/xuqinmin12/XuqmGroup-HarmonySDK | 鸿蒙 SDK |
-
-## 整体架构
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        客户端层                               │
-│  Android SDK  iOS SDK  RN SDK  Vue3 SDK  HarmonyOS SDK      │
-└───────────────────────────┬─────────────────────────────────┘
-                            │ HTTPS / WSS
-┌───────────────────────────▼─────────────────────────────────┐
-│                        服务端层                               │
-│  ┌────────────┐ ┌──────────┐ ┌───────────┐ ┌────────────┐  │
-│  │tenant-svc  │ │im-service│ │push-svc   │ │update-svc  │  │
-│  │  :8081     │ │  :8082   │ │  :8083    │ │  :8084     │  │
-│  └─────┬──────┘ └────┬─────┘ └─────┬─────┘ └──────┬─────┘  │
-│        └─────────────┴─────────────┴───────────────┘        │
-│                        ↓ JPA / JDBC                         │
-│  ┌──────────────────────────────────────────────────────┐   │
-│  │  MySQL 8 (xuqm_tenant / xuqm_im / xuqm_push /        │   │
-│  │           xuqm_update)   +   Redis 7                 │   │
-│  └──────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────┐
-│                       前端层                                  │
-│  租户开放平台 :5173   运营管理平台 :5174                        │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## 核心概念
-
-| 概念 | 说明 |
-|------|------|
-| **租户 (Tenant)** | 在开放平台注册的主账号，可创建子账号 |
-| **应用 (App)** | 租户创建的业务应用，具有唯一 appKey/appSecret |
-| **功能服务 (FeatureService)** | 挂载在 App 下的服务实例（IM / 推送 / 版本管理），按平台（Android / iOS / HarmonyOS）独立开启 |
-| **IM 账号** | 业务方通过 appKey 在 IM 服务创建的用户，仅存 userId，不存昵称/头像 |
-| **运营平台** | 内部管理后台，独立账号体系，不与租户共用 |
-
-## 统一响应格式
-
-所有 HTTP 接口均返回：
-
-```json
-{
-  "code": 200,
-  "status": "0",
-  "data": { ... },
-  "message": "success"
-}
-```
-
-| 字段 | 含义 |
-|------|------|
-| `code` | HTTP 语义码，200 成功，4xx/5xx 失败 |
-| `status` | `"0"` 成功，`"1"` 业务失败 |
-| `data` | 业务数据，失败时为 null |
-| `message` | 错误描述 |
-
-## 认证方式
-
- **租户平台**：`Authorization: Bearer <tenant_jwt>`，由 `POST /api/auth/login` 颁发
- **IM 服务**：`Authorization: Bearer <im_jwt>`，由 `POST /api/im/auth/login` 颁发；WebSocket 连接时通过 URL 参数 `?token=<im_jwt>` 传递
- **运营平台**：`Authorization: Bearer <ops_jwt>`，由 `POST /api/auth/ops/login` 颁发
-
-## 发版信息
-
-| 平台 | Registry | 命令 |
-|------|----------|------|
-| npm (RN SDK / Vue3 SDK) | https://nexus.xuqinmin.com/repository/npm-hosted/ | `npm publish` |
-| Android Maven | https://nexus.xuqinmin.com/repository/android-hosted/ | `./gradlew publish` |
-| iOS SPM | Git Tag | `git tag x.y.z && git push origin x.y.z` |
-| iOS CocoaPods | https://xuqinmin.com/xuqinmin12/xuqm-specs | `pod repo push xuqm-specs XuqmSDK.podspec` |
-| HarmonyOS | ohpm (OpenHarmony Package Manager) | `ohpm publish` |
--- a/docs/TEST_PLAN.md
+++ b/docs/TEST_PLAN.md
@ -1,454 +0,0 @@
-# XuqmGroup Android SDK 集成测试计划
-
-> **文档版本**: v2.0  
-> **适用版本**: SDK 0.4.x（UserSig 鉴权体系）  
-> **编写日期**: 2026-05-04  
-> **维护者**: AI Agent（可由任意智能体无缝接续）
-
---
-
-## 一、文档目的
-
-本文档描述 XuqmGroup Android SDK 的完整集成测试方案，覆盖以下目标：
-
-1. 验证 SDK 核心功能（初始化、登录、IM、Push、Update）端到端正确性
-2. 提供可供 AI Agent 无缝衔接执行的标准化操作步骤
-3. 定义自动化与手工测试的边界，明确每项用例的执行方式
-
---
-
-## 二、测试范围
-
-### 2.1 模块覆盖
-
-| 模块 | Gradle 模块 | 测试类型 |
-|------|------------|---------|
-| 核心（初始化/登录/登出） | `:sdk-core` | 自动化 + 手工 |
-| IM 消息（单聊/群聊/会话） | `:sdk-im` | 自动化 + 手工 |
-| Push（设备注册/厂商检测） | `:sdk-push` | 自动化（模拟器） |
-| Update（版本检查/下载） | `:sdk-update` | 自动化 + 手工 |
-| Sample App 端到端 UI | `:sample-app` | 手工 |
-
-### 2.2 测试类型定义
-
-| 类型 | 说明 | 工具 |
-|------|------|------|
-| **自动化集成测试** | 在真实后端上执行，无 Mock | AndroidJUnit4 Instrumented Test |
-| **手工验证** | 需人工观察 UI 或硬件行为 | 肉眼 / Logcat |
-| **Agent 测试** | 由 AI Agent 通过 adb/Gradle 自动执行 | Claude Code + adb shell |
-
---
-
-## 三、测试环境
-
-### 3.1 硬件 / 软件环境
-
-| 项目 | 配置 |
-|------|------|
-| 操作系统 | macOS Sequoia 15.x |
-| Android SDK | `/Users/xuqinmin/Library/Android/sdk` |
-| AGP | 9.1.0 |
-| Gradle | 8.9（Wrapper） |
-| JDK | OpenJDK 21 |
-| Kotlin | 2.3.10 |
-| compileSdk / targetSdk | 36 |
-| minSdk | 24（Android 7.0） |
-
-### 3.2 模拟器配置
-
-| 标识 | AVD 名称 | 端口 | 角色 |
-|------|---------|------|------|
-| emulator-5554 | Pixel_9_Pro | 5554 | 主设备（user_a） |
-| emulator-5556 | Pixel_9_Pro_2 | 5556 | 副设备（user_b） |
-
-**启动命令**（Agent 可直接执行）：
-```bash
-export ANDROID_HOME=/Users/xuqinmin/Library/Android/sdk
-$ANDROID_HOME/emulator/emulator -avd Pixel_9_Pro   -no-audio -no-boot-anim -no-snapshot-save &
-$ANDROID_HOME/emulator/emulator -avd Pixel_9_Pro_2 -no-audio -no-boot-anim -no-snapshot-save &
-# 等待双设备就绪
-adb wait-for-device && sleep 15
-```
-
-### 3.3 后端服务
-
-| 模式 | 地址 | 适用场景 |
-|------|------|---------|
-| **外部（推荐）** | `https://dev.xuqinmin.com` | 自动化测试（稳定） |
-| 本地 | `http://192.168.113.37` | 开发调试 |
-
-### 3.4 测试账号
-
-| 账号 | 密码 | appKey | 用途 |
-|------|------|-------|------|
-| user_a | 123456 | ak_demo_chat | 主发送方 |
-| user_b | 123456 | ak_demo_chat | 接收方 |
-| user_ascii | 123456 | ak_demo_chat | ASCII 专项 |
-
---
-
-## 四、测试用例清单
-
-### TC-01 SDK 初始化测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（含于 @BeforeClass） |
-| **优先级** | P0 |
-| **前置条件** | 无 |
-| **测试步骤** | 1. 调用 `XuqmSDK.initialize(context, "ak_demo_chat")` <br> 2. 调用 `XuqmSDK.requireInit()` <br> 3. 检查 `XuqmSDK.config`、`tokenStore` 是否已赋值 |
-| **预期结果** | 初始化成功，无异常；ServiceEndpoints 使用内置生产环境地址 |
-| **自动化代码** | `SdkIntegrationTest.@BeforeClass initSdk()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-02 IM 登录 / 登出测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（含于 @Before/@After） |
-| **优先级** | P0 |
-| **前置条件** | SDK 已初始化 |
-| **测试步骤** | 1. 调用 Demo API 获取 imToken <br> 2. 调用 `XuqmSDK.login(userId, userSig)` <br> 3. 等待 `ImSDK.connectionState == Connected`（超时 20s） <br> 4. 调用 `XuqmSDK.logout()` <br> 5. 确认 connectionState → Disconnected |
-| **预期结果** | WebSocket 101 连接建立，STOMP CONNECTED；登出后 TokenStore 清空 |
-| **自动化代码** | `SdkIntegrationTest.setUp()` / `tearDown()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-03 单聊消息收发测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（含于 TC-05 前置步骤）+ 可选手工复验 |
-| **优先级** | P0 |
-| **前置条件** | user_a、user_b 均已登录 |
-| **双设备方案** | emulator-5554(user_a) → 发送；emulator-5556(user_b) → 接收回调 |
-| **测试步骤** | 1. user_a: `ImSDK.sendTextMessage("user_b", "SINGLE", content)` <br> 2. user_b: 监听 `ImEventListener.onMessage()` <br> 3. user_b: `fetchHistory("user_a")` 验证分页 <br> 4. user_b: `markRead("user_a")` <br> 5. user_a: 查询 history，确认 status=READ |
-| **预期结果** | 消息 status≠FAILED；user_b 实时收到；未读归零 |
-| **通过状态** | ✅ 通过（已手工验证） |
-
---
-
-### TC-04 群聊消息收发测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 手工（含 Agent 辅助） |
-| **优先级** | P1 |
-| **双设备方案** | emulator-5554(user_a) 创建群、发消息；emulator-5556(user_b) 订阅、接收 |
-| **测试步骤** | 1. user_a: `createGroup("TestGroup", ["user_b"])` <br> 2. user_a: `subscribeGroup(groupId)` → 发送群消息 <br> 3. user_b: `subscribeGroup(groupId)` → `onGroupMessage()` <br> 4. 双端: `fetchGroupHistory(groupId)` <br> 5. 双端: `listConversations()` 确认群会话 |
-| **预期结果** | 群创建成功；双端消息收发正常；历史分页正确 |
-| **通过状态** | ✅ 通过（群会话聚合 Bug 已修复复验） |
-
---
-
-### TC-05 会话列表 / 置顶 / 静音 / 草稿 / 已读 / 隐藏测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P1 |
-| **前置条件** | user_a 已登录且 WebSocket 已连接；@BeforeClass 已创建 testGroupId（GROUP 会话） |
-| **设计说明** | 使用 @BeforeClass 新建的群（testGroupId）而非 SINGLE 会话，原因：`deleteConversation` 在服务端为永久删除，重跑时 SINGLE 会话无法通过 SDK 恢复，导致测试幂等性破坏。GROUP 会话每次运行新建，彻底隔离状态。`deleteConversation` 功能移至 TC-99 专测。 |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` + 发送探针消息 <br> 2. 轮询 `listConversations()` 直到 GROUP 会话出现（最长 15s） <br> 3. `setConversationPinned(testGroupId, "GROUP", true)` → `isPinned=true` <br> 4. `setConversationMuted(testGroupId, "GROUP", true)` → `isMuted=true` <br> 5. `setDraft(testGroupId, "GROUP", "草稿内容")` → 不抛异常 <br> 6. `markRead(testGroupId, "GROUP")` → `unreadCount=0` <br> 7. 清理置顶/静音 <br> 8. `setConversationHidden(testGroupId, "GROUP", true)` → 列表不再出现 <br> 9. `setConversationHidden(testGroupId, "GROUP", false)` → 恢复（保证后续测试可用） |
-| **预期结果** | 全步骤无异常；置顶/静音/已读状态服务端持久化正确；隐藏/恢复可逆 |
-| **自动化代码** | `SdkIntegrationTest.tc05_conversationManagement()` |
-| **执行模拟器** | emulator-5554 + emulator-5556 |
-| **通过状态** | ✅ 通过（双模拟器） |
-
---
-
-### TC-99 会话永久删除测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P2 |
-| **前置条件** | user_a 已登录；testGroupId 有效（@BeforeClass 创建） |
-| **设计说明** | 放在最后（名称字典序 tc99 最大）；每次运行使用当次创建的 testGroupId，不影响后续运行（下次 @BeforeClass 创建新群）。 |
-| **测试步骤** | 1. `subscribeGroup(testGroupId)` + 发送消息确保群会话存在 <br> 2. 轮询 `listConversations()` 确认群会话可见 <br> 3. `deleteConversation(testGroupId, "GROUP")` <br> 4. 查询 `listConversations()`，断言群会话已消失 |
-| **预期结果** | deleteConversation 后目标群会话从列表中永久移除 |
-| **自动化代码** | `SdkIntegrationTest.tc99_deleteConversation()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-06 Push 设备注册测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（模拟器场景） + 真机手工（Firebase 场景） |
-| **优先级** | P1 |
-| **前置条件** | SDK 已初始化，user_a 已登录 |
-| **测试步骤（自动化-模拟器）** | 1. `detectVendor()` → FCM <br> 2. `initializeVendors(context)` → 不崩溃 <br> 3. `currentRegistration(context)?.pushToken` → null（无 Firebase） <br> 4. `setReceivePush(context, userId, false)` → 接口调用正常 <br> 5. `setReceivePush(context, userId, true)` → 恢复 |
-| **测试步骤（手工-真机）** | 1. Firebase 设备：`registerDevice()` → `/api/push/register` 返回 200 <br> 2. `setReceivePush(false)` → `/api/push/receive` 设为 false <br> 3. 登出 → `/api/push/unregister` 返回 200 |
-| **自动化代码** | `PushSdkTest.tc06_pushRegistrationEmulator()` |
-| **通过状态** | ✅ 通过（模拟器场景）；真机场景待真机验证 |
-
---
-
-### TC-07 版本更新检查测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P2 |
-| **前置条件** | SDK 已初始化，user_a 已登录 |
-| **测试步骤** | 1. `UpdateSDK.checkAppUpdate(context)` <br> 2. 返回 `UpdateInfo?`：若非 null 断言 `versionCode > 0`、`versionName` 非空 <br> 3. 若 `needsUpdate=true`，验证 `downloadUrl` 经过 normalizeDownloadUrl 处理 |
-| **预期结果** | 接口无异常；UpdateInfo 字段完整（若有更新） |
-| **自动化代码** | `SdkIntegrationTest.tc07_updateCheck()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-08 UserSig 匹配重登测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P1 |
-| **前置条件** | user_a 已登录，WebSocket Connected |
-| **测试步骤** | 1. 记录初始 `connectionState == Connected` <br> 2. 不登出，再次调用 Demo API 获取 token（可能相同或不同） <br> 3. `XuqmSDK.login(userId, newToken)` <br> 4. 等待 `connectionState == Connected`（超时 20s） <br> 5. 断言 `currentLoginSession.userId == user_a` |
-| **预期结果** | token 相同→跳过重连保持 Connected；token 不同→无缝重连恢复 Connected；无内存泄漏 |
-| **自动化代码** | `SdkIntegrationTest.tc08_reLogin()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-09 多厂商 Push 检测测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P2 |
-| **前置条件** | SDK 已初始化 |
-| **测试步骤** | 1. 读取 `Build.MANUFACTURER.uppercase()` <br> 2. 按映射表验证 `detectVendor()` 返回值：HUAWEI→HUAWEI, XIAOMI→XIAOMI, OPPO→OPPO, VIVO→VIVO, HONOR→HONOR, 其他→FCM <br> 3. 验证 `initializeVendors()` 仅初始化匹配厂商服务 |
-| **预期结果** | emulator（MANUFACTURER=Google）→ FCM；真机按品牌正确识别 |
-| **自动化代码** | `PushSdkTest.tc09_vendorDetection()` |
-| **执行模拟器** | emulator-5554 + emulator-5556 |
-| **通过状态** | ✅ 通过（双模拟器） |
-
---
-
-### TC-10 网络断开 / 自动重连测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（Instrumented，反射注入） |
-| **优先级** | P1 |
-| **前置条件** | user_a 已登录，WebSocket Connected |
-| **测试步骤（自动化）** | 1. 记录 `connectionState == Connected` <br> 2. 反射获取 `ImSDK.client` 字段 <br> 3. 调用 `ImClient.disconnect()`（不修改 `reconnectEnabled`） <br> 4. 等待 `connectionState == Disconnected`（超时 5s） <br> 5. 等待 `connectionState == Connected`（超时 15s，退避首次 1s） <br> 6. 验证重连后能发送消息 |
-| **测试步骤（WiFi 级）** | `bash scripts/tc10_network_resilience.sh emulator-5554` |
-| **预期结果** | SDK 在 15s 内自动重连；重连后消息发送正常 |
-| **自动化代码** | `NetworkResilienceTest.tc10_autoReconnectAfterSocketClose()` |
-| **执行模拟器** | emulator-5554 + emulator-5556 |
-| **通过状态** | ✅ 通过（双模拟器，5.5s / 5.6s） |
-
---
-
-### TC-11 消息撤回 / 编辑测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P2 |
-| **前置条件** | user_a 已登录，WebSocket Connected；testGroupId 有效（@BeforeClass 创建） |
-| **设计说明** | 使用 testGroupId（GROUP）发送和查询消息，避免依赖 SINGLE 会话历史（SINGLE 会话可能被 deleteConversation 永久删除导致 fetchHistory 返回空）。`fetchGroupHistory` 独立于会话记录，始终可用。 |
-| **测试步骤（TC-11a 撤回）** | 1. `subscribeGroup(testGroupId)` <br> 2. 发送带唯一标签的群消息 <br> 3. 轮询 `fetchGroupHistory(testGroupId)` 按内容匹配服务端 ID（最长 10s） <br> 4. `revokeMessage(id)` <br> 5. 断言返回消息 `status == "REVOKED"` |
-| **测试步骤（TC-11b 编辑）** | 1. `subscribeGroup(testGroupId)` <br> 2. 发送带唯一标签群消息 → 轮询 `fetchGroupHistory` 内容匹配 ID <br> 3. `editMessage(id, newContent)` <br> 4. 断言 `editedAt != null` 且 `content == newContent` |
-| **预期结果** | 撤回后 status="REVOKED"；编辑后 editedAt 有值且 content 更新 |
-| **自动化代码** | `SdkIntegrationTest.tc11a_revokeMessage()` / `tc11b_editMessage()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-12 文件消息发送测试
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化 |
-| **优先级** | P2 |
-| **前置条件** | user_a 已登录，WebSocket Connected |
-| **测试步骤** | 1. 在 `cacheDir` 创建临时文本文件 <br> 2. `ImSDK.sendFileMessage(toId, chatType, file)` <br> 3. 断言 `msg.status != "FAILED"` <br> 4. 断言 `msg.content` 解析为 JSON 且含 `url` 字段 <br> 5. 清理临时文件 |
-| **预期结果** | 文件上传成功；消息 content 含有效 URL；status 非 FAILED |
-| **自动化代码** | `SdkIntegrationTest.tc12_sendFileMessage()` |
-| **通过状态** | ✅ 通过 |
-
---
-
-### TC-03 单聊消息收发（双设备自动化）
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（跨设备轮询） |
-| **优先级** | P0 |
-| **执行顺序** | 1. emulator-5554 运行 `CrossDeviceSenderTest`（user_a 发送）<br> 2. emulator-5556 运行 `CrossDeviceReceiverTest`（user_b 轮询接收） |
-| **测试步骤** | 发送方: `sendTextMessage(user_b, SINGLE, CROSS_DEVICE_AUTO_SINGLE_...)` <br> 接收方: 轮询 `fetchHistory("user_a")` 找含 CROSS_DEVICE_AUTO 的消息（最长 40s）<br> 接收方: `markRead("user_a")` → 验证 unreadCount=0 |
-| **通过状态** | ✅ 通过（双模拟器，12.66s） |
-
---
-
-### TC-04 群聊消息收发（双设备自动化）
-
-| 字段 | 内容 |
-|------|------|
-| **测试类型** | 自动化（跨设备轮询） |
-| **优先级** | P1 |
-| **执行顺序** | 与 TC-03 同批（CrossDeviceSenderTest + CrossDeviceReceiverTest） |
-| **测试步骤** | 发送方: `createGroup(TC04_AUTO_GROUP_xxx, [user_b])` → 订阅 → 发消息 <br> 接收方: `listGroups()` 找 TC04_AUTO_GROUP 前缀最新群 → `fetchGroupHistory` 找消息 |
-| **通过状态** | ✅ 通过（双模拟器） |
-
---
-
-## 五、Agent 执行手册
-
-本节提供可供 AI Agent（Claude Code 或其他）直接无缝接续执行的完整命令集。
-
-### 5.1 前置检查
-
-```bash
-# 检查 adb 连接
-export ANDROID_HOME=/Users/xuqinmin/Library/Android/sdk
-$ANDROID_HOME/platform-tools/adb devices
-# 预期: emulator-5554 device / emulator-5556 device
-
-# 若模拟器未启动
-$ANDROID_HOME/emulator/emulator -avd Pixel_9_Pro   -no-audio -no-boot-anim -no-snapshot-save &
-$ANDROID_HOME/emulator/emulator -avd Pixel_9_Pro_2 -no-audio -no-boot-anim -no-snapshot-save &
-sleep 30  # 等待启动
-```
-
-### 5.2 构建 APK
-
-```bash
-cd /Users/xuqinmin/Projects/XuqmGroup/XuqmGroup-AndroidSDK
-
-# 构建主 APK + 测试 APK
-./gradlew :sample-app:assembleDebug :sample-app:assembleDebugAndroidTest
-
-# 验证产物
-ls sample-app/build/outputs/apk/debug/sample-app-debug.apk
-ls sample-app/build/outputs/apk/androidTest/debug/sample-app-debug-androidTest.apk
-```
-
-### 5.3 安装到双模拟器
-
-```bash
-APK=sample-app/build/outputs/apk/debug/sample-app-debug.apk
-TEST_APK=sample-app/build/outputs/apk/androidTest/debug/sample-app-debug-androidTest.apk
-
-for DEV in emulator-5554 emulator-5556; do
-  adb -s $DEV install -r "$APK"
-  adb -s $DEV install -r "$TEST_APK"
-done
-```
-
-### 5.4 执行自动化测试
-
-```bash
-RUNNER="androidx.test.runner.AndroidJUnitRunner"
-TEST_PKG="com.xuqm.demo.test"
-
-# ── 单设备全量（TC-01~TC-12, 非跨设备部分）──
-ALL_SINGLE="com.xuqm.sdk.sample.SdkIntegrationTest,com.xuqm.sdk.sample.PushSdkTest,com.xuqm.sdk.sample.NetworkResilienceTest"
-adb -s emulator-5554 shell am instrument -w -r -e class "$ALL_SINGLE" "${TEST_PKG}/${RUNNER}"
-adb -s emulator-5556 shell am instrument -w -r -e class "$ALL_SINGLE" "${TEST_PKG}/${RUNNER}"
-
-# ── 跨设备 TC-03/04（先发送方，再接收方）──
-adb -s emulator-5554 shell am instrument -w -r \
-  -e class "com.xuqm.sdk.sample.CrossDeviceSenderTest" "${TEST_PKG}/${RUNNER}"
-adb -s emulator-5556 shell am instrument -w -r \
-  -e class "com.xuqm.sdk.sample.CrossDeviceReceiverTest" "${TEST_PKG}/${RUNNER}"
-```
-
-**或使用 Gradle（自动检测所有连接设备，单设备用例）：**
-```bash
-./gradlew :sample-app:connectedDebugAndroidTest
-```
-
-### 5.5 判断通过标准
-
-```
-每个测试用例输出:
-  INSTRUMENTATION_STATUS_CODE: 0   → 通过
-  INSTRUMENTATION_STATUS_CODE: -2  → 失败（查看 stack 字段）
-
-全套通过期望（单设备 13 个用例）:
-  Tests run: 13, Failures: 0  （SdkIntegrationTest×10 + PushSdkTest×2 + NetworkResilienceTest×1）
-
-跨设备（各 2 个用例）:
-  CrossDeviceSenderTest: Tests run: 2, Failures: 0
-  CrossDeviceReceiverTest: Tests run: 2, Failures: 0
-```
-
-### 5.6 查看 Logcat（失败时诊断）
-
-```bash
-# 过滤 SDK 相关日志
-adb -s emulator-5554 logcat -d -s "XuqmImSDK:D" "XuqmPushSDK:W" "XuqmUpdateSDK:D"
-
-# TC-10 网络韧性（实时监控重连事件）
-adb -s emulator-5554 logcat -s "XuqmImSDK:D" | grep -E "onConnected|onDisconnected|scheduleReconnect|connectWithToken"
-```
-
-### 5.7 TC-10 WiFi 断开（可选主机级脚本）
-
-```bash
-# 使用 adb 从主机切换模拟器网络（需先确保 App 已登录）
-bash scripts/tc10_network_resilience.sh emulator-5554
-```
-
-> 推荐方式: 使用 `NetworkResilienceTest`（Section 5.4 已包含），通过反射直接关闭 WebSocket，无需登录状态依赖。
-
---
-
-## 六、测试文件路径索引
-
-| 文件 | 作用 |
-|------|------|
-| `sample-app/src/androidTest/java/com/xuqm/sdk/sample/SdkIntegrationTest.kt` | TC-05 / TC-07 / TC-08 / TC-11 / TC-12 / TC-13 / TC-14 / TC-15 自动化 |
-| `sample-app/src/androidTest/java/com/xuqm/sdk/sample/PushSdkTest.kt` | TC-06 / TC-09 Push 自动化 |
-| `sample-app/src/androidTest/java/com/xuqm/sdk/sample/NetworkResilienceTest.kt` | TC-10 网络韧性自动化 |
-| `sample-app/src/androidTest/java/com/xuqm/sdk/sample/CrossDeviceTest.kt` | TC-03 / TC-04 双设备协同自动化 |
-| `scripts/tc10_network_resilience.sh` | TC-10 WiFi 级别网络断开脚本（主机运行） |
-| `sample-app/build.gradle.kts` | 已添加 `testInstrumentationRunner` 及测试依赖 |
-| `TEST_REPORT.md` | 每轮测试结果记录 |
-
---
-
-## 七、测试汇总（当前状态）
-
-| 用例 | 名称 | 类型 | 自动化 | 状态 |
-|------|------|------|-------|------|
-| TC-01 | SDK 初始化 | 核心 | ✅ @BeforeClass | ✅ 通过 |
-| TC-02 | IM 登录/登出 | 核心 | ✅ @Before/@After | ✅ 通过 |
-| TC-03 | 单聊消息收发 | IM | ✅ CrossDeviceTest | ✅ 通过（双模拟器） |
-| TC-04 | 群聊消息收发 | IM | ✅ CrossDeviceTest | ✅ 通过（双模拟器） |
-| TC-05 | 会话管理（置顶/静音/已读/删除） | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-06 | Push 设备注册 | Push | ✅ PushSdkTest | ✅ 通过（模拟器 FCM） |
-| TC-07 | 版本更新检查 | Update | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-08 | UserSig 重登 | 核心 | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-09 | 多厂商 Push 检测 | Push | ✅ PushSdkTest | ✅ 通过（双模拟器） |
-| TC-10 | 网络断开/自动重连 | 核心 | ✅ NetworkResilienceTest | ✅ 通过（双模拟器） |
-| TC-11a | 消息撤回 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-11b | 消息编辑 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-12 | 文件消息发送 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-13 | 音频消息发送 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-14 | 消息关键词搜索 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-15 | 好友管理与黑名单 | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-| TC-99 | 会话永久删除（GROUP） | IM | ✅ SdkIntegrationTest | ✅ 通过 |
-
-> **总计**: 17 用例 / 17 通过 | **自动化覆盖率: 17/17（100%）**
-
---
-
-## 八、后续扩展建议
-
-| 扩展项 | 优先级 | 说明 |
-|--------|--------|------|
-| TC-06 真机 Firebase 验证 | P1 | 在 Pixel/Samsung 真机上验证 FCM token 注册流程，`/api/push/register` 返回 200 |
-| TC-10 WiFi 级压测 | P2 | 使用 `scripts/tc10_network_resilience.sh` 在已登录 App 上做 WiFi 级断网验证 |
-| TC-16 音视频通话（预留） | P3 | 待 RTC 模块上线后补充 |
-| CI/CD 集成 | P1 | Jenkins Job `xuqmgroup-android-sdk-test`，`connectedDebugAndroidTest` 自动触发；见 `Jenkinsfile` |