多设备草稿同步需以用户ID为纽带、服务端为权威中心,前端用IndexedDB+网络状态感知+增量同步实现;localStorage无法跨设备,须避免依赖navigator.onLine和unload事件。

多设备登录时同步草稿箱数据,核心不是靠 HTML 或 localStorage 自动“跨设备”同步,而是以用户身份为纽带、服务端为权威中心,前端配合 IndexedDB + 网络状态感知 + 增量同步策略来实现。浏览器本地存储(包括 localStorage、sessionStorage)天然隔离在设备和标签页层面,无法跨设备共享——这点必须先明确。
用用户 ID 统一草稿归属与服务端状态管理
所有草稿必须绑定唯一用户标识(如 userId 或 auth token 解析出的 sub),而非设备或会话 ID:
- 每次新建/修改草稿,前端生成本地唯一 ID(crypto.randomUUID()),但立即关联用户 ID 并尝试写入服务端草稿接口(如
POST /api/drafts) - 服务端返回带 serverVersion 和 updatedAt 的完整草稿记录,前端存入 IndexedDB 时同时保存该版本号和时间戳
- 草稿列表页加载时,优先拉取服务端最新草稿(
GET /api/drafts?since=lastSyncTime),再合并本地 pending 修改
离线编辑与多设备冲突处理的关键逻辑
用户在设备 A 离线写草稿、设备 B 在线修改同一篇,恢复网络后不能简单覆盖——需靠版本控制和操作语义化解冲突:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- IndexedDB 中每条草稿记录包含:id(服务端下发)、content(富文本或 delta)、localVersion(客户端递增序号)、serverVersion(上次成功同步值)、status: 'pending' | 'synced' | 'conflicted'
- 同步时,向服务端提交草稿时带上
if-match: serverVersion;若服务端返回412 Precondition Failed,说明已被其他设备更新,此时触发合并流程 - 轻量内容(如纯文本)可采用“最后写入 wins”+ 时间戳回滚;复杂结构(如带格式、图片、光标位置)建议服务端支持 OT 或返回 diff,前端用 CRDT 库(如 Yjs)做本地合并
跨设备实时感知与 UI 同步提示
用户在设备 B 删除或发布某草稿,设备 A 应及时更新 UI,但不依赖轮询:
- 使用 WebSocket 或 Web Push:服务端在草稿状态变更(create/update/delete)时,向该用户所有在线连接推送事件(如
{ type: 'draft-updated', id: 'xxx', action: 'deleted' }) - 设备 A 收到后,从 IndexedDB 中查找对应草稿,标记为
synced: false,并触发一次局部刷新(如移除 DOM 节点或置灰显示) - 若设备 A 当前离线,则下次联网时通过增量拉取(
GET /api/drafts?updatedAfter=lastKnownTime)补全状态,避免遗漏
避免常见陷阱的操作细节
很多方案看似可行,实则在多设备场景下失效:
- 不用 localStorage 存草稿正文:容量小(通常 5–10MB)、无索引、无事务,无法按用户+时间高效查询;仅适合存 UI 状态(如“最近打开草稿ID”)
- 不依赖 navigator.onLine 判断网络:它只反映系统级联网状态,Wi-Fi 连通但 DNS 失败或服务端宕机时仍返回 true;应结合 fetch 超时或心跳请求判断真实可用性
- 不把草稿同步绑在页面 unload 事件里:该事件不可靠,尤其移动端切后台或系统回收进程时极易丢失;改用 Service Worker 的 background sync + indexedDB 持久队列
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










