three-base 2.0.197 → 2.0.199

package/MktMesh/MktMesh.d.ts

@@ -5,6 +5,7 @@ import { type PanoStitcher } from "./panoTileStitcher";
 import type { MktMeshData, MktTextureInfo, WallPoint, WallSide } from "./types";
 import { ImagePlane, type ImagePlaneData } from "./imagePlane";
 import { ModelSlot, type ModelSlotData } from "./modelSlot";
+import { MktResourceManager } from "./mktResManager";
 export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
     /** 纹理列表（每个纹理的 url + 世界矩阵） */
     textures: MktTextureInfo[];
@@ -121,6 +122,14 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
     /** 当前全景纹理形态（只读）。消费方（预览立方体等自持材质的路径）据此算 `mktPanoTiledFlag`，
      *  必须与基类喂纹理处用同一个值，否则标记与地址不同源 ⇒ 整图被按 1/2 横向铺满球面（10-06 晚起纵向不分块，四槽时代是 1/4）。 */
     get panoTexMode(): PanoTexMode;
+    /** 优先加载的全景个数（存档 `textures` 的前 n 项）：**-1 = 全部、0 = 一个都不提前、n = 前 n 个**（2026-11-05 需求）。
+     *  默认取 `PANO_IMPORT_PRIORITY_DEFAULT`（= -1，同日需求「不管有没有显示出来的全景图都应该默认全部加载」）；
+     *  宿主想收窄，在渲染循环跑起来之前 `setPanoPriorityCount(4)` 一行即可
+     *  （与 `_ossSize`、`_panoTexMode` 同一套注入路径 ⇒ 编辑器与预览各自的配置各自推下来）。
+     *  ⚠️ 这一档只定**下载与拼合的次序**；隐藏期里谁来推那一拍 = `preRender(renderer)`（需求第 1、2 点）。 */
+    private _panoPriorityCount;
+    /** 当前优先加载个数（只读，回显用）。 */
+    get panoPriorityCount(): number;
     private _tmpV3;
     /**
      * 图片平面层（⭐ 10-26 旨入库）：对象挂在**本 MktMesh 的子树**里，⛔ 不是场景根
@@ -162,6 +171,14 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *    否则它会在轮到自身那一帧被写回可见（`boolean` 只有一个位，放行那里分不出这笔是谁写的）。
      */
     private _revealPending;
+    /**
+     * ⭐ 2026-11-05 需求「专门写一个资源管理器来管理，每个 mktmesh 都有自己的一个资源管理器」：本对象一份。
+     * 它不下载、不解码、不上传 ⇒ 全部经下面那几只手点本对象上**现成**的入口（拼合器 `pump` / `prefetchHeadPanoramas` /
+     * `feedImagePlaneTiles` / 隐藏期预热），只多管两件事：隐藏期由谁来推那一拍、以及「哪一档真画进过显存」这本账。
+     */
+    private _res;
+    /** 本对象的资源管理器（只读）。宿主只管调 `preRender`，需要看账本时才用它。 */
+    get resManager(): MktResourceManager;
     /**
      * 隐藏期 GPU 预热的在册清单（元素 = 一个「会进渲染列表的物件」，即它的材质组合 × 几何）。
      * null = 没在预热（未启动 / 已跑完 / `stopGpuPrewarm` / `dispose` 四种都是它）。
@@ -338,6 +355,11 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *     下一帧 `feedFaceMapping` 里共用的那份 binder 见「槽内现有形态 ≠ 目标形态」自动走整档判齐、一次换绑并同帧翻标记。
      *  编辑器 MktDevMesh 走的是自己那路（同一个 binder、同一份策略），本方法对它只是记下形态。 */
     setPanoTexMode(mode: PanoTexMode): void;
+    /** 设置优先加载的全景个数：-1 = 全部 / 0 = 不提前 / n = 存档前 n 个（2026-11-05 需求）。
+     *  收口：负数（含 -2、NaN 一类）一律归到 -1「全加载」，正数向下取整；非有限值回落默认档。
+     *  改档⛔ 需要重新 `importData` —— 名册每帧重排，下一帧 `prefetchHeadPanoramas` 直接用新数点名
+     *  （`prioritize` 幂等 ⇒ 已在队列里的那批不重复投喂，也不会把已出队的旧批再塞回去）。 */
+    setPanoPriorityCount(count: number): void;
     /**
      * 记下「当前激活（名册 0 号槽 = 中心）是第几个全景」。
      * ⭐ 皇上旨 2026-10-03 旨②：预览立方体已与墙**共用同一份材质**，原来那句「把中心那几张抄给立方体单全景材质」
@@ -413,8 +435,27 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *    表空了它就是一句 `length` 判断，⛔ 不需要再像旧写法那样把钩子置 null（钩子上还挂着全景投影那三件事）。
      * ⚠️ 这里写的 `visible` 只针对**自己压进表的那几颗** ⇒ 表外的对象（单颗新增、已 dispose、被 `releaseReveal`
      *    摘牌的）一律不碰；要在放行前接管某颗，调 `releaseReveal(o)`。
+     * ⭐ 2026-11-05 需求第 4 点「只已经预载入的资源才显示出来」：内容落定（`o.loaded`）之后还要问一句资源管理器
+     *    「这一档画进显存了吗」—— 只有宿主调过 `preRender` 且预热还挂着牌时才拦，摘牌 / 没调过 ⇒ 一律放行（⛔ 不许拦出永久黑屏）。
      */
     tickProgressiveReveal(): void;
+    /**
+     * ⭐ 2026-11-05 需求第 1 点逐字：「需要提供一个 `preRender` 方法, 传入一个渲染器对象, 然后在这个方法里面使用
+     *  渲染来预载入已经准备好的资源到 GPU」。隐藏期（`visible = false`）里 three 遍历第一句就把本对象连同子树跳过
+     *  ⇒ `onBeforeRender` 一次都不触发，全景瓦片不下载不拼合、平面不绑、GLB 与墙的 program 不编不传；
+     *  本方法就是那句「藏起来的时候替它跑一遍渲染循环里的推进」，交进来的渲染器同时供拼合器与预热用。
+     *
+     * 一次点齐三族（次序固定，与 `onBeforeRender` 里同一相对位置）：
+     *   ① 全景 —— `stitcher.pump(renderer)` 逐 tick 走「补下载 → 画已进显存的格 → 传一张新的」，
+     *      额度由 `panoPriorityCount` 点的批排在前（默认 -1 = 整份存档，需求第 2 点）；
+     *   ② 平面图 —— `feedImagePlaneTiles()` 一次把整层地址交给下载、绑定一帧一颗（需求第 3 点：这两族本来就全量发起）；
+     *   ③ GLB / 平面 / 墙 —— 下面的 `startGpuPrewarm` 那一族逐 tick 画一件进 1×1 目标（program 编译 + 顶点缓冲首传）。
+     *
+     * 幂等 ⇒ 隐藏期里每帧点一次、或只在载入后点一次都行；已排进队列的那条链不会被重复起。
+     * 本对象一旦 `visible`（进厅），链自己停 ⇒ 之后交回 `onBeforeRender` 每帧那一路，⛔ 不抢同一帧的额度。
+     * ⛔ 不调本方法的宿主（发布页直接亮墙、编辑器画布）行为与改造前逐字一致：显示闸只在 `preRender` 点过之后才生效。
+     */
+    preRender(renderer: WebGLRenderer): void;
     /**
      * 开始隐藏期预热：把「进厅第一帧要现编的那些 program + 要第一次上传的那些几何/纹理」提前跑掉，一帧只放**一件**。
      *
@@ -499,11 +540,12 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *  @param onModelLoad 每只 GLB 落地时回调一次（可选）——按需渲染的宿主（编辑器）拿它标脏；每帧真画的预览不传 */
     importData(data: MktMeshData, projName?: string, onModelLoad?: () => void): void;
     /**
-     * 把**存档里前 `PANO_IMPORT_PRIORITY` 个全景**按存档顺序登记进拼合器的**加载任务队列**
+     * 把**存档里前 `panoPriorityCount` 个全景**（-1 = 整份全加载）按存档顺序登记进拼合器的**加载任务队列**
      *（2026-10-29 需求「优先加载前 2 个全景素材」+ 2026-10-30 需求逐字：「给 mktmesh 内部加一个加载任务队列，
      *  把模型和平面图排在最前面，然后按照顺序，依次把前 2 个全景的顺序把瓦片加载任务添加到任务队列里面，
      *  第一个加载完了，就把这个加载任务从任务队列里面去掉，然后加载第二个；
-     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」）。
+     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」
+     *  + 2026-11-05 需求「提前加载多少个全景改由配置决定，-1 全加载 / 0 不加载 / n 前 n 个，默认 4」）。
      * 由两处渲染循环每帧点一次：基类 `onBeforeRender`（预览弹窗 / 发布页）与编辑器的 `updateFloorTexture`
      *（`MktDevMesh` 覆写了 `onBeforeRender`，只点 `syncProjInvMatrix` + `tickProgressiveReveal`，库内那句在编辑态不跑）。
      *
@@ -512,21 +554,23 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *      （GLB 逐只 `loadModel` 不 throttle；平面那 4 片一次性 `_imgTileLoader.preload`），
      *      而全景瓦片最早也要等下一帧的 `pump` 才发第一片 ⇒ 发起次序天然是「模型 → 平面图 → 全景」，
      *      ⛔ 这里不再把它们塞进队列重复管一遍（塞了就是第二把尺）。
-     *   ② 本方法把存档 0 号、1 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
+     *   ② 本方法把存档 0 号起这 n 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
      *      0 号 32 格全落定（画进 RT，或该格本就缺地址/判死）才出队、1 号才开始发第一片。
      *      比 10-29 那版（只是把两批挪到在册顺序前面、额度仍被两批分摊）更硬：**第 1 颗独享额度，最快出全图**。
+     *      n = -1（全加载）时这一条变成「整份存档按存档顺序串行」⇒ 距离名册插不到前面，出清速度取决于总片数。
      *   ③ 名册按距离点到的其他全景走 `feedFaceMapping` 里那句 `ensure(t.tiles)`（不带队列）⇒ 只入册、
      *      排在队列后面等，队列空了才按在册顺序补料（现行口径不变）。
      * ⚠️⚠️ 为什么每帧点而⛔ 只在 `importData` 里点一记：预览每开一次都换渲染器，`_switchRenderer` 把在册组
      *   整份作废（队列里的键也在同一刻失效）；只在载入那次点名等于白点。本方法点在 `pump` 之后、名册逐槽
-     *   `ensure` 之前 ⇒ 每帧把这两记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以 0 号恒在 1 号前）。
+     *   `ensure` 之前 ⇒ 每帧把这几记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以存档次序恒不变）。
      * ⚠️ 代价如实记：
-     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前两颗的那面墙会多灰一会儿。
+     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前 n 颗的那面墙会多灰一会儿。
      *   · 一颗「永远下不完」的瓦片（下载失败还没累计到判死）会压住队列；判死阈值是解码失败 3 次
-     *     （`_dead`），退避重试期间队首不落定 ⇒ 第 2 颗跟着延后。真实数据里缺片是「地址为空/404」，
+     *     （`_dead`），退避重试期间队首不落定 ⇒ 后面几颗跟着延后。真实数据里缺片是「地址为空/404」，
      *     404 走三次即判死、那一格拼合涂灰 ⇒ 队列照样出清。
-     *   · 这两颗全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
-     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这两个景点迟早要建。
+     *   · 这批全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
+     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这些景点迟早要建；
+     *     ⚠️ n = -1（全加载）时这一条按存档全景总数放大，显存与在途请求都跟着涨。
      * ⚠️ 形态判据读 `this._panoTexMode`（整图形态那一档一张全景只有一张整图，走 `_texCache` 那条路，
      *   走错档就是白下 32 片）⇒ 宿主若用自己那份形态变量（编辑器的 `store.panoTexMode`），
      *   要在调 `importData` 之前先 `setPanoTexMode` 推进来，编辑器那侧已按此接线。

package/MktMesh/MktMesh.js

@@ -49,11 +49,18 @@ import { stripAssetHost, absAssetUrl } from "./assetUrl";
 //    原先各住在本站两个渲染器里一份 ⇒ 下游直接用包里的 `MktMesh` 时，存档里的 `images`/`models` 两键没人读。
 //    入库之后它们挂在 `MktMesh` **自己的子树**下，与墙同一棵变换 ⇒ 预览那三根 transform 滑杆搬得动整份展品。
 import { ImagePlane } from "./imagePlane";
-import { ModelSlot } from "./modelSlot";
+import { ModelSlot, glbFileName } from "./modelSlot";
 import { ImagePlaneTileLoader } from "./imageTileLoader";
-/** 载入 JSON 时**优先**加载几个全景的素材（2026-10-29 需求「优先加载前 2 个全景图的素材，然后再加载其他的」）。
- *  口径 = 存档 `textures` 数组的前 n 项；其余全景照常按每帧的槽位名册（离注视点最近 8 个）排队，只是排在它们后面。 */
-const PANO_IMPORT_PRIORITY = 2;
+// ⭐ 用户需求 2026-11-05「专门写一个资源管理器来管理, 每个 mktmesh 都有自己的一个资源管理器来管理」：
+//    隐藏期（`visible = false` ⇒ `onBeforeRender` 一次都不触发）里那三族资源的**驱动次序**与**是否已进显存**这本账。
+import { MktResourceManager } from "./mktResManager";
+/** 载入 JSON 时**优先**加载几个全景的素材的**默认档**（数值只写这一处）。
+ *  口径 = 存档 `textures` 数组的前 n 项（n = -1 视为整份全加载）；其余全景照常按每帧的槽位名册（离注视点最近 8 个）排队，只是排在它们后面。
+ *  2026-10-29 需求「优先加载前 2 个全景图的素材，然后再加载其他的」立的是 2；
+ *  2026-11-05 需求逐字「现在要默认把全景全部都要默认加载, 现在需要通过配置来设置, 提前加载多少个全景 -1 就是全加载 0就是不加载 1就是加载个 2就提前加载2个 一次类推, 默认加载前4个」⇒ 换成可配置的 4；
+ *  同日需求逐字「panoPriorityCount 设置为 -1, 不管有没有显示出来的全景图都应该默认全部加载, 等待渲染器的预载入」⇒ 默认档落 **-1（整份全加载）**。
+ *  ⚠️ 这一档管的是**下载与拼合的次序**；「亮出来之前先把它推进显存」是 `preRender(renderer)` 那一手（见 `./mktResManager`）。 */
+const PANO_IMPORT_PRIORITY_DEFAULT = -1;
 /** 隐藏期预热那一次绘制用的镜头（模块级共用：它只是个「有合法的投影矩阵可读」的载体，永不动 ⇒ ⛔ 不必每实例造一份）。 */
 const GPU_WARM_CAMERA = new OrthographicCamera(-1, 1, 1, -1, 0.1, 10);
 /**
@@ -193,6 +200,16 @@ export default class MktMesh extends Mesh {
     get panoTexMode() {
         return this._panoTexMode;
     }
+    /** 优先加载的全景个数（存档 `textures` 的前 n 项）：**-1 = 全部、0 = 一个都不提前、n = 前 n 个**（2026-11-05 需求）。
+     *  默认取 `PANO_IMPORT_PRIORITY_DEFAULT`（= -1，同日需求「不管有没有显示出来的全景图都应该默认全部加载」）；
+     *  宿主想收窄，在渲染循环跑起来之前 `setPanoPriorityCount(4)` 一行即可
+     *  （与 `_ossSize`、`_panoTexMode` 同一套注入路径 ⇒ 编辑器与预览各自的配置各自推下来）。
+     *  ⚠️ 这一档只定**下载与拼合的次序**；隐藏期里谁来推那一拍 = `preRender(renderer)`（需求第 1、2 点）。 */
+    _panoPriorityCount = PANO_IMPORT_PRIORITY_DEFAULT;
+    /** 当前优先加载个数（只读，回显用）。 */
+    get panoPriorityCount() {
+        return this._panoPriorityCount;
+    }
     // 复用临时对象（避免每帧 new，降低 GC 压力）
     _tmpV3 = new Vector3();
     /**
@@ -235,6 +252,25 @@ export default class MktMesh extends Mesh {
      *    否则它会在轮到自身那一帧被写回可见（`boolean` 只有一个位，放行那里分不出这笔是谁写的）。
      */
     _revealPending = [];
+    /**
+     * ⭐ 2026-11-05 需求「专门写一个资源管理器来管理，每个 mktmesh 都有自己的一个资源管理器」：本对象一份。
+     * 它不下载、不解码、不上传 ⇒ 全部经下面那几只手点本对象上**现成**的入口（拼合器 `pump` / `prefetchHeadPanoramas` /
+     * `feedImagePlaneTiles` / 隐藏期预热），只多管两件事：隐藏期由谁来推那一拍、以及「哪一档真画进过显存」这本账。
+     */
+    _res = new MktResourceManager({
+        prewarm: (renderer) => this.startGpuPrewarm(renderer),
+        stopPrewarm: () => this.stopGpuPrewarm(),
+        // 挂着牌 = 还没摘牌且还没亮出来 ⇒ 与 `_topUpGpuPrewarm` 用的同一颗尺（⛔ 不自立第二道闸）
+        prewarming: () => this._warmSeen !== null && !this.visible,
+        shown: () => this.visible,
+        pumpPano: (renderer) => this._stitcher.pump(renderer),
+        prefetchPano: () => this.prefetchHeadPanoramas(),
+        feedPlanes: () => this.feedImagePlaneTiles(),
+    });
+    /** 本对象的资源管理器（只读）。宿主只管调 `preRender`，需要看账本时才用它。 */
+    get resManager() {
+        return this._res;
+    }
     /**
      * 隐藏期 GPU 预热的在册清单（元素 = 一个「会进渲染列表的物件」，即它的材质组合 × 几何）。
      * null = 没在预热（未启动 / 已跑完 / `stopGpuPrewarm` / `dispose` 四种都是它）。
@@ -284,6 +320,8 @@ export default class MktMesh extends Mesh {
             //   `updateTexture`（它里面那记 `pump` 是「第一次拿到 renderer ⇒ 在册组整份作废」的现场）之后、
             //   `feedFaceMapping`（名册逐槽入册）之前 —— 顺序倒过来就是「名册在前、我们垫底」= 静默失效。
             //   编辑态那份在 `MktDevMesh` 的宿主循环里照同一相对位置点（⛔ 别在这儿加第三处）。
+            //   2026-11-05 需求：这一批点几颗改由 `panoPriorityCount` 定（默认 -1 = 存档全部）⇒ 本句不动；
+            //   同一批在**隐藏期**由 `preRender(renderer)` 逐 tick 推（本钩子在那时一次都不触发）。
             this.prefetchHeadPanoramas();
             this.feedFaceMapping();
             this.tickProgressiveReveal();
@@ -1069,6 +1107,18 @@ export default class MktMesh extends Mesh {
             return;
         this._panoTexMode = next;
     }
+    /** 设置优先加载的全景个数：-1 = 全部 / 0 = 不提前 / n = 存档前 n 个（2026-11-05 需求）。
+     *  收口：负数（含 -2、NaN 一类）一律归到 -1「全加载」，正数向下取整；非有限值回落默认档。
+     *  改档⛔ 需要重新 `importData` —— 名册每帧重排，下一帧 `prefetchHeadPanoramas` 直接用新数点名
+     *  （`prioritize` 幂等 ⇒ 已在队列里的那批不重复投喂，也不会把已出队的旧批再塞回去）。 */
+    setPanoPriorityCount(count) {
+        if (!Number.isFinite(count))
+            this._panoPriorityCount = PANO_IMPORT_PRIORITY_DEFAULT;
+        else {
+            const n = Math.floor(count);
+            this._panoPriorityCount = n < 0 ? -1 : n;
+        }
+    }
     /**
      * 记下「当前激活（名册 0 号槽 = 中心）是第几个全景」。
      * ⭐ 皇上旨 2026-10-03 旨②：预览立方体已与墙**共用同一份材质**，原来那句「把中心那几张抄给立方体单全景材质」
@@ -1189,6 +1239,9 @@ export default class MktMesh extends Mesh {
             ms.dispose();
         }
         this.models = [];
+        // 用户 2026-11-04「日志少打印点吧」⇒ 这一路（进厅 / 切项目 / 预览的整层重建）几十颗⛔ 不再一颗一行：
+        //   名单先攒着，循环结束打**一条**（文件名口径与 `setModelUrl` 那一记共用 `glbFileName`）⇒ 一颗不落、一行到位。
+        const glbNames = [];
         for (const d of datas) {
             const ms = new ModelSlot(d.name);
             ms.applyData(d);
@@ -1200,9 +1253,12 @@ export default class MktMesh extends Mesh {
                 //（⚠️ 与旧的「GLB 在路上时这一槽露出占位方块」不同：整层重建这一路一颗都不露，直到轮到自己亮）
                 ms.visible = false;
                 this._revealPending.push(ms);
+                glbNames.push(glbFileName(d.url));
                 void ms.loadModel(d.url).then(() => this._queueModelMount(ms, onEachLoad));
             }
         }
+        if (glbNames.length > 0)
+            console.log(`[MktMesh] 整层重建加载 ${glbNames.length} 个 glb：${glbNames.join("、")}`);
     }
     /** 把「备好待挂」的那一槽交给全局队列；⛔ 去重闸门自备（`addWork` 按闭包引用判重，新闭包它判不出来） */
     _queueModelMount(ms, onEachLoad) {
@@ -1299,6 +1355,8 @@ export default class MktMesh extends Mesh {
      *    表空了它就是一句 `length` 判断，⛔ 不需要再像旧写法那样把钩子置 null（钩子上还挂着全景投影那三件事）。
      * ⚠️ 这里写的 `visible` 只针对**自己压进表的那几颗** ⇒ 表外的对象（单颗新增、已 dispose、被 `releaseReveal`
      *    摘牌的）一律不碰；要在放行前接管某颗，调 `releaseReveal(o)`。
+     * ⭐ 2026-11-05 需求第 4 点「只已经预载入的资源才显示出来」：内容落定（`o.loaded`）之后还要问一句资源管理器
+     *    「这一档画进显存了吗」—— 只有宿主调过 `preRender` 且预热还挂着牌时才拦，摘牌 / 没调过 ⇒ 一律放行（⛔ 不许拦出永久黑屏）。
      */
     tickProgressiveReveal() {
         const q = this._revealPending;
@@ -1306,12 +1364,33 @@ export default class MktMesh extends Mesh {
             const o = q[i];
             if (!o.loaded)
                 continue; // 内容还在路上 ⇒ 这一颗继续压着，先看后面已经落定的
+            if (this._res.holdsReveal(o))
+                continue; // 内容到了但还没进显存 ⇒ 等 `preRender` 那一拍画过它
             q.splice(i, 1);
             o.visible = true;
             return;
         }
     }
     // ─────────────────── 隐藏期 GPU 预热（2026-11-01 需求：进厅那一下不要再现编着色器） ───────────────────
+    /**
+     * ⭐ 2026-11-05 需求第 1 点逐字：「需要提供一个 `preRender` 方法, 传入一个渲染器对象, 然后在这个方法里面使用
+     *  渲染来预载入已经准备好的资源到 GPU」。隐藏期（`visible = false`）里 three 遍历第一句就把本对象连同子树跳过
+     *  ⇒ `onBeforeRender` 一次都不触发，全景瓦片不下载不拼合、平面不绑、GLB 与墙的 program 不编不传；
+     *  本方法就是那句「藏起来的时候替它跑一遍渲染循环里的推进」，交进来的渲染器同时供拼合器与预热用。
+     *
+     * 一次点齐三族（次序固定，与 `onBeforeRender` 里同一相对位置）：
+     *   ① 全景 —— `stitcher.pump(renderer)` 逐 tick 走「补下载 → 画已进显存的格 → 传一张新的」，
+     *      额度由 `panoPriorityCount` 点的批排在前（默认 -1 = 整份存档，需求第 2 点）；
+     *   ② 平面图 —— `feedImagePlaneTiles()` 一次把整层地址交给下载、绑定一帧一颗（需求第 3 点：这两族本来就全量发起）；
+     *   ③ GLB / 平面 / 墙 —— 下面的 `startGpuPrewarm` 那一族逐 tick 画一件进 1×1 目标（program 编译 + 顶点缓冲首传）。
+     *
+     * 幂等 ⇒ 隐藏期里每帧点一次、或只在载入后点一次都行；已排进队列的那条链不会被重复起。
+     * 本对象一旦 `visible`（进厅），链自己停 ⇒ 之后交回 `onBeforeRender` 每帧那一路，⛔ 不抢同一帧的额度。
+     * ⛔ 不调本方法的宿主（发布页直接亮墙、编辑器画布）行为与改造前逐字一致：显示闸只在 `preRender` 点过之后才生效。
+     */
+    preRender(renderer) {
+        this._res.preRender(renderer);
+    }
     /**
      * 开始隐藏期预热：把「进厅第一帧要现编的那些 program + 要第一次上传的那些几何/纹理」提前跑掉，一帧只放**一件**。
      *
@@ -1413,6 +1492,9 @@ export default class MktMesh extends Mesh {
                 return;
             seen.add(key);
             items.push({ src: o, m: mesh.material, g });
+            // ⭐ 2026-11-05 需求第 4 点：把「这一颗属于哪一档」交给资源管理器记账（键的算式仍只在这里这一处），
+            //   等 `_runGpuWarmStep` 真画过它再翻成「已进显存」⇒ `tickProgressiveReveal` 才放行。
+            this._res.noteWarmKey(o, key);
             added++;
         });
         return added;
@@ -1463,6 +1545,9 @@ export default class MktMesh extends Mesh {
         renderer.setRenderTarget(this._warmRt);
         renderer.render(scene, GPU_WARM_CAMERA);
         renderer.setRenderTarget(prevTarget);
+        // ⭐ 2026-11-05 需求第 4 点：这一档刚刚真画进显存（program 编了、顶点缓冲与纹理首传也做了）⇒ 记上「已常驻」，
+        //   `tickProgressiveReveal` 那一拍才许把对应那颗亮出来（同一档的第二、第三颗跟着一起放行）。
+        this._res.markWarmDrawn(it.src);
         this._scheduleGpuWarmStep(renderer);
     }
     /**
@@ -1641,11 +1726,12 @@ export default class MktMesh extends Mesh {
         this.setModels((data.models ?? []).map((d) => ({ ...d, url: d.url ? absAssetUrl(d.url, pn) : "" })), onModelLoad);
     }
     /**
-     * 把**存档里前 `PANO_IMPORT_PRIORITY` 个全景**按存档顺序登记进拼合器的**加载任务队列**
+     * 把**存档里前 `panoPriorityCount` 个全景**（-1 = 整份全加载）按存档顺序登记进拼合器的**加载任务队列**
      *（2026-10-29 需求「优先加载前 2 个全景素材」+ 2026-10-30 需求逐字：「给 mktmesh 内部加一个加载任务队列，
      *  把模型和平面图排在最前面，然后按照顺序，依次把前 2 个全景的顺序把瓦片加载任务添加到任务队列里面，
      *  第一个加载完了，就把这个加载任务从任务队列里面去掉，然后加载第二个；
-     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」）。
+     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」
+     *  + 2026-11-05 需求「提前加载多少个全景改由配置决定，-1 全加载 / 0 不加载 / n 前 n 个，默认 4」）。
      * 由两处渲染循环每帧点一次：基类 `onBeforeRender`（预览弹窗 / 发布页）与编辑器的 `updateFloorTexture`
      *（`MktDevMesh` 覆写了 `onBeforeRender`，只点 `syncProjInvMatrix` + `tickProgressiveReveal`，库内那句在编辑态不跑）。
      *
@@ -1654,27 +1740,31 @@ export default class MktMesh extends Mesh {
      *      （GLB 逐只 `loadModel` 不 throttle；平面那 4 片一次性 `_imgTileLoader.preload`），
      *      而全景瓦片最早也要等下一帧的 `pump` 才发第一片 ⇒ 发起次序天然是「模型 → 平面图 → 全景」，
      *      ⛔ 这里不再把它们塞进队列重复管一遍（塞了就是第二把尺）。
-     *   ② 本方法把存档 0 号、1 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
+     *   ② 本方法把存档 0 号起这 n 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
      *      0 号 32 格全落定（画进 RT，或该格本就缺地址/判死）才出队、1 号才开始发第一片。
      *      比 10-29 那版（只是把两批挪到在册顺序前面、额度仍被两批分摊）更硬：**第 1 颗独享额度，最快出全图**。
+     *      n = -1（全加载）时这一条变成「整份存档按存档顺序串行」⇒ 距离名册插不到前面，出清速度取决于总片数。
      *   ③ 名册按距离点到的其他全景走 `feedFaceMapping` 里那句 `ensure(t.tiles)`（不带队列）⇒ 只入册、
      *      排在队列后面等，队列空了才按在册顺序补料（现行口径不变）。
      * ⚠️⚠️ 为什么每帧点而⛔ 只在 `importData` 里点一记：预览每开一次都换渲染器，`_switchRenderer` 把在册组
      *   整份作废（队列里的键也在同一刻失效）；只在载入那次点名等于白点。本方法点在 `pump` 之后、名册逐槽
-     *   `ensure` 之前 ⇒ 每帧把这两记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以 0 号恒在 1 号前）。
+     *   `ensure` 之前 ⇒ 每帧把这几记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以存档次序恒不变）。
      * ⚠️ 代价如实记：
-     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前两颗的那面墙会多灰一会儿。
+     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前 n 颗的那面墙会多灰一会儿。
      *   · 一颗「永远下不完」的瓦片（下载失败还没累计到判死）会压住队列；判死阈值是解码失败 3 次
-     *     （`_dead`），退避重试期间队首不落定 ⇒ 第 2 颗跟着延后。真实数据里缺片是「地址为空/404」，
+     *     （`_dead`），退避重试期间队首不落定 ⇒ 后面几颗跟着延后。真实数据里缺片是「地址为空/404」，
      *     404 走三次即判死、那一格拼合涂灰 ⇒ 队列照样出清。
-     *   · 这两颗全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
-     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这两个景点迟早要建。
+     *   · 这批全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
+     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这些景点迟早要建；
+     *     ⚠️ n = -1（全加载）时这一条按存档全景总数放大，显存与在途请求都跟着涨。
      * ⚠️ 形态判据读 `this._panoTexMode`（整图形态那一档一张全景只有一张整图，走 `_texCache` 那条路，
      *   走错档就是白下 32 片）⇒ 宿主若用自己那份形态变量（编辑器的 `store.panoTexMode`），
      *   要在调 `importData` 之前先 `setPanoTexMode` 推进来，编辑器那侧已按此接线。
      */
     prefetchHeadPanoramas() {
-        const n = Math.min(PANO_IMPORT_PRIORITY, this.textures.length);
+        const total = this.textures.length;
+        // -1 = 整份；0 = 一个都不提前（这一句直接空转，其余全景仍按距离名册排队 = 回到 10-29 之前的行为）
+        const n = this._panoPriorityCount < 0 ? total : Math.min(this._panoPriorityCount, total);
         // 正着点：0 号先入队 ⇒ 队首是它，落定后才轮到 1 号（`prioritize` 对已在队列里的键不挪位置）
         for (let i = 0; i < n; i++) {
             const info = this.textures[i];
@@ -1716,6 +1806,7 @@ export default class MktMesh extends Mesh {
         this._revealPending = [];
         // 隐藏期预热：清单、去重表与小屋子那套临时资源随本对象一起退场（那张 1×1 渲染目标是本类**唯一**自建的 RT）。
         // 走 `stopGpuPrewarm` 而不是 `_finishGpuPrewarm`：本对象都要没了，去重表再留着就是泄漏。
+        this._res.stop(); // 资源管理器：全景/平面那条链停、显示闸开、显存账作废（内部同样落到 `stopGpuPrewarm`）
         this.stopGpuPrewarm();
         this._stitcher.dispose();
         this._glRenderer = null;

package/MktMesh/MktMesh.ts

@@ -75,12 +75,19 @@ import { stripAssetHost, absAssetUrl } from "./assetUrl";
 //    原先各住在本站两个渲染器里一份 ⇒ 下游直接用包里的 `MktMesh` 时，存档里的 `images`/`models` 两键没人读。
 //    入库之后它们挂在 `MktMesh` **自己的子树**下，与墙同一棵变换 ⇒ 预览那三根 transform 滑杆搬得动整份展品。
 import { ImagePlane, type ImagePlaneData } from "./imagePlane";
-import { ModelSlot, type ModelSlotData } from "./modelSlot";
+import { ModelSlot, glbFileName, type ModelSlotData } from "./modelSlot";
 import { ImagePlaneTileLoader } from "./imageTileLoader";
-
-/** 载入 JSON 时**优先**加载几个全景的素材（2026-10-29 需求「优先加载前 2 个全景图的素材，然后再加载其他的」）。
- *  口径 = 存档 `textures` 数组的前 n 项；其余全景照常按每帧的槽位名册（离注视点最近 8 个）排队，只是排在它们后面。 */
-const PANO_IMPORT_PRIORITY = 2;
+// ⭐ 用户需求 2026-11-05「专门写一个资源管理器来管理, 每个 mktmesh 都有自己的一个资源管理器来管理」：
+//    隐藏期（`visible = false` ⇒ `onBeforeRender` 一次都不触发）里那三族资源的**驱动次序**与**是否已进显存**这本账。
+import { MktResourceManager } from "./mktResManager";
+
+/** 载入 JSON 时**优先**加载几个全景的素材的**默认档**（数值只写这一处）。
+ *  口径 = 存档 `textures` 数组的前 n 项（n = -1 视为整份全加载）；其余全景照常按每帧的槽位名册（离注视点最近 8 个）排队，只是排在它们后面。
+ *  2026-10-29 需求「优先加载前 2 个全景图的素材，然后再加载其他的」立的是 2；
+ *  2026-11-05 需求逐字「现在要默认把全景全部都要默认加载, 现在需要通过配置来设置, 提前加载多少个全景 -1 就是全加载 0就是不加载 1就是加载个 2就提前加载2个 一次类推, 默认加载前4个」⇒ 换成可配置的 4；
+ *  同日需求逐字「panoPriorityCount 设置为 -1, 不管有没有显示出来的全景图都应该默认全部加载, 等待渲染器的预载入」⇒ 默认档落 **-1（整份全加载）**。
+ *  ⚠️ 这一档管的是**下载与拼合的次序**；「亮出来之前先把它推进显存」是 `preRender(renderer)` 那一手（见 `./mktResManager`）。 */
+const PANO_IMPORT_PRIORITY_DEFAULT = -1;
 
 /** 隐藏期预热那一次绘制用的镜头（模块级共用：它只是个「有合法的投影矩阵可读」的载体，永不动 ⇒ ⛔ 不必每实例造一份）。 */
 const GPU_WARM_CAMERA = new OrthographicCamera(-1, 1, 1, -1, 0.1, 10);
@@ -231,6 +238,17 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         return this._panoTexMode;
     }
 
+    /** 优先加载的全景个数（存档 `textures` 的前 n 项）：**-1 = 全部、0 = 一个都不提前、n = 前 n 个**（2026-11-05 需求）。
+     *  默认取 `PANO_IMPORT_PRIORITY_DEFAULT`（= -1，同日需求「不管有没有显示出来的全景图都应该默认全部加载」）；
+     *  宿主想收窄，在渲染循环跑起来之前 `setPanoPriorityCount(4)` 一行即可
+     *  （与 `_ossSize`、`_panoTexMode` 同一套注入路径 ⇒ 编辑器与预览各自的配置各自推下来）。
+     *  ⚠️ 这一档只定**下载与拼合的次序**；隐藏期里谁来推那一拍 = `preRender(renderer)`（需求第 1、2 点）。 */
+    private _panoPriorityCount: number = PANO_IMPORT_PRIORITY_DEFAULT;
+    /** 当前优先加载个数（只读，回显用）。 */
+    get panoPriorityCount(): number {
+        return this._panoPriorityCount;
+    }
+
     // 复用临时对象（避免每帧 new，降低 GC 压力）
     private _tmpV3: Vector3 = new Vector3();
 
@@ -275,6 +293,26 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      */
     private _revealPending: Array<ImagePlane | ModelSlot> = [];
 
+    /**
+     * ⭐ 2026-11-05 需求「专门写一个资源管理器来管理，每个 mktmesh 都有自己的一个资源管理器」：本对象一份。
+     * 它不下载、不解码、不上传 ⇒ 全部经下面那几只手点本对象上**现成**的入口（拼合器 `pump` / `prefetchHeadPanoramas` /
+     * `feedImagePlaneTiles` / 隐藏期预热），只多管两件事：隐藏期由谁来推那一拍、以及「哪一档真画进过显存」这本账。
+     */
+    private _res = new MktResourceManager({
+        prewarm: (renderer) => this.startGpuPrewarm(renderer),
+        stopPrewarm: () => this.stopGpuPrewarm(),
+        // 挂着牌 = 还没摘牌且还没亮出来 ⇒ 与 `_topUpGpuPrewarm` 用的同一颗尺（⛔ 不自立第二道闸）
+        prewarming: () => this._warmSeen !== null && !this.visible,
+        shown: () => this.visible,
+        pumpPano: (renderer) => this._stitcher.pump(renderer),
+        prefetchPano: () => this.prefetchHeadPanoramas(),
+        feedPlanes: () => this.feedImagePlaneTiles(),
+    });
+    /** 本对象的资源管理器（只读）。宿主只管调 `preRender`，需要看账本时才用它。 */
+    get resManager(): MktResourceManager {
+        return this._res;
+    }
+
     /**
      * 隐藏期 GPU 预热的在册清单（元素 = 一个「会进渲染列表的物件」，即它的材质组合 × 几何）。
      * null = 没在预热（未启动 / 已跑完 / `stopGpuPrewarm` / `dispose` 四种都是它）。
@@ -323,6 +361,8 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             //   `updateTexture`（它里面那记 `pump` 是「第一次拿到 renderer ⇒ 在册组整份作废」的现场）之后、
             //   `feedFaceMapping`（名册逐槽入册）之前 —— 顺序倒过来就是「名册在前、我们垫底」= 静默失效。
             //   编辑态那份在 `MktDevMesh` 的宿主循环里照同一相对位置点（⛔ 别在这儿加第三处）。
+            //   2026-11-05 需求：这一批点几颗改由 `panoPriorityCount` 定（默认 -1 = 存档全部）⇒ 本句不动；
+            //   同一批在**隐藏期**由 `preRender(renderer)` 逐 tick 推（本钩子在那时一次都不触发）。
             this.prefetchHeadPanoramas();
             this.feedFaceMapping();
             this.tickProgressiveReveal();
@@ -1108,6 +1148,18 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         this._panoTexMode = next;
     }
 
+    /** 设置优先加载的全景个数：-1 = 全部 / 0 = 不提前 / n = 存档前 n 个（2026-11-05 需求）。
+     *  收口：负数（含 -2、NaN 一类）一律归到 -1「全加载」，正数向下取整；非有限值回落默认档。
+     *  改档⛔ 需要重新 `importData` —— 名册每帧重排，下一帧 `prefetchHeadPanoramas` 直接用新数点名
+     *  （`prioritize` 幂等 ⇒ 已在队列里的那批不重复投喂，也不会把已出队的旧批再塞回去）。 */
+    setPanoPriorityCount(count: number): void {
+        if (!Number.isFinite(count)) this._panoPriorityCount = PANO_IMPORT_PRIORITY_DEFAULT;
+        else {
+            const n = Math.floor(count);
+            this._panoPriorityCount = n < 0 ? -1 : n;
+        }
+    }
+
     /**
      * 记下「当前激活（名册 0 号槽 = 中心）是第几个全景」。
      * ⭐ 皇上旨 2026-10-03 旨②：预览立方体已与墙**共用同一份材质**，原来那句「把中心那几张抄给立方体单全景材质」
@@ -1237,6 +1289,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             ms.dispose();
         }
         this.models = [];
+        // 用户 2026-11-04「日志少打印点吧」⇒ 这一路（进厅 / 切项目 / 预览的整层重建）几十颗⛔ 不再一颗一行：
+        //   名单先攒着，循环结束打**一条**（文件名口径与 `setModelUrl` 那一记共用 `glbFileName`）⇒ 一颗不落、一行到位。
+        const glbNames: string[] = [];
         for (const d of datas) {
             const ms = new ModelSlot(d.name);
             ms.applyData(d);
@@ -1248,9 +1303,11 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
                 //（⚠️ 与旧的「GLB 在路上时这一槽露出占位方块」不同：整层重建这一路一颗都不露，直到轮到自己亮）
                 ms.visible = false;
                 this._revealPending.push(ms);
+                glbNames.push(glbFileName(d.url));
                 void ms.loadModel(d.url).then(() => this._queueModelMount(ms, onEachLoad));
             }
         }
+        if (glbNames.length > 0) console.log(`[MktMesh] 整层重建加载 ${glbNames.length} 个 glb：${glbNames.join("、")}`);
     }
 
     /** 把「备好待挂」的那一槽交给全局队列；⛔ 去重闸门自备（`addWork` 按闭包引用判重，新闭包它判不出来） */
@@ -1343,12 +1400,15 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *    表空了它就是一句 `length` 判断，⛔ 不需要再像旧写法那样把钩子置 null（钩子上还挂着全景投影那三件事）。
      * ⚠️ 这里写的 `visible` 只针对**自己压进表的那几颗** ⇒ 表外的对象（单颗新增、已 dispose、被 `releaseReveal`
      *    摘牌的）一律不碰；要在放行前接管某颗，调 `releaseReveal(o)`。
+     * ⭐ 2026-11-05 需求第 4 点「只已经预载入的资源才显示出来」：内容落定（`o.loaded`）之后还要问一句资源管理器
+     *    「这一档画进显存了吗」—— 只有宿主调过 `preRender` 且预热还挂着牌时才拦，摘牌 / 没调过 ⇒ 一律放行（⛔ 不许拦出永久黑屏）。
      */
     tickProgressiveReveal(): void {
         const q = this._revealPending;
         for (let i = 0; i < q.length; i++) {
             const o = q[i];
             if (!o.loaded) continue; // 内容还在路上 ⇒ 这一颗继续压着，先看后面已经落定的
+            if (this._res.holdsReveal(o)) continue; // 内容到了但还没进显存 ⇒ 等 `preRender` 那一拍画过它
             q.splice(i, 1);
             o.visible = true;
             return;
@@ -1357,6 +1417,26 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
 
     // ─────────────────── 隐藏期 GPU 预热（2026-11-01 需求：进厅那一下不要再现编着色器） ───────────────────
 
+    /**
+     * ⭐ 2026-11-05 需求第 1 点逐字：「需要提供一个 `preRender` 方法, 传入一个渲染器对象, 然后在这个方法里面使用
+     *  渲染来预载入已经准备好的资源到 GPU」。隐藏期（`visible = false`）里 three 遍历第一句就把本对象连同子树跳过
+     *  ⇒ `onBeforeRender` 一次都不触发，全景瓦片不下载不拼合、平面不绑、GLB 与墙的 program 不编不传；
+     *  本方法就是那句「藏起来的时候替它跑一遍渲染循环里的推进」，交进来的渲染器同时供拼合器与预热用。
+     *
+     * 一次点齐三族（次序固定，与 `onBeforeRender` 里同一相对位置）：
+     *   ① 全景 —— `stitcher.pump(renderer)` 逐 tick 走「补下载 → 画已进显存的格 → 传一张新的」，
+     *      额度由 `panoPriorityCount` 点的批排在前（默认 -1 = 整份存档，需求第 2 点）；
+     *   ② 平面图 —— `feedImagePlaneTiles()` 一次把整层地址交给下载、绑定一帧一颗（需求第 3 点：这两族本来就全量发起）；
+     *   ③ GLB / 平面 / 墙 —— 下面的 `startGpuPrewarm` 那一族逐 tick 画一件进 1×1 目标（program 编译 + 顶点缓冲首传）。
+     *
+     * 幂等 ⇒ 隐藏期里每帧点一次、或只在载入后点一次都行；已排进队列的那条链不会被重复起。
+     * 本对象一旦 `visible`（进厅），链自己停 ⇒ 之后交回 `onBeforeRender` 每帧那一路，⛔ 不抢同一帧的额度。
+     * ⛔ 不调本方法的宿主（发布页直接亮墙、编辑器画布）行为与改造前逐字一致：显示闸只在 `preRender` 点过之后才生效。
+     */
+    preRender(renderer: WebGLRenderer): void {
+        this._res.preRender(renderer);
+    }
+
     /**
      * 开始隐藏期预热：把「进厅第一帧要现编的那些 program + 要第一次上传的那些几何/纹理」提前跑掉，一帧只放**一件**。
      *
@@ -1453,6 +1533,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
             if (seen.has(key)) return;
             seen.add(key);
             items.push({ src: o, m: mesh.material as Material | Material[], g });
+            // ⭐ 2026-11-05 需求第 4 点：把「这一颗属于哪一档」交给资源管理器记账（键的算式仍只在这里这一处），
+            //   等 `_runGpuWarmStep` 真画过它再翻成「已进显存」⇒ `tickProgressiveReveal` 才放行。
+            this._res.noteWarmKey(o, key);
             added++;
         });
         return added;
@@ -1502,6 +1585,9 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         renderer.setRenderTarget(this._warmRt!);
         renderer.render(scene, GPU_WARM_CAMERA);
         renderer.setRenderTarget(prevTarget);
+        // ⭐ 2026-11-05 需求第 4 点：这一档刚刚真画进显存（program 编了、顶点缓冲与纹理首传也做了）⇒ 记上「已常驻」，
+        //   `tickProgressiveReveal` 那一拍才许把对应那颗亮出来（同一档的第二、第三颗跟着一起放行）。
+        this._res.markWarmDrawn(it.src);
         this._scheduleGpuWarmStep(renderer);
     }
 
@@ -1683,11 +1769,12 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
     }
 
     /**
-     * 把**存档里前 `PANO_IMPORT_PRIORITY` 个全景**按存档顺序登记进拼合器的**加载任务队列**
+     * 把**存档里前 `panoPriorityCount` 个全景**（-1 = 整份全加载）按存档顺序登记进拼合器的**加载任务队列**
      *（2026-10-29 需求「优先加载前 2 个全景素材」+ 2026-10-30 需求逐字：「给 mktmesh 内部加一个加载任务队列，
      *  把模型和平面图排在最前面，然后按照顺序，依次把前 2 个全景的顺序把瓦片加载任务添加到任务队列里面，
      *  第一个加载完了，就把这个加载任务从任务队列里面去掉，然后加载第二个；
-     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」）。
+     *  如果后续再按照距离计算需要加载哪个全景的时候，同样地添加到加载任务队列的后面等待加载」
+     *  + 2026-11-05 需求「提前加载多少个全景改由配置决定，-1 全加载 / 0 不加载 / n 前 n 个，默认 4」）。
      * 由两处渲染循环每帧点一次：基类 `onBeforeRender`（预览弹窗 / 发布页）与编辑器的 `updateFloorTexture`
      *（`MktDevMesh` 覆写了 `onBeforeRender`，只点 `syncProjInvMatrix` + `tickProgressiveReveal`，库内那句在编辑态不跑）。
      *
@@ -1696,27 +1783,31 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
      *      （GLB 逐只 `loadModel` 不 throttle；平面那 4 片一次性 `_imgTileLoader.preload`），
      *      而全景瓦片最早也要等下一帧的 `pump` 才发第一片 ⇒ 发起次序天然是「模型 → 平面图 → 全景」，
      *      ⛔ 这里不再把它们塞进队列重复管一遍（塞了就是第二把尺）。
-     *   ② 本方法把存档 0 号、1 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
+     *   ② 本方法把存档 0 号起这 n 号依次 `prioritize` 进队列 ⇒ 拼合器每帧**只喂队首那一组**，
      *      0 号 32 格全落定（画进 RT，或该格本就缺地址/判死）才出队、1 号才开始发第一片。
      *      比 10-29 那版（只是把两批挪到在册顺序前面、额度仍被两批分摊）更硬：**第 1 颗独享额度，最快出全图**。
+     *      n = -1（全加载）时这一条变成「整份存档按存档顺序串行」⇒ 距离名册插不到前面，出清速度取决于总片数。
      *   ③ 名册按距离点到的其他全景走 `feedFaceMapping` 里那句 `ensure(t.tiles)`（不带队列）⇒ 只入册、
      *      排在队列后面等，队列空了才按在册顺序补料（现行口径不变）。
      * ⚠️⚠️ 为什么每帧点而⛔ 只在 `importData` 里点一记：预览每开一次都换渲染器，`_switchRenderer` 把在册组
      *   整份作废（队列里的键也在同一刻失效）；只在载入那次点名等于白点。本方法点在 `pump` 之后、名册逐槽
-     *   `ensure` 之前 ⇒ 每帧把这两记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以 0 号恒在 1 号前）。
+     *   `ensure` 之前 ⇒ 每帧把这几记任务补回队列头部（`prioritize` 幂等，已在队列里就不挪，所以存档次序恒不变）。
      * ⚠️ 代价如实记：
-     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前两颗的那面墙会多灰一会儿。
+     *   · 队列非空时**其他全景一片都不发** ⇒ 开机那几秒里，离注视点最近、但不在存档前 n 颗的那面墙会多灰一会儿。
      *   · 一颗「永远下不完」的瓦片（下载失败还没累计到判死）会压住队列；判死阈值是解码失败 3 次
-     *     （`_dead`），退避重试期间队首不落定 ⇒ 第 2 颗跟着延后。真实数据里缺片是「地址为空/404」，
+     *     （`_dead`），退避重试期间队首不落定 ⇒ 后面几颗跟着延后。真实数据里缺片是「地址为空/404」，
      *     404 走三次即判死、那一格拼合涂灰 ⇒ 队列照样出清。
-     *   · 这两颗全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
-     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这两个景点迟早要建。
+     *   · 这批全景若本来不在开机那一刻的名册里，它们的瓦片与拼合槽 RT 会被**提前**建出来
+     *     （现行口径每颗全景 2 槽 × 6144² ≈ 384MB 显存）—— 组在运行中不淘汰，走进这些景点迟早要建；
+     *     ⚠️ n = -1（全加载）时这一条按存档全景总数放大，显存与在途请求都跟着涨。
      * ⚠️ 形态判据读 `this._panoTexMode`（整图形态那一档一张全景只有一张整图，走 `_texCache` 那条路，
      *   走错档就是白下 32 片）⇒ 宿主若用自己那份形态变量（编辑器的 `store.panoTexMode`），
      *   要在调 `importData` 之前先 `setPanoTexMode` 推进来，编辑器那侧已按此接线。
      */
     prefetchHeadPanoramas(): void {
-        const n = Math.min(PANO_IMPORT_PRIORITY, this.textures.length);
+        const total = this.textures.length;
+        // -1 = 整份；0 = 一个都不提前（这一句直接空转，其余全景仍按距离名册排队 = 回到 10-29 之前的行为）
+        const n = this._panoPriorityCount < 0 ? total : Math.min(this._panoPriorityCount, total);
         // 正着点：0 号先入队 ⇒ 队首是它，落定后才轮到 1 号（`prioritize` 对已在队列里的键不挪位置）
         for (let i = 0; i < n; i++) {
             const info = this.textures[i];
@@ -1757,6 +1848,7 @@ export default class MktMesh extends Mesh<BufferGeometry, ShaderMaterial> {
         this._revealPending = [];
         // 隐藏期预热：清单、去重表与小屋子那套临时资源随本对象一起退场（那张 1×1 渲染目标是本类**唯一**自建的 RT）。
         // 走 `stopGpuPrewarm` 而不是 `_finishGpuPrewarm`：本对象都要没了，去重表再留着就是泄漏。
+        this._res.stop(); // 资源管理器：全景/平面那条链停、显示闸开、显存账作废（内部同样落到 `stopGpuPrewarm`）
         this.stopGpuPrewarm();
         this._stitcher.dispose();
         this._glRenderer = null;