OpenClaw-bot-review/prd/mobile_adaptation_checklist.md

手机端适配验收清单（PC 上测试）

项目：OpenClaw Bot Dashboard
测试日期：年__月__日
测试人：____

1. 测试环境

• 浏览器：Chrome 最新版
• DevTools 设备模式已开启（Cmd/Ctrl + Shift + M）
• Disable cache 已勾选
• 使用同一构建版本进行测试（避免本地缓存干扰）

2. 断点与设备矩阵

2.1 断点覆盖

• 360 宽（小屏 Android）
• 390 宽（iPhone 12/13/14）
• 412 宽（大屏 Android）
• 768 宽（平板/小桌面边界）
• 1024 宽（桌面基线）

2.2 方向覆盖

• 竖屏（Portrait）
• 横屏（Landscape）

3. 全局布局与导航

• 页面无整体横向滚动条（非表格局部滚动除外）
• 顶部/侧边导航可正常打开和关闭
• 导航点击后可正确跳转页面
• 当前页面高亮状态正确
• 语言切换可用（中文/英文）
• 主题切换可用（深色/浅色）

4. 页面可用性检查

4.1 首页 /

• 首屏卡片不重叠、不溢出
• 顶部按钮组在手机宽度下可操作
• Agent 卡片内容可读，关键字段不被遮挡

4.2 Models /models

• Provider 区块布局正常
• 表格/明细区域在手机端可浏览（滚动或卡片化正确）
• 测试按钮可点击，状态反馈可见

4.3 Sessions /sessions

• Agent 列表卡片布局正常
• Session 列表项不重叠
• 测试按钮与时间信息显示正常

4.4 Stats /stats

• 统计卡片在手机端不挤压重叠
• 图表区域可见且可读
• 时间范围切换按钮可操作

4.5 Alerts /alerts

• 规则区与触发区可完整显示
• 表单输入和开关可用
• 按钮点击反馈正常

4.6 Skills /skills

• 技能卡片栅格在手机端正常换行
• 标签和按钮不溢出

5. Pixel Office 专项 /pixel-office

• 页面可进入且首屏可见（无白屏/卡死）
• 画布区域在手机端可正常显示
• 点击家具可打开对应弹层（手机/时钟/沙发等）
• 弹层内容可滚动、可关闭
• 返回其他页面后无残留遮罩
• 性能可接受（无明显掉帧卡顿）

6. 交互与可访问性

• 所有关键按钮点击区域足够大（约 >= 40px）
• 文本可读（无大面积 10px 以下关键文案）
• 颜色对比在浅色模式下仍可读
• 无仅依赖 hover 才能触发的关键功能

7. 回归与稳定性

• 连续切换页面 10 次无明显布局错乱
• 切换语言/主题后布局仍稳定
• 刷新页面后状态与布局正常

8. 问题记录模板

编号	页面	设备/宽度	复现步骤	实际表现	期望表现	严重级别
1
2
3

9. 验收结论

• 通过（可上线）
• 有条件通过（需修复低/中优先级问题）
• 不通过（存在阻塞问题）