chore: 添加游戏数据同步脚本和配置的元数据文件

- 新增 GameDataSync.ts 的元数据文件，用于 TypeScript 脚本导入管理
- 新增 hearthstone-battlegrounds.md 的元数据文件，用于文本配置文件导入管理

assets/script/game/common/GameDataSync.ts

@@ -0,0 +1,143 @@
+import { sys } from "cc";
+import { WxCloudApi } from "../wx_clound_client_api/WxCloudApi";
+import { mLogger } from "./Logger";
+import { smc, GameDate, CloudData } from "./SingletonModuleComp";
+
+export class GameDataSync {
+    private debugMode: boolean = false;
+    private _localDataDirty: boolean = false;
+    private _lastSyncTime: number = 0;
+    private _syncTimerId: any = null;
+    private readonly LOCAL_STORAGE_KEY = "Heros_GameData_Local";
+
+    /** 标记数据为脏，并更新时间戳，然后保存到本地 */
+    public markDataDirty() {
+        this._localDataDirty = true;
+        this.saveToLocal();
+        // 尝试触发异步同步
+        this.tryAsyncCloudSync();
+    }
+
+    /** 同步数据到本地 localStorage */
+    private saveToLocal() {
+        try {
+            const data = smc.getGameDate();
+            data.timestamp = Date.now(); // 更新时间戳
+            sys.localStorage.setItem(this.LOCAL_STORAGE_KEY, JSON.stringify(data));
+        } catch (error) {
+            mLogger.error(this.debugMode, 'GameDataSync', '保存本地数据失败:', error);
+        }
+    }
+
+    /** 从本地 localStorage 读取数据 */
+    private loadFromLocal(): GameDate | null {
+        try {
+            const str = sys.localStorage.getItem(this.LOCAL_STORAGE_KEY);
+            if (str) {
+                return JSON.parse(str) as GameDate;
+            }
+        } catch (error) {
+            mLogger.error(this.debugMode, 'GameDataSync', '读取本地数据失败:', error);
+        }
+        return null;
+    }
+
+    /**
+     * 判断是否为微信客户端
+     */
+    public isWxClient(): boolean {
+        return sys.platform === sys.Platform.WECHAT_GAME;
+    }
+
+    public updateCloudData() { 
+        this.markDataDirty();
+        return true;
+    }
+
+    /** 尝试异步同步云端数据，带有防抖（Debounce）保护 */
+    private tryAsyncCloudSync() {
+        if (!this.isWxClient()) return;
+        
+        // 如果当前有同步在等待，清除之前的定时器
+        if (this._syncTimerId !== null) {
+            clearTimeout(this._syncTimerId);
+        }
+
+        // 防抖：延迟 3 秒同步，期间多次操作合并为一次同步请求
+        this._syncTimerId = setTimeout(() => {
+            this._syncTimerId = null;
+            this.executeCloudSync();
+        }, 3000);
+    }
+
+    /** 实际执行云端同步 */
+    private executeCloudSync() {
+        if (!this._localDataDirty) return;
+
+        let gameData = smc.getGameDate();
+        // 保证云端存一份时间戳，供下次登录对比
+        gameData.timestamp = Date.now(); 
+
+        WxCloudApi.save(gameData).then((result) => {
+            if (result.result.code === 200) {
+                mLogger.log(this.debugMode, 'GameDataSync', "静默云端保存成功", result.result);
+                // 同步成功，清除脏标记
+                this._localDataDirty = false;
+                this._lastSyncTime = Date.now();
+            } else {
+                mLogger.warn(this.debugMode, 'GameDataSync', `[GameDataSync]: 静默同步失败(等待下次重试): ${result.result.msg}`);
+                // 失败了不清除脏标记，下次有变化或定时器检查时会再次重试
+            }
+        }).catch((error) => {
+            mLogger.error(this.debugMode, 'GameDataSync', `[GameDataSync]: 静默同步异常(等待下次重试):`, error);
+        });
+    }
+
+    public getCloudData() {
+        const localData = this.loadFromLocal();
+        
+        // 未登录微信云端前，先用本地数据顶上（让玩家秒进游戏）
+        if (localData && !this.isWxClient()) {
+            smc.overrideLocalDataWithRemote({ data: localData });
+            return;
+        }
+
+        WxCloudApi.get().then(async (result) => { 
+            if(result.result.code === 200) {
+                let cloudData = result.result.data as CloudData;
+                mLogger.log(this.debugMode, 'GameDataSync', `[GameDataSync]: 获取游戏云端数据成功:`, cloudData);
+                
+                // 冲突解决：基于时间戳比较（云端时间戳 > 本地时间戳 则覆盖）
+                let cloudTs = cloudData?.data?.timestamp || 0;
+                let localTs = localData?.timestamp || 0;
+
+                if (!localData || cloudTs > localTs) {
+                    mLogger.log(this.debugMode, 'GameDataSync', `[GameDataSync]: 云端数据更新 (Cloud: ${cloudTs} > Local: ${localTs}), 执行覆盖。`);
+                    smc.overrideLocalDataWithRemote(cloudData);
+                    this.saveToLocal(); // 同步到本地
+                } else {
+                    mLogger.log(this.debugMode, 'GameDataSync', `[GameDataSync]: 本地数据更新 (Local: ${localTs} >= Cloud: ${cloudTs}), 使用本地数据，触发强制云同步。`);
+                    smc.overrideLocalDataWithRemote({ data: localData });
+                    // 本地数据较新，需要强制推送到云端以保证多端一致
+                    this._localDataDirty = true;
+                    this.executeCloudSync();
+                }
+
+                return true
+            } else {
+                mLogger.warn(this.debugMode, 'GameDataSync', `[GameDataSync]: 获取游戏云端数据失败，使用本地缓存兜底。`);
+                if (localData) {
+                    smc.overrideLocalDataWithRemote({ data: localData });
+                }
+                return false
+            }
+        }).catch((error) => {
+            mLogger.error(this.debugMode, 'GameDataSync', `[GameDataSync]: 获取游戏云端数据异常:`, error);
+            if (localData) {
+                smc.overrideLocalDataWithRemote({ data: localData });
+            }
+        });
+    }
+}
+
+export const gameDataSync = new GameDataSync();

assets/script/game/common/GameDataSync.ts.meta

@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "03eb3891-3801-415d-a889-e05a1f304e5a",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}

assets/script/game/common/SingletonModuleComp.ts

@@ -1,3 +1,4 @@
+import { sys } from "cc";
 import { VM } from "../../../../extensions/oops-plugin-framework/assets/libs/model-view/ViewModel";
 import { ecs } from "../../../../extensions/oops-plugin-framework/assets/libs/ecs/ECS";
 import { Initialize } from "../initialize/Initialize";
@@ -8,15 +9,17 @@ import { GameEvent } from "./config/GameEvent";
 import { GameScoreStats } from "./config/HeroAttrs";
 import { mLogger } from "./Logger";
 import { TalentType } from "./config/TalentSet";
+import { gameDataSync } from "./GameDataSync";
 
 /**
  * 用远程数据覆盖本地数据（统一方法）
  * @param remoteData 远程数据（云端或本地调试）
  */
-interface GameDate{
+export interface GameDate{
     gold:number,
     heros:any,
     fight_hero:number,
+    timestamp?: number, // 用于比对本地与云端数据的最新状态
     collection?: {
         talents: Partial<Record<TalentType, number>>,
         player_level: number,
@@ -26,7 +29,7 @@ interface GameDate{
         friend?: {uuid:0,count:0},
     }
 }
-interface  CloudData {
+export interface CloudData {
     openid: string;
     data: GameDate;
 }
@@ -212,117 +215,74 @@ export class SingletonModuleComp extends ecs.Comp {
     /**
      * 判断是否为微信客户端
      */
-    private isWxClient(): boolean {
-        // 检查是否存在微信API
-        return typeof wx !== 'undefined' && typeof (wx as any).getSystemInfoSync === 'function';
-    }
-
-    finishGuide(index:number){   
-        smc.guides[index]=1
-        //存储到远程服务器 后续再添加
+    isWxClient(): boolean {
+        return gameDataSync.isWxClient();
     }
     
     updateCloudData(){ 
+        return gameDataSync.updateCloudData();
+    }
 
-        let gemeDate=this.getGameDate()
-        WxCloudApi.save(gemeDate).then((result) => {
-            mLogger.log(this.debugMode, 'SMC', '云端保存')
-            if(result.result.code === 200) {
-                mLogger.log(this.debugMode, 'SMC', "保存成功",result.result)
-                return true
-            } else {
-                mLogger.warn(this.debugMode, 'SMC', `[SMC]: 游戏数据增加失败: ${result.result.msg}`);
-                return false
-            }
-        }).catch((error) => {
-            mLogger.error(this.debugMode, 'SMC', `[SMC]: 增加游戏数据异常:`, error);
-            return false
-        });
-        return true
-    }
     getCloudData(){
-        WxCloudApi.get().then(async (result) => { 
-            if(result.result.code === 200) {
-                let data=result.result.data
-                mLogger.log(this.debugMode, 'SMC', `[SMC]: 获取游戏数据成功:`, result.result);
-                this.overrideLocalDataWithRemote(data)
-                return true
-            } else {
-                mLogger.warn(this.debugMode, 'SMC', `[SMC]: 游戏数据增加失败`);
-                return false
+        gameDataSync.getCloudData();
     }
-        }).catch((error) => {
-            mLogger.error(this.debugMode, 'SMC', `[SMC]: 获取游戏数据异常:`, error);
-        });
-    }
-    public async overrideLocalDataWithRemote(CloudData) {
+    public async overrideLocalDataWithRemote(cloudData: any) {
         try {
             // 直接覆盖基础游戏数据
-            if (CloudData.openid) {
-                this.openid=CloudData.openid
+            if (cloudData.openid) {
+                this.openid = cloudData.openid;
             }
             // 直接覆盖出战英雄配置
-            if (CloudData.data) {
-                if(CloudData.data.gold) this.vmdata.gold=CloudData.data.gold
-                if(CloudData.data.heros) this.heros=CloudData.data.heros
-                if(CloudData.data.fight_hero) this.fight_hero=CloudData.data.fight_hero
+            if (cloudData.data) {
+                const data = cloudData.data;
+                // 同步金币
+                if (data.gold !== undefined) {
+                    this.vmdata.gold = data.gold;
+                }
+                // 同步英雄
+                if (data.heros && Array.isArray(data.heros)) {
+                    this.heros = data.heros;
+                }
+                // 同步出战英雄
+                if (data.fight_hero !== undefined) {
+                    this.fight_hero = data.fight_hero;
+                }
                 // 恢复收集记录
-                if(CloudData.data.collection) {
-                    this.collection = CloudData.data.collection;
+                if (data.collection) {
+                    const remoteCol = data.collection;
+                    if (remoteCol.talents) this.collection.talents = remoteCol.talents;
+                    if (typeof remoteCol.player_level === 'number') this.collection.player_level = remoteCol.player_level;
+                    if (typeof remoteCol.player_exp === 'number') this.collection.player_exp = remoteCol.player_exp;
+                    if (typeof remoteCol.talent_points === 'number') this.collection.talent_points = remoteCol.talent_points;
                 }
             }
             
+            // 触发UI更新
+            oops.message.dispatchEvent(GameEvent.GOLD_UPDATE);
+            
         } catch (error) {
             mLogger.error(this.debugMode, 'SMC', `[SMC]: 数据覆盖失败:`, error);
         }
     }
     getGameDate(){
-        return {
+        let data: GameDate = {
             gold: this.vmdata.gold,
             heros: this.heros,
             fight_hero: this.fight_hero,
-            collection: this.collection
-        }
-    }
-    addHero(hero_uuid:number){
-        if(this.heros.indexOf(hero_uuid)==-1){
-            this.heros.push(hero_uuid)
-        }
-        if(this.isWxClient()){
-            let res = this.updateCloudData()
-            if (res){
-                return true
-            }else{
-                // 同步不成功，删除uuid
-                this.heros.splice(this.heros.indexOf(hero_uuid), 1);
-                oops.gui.toast("数据同步失败，已回滚操作");
-                return false
-            }
-        }
-
-        return true
+            collection: this.collection,
+            timestamp: Date.now() // 每次获取当前数据结构时都附带最新的时间戳
+        };
+        return data;
     }
 
     updateGold(gold:number, is_sync: boolean = true){
         this.vmdata.gold += gold;
-        if(this.isWxClient() && is_sync){
-            let res = this.updateCloudData()
-            if (res){
-                oops.message.dispatchEvent(GameEvent.GOLD_UPDATE)
-                return true
-            }else{
-                this.vmdata.gold -= gold
-                return false
-            }
+        if (is_sync) {
+            gameDataSync.markDataDirty();
         }
         oops.message.dispatchEvent(GameEvent.GOLD_UPDATE)
         return true
     }
-
-    error(){
-        oops.gui.toast("数据处理异常,请重试或重新登录")
-    }
-
 }
 
 export var smc: SingletonModuleComp = ecs.getSingleton(SingletonModuleComp);

assets/script/game/common/config/hearthstone-battlegrounds.md.meta

@@ -2,7 +2,7 @@
   "ver": "1.0.1",
   "importer": "text",
   "imported": true,
-  "uuid": "fc76e3b0-5134-401a-b3ea-03251f9135ec",
+  "uuid": "83563f4f-dcd3-4a6f-a2d8-735a643f593e",
   "files": [
     ".json"
   ],

assets/script/game/map/TalentsComp.ts

@@ -202,15 +202,15 @@ export class TalentsComp extends CCComp {
         let points = collection.talent_points || 0;
 
         if (points >= cost && currentLevel < 5) {
-            // 扣除天赋点
+            // 1. 扣除消耗
             collection.talent_points -= cost;
-            // 增加天赋等级
+            // 2. 更新等级
             collection.talents[talentId] = currentLevel + 1;
 
-            // 同步到云端
+            // 3. 同步数据（通过 SingletonModuleComp 新增的机制，这里会触发标记脏数据并自动尝试云端同步）
             smc.updateCloudData();
 
-            // 刷新界面
+            // 4. 刷新 UI
             this.refreshUI();
             
             oops.gui.toast("天赋升级成功");