@lzpenguin/server 1.0.3 → 1.0.4

package/index.js

@@ -178,14 +178,16 @@ export class RiffleServer {
             }
             
             // 合并服务器数据与当前缓存，避免丢失乐观更新的数据
-            // 策略：服务器数据是权威数据，但需要智能合并以避免丢失本地更新
+            // 策略：对于 world 数据，优先保留乐观更新（当前缓存），然后合并服务器数据
+            // 这样可以确保刚画的笔画不会因为服务器推送旧数据而丢失
             if (this.currentData) {
-              // 对于 self 数据：优先使用服务器数据（因为服务器会合并所有更新）
-              // 但对于 world 数据：需要合并，因为可能有其他玩家的更新
               const mergedData = {
-                // world 数据：合并服务器数据和本地缓存，确保不丢失任何更新
-                world: this._deepMerge(this.currentData.world || {}, message.world),
-                // self 数据：服务器数据是权威的（已包含所有更新），但合并确保不丢失字段
+                // world 数据：先使用当前缓存（包含乐观更新），再合并服务器数据
+                // _deepMerge 会先保留 target（当前缓存）的所有数据，然后添加 source（服务器数据）中不存在的项
+                // 对于数组（如 strokes），会合并去重，确保不会丢失任何笔画
+                world: this._deepMerge(this.currentData.world || {}, message.world || {}),
+                // self 数据：服务器数据优先（因为服务器会合并所有玩家的更新）
+                // 但也要合并当前缓存，确保不丢失字段
                 self: {
                   public: this._deepMerge(
                     message.self?.public || {},
@@ -271,7 +273,7 @@ export class RiffleServer {
   /**
    * 深度合并对象
    * @private
-   * @param {Object} target - 目标对象（保留原有数据）
+   * @param {Object} target - 目标对象（基础数据）
    * @param {Object} source - 源对象（新数据，优先使用）
    * @returns {Object} 合并后的对象
    */
@@ -280,6 +282,8 @@ export class RiffleServer {
     if (!source) return target;
     
     // 处理数组：如果都是数组，合并去重（基于 JSON 字符串比较）
+    // 先保留 target 的所有项，然后添加 source 中不存在的项
+    // 这样可以确保不会丢失任何数据
     if (Array.isArray(target) && Array.isArray(source)) {
       const merged = [...target];
       const targetStrings = new Set(target.map(item => JSON.stringify(item)));
@@ -299,6 +303,7 @@ export class RiffleServer {
     }
     
     // 处理对象：递归合并
+    // 先复制 target，然后用 source 的值覆盖（但递归合并子对象）
     const result = { ...target };
     for (const key in source) {
       if (source.hasOwnProperty(key)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lzpenguin/server",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Riffle 游戏服务器 WebSocket 客户端 SDK",
   "license": "ISC",
   "author": "lzpenguin",