docs: 阶段4跨端回归记录(2026-08-16,B-52修复后)

Co-authored-by: multica-agent <github@multica.ai>
This commit is contained in:
编码工程师
2026-08-16 18:36:39 +08:00
co-authored by multica-agent
parent a007e8f694
commit 8391e6a7b4
+51
View File
@@ -0,0 +1,51 @@
# 阶段 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/t1002PC 端(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` 联调开关(默认不变)