轻笺

自动保存与草稿机制

系统行为 · 更新于 2026-06-29

自动保存与草稿机制

编辑器自动保存

轻笺的笔记编辑器采用异步自动保存机制,确保编辑内容不丢失。

保存触发条件

  • 内容变更后自动保存:编辑器内容变化后,前端通过 saveData 事件通知父组件,父组件调用后端 API 异步写入数据库
  • 保存频率:编辑暂停后约 3 秒内触发保存,连续输入时不会频繁请求
  • 页面关闭前保存:切换页面或关闭标签页前,会触发最后一次保存请求
  • 手动保存:支持 Ctrl+S(Cmd+S)快捷键强制保存

保存流程

编辑器内容变化 → 防抖等待(约3秒) → POST /note/updateNote → 数据库写入 → 状态栏显示"已保存"

保存状态指示

编辑器顶部状态栏实时显示保存状态:

  • 未编辑:无指示
  • 保存中…:正在写入云端
  • 已保存:写入成功
  • 保存失败:网络异常时提示,内容保留在编辑器中不丢失

草稿保护机制

本地草稿保留

当网络请求失败或保存异常时:

  • 编辑器的内容不会因为保存失败而丢失
  • 编辑器保持在可编辑状态,用户可以继续编辑
  • 网络恢复后自动重试保存

模式切换备份

笔记在 HTML 和 Markdown 模式之间切换时:

  • 切换前自动备份当前内容到 switchBackup 状态
  • 切换后有撤回按钮可还原到切换前的内容和模式
  • 撤回同样需要确认,防止误操作

注意事项

  • 自动保存是异步的,极短时间内关闭页面可能导致最后一次修改未保存
  • 重要内容建议手动 Ctrl+S 确认保存后再离开
  • 网络不稳定时保存可能延迟,但内容不会丢失
  • 自动保存不生成版本历史,每次保存覆盖上一次内容

← 返回帮助中心