three-base 2.0.169 → 2.0.175

package/Ground1/Ground1.js

@@ -2,44 +2,39 @@
  * @Author: xiaosihan
  * @Date: 2022-09-20 23:06:00
  * @Last Modified by: xiaosihan
- * @Last Modified time: 2024-08-17 02:16:56
+ * @Last Modified time: 2026-10-12 00:00:00
  *
- * ⭐ 2026-09-20 皇上旨两改：
- *   ① 原「科技感装饰地板」（三张格子贴图 + 紫色扩散动画 `#8D108E` + 格子线 `#263C56`）
- *      → 深灰地板（每帧 3 次贴图采样、贴图平铺无各向异性 → 摩尔纹 + home 页卡顿元凶之一）。
- *   ② 皇上再旨「地板就是**随机渐变**的深灰色、**不透明**」：
- *      → 深灰区间内用 **value noise 做随机渐变**（无贴图、零采样，天然无摩尔纹）；
- *      → `transparent: false`、alpha 恒 1（不透明）。
+ * ⭐ 装饰地板 = 科技感格子贴图 + 紫色扩散动画（2026-10-12 皇上旨「整条退回旧科技感地板」+「装饰地板需要透明」）。
+ *   历史：2026-09-20 皇上曾两旨把它改成「随机渐变的深灰、不透明」，理由是每帧 3 次贴图采样 +
+ *   平铺无各向异性 → 摩尔纹，且是 home 页卡顿元凶之一。**当年那个摩尔纹根因现在已经在
+ *   `threeLoader.getTexture` 里根治了**（anisotropy=16 + generateMipmaps + LinearMipmapLinear），
+ *   所以贴图路线的重画成本比 09-20 那版低一档，本次按皇上旨意恢复旧外观。
  *
- *   ⚠️ 不透明带来的变化与对策：
- *   - 原靠「径向 alpha 淡出」柔化 500×500 地板的边界；不透明后改用**径向压暗**（乘 0.72~1.0）
- *     弱化硬边 —— 若哪天皇上要「边界完全消失」，只能改回 alpha 淡出（即恢复 transparent）。
- *   - 调试线（FPScontrol）两条口径分家（2026-09-25 皇上逐条定案）：**10 条射线辅助线开深度测试**，
- *     正是靠本地板「不透明 + depthWrite:true」才挡得住埋进地里的那半截线；**8/9 两条回弹向量线
- *     保持穿透显示**（关深度测试 + renderOrder:9999），照旧常显在最前。
- *     ⚠️ 若哪天把本地板改回 transparent + depthWrite:false，射线辅助线会重新穿地浮出来。
+ *   ⭐ 2026-10-12 皇上旨「装饰地板需要透明」⇒ 恢复旧版的**外观**口径（逐字照抄 09-20 之前的写法）：
+ *   - `transparent: true` + 径向 alpha 淡出 `mapColor.a = 1 - dist(center)*2`（中心实、外缘全透）。
+ *   - **但 `depthWrite: true` 保留**（旧版本来就是 transparent + depthWrite:true）：主渲染的深度缓冲
+ *     照写 ⇒ FPScontrol 那 10 条射线辅助线仍被地板挡住埋进地里的那半截（09-25 定案口径不受影响）。
  *
- *   ⚠️ 改动红线（这几条被别处依赖，**不许顺手改**）：
- *   - `userData.fpsCollision = true`：FPScontrol 把地板当碰撞体（见 FPScontrol.ts 地面处理段）。
- *   - `userData.aoFloor = true`：ssao_pass / debugExcludedShader 的「地板类半透明」特例按此标记走
- *     （默认不写进可见深度图；物体落在地板上仍有接触 AO）。
- *   - ShaderMaterial 必须含 logdepthbuf chunk；linear 输出必须 `#include <colorspace_fragment>`；
- *     否则末端 sRGB 编码会二次编码 → 发白。
+ *   ⭐ 2026-10-18 皇上旨「所有的对象都要进入到深度图里面了，不需要用参数过滤掉了」⇒ 当年为「可透视
+ *   地板」加的 `userData.aoFloor`（把地板从后处理的可见深度图里排除）连同 ssao_pass 里那整条过滤判据
+ *   一并删除。现在地板两张深度图都写 ⇒ 透过地板看到的实体，其描边/辉光/覆盖色/磨砂会被地板裁掉，
+ *   包括外缘 alpha≈0 那圈「看得见空、看不见地板」的区域。判据出处 three-base/pass/ssao_pass.ts 文件头，
+ *   护栏 test/depthDebug.test.js J 组。
  */
-import { Color, DoubleSide, Matrix4, Mesh, PlaneGeometry, ShaderChunk, ShaderMaterial } from "three";
+import { Clock, Color, DoubleSide, Matrix4, Mesh, PlaneGeometry, ShaderChunk, ShaderMaterial, Vector2 } from "three";
 import { MathUtils } from "three";
 const { degToRad } = MathUtils;
-/** 装饰地板（随机渐变的深灰、不透明） */
+import floorMap1PNG from "./floorMap1.png";
+import floorMap2PNG from "./floorMap2.png";
+import floorMap3PNG from "./floorMap3.png";
+import threeLoader from "../threeLoader";
+/** 装饰地板（科技感格子贴图 + 紫色扩散动画，半透明可透视外观） */
 export default class Ground1 extends Mesh {
     tempMatrix = new Matrix4();
     constructor() {
         super();
         // 标记为自己参与 FPS 碰撞检测
         this.userData.fpsCollision = true;
-        // 标记为"地板类半透明"：参与世界空间 AO（物体落在它上需要接触 AO），
-        // 但透过它看到的物体（如从下方透视）仍照常显示描边/辉光、且不被它的接触 AO 乘黑。
-        // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
-        this.userData.aoFloor = true;
     }
     renderOrder = -1;
     geometry = (() => {
@@ -51,14 +46,22 @@ export default class Ground1 extends Mesh {
     setSize(width, height) {
         this.scale.set(width, 1, height);
     }
+    clock = new Clock();
+    onBeforeRender = (renderer, scene, camera, geometry, material, group) => {
+        const elapsedTime = this.clock.getElapsedTime();
+        this.material.uniforms.speed.value = (elapsedTime * 0.1) % 0.6;
+        this.material.uniforms.speed2.value = ((elapsedTime * 0.1) % 0.6) - 0.1;
+    };
     material = new ShaderMaterial({
         uniforms: {
-            /** 随机渐变的**暗端**深灰（three 的 Color 存 linear，末端 colorspace_fragment 编码回 sRGB） */
-            colorDark: { value: new Color("#2A2E33") },
-            /** 随机渐变的**亮端**深灰 */
-            colorLight: { value: new Color("#3D434B") },
-            /** 低频噪声格数（越大斑块越碎；9 → 500×500 地板上每块约 55m 的大块渐变） */
-            noiseScale: { value: 9 },
+            size: { value: new Vector2(10, 10) }, // 格子平铺格数
+            speed: { value: 0 }, // 扩散值0-1
+            speed2: { value: 0 }, // 扩散值0-1
+            speedColor: { value: new Color("#8D108E") }, // 格子扩散颜色
+            lineColor: { value: new Color("#263C56") }, // 格子线的颜色
+            map1: { value: threeLoader.getTexture(floorMap1PNG) }, // 贴图纹理
+            map2: { value: threeLoader.getTexture(floorMap2PNG) }, // 贴图纹理
+            map3: { value: threeLoader.getTexture(floorMap3PNG) }, // 贴图纹理
         },
         vertexShader: `
             ${ShaderChunk.common}
@@ -72,42 +75,59 @@ export default class Ground1 extends Mesh {
         `,
         fragmentShader: `
             ${ShaderChunk.logdepthbuf_pars_fragment}
-            uniform vec3 colorDark;
-            uniform vec3 colorLight;
-            uniform float noiseScale;
+            uniform sampler2D map1;
+            uniform sampler2D map2;
+            uniform sampler2D map3;
+            uniform vec2 size;
+            uniform vec3 lineColor;
+            uniform float speed;
+            uniform float speed2;
+            uniform vec3 speedColor;
             varying vec2 vUv;
+            void main() {
 
-            // 伪随机 hash → value noise：无贴图、零采样，天然没有平铺摩尔纹
-            float hash21(vec2 p) {
-                return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453123);
-            }
-            float valueNoise(vec2 p) {
-                vec2 i = floor(p);
-                vec2 f = fract(p);
-                vec2 u = f * f * (3.0 - 2.0 * f); // smoothstep 插值 → 柔和渐变，不是硬格子
-                return mix(mix(hash21(i), hash21(i + vec2(1.0, 0.0)), u.x),
-                           mix(hash21(i + vec2(0.0, 1.0)), hash21(i + vec2(1.0, 1.0)), u.x), u.y);
-            }
+                // 中心点
+                vec2 center = vec2(0.5,0.5);
 
-            void main() {
-                // 两个八度叠加：低频大块渐变 + 中频细节 → 深灰区间内的**随机渐变**
-                float n = valueNoise(vUv * noiseScale) * 0.65
-                        + valueNoise(vUv * noiseScale * 3.1) * 0.35;
-                vec3 col = mix(colorDark, colorLight, clamp(n, 0.0, 1.0));
+                vec4 map1Color = texture2D(map1, fract( vUv * size) );
+
+                // 格子中心渐变颜色
+                if(distance( vUv , center ) < speed){
+                    map1Color = mix(map1Color, vec4(speedColor, 1.0),  clamp((1.0 - (distance(distance( vUv , center ), speed) * 8.0) ) * map1Color.a, 0.0, 1.0 ) );
+                }
+
+                vec4 map2Color = texture2D(map2, fract( vUv * size) );
+
+                vec4 map3Color = texture2D(map3, fract( vUv * size) );
+
+                // 正方形装饰中心渐变颜色
+                if(distance( vUv , center ) < speed2){
+                    map3Color = mix(map3Color, map3Color * 3.0,  clamp((1.0 - (distance(distance( vUv , center ), speed) * 4.0) ) * map3Color.a, 0.0, 1.0 ) );
+                }
+
+                vec4 mapColor = mix(map1Color, map2Color, map2Color.a);
+
+                mapColor = mix(mapColor, map3Color, map3Color.a);
+
+                //添加背景色
+                mapColor = mix(mapColor, vec4(lineColor.rgb, 1.0 ), 1.0 - mapColor.a);
+
+                // 设置透明度（中心实、外缘全透的径向淡出 —— 500×500 大地板的硬边靠它消失）
+                mapColor.a = 1.0 - (distance( vUv , center ) * 2.0);
 
-                // ⚠️ 不透明地板无法用 alpha 淡出边界 → 改用径向压暗弱化 500×500 的硬边
-                float edge = 1.0 - smoothstep(0.34, 0.5, distance(vUv, vec2(0.5, 0.5)));
-                col *= mix(0.72, 1.0, edge);
+                gl_FragColor = mapColor;
 
-                gl_FragColor = vec4(col, 1.0); // 不透明
                 ${ShaderChunk.logdepthbuf_fragment}
                 #include <colorspace_fragment>
             }
         `,
         depthTest: true,
         depthWrite: true,
-        // ⭐ 皇上 2026-09-20 旨：地板**不透明**
-        transparent: false,
+        // ⭐ 皇上 2026-10-12 旨「装饰地板需要透明」：恢复旧版 transparent:true（半透可透视）。
+        // ⚠️ depthWrite 保持 true —— 主渲染的深度缓冲照写，FPScontrol 的 10 条射线辅助线才挡得住
+        //    埋进地里的那半截（09-25 定案）。后处理特效的遮挡判定走 baseDepthTexture，2026-10-18
+        //    皇上旨「所有的对象都要进入到深度图里面了」⇒ 地板也写进那张图，会裁掉身后特效。
+        transparent: true,
         side: DoubleSide,
     });
 }

package/Ground1/Ground1.ts

@@ -2,45 +2,40 @@
  * @Author: xiaosihan
  * @Date: 2022-09-20 23:06:00
  * @Last Modified by: xiaosihan
- * @Last Modified time: 2024-08-17 02:16:56
+ * @Last Modified time: 2026-10-12 00:00:00
  *
- * ⭐ 2026-09-20 皇上旨两改：
- *   ① 原「科技感装饰地板」（三张格子贴图 + 紫色扩散动画 `#8D108E` + 格子线 `#263C56`）
- *      → 深灰地板（每帧 3 次贴图采样、贴图平铺无各向异性 → 摩尔纹 + home 页卡顿元凶之一）。
- *   ② 皇上再旨「地板就是**随机渐变**的深灰色、**不透明**」：
- *      → 深灰区间内用 **value noise 做随机渐变**（无贴图、零采样，天然无摩尔纹）；
- *      → `transparent: false`、alpha 恒 1（不透明）。
+ * ⭐ 装饰地板 = 科技感格子贴图 + 紫色扩散动画（2026-10-12 皇上旨「整条退回旧科技感地板」+「装饰地板需要透明」）。
+ *   历史：2026-09-20 皇上曾两旨把它改成「随机渐变的深灰、不透明」，理由是每帧 3 次贴图采样 +
+ *   平铺无各向异性 → 摩尔纹，且是 home 页卡顿元凶之一。**当年那个摩尔纹根因现在已经在
+ *   `threeLoader.getTexture` 里根治了**（anisotropy=16 + generateMipmaps + LinearMipmapLinear），
+ *   所以贴图路线的重画成本比 09-20 那版低一档，本次按皇上旨意恢复旧外观。
  *
- *   ⚠️ 不透明带来的变化与对策：
- *   - 原靠「径向 alpha 淡出」柔化 500×500 地板的边界；不透明后改用**径向压暗**（乘 0.72~1.0）
- *     弱化硬边 —— 若哪天皇上要「边界完全消失」，只能改回 alpha 淡出（即恢复 transparent）。
- *   - 调试线（FPScontrol）两条口径分家（2026-09-25 皇上逐条定案）：**10 条射线辅助线开深度测试**，
- *     正是靠本地板「不透明 + depthWrite:true」才挡得住埋进地里的那半截线；**8/9 两条回弹向量线
- *     保持穿透显示**（关深度测试 + renderOrder:9999），照旧常显在最前。
- *     ⚠️ 若哪天把本地板改回 transparent + depthWrite:false，射线辅助线会重新穿地浮出来。
+ *   ⭐ 2026-10-12 皇上旨「装饰地板需要透明」⇒ 恢复旧版的**外观**口径（逐字照抄 09-20 之前的写法）：
+ *   - `transparent: true` + 径向 alpha 淡出 `mapColor.a = 1 - dist(center)*2`（中心实、外缘全透）。
+ *   - **但 `depthWrite: true` 保留**（旧版本来就是 transparent + depthWrite:true）：主渲染的深度缓冲
+ *     照写 ⇒ FPScontrol 那 10 条射线辅助线仍被地板挡住埋进地里的那半截（09-25 定案口径不受影响）。
  *
- *   ⚠️ 改动红线（这几条被别处依赖，**不许顺手改**）：
- *   - `userData.fpsCollision = true`：FPScontrol 把地板当碰撞体（见 FPScontrol.ts 地面处理段）。
- *   - `userData.aoFloor = true`：ssao_pass / debugExcludedShader 的「地板类半透明」特例按此标记走
- *     （默认不写进可见深度图；物体落在地板上仍有接触 AO）。
- *   - ShaderMaterial 必须含 logdepthbuf chunk；linear 输出必须 `#include <colorspace_fragment>`；
- *     否则末端 sRGB 编码会二次编码 → 发白。
+ *   ⭐ 2026-10-18 皇上旨「所有的对象都要进入到深度图里面了，不需要用参数过滤掉了」⇒ 当年为「可透视
+ *   地板」加的 `userData.aoFloor`（把地板从后处理的可见深度图里排除）连同 ssao_pass 里那整条过滤判据
+ *   一并删除。现在地板两张深度图都写 ⇒ 透过地板看到的实体，其描边/辉光/覆盖色/磨砂会被地板裁掉，
+ *   包括外缘 alpha≈0 那圈「看得见空、看不见地板」的区域。判据出处 three-base/pass/ssao_pass.ts 文件头，
+ *   护栏 test/depthDebug.test.js J 组。
  */
-import { Color, DoubleSide, Matrix4, Mesh, PlaneGeometry, ShaderChunk, ShaderMaterial } from "three";
+import { Clock, Color, DoubleSide, BufferGeometry, Camera, Group, Material, Matrix4, Mesh, PlaneGeometry, Scene, ShaderChunk, ShaderMaterial, Vector2, WebGLRenderer } from "three";
 import { MathUtils } from "three";
 const { degToRad } = MathUtils;
+import floorMap1PNG from "./floorMap1.png";
+import floorMap2PNG from "./floorMap2.png";
+import floorMap3PNG from "./floorMap3.png";
+import threeLoader from "../threeLoader";
 
-/** 装饰地板（随机渐变的深灰、不透明） */
+/** 装饰地板（科技感格子贴图 + 紫色扩散动画，半透明可透视外观） */
 export default class Ground1 extends Mesh {
     tempMatrix: Matrix4 = new Matrix4();
     constructor() {
         super();
         // 标记为自己参与 FPS 碰撞检测
         this.userData.fpsCollision = true;
-        // 标记为"地板类半透明"：参与世界空间 AO（物体落在它上需要接触 AO），
-        // 但透过它看到的物体（如从下方透视）仍照常显示描边/辉光、且不被它的接触 AO 乘黑。
-        // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
-        this.userData.aoFloor = true;
     }
     renderOrder: number = -1;
     geometry: PlaneGeometry = (() => {
@@ -52,14 +47,22 @@ export default class Ground1 extends Mesh {
     setSize(width: number, height: number): void {
         this.scale.set(width, 1, height);
     }
+    clock: Clock = new Clock();
+    onBeforeRender: (renderer: WebGLRenderer, scene: Scene, camera: Camera, geometry: BufferGeometry, material: Material, group: Group) => void = (renderer, scene, camera, geometry, material, group) => {
+        const elapsedTime: number = this.clock.getElapsedTime();
+        this.material.uniforms.speed.value = (elapsedTime * 0.1) % 0.6;
+        this.material.uniforms.speed2.value = ((elapsedTime * 0.1) % 0.6) - 0.1;
+    };
     material: ShaderMaterial = new ShaderMaterial({
         uniforms: {
-            /** 随机渐变的**暗端**深灰（three 的 Color 存 linear，末端 colorspace_fragment 编码回 sRGB） */
-            colorDark: { value: new Color("#2A2E33") },
-            /** 随机渐变的**亮端**深灰 */
-            colorLight: { value: new Color("#3D434B") },
-            /** 低频噪声格数（越大斑块越碎；9 → 500×500 地板上每块约 55m 的大块渐变） */
-            noiseScale: { value: 9 },
+            size: { value: new Vector2(10, 10) }, // 格子平铺格数
+            speed: { value: 0 }, // 扩散值0-1
+            speed2: { value: 0 }, // 扩散值0-1
+            speedColor: { value: new Color("#8D108E") }, // 格子扩散颜色
+            lineColor: { value: new Color("#263C56") }, // 格子线的颜色
+            map1: { value: threeLoader.getTexture(floorMap1PNG) }, // 贴图纹理
+            map2: { value: threeLoader.getTexture(floorMap2PNG) }, // 贴图纹理
+            map3: { value: threeLoader.getTexture(floorMap3PNG) }, // 贴图纹理
         },
         vertexShader: `
             ${ShaderChunk.common}
@@ -73,42 +76,59 @@ export default class Ground1 extends Mesh {
         `,
         fragmentShader: `
             ${ShaderChunk.logdepthbuf_pars_fragment}
-            uniform vec3 colorDark;
-            uniform vec3 colorLight;
-            uniform float noiseScale;
+            uniform sampler2D map1;
+            uniform sampler2D map2;
+            uniform sampler2D map3;
+            uniform vec2 size;
+            uniform vec3 lineColor;
+            uniform float speed;
+            uniform float speed2;
+            uniform vec3 speedColor;
             varying vec2 vUv;
+            void main() {
 
-            // 伪随机 hash → value noise：无贴图、零采样，天然没有平铺摩尔纹
-            float hash21(vec2 p) {
-                return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453123);
-            }
-            float valueNoise(vec2 p) {
-                vec2 i = floor(p);
-                vec2 f = fract(p);
-                vec2 u = f * f * (3.0 - 2.0 * f); // smoothstep 插值 → 柔和渐变，不是硬格子
-                return mix(mix(hash21(i), hash21(i + vec2(1.0, 0.0)), u.x),
-                           mix(hash21(i + vec2(0.0, 1.0)), hash21(i + vec2(1.0, 1.0)), u.x), u.y);
-            }
+                // 中心点
+                vec2 center = vec2(0.5,0.5);
 
-            void main() {
-                // 两个八度叠加：低频大块渐变 + 中频细节 → 深灰区间内的**随机渐变**
-                float n = valueNoise(vUv * noiseScale) * 0.65
-                        + valueNoise(vUv * noiseScale * 3.1) * 0.35;
-                vec3 col = mix(colorDark, colorLight, clamp(n, 0.0, 1.0));
+                vec4 map1Color = texture2D(map1, fract( vUv * size) );
+
+                // 格子中心渐变颜色
+                if(distance( vUv , center ) < speed){
+                    map1Color = mix(map1Color, vec4(speedColor, 1.0),  clamp((1.0 - (distance(distance( vUv , center ), speed) * 8.0) ) * map1Color.a, 0.0, 1.0 ) );
+                }
+
+                vec4 map2Color = texture2D(map2, fract( vUv * size) );
+
+                vec4 map3Color = texture2D(map3, fract( vUv * size) );
+
+                // 正方形装饰中心渐变颜色
+                if(distance( vUv , center ) < speed2){
+                    map3Color = mix(map3Color, map3Color * 3.0,  clamp((1.0 - (distance(distance( vUv , center ), speed) * 4.0) ) * map3Color.a, 0.0, 1.0 ) );
+                }
+
+                vec4 mapColor = mix(map1Color, map2Color, map2Color.a);
+
+                mapColor = mix(mapColor, map3Color, map3Color.a);
+
+                //添加背景色
+                mapColor = mix(mapColor, vec4(lineColor.rgb, 1.0 ), 1.0 - mapColor.a);
+
+                // 设置透明度（中心实、外缘全透的径向淡出 —— 500×500 大地板的硬边靠它消失）
+                mapColor.a = 1.0 - (distance( vUv , center ) * 2.0);
 
-                // ⚠️ 不透明地板无法用 alpha 淡出边界 → 改用径向压暗弱化 500×500 的硬边
-                float edge = 1.0 - smoothstep(0.34, 0.5, distance(vUv, vec2(0.5, 0.5)));
-                col *= mix(0.72, 1.0, edge);
+                gl_FragColor = mapColor;
 
-                gl_FragColor = vec4(col, 1.0); // 不透明
                 ${ShaderChunk.logdepthbuf_fragment}
                 #include <colorspace_fragment>
             }
         `,
         depthTest: true,
         depthWrite: true,
-        // ⭐ 皇上 2026-09-20 旨：地板**不透明**
-        transparent: false,
+        // ⭐ 皇上 2026-10-12 旨「装饰地板需要透明」：恢复旧版 transparent:true（半透可透视）。
+        // ⚠️ depthWrite 保持 true —— 主渲染的深度缓冲照写，FPScontrol 的 10 条射线辅助线才挡得住
+        //    埋进地里的那半截（09-25 定案）。后处理特效的遮挡判定走 baseDepthTexture，2026-10-18
+        //    皇上旨「所有的对象都要进入到深度图里面了」⇒ 地板也写进那张图，会裁掉身后特效。
+        transparent: true,
         side: DoubleSide,
     });
 }

package/Mirror.js

@@ -9,10 +9,6 @@ import { Color, DoubleSide, HalfFloatType, Matrix4, Mesh, PerspectiveCamera, Pla
 export default class Mirror extends Mesh {
     constructor(geometry = Mirror.geometry) {
         super(geometry);
-        // 镜子虽标了 transparent:true（为渲染顺序），但 fragment shader 实际输出 alpha=1.0，
-        // 是实心反射面、并非可透视表面 → 必须参与 AO 与描边/辉光的深度遮挡。
-        // SSAO 的 AO 数据准备会排除所有 transparent 物体，故此处显式声明保留。
-        this.userData.aoOpaque = true;
     }
     // 正方形网格
     static geometry = (() => {

package/Mirror.ts

@@ -10,10 +10,6 @@ import { Color, DoubleSide, HalfFloatType, Matrix4, Mesh, PerspectiveCamera, Pla
 export default class Mirror extends Mesh {
     constructor(geometry: BufferGeometry = Mirror.geometry) {
         super(geometry);
-        // 镜子虽标了 transparent:true（为渲染顺序），但 fragment shader 实际输出 alpha=1.0，
-        // 是实心反射面、并非可透视表面 → 必须参与 AO 与描边/辉光的深度遮挡。
-        // SSAO 的 AO 数据准备会排除所有 transparent 物体，故此处显式声明保留。
-        this.userData.aoOpaque = true;
     }
 
     // 正方形网格

package/MktMesh/MktMesh.d.ts

@@ -61,8 +61,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *    ⇒ 与编辑态 `mktMeshEditRenderer._slotPanos` **同一份算法、同一个常数**（预览看到的那几张 = 编辑器里的那几张，均为 8 个全景槽）。
      *    存**对象引用**不存下标（删点会让下标整体前移，引用不会认错人）。
      *    消费方 = `feedFaceMapping`（墙 8 格）；⭐ 10-03 旨② 后预览立方体与墙**共用同一份材质**，
-     *    立方体几何无 `aPanoIndex` ⇒ `vPanoIndex ≡ 0` ⇒ 它显示的就是 0 号槽那张（墙与立方体天然同源，
-     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除）。
+     *    ⭐ 10-12 旨后立方体**逐颗自带序号**（`InstancedChild.panoIndex` → 逐实例 `aPanoIndex`），
+     *    不再是从前那句「几何没这条 attribute ⇒ `vPanoIndex ≡ 0` ⇒ 全体看 0 号槽那张」；
+     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除。
      */
     private _slotPanos;
     /**
@@ -72,9 +73,13 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  · 只读 XZ ⇒ 与名册历代那把「水平距离」尺同一把（09-28 旨），高度差不进尺子。
      *  · `null` ⇒ 回落 `camera.position`（老口径）：发布页那一路没有控制器引用，不注入就一切照旧。
      *  · 存的是**引用**（OrbitControls 原地改它那个 Vector3）⇒ 消费方设一次即可，不必每帧重设。
-     *  · ⚠️ 全景点矩阵本就是**世界矩阵**，锚点也取世界坐标；⛔ 别再乘一遍 `matrixWorld`（同 `updateTexture` 里那句提醒）。
+     *  · 注入的是**世界坐标**；`updateTexture` 里先 `worldToLocal` 换算到本网格局部空间再比距离
+     *    （全景矩阵与着色器取图的 `vProjPos` 都在局部空间，见那里的 2026-10-11 丙旨说明）。
+     *    ⛔ 反过来去给全景矩阵乘 `matrixWorld` 是错的：那会让 JS 侧的尺子和 shader 里的取图各走一路。
      */
     private _rosterCenter;
+    /** 锚点换算到局部空间的落点（每帧复用同一只临时量，避免分配） */
+    private _rosterAnchorLocal;
     /**
      * ⭐ 皇上旨 2026-10-03「整套搬进库（彻底同源）」：库侧不再自养「按全景序号取整槽、齐活才写」那一路，
      *    改成与编辑态**同一份换绑策略**（`./panoSlotBind`）+ 同一口径的三张表：

package/MktMesh/MktMesh.js

@@ -107,8 +107,9 @@ export default class MktMesh extends Mesh {
      *    ⇒ 与编辑态 `mktMeshEditRenderer._slotPanos` **同一份算法、同一个常数**（预览看到的那几张 = 编辑器里的那几张，均为 8 个全景槽）。
      *    存**对象引用**不存下标（删点会让下标整体前移，引用不会认错人）。
      *    消费方 = `feedFaceMapping`（墙 8 格）；⭐ 10-03 旨② 后预览立方体与墙**共用同一份材质**，
-     *    立方体几何无 `aPanoIndex` ⇒ `vPanoIndex ≡ 0` ⇒ 它显示的就是 0 号槽那张（墙与立方体天然同源，
-     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除）。
+     *    ⭐ 10-12 旨后立方体**逐颗自带序号**（`InstancedChild.panoIndex` → 逐实例 `aPanoIndex`），
+     *    不再是从前那句「几何没这条 attribute ⇒ `vPanoIndex ≡ 0` ⇒ 全体看 0 号槽那张」；
+     *    原来那条「把中心那几张抄给立方体单全景材质」的 `currentTiles` 旁路已整条删除。
      */
     _slotPanos = [];
     /**
@@ -118,9 +119,13 @@ export default class MktMesh extends Mesh {
      *  · 只读 XZ ⇒ 与名册历代那把「水平距离」尺同一把（09-28 旨），高度差不进尺子。
      *  · `null` ⇒ 回落 `camera.position`（老口径）：发布页那一路没有控制器引用，不注入就一切照旧。
      *  · 存的是**引用**（OrbitControls 原地改它那个 Vector3）⇒ 消费方设一次即可，不必每帧重设。
-     *  · ⚠️ 全景点矩阵本就是**世界矩阵**，锚点也取世界坐标；⛔ 别再乘一遍 `matrixWorld`（同 `updateTexture` 里那句提醒）。
+     *  · 注入的是**世界坐标**；`updateTexture` 里先 `worldToLocal` 换算到本网格局部空间再比距离
+     *    （全景矩阵与着色器取图的 `vProjPos` 都在局部空间，见那里的 2026-10-11 丙旨说明）。
+     *    ⛔ 反过来去给全景矩阵乘 `matrixWorld` 是错的：那会让 JS 侧的尺子和 shader 里的取图各走一路。
      */
     _rosterCenter = null;
+    /** 锚点换算到局部空间的落点（每帧复用同一只临时量，避免分配） */
+    _rosterAnchorLocal = new Vector3();
     /**
      * ⭐ 皇上旨 2026-10-03「整套搬进库（彻底同源）」：库侧不再自养「按全景序号取整槽、齐活才写」那一路，
      *    改成与编辑态**同一份换绑策略**（`./panoSlotBind`）+ 同一口径的三张表：
@@ -691,15 +696,21 @@ export default class MktMesh extends Mesh {
             this.activeIndex = -1;
             return;
         }
-        const ref = this._rosterCenter ?? camera.position;
+        // ⭐ 皇上旨 2026-10-11 丙：尺子的两端必须落在**同一个空间**。注入的锚点是世界坐标，而下面那把尺子量的
+        //    全景位置记在本网格的**局部（制图）空间** —— 依据是着色器自己：`vProjPos = uProjInvMatrix·modelMatrix·pos`
+        //    = M⁻¹·M·pos = 局部（`uProjInvMatrix` 正是 `syncProjInvMatrix` 里那句 `matrixWorld` 求逆），片元再拿
+        //    `dir = vProjPos - tm[3].xyz` 取图 ⇒ 全景矩阵只可能和 `vProjPos` 同空间，即局部。
+        //    所以换算放在**锚点这一端**（`worldToLocal`），⛔ 不去给全景矩阵乘 `matrixWorld`：那是把 JS 的尺子
+        //    和 shader 的取图拆成两路。网格无变换时这一步是恒等 ⇒ 老项目逐字不变；有旋转时（消费方给 mkt 加了
+        //    `rotation.y`）原来会把「往世界的某一头走」量成「往局部的另一头走」，人走到位了名册还不动。
+        const ref = this._rosterAnchorLocal.copy(this._rosterCenter ?? camera.position);
+        this.worldToLocal(ref);
         const dists = [];
         for (let i = 0; i < n; i++) {
             const e = this.textures[i].matrix.elements;
             this._tmpV3.set(e[12], e[13], e[14]);
-            // ⚠️ 全景点矩阵**本身就是世界矩阵**（见上方 textures 字段注释），位置已在世界空间，
-            //    可直接与锚点的世界坐标比距离 —— 这里**绝不能再乘 matrixWorld**：那是双重变换，
-            //    MktMesh 一有整体变换就会算错「离锚点最近的是哪张」（选错全景）。
-            //    （2026-09-19 曾误以为它记在模型空间而多乘了一次，趁 MktDevMesh 对齐时一并纠正。）
+            // ⚠️ 全景点矩阵记在本网格的局部空间（与 `wallPoints` 同一空间，见上面丙旨那段着色器推导），
+            //    所以拿来直接和**已换算到局部**的 `ref` 比距离；⛔ 这里绝不乘 `matrixWorld`（双重变换 = 选错全景）。
             // ⭐ 09-28 09:33 旨：挑图与编辑器取图同一把「**水平距离**」尺（XZ 平面，不含高度差）。
             // const d = this._tmpV3.distanceTo(camera.position);   // 旧原理：三维直线距离——全景点同高（y 恒 1.6）时与本式排序等价，注释保留备查
             // ⭐ 10-07 第二十一道旨：尺子的另一端从相机位置换成 `ref`（控制器中心点；未注入时它就是相机位置）。
@@ -791,6 +802,10 @@ export default class MktMesh extends Mesh {
      *  ⭐ `rt:` 虚拟键（32 瓦片拼合槽）走拼合器 peek；⛔ 不在这里 pump（每帧驱动点唯一，见 `updateTexture`，
      *    否则一帧画好几格 = 把「每帧只载入一张新纹理」那道闸从后门拆了）。 */
     _peekTileAt(key, original) {
+        // ⭐ 2026-10-25：空地址 = 「这个点还没设图片」，不是一条能加载的 URL ⇒ 直接判没有。
+        //    放过去会让 ensureTileTexture 拿空串请求当前文档地址、失败后每帧重试。
+        if (!key)
+            return null;
         if (isRtStitchKey(key)) {
             const p = rtStitchKeyParts(key);
             if (!p)
@@ -828,6 +843,9 @@ export default class MktMesh extends Mesh {
      *  ⚠️ 皇上旨 2026-09-28「加载瓦片的时候, 瓦片纹理不需要添加 oss 的参数」⇒ 真瓦片（`original=true`，现行 32 片/全景）走原图，
      *     整图档才按 ossSize 档缩（`resolveOssUrl`）。 */
     ensureTileTexture(key, original = false) {
+        // ⭐ 2026-10-25：空地址直接判「没有」，不起载（与编辑态 ensureFloorTexture 同一道闸）。
+        if (!key)
+            return null;
         const cached = this._texCache.get(key);
         if (cached)
             return cached;
@@ -877,8 +895,9 @@ export default class MktMesh extends Mesh {
             if (this._glRenderer)
                 this._glRenderer.initTexture(tex);
         }
-        catch (e) {
-            console.warn("[MktMesh] 瓦片预上传失败，交给常规渲染路径自行上传：", e);
+        catch {
+            // 皇上旨 2026-10-12「日志都去掉」⇒ 这里不再出声；降级路径本身不变（下面照记「已处理」，
+            // 最坏退回 three 在绑定那一帧自己上传的老路径）。
         }
         // ⚠️ 成败都记「已处理」。不记 ⇒ 这张永远进不了 `_texUploaded` ⇒ 那一格永远换不上新图，
         //    比「卡一下」严重得多；记了最坏也只是退回 three 在绑定那一帧自己上传的老路径。
@@ -922,6 +941,18 @@ export default class MktMesh extends Mesh {
                 continue;
             }
             idxU[s] = this.textures.indexOf(info);
+            // ⭐ 2026-10-25 皇上旨「把默认图去掉，图片没有加载的时候就显示纯灰色」：
+            //    这个点**没设图片**（url 空且没有切片）⇒ 按空槽喂料，权重 0 ⇒ 片元回落 uFaceMissingColor 中性灰。
+            //    ⛔ 别把空地址放下去：空 key 会走到 `_peekTileAt` → `ensureTileTexture("")` 发一次空请求
+            //    （解析成当前文档地址），失败后下一帧再试 = 每帧一个废请求。序号照留（归属还在，只是没图）。
+            const hasSource = !!info.url || !!(info.tiles && info.tiles.length > 0);
+            if (!hasSource) {
+                for (let k = 0; k < RT_STITCH_SLOT_COUNT; k++)
+                    panos[base + k] = this._placeholder;
+                mats[s].identity();
+                ws[s] = 0;
+                continue;
+            }
             // 各槽喂什么地址 = 「用户选的形态 + 该点有没有切过片」共同决定（whole 或无 tiles ⇒ 各槽同为一张整图）
             const tiles = mktPanoTexUrls(info.url, info.tiles, this._panoTexMode);
             // ⚠️ 「是不是真瓦片」只算一次：喂地址（走不走 OSS 尺寸档）与写 uPanoTiled 共用同一个值
@@ -1032,12 +1063,10 @@ export default class MktMesh extends Mesh {
         // setWallPoints 已按位置重算过映射（旧为空 → 全 -1），此处用存档里的逐面指派覆盖。
         // 几何拓扑由同一份 wallPoints 重建，面索引与导出时一致 ⇒ 逐面写入即可对齐。
         // ⭐ 皇上旨 2026-10-03「补」：长度不符**不再整份丢弃**——按较小长度逐面灌回（存档多出的面丢掉，
-        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值），并把两个数 warn 出来（不静默吞）。
+        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值）。
+        //   2026-10-12 旨「日志都去掉」⇒ 这一条不再 warn，差值只按较小者静默还原。
         const imported = (data.panoFaceMapping && data.panoFaceMapping.length ? data.panoFaceMapping : []);
         const faceCount = this.panoFaceMapping.length;
-        if (imported.length && imported.length !== faceCount) {
-            console.warn(`[MktMesh] 存档序号映射面数 ${imported.length} ≠ 当前墙体面数 ${faceCount}，按较小者逐面还原（差值来自墙点/墙高变化）`);
-        }
         const restore = Math.min(imported.length, faceCount);
         if (restore > 0) {
             for (let f = 0; f < restore; f++)