For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/offline.md (or send Accept: text/markdown).
离线访问
按工作区隔离的读取缓存,让界面在无网络时仍可用。
缓存存什么
在应用的文档目录下,supastack-offline/ 中的 JSON 文件保存最近成功的读取,文件名是用户、工作区与键的哈希 —— 原始标识符绝不出现在路径里。条目七天后过期,每个上限 256 KB,损坏或超限的文件会被删除或拒收。所有缓存 I/O 都是尽力而为,绝不阻塞界面。
网络优先,缓存兜底
带缓存的读取总是先走网络并持久化新副本。缓存只在连接失败时供数 —— 主机不可达或 status-0 的客户端错误。401、500 这类 HTTP 失败会原样抛出:被拒绝的资源绝不提供陈旧数据,已失效的会话也绝不会被缓存回复续命。
缓存何时清空
退出登录会清空全部缓存,换账户登录同样如此。切换工作区则保留缓存 —— 作用域彼此隔离,一个工作区永远读不到另一个的行。
用户看到什么
走缓存的界面会显示一条本地化横幅 —— You're offline — showing data saved {ago} —— 以相对时间呈现,并作为无障碍提醒播报。首页、账单、通知、内容、电商与聊天列表界面都经由缓存读取。
验证与排障
用飞行模式逐个测试带缓存的界面:读取存活、写入干净地失败、横幅报告数据保存时长。退出登录并确认上一账户没有留下任何内容。