docs: 记录 B-210 Android 通话视觉打回返工与构建证据

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: multica-agent <github@multica.ai>

docs/acceptance/b210-android-call-visual-rework.md

@@ -0,0 +1,97 @@
+# B-210 Android 通话视觉打回返工
+
+分支：`agent/agent/ede0aecc`（基于 B-204 `agent/agent/3a58b06e` HEAD `714794f`）
+施工依据：B-91 视觉规范 v2；打回结论 B-209；姓名字号裁定 18px，32px 仅计时器。
+本卡只做打回返工、构建验证和返工证据，不部署、不发布、不换标。
+
+**结论：9 项阻塞 + 建议项已按规范收口；Android debug/release 真实构建通过。缺有效账号和 ARM64 真机，来电/通话页实机渲染、听筒/扬声器、静音、后台/锁屏、铃声震动继续标为未测。**
+
+## 打回项对照
+
+| # | 打回项 | 修改位置 | 结果 |
+|---|---|---|---|
+| 1 | 计时器 32px 纯白 tabular figures | `AppFont.callTimer`、`Styles.ts_callTimer`、`controls.dart` 通话中状态字 | 已改 |
+| 2 | 通话页底 `#1D2129`，不复用 maskBg | `AppColors.callBg`、`Styles.c_callBg`、`call_state.dart` | 已改 |
+| 3 | 呼出中仅居中 64 红色取消 | `controls.dart` `_buttonArea`、`LiveButton.cancel` | 已改 |
+| 4 | 通话中 48 次按钮 + 居中红色挂断；Token 圆底线性图标 | `live_button.dart`、`controls.dart` | 已改，不再用位图 PNG |
+| 5 | 姓名 → 状态 → 96 头像圆角 0.18 | `controls.dart` `_infoColumn` | 姓名 18px，头像 96×0.18 |
+| 6 | 结束/失败展示 1.5s 后退出，失败 toast | `call_state.dart` `beginEnding`、`Styles.callEndHold` | 已结束 / 网络异常，通话中断 / 对方已拒绝 |
+| 7 | 未接 60s +「未接通话」系统消息；清掉 30s 双来源 | `AppDuration.callInviteTimeout` → `LiveKitCallConfig` / `Styles` / `CallSessionGuard` / 信令 timeout | 超时插入 `CallState.timeout`，文案 `未接通话` |
+| 8 | 进出 250ms 自下而上 ease-out，状态不可被重复回调破坏 | `call_page_host.dart`、`live_client.dart` close 防重入、`beginEnding` `_ending/_closed` | 已改 |
+| 9 | 来电每 1s 震动，拒绝/接听/退出/销毁停止 | `live_controller.dart` `_startIncomingVibrate` / `_stopSound` | 已改；真机未测 |
+| 10 | 状态字 14px 白 60%；文案；静音/免提；最小化点击区 48 | `ts_callStatus`、zh_CN 文案、`LiveButton.mute/handsFree`、最小化 `IconButton` 48 | 已改 |
+
+## 提交主题（可逐项 `git revert`）
+
+从新到旧回退：先本验收记录，再视觉返工。
+
+| 主题 | SHA | 文件 |
+|---|---|---|
+| 本验收记录 | 本文件当次提交 | `docs/acceptance/b210-android-call-visual-rework.md` |
+| 视觉打回返工 | `9bde926` | Token、文案、超时单一来源、通话页布局/按钮/结束态/动效/震动、测试 |
+
+回退示例（新到旧）：
+
+```
+git revert <本验收提交>
+git revert 9bde926
+```
+
+## 环境
+
+- Flutter 3.24.5 / Dart 3.5.4（`C:\flutter324`）
+- Temurin JDK 17.0.20+8
+- Android SDK：既有 B-95 工具链（compileSdk 34）
+- `org.gradle.jvmargs=-Xmx4096M`
+
+## 检查与构建
+
+### 定点测试
+
+```
+cd mobile-next
+flutter test test/company/rtc_token_mapper_test.dart test/company/call_session_guard_test.dart test/company/call_visual_rework_test.dart
+```
+
+16 项通过：换票映射、占线/去重/超时/销毁、60s 单一来源、callBg≠maskBg、32px tabular figures、14px/18px、250ms/1.5s/48·64·96 尺寸。
+
+定点 `flutter analyze` 修改文件：**0 error**。存量 info/warning 未作为本卡阻塞。
+
+### Android（真实构建）
+
+| 构建 | 结果 | 大小 | SHA256 | 产物 |
+|---|---|---|---|---|
+| debug | 成功 | 109,424,273 B | `415478F0908BB44449C7DA944F07C5214989888C77B7E13295E4D71082197308` | `mobile-next/build/app/outputs/flutter-apk/app-debug.apk` |
+| release | 成功 | 53,289,471 B | `7D81C54D2A03920E0989DDCFD5E29C3433DEB4FDB15266DE2913864D6C4FFD1C` | `mobile-next/build/app/outputs/flutter-apk/app-release.apk` |
+
+构建期告警同 B-204：Flutter Gradle apply-script 弃用；部分依赖 Kotlin metadata 1.8.0 vs 工程预期 1.6.0。均属上游，debug/release 均通过。APK 内嵌时间戳，哈希不可位级复现。
+
+## 越界比对
+
+相对 `714794f`（本卡开工 HEAD）：仅 `mobile-next/` 与本验收文档。
+
+相对 `e26abad`：`mobile/`、`account-service/`、`config/`、`scripts/` **零改动**。本卡工作区 diff 不含 `pc-client/`。
+
+`FeatureFlags.livekitCall` 门控保持：配置不足时入口隐藏。
+
+## 已测 / 未测
+
+已测（替身或构建）：
+
+- Token 映射：callBg `#1D2129`、计时器 32px tabular figures、状态字 14px 白 60%、姓名 18px
+- 未接超时 60s 单一来源（配置 / Styles / Guard）
+- 占线、重复信令、超时取消、销毁释放计时器
+- Android debug/release 可构建
+
+未测（缺外部条件，禁止写成通过）：
+
+- 无有效工号+密码，未登录
+- Android ARM64 真机：呼入呼出、听筒/扬声器、静音、后台/锁屏、铃声与每秒震动
+- 结束/失败 1.5s 退场与 250ms 滑入滑出的真机观感
+- 「未接通话」系统消息在会话里的真机展示
+
+## 风险与回退
+
+- 真机铃声/震动依赖设备振动器与勿扰模式，静态审查不能代替点验
+- 结束态 1.5s 内重复回调被 `_ending` 吞掉，属有意防护
+- 回退：先 `git revert` 本验收提交，再 `git revert` 视觉返工提交