> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 离线访问

按工作区隔离的读取缓存，让界面在无网络时仍可用。

## 缓存存什么

在应用的文档目录下，supastack-offline/ 中的 JSON 文件保存最近成功的读取，文件名是用户、工作区与键的哈希 —— 原始标识符绝不出现在路径里。条目七天后过期，每个上限 256 KB，损坏或超限的文件会被删除或拒收。所有缓存 I/O 都是尽力而为，绝不阻塞界面。


## 网络优先，缓存兜底

带缓存的读取总是先走网络并持久化新副本。缓存只在连接失败时供数 —— 主机不可达或 status-0 的客户端错误。401、500 这类 HTTP 失败会原样抛出：被拒绝的资源绝不提供陈旧数据，已失效的会话也绝不会被缓存回复续命。


## 缓存何时清空

退出登录会清空全部缓存，换账户登录同样如此。切换工作区则保留缓存 —— 作用域彼此隔离，一个工作区永远读不到另一个的行。


## 用户看到什么

走缓存的界面会显示一条本地化横幅 —— You're offline — showing data saved {ago} —— 以相对时间呈现，并作为无障碍提醒播报。首页、账单、通知、内容、电商与聊天列表界面都经由缓存读取。


## 验证与排障

用飞行模式逐个测试带缓存的界面：读取存活、写入干净地失败、横幅报告数据保存时长。退出登录并确认上一账户没有留下任何内容。


## 下一篇

[应用锁与设备安全](https://supastack.dev/zh/docs/mobile/security.md)