# 阶段 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` 联调开关（默认不变）
