石墨文档离线编辑时自动缓存至本地数据库，联网后按时间戳同步并解决冲突。支持手动触发同步、移动端后台同步及向量时钟冲突检测与可视化合并。
如果您在没有网络连接的情况下编辑石墨文档，系统会将更改暂存于本地设备，待恢复联网后自动尝试同步。以下是石墨文档离线保存与同步机制的具体说明：
一、本地缓存写入机制
石墨文档在检测到网络中断时，会启用本地 IndexedDB 存储，将用户编辑内容实时写入浏览器或客户端本地数据库。该机制确保所有未提交的修改不会丢失，且保留光标位置、格式标记及协作痕迹元数据。
1、打开石墨文档网页版或桌面客户端，进入任意文档进行编辑。
2、手动关闭 Wi-Fi 或拔掉网线，模拟离线环境。
3、继续输入文字、调整标题层级、插入表格，所有操作即时反映在界面中。
4、观察右上角状态栏，图标变为“离线编辑中”提示。
二、网络恢复后的自动同步流程
当设备重新接入互联网，石墨文档客户端会触发心跳检测，确认服务端可用性后，按时间戳顺序上传本地变更集，并比对服务端最新版本以解决潜在冲突。
1、重新连接网络，等待约 3–8 秒。
2、右上角状态栏由离线图标切换为“正在同步”动画。
3、同步完成后，状态栏显示“已同步至最新版本”，文档顶部出现绿色对勾标识。
4、刷新页面或切换文档再返回，验证编辑内容是否完整出现在服务端。
三、手动触发同步的操作方式
在部分弱网或高延迟场景下，自动同步可能延迟，此时可通过强制刷新同步队列来加速更新，该操作不依赖页面重载，直接调用本地同步引擎。
1、点击右上角用户头像旁的齿轮图标，打开设置菜单。
2、选择“立即同步所有离线更改”选项。
3、弹出确认框后点击“确定”，界面显示同步进度条。
4、进度条满格后，文档底部浮层提示“全部离线内容已提交成功”。
四、移动端离线同步特殊处理
iOS 与 Android 客户端使用本地 SQLite 数据库存储离线文档快照，并通过后台服务监听网络状态变化，支持锁屏状态下完成同步任务，但需开启对应系统权限。
1、在手机设置中进入石墨文档应用权限管理。
2、开启“后台活动”与“无线数据”两项权限。
3、退出应用至后台，断开网络，编辑文档并关闭 App。
4、重新联网后，30 秒内系统自动拉起同步服务，状态栏通知显示“离线文档已更新”。
五、冲突检测与版本回退路径
当多人同时离线编辑同一文档并先后联网时，石墨文档采用向量时钟（Vector Clock）算法识别操作序列冲突，保留所有分支版本并提供可视化合并界面，用户可选择接受某一方修改或手动整合。
1、在文档右上角点击“历史版本”按钮。
2、找到带“离线提交”标签的时间节点。
3、点击该版本右侧的“对比”按钮，查看与当前版本的差异区块。
4、在差异视图中逐段点击“采纳此修改”或“忽略”完成合并。
