feat: 引入调试助手，优化日志输出

- 在 `AudioManager`、`LoadManager`、`GameScene`、`MainMenuScene` 和 `PreloadScene` 中，替换原有的 `console.log` 调用为 `DebugHelper.debugLog` 方法，增强日志的可读性和可维护性。
- 新增 `DebugHelper` 类，提供统一的调试日志输出功能，仅在调试模式下显示，支持分类和附加数据的记录。
- 通过改进日志记录方式，提升了代码的整洁性和调试效率。

Author: Carton

src/game/managers/AudioManager.ts

@@ -1,6 +1,7 @@
 import Phaser from 'phaser'
 import { on } from '@/game/managers/EventBus'
 import { LoadManager } from '@/game/managers/LoadManager'
+import { DebugHelper } from '@/utils/debugHelper'
 
 type SoundCache = Record<string, Phaser.Sound.BaseSound>
 
@@ -131,17 +132,17 @@ export class AudioManager {
     }
 
     this.requestedBgmKey = key
-    console.log(`🎵 场景声明要播放BGM: ${key}`)
+    DebugHelper.debugLog('BGM', `场景声明要播放BGM: ${key}`)
 
     if (!this._bgmEnabled) {
-      console.log('🔇 BGM已关闭')
+      DebugHelper.debugLog('BGM', 'BGM已关闭')
       this.clearRequestedBgmKey()
       return
     }
 
     // 检查是否已加载，使用LoadManager的加载状态
     if (LoadManager.isAudioLoaded(key)) {
-      console.log(`✅ BGM已预加载，立即播放: ${key}`)
+      DebugHelper.debugLog('BGM', `BGM已预加载，立即播放: ${key}`)
       this.tryStartBgm(key)
       this.clearRequestedBgmKey()
       return
@@ -152,7 +153,7 @@ export class AudioManager {
       try {
         const existingSound = this.scene.sound.get(key)
         if (existingSound) {
-          console.log(`✅ BGM已在场景中，立即播放: ${key}`)
+          DebugHelper.debugLog('BGM', `BGM已在场景中，立即播放: ${key}`)
           this.tryStartBgm(key)
           this.clearRequestedBgmKey()
           return
@@ -163,7 +164,7 @@ export class AudioManager {
     }
 
     // 如果未加载，等待LoadManager的audio:loaded事件触发播放
-    console.log(`⏳ BGM尚未加载，等待加载完成: ${key}`)
+    DebugHelper.debugLog('BGM', `BGM尚未加载，等待加载完成: ${key}`)
   }
 
   static playSfx(key: string, config: Phaser.Types.Sound.SoundConfig = { volume: 0.6 }) {

src/game/managers/LoadManager.ts

@@ -2,6 +2,7 @@ import Phaser from 'phaser'
 import { AssetConfig, AUDIO_LOADING_CONFIG } from '@/game/config/assetConfig'
 import { emit } from '@/game/managers/EventBus'
 import { AudioManager } from '@/game/managers/AudioManager'
+import { DebugHelper } from '@/utils/debugHelper'
 
 export class LoadManager {
   private static scene: Phaser.Scene | null = null
@@ -47,20 +48,20 @@ export class LoadManager {
 
         // 如果所有图片都加载完成
         if (loadedCount >= totalAssets) {
-          console.log('✅ 核心图片资源加载完成')
+          DebugHelper.debugLog('Load', '核心图片资源加载完成')
           resolve()
         }
       })
 
       // 监听所有文件加载完成
       this.scene!.load.on('complete', () => {
-        console.log('✅ 核心图片资源加载完成')
+        DebugHelper.debugLog('Load', '核心图片资源加载完成')
         resolve()
       })
 
       // 监听加载错误
       this.scene!.load.on('loaderror', (file: any) => {
-        console.error(`❌ 加载失败: ${file.key}`)
+        DebugHelper.debugLog('Load', `加载失败: ${file.key}`, { file })
         reject(new Error(`Failed to load: ${file.key}`))
       })
 
@@ -132,11 +133,11 @@ export class LoadManager {
       tempLoader.once('complete', () => {
         clearTimeout(timeoutId)
         this.loadedAssets.add(key)
-        console.log(`✅ 音频加载完成: ${key}`)
+        DebugHelper.debugLog('Audio', `音频加载完成: ${key}`)
 
         // 检查AudioManager是否有期望播放这个BGM
         if (AudioManager.getRequestedBgmKey() === key) {
-          console.log(`🎵 自动播放请求的BGM: ${key}`)
+          DebugHelper.debugLog('BGM', `自动播放请求的BGM: ${key}`)
           AudioManager.tryStartBgm(key)
           AudioManager.clearRequestedBgmKey() // 清除期望
         }
@@ -217,9 +218,9 @@ export class LoadManager {
     // 在主菜单BGM加载完成后，开始加载游戏BGM
     try {
       // 直接加载游戏BGM，不重新加载主菜单BGM
-      console.log('🎵 开始预加载游戏BGM...')
+      DebugHelper.debugLog('BGM', '开始预加载游戏BGM...')
       await this.loadAudioAsync(bgmKeys, AUDIO_LOADING_CONFIG.bgmTimeout)
-      console.log('✅ 游戏BGM预加载完成')
+      DebugHelper.debugLog('BGM', '游戏BGM预加载完成')
     } catch (error) {
       console.warn('⚠️ 游戏BGM预加载失败，将在游戏场景中重试:', error)
     }

src/game/scenes/GameScene.ts

@@ -86,7 +86,7 @@ export default class GameScene extends Phaser.Scene {
     }
 
     // 请求播放游戏界面背景音乐
-    console.log('🎵 游戏场景请求播放BGM: bgm_game')
+    DebugHelper.debugLog('BGM', '游戏场景请求播放BGM: bgm_game')
     AudioManager.requestBgm('bgm_game')
 
     this.nextQuestion()

src/game/scenes/MainMenuScene.ts

@@ -7,6 +7,7 @@ import { Strings } from '@/game/managers/Strings'
 import type { LanguageCode } from '@/game/managers/Strings'
 import { createTextButton } from '@/game/utils/uiFactory'
 import { on, off } from '@/game/managers/EventBus'
+import { DebugHelper } from '@/utils/debugHelper'
 
 export default class MainMenuScene extends Phaser.Scene {
   private bgmStatusText?: Phaser.GameObjects.Text
@@ -31,7 +32,7 @@ export default class MainMenuScene extends Phaser.Scene {
     LoadManager.init(this)
 
     // 声明主菜单要播放的BGM
-    console.log('🎵 主菜单声明要播放BGM: bgm_main')
+    DebugHelper.debugLog('BGM', '主菜单声明要播放BGM: bgm_main')
     AudioManager.requestBgm('bgm_main')
 
     // 开始预加载所有BGM（如果还没有开始）
@@ -318,7 +319,7 @@ export default class MainMenuScene extends Phaser.Scene {
    * 开始预加载所有BGM（主菜单BGM + 游戏BGM）
    */
   private async startAllBGMPreload() {
-    console.log('🎵 开始预加载所有BGM...')
+    DebugHelper.debugLog('BGM', '开始预加载所有BGM...')
 
     try {
       // 并行预加载主菜单BGM和游戏BGM
@@ -328,7 +329,7 @@ export default class MainMenuScene extends Phaser.Scene {
       ]
 
       await Promise.allSettled(promises)
-      console.log('✅ 所有BGM预加载完成')
+      DebugHelper.debugLog('BGM', '所有BGM预加载完成')
     } catch (error) {
       console.warn('⚠️ BGM预加载过程中出现错误:', error)
     }
@@ -340,11 +341,11 @@ export default class MainMenuScene extends Phaser.Scene {
   private checkAndInitializeBGMStatus(width: number, height: number) {
     // 检查主菜单BGM是否已经加载完成
     if (LoadManager.isAudioLoaded('bgm_main')) {
-      console.log('✅ 主菜单BGM已加载，隐藏状态指示器')
+      DebugHelper.debugLog('BGM', '主菜单BGM已加载，隐藏状态指示器')
       // BGM已加载完成，不需要显示状态指示器
       // 可以选择隐藏或者显示"已就绪"状态后淡出
     } else {
-      console.log('⏳ 主菜单BGM尚未加载，显示状态指示器')
+      DebugHelper.debugLog('BGM', '主菜单BGM尚未加载，显示状态指示器')
       // BGM还未加载完成，显示状态指示器
       this.createBGMStatusIndicator(width, height)
       this.updateBGMStatus('loading')
@@ -393,7 +394,7 @@ export default class MainMenuScene extends Phaser.Scene {
   private updateBGMStatus(status: 'loading' | 'ready' | 'failed') {
     try {
       if (!this.bgmStatusText || !this.bgmLoadingIndicator) {
-        console.log('BGM状态指示器未初始化，跳过状态更新')
+        DebugHelper.debugLog('BGM', 'BGM状态指示器未初始化，跳过状态更新')
         return
       }
 
@@ -419,7 +420,7 @@ export default class MainMenuScene extends Phaser.Scene {
       const text = Strings.t(textKey)
       this.bgmStatusText.setText(text)
       this.bgmStatusText.setColor(color)
-      console.log(`BGM状态更新: ${text}`)
+      DebugHelper.debugLog('BGM', `BGM状态更新: ${text}`)
 
       // 加载完成或失败后3秒隐藏指示器
       if (status === 'ready' || status === 'failed') {
@@ -448,6 +449,6 @@ export default class MainMenuScene extends Phaser.Scene {
   shutdown() {
     // 重置BGM加载标志，允许重新进入时重新加载
     this.bgmLoadStarted = false
-    console.log('MainMenuScene shutdown - BGM加载状态已重置')
+    DebugHelper.debugLog('BGM', 'MainMenuScene shutdown - BGM加载状态已重置')
   }
 }

src/game/scenes/PreloadScene.ts

@@ -5,14 +5,15 @@ import { ToolManager } from '@/game/managers/ToolManager'
 import { AudioManager } from '@/game/managers/AudioManager'
 import { LoadManager } from '@/game/managers/LoadManager'
 import { on } from '@/game/managers/EventBus'
+import { DebugHelper } from '@/utils/debugHelper'
 
 export default class PreloadScene extends Phaser.Scene {
   constructor() {
     super('PreloadScene')
   }
 
   preload() {
-    console.log('🚀 开始加载核心资源...')
+    DebugHelper.debugLog('Load', '开始加载核心资源...')
 
     // 加载配置文件
     this.load.json('difficulty', 'game/config/digit-difficulty.json')
@@ -41,16 +42,16 @@ export default class PreloadScene extends Phaser.Scene {
 
     // 设置加载事件监听器
     this.load.on('complete', () => {
-      console.log('✅ 核心图片和音效资源加载完成')
+      DebugHelper.debugLog('Load', '核心图片和音效资源加载完成')
     })
 
     this.load.on('loaderror', (file: any) => {
-      console.error(`❌ 核心资源加载失败: ${file.key}`)
+      DebugHelper.debugLog('Load', `核心资源加载失败: ${file.key}`, { file })
     })
   }
 
   create() {
-    console.log('🎮 初始化游戏系统...')
+    DebugHelper.debugLog('System', '初始化游戏系统...')
 
     const diff = this.cache.json.get('difficulty')
 
@@ -94,7 +95,7 @@ export default class PreloadScene extends Phaser.Scene {
     // 移除 ui:choice 事件的音效，因为答题音效已经由 ui:feedback 处理
     on('tool:use', () => AudioManager.playSfx('sfx_click'))
 
-    console.log('✅ 游戏系统初始化完成，进入主菜单')
+    DebugHelper.debugLog('System', '游戏系统初始化完成，进入主菜单')
     this.scene.start('MainMenuScene')
   }
 }

src/utils/debugHelper.ts

@@ -2,6 +2,27 @@
 import { SaveManager } from '@/game/managers/SaveManager'
 
 export class DebugHelper {
+  /**
+   * 调试日志输出 - 只在debug模式下显示
+   * @param category 日志分类（如 'BGM', 'Audio', 'Load' 等）
+   * @param message 日志消息
+   * @param data 可选的额外数据
+   */
+  public static debugLog(category: string, message: string, data?: any): void {
+    if (!this.isDebugMode()) {
+      return
+    }
+
+    const timestamp = new Date().toLocaleTimeString()
+    const prefix = `[${timestamp}] [${category}]`
+
+    if (data !== undefined) {
+      console.log(`${prefix} ${message}`, data)
+    } else {
+      console.log(`${prefix} ${message}`)
+    }
+  }
+
   /**
    * 检查是否为调试模式
    * 统一的调试模式判断逻辑，避免重复实现