# Taro H5 浏览器验收记录（2026-07-12）

## 验收范围

- 产物：学生端、租户后台、平台后台 H5
- 浏览器：Codex 应用内 Chromium 浏览器
- 视口：桌面 `1440x900`、移动 `390x844`
- 数据：本地 mock API，不连接生产数据库或第三方 provider
- 流程：首屏渲染、控制台、页面溢出、每个门户至少一个主入口交互

为了让应用内浏览器直接访问本地 API，视觉验收使用相同代码的 preview 构建。验收结束后必须重新生成 production 构建并重跑静态及交互烟测；preview 产物不能用于发布。

## 结果

| 门户 | 桌面首屏 | 移动首屏 | 控制台 error/warn | 页面级横向溢出 | 主入口交互 |
| --- | --- | --- | --- | --- | --- |
| 学生端 | 通过 | 通过 | 0 | 0 | `开始刷题` 进入题库页 |
| 租户后台 | 通过 | 通过 | 0 | 0 | `学生运营` 进入学生运营页 |
| 平台后台 | 通过 | 通过 | 0 | 0 | `租户管理` 进入租户管理页 |

独立 Chrome 业务交互烟测另行覆盖三端完整关键链路，最终结果为 `33/33`。Taro H5 runtime 加固后，Input 探针验证挂载前 `before-mount` 和挂载后 `after-mount` 均正确同步；Button 探针连续切换 loading 200 次，loading DOM 节点保持同一引用，子节点数始终为 `1`，显示状态为 `none -> inline-block -> none`。

## 发现与前端重构约束

1. 当前界面可用且响应式基础成立，但仍是功能原型，不代表视觉设计已达到正式商用标准。
2. 移动端无页面级横向滚动；顶部导航采用横向可滚动模式，属于既有设计行为。
3. 学生端构建入口约 `500 KiB`，且存在多个超过 `244 KiB` 的异步资源。前端重构必须建立路由拆包、资源预算和低端移动网络首屏指标，不能在当前入口继续无约束叠加组件。
4. 租户后台工作台 DOM 中存在位于横向快捷操作容器可视区之外的按钮，但容器自身裁切且页面宽度未溢出；正式重构时应改为明确的滚动、折叠或响应式操作布局。

## 复现

```bash
# 应用内浏览器视觉 QA 必须先生成三套 preview 产物。
npm run build:taro:h5:preview

# 该命令保持运行并打印三个门户 URL；若检测到 production 产物会直接拒绝启动。
npm run serve:taro:h5:qa

# 视觉 QA 结束后必须重新生成 production 产物；preview 产物不得发布。
npm run build:taro:h5:student
npm run build:taro:h5:tenant
npm run build:taro:h5:platform
npm run smoke:taro:h5
npm run smoke:taro:h5:interaction
```

截图证据保存在本机临时目录 `/tmp`，不进入发布仓库：

- `tiku-student-desktop-1440x900.png`
- `tiku-student-mobile-390x844.png`
- `tiku-tenant-desktop-1440x900.png`
- `tiku-tenant-mobile-390x844.png`
- `tiku-platform-desktop-1440x900.png`
- `tiku-platform-mobile-390x844.png`