tongxunruanjian/docs/phase4-regression-2026-08-16.md

阶段 4 跨端回归记录（2026-08-16）

基线：main @ a007e8f（含 B-52 三项修复：发消息根因 d6ef6eb、同事页/五态 b50ee24+c73e19c、PC 通讯录入口 032882d，以及本轮版本号提升 7eab7d5、AUTH_HOST 联调开关 a007e8f）。 交付包：changlian-1.0.6-android-arm64.apk（28.8MB）、畅联_1.0.2.exe（101MB，分 5 片 + hebing.bat）。 环境：两台安卓模拟器（x86_64，与真机同 OpenIM SDK 3.8.3+hotfix.12）登录 t1001/t1002；PC 端（Electron 22 测试构建）登录 t1003；三者连真实 OpenIM 192.168.200.11，账号服务为本地实例（未改现网）。

一、已在本机完成的跨端回归（通过项）

#	用例	方法	结果
1	安卓 A(t1001)→安卓 B(t1002) 文字	A 发 regTextAtoB_1	B 会话列表+聊天窗均收到，未读+1
2	安卓 B→安卓 A 文字	B 发 regTextBtoA_2	A 聊天窗实时收到
3	PC(t1003)→安卓 B 好友申请	PC「添加同事」弹窗输工号 t1002 发送	B 通讯录「新的同事」出现角标 1，申请行显示「接受/拒绝」按钮组（B-52 视觉修复生效）
4	安卓 B 接受 PC 好友申请	B 点「接受」	双方通讯录出现对方；PC 侧显示「已添加」
5	PC→安卓 B 文字	PC 打开 t1002 会话发 regPcToMobile_3	B 会话列表+聊天窗实时收到
6	安卓 B→PC 文字	B 发 regMobileToPc_4	PC 聊天窗收到（方向标记正确）
7	安卓 B→PC 图片	B 图库选图发送	PC 聊天窗显示 [图片] 卡片
8	安卓 B→PC 语音消息	B 按住说话约 8 秒发送	PC 聊天窗收到 8″ 语音条
9	表情消息	B 发 emoji 😢	PC 收到渲染正常
10	手机「新的同事」五态	B 收到申请→接受→「已添加」	与视觉规范 5.1 一致（发出方「等待对方通过」、收方按钮组、已添加/已拒绝）

二、本地环境无法闭环、需真机验证项（未通过/待测）

#	用例	本地现象	原因/说明
F1	安卓→PC 文件传输	安卓发 test-file.txt（100B），消息行标记「T」但 PC 端未收到；期间出现「消息没发出去，点红色感叹号重试」提示（重试机制本身工作正常）	模拟器环境 MinIO/上传连接被重置（logcat HTTP_DATA_ERROR: Connection reset），疑与模拟器网络或文件 URI 处理有关，需真机确认
C1	一对一语音通话	安卓发起通话，FlutterWebRTC onConnectionChangeCLOSED，未建立通话	LiveKit/WebRTC 音频在模拟器环境不稳定，需两台真机确认（此为本项目既定真机回归项）

说明：以上两项与「发送根因」无关（文字/图片/语音消息均已跨端闭环），是音频/文件链路的真机环境相关项，已列入下方真机待测清单。

三、构建验证

• 安卓：flutter build apk --release --split-per-abi --target-platform android-arm64 → 27.5MB（安装后 1.0.6）；--debug --target-platform android-x64 --dart-define=AUTH_HOST=<本机IP> 供模拟器联调（正式包不带该参数，登录地址与 serverHost 一致）。
• PC：npm run build（vite exit 0）+ electron-builder --win --x64 → 畅联_1.0.2.exe（101MB）。产物内嵌地址复核：http://192.168.200.11:10010 / ws://192.168.200.11:10001 / ws://192.168.200.11:17880，无测试地址残留。
• SHA256：APK 98BC2DCEF473AC04A65E9F072BAB1F26DDA37584D690CE5FC3F412D461DE6403；exe DFD03AF7125041B721A38CF915C712AE8BBE8267CF49ECEC9C8584A191CA9F31（分片还原一致）。

四、真机待测清单（需用户/团队执行）

1. 卸载手机旧版「畅联」，安装 changlian-1.0.6-android-arm64.apk（若提示签名不一致请先卸载）。
2. PC 安装 畅联_1.0.2.exe（分片先 hebing.bat 还原）。
3. 文件传输：手机↔PC 互传图片/文件，确认下载打开正常（本地模拟器 F1 未闭环）。
4. 语音通话：两台真机 + PC 一对一语音通话接通、声音双向、挂断正常（本地 C1 未闭环）。
5. 长文本 / emoji / 特殊字符不丢字不乱码（本地已测短文本，真机补长文本）。
6. 断网后发送显示红色感叹号，点重试能成功。
7. 管理员停用/重置密码 → 对应端被踢下线（账号服务行为，本地代码已验，真机确认一次）。

五、改动清单（本轮）

• mobile/pubspec.yaml：1.0.5+6 → 1.0.6+7
• pc-client/package.json、src/config/index.ts：1.0.1 → 1.0.2（v1.0.2）
• mobile/lib/config.dart：新增 --dart-define=AUTH_HOST 联调开关（默认不变）