fix： 修复一系列 bug

assets/scripts/utils/WxSDK.ts

@@ -398,15 +398,82 @@ export class WxSDK {
 
         try {
             const options = wxApi.getLaunchOptionsSync();
-            if (options?.query?.shareCode) {
-                console.log('[WxSDK] 检测到分享码:', options.query.shareCode);
-                return options.query.shareCode;
+            const code = WxSDK.extractShareCodeFromQuery(options?.query);
+            if (code) {
+                console.log('[WxSDK] 检测到分享码:', code);
+                return code;
             }
         } catch (err) {
             console.warn('[WxSDK] 获取启动参数失败:', err);
         }
         return null;
     }
+
+    /**
+     * 从查询对象（来自 launch options 或 onShow 回调）中提取 shareCode
+     */
+    static extractShareCodeFromQuery(query: Record<string, any> | null | undefined): string | null {
+        const code = query?.shareCode;
+        return typeof code === 'string' && code.length > 0 ? code : null;
+    }
+
+    // ==================== 前后台生命周期 ====================
+
+    /**
+     * 监听小游戏切到前台事件。
+     * 同一个回调可重复注册多次：内部用 wx.onShow，请确保业务层做幂等处理或在卸载时调用 offAppShow。
+     * @param callback 切前台时触发，包含本次显示对应的 query / scene 等参数
+     */
+    static onAppShow(callback: (res: { query?: Record<string, any>; scene?: number; path?: string } | undefined) => void): void {
+        const wxApi = WxSDK.getWx();
+        if (!wxApi) return;
+
+        if (typeof wxApi.onShow !== 'function') {
+            console.warn('[WxSDK] 当前微信版本不支持 onShow');
+            return;
+        }
+
+        wxApi.onShow(callback);
+    }
+
+    /**
+     * 取消监听小游戏切到前台事件
+     */
+    static offAppShow(callback: (res: any) => void): void {
+        const wxApi = WxSDK.getWx();
+        if (!wxApi) return;
+
+        if (typeof wxApi.offShow === 'function') {
+            wxApi.offShow(callback);
+        }
+    }
+
+    /**
+     * 监听小游戏切到后台事件
+     */
+    static onAppHide(callback: () => void): void {
+        const wxApi = WxSDK.getWx();
+        if (!wxApi) return;
+
+        if (typeof wxApi.onHide !== 'function') {
+            console.warn('[WxSDK] 当前微信版本不支持 onHide');
+            return;
+        }
+
+        wxApi.onHide(callback);
+    }
+
+    /**
+     * 取消监听小游戏切到后台事件
+     */
+    static offAppHide(callback: () => void): void {
+        const wxApi = WxSDK.getWx();
+        if (!wxApi) return;
+
+        if (typeof wxApi.offHide === 'function') {
+            wxApi.offHide(callback);
+        }
+    }
 }
 
 // ==================== 隐私授权相关 ====================