refactor(world): blockData 权威统一与派生数据生命周期优化

src/core/Game.js

@@ -591,8 +591,11 @@ export class Game {
   }
 
   /**
-   * 收集当前游戏快照数据（从 worldStore 读取权威数据）
+   * 收集当前游戏快照数据
    * @returns {Promise<object>} 游戏快照对象
+   * @deferred 手动存档链路延后恢复。当前仍从 worldStore 读取，
+   *   后续应迁移到从 WorldBlockDataStore 统一导出。
+   *   本方法不是当前 runtime correctness 的组成部分。
    */
   async collectSnapshot() {
     const playerSnapshot = {
@@ -785,6 +788,9 @@ export class Game {
 
   /**
    * 将保存的快照数据应用到当前游戏实例
+   * @deferred 手动读档链路延后恢复。当前从 worldStore/IndexedDB 读取，
+   *   后续应迁移到基于 WorldBlockDataStore authority 的重新注入。
+   *   本方法不是当前 runtime correctness 的组成部分。
    */
   async applySaveData(saveData) {
     if (!saveData) return;

src/core/MaterialManager.js

@@ -472,13 +472,10 @@ export class MaterialManager {
   }
 
   /**
-   * 切换 AO 着色开关
+   * 同步 AO 开关到所有材质 shader
+   * @param {boolean} enabled - 是否启用 AO
    */
-  toggleAO() {
-    this.aoEnabled = !this.aoEnabled;
-    const enabled = this.aoEnabled;
-    console.log(`[MaterialManager] AO 着色已${enabled ? '开启' : '关闭'}`);
-
+  _syncAOShaderState(enabled) {
     // 更新合批材质（ShaderMaterial）
     for (const mat of this.batchedMaterials.values()) {
       if (mat && mat.uniforms && mat.uniforms.uAoEnabled) {
@@ -497,6 +494,28 @@ export class MaterialManager {
     }
   }
 
+  /**
+   * 通知世界系统：AO 开关已变化
+   * @param {boolean} enabled - 是否启用 AO
+   */
+  _notifyAOSettingChanged(enabled) {
+    const world = globalThis.game?.world;
+    if (world && typeof world.onAOSettingChanged === 'function') {
+      world.onAOSettingChanged(enabled);
+    }
+  }
+
+  /**
+   * 切换 AO 着色开关
+   */
+  toggleAO() {
+    this.aoEnabled = !this.aoEnabled;
+    const enabled = this.aoEnabled;
+    console.log(`[MaterialManager] AO 着色已${enabled ? '开启' : '关闭'}`);
+    this._syncAOShaderState(enabled);
+    this._notifyAOSettingChanged(enabled);
+  }
+
   /**
    * 设置 AO 着色状态
    * @param {boolean} enabled - 是否启用 AO
@@ -505,23 +524,8 @@ export class MaterialManager {
     if (this.aoEnabled === enabled) return;
     this.aoEnabled = enabled;
     console.log(`[MaterialManager] AO 着色已${enabled ? '开启' : '关闭'}`);
-
-    // 更新合批材质（ShaderMaterial）
-    for (const mat of this.batchedMaterials.values()) {
-      if (mat && mat.uniforms && mat.uniforms.uAoEnabled) {
-        mat.uniforms.uAoEnabled.value = enabled ? 1.0 : 0.0;
-      }
-    }
-
-    // 更新普通材质（MeshStandardMaterial）- 通过存储的 shader 引用
-    for (const matOrMats of this.materials.values()) {
-      const mats = Array.isArray(matOrMats) ? matOrMats : [matOrMats];
-      for (const mat of mats) {
-        if (mat && mat._aoShader && mat._aoShader.uniforms) {
-          mat._aoShader.uniforms.uAoEnabled.value = enabled ? 1.0 : 0.0;
-        }
-      }
-    }
+    this._syncAOShaderState(enabled);
+    this._notifyAOSettingChanged(enabled);
   }
 
   /**

src/tests/index.html

@@ -399,7 +399,6 @@ <h1>MC Lite - 测试用例</h1>
     import './test-runtime-session-persistence.js';
     import './test-global-instanced-mesh-manager.js';
     import './test-hud.js';
-    import './test-memory-world-store.js';
     import './test-playground-service.js';
 
     // 等待所有脚本加载后再延时 1000ms 启用按钮