文档内容何时保存 - 石墨文档中台(SDK)

石墨 SDK 的协同引擎会在用户输入后立即把增量 Operation 推送到石墨云端，并在所有协作者之间广播，因此无需手动保存。

工作机制：

编辑页面的内容状态「保存中/保存成功/保存失败」由 SDK 自动维护，接入方通过接入前端 saveStatusChanged 监听函数来对应展示编辑状态，对应状态值为「saving/saved/error」；只要保持 AppId、签名和网络有效，内容就会持续落盘。

服务端同时生成历史版本，可在界面中查看回溯，误操作也能快速恢复。

如果临时断网，SDK 会将尚未同步的操作排队，网络恢复后自动补发；若长时间无法补发，会提示用户刷新以避免冲突。

业务侧建议：

如需在业务界面展示保存状态，可订阅 JSSDK 提供的同步状态事件（详见 npm README）或直接读取 SDK 的状态提示来提醒用户。

在关闭窗口或切换路由前，可检测当前同步状态并在尚未完成时给予二次确认，确保用户知悉。

因此，大部分场景无需编写额外保存逻辑，把精力放在网络健康监控与错误提醒上即可。