图层锁定同步需服务端统一裁定并广播状态:验证权限、检查冲突、更新内存快照;WebSocket仅可靠广播语义化消息;前端校验本地映射并响应快照兜底。

实现网页版协同设计工具的图层锁定同步,核心是让所有协作者看到一致的图层可编辑状态:谁锁了哪一层,其他人立刻无法编辑,且本地操作不绕过服务端校验。WebSocket 不负责“执行锁定”,而是精准、可靠地广播锁定意图与结果。
图层锁定必须由服务端统一裁定
前端点击“锁定图层”只是发起请求,不能直接修改本地图层状态并假定同步成功。服务端需做三件事:
- 验证操作权限:当前用户是否有权锁定该图层(例如是否为所有者或具备编辑权限)
- 检查冲突:该图层是否已被他人锁定;若已锁,拒绝本次请求并返回错误码
- 更新内存快照:维护一个 Map<layerId, lockedBy: userId>,仅在此处记录权威状态
用语义化消息广播锁定变更
服务端确认锁定生效后,向本项目/画布下所有在线协作者(含操作者自己)广播结构化消息,而非简单发“locked:true”:
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 消息示例:{"type":"layer_lock","layerId":"l_003","lockedBy":"u_789","timestamp":1746720620112}
- 前端收到后,只更新对应图层的 UI 状态(如灰掉图层缩略图、禁用编辑控件),不重新加载整张画布
- 若收到 {"type":"layer_unlock","layerId":"l_003"},则恢复可编辑态,并清除本地缓存的锁定标识
本地操作前必须校验服务端状态
用户尝试编辑某图层时,前端不能仅看本地 UI 是否“解锁”,而应结合实时状态快照:
立即学习“前端免费学习笔记(深入)”;
- 维护一个轻量级本地映射:Map<layerId, {lockedBy: string | null, ts: number}>
- 每次鼠标悬停或聚焦图层时,检查该 layerId 是否在映射中且 lockedBy 非空;若是,阻止编辑并提示“已被 u_789 锁定”
- 该映射由 WebSocket 消息自动更新,不依赖定时轮询
处理断线重连与状态兜底
用户网络短暂中断后重连,不能丢失锁定状态。服务端应在握手完成时主动推送当前全量锁定快照:
- 重连后发送:{"type":"layer_lock_snapshot","data":[{"layerId":"l_003","lockedBy":"u_789"},{"layerId":"l_005","lockedBy":"u_211"}]}
- 前端用此快照覆盖本地映射,再比对差异触发 UI 更新(避免闪烁)
- 服务端不保存历史,只维护“此刻谁锁了什么”,降低复杂度与延迟


















