three-base 2.0.142 → 2.0.145

package/MktMesh/mktShader.js

@@ -1,1248 +1,1248 @@
-/*
- * @Author: xiaosihan
- * @Date: 2026-08-25
- * @Description: MktMesh（墨卡托模型）的自定义 ShaderMaterial。
- *
- * 思路（与脚手架 render3DGoods 的 panoramaMercatorMaterial 同源）：
- *  1. 顶点着色器：vProjPos = uProjInvMatrix * modelMatrix * im * position。
- *     墙体几何在构建时已把点位写入世界坐标、MktMesh 自身保持单位变换，故无需实例矩阵；
- *     纹理朝向的旋转由片元着色器乘 mat3(textureMatrix)（纹理矩阵左上 3x3 旋转分量）完成。
- *     ⚠️ **取样方向的两个操作数，必须都对 MktMesh 的整体变换免疫**（皇上旨 2026-09-19）：
- *     textureMatrix 是**世界矩阵**（见下方片元 uniform 注释），属独立于 MktMesh 的外部数据，
- *     本来就不随 MktMesh 移动/旋转/缩放；而墙顶点经 modelMatrix 升到世界坐标，**会**跟着变 ——
- *     一个动、一个不动，方向就变了 => **墙上的纹理跟着滑动**（皇上报的正是此症）。
- *     故引入 uProjInvMatrix（默认单位阵）：MktMesh 自己写 inverse(matrixWorld)，把墙顶点也**拉回
- *     与整体变换无关的几何局部坐标**，两个操作数于是双双免疫 => 方向恒定 => 纹理稳稳贴在墙上。
- *     其余网格（编辑器地板/立方体、预览立方体）保持单位阵 => 行为与改造前逐字节一致。
- *     ⚠️ 注意 M ≠ I 时 vProjPos（局部）与 textureMatrix（世界）并不在同一空间 —— 这是**刻意**的：
- *        皇上要的是「纹理贴在墙上不动」，达成条件就是「两个操作数都不随 M 变」，而非「同处一空间」。
- *        千万别"好心"再去把 textureMatrix 也乘一遍 inverse(matrixWorld)，那会让纹理重新动起来。
- *  2. 片元着色器：方向向量 dir = normalize(vProjPos - 纹理矩阵位置)，即「以纹理矩阵的位置为投影中心」；
- *     再乘纹理矩阵的旋转分量（mat3(textureMatrix)），得到纹理局部方向；
- *     最后按**等距柱状**（equirectangular）把方向换算成全景纹理 UV 采样。
- *     ⚠️ 类名叫 MktMesh（墨卡托）是历史包袱，**取样口径不是墨卡托**：全景图是等距柱状图、
- *     像素行正比于纬度，故 v 必须线性于 lat（理由见片元着色器 v 换算处的说明）。
- *  3. 色彩空间 = **只有一条路**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
- *     全景纹理（瓦片 / 整图 / 拼合槽 RT）一律标 `colorSpace = SRGBColorSpace` ⇒ WebGL2 按 SRGB8_ALPHA8 上传，
- *     `texture2D` 时**硬件已经做过一次 sRGB→linear 解码**，片元直接把采样值当线性值用、**不再手动 pow 解码**。
- *     原 `uColorSpace` uniform + 那段内联 pow 分支（sRGB/Linear 两档）已整条撤除 ⇒ 两遍都解 = 二次解码压暗。
- *     toneMapped=false 跳过 Reinhard；末端 <colorspace_fragment> / 终处理只编码一次 ⇒ 一进一出，与源图逐字节还原。
- *
- * 兼容注意：为兼容 Windows / ANGLE 的 GLSL 编译器，本文件刻意不使用全局 const 常量与自定义函数，
- * 所有常量均以字面量内联书写；ShaderMaterial 为 GLSL ES 1.00，用 texture2D / gl_FragColor。
- */
-import { Color, DataTexture, DoubleSide, Matrix4, ShaderMaterial, SRGBColorSpace, Vector3, Vector4 } from "three";
-/**
- * 🔬 瓦片象限诊断开关（2026-09-21）。
- * 背景：皇上为「全景 2×2 瓦片上下方向」连调六轮，当时把「位置」与「块内朝向」绑在一起调
- * （tileRow 随 v 动），2×2=4 种组合**四档全试过仍不合预期** ⇒ 病灶必不在开关取值内，
- * 继续靠「交换 / 翻转 / 颠倒」这类语义词猜测只会无限循环，故改用**可视化归因**。
- *
- * ✅ **后续定论（2026-09-22 写死）**：四档轮转当时调不动，根因不在开关取值，而在**基础 v 映射口径**
- *    （切片线性、取样墨卡托，见下方 🎛️ 段 ①）—— 口径错配是**连续**偏差，任何离散档位都凑不回来。
- *    现口径已统一为等距柱状线性，皇上验收「不交换 / 不翻转」那态即正确 ⇒ **方向参数整条撤除、写死**
- *    （见 🎛️ 段）。本诊断开关保留，用于日后再次核对「哪块瓦片落在哪个象限」。
- *
- * 用法：页面 URL 带 `?panoTileDebug=1` 时，两张槽纹理**不再采样纹理**，各自输出一个纯色 ——
- *      ⭐ 10-06 晚起只有左右两槽（竖着不再分块）：红=左半幅(槽0)  绿=右半幅(槽1)
- *      （旧 4 象限版是 红=tiles[0] 绿=tiles[1] 蓝=tiles[2] 黄=tiles[3]，已随四槽一并作废）
- * 皇上只要说出「画面上下左右各是什么颜色」，即可一次反推出真实映射。
- *
- * ⚠️ 以**字面量 0.0/1.0** 内联进 GLSL：正常态整段被编译器消除，线上正常路径零开销、零行为差异。
- */
-/**
- * 诊断开关取值：URL 的 `?name=1` —— ⚠️ **search 与 hash 两处都认**。
- * 皇上的地址长这样：`https://www.3dkeshihua.com/three-base/#/mktMeshEdit?nocache=xxx`，
- * 查询串挂在 `#` **后面**（那是路由的 hash，`location.search` 是空串）⇒ 只查 search 的话开关永远按不下去。
- */
-function panoDebugOn(name) {
-    try {
-        if (typeof location === "undefined")
-            return false;
-        const re = new RegExp(`[?&]${name}=1\\b`);
-        return re.test(location.search || "") || re.test(location.hash || "");
-    }
-    catch {
-        return false;
-    }
-}
-const TILE_DEBUG_GLSL = panoDebugOn("panoTileDebug") ? "1.0" : "0.0";
-/**
- * 🔬 归属诊断配色（皇上旨 2026-09-25「你为每个全景球设置不同的颜色, 然后把全景瓦片映射在墙面上时, 叠加该全景图的颜色,
- *      这样我就能看清楚整个墙面是不是叠加了同一个颜色 —— 若是同一个颜色, 说明整面都映射了同一张瓦片, 根本没按最近取」）。
- *
- * 用法：页面 URL 带 `?panoTint=1`（`#` 前后都认，见 `panoDebugOn`）⇒
- *      片元算完最终颜色后，**这块面按「它归哪个景点」染成该景点的固定色**（红/绿/蓝/黄；色相由景点决定，
- *      强度见下面的 `PANO_TINT_MIX`），
- *      同时应用层把**全景点标记**染成同一色板（图例，方便对「哪块色是哪个球」）⇒
- *      这一片墙/地板是什么色，它就是那个球投的；整墙一个色 = 只投了一张，两色交界 = 归属分界线。
- *      ⚠️ 口径历经五版：① 「采样色 × 固定色」→ 叠在亮图上近白，皇上「完全看不到效果」；② 逐槽把 `linK` 整张换成纯色
- *      → 墙对了，但地板渐隐成灰的那些地方压根没全景、于是也没色 ⇒ 皇上「颜色叠加怎么没有了」；
- *      ③（皇上 09-25 口谕「就在最后算出来的颜色再叠加上颜色，不用想那么复杂」）⇒ 只在 **main 末尾对最终颜色**上一次色，
- *      归属判据与取图那条逐字一致，但地板盘外也照样上色，一眼看得出整间房怎么分家；
- *      ④（皇上 09-25 近旨「地板有叠加色了，但墙上没有；每个全景点的叠加色都是红色，我想要让他们的颜色不一样」）
- *      ⇒ 两处同一个根因：**色相按「纹理槽」给，而槽 ≠ 景点**。①「仅映射选中的那一个」模式下墙走的是另一份
- *      **单全景材质**（`createMktShaderMaterial`，压根没有染色段）⇒ 墙当然没色；② 同一模式下地板只把选中的那张
- *      喂进 **0 号槽** ⇒ 不管选第几个点都涂 0 号的红。修法：色相改为**运行时按景点序号**给（`uPanoTintColors[slot]`
- *      / 单全景材质 `uPanoTint`，两根 uniform 都只在开态存在），单全景材质末尾也补上同一条上色；色板抬成
- *      **前 20 个景点各一色**（见 `panoTintHex`）；
- *      ⑤（皇上 09-26 晚「颜色叠加中, 叠加的颜色比例少一点」）⇒ ③④ 那两版把最终颜色**整块换成了色相**（只剩明暗），
- *      底下那张全景照片完全读不出来 ⇒ 改成 `mix(原色, 染色, PANO_TINT_MIX)`，两份材质共用这一个常数。
- *
- * ⚠️ 关掉时（默认）**一行 GLSL 都不生成**（JS 侧三元，不是 uniform 分支）⇒ 线上正常路径零开销、零行为差异。
- * ⚠️ 与 `panoTileDebug` 互不影响：那个看「哪一块瓦片落在哪个象限」，这个看「这一片墙归哪个全景」。
- */
-const PANO_TINT_ON = panoDebugOn("panoTint");
-/** 诊断配色是否开启（应用层据此把全景点标记染成同色板，两边对得上） */
-export const MKT_PANO_TINT_ON = PANO_TINT_ON;
-/**
- * 🔬 诊断色的**叠加强度**（0~1）：`mix(原画面色, 染色, 本值)`。1 = 整块换成色相（09-25 初版，墙上只剩明暗，
- * 照片本身看不清）；皇上旨 2026-09-26 晚「叠加的颜色比例少一点」⇒ 取 **0.5**：色相仍是主色、一眼分得出归属，
- * 但底下那张全景图的明暗与颜色能同时读出来。两份材质（融合 / 单全景）**共用这一个值**。
- */
-const PANO_TINT_MIX = 0.5;
-/**
- * 🔬 **距离明暗诊断图**（皇上旨 2026-09-26 晚「你计一下每个点距离最近的一个全景点的距离, 然后距离越小颜色就是白色,
- *      越远颜色就是黑色」）。
- *
- * 用法：分两条路，**各自独立**，谁也不靠谁：
- *      · **编辑器（MktMeshEdit）= 建材质时显式传 `panoDist: mktPanoDistEditorOn()`** ⇒ 默认关、地址里写 `panoDist=1` 才开
- *        （皇上旨 2026-09-27 晚「把颜色换成纹理，全景的纹理」—— 灰阶诊断让位给真投影，诊断图按需开）。
- *      · **库侧（发布页 / 预览弹窗）= 不传 ⇒ 读 URL 的 `PANO_DIST_ON`，默认关** ⇒ 正常渲染路径零影响。
- *      开了之后片元算完最终颜色，按**这面这点到「它实际用的那张全景」的投影中心的水平距离**涂明暗：
- *      **贴到球脚下 = 白，远到房间最远角 = 黑**。
- *      与归属配色的分工：`panoTint` 回答「这块归哪个球」（分家线），`panoDist` 回答「这点离自己的球到底有多远」——
- *      后者能把「整墙一个色」那面墙上的**连续渐变**照出来，距离判据是不是真在起作用一眼可辨（恒白/恒黑才是坏的）。
- * ⚠️ 距离口径与取图那条**同一个**：水平（xz）距离、候选 = 存活槽、门优先兜底不限门 ⇒ 白色区域就是那一张覆盖到的地方。
- * ⚠️ 黑端（多远算全黑）= 应用层每次喂的 `uPanoDistMax`，取**墙体上最远处到自己最近景点的那段水平距离**
- *    （`_panoDistRange()`，皇上那间约 12m）⇒「黑」就是这间房可能出现的最大距离，跨面可比（不是每面各自归一化）。
- *    ⛔ 别拿地板尺寸当尺子：默认地板盘 `FLOOR_SIZE_DEFAULT = 80`（远超房间），对角线 113m 会把整面墙的灰阶压平
- *    （09-26 实测横扫三个点亮度 222/223/224，等于没有渐变）。
- * ⚠️ 明暗曲线 = **线性**（`1 − d/D`，皇上旨 2026-09-27「要，改成线性渐变」）。09-26 那版 `pow(…, 2.2)` 的动机是
- *    「着色器里是线性色，不补感知伽马会中间偏亮」—— 代价实测更糟：6m 处灰阶只剩 0.22 ⇒ 渐变几乎全压在景点脚下，
- *    他数不出圆。线性后同一点 0.50 中灰，整间房的远近一眼读得出。
- * ⚠️ 强度**不沿用** `PANO_TINT_MIX` 而是自己的 `PANO_DIST_MIX = 1`（整块换成灰阶）：皇上要的是「近=白、远=黑」这张**距离图**本身，
- *    09-26 实测按 0.5 混 ⇒ 一面墙横扫过去只有 135→151（19 级）的差别，肉眼仍是「一片灰」；归属配色那条 0.5 的旨意针对的是
- *    「色叠加把照片盖住了」，与本图无关（要看照片本来颜色就把 `?panoDist` 关掉）。
- * ⚠️ 两道诊断**同时开**时本图后上色 ⇒ 明暗图盖住色相（要同时看归属与距离请分开截两张）。
- * ⚠️ 开关口径历经三版：① 初版「默认关、URL `?panoDist=1` 才开」⇒ 皇上第二天地址栏里只剩 `panoTint=1`，
- *      看到的又是实拍照片，误判「代码被改回去了」（09-26 实测线上包里 panoDist 一段俱在，纯为开关没跟上）。
- *    ② 皇上同日晚旨「继续改成 距离越近越白、越远越黑的模式」⇒ 改成**编辑器这一页默认开**：写法是在 renderer
- *      模块顶层调 `mktPanoDistEditorDefaultOn()` 翻全局开关。09-26 实测线上打印当场暴露它是**半张图**：
- *      「墙 / 地板 / 家具三份材质的片元着色器不是同一份」—— 立方体那份是 `static material = create…()`，
- *      在**模块求值期**就建好了，永远早于任何应用层模块体里的语句 ⇒ 墙/地板黑了白了，立方体仍是实拍。
- *    ③ 现行（本次定论）：**开关不再靠语句先后**，而是建材质时把这一份材质要不要这张图**显式说清楚**
- *      （融合工厂的 `panoDist` 选项）。⇒ 编辑器三处建材质点同传一个纯函数，预览/发布页不传 ⇒ 天然关。
- *    ④ 09-27 晚皇上旨「把颜色换成纹理，全景的纹理」⇒ 编辑器这一页翻回**默认关**（`mktPanoDistEditorOn()`
- *      = `panoDebugOn("panoDist")`），灰阶诊断按需 `?panoDist=1` 再看。口径机制不变，只翻默认值。
- *    ⛔ 不许再回到「模块顶层翻全局变量」那一路：那份 GLSL 是建材质时一次性拼出来的，谁先谁后取决于 import 顺序，
- *      改一次 import 就悄悄漏一面（且 `统一性检查` 会当场报不是同一份源码）。
- */
-const PANO_DIST_ON = panoDebugOn("panoDist");
-/**
- * 🔬 **编辑器这一页**该不该有近白远黑图：**默认关**（皇上旨 2026-09-27 晚「把颜色换成纹理，全景的纹理」——
- *      灰阶诊断盖住了真投影，默认让位给全景纹理；要看诊断图 URL 显式写 `panoDist=1`，`#` 前后都认）。
- * ⚠️ 这是个**纯查询**（不改任何全局状态）：应用层每建一份材质调一次，传进 `createMktFloorBlendShaderMaterial({ panoDist })`。
- *      ⛔ 不要图省事改成「调一次翻全局」—— 静态字段上的材质在模块求值期就建好了，翻不到它（见上面第 ② 版事故）。
- * ⚠️ URL 解析只留库侧这一处（与 `panoDebugOn` 同族口径），⛔ 应用层不许再各解一遍。
- */
-export function mktPanoDistEditorOn() {
-    return panoDebugOn("panoDist");
-}
-/**
- * 🔬 距离明暗图的**叠加强度**（0~1）：`mix(原画面色, 灰阶, 本值)`。取 **1 = 整块换成灰阶**（本图就是纯距离图），
- * ⛔ 不与归属配色的 `PANO_TINT_MIX`（0.5）共用 —— 共用那版实测一面墙只有 19 级亮度差，等于看不出渐变。
- * ⚠️ 拼进 GLSL 时必须走 `.toFixed(1)`：TS 里的 `1` 会被原样写成整数 `1` ⇒ **GLSL ES 报 `mix` 无匹配重载、整份片元编译失败**
- *    （09-26 踩过，画面直接空掉），着色器里任何浮点参数都得带小数点。
- */
-const PANO_DIST_MIX = 1;
-/**
- * 🔬 距离明暗诊断那一段 GLSL（**两份材质共用这一份**，与 `PANO_TINT_MIX` 同理：两处各写一遍必然分叉）。
- * `colorVar` = 最终颜色变量，`distExpr` = 这点到「最近那个全景点」的**水平**距离（米，与取图同口径）。
- * 判不到任何候选（场景里一个全景点都没有）时 `distExpr` ≥ 1e8 ⇒ 整段跳过，露本来颜色。
- * ⚠️ 曲线 = **线性**（皇上旨 2026-09-27「要，改成线性渐变」）：旧的 `pow(…, 2.2)` 实测把 6m 处压到灰阶 0.22
- *      ⇒ 「圆」只剩景点脚下一小块（09-26 他报「只能看到一个白色中心」的第二层原因）。线性后 6m = 0.50 中灰。
- *      ⚠️ 代价照实报：纯白（灰阶≥235）仍然只覆盖景点脚下 D×(1−235/255) ≈ **0.078×D** 的半径（尺子 12m ⇒ 0.94m），
- *      铺开的是**渐变**而不是白心本身。
- */
-function panoDistGlsl(colorVar, distExpr) {
-    return /* glsl */ `{
-            float distNear = ${distExpr};
-            if (distNear < 1e8) {
-                float distGray = 1.0 - clamp(distNear / max(uPanoDistMax, 0.001), 0.0, 1.0);
-                ${colorVar} = mix(${colorVar}, vec3(distGray), ${PANO_DIST_MIX.toFixed(1)});
-            }
-        }`;
-}
-/**
- * 🔬 距离明暗图的「求最近景点」那一段 —— **真循环**版（皇上旨 2026-09-27 晚「那就更不对了，我一开始的需求就是
- * 把 4 个全景点的坐标传给 shader，按最近取用」+ 看过代码后点头要这版）。
- * 语义与他原话逐字对齐：每个像素遍历 `uPanoPoints[0..N-1]`，只留最小水平距离。
- * ⚠️ 09-27 晚起取图与明暗图**同把尺**（皇上「取用距离最近的那个全景点的瓦片纹理」定版）：取图那条的夹角门
- *    已整链删除 ⇒ 两边都是「纯水平距离最近」，圆与图永远一致。⛔ 本函数只动颜色，不动取图。
- * ⚠️ 动态下标只碰普通 uniform 数组（`vec4[]`），不碰 sampler ⇒ ANGLE 那条「sampler 必须常量下标」的限制管不到这里。
- */
-function panoDistLoopGlsl(colorVar, maxPano) {
-    return /* glsl */ `{
-            float distNear = 1e9;
-            for (int i = 0; i < ${maxPano}; i++) {
-                vec4 p = uPanoPoints[i];
-                if (p.w > 0.5) distNear = min(distNear, distance(vProjPos.xz, p.xz));
-            }
-            if (distNear < 1e8) {
-                float distGray = 1.0 - clamp(distNear / max(uPanoDistMax, 0.001), 0.0, 1.0);
-                ${colorVar} = mix(${colorVar}, vec3(distGray), ${PANO_DIST_MIX.toFixed(1)});
-            }
-        }`;
-}
-/** 第 5~24 个景点的色板（sRGB 十六进制，两两可分辨）：**球色与墙面染色的色相同源**，勿在两处各写一份。
- *  前 20 个各一色、互不相同；第 21 个起重复末尾那 4 色（深色底 + 中间色，任意两色不撞）。 */
-const PANO_TINT_SEQ_HEX = [
-    0xff4747, 0x47ff47, 0x477bff, 0xffff47, 0xff47ff, 0x47ffff, 0xff8c1a, 0x8c1aff, 0x1aff8c, 0xff1a8c,
-    0x1a8cff, 0x8cff1a, 0xff47b4, 0x47ffb4, 0xb447ff, 0xb4ff47, 0xffb447, 0x47b4ff, 0x2acfff, 0xff477b,
-];
-/** 末尾 4 色（红/绿/蓝/黄）：景点数 > 20 时循环取用 */
-export const MKT_PANO_TINT_HEX = [0xff4747, 0x47e05a, 0x5a8cff, 0xffe14a];
-/** 「第 i 个**景点**」的诊断色（按景点序号，不是槽位）：0~19 各一色，>=20 循环末尾 4 色 */
-export function panoTintHex(i) {
-    const n = Number.isFinite(i) && i >= 0 ? Math.floor(i) : 0;
-    return n < PANO_TINT_SEQ_HEX.length ? PANO_TINT_SEQ_HEX[n] : MKT_PANO_TINT_HEX[n % MKT_PANO_TINT_HEX.length];
-}
-/** 景点诊断色的**线性空间**分量（three 的 Color 按 sRGB 输入即转线性）⇒ 写进着色器与球色都走这一个口径 */
-function panoTintLinear(i) {
-    const c = new Color().setHex(panoTintHex(i), SRGBColorSpace);
-    return [c.r, c.g, c.b];
-}
-/**
- * 写入诊断色 uniform（**仅 `?panoTint=1` 时这些 uniform 才存在**，关态本函数直接空转 ⇒ 线上零开销）。
- *
- * 为什么色相改走 uniform、不再编译期按槽位写死（皇上旨 2026-09-25「每个全景点的叠加色都是红色，我想要让他们的颜色不一样」）：
- *   槽位不等于景点。融合材质下「第 i 槽 = 第 i 个点」（09-25 去相机化定论）时才恰好相等，
- *   而「仅映射选中的那一个」模式下地板永远只喂**选中那一张到 0 号槽** ⇒ 按槽写死 = 无论选第几个点都涂红，
- *   且那个模式下的墙/家具是另一份单全景材质（压根没有染色段）⇒ 墙一点色都没有。两处同一个错。
- * 故应用层在**每次往某个槽写全景时**顺手写「这个槽里躺的是第几个景点」的颜色：
- *   - 融合材质：`uPanoTintColors[slot]`（vec3 数组）
- *   - 单全景材质：`uPanoTint`（vec3，整面恒为选中的那一个，slot 恒 0）
- * 材质没有这些 uniform（关态 / 旧材质 / 误传）时静默跳过，不抛错。
- */
-export function setMktPanoTint(material, index, slot = 0) {
-    if (!PANO_TINT_ON || !material || !material.uniforms)
-        return;
-    const [r, g, b] = panoTintLinear(index);
-    const arr = material.uniforms.uPanoTintColors?.value;
-    if (arr && arr.length > slot && arr[slot] && typeof arr[slot].set === "function") {
-        arr[slot].set(r, g, b);
-        return;
-    }
-    const v = material.uniforms.uPanoTint?.value;
-    if (v && typeof v.set === "function")
-        v.set(r, g, b);
-}
-/**
- * 写入距离明暗诊断图的**黑端距离**（米）：材质上没有这根 uniform（那份材质建时就没开这张图 / 误传）时静默跳过。
- * ⚠️ 判据只看**材质自己有没有** `uPanoDistMax`，⛔ 不再读全局 `PANO_DIST_ON`：编辑器那三份材质是显式传 `panoDist`
- *      建出来的（全局开关可能仍是关 —— 发布页/预览走的就是全局），拿全局判会把编辑器该喂的尺子饿掉。
- * 传的是「多远算全黑」= 全局一把尺（应用层现场量），⛔ 不要按「每个槽各自」给 —— 跨面可比才读得出远近。
- */
-export function setMktPanoDistRange(material, meters) {
-    if (!material || !material.uniforms)
-        return;
-    const u = material.uniforms.uPanoDistMax;
-    if (u && Number.isFinite(meters) && meters > 0)
-        u.value = meters;
-}
-/**
- * 写入距离明暗诊断图的**圆心清单**（皇上旨 2026-09-27「shader 里面有四个全景点的坐标, 每个像素点都判断距离 4 个全景点
- * 的距离中最小的那个值, 然后用这个值来设置颜色」）：一条 = 一个全景点的世界矩阵（只取平移列），空位传 null。
- * ⛔ 不要拿 `weights` 当这份清单：`weights[i]` 说的是「第 i 格的**瓦片绑好了没**」（没绑好给 0 是防止拿 1×1 占位图
- *      刷一片素灰，09-25 线上抓到的病灶），而本数组说的是「第 i 格**有没有一个点**」。
- *      两者在「景点已放置、图还在下载」那段时间里就是不一样 ⇒ 明暗图按点数画圆，取图仍按绑好的那几张。
- * ⚠️ 材质上没有这根 uniform（那份材质建时没开这张图 / 误传）时静默跳过，与 `setMktPanoDistRange` 同口径。
- */
-export function setMktPanoPoints(material, matrices) {
-    if (!material || !material.uniforms)
-        return;
-    const u = material.uniforms.uPanoPoints?.value;
-    if (!Array.isArray(u))
-        return;
-    for (let i = 0; i < u.length; i++) {
-        const m = matrices[i];
-        const e = m?.elements;
-        if (!e) {
-            u[i].set(0, 0, 0, 0);
-            continue;
-        }
-        const x = e[12];
-        const y = e[13];
-        const z = e[14];
-        u[i].set(x, y, z, Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(z) ? 1 : 0);
-    }
-}
-/**
- * 🎛️ 全景上下方向 = **口径写死：等距柱状线性 v + 不交换 + 不翻转**（2026-09-22 皇上定论）。
- *
- *    皇上验收「不交换 / 不翻转」那态后口谕：「完全正确，就按照这样的方式写死在代码里面，
- *    后续也不用再通过参数来调整了」⇒ 三个方向 uniform（`uPanoSwapRow` 上下交换 /
- *    `uPanoFlipTile` 上下翻转 / `uPanoVertOff` 垂直偏移）连同 `setMktPanoDims`、
- *    store 三字段与其 setter、序列化、四处材质广播、预览 `setPanoDims`、面板两个 Select
- *    **整条链路一并删除**（不是「留着不用」——半截链路最容易在日后被误接回去）。
- *    ⚠️ 若真要再参数化：从 git 找回这一条完整链路，**别在半路上重新发明一遍**
- *    —— 历次「调了没反应」有一半就是重复实现导致两处口径分叉。
- *    ⚠️ 唯一**保留**的是 `uPanoTiled`（见下 🧩 段）：它不是可调参数，而是「这几个槽装的是拼合槽纹理
- *    还是一张整图」的**数据形状判定**，删了就退回「把整图的一块拉伸铺满球面」（10-06 晚起是 1/2 拉伸）。
- *
- *    为什么这里值这么多注释（三轮参数化 + 一次撤除，皇上从 09-21 调到现在）—— 历次失败的**真正根因**：
- *      ① **v 映射口径与切片口径不一致** —— 切片是把原图**线性等分**（等距柱状图：像素行 ∝ 纬度；当时 2×2，
- *        2026-10-06 起 8×8、当夜再改 8×4 ⇒ 「线性」这条结论与切片数无关），着色器却按**墨卡托** `log(tan(45+lat/2))` 算 v。
- *        赤道处恰好相等，越偏离越错：
- *        墙面仰角 +10° 采到原图 +5.0°（**线性口径下应恒等于 +10°**）、−45°（地板）采到 −25.2°。
- *        **这个偏差是连续的 ⇒ 任何离散档位组合都凑不回来**，所以「四档全试遍仍不合预期」。
- *        ⇒ 结论只有一条：**v 必须线性于纬度**（`0.5 + lat/PI`），这一条已写死，别再改回墨卡托。
- *      ② 两档开关在**错口径下**几乎不可能调对 —— 旧墨卡托 v 把它们和口径误差叠在一起：
- *        lat+10° 在四态下分别显示原图 +5.0° / **−85.0°** / −5.0° / **+85.0°**（后两态=三脚架与天花板正中）。
- *        09-22 一度把口径修正后的两档按原语义恢复上面板（皇上当时明确要「上下交换 + 上下翻转」两个开关，
- *        臣此前自作主张删控件换连续「垂直偏移」属越权改需求），**修好口径后皇上验收第一档即正确**，遂改判写死。
- *      ③ **「上下翻转」在错口径下必然看起来没反应** —— 墙面只覆盖贴赤道约 9% 高度的窄带，
- *        而 `v = 1 - v` 是**关于赤道镜像这条窄带自身**，翻完仍落在同一条带里，
- *        净效果仅「±5° 对调」≈ 画面几乎不动。
- *
- * 🧩 **第二个根因（与方向参数无关，故本次写死后依然保留）**：
- *    默认场景与旧存档的 `textures[].tiles` **只有 1 条地址**（当年上传切片功能之后才有的字段），
- *    喂料处回退成「各槽同为 `url`」（10-06 晚起是 2 槽：`[url, url]`）⇒ **各 sampler 装的是同一张完整等距柱状图**。于是：
- *      ① 各槽同图 ⇒ 选哪一格都一样（当时看到的「交换零效果」症状，写死后该症状无从出现）；
- *      ② 更要命的是仍按「瓦片内 UV」`localU/localV` 去采整图 ⇒ 整图被按 1/2 拉伸铺满整个球面（旧版是 1/4）：
- *        墙面仰角 +10° 采到原图 **−70°（脚底/三脚架）** —— 这才是「全景映射在模型上的位置不太对」的另一半，
- *        且它是**结构性**错，比 ① 的墨卡托连续偏差更严重（臣前几轮只修了墨卡托那一半，所以皇上仍觉得不对）。
- *    修法 = `uPanoTiled`（单全景标量 / 融合每点数组）：0 时把瓦片内 UV **还原成整图 UV**
- *      `panoU = u`、`panoV = v`（口径写死后这就是恒等式：横向 `0.5(2u)=u` / `0.5+0.5(2u−1)=u`；
- *      纵向 10-06 晚起 localV 本就等于 v ⇒ 两个方向都退化成恒等式）。
- *    ⚠️ 判据与回退式**必须同源**（`mktPanoTiledFlag` = 「tiled 形态 且 tiles 有任意 1~32 条」，10-06 晚旨只支持 8×4=32 张、不足涂灰），且每个回退喂料点都要写标记，
- *       漏一处该对象就悄悄退回 1/2 拉伸。默认值取 1（已切片的真实上传数据行为不变）。
- *       护栏：`test/panoVMapping.test.js`。
- *    🔄 2026-09-22 追加（皇上口谕）：本标记现由**用户可选的「全景纹理形态」`PanoTexMode`**（tiled/whole）与数据
- *       形状共同决定 —— 见下方 `PanoTexMode` / `mktPanoTexUrls` / `mktPanoTiledFlag` 三者的说明。
- *       喂地址与写标记**必须走同一形态参数**，这是本段唯一的铁律。
- *
- * ⛔ **血案铁律（2026-09-21 10:39，方向参数删了它也照样成立；⭐ 2026-10-06 晚起**已作废**，仅存档）**：
- *    旧口径（2×2 / 8×8 四槽）下 `tileRow` 必须**随取样用的 v 现算**（上半球取上排、下半球取下排），
- *    绝不能塌缩成「与 v 无关的单一常量」—— 那样上下半球会取到同一排（天顶与天底同一张图），画面崩坏。
- *    ⚠️ **作废说明**：10-06 晚皇上旨「每个全景纹理由**左右 2 个 RT** 组成、原图只切 8×4=32 片」
- *    ⇒ 竖着**不再分块**，一个槽就装下上下 180°，`tileRow` 这个变量**已整条删除**。
- *    ⛔ 谁把它加回来 = 又变回 4 槽，而 sampler 只有 2 个 ⇒ 读到未定义的槽；加回来前先答「第 3、4 张槽从哪来」。
- *
- * ⚠️ 历史教训（2026-09-21 线上曾报 GLSL 编译错）：曾用 `(${ROW_COND} == 1) ? 1 : 0` 内联表达式，
- *    因 GLSL/C 里 `==` 优先级高于 `?:`，拼接后被解析为 `(v>=0.5) ? 1 : (0==1)` ⇒ int 与 bool 不匹配
- *    ⇒ 整个片元着色器编译失败（画面全黑）。**故模板里只允许纯字面量，任何运算都在 JS 侧算完。**
- */
-const vertexShader = /* glsl */ `
-    // common 提供 isPerspectiveMatrix 等辅助函数，logdepthbuf_vertex 依赖它
-    #include <common>
-    // 对数深度缓冲：ThreeBase 的 WebGLRenderer 开启了 logarithmicDepthBuffer，
-    // 内置材质自动注入，但自定义 ShaderMaterial 不会，必须手动 include，
-    // 否则 MktMesh 的深度与场景其他物体不一致，会被深度测试整块丢弃（表现为不显示但无编译报错）。
-    #include <logdepthbuf_pars_vertex>
-
-    // 投影空间逆矩阵：把墙顶点从「世界坐标」拉回「与 MktMesh 整体变换无关的几何局部坐标」。
-    // ⚠️ 需求铁律（皇上旨 2026-09-19）：「墙的矩阵和全景的矩阵是相对的，无论 MktMesh 整体怎么
-    //    移动/旋转/缩放，墙上的纹理都保持不变」。textureMatrix 是世界矩阵、不随 MktMesh 动，
-    //    故墙顶点也必须摆脱 modelMatrix 的影响 —— 乘上 inverse(matrixWorld) 正好抵消。
-    //    默认**单位阵**（= 直接用世界坐标，行为与改造前逐字节一致），只由 MktMesh / MktDevMesh
-    //    自己按 matrixWorld 写入；故编辑器地板 / 立方体、预览立方体这些「与 MktMesh 各自独立」
-    //    的网格完全不受影响。
-    uniform mat4 uProjInvMatrix;
-
-    varying vec3 vProjPos;
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-
-    void main() {
-        // 模型/实例局部坐标：普通 Mesh（墙/地板）无实例矩阵；InstancedMesh（家具立方体）额外乘 instanceMatrix。
-        // 与融合着色器同理，靠 three.js 自动注入的 USE_INSTANCING 宏在一份代码里同时服务两类网格。
-        #ifdef USE_INSTANCING
-            mat4 im = instanceMatrix;
-        #else
-            mat4 im = mat4(1.0);
-        #endif
-        vec4 modelPos = im * vec4(position, 1.0);
-        // 取样坐标：先按 modelMatrix 升到世界坐标，再乘 uProjInvMatrix 抵消掉 MktMesh 的整体变换。
-        // 对 MktMesh / MktDevMesh 自身，uProjInvMatrix = inverse(matrixWorld)，两者相消 => 只剩几何局部坐标，
-        // 于是 MktMesh 整体怎么变换，取样方向都不变（纹理稳稳贴在墙上）。
-        vProjPos = (uProjInvMatrix * modelMatrix * modelPos).xyz;
-
-        #ifdef USE_INSTANCING_COLOR
-            vInstanceColor = instanceColor;
-        #endif
-
-        gl_Position = projectionMatrix * modelViewMatrix * modelPos;
-
-        #include <logdepthbuf_vertex>
+/*
+ * @Author: xiaosihan
+ * @Date: 2026-08-25
+ * @Description: MktMesh（墨卡托模型）的自定义 ShaderMaterial。
+ *
+ * 思路（与脚手架 render3DGoods 的 panoramaMercatorMaterial 同源）：
+ *  1. 顶点着色器：vProjPos = uProjInvMatrix * modelMatrix * im * position。
+ *     墙体几何在构建时已把点位写入世界坐标、MktMesh 自身保持单位变换，故无需实例矩阵；
+ *     纹理朝向的旋转由片元着色器乘 mat3(textureMatrix)（纹理矩阵左上 3x3 旋转分量）完成。
+ *     ⚠️ **取样方向的两个操作数，必须都对 MktMesh 的整体变换免疫**（皇上旨 2026-09-19）：
+ *     textureMatrix 是**世界矩阵**（见下方片元 uniform 注释），属独立于 MktMesh 的外部数据，
+ *     本来就不随 MktMesh 移动/旋转/缩放；而墙顶点经 modelMatrix 升到世界坐标，**会**跟着变 ——
+ *     一个动、一个不动，方向就变了 => **墙上的纹理跟着滑动**（皇上报的正是此症）。
+ *     故引入 uProjInvMatrix（默认单位阵）：MktMesh 自己写 inverse(matrixWorld)，把墙顶点也**拉回
+ *     与整体变换无关的几何局部坐标**，两个操作数于是双双免疫 => 方向恒定 => 纹理稳稳贴在墙上。
+ *     其余网格（编辑器地板/立方体、预览立方体）保持单位阵 => 行为与改造前逐字节一致。
+ *     ⚠️ 注意 M ≠ I 时 vProjPos（局部）与 textureMatrix（世界）并不在同一空间 —— 这是**刻意**的：
+ *        皇上要的是「纹理贴在墙上不动」，达成条件就是「两个操作数都不随 M 变」，而非「同处一空间」。
+ *        千万别"好心"再去把 textureMatrix 也乘一遍 inverse(matrixWorld)，那会让纹理重新动起来。
+ *  2. 片元着色器：方向向量 dir = normalize(vProjPos - 纹理矩阵位置)，即「以纹理矩阵的位置为投影中心」；
+ *     再乘纹理矩阵的旋转分量（mat3(textureMatrix)），得到纹理局部方向；
+ *     最后按**等距柱状**（equirectangular）把方向换算成全景纹理 UV 采样。
+ *     ⚠️ 类名叫 MktMesh（墨卡托）是历史包袱，**取样口径不是墨卡托**：全景图是等距柱状图、
+ *     像素行正比于纬度，故 v 必须线性于 lat（理由见片元着色器 v 换算处的说明）。
+ *  3. 色彩空间 = **只有一条路**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
+ *     全景纹理（瓦片 / 整图 / 拼合槽 RT）一律标 `colorSpace = SRGBColorSpace` ⇒ WebGL2 按 SRGB8_ALPHA8 上传，
+ *     `texture2D` 时**硬件已经做过一次 sRGB→linear 解码**，片元直接把采样值当线性值用、**不再手动 pow 解码**。
+ *     原 `uColorSpace` uniform + 那段内联 pow 分支（sRGB/Linear 两档）已整条撤除 ⇒ 两遍都解 = 二次解码压暗。
+ *     toneMapped=false 跳过 Reinhard；末端 <colorspace_fragment> / 终处理只编码一次 ⇒ 一进一出，与源图逐字节还原。
+ *
+ * 兼容注意：为兼容 Windows / ANGLE 的 GLSL 编译器，本文件刻意不使用全局 const 常量与自定义函数，
+ * 所有常量均以字面量内联书写；ShaderMaterial 为 GLSL ES 1.00，用 texture2D / gl_FragColor。
+ */
+import { Color, DataTexture, DoubleSide, Matrix4, ShaderMaterial, SRGBColorSpace, Vector3, Vector4 } from "three";
+/**
+ * 🔬 瓦片象限诊断开关（2026-09-21）。
+ * 背景：皇上为「全景 2×2 瓦片上下方向」连调六轮，当时把「位置」与「块内朝向」绑在一起调
+ * （tileRow 随 v 动），2×2=4 种组合**四档全试过仍不合预期** ⇒ 病灶必不在开关取值内，
+ * 继续靠「交换 / 翻转 / 颠倒」这类语义词猜测只会无限循环，故改用**可视化归因**。
+ *
+ * ✅ **后续定论（2026-09-22 写死）**：四档轮转当时调不动，根因不在开关取值，而在**基础 v 映射口径**
+ *    （切片线性、取样墨卡托，见下方 🎛️ 段 ①）—— 口径错配是**连续**偏差，任何离散档位都凑不回来。
+ *    现口径已统一为等距柱状线性，皇上验收「不交换 / 不翻转」那态即正确 ⇒ **方向参数整条撤除、写死**
+ *    （见 🎛️ 段）。本诊断开关保留，用于日后再次核对「哪块瓦片落在哪个象限」。
+ *
+ * 用法：页面 URL 带 `?panoTileDebug=1` 时，两张槽纹理**不再采样纹理**，各自输出一个纯色 ——
+ *      ⭐ 10-06 晚起只有左右两槽（竖着不再分块）：红=左半幅(槽0)  绿=右半幅(槽1)
+ *      （旧 4 象限版是 红=tiles[0] 绿=tiles[1] 蓝=tiles[2] 黄=tiles[3]，已随四槽一并作废）
+ * 皇上只要说出「画面上下左右各是什么颜色」，即可一次反推出真实映射。
+ *
+ * ⚠️ 以**字面量 0.0/1.0** 内联进 GLSL：正常态整段被编译器消除，线上正常路径零开销、零行为差异。
+ */
+/**
+ * 诊断开关取值：URL 的 `?name=1` —— ⚠️ **search 与 hash 两处都认**。
+ * 皇上的地址长这样：`https://www.3dkeshihua.com/three-base/#/mktMeshEdit?nocache=xxx`，
+ * 查询串挂在 `#` **后面**（那是路由的 hash，`location.search` 是空串）⇒ 只查 search 的话开关永远按不下去。
+ */
+function panoDebugOn(name) {
+    try {
+        if (typeof location === "undefined")
+            return false;
+        const re = new RegExp(`[?&]${name}=1\\b`);
+        return re.test(location.search || "") || re.test(location.hash || "");
     }
-`;
-/**
- * 多全景地面融合着色器的顶点着色器（**地板 / 墙体 / 立方体 三者共用同一份**）。
- * three.js 渲染 InstancedMesh 时会自动定义 USE_INSTANCING 宏并注入 instanceMatrix / instanceColor，
- * 同一份代码因此同时服务两类网格：
- *  - 普通 Mesh（墙/地板）：无实例矩阵，im 退化为单位阵；
- *  - InstancedMesh（家具立方体，InstancedChild 合批）：im = instanceMatrix，各实例世界变换在其中。
- * 故「地板/墙体/立方体」共用这一个着色器，无需为立方体另写实例化版（消除原先的 instanced 分支）。
- * instanceColor（逐实例染色，选中高亮）同样用 USE_INSTANCING_COLOR 宏在顶点→片段间传递。
- */
-// ⭐ 下面这一组「切片 / 拼合槽」几何常量**必须排在 `fragmentShader` 之前**：单全景那份片元是模块级
-// 常量字符串，里面要用 `${RT_STITCH_SLOT_COUNT}` 声明 sampler 数组长度（TS 的块级作用域禁止先用后声明）。
-/** ⭐ 32 瓦片拼合（2026-10-06 晚皇上旨：一张全景切 **横 8 × 竖 4 = 32 片**，每 **4×4 = 16 片**离屏拼成
- *  1 张 **4096×4096 正方形**槽纹理，**左右 2 槽**组成完整全景；上一版是同日早些时候的 8×8 = 64 片 / 4 槽
- *  2×2 象限，再上一版是 09-29 旨的 4×4 = 16 片）的「槽虚拟地址」前缀。
- *  虚拟键不是真 URL，纹理由 `PanoTileStitcher` 用 shader 逐格画进 `WebGLRenderTarget` 提供，
- *  消费方（基类 `_ensurePanoTiles` / 编辑器 `_peekTileAt`）见前缀即走拼合器，⛔ 不得当 URL 下载。
- *  ⚠️ 键协议 `rt:<batch>#<slot>` 与 `uPanoTiled` 这套对外接口**一字未改** —— 变的只有「每批几条地址」
- *  和「槽怎么分」；`slot` 的取值范围从 0..3 缩到 0..1，消费方一律用 `RT_STITCH_SLOT_COUNT` 取，不许写死。
- *  ⚠️ 旧存档不兼容（皇上 2026-10-06 拍板）：存档里 64 条瓦片地址会因张数超限被判废 ⇒ **老项目需重新上传**。 */
-export const RT_STITCH_KEY_PREFIX = "rt:";
-/** 原图**横向**（经度方向 u）切几片（旨「横 8」） */
-export const RT_STITCH_COLS = 8;
-/** 原图**纵向**（纬度方向 v）切几片（旨「竖 4」）⇒ 竖着不再分块，一个 RT 就装下整幅的上下 180° */
-export const RT_STITCH_ROWS = 4;
-/** 一个批次（= 一个全景点）的瓦片总数 = 8 × 4 = 32；`tiles` 存档数组的硬上限 */
-export const RT_STITCH_TILES_PER_BATCH = RT_STITCH_COLS * RT_STITCH_ROWS;
-/** 一个拼合槽每边几格（旨「每个 RT 由 16 个全景瓦片组成」⇒ 4×4 = 16）*/
-export const RT_STITCH_SLOT_GRID = 4;
-/** 一个拼合槽的格数 = 4² = 16（画满 16 格 = 这一槽齐活） */
-export const RT_STITCH_CELLS_PER_SLOT = RT_STITCH_SLOT_GRID * RT_STITCH_SLOT_GRID;
-/** 拼合槽个数 = **左右 2 槽**（旨「每个全景纹理由左右 2 个 RT 组成」）⇒ 一个全景点只占 **2 个 sampler**。
- *  ⛔ 别以为 32 片就要 32 个 sampler：皇上本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16 = 2 槽 × 8 景点，
- *  这一条是硬顶，也是「必须拼进 RT」而不是「直接喂瓦片」的根本原因。
- *  ⭐ 分块口径：槽 0 = **左半幅**（列 0-3、行 0-3）、槽 1 = **右半幅**（列 4-7、行 0-3），
- *    即「只按 u 分左右，v 不再分上下」⇒ 每槽覆盖 **横向 180° × 纵向 180°**，是原图左/右半个**正方形**
- *    ⇒ 槽纹理必须跟着变正方形（见下 `RT_STITCH_SLOT_W/H`），否则纵向被压 2 倍。 */
-export const RT_STITCH_SLOT_COUNT = 2;
-/** 单槽像素尺寸 **4096×4096 正方形**（皇上 2026-10-06 拍板保画质）：2 槽 = 有效分辨率 8192×4096。
- *  ⚠️ 为什么必须变正方形：每槽覆盖的原图区域从「横 180° × 竖 90°（2:1）」变成「横 180° × 竖 180°（1:1）」，
- *     RT 若仍是 4096×2048 ⇒ 纵向缩放比是横向的 2 倍、**纵向分辨率腰斩**，直接踩「不降质」红线。
- *  每格 = 1024×1024；一片瓦片的原图边长 = 横 W/8、竖 H/4 ⇒ 横向缩放比 = (W/8)/1024 = 1.4533（11904 宽原图），
- *  与 64 片那一版**逐字相同** ⇒ 本次改版**不涨也不降画质**；变的是同屏全景数 4 → 8、
- *  单全景下载片数 64 → 32（减半）、单全景 RT 显存 128MB（不变，只是从 4 张 32MB 变 2 张 64MB）。
- *  ⚠️ 红线（「千万不要降低质量」）：这两个数与「原图切几片」无关，⛔ 不许当成省显存的旋钮去缩。 */
-export const RT_STITCH_SLOT_W = 4096;
-export const RT_STITCH_SLOT_H = 4096;
-export const floorVertexShader = /* glsl */ `
-    #include <common>
-    #include <logdepthbuf_pars_vertex>
-
-    // 投影空间逆矩阵：见单全景顶点着色器处的同一段说明（皇上旨 2026-09-19）。
-    // 默认保持单位阵（地板 / 立方体行为与改造前完全一致）；编辑器墙（MktDevMesh）与发布态 MktMesh
-    // 一样每帧写入 inverse(matrixWorld)，故墙上的纹理同样不随整体变换漂移。
-    uniform mat4 uProjInvMatrix;
-
-    // 全景序号映射模式：本三角面归属的全局全景序号（来自 geometry 的 aPanoIndex；无此 attribute 的对象恒为 0，仅 mode=1 时读取）
-    attribute float aPanoIndex;
-    varying float vPanoIndex;
-
-    varying vec3 vProjPos;
-    // 取图「正面夹角」判据用（皇上旨 2026-09-27 深夜）：几何法线，变换到与 vProjPos **同一空间**
-    // （uProjInvMatrix * modelMatrix * instanceMatrix 的旋转部分），片元里与「点→全景」向量点积算夹角。
-    // ⛔ normal 是 three.js 自动注入的标准 attribute（墙=computeVertexNormals 逐面法线 / 封盖=ShapeGeometry /
-    //    地板=PlaneGeometry / 家具=BoxGeometry），此处无需自己声明。
-    varying vec3 vWNormal;
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-
-    void main() {
-        // 实例矩阵：InstancedMesh 自动定义 USE_INSTANCING 并提供 instanceMatrix；
-        // 普通 Mesh（墙/地板）无实例矩阵，退化为单位阵 —— 一份着色器同时服务墙/地板/立方体。
-        #ifdef USE_INSTANCING
-            mat4 im = instanceMatrix;
-        #else
-            mat4 im = mat4(1.0);
-        #endif
-        // 模型/实例局部坐标；立方体实例的变换在 instanceMatrix，墙/地板在 modelMatrix
-        vec4 modelPos = im * vec4(position, 1.0);
-        vProjPos = (uProjInvMatrix * modelMatrix * modelPos).xyz;
-        // 法线与 vProjPos 走同一条矩阵链（mat3 取旋转/缩放部分，片元里 normalize 抵消缩放）
-        vWNormal = mat3(uProjInvMatrix * modelMatrix * im) * normal;
-        // 全景序号映射模式：把本三角面的归属序号传给片元（geometry 无 aPanoIndex 的对象恒为 0，仅 mode=1 时读取）
-        vPanoIndex = aPanoIndex;
-
-        #ifdef USE_INSTANCING_COLOR
-            vInstanceColor = instanceColor;
-        #endif
-
-        gl_Position = projectionMatrix * modelViewMatrix * modelPos;
-
-        #include <logdepthbuf_vertex>
+    catch {
+        return false;
     }
-`;
-const fragmentShader = /* glsl */ `
-    // 对数深度缓冲（与顶点着色器配套，保证 MktMesh 深度与场景一致）
-    #include <logdepthbuf_pars_fragment>
-
-    // 一个全景点 = 2 张**拼合槽纹理**（原图切 8×4=32 片，每 4×4=16 片拼成一张槽，10-06 晚皇上旨）。
-    // panoramas[0..1] = [左半幅, 右半幅] 两个 RT；片元按全景 UV 的 **u** 挑对应槽采样（v 不再分块）。
-    // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组，故槽选择用「常量下标 if 链」（tileIdx 命中的分支内 sampler 下标为字面量）。
-    uniform sampler2D panoramas[${RT_STITCH_SLOT_COUNT}];
-    uniform mat4 textureMatrix; // 纹理世界矩阵：位置(第4列 xyz)=投影中心，旋转(左上3x3)=纹理朝向
-    uniform float uPanoramaVisible; // 全景投射显隐：1=显示全景，0=仅显示中性素色（编辑态切换/投射显隐开关用）
-    // 色彩空间**只有一条路**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
-    // 原 uniform float uColorSpace; + 片元里那段 sRGB→linear 的 pow 分支已整条撤除，勿加回（原因见下方采样处）。
-    // 全景上下方向**已写死**（等距柱状线性 v + 不交换 + 不翻转，2026-09-22 皇上定论，理由见文件头 🎛️ 段）：
-    // 曾有 uPanoSwapRow / uPanoFlipTile / uPanoVertOff 三个可调 uniform，现已整条撤除，勿加回。
-    // ⚠️ uPanoTiled = panoramas[0..1] 装的是「拼合好的左右两张槽纹理」(1) 还是「同一张完整等距柱状图」(0)。
-    //   由「用户选的纹理形态 PanoTexMode + 该点有没有切过片」共同决定（见下方 mktPanoTiledFlag）。
-    //   0 时必须改用**全图 UV** 取样：拿瓦片内的 localU/localV 去采整图 = 把整图的左半幅拉伸到整个
-    //   球面（墙面仰角 +10° 采到原图 −70° 的地板）—— 2026-09-22「全景位置不对」的第二真因，见文件头 🧩 段。
-    uniform float uPanoTiled;${PANO_TINT_ON ? `
-    // 🔬 归属诊断色（仅 ?panoTint=1 时存在）：本材质当前投的就是「选中的那一个」全景，
-    //    故由应用层把**那个景点**的固定色写进来（见 setMktPanoTint）⇒ 墙面/立方体上的色与球色同相。
-    uniform vec3 uPanoTint;` : ""}${PANO_DIST_ON ? `
-    // 🔬 距离明暗诊断（仅 ?panoDist=1 时存在）：「多远算全黑」的米数，由应用层写（见 setMktPanoDistRange）
-    uniform float uPanoDistMax;` : ""}
-
-    // 取样坐标（已由顶点着色器的 uProjInvMatrix 抵消掉 MktMesh 的整体变换，与 textureMatrix 一样对变换免疫）
-    varying vec3 vProjPos;
-    // 实例染色（仅 InstancedMesh 带 instanceColor 时启用）：默认白=全景真实色，选中黄=高亮染色
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-
-    void main() {
-        // 投影中心 = 纹理矩阵的位置
-        vec3 texPos = textureMatrix[3].xyz;
-        // 纹理朝向 = 纹理矩阵的旋转分量（mat4 -> mat3 取左上 3x3）
-        mat3 texRot = mat3(textureMatrix);
-
-        // 从纹理位置指向该片元的方向向量（即「以纹理矩阵位置为中心」）。
-        vec3 dir = normalize(vProjPos - texPos);
-        dir = texRot * dir;
-
-        // 经度 [-PI, PI] -> u ∈ [0,1]
-        float lon = atan(dir.z, dir.x);
-        float u = lon * 0.15915494309189535 + 0.5; // 1/(2*PI)
-
-        // 纬度 [-PI/2, PI/2]。⚠️ **等距柱状（equirectangular）口径**：全景图的像素行正比于纬度，
-        // 故 v 必须**线性于 lat**，±90° 落在 1/0（线性在极点不发散，因此不需要截断纬度）。
-        // 此处曾按墨卡托 log(tan(45+lat/2)) 换算 —— 与切片口径不一致，导致墙面仰角 +10° 只采到
-        // 原图 +5.0°、且越偏离赤道偏得越多。这才是「全景映射位置不对」的根因（2026-09-22 定位后写死）。
-        float lat = asin(clamp(dir.y, -1.0, 1.0));
-        float v = 0.5 + lat * 0.3183098861837907; // 1/PI
-
-        // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
-        // ⭐ 2026-10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」：**竖着不再分块** ⇒ 槽只随 **u** 走，
-        //    v 方向一槽装下整幅上下 180°（这也是槽纹理必须改成 4096² 正方形的原因，见 RT_STITCH_SLOT_W/H）。
-        // ⛔ 别把 tileRow 加回来：加回来 = 又变成 2×2 四槽，而 sampler 只有 2 个 ⇒ 读到未定义的槽。
-        int tileIdx = (u >= 0.5) ? 1 : 0;
-        // 槽内局部 UV（连续、无 fract 边界跳变）：横向按左右减半；
-        // ⛔ 纵向**不再减半**（槽就是全高）⇒ localV 恒等于 v。写成 2v / 2v-1 = 纵向分辨率白丢一半。
-        float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
-        float localV = v;
-
-        // 🧩 uPanoTiled == 0（两槽装的是**同一张完整等距柱状图**，没有拼合槽）：
-        //    必须还原成**全图 UV** 再采样，也就是直接用 (u, v) ——
-        //    横向还原式 (半==左 ? 0.0 : 0.5) + 0.5*localU 代入 localU 后恒等于 u；纵向 localV 本就等于 v，
-        //    **两个方向都退化成恒等式**（方向已写死：无交换、无翻转、无偏移）。
-        //    ⛔ 切勿删掉本分支图省事：直接拿 localU/localV 去采整图 = 把整图的左半幅铺满整个球面。
-        float panoU = (uPanoTiled > 0.5) ? localU : u;
-        float panoV = (uPanoTiled > 0.5) ? localV : v;
-
-        // 🔬 诊断直通（见文件头 TILE_DEBUG_GLSL 说明；正常态内联为 0.0，整段被编译器消除）
-        if (${TILE_DEBUG_GLSL} > 0.5) {
-            vec3 dbgCol;
-            if (tileIdx == 0) dbgCol = vec3(1.0, 0.0, 0.0);      // 红 = 左半幅槽 0
-            else dbgCol = vec3(0.0, 1.0, 0.0);                   // 绿 = 右半幅槽 1
-            gl_FragColor = vec4(dbgCol, 1.0);
-            #include <colorspace_fragment>
-            #include <logdepthbuf_fragment>
-            return;
-        }
-
-        // ⭐ 采样出来的**已经是线性值**：全景纹理（瓦片 / 整图 / 拼合槽 RT）一律标 colorSpace = SRGBColorSpace
-        //    ⇒ WebGL2 按 SRGB8_ALPHA8 上传，texture2D 时硬件已做过一次 sRGB→linear 解码。
-        //    这里因此**不再手动解码**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
-        //    末端的 <colorspace_fragment> / 终处理再编码一次 ⇒ 一进一出，屏幕上与源图逐字节还原。
-        //    ⛔ 别加回那段 pow()：它在硬件已解码之上再解一遍 = 二次解码压暗（中灰 #808080 掉到 #373737、#333333 掉到 #080808）。
-        vec3 projCol;
-        if (tileIdx == 0) projCol = texture2D(panoramas[0], vec2(panoU, panoV)).rgb;
-        else projCol = texture2D(panoramas[1], vec2(panoU, panoV)).rgb;
-
-        // 全景投射显隐：关闭时（仅墙体/地板，回落中性素色，不投射全景）；默认 1 完全显示
-        if (uPanoramaVisible < 0.5) {
-            projCol = vec3(0.78, 0.78, 0.80);
+}
+const TILE_DEBUG_GLSL = panoDebugOn("panoTileDebug") ? "1.0" : "0.0";
+/**
+ * 🔬 归属诊断配色（皇上旨 2026-09-25「你为每个全景球设置不同的颜色, 然后把全景瓦片映射在墙面上时, 叠加该全景图的颜色,
+ *      这样我就能看清楚整个墙面是不是叠加了同一个颜色 —— 若是同一个颜色, 说明整面都映射了同一张瓦片, 根本没按最近取」）。
+ *
+ * 用法：页面 URL 带 `?panoTint=1`（`#` 前后都认，见 `panoDebugOn`）⇒
+ *      片元算完最终颜色后，**这块面按「它归哪个景点」染成该景点的固定色**（红/绿/蓝/黄；色相由景点决定，
+ *      强度见下面的 `PANO_TINT_MIX`），
+ *      同时应用层把**全景点标记**染成同一色板（图例，方便对「哪块色是哪个球」）⇒
+ *      这一片墙/地板是什么色，它就是那个球投的；整墙一个色 = 只投了一张，两色交界 = 归属分界线。
+ *      ⚠️ 口径历经五版：① 「采样色 × 固定色」→ 叠在亮图上近白，皇上「完全看不到效果」；② 逐槽把 `linK` 整张换成纯色
+ *      → 墙对了，但地板渐隐成灰的那些地方压根没全景、于是也没色 ⇒ 皇上「颜色叠加怎么没有了」；
+ *      ③（皇上 09-25 口谕「就在最后算出来的颜色再叠加上颜色，不用想那么复杂」）⇒ 只在 **main 末尾对最终颜色**上一次色，
+ *      归属判据与取图那条逐字一致，但地板盘外也照样上色，一眼看得出整间房怎么分家；
+ *      ④（皇上 09-25 近旨「地板有叠加色了，但墙上没有；每个全景点的叠加色都是红色，我想要让他们的颜色不一样」）
+ *      ⇒ 两处同一个根因：**色相按「纹理槽」给，而槽 ≠ 景点**。①「仅映射选中的那一个」模式下墙走的是另一份
+ *      **单全景材质**（`createMktShaderMaterial`，压根没有染色段）⇒ 墙当然没色；② 同一模式下地板只把选中的那张
+ *      喂进 **0 号槽** ⇒ 不管选第几个点都涂 0 号的红。修法：色相改为**运行时按景点序号**给（`uPanoTintColors[slot]`
+ *      / 单全景材质 `uPanoTint`，两根 uniform 都只在开态存在），单全景材质末尾也补上同一条上色；色板抬成
+ *      **前 20 个景点各一色**（见 `panoTintHex`）；
+ *      ⑤（皇上 09-26 晚「颜色叠加中, 叠加的颜色比例少一点」）⇒ ③④ 那两版把最终颜色**整块换成了色相**（只剩明暗），
+ *      底下那张全景照片完全读不出来 ⇒ 改成 `mix(原色, 染色, PANO_TINT_MIX)`，两份材质共用这一个常数。
+ *
+ * ⚠️ 关掉时（默认）**一行 GLSL 都不生成**（JS 侧三元，不是 uniform 分支）⇒ 线上正常路径零开销、零行为差异。
+ * ⚠️ 与 `panoTileDebug` 互不影响：那个看「哪一块瓦片落在哪个象限」，这个看「这一片墙归哪个全景」。
+ */
+const PANO_TINT_ON = panoDebugOn("panoTint");
+/** 诊断配色是否开启（应用层据此把全景点标记染成同色板，两边对得上） */
+export const MKT_PANO_TINT_ON = PANO_TINT_ON;
+/**
+ * 🔬 诊断色的**叠加强度**（0~1）：`mix(原画面色, 染色, 本值)`。1 = 整块换成色相（09-25 初版，墙上只剩明暗，
+ * 照片本身看不清）；皇上旨 2026-09-26 晚「叠加的颜色比例少一点」⇒ 取 **0.5**：色相仍是主色、一眼分得出归属，
+ * 但底下那张全景图的明暗与颜色能同时读出来。两份材质（融合 / 单全景）**共用这一个值**。
+ */
+const PANO_TINT_MIX = 0.5;
+/**
+ * 🔬 **距离明暗诊断图**（皇上旨 2026-09-26 晚「你计一下每个点距离最近的一个全景点的距离, 然后距离越小颜色就是白色,
+ *      越远颜色就是黑色」）。
+ *
+ * 用法：分两条路，**各自独立**，谁也不靠谁：
+ *      · **编辑器（MktMeshEdit）= 建材质时显式传 `panoDist: mktPanoDistEditorOn()`** ⇒ 默认关、地址里写 `panoDist=1` 才开
+ *        （皇上旨 2026-09-27 晚「把颜色换成纹理，全景的纹理」—— 灰阶诊断让位给真投影，诊断图按需开）。
+ *      · **库侧（发布页 / 预览弹窗）= 不传 ⇒ 读 URL 的 `PANO_DIST_ON`，默认关** ⇒ 正常渲染路径零影响。
+ *      开了之后片元算完最终颜色，按**这面这点到「它实际用的那张全景」的投影中心的水平距离**涂明暗：
+ *      **贴到球脚下 = 白，远到房间最远角 = 黑**。
+ *      与归属配色的分工：`panoTint` 回答「这块归哪个球」（分家线），`panoDist` 回答「这点离自己的球到底有多远」——
+ *      后者能把「整墙一个色」那面墙上的**连续渐变**照出来，距离判据是不是真在起作用一眼可辨（恒白/恒黑才是坏的）。
+ * ⚠️ 距离口径与取图那条**同一个**：水平（xz）距离、候选 = 存活槽、门优先兜底不限门 ⇒ 白色区域就是那一张覆盖到的地方。
+ * ⚠️ 黑端（多远算全黑）= 应用层每次喂的 `uPanoDistMax`，取**墙体上最远处到自己最近景点的那段水平距离**
+ *    （`_panoDistRange()`，皇上那间约 12m）⇒「黑」就是这间房可能出现的最大距离，跨面可比（不是每面各自归一化）。
+ *    ⛔ 别拿地板尺寸当尺子：默认地板盘 `FLOOR_SIZE_DEFAULT = 80`（远超房间），对角线 113m 会把整面墙的灰阶压平
+ *    （09-26 实测横扫三个点亮度 222/223/224，等于没有渐变）。
+ * ⚠️ 明暗曲线 = **线性**（`1 − d/D`，皇上旨 2026-09-27「要，改成线性渐变」）。09-26 那版 `pow(…, 2.2)` 的动机是
+ *    「着色器里是线性色，不补感知伽马会中间偏亮」—— 代价实测更糟：6m 处灰阶只剩 0.22 ⇒ 渐变几乎全压在景点脚下，
+ *    他数不出圆。线性后同一点 0.50 中灰，整间房的远近一眼读得出。
+ * ⚠️ 强度**不沿用** `PANO_TINT_MIX` 而是自己的 `PANO_DIST_MIX = 1`（整块换成灰阶）：皇上要的是「近=白、远=黑」这张**距离图**本身，
+ *    09-26 实测按 0.5 混 ⇒ 一面墙横扫过去只有 135→151（19 级）的差别，肉眼仍是「一片灰」；归属配色那条 0.5 的旨意针对的是
+ *    「色叠加把照片盖住了」，与本图无关（要看照片本来颜色就把 `?panoDist` 关掉）。
+ * ⚠️ 两道诊断**同时开**时本图后上色 ⇒ 明暗图盖住色相（要同时看归属与距离请分开截两张）。
+ * ⚠️ 开关口径历经三版：① 初版「默认关、URL `?panoDist=1` 才开」⇒ 皇上第二天地址栏里只剩 `panoTint=1`，
+ *      看到的又是实拍照片，误判「代码被改回去了」（09-26 实测线上包里 panoDist 一段俱在，纯为开关没跟上）。
+ *    ② 皇上同日晚旨「继续改成 距离越近越白、越远越黑的模式」⇒ 改成**编辑器这一页默认开**：写法是在 renderer
+ *      模块顶层调 `mktPanoDistEditorDefaultOn()` 翻全局开关。09-26 实测线上打印当场暴露它是**半张图**：
+ *      「墙 / 地板 / 家具三份材质的片元着色器不是同一份」—— 立方体那份是 `static material = create…()`，
+ *      在**模块求值期**就建好了，永远早于任何应用层模块体里的语句 ⇒ 墙/地板黑了白了，立方体仍是实拍。
+ *    ③ 现行（本次定论）：**开关不再靠语句先后**，而是建材质时把这一份材质要不要这张图**显式说清楚**
+ *      （融合工厂的 `panoDist` 选项）。⇒ 编辑器三处建材质点同传一个纯函数，预览/发布页不传 ⇒ 天然关。
+ *    ④ 09-27 晚皇上旨「把颜色换成纹理，全景的纹理」⇒ 编辑器这一页翻回**默认关**（`mktPanoDistEditorOn()`
+ *      = `panoDebugOn("panoDist")`），灰阶诊断按需 `?panoDist=1` 再看。口径机制不变，只翻默认值。
+ *    ⛔ 不许再回到「模块顶层翻全局变量」那一路：那份 GLSL 是建材质时一次性拼出来的，谁先谁后取决于 import 顺序，
+ *      改一次 import 就悄悄漏一面（且 `统一性检查` 会当场报不是同一份源码）。
+ */
+const PANO_DIST_ON = panoDebugOn("panoDist");
+/**
+ * 🔬 **编辑器这一页**该不该有近白远黑图：**默认关**（皇上旨 2026-09-27 晚「把颜色换成纹理，全景的纹理」——
+ *      灰阶诊断盖住了真投影，默认让位给全景纹理；要看诊断图 URL 显式写 `panoDist=1`，`#` 前后都认）。
+ * ⚠️ 这是个**纯查询**（不改任何全局状态）：应用层每建一份材质调一次，传进 `createMktFloorBlendShaderMaterial({ panoDist })`。
+ *      ⛔ 不要图省事改成「调一次翻全局」—— 静态字段上的材质在模块求值期就建好了，翻不到它（见上面第 ② 版事故）。
+ * ⚠️ URL 解析只留库侧这一处（与 `panoDebugOn` 同族口径），⛔ 应用层不许再各解一遍。
+ */
+export function mktPanoDistEditorOn() {
+    return panoDebugOn("panoDist");
+}
+/**
+ * 🔬 距离明暗图的**叠加强度**（0~1）：`mix(原画面色, 灰阶, 本值)`。取 **1 = 整块换成灰阶**（本图就是纯距离图），
+ * ⛔ 不与归属配色的 `PANO_TINT_MIX`（0.5）共用 —— 共用那版实测一面墙只有 19 级亮度差，等于看不出渐变。
+ * ⚠️ 拼进 GLSL 时必须走 `.toFixed(1)`：TS 里的 `1` 会被原样写成整数 `1` ⇒ **GLSL ES 报 `mix` 无匹配重载、整份片元编译失败**
+ *    （09-26 踩过，画面直接空掉），着色器里任何浮点参数都得带小数点。
+ */
+const PANO_DIST_MIX = 1;
+/**
+ * 🔬 距离明暗诊断那一段 GLSL（**两份材质共用这一份**，与 `PANO_TINT_MIX` 同理：两处各写一遍必然分叉）。
+ * `colorVar` = 最终颜色变量，`distExpr` = 这点到「最近那个全景点」的**水平**距离（米，与取图同口径）。
+ * 判不到任何候选（场景里一个全景点都没有）时 `distExpr` ≥ 1e8 ⇒ 整段跳过，露本来颜色。
+ * ⚠️ 曲线 = **线性**（皇上旨 2026-09-27「要，改成线性渐变」）：旧的 `pow(…, 2.2)` 实测把 6m 处压到灰阶 0.22
+ *      ⇒ 「圆」只剩景点脚下一小块（09-26 他报「只能看到一个白色中心」的第二层原因）。线性后 6m = 0.50 中灰。
+ *      ⚠️ 代价照实报：纯白（灰阶≥235）仍然只覆盖景点脚下 D×(1−235/255) ≈ **0.078×D** 的半径（尺子 12m ⇒ 0.94m），
+ *      铺开的是**渐变**而不是白心本身。
+ */
+function panoDistGlsl(colorVar, distExpr) {
+    return /* glsl */ `{
+            float distNear = ${distExpr};
+            if (distNear < 1e8) {
+                float distGray = 1.0 - clamp(distNear / max(uPanoDistMax, 0.001), 0.0, 1.0);
+                ${colorVar} = mix(${colorVar}, vec3(distGray), ${PANO_DIST_MIX.toFixed(1)});
+            }
+        }`;
+}
+/**
+ * 🔬 距离明暗图的「求最近景点」那一段 —— **真循环**版（皇上旨 2026-09-27 晚「那就更不对了，我一开始的需求就是
+ * 把 4 个全景点的坐标传给 shader，按最近取用」+ 看过代码后点头要这版）。
+ * 语义与他原话逐字对齐：每个像素遍历 `uPanoPoints[0..N-1]`，只留最小水平距离。
+ * ⚠️ 09-27 晚起取图与明暗图**同把尺**（皇上「取用距离最近的那个全景点的瓦片纹理」定版）：取图那条的夹角门
+ *    已整链删除 ⇒ 两边都是「纯水平距离最近」，圆与图永远一致。⛔ 本函数只动颜色，不动取图。
+ * ⚠️ 动态下标只碰普通 uniform 数组（`vec4[]`），不碰 sampler ⇒ ANGLE 那条「sampler 必须常量下标」的限制管不到这里。
+ */
+function panoDistLoopGlsl(colorVar, maxPano) {
+    return /* glsl */ `{
+            float distNear = 1e9;
+            for (int i = 0; i < ${maxPano}; i++) {
+                vec4 p = uPanoPoints[i];
+                if (p.w > 0.5) distNear = min(distNear, distance(vProjPos.xz, p.xz));
+            }
+            if (distNear < 1e8) {
+                float distGray = 1.0 - clamp(distNear / max(uPanoDistMax, 0.001), 0.0, 1.0);
+                ${colorVar} = mix(${colorVar}, vec3(distGray), ${PANO_DIST_MIX.toFixed(1)});
+            }
+        }`;
+}
+/** 第 5~24 个景点的色板（sRGB 十六进制，两两可分辨）：**球色与墙面染色的色相同源**，勿在两处各写一份。
+ *  前 20 个各一色、互不相同；第 21 个起重复末尾那 4 色（深色底 + 中间色，任意两色不撞）。 */
+const PANO_TINT_SEQ_HEX = [
+    0xff4747, 0x47ff47, 0x477bff, 0xffff47, 0xff47ff, 0x47ffff, 0xff8c1a, 0x8c1aff, 0x1aff8c, 0xff1a8c,
+    0x1a8cff, 0x8cff1a, 0xff47b4, 0x47ffb4, 0xb447ff, 0xb4ff47, 0xffb447, 0x47b4ff, 0x2acfff, 0xff477b,
+];
+/** 末尾 4 色（红/绿/蓝/黄）：景点数 > 20 时循环取用 */
+export const MKT_PANO_TINT_HEX = [0xff4747, 0x47e05a, 0x5a8cff, 0xffe14a];
+/** 「第 i 个**景点**」的诊断色（按景点序号，不是槽位）：0~19 各一色，>=20 循环末尾 4 色 */
+export function panoTintHex(i) {
+    const n = Number.isFinite(i) && i >= 0 ? Math.floor(i) : 0;
+    return n < PANO_TINT_SEQ_HEX.length ? PANO_TINT_SEQ_HEX[n] : MKT_PANO_TINT_HEX[n % MKT_PANO_TINT_HEX.length];
+}
+/** 景点诊断色的**线性空间**分量（three 的 Color 按 sRGB 输入即转线性）⇒ 写进着色器与球色都走这一个口径 */
+function panoTintLinear(i) {
+    const c = new Color().setHex(panoTintHex(i), SRGBColorSpace);
+    return [c.r, c.g, c.b];
+}
+/**
+ * 写入诊断色 uniform（**仅 `?panoTint=1` 时这些 uniform 才存在**，关态本函数直接空转 ⇒ 线上零开销）。
+ *
+ * 为什么色相改走 uniform、不再编译期按槽位写死（皇上旨 2026-09-25「每个全景点的叠加色都是红色，我想要让他们的颜色不一样」）：
+ *   槽位不等于景点。融合材质下「第 i 槽 = 第 i 个点」（09-25 去相机化定论）时才恰好相等，
+ *   而「仅映射选中的那一个」模式下地板永远只喂**选中那一张到 0 号槽** ⇒ 按槽写死 = 无论选第几个点都涂红，
+ *   且那个模式下的墙/家具是另一份单全景材质（压根没有染色段）⇒ 墙一点色都没有。两处同一个错。
+ * 故应用层在**每次往某个槽写全景时**顺手写「这个槽里躺的是第几个景点」的颜色：
+ *   - 融合材质：`uPanoTintColors[slot]`（vec3 数组）
+ *   - 单全景材质：`uPanoTint`（vec3，整面恒为选中的那一个，slot 恒 0）
+ * 材质没有这些 uniform（关态 / 旧材质 / 误传）时静默跳过，不抛错。
+ */
+export function setMktPanoTint(material, index, slot = 0) {
+    if (!PANO_TINT_ON || !material || !material.uniforms)
+        return;
+    const [r, g, b] = panoTintLinear(index);
+    const arr = material.uniforms.uPanoTintColors?.value;
+    if (arr && arr.length > slot && arr[slot] && typeof arr[slot].set === "function") {
+        arr[slot].set(r, g, b);
+        return;
+    }
+    const v = material.uniforms.uPanoTint?.value;
+    if (v && typeof v.set === "function")
+        v.set(r, g, b);
+}
+/**
+ * 写入距离明暗诊断图的**黑端距离**（米）：材质上没有这根 uniform（那份材质建时就没开这张图 / 误传）时静默跳过。
+ * ⚠️ 判据只看**材质自己有没有** `uPanoDistMax`，⛔ 不再读全局 `PANO_DIST_ON`：编辑器那三份材质是显式传 `panoDist`
+ *      建出来的（全局开关可能仍是关 —— 发布页/预览走的就是全局），拿全局判会把编辑器该喂的尺子饿掉。
+ * 传的是「多远算全黑」= 全局一把尺（应用层现场量），⛔ 不要按「每个槽各自」给 —— 跨面可比才读得出远近。
+ */
+export function setMktPanoDistRange(material, meters) {
+    if (!material || !material.uniforms)
+        return;
+    const u = material.uniforms.uPanoDistMax;
+    if (u && Number.isFinite(meters) && meters > 0)
+        u.value = meters;
+}
+/**
+ * 写入距离明暗诊断图的**圆心清单**（皇上旨 2026-09-27「shader 里面有四个全景点的坐标, 每个像素点都判断距离 4 个全景点
+ * 的距离中最小的那个值, 然后用这个值来设置颜色」）：一条 = 一个全景点的世界矩阵（只取平移列），空位传 null。
+ * ⛔ 不要拿 `weights` 当这份清单：`weights[i]` 说的是「第 i 格的**瓦片绑好了没**」（没绑好给 0 是防止拿 1×1 占位图
+ *      刷一片素灰，09-25 线上抓到的病灶），而本数组说的是「第 i 格**有没有一个点**」。
+ *      两者在「景点已放置、图还在下载」那段时间里就是不一样 ⇒ 明暗图按点数画圆，取图仍按绑好的那几张。
+ * ⚠️ 材质上没有这根 uniform（那份材质建时没开这张图 / 误传）时静默跳过，与 `setMktPanoDistRange` 同口径。
+ */
+export function setMktPanoPoints(material, matrices) {
+    if (!material || !material.uniforms)
+        return;
+    const u = material.uniforms.uPanoPoints?.value;
+    if (!Array.isArray(u))
+        return;
+    for (let i = 0; i < u.length; i++) {
+        const m = matrices[i];
+        const e = m?.elements;
+        if (!e) {
+            u[i].set(0, 0, 0, 0);
+            continue;
         }
-
-        // 实例染色：默认白=原全景色；选中黄（家具 InstancedMesh 写入 instanceColor）染黄高亮。
-        #ifdef USE_INSTANCING_COLOR
-            projCol *= vInstanceColor;
-        #endif
-${PANO_TINT_ON ? `
-        // 🔬 归属诊断配色（?panoTint=1，皇上旨 2026-09-25）：**单全景材质也要上色**。
-        //    这一支是「仅映射选中的那一个」映射方式下的墙/家具材质，它没有「哪个景点投到这块面」的
-        //    分界概念（整面恒为选中的那一张），故色相由应用层按**选中的景点序号**写进 uPanoTint（见 setMktPanoTint）
-        //    ⇒ 选 1 号球整面绿、选 2 号整面蓝，与球色对得上。
-        //    ⚠️ 色相交给标记色、明暗留原画面（乘色叠在亮图上近白，已被打回过）；强度只取 PANO_TINT_MIX（皇上 09-26「比例少一点」）。
-        {
-            float tintLum = dot(projCol, vec3(0.2126, 0.7152, 0.0722));
-            vec3 tintTo = uPanoTint * (0.55 + 0.45 * clamp(tintLum * 3.0, 0.0, 1.0));
-            projCol = mix(projCol, tintTo, ${PANO_TINT_MIX});
-        }` : ""}${PANO_DIST_ON ? `
-        // 🔬 距离明暗诊断（?panoDist=1）：这一支恒投「选中的那一个」⇒ 距离就是到它那点的水平距离。
-        ${panoDistGlsl("projCol", "distance(vProjPos.xz, texPos.xz)")}` : ""}
-
-        gl_FragColor = vec4(projCol, 1.0);
-
-        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
-        #include <colorspace_fragment>
-
-        #include <logdepthbuf_fragment>
+        const x = e[12];
+        const y = e[13];
+        const z = e[14];
+        u[i].set(x, y, z, Number.isFinite(x) && Number.isFinite(y) && Number.isFinite(z) ? 1 : 0);
     }
-`;
-/** 1×1 白色占位纹理：panorama 在尚未激活任何纹理前使用，避免空纹理采样报错 */
-export function createPlaceholderTexture() {
-    const tex = new DataTexture(new Uint8Array([255, 255, 255, 255]), 1, 1);
-    tex.needsUpdate = true;
-    return tex;
-}
-/** 形态合法值（序列化 / 反序列化单一来源，勿在别处另立字面量） */
-export function isPanoTexMode(v) {
-    return v === "tiled" || v === "whole";
-}
-/** 缺失格涂灰（09-29 晚旨「不足张数缺的地方涂灰，一眼看出数据不全」）。
- *  取 #767676 ≈ mapping 模式 `uFaceMissingColor`（线性 0.18）的 sRGB 值，两处观感一致。
- *  10-06 起拼合器只有一份（canvas 那一份奉旨删除）⇒ 常量搬到本文件当唯一来源。 */
-export const MISSING_TILE_GRAY = "#767676";
-/** 接缝余量（**原图像素**，每片向四边各多切这么多；贴原图边那侧裁到剩多少算多少）。
- *
- *  10-06 槽内改成 4×4 = 16 格 ⇒ 一张槽内部的接缝从旧版的 1 条十字变成 **3 横 3 竖**，这一条是随之而来的画质护栏：
- *   ① 上传时每片**向四边多切 M 像素**（`rtStitchTileRects`）；
- *   ② 拼合时**只采中间那块**（`rtStitchTileInset` 算出的 UV 内缩窗口），多切的那一圈**不画进格子**。
- *
- *  为什么这样就没了细亮/细暗线：缝的病根是「双线性 / mipmap 在瓦片边界外拿不到邻居像素，只能复制自己的
- *  边缘像素」（就是 `PanoTexMode` 文件头 ② 那条）。多带的 M 像素就是**真的邻居像素**，插值不再靠复制。
- *
- *  M 取 8 够不够：一格 1024×1024px、一片原图 1488×1488px（横 W/8、竖 H/4）⇒ 两个方向都是 1.45× 缩小，
- *  三线性 mip 的 footprint 半径最大约
- *  `2 × 1.45 ≈ 3` texel ⇒ 8px 有 ≈2.7 倍余量；再小一档（4px）也够用，取 8 是给「原图比 8192 窄 ⇒ 格子
- *  反而在放大」那类点留边界。**代价**：每片文件比「正好 1/8」宽 16px、高 16px（≈ +4% 面积），⛔ 不是降质。 */
-export const RT_STITCH_SEAM_MARGIN_PX = 8;
-/** 32 瓦片批次的标识 = 第一条**非空**瓦片地址（同批上传 URL 前缀一致，足以唯一；
- *  09-29 晚旨「不足张数缺的地方涂灰」后批次里允许有空串占位 ⇒ 取首个非空，防首张缺失时键为空串互撞） */
-export function rtStitchBatchOf(tiles) {
-    return tiles.find((u) => u) || "";
-}
-/** 某一拼合槽的虚拟键：`rt:<batch>#<slot>` */
-export function rtStitchKey(batch, slot) {
-    return `${RT_STITCH_KEY_PREFIX}${batch}#${slot}`;
-}
-/** 是否拼合槽（`rt:<batch>#<slot>`）的虚拟键 —— 16 片 / 64 片 / 现行 32 片**同一个前缀**，键本身不含片数信息 */
-export function isRtStitchKey(key) {
-    return key.startsWith(RT_STITCH_KEY_PREFIX);
-}
-/** 解析虚拟键 → { batch, slot }；非 rt 键返回 null */
-export function rtStitchKeyParts(key) {
-    if (!isRtStitchKey(key))
-        return null;
-    const body = key.slice(RT_STITCH_KEY_PREFIX.length);
-    const i = body.lastIndexOf("#");
-    if (i < 0)
-        return null;
-    return { batch: body.slice(0, i), slot: Number(body.slice(i + 1)) };
-}
-/** 槽 slot 用哪 16 张瓦片（原图 **8 列 × 4 行 行优先**下标 `r*8+c`；**槽内格序 = 4×4 行优先、图像左上起**）：
- *  槽 0 = 图像**左半幅**（行 0-3 × 列 0-3）→ `[0,1,2,3, 8,9,10,11, 16,17,18,19, 24,25,26,27]`；
- *  槽 1 = **右半幅**（行 0-3 × 列 4-7）→ `[4,5,6,7, 12,13,14,15, 20,21,22,23, 28,29,30,31]`。
- *  ⭐ 竖着**不再分块**（皇上旨「每个全景纹理由左右 2 个 RT 组成」）⇒ 两个槽**都是全高**，只按 u 分左右，
- *    故槽纹理也必须跟着变正方形（见 `RT_STITCH_SLOT_W/H` 那条注释，⛔ 别只改这里漏了那边）。
- *  ⚠️ 表是**从上面那几个网格常数生成**的（⛔ 手抄 32 个数）：正确性由护栏 `test/mktmesh.test.js` BE 组
- *  对着手写死的字面量逐个数断言 —— 改了网格常数而护栏没跟着改，当场红。 */
-export const RT_STITCH_SLOT_TILES = (() => {
-    // 横向几个槽（COLS/SLOT_GRID = 8/4 = 2）；纵向恒 1 个槽（ROWS/SLOT_GRID = 4/4 = 1 ⇒ sr 恒 0 = 全高）
-    const slotCols = RT_STITCH_COLS / RT_STITCH_SLOT_GRID;
-    const slots = [];
-    for (let slot = 0; slot < RT_STITCH_SLOT_COUNT; slot++) {
-        const sr = Math.floor(slot / slotCols) * RT_STITCH_SLOT_GRID;
-        const sc = (slot % slotCols) * RT_STITCH_SLOT_GRID;
-        const ids = [];
-        for (let r = 0; r < RT_STITCH_SLOT_GRID; r++) {
-            for (let c = 0; c < RT_STITCH_SLOT_GRID; c++)
-                ids.push((sr + r) * RT_STITCH_COLS + (sc + c));
-        }
-        slots.push(ids);
-    }
-    return slots;
-})();
-/** 槽内第 cell 格在**图像方向**的位置 `[列, 行]`（0 起，与 `RT_STITCH_SLOT_TILES` 的格序同一口径）。
- *  ⚠️ 这是「图像方向」（行 0 = 图像最上），GL 的 y 向上 ⇒ 画进 RT 时 y 要翻（拼合器里那句 `1 - (2*r+1)/n`）。 */
-export function rtStitchCellPos(cell) {
-    return [cell % RT_STITCH_SLOT_GRID, Math.floor(cell / RT_STITCH_SLOT_GRID)];
-}
-/** 网格取整：第 `i` 条分界线在原图 `n` 像素上的位置（`round` ⇒ 余数摊到各格，
- *  ⛔ 不必再像旧上传代码那样特判「末行末列吸收余数」）。
- *  ⚠️ `steps` = **该方向**切几片（横 `RT_STITCH_COLS` / 竖 `RT_STITCH_ROWS`）：10-06 晚起两个方向
- *     **不再相等**（8×4），必须显式传，⛔ 不许再拿一个「每边片数」两边共用 —— 竖着按 8 切 = 纵向切错。 */
-function gridLine(i, n, steps) {
-    return Math.round((i * n) / steps);
-}
-/** 32 片瓦片的切图矩形（行优先、图像左上起，下标 `i = r*8+c` 与 `RT_STITCH_SLOT_TILES` 同源；
- *  ⭐ 10-06 晚旨「横 8 × 竖 4 = 32」：`r` 走 `RT_STITCH_ROWS`(4)、`c` 走 `RT_STITCH_COLS`(8)，不再相等）。
- *
- *  ⭐ **上传侧（`panoramaUpload`）与拼合侧（`PanoTileStitcher`）必须共用这一份几何**：
- *  上传多切多少、拼合就内缩多少；两边各算一次就是「缝没治掉、反而把画面挤歪」。
- *  拼合侧拿不到原图尺寸（它只有 32 个 URL 和 32 张已解码纹理），所以它用 `rtStitchTileInset`
- *  —— 那条只需「下标 + 该瓦片自己的像素尺寸」，两者等价的前提是「多切量 = 常数 M、只有贴边那几片被裁」，
- *  而「贴不贴边」纯由下标决定 ⇒ 护栏 BE 组用同一批 (W,H) 把两条算路对表钉死。 */
-export function rtStitchTileRects(w, h) {
-    const out = [];
-    for (let r = 0; r < RT_STITCH_ROWS; r++) {
-        for (let c = 0; c < RT_STITCH_COLS; c++) {
-            const x0 = gridLine(c, w, RT_STITCH_COLS);
-            const x1 = gridLine(c + 1, w, RT_STITCH_COLS);
-            const y0 = gridLine(r, h, RT_STITCH_ROWS);
-            const y1 = gridLine(r + 1, h, RT_STITCH_ROWS);
-            const ml = Math.min(RT_STITCH_SEAM_MARGIN_PX, x0);
-            const mr = Math.min(RT_STITCH_SEAM_MARGIN_PX, w - x1);
-            const mt = Math.min(RT_STITCH_SEAM_MARGIN_PX, y0);
-            const mb = Math.min(RT_STITCH_SEAM_MARGIN_PX, h - y1);
-            out.push({ sx: x0 - ml, sy: y0 - mt, sw: x1 + mr - (x0 - ml), sh: y1 + mb - (y0 - mt), ml, mt, mr, mb });
-        }
+}
+/**
+ * 🎛️ 全景上下方向 = **口径写死：等距柱状线性 v + 不交换 + 不翻转**（2026-09-22 皇上定论）。
+ *
+ *    皇上验收「不交换 / 不翻转」那态后口谕：「完全正确，就按照这样的方式写死在代码里面，
+ *    后续也不用再通过参数来调整了」⇒ 三个方向 uniform（`uPanoSwapRow` 上下交换 /
+ *    `uPanoFlipTile` 上下翻转 / `uPanoVertOff` 垂直偏移）连同 `setMktPanoDims`、
+ *    store 三字段与其 setter、序列化、四处材质广播、预览 `setPanoDims`、面板两个 Select
+ *    **整条链路一并删除**（不是「留着不用」——半截链路最容易在日后被误接回去）。
+ *    ⚠️ 若真要再参数化：从 git 找回这一条完整链路，**别在半路上重新发明一遍**
+ *    —— 历次「调了没反应」有一半就是重复实现导致两处口径分叉。
+ *    ⚠️ 唯一**保留**的是 `uPanoTiled`（见下 🧩 段）：它不是可调参数，而是「这几个槽装的是拼合槽纹理
+ *    还是一张整图」的**数据形状判定**，删了就退回「把整图的一块拉伸铺满球面」（10-06 晚起是 1/2 拉伸）。
+ *
+ *    为什么这里值这么多注释（三轮参数化 + 一次撤除，皇上从 09-21 调到现在）—— 历次失败的**真正根因**：
+ *      ① **v 映射口径与切片口径不一致** —— 切片是把原图**线性等分**（等距柱状图：像素行 ∝ 纬度；当时 2×2，
+ *        2026-10-06 起 8×8、当夜再改 8×4 ⇒ 「线性」这条结论与切片数无关），着色器却按**墨卡托** `log(tan(45+lat/2))` 算 v。
+ *        赤道处恰好相等，越偏离越错：
+ *        墙面仰角 +10° 采到原图 +5.0°（**线性口径下应恒等于 +10°**）、−45°（地板）采到 −25.2°。
+ *        **这个偏差是连续的 ⇒ 任何离散档位组合都凑不回来**，所以「四档全试遍仍不合预期」。
+ *        ⇒ 结论只有一条：**v 必须线性于纬度**（`0.5 + lat/PI`），这一条已写死，别再改回墨卡托。
+ *      ② 两档开关在**错口径下**几乎不可能调对 —— 旧墨卡托 v 把它们和口径误差叠在一起：
+ *        lat+10° 在四态下分别显示原图 +5.0° / **−85.0°** / −5.0° / **+85.0°**（后两态=三脚架与天花板正中）。
+ *        09-22 一度把口径修正后的两档按原语义恢复上面板（皇上当时明确要「上下交换 + 上下翻转」两个开关，
+ *        臣此前自作主张删控件换连续「垂直偏移」属越权改需求），**修好口径后皇上验收第一档即正确**，遂改判写死。
+ *      ③ **「上下翻转」在错口径下必然看起来没反应** —— 墙面只覆盖贴赤道约 9% 高度的窄带，
+ *        而 `v = 1 - v` 是**关于赤道镜像这条窄带自身**，翻完仍落在同一条带里，
+ *        净效果仅「±5° 对调」≈ 画面几乎不动。
+ *
+ * 🧩 **第二个根因（与方向参数无关，故本次写死后依然保留）**：
+ *    默认场景与旧存档的 `textures[].tiles` **只有 1 条地址**（当年上传切片功能之后才有的字段），
+ *    喂料处回退成「各槽同为 `url`」（10-06 晚起是 2 槽：`[url, url]`）⇒ **各 sampler 装的是同一张完整等距柱状图**。于是：
+ *      ① 各槽同图 ⇒ 选哪一格都一样（当时看到的「交换零效果」症状，写死后该症状无从出现）；
+ *      ② 更要命的是仍按「瓦片内 UV」`localU/localV` 去采整图 ⇒ 整图被按 1/2 拉伸铺满整个球面（旧版是 1/4）：
+ *        墙面仰角 +10° 采到原图 **−70°（脚底/三脚架）** —— 这才是「全景映射在模型上的位置不太对」的另一半，
+ *        且它是**结构性**错，比 ① 的墨卡托连续偏差更严重（臣前几轮只修了墨卡托那一半，所以皇上仍觉得不对）。
+ *    修法 = `uPanoTiled`（单全景标量 / 融合每点数组）：0 时把瓦片内 UV **还原成整图 UV**
+ *      `panoU = u`、`panoV = v`（口径写死后这就是恒等式：横向 `0.5(2u)=u` / `0.5+0.5(2u−1)=u`；
+ *      纵向 10-06 晚起 localV 本就等于 v ⇒ 两个方向都退化成恒等式）。
+ *    ⚠️ 判据与回退式**必须同源**（`mktPanoTiledFlag` = 「tiled 形态 且 tiles 有任意 1~32 条」，10-06 晚旨只支持 8×4=32 张、不足涂灰），且每个回退喂料点都要写标记，
+ *       漏一处该对象就悄悄退回 1/2 拉伸。默认值取 1（已切片的真实上传数据行为不变）。
+ *       护栏：`test/panoVMapping.test.js`。
+ *    🔄 2026-09-22 追加（皇上口谕）：本标记现由**用户可选的「全景纹理形态」`PanoTexMode`**（tiled/whole）与数据
+ *       形状共同决定 —— 见下方 `PanoTexMode` / `mktPanoTexUrls` / `mktPanoTiledFlag` 三者的说明。
+ *       喂地址与写标记**必须走同一形态参数**，这是本段唯一的铁律。
+ *
+ * ⛔ **血案铁律（2026-09-21 10:39，方向参数删了它也照样成立；⭐ 2026-10-06 晚起**已作废**，仅存档）**：
+ *    旧口径（2×2 / 8×8 四槽）下 `tileRow` 必须**随取样用的 v 现算**（上半球取上排、下半球取下排），
+ *    绝不能塌缩成「与 v 无关的单一常量」—— 那样上下半球会取到同一排（天顶与天底同一张图），画面崩坏。
+ *    ⚠️ **作废说明**：10-06 晚皇上旨「每个全景纹理由**左右 2 个 RT** 组成、原图只切 8×4=32 片」
+ *    ⇒ 竖着**不再分块**，一个槽就装下上下 180°，`tileRow` 这个变量**已整条删除**。
+ *    ⛔ 谁把它加回来 = 又变回 4 槽，而 sampler 只有 2 个 ⇒ 读到未定义的槽；加回来前先答「第 3、4 张槽从哪来」。
+ *
+ * ⚠️ 历史教训（2026-09-21 线上曾报 GLSL 编译错）：曾用 `(${ROW_COND} == 1) ? 1 : 0` 内联表达式，
+ *    因 GLSL/C 里 `==` 优先级高于 `?:`，拼接后被解析为 `(v>=0.5) ? 1 : (0==1)` ⇒ int 与 bool 不匹配
+ *    ⇒ 整个片元着色器编译失败（画面全黑）。**故模板里只允许纯字面量，任何运算都在 JS 侧算完。**
+ */
+const vertexShader = /* glsl */ `
+    // common 提供 isPerspectiveMatrix 等辅助函数，logdepthbuf_vertex 依赖它
+    #include <common>
+    // 对数深度缓冲：ThreeBase 的 WebGLRenderer 开启了 logarithmicDepthBuffer，
+    // 内置材质自动注入，但自定义 ShaderMaterial 不会，必须手动 include，
+    // 否则 MktMesh 的深度与场景其他物体不一致，会被深度测试整块丢弃（表现为不显示但无编译报错）。
+    #include <logdepthbuf_pars_vertex>
+
+    // 投影空间逆矩阵：把墙顶点从「世界坐标」拉回「与 MktMesh 整体变换无关的几何局部坐标」。
+    // ⚠️ 需求铁律（皇上旨 2026-09-19）：「墙的矩阵和全景的矩阵是相对的，无论 MktMesh 整体怎么
+    //    移动/旋转/缩放，墙上的纹理都保持不变」。textureMatrix 是世界矩阵、不随 MktMesh 动，
+    //    故墙顶点也必须摆脱 modelMatrix 的影响 —— 乘上 inverse(matrixWorld) 正好抵消。
+    //    默认**单位阵**（= 直接用世界坐标，行为与改造前逐字节一致），只由 MktMesh / MktDevMesh
+    //    自己按 matrixWorld 写入；故编辑器地板 / 立方体、预览立方体这些「与 MktMesh 各自独立」
+    //    的网格完全不受影响。
+    uniform mat4 uProjInvMatrix;
+
+    varying vec3 vProjPos;
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+
+    void main() {
+        // 模型/实例局部坐标：普通 Mesh（墙/地板）无实例矩阵；InstancedMesh（家具立方体）额外乘 instanceMatrix。
+        // 与融合着色器同理，靠 three.js 自动注入的 USE_INSTANCING 宏在一份代码里同时服务两类网格。
+        #ifdef USE_INSTANCING
+            mat4 im = instanceMatrix;
+        #else
+            mat4 im = mat4(1.0);
+        #endif
+        vec4 modelPos = im * vec4(position, 1.0);
+        // 取样坐标：先按 modelMatrix 升到世界坐标，再乘 uProjInvMatrix 抵消掉 MktMesh 的整体变换。
+        // 对 MktMesh / MktDevMesh 自身，uProjInvMatrix = inverse(matrixWorld)，两者相消 => 只剩几何局部坐标，
+        // 于是 MktMesh 整体怎么变换，取样方向都不变（纹理稳稳贴在墙上）。
+        vProjPos = (uProjInvMatrix * modelMatrix * modelPos).xyz;
+
+        #ifdef USE_INSTANCING_COLOR
+            vInstanceColor = instanceColor;
+        #endif
+
+        gl_Position = projectionMatrix * modelViewMatrix * modelPos;
+
+        #include <logdepthbuf_vertex>
     }
-    return out;
-}
-/** 这片瓦片有没有贴原图边界（8×4 ⇒ 32 片里四周那 20 片至少贴一条边；贴边的**那一侧**多切量被裁成 0）。
- *  拼合侧靠它 + 瓦片自己的像素尺寸还原内缩量 ⇒ 不必知道原图多大。
- *  ⚠️ 下标拆分必须按 **列数 COLS=8**（`i = r*8+c`），⛔ 不是 ROWS。 */
-export function rtStitchTileEdgeClip(i) {
-    const r = Math.floor(i / RT_STITCH_COLS);
-    const c = i % RT_STITCH_COLS;
-    return {
-        left: c === 0,
-        right: c === RT_STITCH_COLS - 1,
-        top: r === 0,
-        bottom: r === RT_STITCH_ROWS - 1,
-    };
-}
-/** 拼合时的采样窗口 = 该瓦片纹理的 UV 里「**只留基础格、丢掉多切那一圈**」的那一块，
- *  返回 `[u0, v0, u1, v1]`（片元里 `mix(vec2(u0,v0), vec2(u1,v1), vUv)`）。
- *
- *  `tw/th` = 该瓦片纹理的**实际**像素宽高。内缩比例 = `M / sw`（多切那 M 像素占整片的比例），
- *  与「文件是不是正好等于标称切片区」无关 ⇒ 编码差 1px 也不会露出邻居的格子。
- *  贴原图边那一侧内缩 0：那里压根没多切，且那条边界就是全景自己的边（`ClampToEdge` 照旧）。
- *
- *  ⚠️ v 方向口径（与 `panoBitmapTexture` 绑死）：瓦片走 `imageOrientation:"flipY"` 预翻 + `texture.flipY=false`
- *  ⇒ 纹理 **v=0 = 图像下边**，所以图像顶部余量 `mt` 落在 `v1`、底部 `mb` 落在 `v0`。搞反 = 上下颠倒。 */
-export function rtStitchTileInset(i, tw, th) {
-    const e = rtStitchTileEdgeClip(i);
-    const m = RT_STITCH_SEAM_MARGIN_PX;
-    const u0 = e.left ? 0 : Math.min(0.5, m / tw);
-    const u1 = e.right ? 1 : 1 - Math.min(0.5, m / tw);
-    const v0 = e.bottom ? 0 : Math.min(0.5, m / th);
-    const v1 = e.top ? 1 : 1 - Math.min(0.5, m / th);
-    return [u0, v0, u1, v1];
-}
-/**
- * 「这 `RT_STITCH_SLOT_COUNT`(2) 个纹理槽到底喂哪几个地址」。⚠️ **必须**与 `mktPanoTiledFlag` 同源、同一时机调用：
- * 只改标记不改地址（或反之）= 用整图 UV 去采一张瓦片 / 用瓦片内 UV 去采整图，画面立刻错乱。
- * 非 tiled 态（或该点压根没切过片）一律回退成「各槽同为一张整图」。
- * ⭐ 2026-10-06 晚旨「只支持 32 张（8×4）」：只要有瓦片（1~32 条）一律走拼合器（rt: 虚拟键），
- *   不足 32 张的位置由拼合器**涂灰**（一眼看出数据不全）；8×8=64 张与 4×4=16 张那两版**都不做兼容**
- *   （皇上「无须兼容正常使用，有异常我会重传」⇒ 旧存档的 64 条地址超张数被判废、重传即可）。
- * ⚠️ 返回长度由 `RT_STITCH_SLOT_COUNT` 派生（⛔ 不许手写 2 个 rtStitchKey —— 槽数再变会漏改）。
- */
-export function mktPanoTexUrls(url, tiles, mode = "tiled") {
-    if (mode === "tiled" && tiles && tiles.length > 0) {
-        const batch = rtStitchBatchOf(tiles);
-        return Array.from({ length: RT_STITCH_SLOT_COUNT }, (_, s) => rtStitchKey(batch, s));
+`;
+/**
+ * 多全景地面融合着色器的顶点着色器（**地板 / 墙体 / 立方体 三者共用同一份**）。
+ * three.js 渲染 InstancedMesh 时会自动定义 USE_INSTANCING 宏并注入 instanceMatrix / instanceColor，
+ * 同一份代码因此同时服务两类网格：
+ *  - 普通 Mesh（墙/地板）：无实例矩阵，im 退化为单位阵；
+ *  - InstancedMesh（家具立方体，InstancedChild 合批）：im = instanceMatrix，各实例世界变换在其中。
+ * 故「地板/墙体/立方体」共用这一个着色器，无需为立方体另写实例化版（消除原先的 instanced 分支）。
+ * instanceColor（逐实例染色，选中高亮）同样用 USE_INSTANCING_COLOR 宏在顶点→片段间传递。
+ */
+// ⭐ 下面这一组「切片 / 拼合槽」几何常量**必须排在 `fragmentShader` 之前**：单全景那份片元是模块级
+// 常量字符串，里面要用 `${RT_STITCH_SLOT_COUNT}` 声明 sampler 数组长度（TS 的块级作用域禁止先用后声明）。
+/** ⭐ 32 瓦片拼合（2026-10-06 晚皇上旨：一张全景切 **横 8 × 竖 4 = 32 片**，每 **4×4 = 16 片**离屏拼成
+ *  1 张 **4096×4096 正方形**槽纹理，**左右 2 槽**组成完整全景；上一版是同日早些时候的 8×8 = 64 片 / 4 槽
+ *  2×2 象限，再上一版是 09-29 旨的 4×4 = 16 片）的「槽虚拟地址」前缀。
+ *  虚拟键不是真 URL，纹理由 `PanoTileStitcher` 用 shader 逐格画进 `WebGLRenderTarget` 提供，
+ *  消费方（基类 `_ensurePanoTiles` / 编辑器 `_peekTileAt`）见前缀即走拼合器，⛔ 不得当 URL 下载。
+ *  ⚠️ 键协议 `rt:<batch>#<slot>` 与 `uPanoTiled` 这套对外接口**一字未改** —— 变的只有「每批几条地址」
+ *  和「槽怎么分」；`slot` 的取值范围从 0..3 缩到 0..1，消费方一律用 `RT_STITCH_SLOT_COUNT` 取，不许写死。
+ *  ⚠️ 旧存档不兼容（皇上 2026-10-06 拍板）：存档里 64 条瓦片地址会因张数超限被判废 ⇒ **老项目需重新上传**。 */
+export const RT_STITCH_KEY_PREFIX = "rt:";
+/** 原图**横向**（经度方向 u）切几片（旨「横 8」） */
+export const RT_STITCH_COLS = 8;
+/** 原图**纵向**（纬度方向 v）切几片（旨「竖 4」）⇒ 竖着不再分块，一个 RT 就装下整幅的上下 180° */
+export const RT_STITCH_ROWS = 4;
+/** 一个批次（= 一个全景点）的瓦片总数 = 8 × 4 = 32；`tiles` 存档数组的硬上限 */
+export const RT_STITCH_TILES_PER_BATCH = RT_STITCH_COLS * RT_STITCH_ROWS;
+/** 一个拼合槽每边几格（旨「每个 RT 由 16 个全景瓦片组成」⇒ 4×4 = 16）*/
+export const RT_STITCH_SLOT_GRID = 4;
+/** 一个拼合槽的格数 = 4² = 16（画满 16 格 = 这一槽齐活） */
+export const RT_STITCH_CELLS_PER_SLOT = RT_STITCH_SLOT_GRID * RT_STITCH_SLOT_GRID;
+/** 拼合槽个数 = **左右 2 槽**（旨「每个全景纹理由左右 2 个 RT 组成」）⇒ 一个全景点只占 **2 个 sampler**。
+ *  ⛔ 别以为 32 片就要 32 个 sampler：皇上本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16 = 2 槽 × 8 景点，
+ *  这一条是硬顶，也是「必须拼进 RT」而不是「直接喂瓦片」的根本原因。
+ *  ⭐ 分块口径：槽 0 = **左半幅**（列 0-3、行 0-3）、槽 1 = **右半幅**（列 4-7、行 0-3），
+ *    即「只按 u 分左右，v 不再分上下」⇒ 每槽覆盖 **横向 180° × 纵向 180°**，是原图左/右半个**正方形**
+ *    ⇒ 槽纹理必须跟着变正方形（见下 `RT_STITCH_SLOT_W/H`），否则纵向被压 2 倍。 */
+export const RT_STITCH_SLOT_COUNT = 2;
+/** 单槽像素尺寸 **4096×4096 正方形**（皇上 2026-10-06 拍板保画质）：2 槽 = 有效分辨率 8192×4096。
+ *  ⚠️ 为什么必须变正方形：每槽覆盖的原图区域从「横 180° × 竖 90°（2:1）」变成「横 180° × 竖 180°（1:1）」，
+ *     RT 若仍是 4096×2048 ⇒ 纵向缩放比是横向的 2 倍、**纵向分辨率腰斩**，直接踩「不降质」红线。
+ *  每格 = 1024×1024；一片瓦片的原图边长 = 横 W/8、竖 H/4 ⇒ 横向缩放比 = (W/8)/1024 = 1.4533（11904 宽原图），
+ *  与 64 片那一版**逐字相同** ⇒ 本次改版**不涨也不降画质**；变的是同屏全景数 4 → 8、
+ *  单全景下载片数 64 → 32（减半）、单全景 RT 显存 128MB（不变，只是从 4 张 32MB 变 2 张 64MB）。
+ *  ⚠️ 红线（「千万不要降低质量」）：这两个数与「原图切几片」无关，⛔ 不许当成省显存的旋钮去缩。 */
+export const RT_STITCH_SLOT_W = 4096;
+export const RT_STITCH_SLOT_H = 4096;
+export const floorVertexShader = /* glsl */ `
+    #include <common>
+    #include <logdepthbuf_pars_vertex>
+
+    // 投影空间逆矩阵：见单全景顶点着色器处的同一段说明（皇上旨 2026-09-19）。
+    // 默认保持单位阵（地板 / 立方体行为与改造前完全一致）；编辑器墙（MktDevMesh）与发布态 MktMesh
+    // 一样每帧写入 inverse(matrixWorld)，故墙上的纹理同样不随整体变换漂移。
+    uniform mat4 uProjInvMatrix;
+
+    // 全景序号映射模式：本三角面归属的全局全景序号（来自 geometry 的 aPanoIndex；无此 attribute 的对象恒为 0，仅 mode=1 时读取）
+    attribute float aPanoIndex;
+    varying float vPanoIndex;
+
+    varying vec3 vProjPos;
+    // 取图「正面夹角」判据用（皇上旨 2026-09-27 深夜）：几何法线，变换到与 vProjPos **同一空间**
+    // （uProjInvMatrix * modelMatrix * instanceMatrix 的旋转部分），片元里与「点→全景」向量点积算夹角。
+    // ⛔ normal 是 three.js 自动注入的标准 attribute（墙=computeVertexNormals 逐面法线 / 封盖=ShapeGeometry /
+    //    地板=PlaneGeometry / 家具=BoxGeometry），此处无需自己声明。
+    varying vec3 vWNormal;
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+
+    void main() {
+        // 实例矩阵：InstancedMesh 自动定义 USE_INSTANCING 并提供 instanceMatrix；
+        // 普通 Mesh（墙/地板）无实例矩阵，退化为单位阵 —— 一份着色器同时服务墙/地板/立方体。
+        #ifdef USE_INSTANCING
+            mat4 im = instanceMatrix;
+        #else
+            mat4 im = mat4(1.0);
+        #endif
+        // 模型/实例局部坐标；立方体实例的变换在 instanceMatrix，墙/地板在 modelMatrix
+        vec4 modelPos = im * vec4(position, 1.0);
+        vProjPos = (uProjInvMatrix * modelMatrix * modelPos).xyz;
+        // 法线与 vProjPos 走同一条矩阵链（mat3 取旋转/缩放部分，片元里 normalize 抵消缩放）
+        vWNormal = mat3(uProjInvMatrix * modelMatrix * im) * normal;
+        // 全景序号映射模式：把本三角面的归属序号传给片元（geometry 无 aPanoIndex 的对象恒为 0，仅 mode=1 时读取）
+        vPanoIndex = aPanoIndex;
+
+        #ifdef USE_INSTANCING_COLOR
+            vInstanceColor = instanceColor;
+        #endif
+
+        gl_Position = projectionMatrix * modelViewMatrix * modelPos;
+
+        #include <logdepthbuf_vertex>
     }
-    return Array.from({ length: RT_STITCH_SLOT_COUNT }, () => url);
-}
-/**
- * 「这 2 个纹理槽是不是真瓦片」的判据 —— **必须**与喂纹理处的回退式（`mktPanoTexUrls`）同源：
- * `tiles` 有 **任意 1~32 条**地址（不足 32 = 数据不全，缺的格子拼合时涂灰）**且**当前形态选的是 tiled = 是瓦片；
- * 否则各槽同为一张整图（旧数据 / 种子图 / 用户切整片）。
- */
-export function mktPanoTiledFlag(tiles, mode = "tiled") {
-    return mode === "tiled" && tiles && tiles.length > 0 ? 1 : 0;
-}
-/**
- * 写入 uPanoTiled（2026-09-22「交换 / 不交换完全一样」的修复）。
- *
- * 单全景材质该 uniform 是标量；融合材质是**每点一个**的数组（不同点来源可能不同），故带 slot。
- * 材质没有该 uniform（旧材质 / 误传）时静默跳过，不抛错。
- */
-export function setMktPanoTiled(material, tiled, slot = 0) {
-    if (!material || !material.uniforms)
-        return;
-    const u = material.uniforms.uPanoTiled;
-    if (!u)
-        return;
-    if (Array.isArray(u.value) || ArrayBuffer.isView(u.value)) {
-        const arr = u.value;
-        if (slot >= 0 && slot < arr.length)
-            arr[slot] = tiled;
-    }
-    else {
-        u.value = tiled;
-    }
-}
-/**
- * 创建 MktMesh 专用的「实例化 + 等距柱状投影全景」着色器材质。
- * panorama / textureMatrix 由 MktMesh 在运行时按「最近纹理」动态设置。
- */
-export function createMktShaderMaterial() {
-    return new ShaderMaterial({
-        uniforms: {
-            // 一个全景点恒占 **2 个 sampler**（2026-10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」）：
-            // panoramas[0..1] = 2 张**离屏拼合槽纹理**（[左半幅, 右半幅]，每槽由 `RT_STITCH_CELLS_PER_SLOT`
-            // 片瓦片拼成），片元按全景 UV 的 **u** 挑对应槽采样（v 不再分块）。
-            // ⛔ 长度由 `RT_STITCH_SLOT_COUNT` 派生（不许手写 2 张）—— 槽数再变这里会漏改。
-            panoramas: {
-                value: Array.from({ length: RT_STITCH_SLOT_COUNT }, () => createPlaceholderTexture()),
-            },
-            textureMatrix: { value: new Matrix4() },
-            uPanoramaVisible: { value: 1 },
-            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 连同着色器里那段 pow 分支已整条撤除
-            // 全景上下方向**已写死**，无 uniform（见文件头 🎛️ 段）。
-            // 1 = panoramas[0..1] 是 2 张拼合槽纹理（左/右半幅）；0 = 两槽同为一张完整等距柱状图（改用全图 UV）。
-            // 由喂纹理处按「用户选的 PanoTexMode + 数据来源」写（setMktPanoTiled）；默认 1 与改造前行为逐字一致。
-            uPanoTiled: { value: 1 },
-            // 投影空间逆矩阵：默认单位阵 = 直接用世界坐标（与改造前行为逐字节一致）。
-            // 仅由 MktMesh 自身按 matrixWorld 写入，使墙的投影与 MktMesh 整体变换解耦（皇上旨 2026-09-19）。
-            uProjInvMatrix: { value: new Matrix4() },
-            // 🔬 归属诊断色（线性空间）：**只在 ?panoTint=1 时创建**（JS 侧三元，关时连 uniform 都不存在）
-            //    ⇒ 「仅映射选中的那一个」那套墙/家具材质也带上该景点的固定色，见 setMktPanoTint。
-            ...(PANO_TINT_ON ? { uPanoTint: { value: new Vector3(1, 1, 1) } } : {}),
-            // 🔬 距离明暗诊断的「黑端米数」：**只在 ?panoDist=1 时创建**；默认 16 ≈ 常见房间对角线
-            //    （应用层每次喂投影时按 floorSize 写实际值，见 setMktPanoDistRange；万一没喂也不会整图黑）
-            ...(PANO_DIST_ON ? { uPanoDistMax: { value: 16 } } : {}),
-        },
-        vertexShader,
-        fragmentShader,
-        // 双面渲染（DoubleSide）：09-29 皇上旨「3 个 shader 的 side 参数需要保持一致」——
-        // 四个全景 shader 工厂（单全景 / blend / mapping / selected）统一 DoubleSide，
-        // 墙零厚度两面都要见投影，家具/地板与墙两面行为一致（旧 FrontSide「正/反面立方体互不可见」
-        // 的设计早被编辑器三模式切换的 DoubleSide 三件套冲掉，留着只是初始态不一致的祸根）。
-        side: DoubleSide,
-        // 面片一律不透明（每实例透明度已移除）：走不透明队列，写深度且免去按距离排序开销
-        transparent: false,
-        // 跳过 ThreeBase 的 ReinhardToneMapping，避免压暗全景颜色（色彩空间口径见文件头 ③：硬件解码一次、片元不再手动 pow）
-        toneMapped: false,
-    });
-}
-/**
- * 多全景融合着色器：把「最近最多 maxPano 个全景」以数组传入，每个片元对这些张各自做等距柱状投射，
- * 再取**唯一一条**口径（皇上旨 2026-09-25 晚「都要一起改」→ 2026-09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
- * - **候选里只取水平距离最近的那一张，满权重**（地板 / 墙 / 家具立方体**同一份、同一条**，
- *   旧的「地板按覆盖度加权融合、交界渐隐」那一路已按旨删除 ⇒ 面上不再有渐隐带，也不再有中央露灰）。
- * - ⚠️ 09-24~09-25 的「夹角门（点在面正面侧才合格）+ 全不合格兜底」已按 09-27 晚旨**整链删除**：
- *   它是「明暗圆对、纹理不对」的第二来源（墙背后更近的点被门否掉，纹理落到正面侧的远槽）；
- *   纯距离口径下墙背后的全景也会投过来，皇上知情选定。
- * - 候选池按「槽里有没有全景」筛，**不按覆盖半径（c>0）筛**，否则两个景点距离一远就变成
- *   「各占一片互不相干的 territory、交界处整条露灰底」，距离判据压根轮不到（实测 bothCandidates=0）。
- * - ⚠️ 代价（已向皇上报过并获批）：`uFloorCoreRadius` / `uFloorFadeRange` 两根覆盖半径旋钮**从此对任何面都不参与取图**。
- *   控件与 uniform 暂未删（未奉旨），删与不删等皇上下结论。
- * - panoramas[i]      : 第 i 张全景纹理
- * - textureMatrices[i]: 第 i 张全景的世界矩阵（位置=投影中心，旋转=朝向）
- * - weights[i]        : 第 i 张是否活着（camW，0 = 该槽未绑全景 ⇒ 不进候选池）
- */
-/**
- * 生成多全景片元着色器（地板 / 墙 / 家具共用）。
- * ⚠️ 关键约束：Windows/ANGLE(D3D) 后端**禁止用循环变量/非常量索引 sampler 数组**（报错
- * "array index for samplers must be constant integral expressions"），故这里在 JS 侧把循环
- * 完全展开成「字面量下标」的若干代码段（panoramas[0]…panoramas[N-1]），所有数组访问均为常量下标。
- * 未参与融合的槽位权重=0，被 if(w>0.0) 跳过（常量分支，零开销）。
- */
-function buildFloorBlendFragment(maxPano, panoDistOn) {
-    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
-    let slotCalc = ""; // 每槽各自算出：颜色 linK / 水平距离 dK / 夹角 angK（acos+背面+180°）/ 分值 scoreK = d−ang
-    let slotReduceLive = ""; // 每槽参与「score 最小值」归约（候选池 = 槽里活着的那几张，score<1e8 即活）
-    let slotOne = ""; // 每槽对「只取 score 最小那一张」的贡献（唯一取图口径，地板/墙/家具共用）
-    let slotOwner = ""; // 🔬 每槽对「归属诊断色」的贡献（仅 ?panoTint=1 时生成，正常态为空串）
-    for (let k = 0; k < maxPano; k++) {
-        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
-        slotCalc += `
-        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
-        vec3 lin${k} = vec3(0.0);
-        float d${k} = 1e9;     // 本面这点到本槽全景中心的**水平**距离（score 被减数）
-        // float camD${k} —— 14:24 旨曾加「全景中心到相机距离」项，15:07 旨去掉（连声明一并去，注释存档）
-        float cosA${k} = -1.0; // 「点→全景」向量 与 正面法线 的夹角余弦（acos 后 = 夹角弧度）
-        float ang${k} = 1e9;   // 夹角（acos 后 0..180°，背面 +180° ⇒ 270°..360°），score 的减数
-        float score${k} = 1e9; // ⭐主判据（皇上 09-28 15:07 旨七修）：score = 顶点与全景的距离 − 夹角，取**最小**者定纹理
-        // ── 旧原理存档（注释保留不删）──
-        // 09-28 14:24 旨「score = 顶点距离 + 相机距离 − 夹角」：camD 项已整条撤（见下方槽内注释行）
-        // 09-28 00:44 旨「score = 距离 × 夹角²，取积最小」：见下方槽内注释行
-        // 09-28 01:56 旨「按夹角从小到大排序取最小、打平比水平距离」：bestAng/bestDAtAng 两段归约（已撤，git 可查）
-        {
-            float camW = weights[${k}];   // 该全景的「锚点距离权重」（JS 按**名册那条水平距离**反比算，未归一化；⭐ 10-07 第二十一道旨后那把尺量的端点 = 控制器中心点，未注入时才是相机位置）
-            if (camW > 0.0) {
-                mat4 tm = textureMatrices[${k}];
-                vec3 texPos = tm[3].xyz;            // 投影中心 = 纹理矩阵位置
-                mat3 texRot = mat3(tm);             // 纹理朝向 = 旋转分量
-                vec3 dir = normalize(vProjPos - texPos);
-                dir = texRot * dir;                 // 转到纹理局部方向
-                float lon = atan(dir.z, dir.x);
-                float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
-                float lat = asin(clamp(dir.y, -1.0, 1.0));
-                // 等距柱状线性 v（= 全图 UV），与单全景分支**逐字同口径**，理由见单全景分支说明
-                float v = 0.5 + lat * 0.3183098861837907; // 1/PI
-                // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
-                // ⭐ 10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」：竖着不再分块 ⇒ 槽只随 u 走，与单全景分支逐字同口径
-                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 = 纵向分辨率白丢一半
-                float localV = v;
-                // 🧩 该点这 2 槽装的是整图（用户切了 whole 形态，或该点压根没切过片）⇒ 还原成全图 UV 再采样，与单全景分支逐字同口径
-                //    （方向已写死，故横向还原式恒等于 u、纵向 localV 本就等于 v，见单全景分支推导）
-                float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
-                float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
-                // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：base 为本点连槽起点（JS 常量 k*RT_STITCH_SLOT_COUNT），
-                //    以下 2 个采样下标均为「base + 字面量 0/1」的常量表达式，编译安全。
-                // 🔬 诊断直通（见文件头 TILE_DEBUG_GLSL 说明；正常态内联为 0.0，整段被编译器消除）
-                if (${TILE_DEBUG_GLSL} > 0.5) {
-                    vec3 dbgCol;
-                    if (tileIdx == 0) dbgCol = vec3(1.0, 0.0, 0.0);      // 红 = 左半幅槽 0
-                    else dbgCol = vec3(0.0, 1.0, 0.0);                   // 绿 = 右半幅槽 1
-                    gl_FragColor = vec4(dbgCol, 1.0);
-                    #include <colorspace_fragment>
-                    #include <logdepthbuf_fragment>
-                    return;
-                }
-
-                // ⭐ 采样即线性（与单全景分支同一条口径，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;
-                // ⭐ 09-28 15:07 旨定版（七修）：score = **顶点到全景的距离 − 夹角**，取最小者。
-                //    夹角 = acos(cosA)（0..180°），cosA = dot(normalize(全景中心 − 本点), N)（N 已按 gl_FrontFacing 翻到观察面）。
-                //    背面一刀 +180°（00:26 旨「背面的夹角该大于 180 度」）保留。
-                //    14:24 那版曾加「全景与相机的距离 camD」，15:07 旨「把全景到相机的那个逻辑去掉」，注释保留不删。
-                vec3 toPano${k} = texPos - vProjPos;
-                float lenP${k} = length(toPano${k});
-                cosA${k} = (lenP${k} > 1e-4) ? dot(toPano${k} / lenP${k}, N) : 1.0;
-                d${k} = distance(vProjPos.xz, texPos.xz);
-                // camD${k} = distance(cameraPosition, texPos);   // ⛌ 14:24 旨「全景与相机距离」项，15:07 旨去掉，注释保留不删
-                ang${k} = acos(clamp(cosA${k}, -1.0, 1.0));
-                if (cosA${k} < 0.0) ang${k} += 3.14159265;   // 背面 +180°（π）
-                score${k} = d${k} - ang${k};                 // ⭐ 15:07 旨：距离 − 角度，取最小
-                // score${k} = d${k} + camD${k} - ang${k};    // ⛌ 旧原理（14:24 旨：两距离之和 − 角度），注释保留不删
-                // score${k} = d${k} * ang${k} * ang${k};    // ⛌ 旧原理（00:44 旨：距离 × 夹角² 取积最小），注释保留不删
-            }
-        }`;
-        // ⭐ 归约（皇上 09-28 15:07 旨七修「顶点距离 − 夹角」）：bestScore = 各活槽分值最小值。
-        //    score == bestScore 是同值浮点精确比较（min 存的就是同一份 bit 值，== 可靠，与历代口径同一技巧）。
-        slotReduceLive += `
-    if (score${k} < 1e8) {
-        bestScore = min(bestScore, score${k});
-    }`;
-        // ⭐ 胜者（皇上 09-28 15:07 旨七修）：score = 顶点距离 − 角度 最小的那张。
-        slotOne += `
-    if (score${k} < 1e8 && score${k} == bestScore) {
-        wsum += 1.0; acc += lin${k}; cover += 1.0;
-    }`;
-        // 🔬 归属诊断（皇上旨 2026-09-25「就在最后算出来的颜色上再叠颜色，不用想那么复杂」）：
-        //   这里只**记账**（这点归哪个景点），染色动作留到 main 末尾对最终颜色做一次。
-        //   归属判据与 slotOne **逐字同一条**（距离−角度最小），末了统一「打平归编号小的那个」。
-        if (PANO_TINT_ON) {
-            slotOwner += `
-    if (score${k} < 1e8 && score${k} == bestScore) {
-        // ⚠️ tintCnt == 0.0 这道闸 = **打平归编号小的那个**：两张一样近的那条分界带（实测两景点连线的中垂面与墙交线那一带）
-        //    会同时命中两个槽，平均出来是「红+绿=橄榄」—— 那不是没上色，但肉眼读不出归属，故只记第一个。
-        if (tintCnt == 0.0) { tintAcc += uPanoTintColors[${k}]; tintCnt += 1.0; }
-    }`;
+`;
+const fragmentShader = /* glsl */ `
+    // 对数深度缓冲（与顶点着色器配套，保证 MktMesh 深度与场景一致）
+    #include <logdepthbuf_pars_fragment>
+
+    // 一个全景点 = 2 张**拼合槽纹理**（原图切 8×4=32 片，每 4×4=16 片拼成一张槽，10-06 晚皇上旨）。
+    // panoramas[0..1] = [左半幅, 右半幅] 两个 RT；片元按全景 UV 的 **u** 挑对应槽采样（v 不再分块）。
+    // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组，故槽选择用「常量下标 if 链」（tileIdx 命中的分支内 sampler 下标为字面量）。
+    uniform sampler2D panoramas[${RT_STITCH_SLOT_COUNT}];
+    uniform mat4 textureMatrix; // 纹理世界矩阵：位置(第4列 xyz)=投影中心，旋转(左上3x3)=纹理朝向
+    uniform float uPanoramaVisible; // 全景投射显隐：1=显示全景，0=仅显示中性素色（编辑态切换/投射显隐开关用）
+    // 色彩空间**只有一条路**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
+    // 原 uniform float uColorSpace; + 片元里那段 sRGB→linear 的 pow 分支已整条撤除，勿加回（原因见下方采样处）。
+    // 全景上下方向**已写死**（等距柱状线性 v + 不交换 + 不翻转，2026-09-22 皇上定论，理由见文件头 🎛️ 段）：
+    // 曾有 uPanoSwapRow / uPanoFlipTile / uPanoVertOff 三个可调 uniform，现已整条撤除，勿加回。
+    // ⚠️ uPanoTiled = panoramas[0..1] 装的是「拼合好的左右两张槽纹理」(1) 还是「同一张完整等距柱状图」(0)。
+    //   由「用户选的纹理形态 PanoTexMode + 该点有没有切过片」共同决定（见下方 mktPanoTiledFlag）。
+    //   0 时必须改用**全图 UV** 取样：拿瓦片内的 localU/localV 去采整图 = 把整图的左半幅拉伸到整个
+    //   球面（墙面仰角 +10° 采到原图 −70° 的地板）—— 2026-09-22「全景位置不对」的第二真因，见文件头 🧩 段。
+    uniform float uPanoTiled;${PANO_TINT_ON ? `
+    // 🔬 归属诊断色（仅 ?panoTint=1 时存在）：本材质当前投的就是「选中的那一个」全景，
+    //    故由应用层把**那个景点**的固定色写进来（见 setMktPanoTint）⇒ 墙面/立方体上的色与球色同相。
+    uniform vec3 uPanoTint;` : ""}${PANO_DIST_ON ? `
+    // 🔬 距离明暗诊断（仅 ?panoDist=1 时存在）：「多远算全黑」的米数，由应用层写（见 setMktPanoDistRange）
+    uniform float uPanoDistMax;` : ""}
+
+    // 取样坐标（已由顶点着色器的 uProjInvMatrix 抵消掉 MktMesh 的整体变换，与 textureMatrix 一样对变换免疫）
+    varying vec3 vProjPos;
+    // 实例染色（仅 InstancedMesh 带 instanceColor 时启用）：默认白=全景真实色，选中黄=高亮染色
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+
+    void main() {
+        // 投影中心 = 纹理矩阵的位置
+        vec3 texPos = textureMatrix[3].xyz;
+        // 纹理朝向 = 纹理矩阵的旋转分量（mat4 -> mat3 取左上 3x3）
+        mat3 texRot = mat3(textureMatrix);
+
+        // 从纹理位置指向该片元的方向向量（即「以纹理矩阵位置为中心」）。
+        vec3 dir = normalize(vProjPos - texPos);
+        dir = texRot * dir;
+
+        // 经度 [-PI, PI] -> u ∈ [0,1]
+        float lon = atan(dir.z, dir.x);
+        float u = lon * 0.15915494309189535 + 0.5; // 1/(2*PI)
+
+        // 纬度 [-PI/2, PI/2]。⚠️ **等距柱状（equirectangular）口径**：全景图的像素行正比于纬度，
+        // 故 v 必须**线性于 lat**，±90° 落在 1/0（线性在极点不发散，因此不需要截断纬度）。
+        // 此处曾按墨卡托 log(tan(45+lat/2)) 换算 —— 与切片口径不一致，导致墙面仰角 +10° 只采到
+        // 原图 +5.0°、且越偏离赤道偏得越多。这才是「全景映射位置不对」的根因（2026-09-22 定位后写死）。
+        float lat = asin(clamp(dir.y, -1.0, 1.0));
+        float v = 0.5 + lat * 0.3183098861837907; // 1/PI
+
+        // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
+        // ⭐ 2026-10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」：**竖着不再分块** ⇒ 槽只随 **u** 走，
+        //    v 方向一槽装下整幅上下 180°（这也是槽纹理必须改成 4096² 正方形的原因，见 RT_STITCH_SLOT_W/H）。
+        // ⛔ 别把 tileRow 加回来：加回来 = 又变成 2×2 四槽，而 sampler 只有 2 个 ⇒ 读到未定义的槽。
+        int tileIdx = (u >= 0.5) ? 1 : 0;
+        // 槽内局部 UV（连续、无 fract 边界跳变）：横向按左右减半；
+        // ⛔ 纵向**不再减半**（槽就是全高）⇒ localV 恒等于 v。写成 2v / 2v-1 = 纵向分辨率白丢一半。
+        float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
+        float localV = v;
+
+        // 🧩 uPanoTiled == 0（两槽装的是**同一张完整等距柱状图**，没有拼合槽）：
+        //    必须还原成**全图 UV** 再采样，也就是直接用 (u, v) ——
+        //    横向还原式 (半==左 ? 0.0 : 0.5) + 0.5*localU 代入 localU 后恒等于 u；纵向 localV 本就等于 v，
+        //    **两个方向都退化成恒等式**（方向已写死：无交换、无翻转、无偏移）。
+        //    ⛔ 切勿删掉本分支图省事：直接拿 localU/localV 去采整图 = 把整图的左半幅铺满整个球面。
+        float panoU = (uPanoTiled > 0.5) ? localU : u;
+        float panoV = (uPanoTiled > 0.5) ? localV : v;
+
+        // 🔬 诊断直通（见文件头 TILE_DEBUG_GLSL 说明；正常态内联为 0.0，整段被编译器消除）
+        if (${TILE_DEBUG_GLSL} > 0.5) {
+            vec3 dbgCol;
+            if (tileIdx == 0) dbgCol = vec3(1.0, 0.0, 0.0);      // 红 = 左半幅槽 0
+            else dbgCol = vec3(0.0, 1.0, 0.0);                   // 绿 = 右半幅槽 1
+            gl_FragColor = vec4(dbgCol, 1.0);
+            #include <colorspace_fragment>
+            #include <logdepthbuf_fragment>
+            return;
+        }
+
+        // ⭐ 采样出来的**已经是线性值**：全景纹理（瓦片 / 整图 / 拼合槽 RT）一律标 colorSpace = SRGBColorSpace
+        //    ⇒ WebGL2 按 SRGB8_ALPHA8 上传，texture2D 时硬件已做过一次 sRGB→linear 解码。
+        //    这里因此**不再手动解码**（皇上旨 2026-10-07「mktmesh 里面的纹理色彩空间统一使用 liner」）：
+        //    末端的 <colorspace_fragment> / 终处理再编码一次 ⇒ 一进一出，屏幕上与源图逐字节还原。
+        //    ⛔ 别加回那段 pow()：它在硬件已解码之上再解一遍 = 二次解码压暗（中灰 #808080 掉到 #373737、#333333 掉到 #080808）。
+        vec3 projCol;
+        if (tileIdx == 0) projCol = texture2D(panoramas[0], vec2(panoU, panoV)).rgb;
+        else projCol = texture2D(panoramas[1], vec2(panoU, panoV)).rgb;
+
+        // 全景投射显隐：关闭时（仅墙体/地板，回落中性素色，不投射全景）；默认 1 完全显示
+        if (uPanoramaVisible < 0.5) {
+            projCol = vec3(0.78, 0.78, 0.80);
         }
-        // 🔬 距离明暗图**不在这儿逐槽拼**了（皇上旨 2026-09-27 晚：要一句真循环遍历 4 个坐标）⇒ 见 `panoDistLoopGlsl`。
+
+        // 实例染色：默认白=原全景色；选中黄（家具 InstancedMesh 写入 instanceColor）染黄高亮。
+        #ifdef USE_INSTANCING_COLOR
+            projCol *= vInstanceColor;
+        #endif
+${PANO_TINT_ON ? `
+        // 🔬 归属诊断配色（?panoTint=1，皇上旨 2026-09-25）：**单全景材质也要上色**。
+        //    这一支是「仅映射选中的那一个」映射方式下的墙/家具材质，它没有「哪个景点投到这块面」的
+        //    分界概念（整面恒为选中的那一张），故色相由应用层按**选中的景点序号**写进 uPanoTint（见 setMktPanoTint）
+        //    ⇒ 选 1 号球整面绿、选 2 号整面蓝，与球色对得上。
+        //    ⚠️ 色相交给标记色、明暗留原画面（乘色叠在亮图上近白，已被打回过）；强度只取 PANO_TINT_MIX（皇上 09-26「比例少一点」）。
+        {
+            float tintLum = dot(projCol, vec3(0.2126, 0.7152, 0.0722));
+            vec3 tintTo = uPanoTint * (0.55 + 0.45 * clamp(tintLum * 3.0, 0.0, 1.0));
+            projCol = mix(projCol, tintTo, ${PANO_TINT_MIX});
+        }` : ""}${PANO_DIST_ON ? `
+        // 🔬 距离明暗诊断（?panoDist=1）：这一支恒投「选中的那一个」⇒ 距离就是到它那点的水平距离。
+        ${panoDistGlsl("projCol", "distance(vProjPos.xz, texPos.xz)")}` : ""}
+
+        gl_FragColor = vec4(projCol, 1.0);
+
+        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
+        #include <colorspace_fragment>
+
+        #include <logdepthbuf_fragment>
     }
-    return /* glsl */ `
-    #include <logdepthbuf_pars_fragment>
-
-    uniform sampler2D panoramas[${tileCount}];${PANO_TINT_ON ? `
-    // 🔬 归属诊断色（线性空间，**仅 ?panoTint=1 时存在**）：第 i 个纹理槽里躺的那个景点的固定色，
-    //    由应用层每次换绑时写入（见 setMktPanoTint）。⚠️ 刻意不按槽位编译期写死：
-    //    「仅映射选中的那一个」模式下地板永远只喂 0 号槽，按槽写死 = 选第几个点都涂同一个红（皇上 09-25 反馈）。
-    uniform vec3 uPanoTintColors[${maxPano}];` : ""}${panoDistOn ? `
-    // 🔬 距离明暗诊断（这份材质建时 panoDist 选项为真才存在）：「多远算全黑」的米数，由应用层每次喂投影时写
-    //    （见 setMktPanoDistRange）⇒ 全屋同一把尺子，跨面才比得出远近。
-    uniform float uPanoDistMax;
-    // 🔬 距离明暗诊断的**圆心清单**（皇上旨 2026-09-27「shader 里面有四个全景点的坐标, 每个像素判断距离 4 个点里最小的
-    //    那个值, 再用这个值设置颜色」）：xyz = 该点的世界坐标，w = 1 ⇒ 这一格**真有一个全景点**。
-    //    ⛔ 与 weights 的分工（两者刻意不同，别合并）：weights 管「这格的**图**能不能取」（瓦片没绑好就 0，防止拿
-    //    1×1 占位图刷一片素灰），uPanoPoints 管「这格**有没有点**」⇒ 圆按景点个数画，图按传到位的那几张取。
-    //    ⚠️ 09-27 晚起明暗那段**只读这一个数组**（纯水平距离最近）⇒ 与取图同把尺（夹角门已废）；坐标与上面
-    //    textureMatrices[k][3].xyz 同源同值（同一批矩阵喂进来，见 setMktPanoPoints），不是第二套数据。
-    uniform vec4 uPanoPoints[${maxPano}];` : ""}
-    uniform mat4 textureMatrices[${maxPano}];
-    uniform float weights[${maxPano}];   // 锚点距离权重 camW（JS 由名册那条水平距离写入，未归一化；着色器内与空间因子相乘后整体归一化）
-    uniform vec3 uFloorBaseColor;       // 地板底色（线性空间，深灰）：只在「一个候选都没有」（maxPano 张全景全未绑定）时露出来
-    // ⚠️ 下面两根覆盖半径旋钮**自 09-25 晚「都要一起改」起不再参与取图**（覆盖度融合那一路已删，每个像素纯按最近一张）。
-    //    控件与 uniform 暂留（未奉旨删控件），值仍由应用层写入，但着色器不读 ⇒ 调它们没有视觉变化。
-    uniform float uFloorCoreRadius;
-    uniform float uFloorFadeRange;
-    uniform float uFloorOpacity;        // 地板全景投影「整体透明度」（0~1，全局对所有全景一起生效）：仅作用于全景图映射的可见度，越小全景越淡、越透出地板灰底；地板灰色本身不变
-    // 全景投射显隐：1=显示全景（投射到墙/地板），0=仅显示素色（墙体回落中性色，地板恒为 1 不受影响）
-    uniform float uPanoramaVisible;
-    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 sRGB pow 解码分支已整条撤除，
-    //   采样值即线性（纹理标了 SRGBColorSpace ⇒ 硬件解过一次），末端 <colorspace_fragment> 只编码一次。
-    // ⭐ 取图方式只有一条（皇上旨 2026-09-25 晚「都要一起改」→ 09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
-    //   地板 / 墙 / 家具**同一份着色器、同一条判据** —— 候选里只取水平距离最近那**一张**，满权重。
-    //   旧的 uPanoPickNearest（0=地板覆盖度融合 / 1=模型表面取最近）已随融合那一路一起删除；
-    //   09-24~09-25 的夹角门 + 兜底也已按 09-27 晚旨整链删除（它是「明暗圆对、纹理不对」的第二来源）。
-    //   ⚠️ 候选池是「槽里活着的全景」（weights>0，瓦片绑好了的），**不受覆盖半径筛掉**。
-    // 全景上下方向**已写死**，无 uniform（与单全景材质同口径，见文件头 🎛️ 段）。
-    // 每个全景点**各自**的「这 2 槽是瓦片(1)还是同一张整图(0)」—— 融合时不同点可能来源不同（上传的有瓦片、
-    // 旧数据/种子图没有），故按点存数组；为 0 的点走全图 UV，理由见单全景分支同注释。
-    uniform float uPanoTiled[${maxPano}];
-
-    // 取样坐标（已由顶点着色器的 uProjInvMatrix 抵消掉 MktMesh 的整体变换，与 textureMatrices 一样对变换免疫）
-    varying vec3 vProjPos;
-    // 全景序号映射模式：本三角面归属的全局全景序号（顶点着色器从 geometry 的 aPanoIndex 传来；无此 attribute 的对象恒为 0）
-    varying float vPanoIndex;
-    // 几何法线（顶点着色器按同一条矩阵链变换到与 vProjPos 同一空间）：取图「正面夹角」判据用
-    varying vec3 vWNormal;
-    // 实例染色（仅当 InstancedMesh 带 instanceColor 时启用）：默认白=全景真实色，选中黄=高亮染色
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-
-    void main() {
-        // ⭐ 正面法线 N（分值公式里「夹角」的基准，皇上 09-28 凌晨旨「距离 × 夹角」）：几何法线归一化后，
-        //    按 gl_FrontFacing 翻到**观察者看的这一面**（墙零厚度 DoubleSide，两面各自以看到的这面算夹角——
-        //    同一面墙从两侧看，分值不同是应该的）。地板/封盖/立方体同理。
-        vec3 N = normalize(vWNormal);
-        if (!gl_FrontFacing) N = -N;
-${PANO_TINT_ON ? `        // 🔬 归属诊断配色（?panoTint=1）：本面这点归哪个景点（tintAcc 累加其固定色，tintCnt 计数）
-        vec3 tintAcc = vec3(0.0);
-        float tintCnt = 0.0;` : ""}
-${slotCalc}
-        // ⭐ 取图口径（距离+夹角融合，钦定公式）：score = 顶点距离 − 角度，取最小的那**一张**（地板/家具/编辑态墙同一份 shader）。
-        //   （原「uFaceMappingMode 0/1 运行时分支」已按皇上旨 2026-09-29「三模式三 shader」拆出：
-        //    序号直取在 createMktFloorMappingShaderMaterial、仅显示选中在 createMktFloorSelectedShaderMaterial。）
-        vec3 acc = vec3(0.0);
-        float wsum = 0.0;
-        float cover = 0.0;
-        // 「取图胜者」归约（皇上 09-28 15:07 旨七修定版：score = 顶点距离 − 角度，取最小）
-        float bestScore = 1e9;
-${slotReduceLive}
-${PANO_TINT_ON ? "        // 🔬 先记账：这点按「距离减夹角最小」归哪个景点（与下面 slotOne 的取图判据同一条）\n" + slotOwner : ""}
-        // 一面只显一张：score 最小的那张（不论多远，绝不留空面）
-${slotOne}
-        if (wsum > 0.0) acc /= wsum;     // 按总权重归一化（总混合值=1）
-        // 覆盖度：有候选即 1（09-25 晚起不再有「渐隐/露灰」的中间态），只在「一个候选都没有」时 = 0
-        // ⇒ 露出地板/墙体本来的底色。
-        float coverage = clamp(cover, 0.0, 1.0);
-        // 整体透明度仅作用于全景图映射：把覆盖度按 uFloorOpacity 缩放后再混合，
-        // 灰底始终不透明（alpha=1），opacity 越小全景越淡、越透出地板灰色；地板灰色本身不变。
-        float coverageEff = clamp(coverage * uFloorOpacity, 0.0, 1.0);
-        vec3 col = mix(uFloorBaseColor, acc, coverageEff);
-        // 全景投射显隐：关闭时（仅墙体，地板恒为 1）回落中性素色，不投射全景
-        if (uPanoramaVisible < 0.5) {
-            col = vec3(0.78, 0.78, 0.80);
+`;
+/** 1×1 白色占位纹理：panorama 在尚未激活任何纹理前使用，避免空纹理采样报错 */
+export function createPlaceholderTexture() {
+    const tex = new DataTexture(new Uint8Array([255, 255, 255, 255]), 1, 1);
+    tex.needsUpdate = true;
+    return tex;
+}
+/** 形态合法值（序列化 / 反序列化单一来源，勿在别处另立字面量） */
+export function isPanoTexMode(v) {
+    return v === "tiled" || v === "whole";
+}
+/** 缺失格涂灰（09-29 晚旨「不足张数缺的地方涂灰，一眼看出数据不全」）。
+ *  取 #767676 ≈ mapping 模式 `uFaceMissingColor`（线性 0.18）的 sRGB 值，两处观感一致。
+ *  10-06 起拼合器只有一份（canvas 那一份奉旨删除）⇒ 常量搬到本文件当唯一来源。 */
+export const MISSING_TILE_GRAY = "#767676";
+/** 接缝余量（**原图像素**，每片向四边各多切这么多；贴原图边那侧裁到剩多少算多少）。
+ *
+ *  10-06 槽内改成 4×4 = 16 格 ⇒ 一张槽内部的接缝从旧版的 1 条十字变成 **3 横 3 竖**，这一条是随之而来的画质护栏：
+ *   ① 上传时每片**向四边多切 M 像素**（`rtStitchTileRects`）；
+ *   ② 拼合时**只采中间那块**（`rtStitchTileInset` 算出的 UV 内缩窗口），多切的那一圈**不画进格子**。
+ *
+ *  为什么这样就没了细亮/细暗线：缝的病根是「双线性 / mipmap 在瓦片边界外拿不到邻居像素，只能复制自己的
+ *  边缘像素」（就是 `PanoTexMode` 文件头 ② 那条）。多带的 M 像素就是**真的邻居像素**，插值不再靠复制。
+ *
+ *  M 取 8 够不够：一格 1024×1024px、一片原图 1488×1488px（横 W/8、竖 H/4）⇒ 两个方向都是 1.45× 缩小，
+ *  三线性 mip 的 footprint 半径最大约
+ *  `2 × 1.45 ≈ 3` texel ⇒ 8px 有 ≈2.7 倍余量；再小一档（4px）也够用，取 8 是给「原图比 8192 窄 ⇒ 格子
+ *  反而在放大」那类点留边界。**代价**：每片文件比「正好 1/8」宽 16px、高 16px（≈ +4% 面积），⛔ 不是降质。 */
+export const RT_STITCH_SEAM_MARGIN_PX = 8;
+/** 32 瓦片批次的标识 = 第一条**非空**瓦片地址（同批上传 URL 前缀一致，足以唯一；
+ *  09-29 晚旨「不足张数缺的地方涂灰」后批次里允许有空串占位 ⇒ 取首个非空，防首张缺失时键为空串互撞） */
+export function rtStitchBatchOf(tiles) {
+    return tiles.find((u) => u) || "";
+}
+/** 某一拼合槽的虚拟键：`rt:<batch>#<slot>` */
+export function rtStitchKey(batch, slot) {
+    return `${RT_STITCH_KEY_PREFIX}${batch}#${slot}`;
+}
+/** 是否拼合槽（`rt:<batch>#<slot>`）的虚拟键 —— 16 片 / 64 片 / 现行 32 片**同一个前缀**，键本身不含片数信息 */
+export function isRtStitchKey(key) {
+    return key.startsWith(RT_STITCH_KEY_PREFIX);
+}
+/** 解析虚拟键 → { batch, slot }；非 rt 键返回 null */
+export function rtStitchKeyParts(key) {
+    if (!isRtStitchKey(key))
+        return null;
+    const body = key.slice(RT_STITCH_KEY_PREFIX.length);
+    const i = body.lastIndexOf("#");
+    if (i < 0)
+        return null;
+    return { batch: body.slice(0, i), slot: Number(body.slice(i + 1)) };
+}
+/** 槽 slot 用哪 16 张瓦片（原图 **8 列 × 4 行 行优先**下标 `r*8+c`；**槽内格序 = 4×4 行优先、图像左上起**）：
+ *  槽 0 = 图像**左半幅**（行 0-3 × 列 0-3）→ `[0,1,2,3, 8,9,10,11, 16,17,18,19, 24,25,26,27]`；
+ *  槽 1 = **右半幅**（行 0-3 × 列 4-7）→ `[4,5,6,7, 12,13,14,15, 20,21,22,23, 28,29,30,31]`。
+ *  ⭐ 竖着**不再分块**（皇上旨「每个全景纹理由左右 2 个 RT 组成」）⇒ 两个槽**都是全高**，只按 u 分左右，
+ *    故槽纹理也必须跟着变正方形（见 `RT_STITCH_SLOT_W/H` 那条注释，⛔ 别只改这里漏了那边）。
+ *  ⚠️ 表是**从上面那几个网格常数生成**的（⛔ 手抄 32 个数）：正确性由护栏 `test/mktmesh.test.js` BE 组
+ *  对着手写死的字面量逐个数断言 —— 改了网格常数而护栏没跟着改，当场红。 */
+export const RT_STITCH_SLOT_TILES = (() => {
+    // 横向几个槽（COLS/SLOT_GRID = 8/4 = 2）；纵向恒 1 个槽（ROWS/SLOT_GRID = 4/4 = 1 ⇒ sr 恒 0 = 全高）
+    const slotCols = RT_STITCH_COLS / RT_STITCH_SLOT_GRID;
+    const slots = [];
+    for (let slot = 0; slot < RT_STITCH_SLOT_COUNT; slot++) {
+        const sr = Math.floor(slot / slotCols) * RT_STITCH_SLOT_GRID;
+        const sc = (slot % slotCols) * RT_STITCH_SLOT_GRID;
+        const ids = [];
+        for (let r = 0; r < RT_STITCH_SLOT_GRID; r++) {
+            for (let c = 0; c < RT_STITCH_SLOT_GRID; c++)
+                ids.push((sr + r) * RT_STITCH_COLS + (sc + c));
         }
-        // 实例染色：默认白=原全景色；选中黄（FurnitureObject.highlight 写入 instanceColor）染黄高亮。
-        // 普通 Mesh（墙/地板）无 instanceColor，USE_INSTANCING_COLOR 不定义，此分支被编译剔除。
-        #ifdef USE_INSTANCING_COLOR
-            col *= vInstanceColor;
-        #endif
-${PANO_TINT_ON ? `        // 🔬 归属诊断配色（皇上旨 2026-09-25「就在最后算出来的颜色再叠加上颜色，不用想那么复杂」）：
-        //    整段只在 ?panoTint=1 时生成，默认关 ⇒ 正常态一行都没有。色相全交给所属景点，只保留明暗，
-        //    所以亮部/暗部仍看得出是原照片的纹理，但一眼能分「这块面归哪个景点」。
-        //    ⚠️ 与上一版（逐槽染 linK）的区别：这里染的是**最终颜色** ⇒ 即使那一片压根没有候选（一个全景都没绑上、
-        //       露底色）之外的任何区域也照样按归属上色；归属判据与取图判据同一条 = 「存活口径最近一张」。
-        //    ⚠️ 刻意不用「采样色 × 淡色」：那种叠法叠在亮图上几乎发白，肉眼看不出（09-25 已被打回过一次）。
-        //    ⚠️ 强度 = PANO_TINT_MIX（皇上旨 09-26 晚「叠加的颜色比例少一点」）：原来整块换成色相 ⇒ 只剩明暗、
-        //       底下一张全景图完全读不出来；现在按 mix(原色, 染色, 本值) 叠，色相仍占主但照片看得见了。
-        if (tintCnt > 0.0) {
-            vec3 tintHue = tintAcc / tintCnt;
-            float tintLum = dot(col, vec3(0.2126, 0.7152, 0.0722));
-            vec3 tintTo = tintHue * (0.55 + 0.45 * clamp(tintLum * 3.0, 0.0, 1.0));
-            col = mix(col, tintTo, ${PANO_TINT_MIX});
-        }` : ""}${panoDistOn ? `
-        // 🔬 距离明暗诊断（皇上旨 09-26 晚「距离越小越白、越远越黑」+ 09-27 早「按我有 4 个全景点来写代码」+
-        //    09-27 晚「我一开始的需求就是要把 4 个全景点的坐标传给 shader，按最近取用」）：
-        //    **一句真循环**遍历 uPanoPoints[0..${maxPano - 1}]，每个像素只留「到最近那个景点」的水平距离。
-        //    ⚠️ 纯水平距离最近（09-27 晚定版后与取图**同把尺**，夹角门已废）⇒ 墙背后的景点也往这面墙上画圆，
-        //       一个面能看满 N 个渐变圆；代价 = 明暗图不分身前身后（与取图口径一致）。
-        ${panoDistLoopGlsl("col", maxPano)}` : ""}
-        gl_FragColor = vec4(col, 1.0);
-        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
-        #include <colorspace_fragment>
-        #include <logdepthbuf_fragment>
+        slots.push(ids);
     }
-`;
-}
-/** 融合材质的全景点数**上限**：每点占 **2** 张拼合槽纹理（32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
- *  ⭐ 2026-10-06 晚皇上旨「一次能够展示 8 个全景纹理」：靠的就是「每点从 4 槽降到 2 槽」——
- *     sampler 总数 16 是硬件硬顶（皇上本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16，一直没变），
- *     原来 16 ÷ 4 槽 = 4 个景点，现在 16 ÷ 2 槽 = **8 个景点**，画质与单全景显存**分毫未动**。 */
-export const MKT_PANO_MAX_SLOTS = 8;
-/**
- * 创建「多全景融合」着色器材质：每帧由外部喂入最近 maxPano 个全景点（⭐ 10-06 晚旨后每点 2 张拼合槽纹理）。
- * 同一份着色器同时服务普通 Mesh（墙/地板）与 InstancedMesh（家具立方体）：
- * 实例化与否由 three.js 按对象类型自动注入 USE_INSTANCING 宏决定，无需外部传 instanced 开关。
- * 数组 uniform 在创建时即按 maxPano 长度初始化（占位纹理 + 单位矩阵 + 权重 0），运行时由渲染器每帧改写对应槽位。
- * ⚠️ 取图口径只有一条（皇上旨 2026-09-25 晚「都要一起改」→ 09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
- * 地板 / 墙 / 家具**全部**按「水平距离最近的一张」取图（09-24~09-25 的夹角门已整链删除），
- * 不再有「地板按覆盖度融合」这条路，故也**没有** `pickNearest` 选项（旧的 0/1 分流 uniform 已删）。
- */
-export function createMktFloorBlendShaderMaterial(options = {}) {
-    // 2026-09-20：每个全景点占 N 张纹理槽，故「最多融合点数」maxPano 与纹理上限挂钩：
-    // maxPano × N 张纹理须 ≤ 16（shader sampler 上限）。
-    // 2026-09-24 皇上旨「同一时间要准备 4 个全景的瓦片纹理，一共刚好 16 个」（当时 N=4 ⇒ 上限 4）。
-    // ⭐ 2026-10-06 晚旨「一次能够展示 8 个全景纹理」：N 从 4 降到 **2**（每个全景只占左右两张 RT）
-    //    ⇒ 16 ÷ 2 = **上限 8 个景点**，默认就取满 8。画质 / 单全景显存**分毫未动**。
-    // ⚠️ 10-06 切 32 片之后这两个槽各是「16 片拼出来的一张 4096² RT」，sampler 总数仍是 16（硬顶）。
-    // ⚠️ 所有喂同一批数据的材质必须同档：某处写成 3 而喂料方按 8 喂，会往 panos[6..15] 越界写、着色器读到 undefined sampler。
-    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
-    // 🔬 这一份材质是否带「近白远黑」图：显式传了听他的（编辑器），没传读 URL（发布页/预览默认关）。
-    const panoDistOn = options.panoDist ?? PANO_DIST_ON;
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 总纹理槽数 = 点数 × 每点槽数（8 × 2 = 16 = sampler 硬顶）
-    const panoramas = [];
-    const matrices = [];
-    const weights = new Float32Array(maxPano); // 默认全 0（未参与）
-    for (let i = 0; i < tileCount; i++) {
-        panoramas.push(createPlaceholderTexture());
-    }
-    for (let i = 0; i < maxPano; i++) {
-        matrices.push(new Matrix4());
-    }
-    return new ShaderMaterial({
-        uniforms: {
-            panoramas: { value: panoramas },
-            textureMatrices: { value: matrices },
-            weights: { value: weights },
-            // 地板底色（线性空间深灰，约 sRGB 0.27）：远处露出此色
-            uFloorBaseColor: { value: new Vector3(0.06, 0.06, 0.06) },
-            // 🔬 归属诊断色（每槽一个 vec3 = 该槽里那个景点的固定色）：**只在 ?panoTint=1 时创建**，
-            //    关态连 uniform 都不存在（JS 侧三元）⇒ 线上正常路径零开销。默认白 = 未被应用层写过。
-            ...(PANO_TINT_ON
-                ? { uPanoTintColors: { value: Array.from({ length: maxPano }, () => new Vector3(1, 1, 1)) } }
-                : {}),
-            // 🔬 距离明暗诊断的「黑端米数」：**这份材质 panoDist 为真才创建**（默认 16 ≈ 常见房间对角线，
-            //    应用层每次喂投影时按现场量出的尺子写实际值，见 setMktPanoDistRange）；
-            //    uPanoPoints = 同一张图的**圆心清单**（每格一个 vec4，w=1 表示这格有个全景点，见 setMktPanoPoints）
-            ...(panoDistOn ? {
-                uPanoDistMax: { value: 16 },
-                uPanoPoints: { value: Array.from({ length: maxPano }, () => new Vector4(0, 0, 0, 0)) },
-            } : {}),
-            // ⚠️ 下面两根覆盖半径：着色器自 09-25 晚「都要一起改」起**不再读它们**（覆盖度融合那一路已删），
-            //    uniform 与应用层写入暂留 ⇒ 面板上那两根旋钮调了没有视觉变化，删不删等皇上旨意。
-            uFloorCoreRadius: { value: 4 },
-            uFloorFadeRange: { value: 4 },
-            // 整体透明度（0~1）：仅缩放全景图映射的可见度（覆盖度×此值），地板灰底不变；全局对所有全景一起生效；1=全景完全可见
-            uFloorOpacity: { value: 1 },
-            // 全景投射显隐：1=显示全景，0=仅显示素色（墙体回落中性色，地板恒为 1）
-            uPanoramaVisible: { value: 1 },
-            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
-            // 全景上下方向**已写死**，无 uniform（见文件头 🎛️ 段）。
-            // 每点各自的「这 2 槽是瓦片(1)/同一张整图(0)」，由喂料处按「PanoTexMode + 真实 tiles」写（setMktPanoTiled）；
-            // 默认全 1 = 维持改造前的瓦片口径（真实上传的图都是四瓦片）。
-            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
-            // 投影空间逆矩阵：默认单位阵（= 世界坐标，行为与改造前一致）。
-            // 融合材质默认**永不**写入它 —— 编辑器地板/立方体、预览立方体因此完全不受 MktMesh 变换影响。
-            uProjInvMatrix: { value: new Matrix4() },
-        },
-        vertexShader: floorVertexShader,
-        fragmentShader: buildFloorBlendFragment(maxPano, panoDistOn),
-        side: DoubleSide,
-        transparent: false,
-        toneMapped: false,
-    });
-}
-/**
- * 「仅显示选中全景」片元（皇上旨 2026-09-29「三模式三 shader」之三）：
- * 整面恒显示 **0 号点槽**那一张全景 —— 不看距离、不看夹角、不看序号，槽里是谁就投谁
- * （喂料侧保证 0 号槽 = 当前选中的全景、其余槽留空）。
- * uniform 形状与 blend 同档 ⇒ 喂料复用 feedBlendProjection 槽位指派路零改动；
- * GLSL 只读 0 号点槽，其余槽是声明了没人采的死重（开销可忽略）。
- * 槽没绑好（weights[0]≤0，选中全景瓦片还在路上 / 没选中任何全景）→ 露 uFloorBaseColor 深灰底。
- */
-function buildFloorSelectedFragment(maxPano) {
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 形状与 blend 同档（喂料共用）
-    return /* glsl */ `
-    #include <logdepthbuf_pars_fragment>
-    uniform sampler2D panoramas[${tileCount}]; // 形状与 blend 同档（喂料共用）；本 shader 只采 0 号点槽（纹理 0..1）
-    uniform mat4 textureMatrices[${maxPano}];
-    uniform float weights[${maxPano}];         // 0 号槽 > 0 = 选中全景的瓦片已绑好
-    uniform float uPanoTiled[${maxPano}];
-    uniform vec3 uFloorBaseColor;              // 槽没绑好时露出的深灰底（线性空间，约 sRGB 0.27）
-    uniform float uFloorOpacity;               // 整体透明度（与 blend 同口径：只缩放全景可见度，底色不变）
-    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 pow 分支已整条撤除（与 blend 同口径）
-    uniform float uPanoramaVisible;
-    varying vec3 vProjPos;
-    #ifdef USE_INSTANCING_COLOR
-    varying vec3 vInstanceColor;
-    #endif
-    void main() {
-        // ── 0 号点槽（纹理 0..1，即左右那 2 张拼合槽）：选中的全景独占（采样段与 blend 逐字同口径）──
-        vec3 lin0 = vec3(0.0);
-        if (weights[0] > 0.0) {
-            mat4 tm = textureMatrices[0];
-            vec3 texPos = tm[3].xyz;
-            mat3 texRot = mat3(tm);
-            vec3 dir = normalize(vProjPos - texPos);
-            dir = texRot * dir;
-            float lon = atan(dir.z, dir.x);
-            float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
-            float lat = asin(clamp(dir.y, -1.0, 1.0));
-            float v = 0.5 + lat * 0.3183098861837907; // 1/PI（等距柱状线性 v，与 blend 逐字同口径）
-            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（左右两半：[左半幅=0, 右半幅=1]），与 blend 逐字同口径
-            int tileIdx = (u >= 0.5) ? 1 : 0;
-            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
-            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v
-            float localV = v;
-            float panoU = (uPanoTiled[0] > 0.5) ? localU : u;
-            float panoV = (uPanoTiled[0] > 0.5) ? localV : v;
-            // ⭐ 采样即线性（与单全景 / blend 那两路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
-            //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
-            //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
-            if (tileIdx == 0) lin0 = texture2D(panoramas[0], vec2(panoU, panoV)).rgb;
-            else lin0 = texture2D(panoramas[1], vec2(panoU, panoV)).rgb;
+    return slots;
+})();
+/** 槽内第 cell 格在**图像方向**的位置 `[列, 行]`（0 起，与 `RT_STITCH_SLOT_TILES` 的格序同一口径）。
+ *  ⚠️ 这是「图像方向」（行 0 = 图像最上），GL 的 y 向上 ⇒ 画进 RT 时 y 要翻（拼合器里那句 `1 - (2*r+1)/n`）。 */
+export function rtStitchCellPos(cell) {
+    return [cell % RT_STITCH_SLOT_GRID, Math.floor(cell / RT_STITCH_SLOT_GRID)];
+}
+/** 网格取整：第 `i` 条分界线在原图 `n` 像素上的位置（`round` ⇒ 余数摊到各格，
+ *  ⛔ 不必再像旧上传代码那样特判「末行末列吸收余数」）。
+ *  ⚠️ `steps` = **该方向**切几片（横 `RT_STITCH_COLS` / 竖 `RT_STITCH_ROWS`）：10-06 晚起两个方向
+ *     **不再相等**（8×4），必须显式传，⛔ 不许再拿一个「每边片数」两边共用 —— 竖着按 8 切 = 纵向切错。 */
+function gridLine(i, n, steps) {
+    return Math.round((i * n) / steps);
+}
+/** 32 片瓦片的切图矩形（行优先、图像左上起，下标 `i = r*8+c` 与 `RT_STITCH_SLOT_TILES` 同源；
+ *  ⭐ 10-06 晚旨「横 8 × 竖 4 = 32」：`r` 走 `RT_STITCH_ROWS`(4)、`c` 走 `RT_STITCH_COLS`(8)，不再相等）。
+ *
+ *  ⭐ **上传侧（`panoramaUpload`）与拼合侧（`PanoTileStitcher`）必须共用这一份几何**：
+ *  上传多切多少、拼合就内缩多少；两边各算一次就是「缝没治掉、反而把画面挤歪」。
+ *  拼合侧拿不到原图尺寸（它只有 32 个 URL 和 32 张已解码纹理），所以它用 `rtStitchTileInset`
+ *  —— 那条只需「下标 + 该瓦片自己的像素尺寸」，两者等价的前提是「多切量 = 常数 M、只有贴边那几片被裁」，
+ *  而「贴不贴边」纯由下标决定 ⇒ 护栏 BE 组用同一批 (W,H) 把两条算路对表钉死。 */
+export function rtStitchTileRects(w, h) {
+    const out = [];
+    for (let r = 0; r < RT_STITCH_ROWS; r++) {
+        for (let c = 0; c < RT_STITCH_COLS; c++) {
+            const x0 = gridLine(c, w, RT_STITCH_COLS);
+            const x1 = gridLine(c + 1, w, RT_STITCH_COLS);
+            const y0 = gridLine(r, h, RT_STITCH_ROWS);
+            const y1 = gridLine(r + 1, h, RT_STITCH_ROWS);
+            const ml = Math.min(RT_STITCH_SEAM_MARGIN_PX, x0);
+            const mr = Math.min(RT_STITCH_SEAM_MARGIN_PX, w - x1);
+            const mt = Math.min(RT_STITCH_SEAM_MARGIN_PX, y0);
+            const mb = Math.min(RT_STITCH_SEAM_MARGIN_PX, h - y1);
+            out.push({ sx: x0 - ml, sy: y0 - mt, sw: x1 + mr - (x0 - ml), sh: y1 + mb - (y0 - mt), ml, mt, mr, mb });
+        }
+    }
+    return out;
+}
+/** 这片瓦片有没有贴原图边界（8×4 ⇒ 32 片里四周那 20 片至少贴一条边；贴边的**那一侧**多切量被裁成 0）。
+ *  拼合侧靠它 + 瓦片自己的像素尺寸还原内缩量 ⇒ 不必知道原图多大。
+ *  ⚠️ 下标拆分必须按 **列数 COLS=8**（`i = r*8+c`），⛔ 不是 ROWS。 */
+export function rtStitchTileEdgeClip(i) {
+    const r = Math.floor(i / RT_STITCH_COLS);
+    const c = i % RT_STITCH_COLS;
+    return {
+        left: c === 0,
+        right: c === RT_STITCH_COLS - 1,
+        top: r === 0,
+        bottom: r === RT_STITCH_ROWS - 1,
+    };
+}
+/** 拼合时的采样窗口 = 该瓦片纹理的 UV 里「**只留基础格、丢掉多切那一圈**」的那一块，
+ *  返回 `[u0, v0, u1, v1]`（片元里 `mix(vec2(u0,v0), vec2(u1,v1), vUv)`）。
+ *
+ *  `tw/th` = 该瓦片纹理的**实际**像素宽高。内缩比例 = `M / sw`（多切那 M 像素占整片的比例），
+ *  与「文件是不是正好等于标称切片区」无关 ⇒ 编码差 1px 也不会露出邻居的格子。
+ *  贴原图边那一侧内缩 0：那里压根没多切，且那条边界就是全景自己的边（`ClampToEdge` 照旧）。
+ *
+ *  ⚠️ v 方向口径（与 `panoBitmapTexture` 绑死）：瓦片走 `imageOrientation:"flipY"` 预翻 + `texture.flipY=false`
+ *  ⇒ 纹理 **v=0 = 图像下边**，所以图像顶部余量 `mt` 落在 `v1`、底部 `mb` 落在 `v0`。搞反 = 上下颠倒。 */
+export function rtStitchTileInset(i, tw, th) {
+    const e = rtStitchTileEdgeClip(i);
+    const m = RT_STITCH_SEAM_MARGIN_PX;
+    const u0 = e.left ? 0 : Math.min(0.5, m / tw);
+    const u1 = e.right ? 1 : 1 - Math.min(0.5, m / tw);
+    const v0 = e.bottom ? 0 : Math.min(0.5, m / th);
+    const v1 = e.top ? 1 : 1 - Math.min(0.5, m / th);
+    return [u0, v0, u1, v1];
+}
+/**
+ * 「这 `RT_STITCH_SLOT_COUNT`(2) 个纹理槽到底喂哪几个地址」。⚠️ **必须**与 `mktPanoTiledFlag` 同源、同一时机调用：
+ * 只改标记不改地址（或反之）= 用整图 UV 去采一张瓦片 / 用瓦片内 UV 去采整图，画面立刻错乱。
+ * 非 tiled 态（或该点压根没切过片）一律回退成「各槽同为一张整图」。
+ * ⭐ 2026-10-06 晚旨「只支持 32 张（8×4）」：只要有瓦片（1~32 条）一律走拼合器（rt: 虚拟键），
+ *   不足 32 张的位置由拼合器**涂灰**（一眼看出数据不全）；8×8=64 张与 4×4=16 张那两版**都不做兼容**
+ *   （皇上「无须兼容正常使用，有异常我会重传」⇒ 旧存档的 64 条地址超张数被判废、重传即可）。
+ * ⚠️ 返回长度由 `RT_STITCH_SLOT_COUNT` 派生（⛔ 不许手写 2 个 rtStitchKey —— 槽数再变会漏改）。
+ */
+export function mktPanoTexUrls(url, tiles, mode = "tiled") {
+    if (mode === "tiled" && tiles && tiles.length > 0) {
+        const batch = rtStitchBatchOf(tiles);
+        return Array.from({ length: RT_STITCH_SLOT_COUNT }, (_, s) => rtStitchKey(batch, s));
+    }
+    return Array.from({ length: RT_STITCH_SLOT_COUNT }, () => url);
+}
+/**
+ * 「这 2 个纹理槽是不是真瓦片」的判据 —— **必须**与喂纹理处的回退式（`mktPanoTexUrls`）同源：
+ * `tiles` 有 **任意 1~32 条**地址（不足 32 = 数据不全，缺的格子拼合时涂灰）**且**当前形态选的是 tiled = 是瓦片；
+ * 否则各槽同为一张整图（旧数据 / 种子图 / 用户切整片）。
+ */
+export function mktPanoTiledFlag(tiles, mode = "tiled") {
+    return mode === "tiled" && tiles && tiles.length > 0 ? 1 : 0;
+}
+/**
+ * 写入 uPanoTiled（2026-09-22「交换 / 不交换完全一样」的修复）。
+ *
+ * 单全景材质该 uniform 是标量；融合材质是**每点一个**的数组（不同点来源可能不同），故带 slot。
+ * 材质没有该 uniform（旧材质 / 误传）时静默跳过，不抛错。
+ */
+export function setMktPanoTiled(material, tiled, slot = 0) {
+    if (!material || !material.uniforms)
+        return;
+    const u = material.uniforms.uPanoTiled;
+    if (!u)
+        return;
+    if (Array.isArray(u.value) || ArrayBuffer.isView(u.value)) {
+        const arr = u.value;
+        if (slot >= 0 && slot < arr.length)
+            arr[slot] = tiled;
+    }
+    else {
+        u.value = tiled;
+    }
+}
+/**
+ * 创建 MktMesh 专用的「实例化 + 等距柱状投影全景」着色器材质。
+ * panorama / textureMatrix 由 MktMesh 在运行时按「最近纹理」动态设置。
+ */
+export function createMktShaderMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            // 一个全景点恒占 **2 个 sampler**（2026-10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」）：
+            // panoramas[0..1] = 2 张**离屏拼合槽纹理**（[左半幅, 右半幅]，每槽由 `RT_STITCH_CELLS_PER_SLOT`
+            // 片瓦片拼成），片元按全景 UV 的 **u** 挑对应槽采样（v 不再分块）。
+            // ⛔ 长度由 `RT_STITCH_SLOT_COUNT` 派生（不许手写 2 张）—— 槽数再变这里会漏改。
+            panoramas: {
+                value: Array.from({ length: RT_STITCH_SLOT_COUNT }, () => createPlaceholderTexture()),
+            },
+            textureMatrix: { value: new Matrix4() },
+            uPanoramaVisible: { value: 1 }, // 全景投射显隐：1=显示全景，0=仅显示中性素色（编辑态切换/投射显隐开关用）
+            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 连同着色器里那段 pow 分支已整条撤除
+            // 全景上下方向**已写死**，无 uniform（见文件头 🎛️ 段）。
+            // 1 = panoramas[0..1] 是 2 张拼合槽纹理（左/右半幅）；0 = 两槽同为一张完整等距柱状图（改用全图 UV）。
+            // 由喂纹理处按「用户选的 PanoTexMode + 数据来源」写（setMktPanoTiled）；默认 1 与改造前行为逐字一致。
+            uPanoTiled: { value: 1 },
+            // 投影空间逆矩阵：默认单位阵 = 直接用世界坐标（与改造前行为逐字节一致）。
+            // 仅由 MktMesh 自身按 matrixWorld 写入，使墙的投影与 MktMesh 整体变换解耦（皇上旨 2026-09-19）。
+            uProjInvMatrix: { value: new Matrix4() },
+            // 🔬 归属诊断色（线性空间）：**只在 ?panoTint=1 时创建**（JS 侧三元，关时连 uniform 都不存在）
+            //    ⇒ 「仅映射选中的那一个」那套墙/家具材质也带上该景点的固定色，见 setMktPanoTint。
+            ...(PANO_TINT_ON ? { uPanoTint: { value: new Vector3(1, 1, 1) } } : {}),
+            // 🔬 距离明暗诊断的「黑端米数」：**只在 ?panoDist=1 时创建**；默认 16 ≈ 常见房间对角线
+            //    （应用层每次喂投影时按 floorSize 写实际值，见 setMktPanoDistRange；万一没喂也不会整图黑）
+            ...(PANO_DIST_ON ? { uPanoDistMax: { value: 16 } } : {}),
+        },
+        vertexShader,
+        fragmentShader,
+        // 双面渲染（DoubleSide）：09-29 皇上旨「3 个 shader 的 side 参数需要保持一致」——
+        // 四个全景 shader 工厂（单全景 / blend / mapping / selected）统一 DoubleSide，
+        // 墙零厚度两面都要见投影，家具/地板与墙两面行为一致（旧 FrontSide「正/反面立方体互不可见」
+        // 的设计早被编辑器三模式切换的 DoubleSide 三件套冲掉，留着只是初始态不一致的祸根）。
+        side: DoubleSide,
+        // 面片一律不透明（每实例透明度已移除）：走不透明队列，写深度且免去按距离排序开销
+        transparent: false,
+        // 跳过 ThreeBase 的 ReinhardToneMapping，避免压暗全景颜色（色彩空间口径见文件头 ③：硬件解码一次、片元不再手动 pow）
+        toneMapped: false,
+    });
+}
+/**
+ * 多全景融合着色器：把「最近最多 maxPano 个全景」以数组传入，每个片元对这些张各自做等距柱状投射，
+ * 再取**唯一一条**口径（皇上旨 2026-09-25 晚「都要一起改」→ 2026-09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
+ * - **候选里只取水平距离最近的那一张，满权重**（地板 / 墙 / 家具立方体**同一份、同一条**，
+ *   旧的「地板按覆盖度加权融合、交界渐隐」那一路已按旨删除 ⇒ 面上不再有渐隐带，也不再有中央露灰）。
+ * - ⚠️ 09-24~09-25 的「夹角门（点在面正面侧才合格）+ 全不合格兜底」已按 09-27 晚旨**整链删除**：
+ *   它是「明暗圆对、纹理不对」的第二来源（墙背后更近的点被门否掉，纹理落到正面侧的远槽）；
+ *   纯距离口径下墙背后的全景也会投过来，皇上知情选定。
+ * - 候选池按「槽里有没有全景」筛，**不按覆盖半径（c>0）筛**，否则两个景点距离一远就变成
+ *   「各占一片互不相干的 territory、交界处整条露灰底」，距离判据压根轮不到（实测 bothCandidates=0）。
+ * - ⚠️ 代价（已向皇上报过并获批）：`uFloorCoreRadius` / `uFloorFadeRange` 两根覆盖半径旋钮**从此对任何面都不参与取图**。
+ *   控件与 uniform 暂未删（未奉旨），删与不删等皇上下结论。
+ * - panoramas[i]      : 第 i 张全景纹理
+ * - textureMatrices[i]: 第 i 张全景的世界矩阵（位置=投影中心，旋转=朝向）
+ * - weights[i]        : 第 i 张是否活着（camW，0 = 该槽未绑全景 ⇒ 不进候选池）
+ */
+/**
+ * 生成多全景片元着色器（地板 / 墙 / 家具共用）。
+ * ⚠️ 关键约束：Windows/ANGLE(D3D) 后端**禁止用循环变量/非常量索引 sampler 数组**（报错
+ * "array index for samplers must be constant integral expressions"），故这里在 JS 侧把循环
+ * 完全展开成「字面量下标」的若干代码段（panoramas[0]…panoramas[N-1]），所有数组访问均为常量下标。
+ * 未参与融合的槽位权重=0，被 if(w>0.0) 跳过（常量分支，零开销）。
+ */
+function buildFloorBlendFragment(maxPano, panoDistOn) {
+    // 每个全景点占 **2** 张拼合槽纹理（32 片每 16 片拼一张：左半幅 / 右半幅）⇒ 8 × 2 = 16 = sampler 硬顶
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT;
+    let slotCalc = ""; // 每槽各自算出：颜色 linK / 水平距离 dK / 夹角 angK（acos+背面+180°）/ 分值 scoreK = d−ang
+    let slotReduceLive = ""; // 每槽参与「score 最小值」归约（候选池 = 槽里活着的那几张，score<1e8 即活）
+    let slotOne = ""; // 每槽对「只取 score 最小那一张」的贡献（唯一取图口径，地板/墙/家具共用）
+    let slotOwner = ""; // 🔬 每槽对「归属诊断色」的贡献（仅 ?panoTint=1 时生成，正常态为空串）
+    for (let k = 0; k < maxPano; k++) {
+        const base = k * RT_STITCH_SLOT_COUNT; // 本点占 2 个连续纹理槽：base=k*2 .. base+1（顺序 [左半幅, 右半幅]）
+        slotCalc += `
+        // ── 点槽 ${k}（纹理 ${base}..${base + 1}）──
+        vec3 lin${k} = vec3(0.0);
+        float d${k} = 1e9;     // 本面这点到本槽全景中心的**水平**距离（score 被减数）
+        // float camD${k} —— 14:24 旨曾加「全景中心到相机距离」项，15:07 旨去掉（连声明一并去，注释存档）
+        float cosA${k} = -1.0; // 「点→全景」向量 与 正面法线 的夹角余弦（acos 后 = 夹角弧度）
+        float ang${k} = 1e9;   // 夹角（acos 后 0..180°，背面 +180° ⇒ 270°..360°），score 的减数
+        float score${k} = 1e9; // ⭐主判据（皇上 09-28 15:07 旨七修）：score = 顶点与全景的距离 − 夹角，取**最小**者定纹理
+        // ── 旧原理存档（注释保留不删）──
+        // 09-28 14:24 旨「score = 顶点距离 + 相机距离 − 夹角」：camD 项已整条撤（见下方槽内注释行）
+        // 09-28 00:44 旨「score = 距离 × 夹角²，取积最小」：见下方槽内注释行
+        // 09-28 01:56 旨「按夹角从小到大排序取最小、打平比水平距离」：bestAng/bestDAtAng 两段归约（已撤，git 可查）
+        {
+            float camW = weights[${k}];   // 该全景的「锚点距离权重」（JS 按**名册那条水平距离**反比算，未归一化；⭐ 10-07 第二十一道旨后那把尺量的端点 = 控制器中心点，未注入时才是相机位置）
+            if (camW > 0.0) {
+                mat4 tm = textureMatrices[${k}];
+                vec3 texPos = tm[3].xyz;            // 投影中心 = 纹理矩阵位置
+                mat3 texRot = mat3(tm);             // 纹理朝向 = 旋转分量
+                vec3 dir = normalize(vProjPos - texPos);
+                dir = texRot * dir;                 // 转到纹理局部方向
+                float lon = atan(dir.z, dir.x);
+                float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
+                float lat = asin(clamp(dir.y, -1.0, 1.0));
+                // 等距柱状线性 v（= 全图 UV），与单全景分支**逐字同口径**，理由见单全景分支说明
+                float v = 0.5 + lat * 0.3183098861837907; // 1/PI
+                // 左右两半 -> 拼合槽下标 [左半幅=0, 右半幅=1]（每槽 = 8×4 网格里 4×4=16 片拼成，见 RT_STITCH_SLOT_TILES）
+                // ⭐ 10-06 晚旨「每个全景纹理由左右 2 个 RT 组成」：竖着不再分块 ⇒ 槽只随 u 走，与单全景分支逐字同口径
+                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 = 纵向分辨率白丢一半
+                float localV = v;
+                // 🧩 该点这 2 槽装的是整图（用户切了 whole 形态，或该点压根没切过片）⇒ 还原成全图 UV 再采样，与单全景分支逐字同口径
+                //    （方向已写死，故横向还原式恒等于 u、纵向 localV 本就等于 v，见单全景分支推导）
+                float panoU = (uPanoTiled[${k}] > 0.5) ? localU : u;
+                float panoV = (uPanoTiled[${k}] > 0.5) ? localV : v;
+                // ⚠️ ANGLE(D3D) 禁止动态索引 sampler 数组：base 为本点连槽起点（JS 常量 k*RT_STITCH_SLOT_COUNT），
+                //    以下 2 个采样下标均为「base + 字面量 0/1」的常量表达式，编译安全。
+                // 🔬 诊断直通（见文件头 TILE_DEBUG_GLSL 说明；正常态内联为 0.0，整段被编译器消除）
+                if (${TILE_DEBUG_GLSL} > 0.5) {
+                    vec3 dbgCol;
+                    if (tileIdx == 0) dbgCol = vec3(1.0, 0.0, 0.0);      // 红 = 左半幅槽 0
+                    else dbgCol = vec3(0.0, 1.0, 0.0);                   // 绿 = 右半幅槽 1
+                    gl_FragColor = vec4(dbgCol, 1.0);
+                    #include <colorspace_fragment>
+                    #include <logdepthbuf_fragment>
+                    return;
+                }
+
+                // ⭐ 采样即线性（与单全景分支同一条口径，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;
+                // ⭐ 09-28 15:07 旨定版（七修）：score = **顶点到全景的距离 − 夹角**，取最小者。
+                //    夹角 = acos(cosA)（0..180°），cosA = dot(normalize(全景中心 − 本点), N)（N 已按 gl_FrontFacing 翻到观察面）。
+                //    背面一刀 +180°（00:26 旨「背面的夹角该大于 180 度」）保留。
+                //    14:24 那版曾加「全景与相机的距离 camD」，15:07 旨「把全景到相机的那个逻辑去掉」，注释保留不删。
+                vec3 toPano${k} = texPos - vProjPos;
+                float lenP${k} = length(toPano${k});
+                cosA${k} = (lenP${k} > 1e-4) ? dot(toPano${k} / lenP${k}, N) : 1.0;
+                d${k} = distance(vProjPos.xz, texPos.xz);
+                // camD${k} = distance(cameraPosition, texPos);   // ⛌ 14:24 旨「全景与相机距离」项，15:07 旨去掉，注释保留不删
+                ang${k} = acos(clamp(cosA${k}, -1.0, 1.0));
+                if (cosA${k} < 0.0) ang${k} += 3.14159265;   // 背面 +180°（π）
+                score${k} = d${k} - ang${k};                 // ⭐ 15:07 旨：距离 − 角度，取最小
+                // score${k} = d${k} + camD${k} - ang${k};    // ⛌ 旧原理（14:24 旨：两距离之和 − 角度），注释保留不删
+                // score${k} = d${k} * ang${k} * ang${k};    // ⛌ 旧原理（00:44 旨：距离 × 夹角² 取积最小），注释保留不删
+            }
+        }`;
+        // ⭐ 归约（皇上 09-28 15:07 旨七修「顶点距离 − 夹角」）：bestScore = 各活槽分值最小值。
+        //    score == bestScore 是同值浮点精确比较（min 存的就是同一份 bit 值，== 可靠，与历代口径同一技巧）。
+        slotReduceLive += `
+    if (score${k} < 1e8) {
+        bestScore = min(bestScore, score${k});
+    }`;
+        // ⭐ 胜者（皇上 09-28 15:07 旨七修）：score = 顶点距离 − 角度 最小的那张。
+        slotOne += `
+    if (score${k} < 1e8 && score${k} == bestScore) {
+        wsum += 1.0; acc += lin${k}; cover += 1.0;
+    }`;
+        // 🔬 归属诊断（皇上旨 2026-09-25「就在最后算出来的颜色上再叠颜色，不用想那么复杂」）：
+        //   这里只**记账**（这点归哪个景点），染色动作留到 main 末尾对最终颜色做一次。
+        //   归属判据与 slotOne **逐字同一条**（距离−角度最小），末了统一「打平归编号小的那个」。
+        if (PANO_TINT_ON) {
+            slotOwner += `
+    if (score${k} < 1e8 && score${k} == bestScore) {
+        // ⚠️ tintCnt == 0.0 这道闸 = **打平归编号小的那个**：两张一样近的那条分界带（实测两景点连线的中垂面与墙交线那一带）
+        //    会同时命中两个槽，平均出来是「红+绿=橄榄」—— 那不是没上色，但肉眼读不出归属，故只记第一个。
+        if (tintCnt == 0.0) { tintAcc += uPanoTintColors[${k}]; tintCnt += 1.0; }
+    }`;
         }
-        float coverage = weights[0] > 0.0 ? 1.0 : 0.0;
-        float coverageEff = clamp(coverage * uFloorOpacity, 0.0, 1.0);
-        vec3 col = mix(uFloorBaseColor, lin0, coverageEff);
-        // 全景投射显隐：关闭时回落中性素色（与 blend 一致）
-        if (uPanoramaVisible < 0.5) col = vec3(0.78, 0.78, 0.80);
-        #ifdef USE_INSTANCING_COLOR
-            col *= vInstanceColor;
-        #endif
-        gl_FragColor = vec4(col, 1.0);
-        #include <colorspace_fragment>
-        #include <logdepthbuf_fragment>
+        // 🔬 距离明暗图**不在这儿逐槽拼**了（皇上旨 2026-09-27 晚：要一句真循环遍历 4 个坐标）⇒ 见 `panoDistLoopGlsl`。
     }
-`;
-}
-/**
- * 创建「仅显示选中全景」着色器材质（皇上旨 2026-09-29「三模式三 shader」之三）：仅编辑器使用。
- * uniform 形状与 blend 工厂同档 ⇒ 喂料复用 feedBlendProjection 槽位指派路零改动；
- * 本 shader 只读 0 号点槽（GLSL 写死），uFloorCoreRadius/uFloorFadeRange 喂料会写但不读（静默忽略）。
- */
-export function createMktFloorSelectedShaderMaterial(options = {}) {
-    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
-    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 与 blend / mapping 同档（8 点 × 2 槽 = 16）
-    const panoramas = [];
-    const matrices = [];
-    for (let i = 0; i < tileCount; i++)
-        panoramas.push(createPlaceholderTexture());
-    for (let i = 0; i < maxPano; i++)
-        matrices.push(new Matrix4());
-    return new ShaderMaterial({
-        uniforms: {
-            panoramas: { value: panoramas },
-            textureMatrices: { value: matrices },
-            weights: { value: new Float32Array(maxPano) },
-            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
-            uFloorBaseColor: { value: new Vector3(0.06, 0.06, 0.06) },
-            // 喂料统一入口会写；本 shader 不读 uFloorCoreRadius/uFloorFadeRange（留 JS 项 = 喂料零分支）
-            uFloorCoreRadius: { value: 4 },
-            uFloorFadeRange: { value: 4 },
-            uFloorOpacity: { value: 1 },
-            uPanoramaVisible: { value: 1 },
-            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
-            uProjInvMatrix: { value: new Matrix4() },
-        },
-        vertexShader: floorVertexShader,
-        fragmentShader: buildFloorSelectedFragment(maxPano),
-        side: DoubleSide,
-        transparent: false,
-        toneMapped: false,
-    });
-}
+    return /* glsl */ `
+    #include <logdepthbuf_pars_fragment>
+
+    uniform sampler2D panoramas[${tileCount}];${PANO_TINT_ON ? `
+    // 🔬 归属诊断色（线性空间，**仅 ?panoTint=1 时存在**）：第 i 个纹理槽里躺的那个景点的固定色，
+    //    由应用层每次换绑时写入（见 setMktPanoTint）。⚠️ 刻意不按槽位编译期写死：
+    //    「仅映射选中的那一个」模式下地板永远只喂 0 号槽，按槽写死 = 选第几个点都涂同一个红（皇上 09-25 反馈）。
+    uniform vec3 uPanoTintColors[${maxPano}];` : ""}${panoDistOn ? `
+    // 🔬 距离明暗诊断（这份材质建时 panoDist 选项为真才存在）：「多远算全黑」的米数，由应用层每次喂投影时写
+    //    （见 setMktPanoDistRange）⇒ 全屋同一把尺子，跨面才比得出远近。
+    uniform float uPanoDistMax;
+    // 🔬 距离明暗诊断的**圆心清单**（皇上旨 2026-09-27「shader 里面有四个全景点的坐标, 每个像素判断距离 4 个点里最小的
+    //    那个值, 再用这个值设置颜色」）：xyz = 该点的世界坐标，w = 1 ⇒ 这一格**真有一个全景点**。
+    //    ⛔ 与 weights 的分工（两者刻意不同，别合并）：weights 管「这格的**图**能不能取」（瓦片没绑好就 0，防止拿
+    //    1×1 占位图刷一片素灰），uPanoPoints 管「这格**有没有点**」⇒ 圆按景点个数画，图按传到位的那几张取。
+    //    ⚠️ 09-27 晚起明暗那段**只读这一个数组**（纯水平距离最近）⇒ 与取图同把尺（夹角门已废）；坐标与上面
+    //    textureMatrices[k][3].xyz 同源同值（同一批矩阵喂进来，见 setMktPanoPoints），不是第二套数据。
+    uniform vec4 uPanoPoints[${maxPano}];` : ""}
+    uniform mat4 textureMatrices[${maxPano}];
+    uniform float weights[${maxPano}];   // 锚点距离权重 camW（JS 由名册那条水平距离写入，未归一化；着色器内与空间因子相乘后整体归一化）
+    uniform vec3 uFloorBaseColor;       // 地板底色（线性空间，深灰）：只在「一个候选都没有」（maxPano 张全景全未绑定）时露出来
+    // ⚠️ 下面两根覆盖半径旋钮**自 09-25 晚「都要一起改」起不再参与取图**（覆盖度融合那一路已删，每个像素纯按最近一张）。
+    //    控件与 uniform 暂留（未奉旨删控件），值仍由应用层写入，但着色器不读 ⇒ 调它们没有视觉变化。
+    uniform float uFloorCoreRadius;
+    uniform float uFloorFadeRange;
+    uniform float uFloorOpacity;        // 地板全景投影「整体透明度」（0~1，全局对所有全景一起生效）：仅作用于全景图映射的可见度，越小全景越淡、越透出地板灰底；地板灰色本身不变
+    // 全景投射显隐：1=显示全景（投射到墙/地板），0=仅显示素色（墙体回落中性色，地板恒为 1 不受影响）
+    uniform float uPanoramaVisible;
+    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 sRGB pow 解码分支已整条撤除，
+    //   采样值即线性（纹理标了 SRGBColorSpace ⇒ 硬件解过一次），末端 <colorspace_fragment> 只编码一次。
+    // ⭐ 取图方式只有一条（皇上旨 2026-09-25 晚「都要一起改」→ 09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
+    //   地板 / 墙 / 家具**同一份着色器、同一条判据** —— 候选里只取水平距离最近那**一张**，满权重。
+    //   旧的 uPanoPickNearest（0=地板覆盖度融合 / 1=模型表面取最近）已随融合那一路一起删除；
+    //   09-24~09-25 的夹角门 + 兜底也已按 09-27 晚旨整链删除（它是「明暗圆对、纹理不对」的第二来源）。
+    //   ⚠️ 候选池是「槽里活着的全景」（weights>0，瓦片绑好了的），**不受覆盖半径筛掉**。
+    // 全景上下方向**已写死**，无 uniform（与单全景材质同口径，见文件头 🎛️ 段）。
+    // 每个全景点**各自**的「这 2 槽是瓦片(1)还是同一张整图(0)」—— 融合时不同点可能来源不同（上传的有瓦片、
+    // 旧数据/种子图没有），故按点存数组；为 0 的点走全图 UV，理由见单全景分支同注释。
+    uniform float uPanoTiled[${maxPano}];
+
+    // 取样坐标（已由顶点着色器的 uProjInvMatrix 抵消掉 MktMesh 的整体变换，与 textureMatrices 一样对变换免疫）
+    varying vec3 vProjPos;
+    // 全景序号映射模式：本三角面归属的全局全景序号（顶点着色器从 geometry 的 aPanoIndex 传来；无此 attribute 的对象恒为 0）
+    varying float vPanoIndex;
+    // 几何法线（顶点着色器按同一条矩阵链变换到与 vProjPos 同一空间）：取图「正面夹角」判据用
+    varying vec3 vWNormal;
+    // 实例染色（仅当 InstancedMesh 带 instanceColor 时启用）：默认白=全景真实色，选中黄=高亮染色
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+
+    void main() {
+        // ⭐ 正面法线 N（分值公式里「夹角」的基准，皇上 09-28 凌晨旨「距离 × 夹角」）：几何法线归一化后，
+        //    按 gl_FrontFacing 翻到**观察者看的这一面**（墙零厚度 DoubleSide，两面各自以看到的这面算夹角——
+        //    同一面墙从两侧看，分值不同是应该的）。地板/封盖/立方体同理。
+        vec3 N = normalize(vWNormal);
+        if (!gl_FrontFacing) N = -N;
+${PANO_TINT_ON ? `        // 🔬 归属诊断配色（?panoTint=1）：本面这点归哪个景点（tintAcc 累加其固定色，tintCnt 计数）
+        vec3 tintAcc = vec3(0.0);
+        float tintCnt = 0.0;` : ""}
+${slotCalc}
+        // ⭐ 取图口径（距离+夹角融合，钦定公式）：score = 顶点距离 − 角度，取最小的那**一张**（地板/家具/编辑态墙同一份 shader）。
+        //   （原「uFaceMappingMode 0/1 运行时分支」已按皇上旨 2026-09-29「三模式三 shader」拆出：
+        //    序号直取在 createMktFloorMappingShaderMaterial、仅显示选中在 createMktFloorSelectedShaderMaterial。）
+        vec3 acc = vec3(0.0);
+        float wsum = 0.0;
+        float cover = 0.0;
+        // 「取图胜者」归约（皇上 09-28 15:07 旨七修定版：score = 顶点距离 − 角度，取最小）
+        float bestScore = 1e9;
+${slotReduceLive}
+${PANO_TINT_ON ? "        // 🔬 先记账：这点按「距离减夹角最小」归哪个景点（与下面 slotOne 的取图判据同一条）\n" + slotOwner : ""}
+        // 一面只显一张：score 最小的那张（不论多远，绝不留空面）
+${slotOne}
+        if (wsum > 0.0) acc /= wsum;     // 按总权重归一化（总混合值=1）
+        // 覆盖度：有候选即 1（09-25 晚起不再有「渐隐/露灰」的中间态），只在「一个候选都没有」时 = 0
+        // ⇒ 露出地板/墙体本来的底色。
+        float coverage = clamp(cover, 0.0, 1.0);
+        // 整体透明度仅作用于全景图映射：把覆盖度按 uFloorOpacity 缩放后再混合，
+        // 灰底始终不透明（alpha=1），opacity 越小全景越淡、越透出地板灰色；地板灰色本身不变。
+        float coverageEff = clamp(coverage * uFloorOpacity, 0.0, 1.0);
+        vec3 col = mix(uFloorBaseColor, acc, coverageEff);
+        // 全景投射显隐：关闭时（仅墙体，地板恒为 1）回落中性素色，不投射全景
+        if (uPanoramaVisible < 0.5) {
+            col = vec3(0.78, 0.78, 0.80);
+        }
+        // 实例染色：默认白=原全景色；选中黄（FurnitureObject.highlight 写入 instanceColor）染黄高亮。
+        // 普通 Mesh（墙/地板）无 instanceColor，USE_INSTANCING_COLOR 不定义，此分支被编译剔除。
+        #ifdef USE_INSTANCING_COLOR
+            col *= vInstanceColor;
+        #endif
+${PANO_TINT_ON ? `        // 🔬 归属诊断配色（皇上旨 2026-09-25「就在最后算出来的颜色再叠加上颜色，不用想那么复杂」）：
+        //    整段只在 ?panoTint=1 时生成，默认关 ⇒ 正常态一行都没有。色相全交给所属景点，只保留明暗，
+        //    所以亮部/暗部仍看得出是原照片的纹理，但一眼能分「这块面归哪个景点」。
+        //    ⚠️ 与上一版（逐槽染 linK）的区别：这里染的是**最终颜色** ⇒ 即使那一片压根没有候选（一个全景都没绑上、
+        //       露底色）之外的任何区域也照样按归属上色；归属判据与取图判据同一条 = 「存活口径最近一张」。
+        //    ⚠️ 刻意不用「采样色 × 淡色」：那种叠法叠在亮图上几乎发白，肉眼看不出（09-25 已被打回过一次）。
+        //    ⚠️ 强度 = PANO_TINT_MIX（皇上旨 09-26 晚「叠加的颜色比例少一点」）：原来整块换成色相 ⇒ 只剩明暗、
+        //       底下一张全景图完全读不出来；现在按 mix(原色, 染色, 本值) 叠，色相仍占主但照片看得见了。
+        if (tintCnt > 0.0) {
+            vec3 tintHue = tintAcc / tintCnt;
+            float tintLum = dot(col, vec3(0.2126, 0.7152, 0.0722));
+            vec3 tintTo = tintHue * (0.55 + 0.45 * clamp(tintLum * 3.0, 0.0, 1.0));
+            col = mix(col, tintTo, ${PANO_TINT_MIX});
+        }` : ""}${panoDistOn ? `
+        // 🔬 距离明暗诊断（皇上旨 09-26 晚「距离越小越白、越远越黑」+ 09-27 早「按我有 4 个全景点来写代码」+
+        //    09-27 晚「我一开始的需求就是要把 4 个全景点的坐标传给 shader，按最近取用」）：
+        //    **一句真循环**遍历 uPanoPoints[0..${maxPano - 1}]，每个像素只留「到最近那个景点」的水平距离。
+        //    ⚠️ 纯水平距离最近（09-27 晚定版后与取图**同把尺**，夹角门已废）⇒ 墙背后的景点也往这面墙上画圆，
+        //       一个面能看满 N 个渐变圆；代价 = 明暗图不分身前身后（与取图口径一致）。
+        ${panoDistLoopGlsl("col", maxPano)}` : ""}
+        gl_FragColor = vec4(col, 1.0);
+        // 输出颜色空间编码：渲染到线性 RT（主编辑器后处理链）时 passthrough，渲染到 sRGB 屏幕（预览弹窗）时自动编码 sRGB
+        #include <colorspace_fragment>
+        #include <logdepthbuf_fragment>
+    }
+`;
+}
+/** 融合材质的全景点数**上限**：每点占 **2** 张拼合槽纹理（32 片 8×4 → 左右 2 槽，每槽 4×4 格）⇒ **8 × 2 = 16 个 sampler**，再多样本编译不过。
+ *  ⭐ 2026-10-06 晚皇上旨「一次能够展示 8 个全景纹理」：靠的就是「每点从 4 槽降到 2 槽」——
+ *     sampler 总数 16 是硬件硬顶（皇上本机 `MAX_TEXTURE_IMAGE_UNITS` 实测 16，一直没变），
+ *     原来 16 ÷ 4 槽 = 4 个景点，现在 16 ÷ 2 槽 = **8 个景点**，画质与单全景显存**分毫未动**。 */
+export const MKT_PANO_MAX_SLOTS = 8;
+/**
+ * 创建「多全景融合」着色器材质：每帧由外部喂入最近 maxPano 个全景点（⭐ 10-06 晚旨后每点 2 张拼合槽纹理）。
+ * 同一份着色器同时服务普通 Mesh（墙/地板）与 InstancedMesh（家具立方体）：
+ * 实例化与否由 three.js 按对象类型自动注入 USE_INSTANCING 宏决定，无需外部传 instanced 开关。
+ * 数组 uniform 在创建时即按 maxPano 长度初始化（占位纹理 + 单位矩阵 + 权重 0），运行时由渲染器每帧改写对应槽位。
+ * ⚠️ 取图口径只有一条（皇上旨 2026-09-25 晚「都要一起改」→ 09-27 晚「取用距离最近的那个全景点的瓦片纹理」定版）：
+ * 地板 / 墙 / 家具**全部**按「水平距离最近的一张」取图（09-24~09-25 的夹角门已整链删除），
+ * 不再有「地板按覆盖度融合」这条路，故也**没有** `pickNearest` 选项（旧的 0/1 分流 uniform 已删）。
+ */
+export function createMktFloorBlendShaderMaterial(options = {}) {
+    // 2026-09-20：每个全景点占 N 张纹理槽，故「最多融合点数」maxPano 与纹理上限挂钩：
+    // maxPano × N 张纹理须 ≤ 16（shader sampler 上限）。
+    // 2026-09-24 皇上旨「同一时间要准备 4 个全景的瓦片纹理，一共刚好 16 个」（当时 N=4 ⇒ 上限 4）。
+    // ⭐ 2026-10-06 晚旨「一次能够展示 8 个全景纹理」：N 从 4 降到 **2**（每个全景只占左右两张 RT）
+    //    ⇒ 16 ÷ 2 = **上限 8 个景点**，默认就取满 8。画质 / 单全景显存**分毫未动**。
+    // ⚠️ 10-06 切 32 片之后这两个槽各是「16 片拼出来的一张 4096² RT」，sampler 总数仍是 16（硬顶）。
+    // ⚠️ 所有喂同一批数据的材质必须同档：某处写成 3 而喂料方按 8 喂，会往 panos[6..15] 越界写、着色器读到 undefined sampler。
+    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
+    // 🔬 这一份材质是否带「近白远黑」图：显式传了听他的（编辑器），没传读 URL（发布页/预览默认关）。
+    const panoDistOn = options.panoDist ?? PANO_DIST_ON;
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 总纹理槽数 = 点数 × 每点槽数（8 × 2 = 16 = sampler 硬顶）
+    const panoramas = [];
+    const matrices = [];
+    const weights = new Float32Array(maxPano); // 默认全 0（未参与）
+    for (let i = 0; i < tileCount; i++) {
+        panoramas.push(createPlaceholderTexture());
+    }
+    for (let i = 0; i < maxPano; i++) {
+        matrices.push(new Matrix4());
+    }
+    return new ShaderMaterial({
+        uniforms: {
+            panoramas: { value: panoramas },
+            textureMatrices: { value: matrices },
+            weights: { value: weights },
+            // 地板底色（线性空间深灰，约 sRGB 0.27）：远处露出此色
+            uFloorBaseColor: { value: new Vector3(0.06, 0.06, 0.06) },
+            // 🔬 归属诊断色（每槽一个 vec3 = 该槽里那个景点的固定色）：**只在 ?panoTint=1 时创建**，
+            //    关态连 uniform 都不存在（JS 侧三元）⇒ 线上正常路径零开销。默认白 = 未被应用层写过。
+            ...(PANO_TINT_ON
+                ? { uPanoTintColors: { value: Array.from({ length: maxPano }, () => new Vector3(1, 1, 1)) } }
+                : {}),
+            // 🔬 距离明暗诊断的「黑端米数」：**这份材质 panoDist 为真才创建**（默认 16 ≈ 常见房间对角线，
+            //    应用层每次喂投影时按现场量出的尺子写实际值，见 setMktPanoDistRange）；
+            //    uPanoPoints = 同一张图的**圆心清单**（每格一个 vec4，w=1 表示这格有个全景点，见 setMktPanoPoints）
+            ...(panoDistOn ? {
+                uPanoDistMax: { value: 16 },
+                uPanoPoints: { value: Array.from({ length: maxPano }, () => new Vector4(0, 0, 0, 0)) },
+            } : {}),
+            // ⚠️ 下面两根覆盖半径：着色器自 09-25 晚「都要一起改」起**不再读它们**（覆盖度融合那一路已删），
+            //    uniform 与应用层写入暂留 ⇒ 面板上那两根旋钮调了没有视觉变化，删不删等皇上旨意。
+            uFloorCoreRadius: { value: 4 },
+            uFloorFadeRange: { value: 4 },
+            // 整体透明度（0~1）：仅缩放全景图映射的可见度（覆盖度×此值），地板灰底不变；全局对所有全景一起生效；1=全景完全可见
+            uFloorOpacity: { value: 1 },
+            // 全景投射显隐：1=显示全景，0=仅显示素色（墙体回落中性色，地板恒为 1）
+            uPanoramaVisible: { value: 1 },
+            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
+            // 全景上下方向**已写死**，无 uniform（见文件头 🎛️ 段）。
+            // 每点各自的「这 2 槽是瓦片(1)/同一张整图(0)」，由喂料处按「PanoTexMode + 真实 tiles」写（setMktPanoTiled）；
+            // 默认全 1 = 维持改造前的瓦片口径（真实上传的图都是四瓦片）。
+            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
+            // 投影空间逆矩阵：默认单位阵（= 世界坐标，行为与改造前一致）。
+            // 融合材质默认**永不**写入它 —— 编辑器地板/立方体、预览立方体因此完全不受 MktMesh 变换影响。
+            uProjInvMatrix: { value: new Matrix4() },
+        },
+        vertexShader: floorVertexShader,
+        fragmentShader: buildFloorBlendFragment(maxPano, panoDistOn),
+        side: DoubleSide,
+        transparent: false,
+        toneMapped: false,
+    });
+}
+/**
+ * 「仅显示选中全景」片元（皇上旨 2026-09-29「三模式三 shader」之三）：
+ * 整面恒显示 **0 号点槽**那一张全景 —— 不看距离、不看夹角、不看序号，槽里是谁就投谁
+ * （喂料侧保证 0 号槽 = 当前选中的全景、其余槽留空）。
+ * uniform 形状与 blend 同档 ⇒ 喂料复用 feedBlendProjection 槽位指派路零改动；
+ * GLSL 只读 0 号点槽，其余槽是声明了没人采的死重（开销可忽略）。
+ * 槽没绑好（weights[0]≤0，选中全景瓦片还在路上 / 没选中任何全景）→ 露 uFloorBaseColor 深灰底。
+ */
+function buildFloorSelectedFragment(maxPano) {
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 形状与 blend 同档（喂料共用）
+    return /* glsl */ `
+    #include <logdepthbuf_pars_fragment>
+    uniform sampler2D panoramas[${tileCount}]; // 形状与 blend 同档（喂料共用）；本 shader 只采 0 号点槽（纹理 0..1）
+    uniform mat4 textureMatrices[${maxPano}];
+    uniform float weights[${maxPano}];         // 0 号槽 > 0 = 选中全景的瓦片已绑好
+    uniform float uPanoTiled[${maxPano}];
+    uniform vec3 uFloorBaseColor;              // 槽没绑好时露出的深灰底（线性空间，约 sRGB 0.27）
+    uniform float uFloorOpacity;               // 整体透明度（与 blend 同口径：只缩放全景可见度，底色不变）
+    // 色彩空间只有一条路（10-07 旨「统一使用 liner」）：原 uniform float uColorSpace; + 那段 pow 分支已整条撤除（与 blend 同口径）
+    uniform float uPanoramaVisible;
+    varying vec3 vProjPos;
+    #ifdef USE_INSTANCING_COLOR
+    varying vec3 vInstanceColor;
+    #endif
+    void main() {
+        // ── 0 号点槽（纹理 0..1，即左右那 2 张拼合槽）：选中的全景独占（采样段与 blend 逐字同口径）──
+        vec3 lin0 = vec3(0.0);
+        if (weights[0] > 0.0) {
+            mat4 tm = textureMatrices[0];
+            vec3 texPos = tm[3].xyz;
+            mat3 texRot = mat3(tm);
+            vec3 dir = normalize(vProjPos - texPos);
+            dir = texRot * dir;
+            float lon = atan(dir.z, dir.x);
+            float u = lon * 0.15915494309189535 + 0.5; // 经度 -> u
+            float lat = asin(clamp(dir.y, -1.0, 1.0));
+            float v = 0.5 + lat * 0.3183098861837907; // 1/PI（等距柱状线性 v，与 blend 逐字同口径）
+            // ⭐ 10-06 晚旨：竖着不再分块 ⇒ 槽只随 u 走（左右两半：[左半幅=0, 右半幅=1]），与 blend 逐字同口径
+            int tileIdx = (u >= 0.5) ? 1 : 0;
+            float localU = (u < 0.5) ? (u * 2.0) : (u * 2.0 - 1.0);
+            // ⛔ 纵向不再减半（槽就是全高）⇒ localV 恒等于 v
+            float localV = v;
+            float panoU = (uPanoTiled[0] > 0.5) ? localU : u;
+            float panoV = (uPanoTiled[0] > 0.5) ? localV : v;
+            // ⭐ 采样即线性（与单全景 / blend 那两路同一条口径，10-07 旨「色彩空间统一使用 liner」）：纹理都标了
+            //    colorSpace = SRGBColorSpace ⇒ 硬件上传成 SRGB8_ALPHA8、texture2D 已解码一次；
+            //    这里**不再手动 pow 解码**（那遍是二次解码 = 整体压暗），末端只编码一次 ⇒ 与源图逐字节还原。
+            if (tileIdx == 0) lin0 = texture2D(panoramas[0], vec2(panoU, panoV)).rgb;
+            else lin0 = texture2D(panoramas[1], vec2(panoU, panoV)).rgb;
+        }
+        float coverage = weights[0] > 0.0 ? 1.0 : 0.0;
+        float coverageEff = clamp(coverage * uFloorOpacity, 0.0, 1.0);
+        vec3 col = mix(uFloorBaseColor, lin0, coverageEff);
+        // 全景投射显隐：关闭时回落中性素色（与 blend 一致）
+        if (uPanoramaVisible < 0.5) col = vec3(0.78, 0.78, 0.80);
+        #ifdef USE_INSTANCING_COLOR
+            col *= vInstanceColor;
+        #endif
+        gl_FragColor = vec4(col, 1.0);
+        #include <colorspace_fragment>
+        #include <logdepthbuf_fragment>
+    }
+`;
+}
+/**
+ * 创建「仅显示选中全景」着色器材质（皇上旨 2026-09-29「三模式三 shader」之三）：仅编辑器使用。
+ * uniform 形状与 blend 工厂同档 ⇒ 喂料复用 feedBlendProjection 槽位指派路零改动；
+ * 本 shader 只读 0 号点槽（GLSL 写死），uFloorCoreRadius/uFloorFadeRange 喂料会写但不读（静默忽略）。
+ */
+export function createMktFloorSelectedShaderMaterial(options = {}) {
+    const maxPano = Math.min(options.maxPano ?? MKT_PANO_MAX_SLOTS, MKT_PANO_MAX_SLOTS);
+    const tileCount = maxPano * RT_STITCH_SLOT_COUNT; // 与 blend / mapping 同档（8 点 × 2 槽 = 16）
+    const panoramas = [];
+    const matrices = [];
+    for (let i = 0; i < tileCount; i++)
+        panoramas.push(createPlaceholderTexture());
+    for (let i = 0; i < maxPano; i++)
+        matrices.push(new Matrix4());
+    return new ShaderMaterial({
+        uniforms: {
+            panoramas: { value: panoramas },
+            textureMatrices: { value: matrices },
+            weights: { value: new Float32Array(maxPano) },
+            uPanoTiled: { value: new Float32Array(maxPano).fill(1) },
+            uFloorBaseColor: { value: new Vector3(0.06, 0.06, 0.06) },
+            // 喂料统一入口会写；本 shader 不读 uFloorCoreRadius/uFloorFadeRange（留 JS 项 = 喂料零分支）
+            uFloorCoreRadius: { value: 4 },
+            uFloorFadeRange: { value: 4 },
+            uFloorOpacity: { value: 1 },
+            uPanoramaVisible: { value: 1 },
+            // 色彩空间只有一条路（10-07 旨「统一使用 liner」）⇒ 原 `uColorSpace: { value: 0 }` 已随那段 pow 分支整条撤除
+            uProjInvMatrix: { value: new Matrix4() },
+        },
+        vertexShader: floorVertexShader,
+        fragmentShader: buildFloorSelectedFragment(maxPano),
+        side: DoubleSide,
+        transparent: false,
+        toneMapped: false,
+    });
+}