移动端、浏览器与 PWA 使用说明
网页支持桌面和移动浏览器。功能入口、文件权限、二维码、弹窗和大表格在小屏幕上有不同操作方式。本页说明如何减少误触和状态误判。
桌面端
桌面端适合：
- 编辑长 JSON；
- 查看多列订单表；
- 处理评论和审核；
- 对比多台机台统计；
- 下载和整理缓存/相片。
浏览器窗口过窄时，表格可能横向滚动，不要为了“看起来完整”复制到公开聊天。
移动端菜单
移动端通过汉堡按钮打开导航：
- 点击按钮展开；
- 选择目标页面；
- 页面切换后菜单应关闭；
- 点击页面外部关闭；
- 切换账号前确认当前写入已完成。
如果菜单遮住二维码或弹窗，先关闭菜单再操作。系统返回键和浏览器返回键可能有不同历史行为。
二维码操作
手机屏幕建议：
- 提高亮度；
- 保持二维码四个定位点完整；
- 避免反光和自动缩放；
- 横屏/竖屏按设备要求选择；
- 识别失败时复制文本；
- 使用后删除截图和下载副本。
不要通过社交软件中转完整二维码。聊天记录会同步到多个设备，删除一处不代表已经清除所有副本。
文件选择
文件选择器可能需要系统权限。选择备份、头像或二维码前确认：
- 当前账号正确；
- 文件来自受信位置；
- 选择的是原文件而不是缩略图/截图；
- 页面显示文件名和大小；
- 取消选择不会提交旧文件。
公共设备使用完后清理下载目录和浏览器临时文件。
JSON 和大表格
移动端编辑 JSON 容易误删引号或换行。推荐在受保护电脑上编辑长对象，再回到网页上传/粘贴。无法避免移动端编辑时：
- 先复制原文；
- 放大输入区域；
- 不使用智能引号；
- 保存前查看“JSON 有效”；
- 保存后回读；
- 关闭键盘后再点击确认。
大表格可以横向拖动。不要仅凭第一列判断订单或机台来源。
深色模式
主题按钮只改变浏览器显示，不改变机台或账号数据。回归时检查：
- 错误文字可读；
- 禁用按钮仍有明显状态；
- 二维码对比度足够；
- 图表图例可区分；
- 弹窗背景和关闭按钮可见。
PWA/添加到主屏幕
支持 PWA 的浏览器可以添加到主屏幕，但本地缓存可能保留旧前端资源。更新后出现页面与文档不一致时：
- 关闭已打开的 PWA 窗口；
- 使用当前入口重新打开；
- 刷新并重新登录；
- 确认标题和版本；
- 再做写入或删除。
不要在旧 PWA 页面中输入新的凭据或恢复文件，先确认页面来源。
下载和预览
移动浏览器可能把文件放入下载目录或弹出系统确认。下载前检查文件类型和目标账号，下载后不要自动打开未知扩展名。图片预览关闭后仍可能留在浏览器缓存，敏感照片要主动清理。
网络切换
手机从 Wi‑Fi 切到移动网络时，当前请求可能超时。对于读取可以有限重试；对于保存、删除、上传和机台动作，先重新读取状态，不要自动重复。
移动端回归清单
- [ ] 菜单展开/关闭正常；
- [ ] 账号下拉菜单不被遮挡；
- [ ] 二维码完整可见；
- [ ] 文件选择和下载权限明确；
- [ ] 长 JSON 可滚动；
- [ ] 表格可横向滚动；
- [ ] 深色模式文字可读；
- [ ] 自动刷新离开页面后停止；
- [ ] 网络切换后写入不会重复；
- [ ] 关闭页面后临时凭据被清理。