three-base 2.0.172 → 2.0.175

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 地面处理段）。
- *   - ⚠️ 2026-10-11 皇上旨「物体的深度都要进深度图」⇒ 原第三条红线 `userData.aoFloor = true`
- *     （把地板从可见深度图里排除的那条例外）**整条拆除**：它的前提是地板半透明可透视，与本文件
- *     ② 的「不透明改造」自相矛盾。地板现在按普通实心面写进深度图，被它挡住的描边/辉光/覆盖色/
- *     磨砂会被裁掉。见 three-base/pass/ssao_pass.ts 文件头。
- *   - 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;
-        // ⚠️ 这里原来还有 `this.userData.aoFloor = true;`（把本地板从可见深度图里排除的特例标记），
-        // 2026-10-11 皇上旨「物体的深度都要进深度图」⇒ 连同 ssao_pass 的特例分支一起整条删除。
     }
     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;
     /**

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 = [];
     /**
@@ -801,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)
@@ -838,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;
@@ -887,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 在绑定那一帧自己上传的老路径。
@@ -932,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 共用同一个值
@@ -1042,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++)

package/MktMesh/MktMesh.ts

@@ -130,8 +130,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: (MktTextureInfo | undefined)[] = [];
     /**
@@ -833,6 +834,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  ⭐ `rt:` 虚拟键（32 瓦片拼合槽）走拼合器 peek；⛔ 不在这里 pump（每帧驱动点唯一，见 `updateTexture`，
      *    否则一帧画好几格 = 把「每帧只载入一张新纹理」那道闸从后门拆了）。 */
     private _peekTileAt(key: string, original: boolean): Texture | null {
+        // ⭐ 2026-10-25：空地址 = 「这个点还没设图片」，不是一条能加载的 URL ⇒ 直接判没有。
+        //    放过去会让 ensureTileTexture 拿空串请求当前文档地址、失败后每帧重试。
+        if (!key) return null;
         if (isRtStitchKey(key)) {
             const p = rtStitchKeyParts(key);
             if (!p) return null;
@@ -869,6 +873,8 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  ⚠️ 皇上旨 2026-09-28「加载瓦片的时候, 瓦片纹理不需要添加 oss 的参数」⇒ 真瓦片（`original=true`，现行 32 片/全景）走原图，
      *     整图档才按 ossSize 档缩（`resolveOssUrl`）。 */
     private ensureTileTexture(key: string, original = false): Texture | null {
+        // ⭐ 2026-10-25：空地址直接判「没有」，不起载（与编辑态 ensureFloorTexture 同一道闸）。
+        if (!key) return null;
         const cached = this._texCache.get(key);
         if (cached) return cached;
         if (cached === null) return null; // 加载中
@@ -915,8 +921,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             // `_glRenderer` 还没被 `onBeforeRender` 捕获到（构造后尚未渲染过一帧）⇒ 跳过预上传，
             // 交给 three 在绑定那一帧自己上传 —— 那是改造前的老路径，不会报错，只是那一张没享受「错峰」。
             if (this._glRenderer) this._glRenderer.initTexture(tex);
-        } catch (e) {
-            console.warn("[MktMesh] 瓦片预上传失败，交给常规渲染路径自行上传：", e);
+        } catch {
+            // 皇上旨 2026-10-12「日志都去掉」⇒ 这里不再出声；降级路径本身不变（下面照记「已处理」，
+            // 最坏退回 three 在绑定那一帧自己上传的老路径）。
         }
         // ⚠️ 成败都记「已处理」。不记 ⇒ 这张永远进不了 `_texUploaded` ⇒ 那一格永远换不上新图，
         //    比「卡一下」严重得多；记了最坏也只是退回 three 在绑定那一帧自己上传的老路径。
@@ -959,6 +966,17 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
                 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 共用同一个值
@@ -1075,12 +1093,10 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         // setWallPoints 已按位置重算过映射（旧为空 → 全 -1），此处用存档里的逐面指派覆盖。
         // 几何拓扑由同一份 wallPoints 重建，面索引与导出时一致 ⇒ 逐面写入即可对齐。
         // ⭐ 皇上旨 2026-10-03「补」：长度不符**不再整份丢弃**——按较小长度逐面灌回（存档多出的面丢掉，
-        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值），并把两个数 warn 出来（不静默吞）。
+        //   墙变长多出来的那些面保持 setWallPoints 按位置继承到的值）。
+        //   2026-10-12 旨「日志都去掉」⇒ 这一条不再 warn，差值只按较小者静默还原。
         const imported = (data.panoFaceMapping && data.panoFaceMapping.length ? data.panoFaceMapping : []) as number[];
         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++) this.panoFaceMapping[f] = imported[f];

package/MktMesh/mktMappingShader.d.ts

@@ -1,18 +1,19 @@
 import { ShaderMaterial } from "three";
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export declare const MKT_PANO_MAX_SLOTS = 8;
+export declare const MKT_PANO_MAX_SLOTS = 5;
 /**
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
  * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
  */

package/MktMesh/mktMappingShader.js

@@ -8,33 +8,42 @@
 import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
 import { createPlaceholderTexture, floorVertexShader, RT_STITCH_SLOT_COUNT } from "./mktShader";
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export const MKT_PANO_MAX_SLOTS = 8;
+export const MKT_PANO_MAX_SLOTS = 5;
 /**
  * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
- * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
+ * 槽内采样段（等距柱状投射 + 左/中/右 3 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
  * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
  * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
  * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
  */
 function buildFloorMappingFragment(maxPano) {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    // 每个全景点占 **3** 张拼合槽纹理（9 片 3×3 按列分：左列 / 中列 / 右列，每槽竖叠 3 片）⇒ 5 × 3 = 15 ≤ sampler 硬顶 16
     const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
     let slotCalc = ""; // 每槽各自采样出 linK（weights[k]>0 才采；没绑好保持 0，由 facePick 的 weights 闸兜成深灰）
     let slotFacePick = ""; // 逐槽展开「panoIndices[k]==vPanoIndex 则取 lin{k}」（ANGLE 禁动态索引 ⇒ JS 常量展开）
     for (let k = 0; k < maxPano; k++) {
-        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 3 个连续纹理槽：base=k*3 .. base+2（顺序 [左列, 中列, 右列]）
+        // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组 ⇒ 展开成「base + 字面量」常量下标 if 链；末条裸 else 兜住 u==1 边界
+        const slotSamples = [];
+        for (let s = 0; s < RT_STITCH_SLOT_COUNT; s++) {
+            const cond = s === RT_STITCH_SLOT_COUNT - 1
+                ? "else"
+                : `${s === 0 ? "if" : "else if"} (tileIdx == ${s})`;
+            slotSamples.push(`            ${cond} lin${k} = texture2D(panoramas[${base + s}], vec2(panoU, panoV)).rgb;`);
+        }
         slotFacePick += `
         if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
         slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        // ── 点槽 ${k}（纹理 ${base}..${base + RT_STITCH_SLOT_COUNT - 1}）──
         vec3 lin${k} = vec3(0.0);
         if (weights[${k}] > 0.0) {
             mat4 tm = textureMatrices[${k}];
@@ -47,21 +56,19 @@ function buildFloorMappingFragment(maxPano) {
             float lat = asin(clamp(dir.y, -1.0, 1.0));
             // 等距柱状线性 v（= 全图 UV），与 blend / 单全景分支**逐字同口径**
             float v = 0.5 + lat * 0.3183098861837907; // 1/PI
-            // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
-            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
-            int tileIdx = (u >= 0.5) ? 1 : 0;
-            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
-            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 2v/2v-1 = 纵向分辨率白丢一半
+            // 三等分经度 -> 拼合槽下标 [左列=0, 中列=1, 右列=2]（每槽 = 3×3 网格里一整列、竖 3 片拼成，见 RT_STITCH_SLOT_TILES）
+            // ⭐ 10-06 晚旨「竖着不再分块」继续成立、10-23 旨把横向从 2 等分改成 3 等分 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
+            int tileIdx = int(clamp(floor(u * ${RT_STITCH_SLOT_COUNT}.0), 0.0, ${RT_STITCH_SLOT_COUNT - 1}.0));
+            float localU = u * ${RT_STITCH_SLOT_COUNT}.0 - float(tileIdx);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 nv/nv-1 = 纵向分辨率白丢一档
             float localV = v;
-            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
+            // 🧩 该点这 3 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
             float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
             float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
-            // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：以下 2 个采样下标均为「base + 字面量」常量表达式，编译安全
             // ⭐ 采样即线性（与单全景 / blend / selected 三路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
             //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
             //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
-            if (tileIdx == 0) lin${k} = texture2D(panoramas[${base}], vec2(panoU, panoV)).rgb;
-            else lin${k} = texture2D(panoramas[${base + 1}], vec2(panoU, panoV)).rgb;
+${slotSamples.join("\n")}
         }`;
     }
     return /* glsl */ `
@@ -105,13 +112,13 @@ ${slotFacePick}
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
  * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
  */
 export function createMktFloorMappingShaderMaterial(options = {}) {
     const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 8 点 × 左/右 2 槽 = 16 = sampler 硬顶
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 5 点 × 左/中/右 3 槽 = 15（sampler 硬顶 16）
     const panoramas = [];
     const matrices = [];
     for (let i = 0; i < tileCount; i++)

package/MktMesh/mktMappingShader.ts

@@ -9,34 +9,45 @@ import { BackSide, Matrix4, ShaderMaterial, Vector3 } from "three";
 import { createPlaceholderTexture, floorVertexShader, RT_STITCH_SLOT_COUNT } from "./mktShader";
 
 /**
- * ⭐ 融合材质的全景点数**上限**（皇上旨 10-06「一次能够展示 8 个全景纹理」）：每点占 **2** 张拼合槽纹理
- *   （32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *   （sampler 总数 16 是硬件硬顶，本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16。）
+ * ⭐ 融合材质的全景点数**上限**：每点占 **3** 张拼合槽纹理（皇上旨 2026-10-23「全景的 RT 由原来的 2 个分成 3 个、
+ *   每个 4096×6144、竖直排列 3 个瓦片」⇒ 原图切 3×3=9 片，按**列**分 3 槽）⇒ 点数 × 3 必须 ≤ sampler 硬顶。
+ *   本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 **16**：旧版 8 点 × 2 槽 = 16 正好用满，现每点 3 槽 ⇒ 只能取 ⌊16/3⌋ = **5**
+ *   （5 × 3 = 15）。皇上旨 2026-10-23 在「A」里拍板：保 3 槽不降画质，**同屏全景点数 8 → 5**。
  *
  * ⭐⭐ 2026-10-09 皇上旨「MktMesh 只有映射一种，blend/selected 归编辑器」⇒ 该常量从 `mktShader.ts`
  *   **搬到这里**（映射材质的所在地）。它同时是库与编辑器那份 blend 的**共同上限**，两边必须同值。
  */
-export const MKT_PANO_MAX_SLOTS = 8;
+export const MKT_PANO_MAX_SLOTS = 5;
 
 /**
  * 序号直取片元（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 按三角面 aPanoIndex 在 panoIndices 槽里找对应全景纹理 —— **不看距离、不看夹角**（blend 那套打分/归约整段没有）。
- * 槽内采样段（等距柱状投射 + 左右 2 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
+ * 槽内采样段（等距柱状投射 + 左/中/右 3 张拼合槽 + 采样即线性、不再手动 pow 解码）与 blend **逐字同口径**；改采样口径两处同改。
  * 未设序号 / 序号不在槽里 / 该槽瓦片没绑好（weights≤0）→ uFaceMissingColor 深灰兜底
  * （皇上旨 09-28「装不下就深灰」；weights 闸是 09-29 拆分时补的 —— 原运行时分支没这道闸，
  * 槽没绑好但序号命中会采到 vec3(0) 纯黑，深灰才是钦定兜底色）。
  */
 function buildFloorMappingFragment(maxPano: number): string {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    // 每个全景点占 **3** 张拼合槽纹理（9 片 3×3 按列分：左列 / 中列 / 右列，每槽竖叠 3 片）⇒ 5 × 3 = 15 ≤ sampler 硬顶 16
     const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
     let slotCalc = ""; // 每槽各自采样出 linK（weights[k]>0 才采；没绑好保持 0，由 facePick 的 weights 闸兜成深灰）
     let slotFacePick = ""; // 逐槽展开「panoIndices[k]==vPanoIndex 则取 lin{k}」（ANGLE 禁动态索引 ⇒ JS 常量展开）
     for (let k = 0; k < maxPano; k++) {
-        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 3 个连续纹理槽：base=k*3 .. base+2（顺序 [左列, 中列, 右列]）
+        // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组 ⇒ 展开成「base + 字面量」常量下标 if 链；末条裸 else 兜住 u==1 边界
+        const slotSamples: string[] = [];
+        for (let s = 0; s < RT_STITCH_SLOT_COUNT; s++) {
+            const cond = s === RT_STITCH_SLOT_COUNT - 1
+                ? "else"
+                : `${s === 0 ? "if" : "else if"} (tileIdx == ${s})`;
+            slotSamples.push(
+                `            ${cond} lin${k} = texture2D(panoramas[${base + s}], vec2(panoU, panoV)).rgb;`,
+            );
+        }
         slotFacePick += `
         if (panoIndices[${k}] >= 0.0 && weights[${k}] > 0.0 && abs(panoIndices[${k}] - vPanoIndex) < 0.5) faceCol = lin${k};`;
         slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        // ── 点槽 ${k}（纹理 ${base}..${base + RT_STITCH_SLOT_COUNT - 1}）──
         vec3 lin${k} = vec3(0.0);
         if (weights[${k}] > 0.0) {
             mat4 tm = textureMatrices[${k}];
@@ -49,21 +60,19 @@ function buildFloorMappingFragment(maxPano: number): string {
             float lat = asin(clamp(dir.y, -1.0, 1.0));
             // 等距柱状线性 v（= 全图 UV），与 blend / 单全景分支**逐字同口径**
             float v = 0.5 + lat * 0.3183098861837907; // 1/PI
-            // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
-            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
-            int tileIdx = (u >= 0.5) ? 1 : 0;
-            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
-            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 2v/2v-1 = 纵向分辨率白丢一半
+            // 三等分经度 -> 拼合槽下标 [左列=0, 中列=1, 右列=2]（每槽 = 3×3 网格里一整列、竖 3 片拼成，见 RT_STITCH_SLOT_TILES）
+            // ⭐ 10-06 晚旨「竖着不再分块」继续成立、10-23 旨把横向从 2 等分改成 3 等分 ⇒ 槽只随 u 走（与 blend / 单全景分支**逐字同口径**）
+            int tileIdx = int(clamp(floor(u * ${RT_STITCH_SLOT_COUNT}.0), 0.0, ${RT_STITCH_SLOT_COUNT - 1}.0));
+            float localU = u * ${RT_STITCH_SLOT_COUNT}.0 - float(tileIdx);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v；写成 nv/nv-1 = 纵向分辨率白丢一档
             float localV = v;
-            // 🧩 该点这 2 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
+            // 🧩 该点这 3 槽装的是整图（whole 形态 / 没切过片）⇒ 还原成全图 UV 再采样（与 blend 逐字同口径）
             float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
             float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
-            // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：以下 2 个采样下标均为「base + 字面量」常量表达式，编译安全
             // ⭐ 采样即线性（与单全景 / blend / selected 三路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
             //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
             //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
-            if (tileIdx == 0) lin${k} = texture2D(panoramas[${base}], vec2(panoU, panoV)).rgb;
-            else lin${k} = texture2D(panoramas[${base + 1}], vec2(panoU, panoV)).rgb;
+${slotSamples.join("\n")}
         }`;
     }
     return /* glsl */ `
@@ -108,13 +117,13 @@ ${slotFacePick}
  * 创建「全景序号直取」着色器材质（皇上旨 2026-09-29「三模式三 shader」之二）：
  * 编辑器「映射设置模式」的墙材质 + **基类 MktMesh（发布/预览）的固定墙材质**
  * （皇上旨：mktmesh 就只有按照 attribute 配置来显示全景这一种固定的 shader）。
- * uniform 形状与 blend 工厂同档（panoramas[16]/textureMatrices[8]/weights[8]/uPanoTiled[8]）⇒
+ * uniform 形状与 blend 工厂同档（panoramas[15]/textureMatrices[5]/weights[5]/uPanoTiled[5]）⇒
  * 喂料复用 feedBlendProjection 的槽位指派路（feedFaceMapping），零新喂料路。
  * uFloorCoreRadius/uFloorFadeRange/uFloorOpacity 三根本 shader 不读，但喂料统一入口会写 ⇒ JS 侧留着（静默忽略）。
  */
 export function createMktFloorMappingShaderMaterial(options: { maxPano?: number } = {}): ShaderMaterial {
     const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 8 点 × 左/右 2 槽 = 16 = sampler 硬顶
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 5 点 × 左/中/右 3 槽 = 15（sampler 硬顶 16）
     const panoramas: import("three").Texture[] = [];
     const matrices: Matrix4[] = [];
     for (let i = 0; i < tileCount; i++) panoramas.push(createPlaceholderTexture());