three-base 2.0.169 → 2.0.175

package/instanced/InstancedGroup.ts

@@ -14,6 +14,46 @@ const PICK_EVENT_TYPES = [
     "mouseup",
 ];
 
+/** 一个 batch 的合并情况快照（详见 `InstancedGroup.snapshot`） */
+export interface InstancedBatchSnapshot {
+    /** 分桶键：`geo:<geometryUuid>/<materialUuid>` 或 `url:<glb>:anim:<剪辑名>` */
+    key: string;
+    /** 本桶里的逻辑实例数（InstancedChild） */
+    childCount: number;
+    /** 真实 InstancedMesh 个数 = 本桶一帧的 draw call 数（GLB 多 submesh ⇒ 大于 1） */
+    drawCalls: number;
+    /** 实例缓冲容量（只增不减） */
+    capacity: number;
+    /** GLB 模板是否已就绪；false ⇒ 实例已登记但还没画出来 */
+    ready: boolean;
+    /** 每个 InstancedMesh 实际写入的实例数（与 drawCalls 一一对应） */
+    counts: number[];
+    /** 子实例的可读标签（name 优先，其次构造器名） */
+    children: string[];
+    /** 首个 InstancedMesh 的几何类型名（如 `BoxGeometry`）；模板未就绪时为空串 */
+    geomType: string;
+    /** 首个 InstancedMesh 的材质类型名（多材质为 `多材质`）；模板未就绪时为空串 */
+    matType: string;
+}
+
+/** 一个 InstancedGroup 的合并总览 */
+export interface InstancedGroupSnapshot {
+    /** 本组归属 tag；undefined = ThreeBase 默认组（只收未声明归属的实例） */
+    owner?: string;
+    batches: InstancedBatchSnapshot[];
+    /** 已收进各 batch 的实例总数 */
+    merged: number;
+    /** 全局注册表里的 InstancedChild 总数（含归属其他组的） */
+    registryTotal: number;
+    /**
+     * 累计创建过的 InstancedChild 总数（只增不减，dispose 不回退）。
+     * 与 `registryTotal` 配对即得「已销毁 = createdTotal - registryTotal」。
+     */
+    createdTotal: number;
+    /** 归属本组却没进任何 batch 的实例数：正常恒为 0，非 0 说明分桶/收集有漏 */
+    leaked: number;
+}
+
 /**
  * 固定在 ThreeBase.scene 里的分组器。每帧收集所有 InstancedChild，按 batchKey（glb+当前生效动画）分组，
  * 为每个 key 创建/复用 InstancedBatch，把实例的世界矩阵 / 颜色同步进真实 InstancedMesh。
@@ -118,6 +158,51 @@ export default class InstancedGroup extends Object3D {
         }
     }
 
+    /**
+     * 只读快照：本组当前的合并情况，供调试面板画拓扑图。
+     *
+     * 归属判定（哪些注册表实例该由本组收集）刻意留在这里而不是让调用方自己判 ——
+     * 规则与 `_accepts` 必须同源，否则面板报的「未合并数」会与实际渲染不符。
+     *
+     * ⚠️ 子实例标签取 `name`，其次取构造器名：业务子类若没设 `name`，生产构建（压缩后）
+     * 构造器名会变成短标识符。要在拓扑图里认出实例，请给实例设 `name`（同 [[InstancedChild]] 的控制台可读命名约定）。
+     */
+    snapshot(): InstancedGroupSnapshot {
+        const batches: InstancedBatchSnapshot[] = [];
+        let merged = 0;
+        for (const batch of this.batches.values()) {
+            const childCount = batch.childCount;
+            merged += childCount;
+            const first = batch.pickables[0];
+            const mat = first?.material;
+            batches.push({
+                key: batch.key,
+                childCount,
+                drawCalls: batch.pickables.length,
+                capacity: batch.capacity,
+                ready: batch.ready,
+                counts: batch.pickables.map((im) => im.count),
+                children: batch.childrenView.map((c) => c.name || c.constructor.name),
+                geomType: first?.geometry.type ?? "",
+                matType: Array.isArray(mat) ? "多材质" : mat?.type ?? "",
+            });
+        }
+        let accepted = 0;
+        for (const child of instancedChildRegistry) {
+            if (this._accepts(child)) {
+                accepted++;
+            }
+        }
+        return {
+            owner: this.owner,
+            batches,
+            merged,
+            registryTotal: instancedChildRegistry.size,
+            createdTotal: InstancedChild.createdTotal,
+            leaked: accepted - merged,
+        };
+    }
+
     /**
      * 释放本组的全部 batch（实例缓冲 + 从组内摘除 mesh）。
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-base",
-  "version": "2.0.169",
+  "version": "2.0.175",
   "description": "A Three.js extension library providing common 3D components, animations, materials, and utilities",
   "author": "xiaosihan",
   "publishConfig": {
@@ -76,12 +76,8 @@
     "./shaders/baseDepthVis": "./shaders/baseDepthVisShader.js",
     "./shaders/debugDepthCompare": "./shaders/debugDepthCompareShader.js",
     "./shaders/debugDepthJudge": "./shaders/debugDepthJudgeShader.js",
-    "./shaders/debugExcluded": "./shaders/debugExcludedShader.js",
     "./Fire/FireGeometry": "./Fire/FireGeometry.js",
-    "./Fire/FireMaterial": "./Fire/FireMaterial.js",
-    "./WaterFlow": "./WaterFlow/WaterFlow.js",
-    "./WaterFlow/WaterFlow": "./WaterFlow/WaterFlow.js",
-    "./WaterFlow/waterFlowPass": "./WaterFlow/waterFlowPass.js"
+    "./Fire/FireMaterial": "./Fire/FireMaterial.js"
   },
   "files": [
     "*.ts",
@@ -99,7 +95,6 @@
     "SpriteModal1/",
     "Text3D/",
     "Water/",
-    "WaterFlow/",
     "instanced/",
     "lensflare/",
     "pass/",

package/pass/bloom_pass.js

@@ -15,23 +15,18 @@ const selectDepthTexture = (() => {
     baseDepthTexture.anisotropy = 16;
     return baseDepthTexture;
 })();
+// ⭐ 2026-10-11 皇上旨「简化渲染」：selectDepthTexture 挂在本目标上当 depth attachment，
+// mask 那一趟光栅化顺带写出本体深度 ⇒ 原来为同一对象再渲一趟「只出深度」整条删除。
 const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTest 判定边界与 mask 视觉边缘错位，bloom 边缘锯齿/摩尔纹。
     // 边缘抗锯齿统一由终处理 FXAA 兜底。
 });
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
 const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -117,7 +112,6 @@ export default function bloom_pass(renderer, camera, object3d, baseRenderTarget,
     size.multiplyScalar(devicePixelRatio);
     bloomPass.setSize(size.x, size.y);
     selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
     // 缺陷②修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
     // 需手动把 selectDepthTexture 的尺寸与全屏 baseDepth 对齐，否则深度比例错位导致 bloom 被全部 discard
     selectDepthTexture.image.width = size.x;
@@ -168,13 +162,12 @@ export default function bloom_pass(renderer, camera, object3d, baseRenderTarget,
         }
     });
     try {
+        // ⭐ mask 这一趟顺带把本体深度写进 selectDepthTexture（挂在 selectTextureTarget 的 depth
+        //   attachment 上）；原先紧随其后的「只渲深度」第二趟（同材质/同相机/同几何 ⇒ 深度逐位相同）
+        //   已在 2026-10-11 皇上旨简化时删除。与材质/父节点还原同生命周期。
         renderer.setRenderTarget(selectTextureTarget);
         renderer.clear();
         renderer.render(scene, camera);
-        // 单独渲染对象深度到无 MSAA 目标，供 depthTestShader 做遮挡判定（与材质/父节点还原同生命周期）
-        renderer.setRenderTarget(selectDepthTextureTarget);
-        renderer.clear();
-        renderer.render(scene, camera);
     }
     finally {
         // 还原材质 emissive

package/pass/bloom_pass.ts

@@ -18,25 +18,19 @@ const selectDepthTexture: DepthTexture = (() => {
     return baseDepthTexture;
 })();
 
+// ⭐ 2026-10-11 皇上旨「简化渲染」：selectDepthTexture 挂在本目标上当 depth attachment，
+// mask 那一趟光栅化顺带写出本体深度 ⇒ 原来为同一对象再渲一趟「只出深度」整条删除。
 const selectTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTest 判定边界与 mask 视觉边缘错位，bloom 边缘锯齿/摩尔纹。
     // 边缘抗锯齿统一由终处理 FXAA 兜底。
 });
 
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
-
 const selectDepthTestTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -145,7 +139,6 @@ export default function bloom_pass(
     size.multiplyScalar(devicePixelRatio);
     bloomPass.setSize(size.x, size.y);
     selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
     // 缺陷②修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
     // 需手动把 selectDepthTexture 的尺寸与全屏 baseDepth 对齐，否则深度比例错位导致 bloom 被全部 discard
     selectDepthTexture.image.width = size.x;
@@ -198,14 +191,12 @@ export default function bloom_pass(
     });
 
     try {
+        // ⭐ mask 这一趟顺带把本体深度写进 selectDepthTexture（挂在 selectTextureTarget 的 depth
+        //   attachment 上）；原先紧随其后的「只渲深度」第二趟（同材质/同相机/同几何 ⇒ 深度逐位相同）
+        //   已在 2026-10-11 皇上旨简化时删除。与材质/父节点还原同生命周期。
         renderer.setRenderTarget(selectTextureTarget);
         renderer.clear();
         renderer.render(scene, camera);
-
-        // 单独渲染对象深度到无 MSAA 目标，供 depthTestShader 做遮挡判定（与材质/父节点还原同生命周期）
-        renderer.setRenderTarget(selectDepthTextureTarget);
-        renderer.clear();
-        renderer.render(scene, camera);
     } finally {
         // 还原材质 emissive
         emissiveBackup.forEach(({ material, emissive, emissiveIntensity }) => {

package/pass/cover_pass.js

@@ -20,23 +20,18 @@ const selectDepthTexture = (() => {
     baseDepthTexture.anisotropy = 16;
     return baseDepthTexture;
 })();
+// ⭐ 2026-10-11 皇上旨「简化渲染」：selectDepthTexture 挂在本目标上当 depth attachment，
+// mask 那一趟光栅化顺带写出本体深度 ⇒ 原来为同一对象再渲一趟「只出深度」整条删除。
 const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，覆盖边缘锯齿。
     // 边缘抗锯齿统一由终处理 FXAA 兜底。
 });
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
 const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -125,7 +120,6 @@ export default function cover_pass(renderer, camera, object3d, baseDepthTexture,
     renderer.getSize(size);
     size.multiplyScalar(devicePixelRatio);
     selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
     // 缺陷修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
     // 需手动把 selectDepthTexture 尺寸与全屏 baseDepth 对齐，否则深度比例错位导致颜色覆盖被错误 discard
     selectDepthTexture.image.width = size.x;
@@ -133,15 +127,13 @@ export default function cover_pass(renderer, camera, object3d, baseDepthTexture,
     selectDepthTexture.needsUpdate = true;
     selectDepthTestTextureTarget.setSize(size.x, size.y);
     blur1TextureTarget.setSize(size.x, size.y);
+    // ⭐ mask 那一趟光栅化顺带把本体深度写进 selectDepthTexture（挂在 selectTextureTarget 的
+    //   depth attachment 上）；原先紧随其后的「只渲深度」第二趟（同材质/同相机/同几何 ⇒ 深度逐位相同）
+    //   已在 2026-10-11 皇上旨简化时删除。
     renderer.setRenderTarget(selectTextureTarget);
     scene.children = [object3d];
     renderer.clear();
     renderer.render(scene, camera);
-    // 单独渲染对象深度到无 MSAA 目标，供 depthTestShader 做遮挡判定
-    renderer.setRenderTarget(selectDepthTextureTarget);
-    scene.children = [object3d];
-    renderer.clear();
-    renderer.render(scene, camera);
     // 调试：记录选区深度，供面板「深度判定图 / 辉光深度比对」排查 cover 的遮挡判定
     debugDepthState.lastSelectDepth = selectDepthTexture;
     renderer.setRenderTarget(originRenderTarget);

package/pass/cover_pass.ts

@@ -23,25 +23,19 @@ const selectDepthTexture: DepthTexture = (() => {
     return baseDepthTexture;
 })();
 
+// ⭐ 2026-10-11 皇上旨「简化渲染」：selectDepthTexture 挂在本目标上当 depth attachment，
+// mask 那一趟光栅化顺带写出本体深度 ⇒ 原来为同一对象再渲一趟「只出深度」整条删除。
 const selectTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，覆盖边缘锯齿。
     // 边缘抗锯齿统一由终处理 FXAA 兜底。
 });
 
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
-
 const selectDepthTestTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -149,7 +143,6 @@ export default function cover_pass(
     renderer.getSize(size);
     size.multiplyScalar(devicePixelRatio);
     selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
     // 缺陷修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
     // 需手动把 selectDepthTexture 尺寸与全屏 baseDepth 对齐，否则深度比例错位导致颜色覆盖被错误 discard
     selectDepthTexture.image.width = size.x;
@@ -157,16 +150,13 @@ export default function cover_pass(
     selectDepthTexture.needsUpdate = true;
     selectDepthTestTextureTarget.setSize(size.x, size.y);
     blur1TextureTarget.setSize(size.x, size.y);
+    // ⭐ mask 那一趟光栅化顺带把本体深度写进 selectDepthTexture（挂在 selectTextureTarget 的
+    //   depth attachment 上）；原先紧随其后的「只渲深度」第二趟（同材质/同相机/同几何 ⇒ 深度逐位相同）
+    //   已在 2026-10-11 皇上旨简化时删除。
     renderer.setRenderTarget(selectTextureTarget);
     scene.children = [object3d];
     renderer.clear();
     renderer.render(scene, camera);
-
-    // 单独渲染对象深度到无 MSAA 目标，供 depthTestShader 做遮挡判定
-    renderer.setRenderTarget(selectDepthTextureTarget);
-    scene.children = [object3d];
-    renderer.clear();
-    renderer.render(scene, camera);
     // 调试：记录选区深度，供面板「深度判定图 / 辉光深度比对」排查 cover 的遮挡判定
     debugDepthState.lastSelectDepth = selectDepthTexture;
 

package/pass/debugDepthState.d.ts

@@ -1,20 +1,28 @@
-import type { DepthTexture } from "three";
+import type { DepthTexture, Texture } from "three";
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
- *   - "none"    ：正常渲染（默认）
- *   - "global"  ：全局深度图（baseDepthTexture，排除地板）
- *   - "ao"      ：AO 深度图（aoDepthTexture，含地板）
- *   - "compare" ：R=base 深度、G=选区 select 深度（对数反解后归一化）
- *   - "judge"   ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
- *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=挡不住任何后处理）
+ *   - "none"            ：正常渲染（默认）
+ *   - "global"          ：可见深度图（baseDepthTexture，各物体自身材质渲染；2026-10-18 起收全场景对象，含地板）
+ *   - "ao"              ：AO 深度图（aoDepthTexture，法线 pass 顺带写入，override 渲染，同样收全场景对象）
+ *   - "compare"         ：R=base 深度、G=选区 select 深度（对数反解后归一化）
+ *   - "judge"           ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
+ *   - "strokeSelect"    ：【描边步骤 1】选区本体深度（selectDepthTexture，mask 那趟光栅化顺带写入）
+ *   - "strokeSelectBlur"：【描边步骤 5.5】描边外扩后的选区深度（selectDepthBlurTextureTarget，
+ *                        RGBA8 的 R 通道存对数深度，外扩环取邻域最近深度）
+ * ⚠️ 2026-10-18 皇上旨「所有的对象都要进入到深度图里面了，不需要用参数过滤掉了」⇒ 原 "excluded"
+ *    档（把被排除的面叠红）连同 ssao_pass 的排除判据整条删除，已无「写不进深度图的面」可标。
  */
-export type DebugDepthMode = "none" | "global" | "ao" | "compare" | "judge" | "excluded";
+export type DebugDepthMode = "none" | "global" | "ao" | "compare" | "judge" | "strokeSelect" | "strokeSelectBlur";
 /**
  * 调试用全局状态：记录最近一次 glow_pass / stroke_pass 渲染的「选区自身深度图」(selectDepth)。
  * 供 ThreeBase 渲染末尾的「辉光深度比对」调试视图读取（R=全局 base 深度，G=选区 select 深度），
  * 让用户一眼看出到底是「全局 base 深度没写进」还是「选区自身深度没写进」。
  * 由各 pass 在渲染完 selectDepth 后写入；每帧会被最后一个被处理的可见对象覆盖（调试够用）。
+ *
+ * lastSelectBlurDepth：描边专属（步骤 5.5 外扩后的选区深度）。它是 RGBA8 目标（不是 DepthTexture），
+ * 深度值存在 .r 通道里 —— 可视化时同样取 .r 即可。glow/cover/frosted 没有这一步，故只有 stroke_pass 写。
  */
 export declare const debugDepthState: {
     lastSelectDepth: DepthTexture | null;
+    lastSelectBlurDepth: Texture | null;
 };

package/pass/debugDepthState.js

@@ -3,7 +3,11 @@
  * 供 ThreeBase 渲染末尾的「辉光深度比对」调试视图读取（R=全局 base 深度，G=选区 select 深度），
  * 让用户一眼看出到底是「全局 base 深度没写进」还是「选区自身深度没写进」。
  * 由各 pass 在渲染完 selectDepth 后写入；每帧会被最后一个被处理的可见对象覆盖（调试够用）。
+ *
+ * lastSelectBlurDepth：描边专属（步骤 5.5 外扩后的选区深度）。它是 RGBA8 目标（不是 DepthTexture），
+ * 深度值存在 .r 通道里 —— 可视化时同样取 .r 即可。glow/cover/frosted 没有这一步，故只有 stroke_pass 写。
  */
 export const debugDepthState = {
     lastSelectDepth: null,
+    lastSelectBlurDepth: null,
 };

package/pass/debugDepthState.ts

@@ -1,22 +1,40 @@
-import type { DepthTexture } from "three";
+import type { DepthTexture, Texture } from "three";
 
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
- *   - "none"    ：正常渲染（默认）
- *   - "global"  ：全局深度图（baseDepthTexture，排除地板）
- *   - "ao"      ：AO 深度图（aoDepthTexture，含地板）
- *   - "compare" ：R=base 深度、G=选区 select 深度（对数反解后归一化）
- *   - "judge"   ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
- *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=挡不住任何后处理）
+ *   - "none"            ：正常渲染（默认）
+ *   - "global"          ：可见深度图（baseDepthTexture，各物体自身材质渲染；2026-10-18 起收全场景对象，含地板）
+ *   - "ao"              ：AO 深度图（aoDepthTexture，法线 pass 顺带写入，override 渲染，同样收全场景对象）
+ *   - "compare"         ：R=base 深度、G=选区 select 深度（对数反解后归一化）
+ *   - "judge"           ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
+ *   - "strokeSelect"    ：【描边步骤 1】选区本体深度（selectDepthTexture，mask 那趟光栅化顺带写入）
+ *   - "strokeSelectBlur"：【描边步骤 5.5】描边外扩后的选区深度（selectDepthBlurTextureTarget，
+ *                        RGBA8 的 R 通道存对数深度，外扩环取邻域最近深度）
+ * ⚠️ 2026-10-18 皇上旨「所有的对象都要进入到深度图里面了，不需要用参数过滤掉了」⇒ 原 "excluded"
+ *    档（把被排除的面叠红）连同 ssao_pass 的排除判据整条删除，已无「写不进深度图的面」可标。
  */
-export type DebugDepthMode = "none" | "global" | "ao" | "compare" | "judge" | "excluded";
+export type DebugDepthMode =
+    | "none"
+    | "global"
+    | "ao"
+    | "compare"
+    | "judge"
+    | "strokeSelect"
+    | "strokeSelectBlur";
 
 /**
  * 调试用全局状态：记录最近一次 glow_pass / stroke_pass 渲染的「选区自身深度图」(selectDepth)。
  * 供 ThreeBase 渲染末尾的「辉光深度比对」调试视图读取（R=全局 base 深度，G=选区 select 深度），
  * 让用户一眼看出到底是「全局 base 深度没写进」还是「选区自身深度没写进」。
  * 由各 pass 在渲染完 selectDepth 后写入；每帧会被最后一个被处理的可见对象覆盖（调试够用）。
+ *
+ * lastSelectBlurDepth：描边专属（步骤 5.5 外扩后的选区深度）。它是 RGBA8 目标（不是 DepthTexture），
+ * 深度值存在 .r 通道里 —— 可视化时同样取 .r 即可。glow/cover/frosted 没有这一步，故只有 stroke_pass 写。
  */
-export const debugDepthState: { lastSelectDepth: DepthTexture | null } = {
+export const debugDepthState: {
+    lastSelectDepth: DepthTexture | null;
+    lastSelectBlurDepth: Texture | null;
+} = {
     lastSelectDepth: null,
+    lastSelectBlurDepth: null,
 };

package/pass/glow_pass.js

@@ -14,23 +14,18 @@ const selectDepthTexture = (() => {
     baseDepthTexture.anisotropy = 16;
     return baseDepthTexture;
 })();
+// ⭐ 2026-10-11 皇上旨「简化渲染」：selectDepthTexture 挂在本目标上当 depth attachment，
+// mask 那一趟光栅化顺带写出本体深度 ⇒ 原来为同一对象再渲一趟「只出深度」整条删除。
 const selectTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
     format: RGBAFormat,
+    depthTexture: selectDepthTexture,
     anisotropy: 16,
-    // 无 MSAA：mask 颜色与下方 selectDepthTextureTarget（深度）必须同为硬边缘，
+    // 无 MSAA：mask 颜色与它顺带写入的深度必须同为硬边缘，
     // 否则 mask 边缘平滑而深度硬 → depthTestShader 判定边界与 mask 视觉边缘错位，辉光边缘锯齿。
     // 边缘抗锯齿统一由 mask 内部 FXAA + 终处理 FXAA 兜底。
 });
-// 无 MSAA 的深度专用目标：仅用于导出对象深度，供 depthTestShader 做遮挡判定（深度无需抗锯齿）
-const selectDepthTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-    depthTexture: selectDepthTexture,
-    anisotropy: 16,
-});
 const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
     minFilter: LinearFilter,
     magFilter: LinearFilter,
@@ -48,24 +43,13 @@ const blur2TextureTarget = new WebGLRenderTarget(1024, 1024, {
     magFilter: LinearFilter,
     format: RGBAFormat,
 });
-// 外扩深度临时/结果目标：depthMinBlurShader 把本体深度图随 mask 一起外扩，
-// 外扩区取邻域最近深度（忽略背景 1.0），使外扩区 selD<1.0，depthTest 才能正确判遮挡（不漏光）。
-const selectDepthBlurTmpTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-});
-const selectDepthBlurTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-});
-// 外扩辉光经深度测试后的结果（步骤 5.6）：独立 target，避免回写 blur1 触发历史回归 bug
-const blurDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
-    minFilter: LinearFilter,
-    magFilter: LinearFilter,
-    format: RGBAFormat,
-});
+// ⭐ 2026-10-25 皇上旨「步骤 5.6 外扩辉光再判遮挡 不要这不」：
+//   原「步骤 5.5 深度外扩（min-blur）+ 5.6 外扩辉光再判遮挡」整段删除，连同
+//   selectDepthBlurTmp / selectDepthBlur / blurDepthTest 三个 RT 与 depthMinBlurShader。
+//   原因：min-blur 的膨胀窗口是 ±10×radius 的方形（radius = glow_width×2，与单趟高斯采样步长同源），
+//   而模糊迭代 N 次后等效扩散按 σ√N 增长 ⇒ 窗口外那圈光的 selD 仍是「背景 1.0」，
+//   被 baseD(天空 0.9) < selD(1.0) 判成「被挡住」→ discard → 光晕被硬切一刀。
+//   代价（已知并接受）：物体被更近的物体挡住时，辉光不再从遮挡物前方被裁掉，会透出来。
 const size = new Vector2();
 const depthTestShader = new ShaderMaterial({
     uniforms: {
@@ -209,52 +193,6 @@ const gaussianBlurVShader = new RawShaderMaterial({
     depthWrite: false,
     transparent: true,
 });
-// 深度 min-blur（最近深度，忽略背景 1.0）：随 mask 一起把深度图向外扩，
-// 外扩区 selD = 物体最近深度(<1.0) 而非清屏 1.0，depthTest 在外扩区才能正确判遮挡（不漏光），
-// 同时本体区仍靠 depthTestShader 的 EPSILON 容差防自遮挡闪烁（无缝）。separable（direction 控制 H/V）。
-const depthMinBlurShader = new ShaderMaterial({
-    uniforms: {
-        tDepth: { value: null },
-        resolution: { value: new Vector2(1 / 512, 1 / 512) },
-        radius: { value: 1.0 },
-        direction: { value: new Vector2(1, 0) },
-    },
-    vertexShader: `
-        ${ShaderChunk.common}
-        ${ShaderChunk.logdepthbuf_pars_vertex}
-        varying vec2 vUv;
-        void main() {
-            vUv = uv;
-            gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
-            ${ShaderChunk.logdepthbuf_vertex}
-        }
-    `,
-    fragmentShader: `
-        ${ShaderChunk.logdepthbuf_pars_fragment}
-        uniform sampler2D tDepth;
-        uniform vec2 resolution;
-        uniform float radius;
-        uniform vec2 direction;
-        varying vec2 vUv;
-        void main() {
-            float minD = 1.0;
-            for (int i = -10; i <= 10; i++) {
-                float x = float(i);
-                vec2 off = direction * (x * radius * resolution);
-                float d = texture2D(tDepth, vUv + off).r;
-                if (d < 0.9999) {
-                    minD = min(minD, d);
-                }
-            }
-            gl_FragColor = vec4(minD, 0.0, 0.0, 1.0);
-            ${ShaderChunk.logdepthbuf_fragment}
-        }
-    `,
-    blending: NoBlending,
-    depthTest: false,
-    depthWrite: false,
-    transparent: true,
-});
 const glowCompositeShader = new RawShaderMaterial({
     uniforms: {
         tDiffuse: { value: null },
@@ -483,7 +421,6 @@ export default function glow_pass(renderer, camera, object3d, baseDepthTexture,
     renderer.getSize(size);
     size.multiplyScalar(devicePixelRatio);
     selectTextureTarget.setSize(size.x, size.y);
-    selectDepthTextureTarget.setSize(size.x, size.y);
     // 缺陷修复：three r167 的 WebGLRenderTarget.setSize 不会同步 depthTexture，
     // 需手动把 selectDepthTexture 尺寸与全屏 baseDepth 对齐，否则深度比例错位导致辉光被错误 discard
     selectDepthTexture.image.width = size.x;
@@ -492,19 +429,14 @@ export default function glow_pass(renderer, camera, object3d, baseDepthTexture,
     selectDepthTestTextureTarget.setSize(size.x, size.y);
     blur1TextureTarget.setSize(size.x, size.y);
     blur2TextureTarget.setSize(size.x, size.y);
-    selectDepthBlurTmpTextureTarget.setSize(size.x, size.y);
-    selectDepthBlurTextureTarget.setSize(size.x, size.y);
-    blurDepthTestTextureTarget.setSize(size.x, size.y);
-    // 1. 渲染物体本体 mask（灰度）
+    // 1. 渲染物体本体 mask（灰度）。⭐ 本体深度由同一趟光栅化顺带写进 selectDepthTexture
+    //   （挂在 selectTextureTarget 的 depth attachment 上）；原先的第 2 趟「只渲深度」（供 min-blur
+    //   外扩用）与这趟同材质/同相机/同几何 ⇒ 深度逐位相同，2026-10-11 皇上旨简化时删除。
+    //   （下面的步骤编号保留 3/4/5…，别处注释按号交叉引用，不随之重排。）
     renderer.setRenderTarget(selectTextureTarget);
     scene.children = [object3d];
     renderer.clear();
     renderer.render(scene, camera);
-    // 2. 渲染物体本体深度（无 MSAA，供 min-blur 外扩用）
-    renderer.setRenderTarget(selectDepthTextureTarget);
-    scene.children = [object3d];
-    renderer.clear();
-    renderer.render(scene, camera);
     // 调试：把本次渲染的选区深度记到全局调试状态，供面板「辉光深度比对」读取
     debugDepthState.lastSelectDepth = selectDepthTexture;
     // 3. 深度测试（用本体 mask）：被真实更近物体挡住的「本体辉光」部分 discard。
@@ -553,36 +485,13 @@ export default function glow_pass(renderer, camera, object3d, baseDepthTexture,
     glowCompositeShader.uniforms.threshold.value = glow_threshold;
     glowCompositeShader.uniforms.intensity.value = glow_intensity;
     fsQuad.render(renderer, glowCompositeShader);
-    // 5.5 ⭐ 外扩环深度测试（补齐此前只定义未调用的死代码，与 stroke_pass 同一修复）：
-    //   本体深度随辉光一起外扩（separable H/V，外扩区取邻域最近深度），
-    //   再用它对外扩后的辉光做一次 depthTest —— 否则外扩环永远不参与遮挡判定，
-    //   物体被挡住时辉光依旧从遮挡物前方漏出来。
-    depthMinBlurShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    depthMinBlurShader.uniforms.radius.value = Math.max(1, blurRadius);
-    depthMinBlurShader.uniforms.direction.value.set(1, 0);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthTexture;
-    renderer.setRenderTarget(selectDepthBlurTmpTextureTarget);
-    renderer.clear();
-    fsQuad.render(renderer, depthMinBlurShader);
-    depthMinBlurShader.uniforms.direction.value.set(0, 1);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthBlurTmpTextureTarget.texture;
-    renderer.setRenderTarget(selectDepthBlurTextureTarget);
-    renderer.clear();
-    fsQuad.render(renderer, depthMinBlurShader);
-    // 5.6 对外扩后的辉光判遮挡（输出到独立 target，绝不回写 blur1，避免步骤 6 相减归零）
-    renderer.setRenderTarget(blurDepthTestTextureTarget);
-    renderer.clear();
-    depthTestShader.uniforms.map.value = blur1TextureTarget.texture;
-    depthTestShader.uniforms.baseDepth.value = baseDepthTexture;
-    depthTestShader.uniforms.selectDepth.value = selectDepthBlurTextureTarget.texture;
-    depthTestShader.uniforms.cameraFar.value = camera.far;
-    fsQuad.render(renderer, depthTestShader);
-    // 6. 合成到屏幕：filterSelect(blur=上色后且已判遮挡的最终外扩辉光, select=深度测试后本体辉光)
-    //    = 仅保留辉光外扩环；本体被减掉。⚠️ blur 必须是最终外扩辉光，绝不能被 depthTest 结果覆盖
+    // 6. 合成到屏幕：filterSelect(blur=上色后的外扩辉光 blur1, select=深度测试后本体辉光)
+    //    = 仅保留辉光外扩环；本体被减掉。⚠️ blur 必须是上色后的 blur1，绝不能被别的结果覆盖
     //    （早期回归：误把 depthTest 结果上色进 blur1 → filterSelect 相减归零 → 辉光全不显示）。
+    //    ⭐ 2026-10-25 起外扩环不再做第二次遮挡判定（皇上旨删 5.6），blur1 直接就是最终辉光。
     renderer.setRenderTarget(originRenderTarget);
     filterSelectShader.uniforms.selectTexture.value = selectDepthTestTextureTarget.texture;
-    filterSelectShader.uniforms.blurTexture.value = blurDepthTestTextureTarget.texture;
+    filterSelectShader.uniforms.blurTexture.value = blur1TextureTarget.texture;
     filterSelectShader.uniforms.opacity.value = glow_opacity;
     // glow_additive=true 时用加性混合，光晕叠加到画面呈发光感（很亮那种）；否则普通半透明覆盖（默认）
     filterSelectShader.blending = glow_additive ? AdditiveBlending : NormalBlending;