相片页面
相片页面用于查看、下载和删除账号下的相片文件。页面同时使用服务端文件列表和浏览器短期图片缓存，因此“清除本地缓存”和“删除服务端相片”是两种完全不同的操作。
页面首次加载
- 确认顶部显示的是目标账号；
- 打开“烘焙相片”；
- 页面读取文件列表；
- 列表出现后按需加载缩略图；
- 点击具体文件查看原图。
没有相片时，页面会显示空状态；加载中、刷新中、读取失败和列表为空应分别处理。
顶部按钮
刷新
“刷新”重新读取服务端文件列表。刷新期间按钮会禁用，避免重复请求。刷新只更新列表，不会删除浏览器已经缓存的图片。
清除缓存
“清除缓存”只删除当前浏览器保存的缩略图/图片对象：
- 不会删除服务端文件；
- 不会改变相片列表；
- 清除后再次查看需要重新下载；
- 适合浏览器缓存过旧或本地占用过大时使用。
删除所有相片
这是服务端删除操作，会影响当前账号的全部相片。执行前必须：
- 下载需要保留的原图；
- 核对当前账号；
- 确认没有其它设备正在查看或下载；
- 阅读二次确认文字；
- 只点击一次并等待结果。
删除成功后页面清空列表和当前预览；失败时保留原列表，不要通过刷新来猜测是否已经删除。
相片缩略图
列表按文件名显示卡片。图片采用按需加载：进入可视区域后才请求缩略图，加载期间会显示占位状态。
可能出现的情况：
- 文件列表成功但某张缩略图加载失败；
- 缩略图成功但原图加载失败；
- 图片缓存命中，几乎不产生等待；
- 浏览器缓存被清除后重新下载。
缩略图失败不等于文件已经丢失。先点击“查看”重试一次，再记录文件名和错误消息。
查看单张相片
点击卡片或“查看”按钮后，页面打开预览区域，可能显示：
- “查看相片：文件名”；
- 加载中提示；
- 原图；
- “下载相片”；
- “删除相片”；
- 关闭按钮。
下载原图
下载使用服务端返回的原文件名。下载前确认浏览器没有拦截弹出下载，下载后检查文件大小和图片能否打开。
删除单张
单张删除只影响当前文件，但同样不可逆。确认文件名后再删除；删除成功会从列表移除，并关闭或清空当前预览。
关闭预览
关闭只退出预览，不会删除相片，也不会清理本地缓存。若要清理缓存，使用顶部的“清除缓存”。
错误与恢复
| 现象 | 优先处理 |
|---|---|
| 请先登录账号 | 回到账号选择页验证 Token |
| 获取相片列表失败 | 保留提示，检查网络并刷新一次 |
| 图片加载失败 | 记录文件名，重试原图读取 |
| 删除失败 | 保留列表，确认账号和文件名 |
| 预览空白 | 先关闭再重新打开，检查浏览器下载/图片权限 |
| 列表为空 | 区分真的没有相片和读取失败 |
隐私与长期保存
相片可能包含机台画面、用户名称、二维码、现场人员或其它个人信息。分享前打码，故障报告只提供必要区域。服务可能按保留策略清理旧相片，长期保存必须主动下载到受保护的位置。
相片 API 的列表、单文件读取、单张删除和全部删除见相片管理 API。文件读取成功时可能是二进制，失败时才可能返回 JSON，第三方客户端不能无条件调用 json()。