石墨文档离线时通过浏览器缓存、App草稿箱和桌面端快照三种机制暂存内容:网页端用IndexedDB临时缓存未同步编辑;移动端需手动“保存到本地”才启用SQLite存储;桌面端每5分钟自动生成加密快照文件用于恢复。

如果您在使用石墨文档时网络中断或处于无网环境,文档内容仍可能被保留,但其保存行为并非传统意义上的“离线持久化存储”。以下是石墨文档在离线状态下处理数据的具体机制:
一、依赖浏览器本地存储的临时缓存
石墨文档在网页端运行时,会利用浏览器提供的 IndexedDB 和 localStorage 接口,在用户设备本地暂存未同步的编辑内容。该缓存不经过服务器确认,仅用于断网期间维持编辑连续性。
1、打开石墨文档网页并登录账号,确保此前已成功加载过目标文档。
2、断开网络连接(如关闭Wi-Fi或拔掉网线)。
3、继续输入或修改文档内容,界面通常不会报错,光标可正常移动。
4、重新联网后,系统自动尝试将 IndexedDB 中暂存的变更提交至云端。
5、若提交成功,文档历史版本中将新增此次离线编辑记录;若提交失败(如冲突或超时),部分修改可能丢失且无本地文件备份。
二、移动端App的离线草稿箱机制
石墨文档iOS/Android客户端内置独立草稿管理模块,对用户主动触发“保存到本地”操作的文档启用本地SQLite数据库存储,形成与云端分离的副本。
1、在App中打开任意文档,点击右上角“更多”按钮(三个点图标)。
2、选择“保存到本地”,此时文档标题旁会出现“已保存到本地”提示。
3、断网后进入“我的文档”页,切换至“本地文档”标签页即可查看和编辑。
4、联网后手动点击该本地文档右上角同步按钮,触发双向合并逻辑。
5、未执行“保存到本地”的文档在离线时仅保留在内存中,重启App即清空。
三、桌面客户端的自动本地快照功能
Windows/macOS版石墨文档客户端默认启用后台定时快照策略,每5分钟将当前编辑状态写入本地磁盘指定目录,生成加密的 .gsnap 文件,作为紧急恢复依据。
1、安装并登录桌面客户端,打开需长期编辑的文档。
2、保持客户端前台运行,无需额外设置即可激活快照机制。
3、断网或意外退出后,再次启动客户端,首页顶部将弹出“检测到未同步编辑,请恢复?”提示栏。
4、点击“恢复”可载入最新快照,内容精度可达最后一次自动保存时间点。
5、快照文件默认存储于用户目录下的 /GraphDoc/Snapshots/ 路径,不可直接用文本编辑器打开。










