智桥 PWA 移动端测试指南

📱 测试设备要求

iOS 设备

最低版本: iOS 16.4+ (支持 PWA 安装)
推荐版本: iOS 17+
推荐浏览器: Safari

Android 设备

最低版本: Android 5.0+ (Lollipop)
推荐版本: Android 12+
推荐浏览器: Chrome, Samsung Internet

📋 测试清单

1. 安装和访问

iOS (Safari)

[ ] 访问应用地址: http://10.113.22.99:8080/web/ui/index.html
[ ] 点击分享按钮 (⎋)
[ ] 选择"添加到主屏幕"
[ ] 确认名称和图标
[ ] 点击"添加"
[ ] 从主屏幕打开应用
[ ] 验证应用以全屏模式运行（无地址栏）

Android (Chrome)

[ ] 访问应用地址: http://10.113.22.99:8080/web/ui/index.html
[ ] 查看浏览器地址栏右侧
[ ] 点击"安装"或"添加到主屏幕"图标
[ ] 确认安装
[ ] 从主屏幕打开应用
[ ] 验证应用作为独立应用运行

2. WebSocket 连接测试

测试步骤

[ ] 打开应用
[ ] 查看右上角连接状态指示器
[ ] 应该显示"已连接" (绿色)
[ ] 如果显示"未连接"，点击"连接"按钮
[ ] 等待连接建立
[ ] 验证连接状态变为绿色

预期结果

✅ 连接状态显示正确
✅ 连接建立时间 < 2秒
✅ 连接稳定，不会频繁断开重连

3. 会话管理测试

创建会话

[ ] 选择一个 AI 工具 (例如：Crush)
[ ] 输入命令参数 (例如：--help)
[ ] 点击"启动会话"按钮
[ ] 观察会话列表中是否出现新会话
[ ] 验证会话状态显示为"运行中"
[ ] 查看会话输出

停止会话

[ ] 在会话列表中找到正在运行的会话
[ ] 点击"停止"按钮
[ ] 确认停止操作
[ ] 验证会话状态变为"已停止"
[ ] 验证会话从活动列表中移除

删除会话

[ ] 在会话历史中找到已停止的会话
[ ] 点击"删除"按钮
[ ] 确认删除操作
[ ] 验证会话从历史列表中移除

预期结果

✅ 会话创建成功
✅ 会话停止成功
✅ 会话删除成功
✅ 会话状态更新实时
✅ 输出显示正确

4. 推送通知测试

启用推送通知

[ ] 打开应用设置
[ ] 找到"推送通知"选项
[ ] 启用推送通知开关
[ ] 浏览器会弹出权限请求对话框
[ ] 点击"允许"
[ ] 验证推送通知已启用

接收通知

[ ] 确保推送通知已启用
[ ] 创建一个新会话
[ ] 等待通知接收（应该在几秒内）
[ ] 验证通知内容正确（会话名称、状态等）
[ ] 停止会话
[ ] 验证收到会话停止通知

通知交互

[ ] 点击接收到的通知
[ ] 验证应用打开并跳转到相应页面
[ ] 验证会话详情正确显示

预期结果

✅ 权限请求弹出正确
✅ 推送通知接收及时
✅ 通知内容正确
✅ 点击通知打开应用
✅ 跳转到正确页面

iOS 特殊注意事项

⚠️ iOS Safari 需要用户主动交互（点击、滚动）才能发送通知
⚠️ iOS 16.4 以下版本不支持 PWA 推送通知
⚠️ 通知可能出现在通知中心或锁定屏幕

Android 特殊注意事项

✅ Android Chrome 对 PWA 推送通知支持良好
✅ 通知会出现在通知栏
✅ 可以配置通知声音和震动

5. 文件提及功能测试

文件搜索

[ ] 点击文件面板中的"提及文件"按钮
[ ] 在搜索框中输入文件名（例如：server.py）
[ ] 等待搜索结果
[ ] 验证搜索结果显示正确
[ ] 点击搜索结果

文件查看

[ ] 点击文件搜索结果
[ ] 验证文件内容正确显示
[ ] 检查文件元数据（大小、修改时间等）
[ ] 验证代码高亮正确（对于代码文件）

文件列表

预期结果

✅ 搜索功能快速响应
✅ 搜索结果准确
✅ 文件内容正确显示
✅ 文件元数据正确
✅ 目录导航流畅

6. 离线功能测试

缓存内容

[ ] 在有网络连接的情况下浏览应用
[ ] 访问多个页面
[ ] 验证页面加载正常

离线访问

[ ] 打开设备设置
[ ] 关闭 Wi-Fi 和移动数据
[ ] 返回应用
[ ] 刷新页面或导航
[ ] 验证缓存内容正常显示
[ ] 查看离线提示信息

恢复在线

[ ] 重新连接 Wi-Fi 或移动数据
[ ] 刷新页面
[ ] 验证在线状态恢复
[ ] 验证新内容可以加载

预期结果

✅ 缓存内容正常显示
✅ 离线状态提示正确
✅ 在线恢复后正常工作

7. 响应式设计测试

不同屏幕尺寸

[ ] iPhone SE (375x667)
[ ] iPhone 12/13/14 (390x844)
[ ] iPhone 14 Pro Max (430x932)
[ ] iPad (768x1024)
[ ] iPad Pro (1024x1366)
[ ] 小屏 Android (360x640)
[ ] 中屏 Android (360x800)
[ ] 大屏 Android (412x915)

测试要点

[ ] 布局自适应不同屏幕
[ ] 文字大小合适
[ ] 按钮易于点击
[ ] 表单易于填写
[ ] 没有水平滚动条（除非必要）

8. 触摸交互测试

基本手势

[ ] 点击: 所有按钮和链接响应正常
[ ] 长按: 显示上下文菜单（如适用）
[ ] 滑动: 页面和列表滚动流畅
[ ] 捏合缩放: 页面缩放正常（如适用）

预期结果

✅ 所有触摸响应及时
✅ 没有误触发
✅ 手势识别准确

9. 性能测试

页面加载

[ ] 首次加载时间 < 3秒
[ ] 后续加载时间 < 1秒
[ ] 页面切换流畅

动画和过渡

[ ] 动画流畅 (60fps)
[ ] 没有明显卡顿
[ ] 过渡自然

内存使用

[ ] 长时间使用没有明显卡顿
[ ] 没有内存泄漏迹象

10. 兼容性测试

浏览器测试

[ ] Safari (iOS)
[ ] Chrome (Android)
[ ] Samsung Internet (Android)
[ ] Firefox (Android)
[ ] Edge (Android)

预期结果

✅ 所有支持的浏览器正常工作
✅ 功能一致性良好

11. 安全性测试

HTTPS 警告

[ ] 注意到 HTTP 连接提示（预期行为）
[ ] 确认不会存储敏感信息
[ ] 确认不会发送敏感信息

预期结果

✅ 用户理解当前使用 HTTP
✅ 没有敏感数据泄露风险

📊 测试结果记录

测试环境

设备型号: ___
操作系统版本: ___
浏览器名称和版本: ___
屏幕分辨率: ___
测试日期: ___

功能测试结果

测试项	通过	失败
安装和访问	☐	☐
WebSocket 连接	☐	☐
会话管理	☐	☐
推送通知	☐	☐
文件提及功能	☐	☐
离线功能	☐	☐
响应式设计	☐	☐
触摸交互	☐	☐
性能	☐	☐
兼容性	☐	☐
安全性	☐	☐

性能指标

指标	实测值	目标值	状态
首次加载时间		< 3s
后续加载时间		< 1s
WebSocket 连接时间		< 2s
动画帧率		60fps

🐛 问题报告模板

如发现问题，请按以下格式记录：

问题描述

标题: ___

严重程度: ☐ 致命 ☐ 严重 ☐ 中等 ☐ 轻微 ☐ 建议

复现步骤: 1. 2. 3.

预期结果:

实际结果:

环境信息: - 设备型号: __ - 操作系统版本: __ - 浏览器版本: __ - 屏幕分辨率: __

截图/录屏: (如果适用)

📝 总结

通过的功能

-

需要改进的功能

-

建议和反馈

-

文档版本: 1.0.0 最后更新: 2026-03-29 作者: Crush AI Assistant