three-base 2.0.169 → 2.0.172

package/ThreeBase.js

@@ -18,7 +18,7 @@ import frosted_glass_pass from "./pass/frosted_glass_pass";
 import { flushLensflareOverlays } from "./lensflare/LensFlare";
 import glow_pass from "./pass/glow_pass";
 import stroke_pass from "./pass/stroke_pass";
-import ssao_pass, { renderAoDepthPass, renderExcludedMaskPass, visibleDepthOptions } from "./pass/ssao_pass";
+import ssao_pass, { renderVisibleDepthPass, renderExcludedMaskPass } from "./pass/ssao_pass";
 import screenBloomPass from "./pass/screen_bloom_pass";
 import copyShader from "./shaders/copyShader";
 import { baseTextureToRenderShader } from "./shaders/baseTextureToRenderShader";
@@ -260,12 +260,13 @@ export default class ThreeBase extends EventDispatcher {
         stencilBuffer: false,
         depthTexture: this.baseDepthTexture,
     });
-    // AO 深度纹理（含地板）：**不再单独渲染一遍** —— 它挂在 normalRenderTarget 上当 depth attachment，
-    // 法线 pass（renderAoNormalPass，includeFloor=true）渲染时深度由光栅器顺带写入，白拿一张含地板深度。
-    // （2026-09-14 优化：删掉原 ssao_pass 内那次 renderAoDepthPass(true)，每帧省一次全场景遍历。）
-    // SSAO 的 GTAO 采样它（地板保留为实体 → 接触 AO），合成时再与 depthRenderTarget
-    // （地板排除 = 可见深度）比对，作废"透过半透明地板看到的实体"上的地板接触 AO。
-    // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
+    // AO 深度纹理：**不再单独渲染一遍** —— 它挂在 normalRenderTarget 上当 depth attachment，
+    // 法线 pass（renderAoNormalPass，excludeTransparent=true）渲染时深度由光栅器顺带写入，白拿一张。
+    // （2026-09-14 优化：删掉原 ssao_pass 内那次独立的含地板深度 pass，每帧省一次全场景遍历。）
+    // SSAO 的 GTAO 采样它（与法线同源）；合成时再与 depthRenderTarget（可见深度 = 各物体自身材质渲染）
+    // 比对：AO 侧更近说明那像素记到屏幕上不可见的面（抠图空隙 / 单面墙背面）→ 作废该像素 AO。
+    // ⚠️ 2026-10-11：地板（Ground1）现在两张图都写（旧的 aoFloor 排除特例已整条拆除），
+    //   见 three-base/pass/ssao_pass.ts 文件头与复合守卫说明。
     aoDepthTexture = (() => {
         const t = new DepthTexture(4096, 4096);
         t.format = DepthFormat;
@@ -276,8 +277,8 @@ export default class ThreeBase extends EventDispatcher {
     /**
      * 调试用：深度预览模式。由面板「深度调试」切换，便于逐一看各深度图排查"深度测试全部失效"根因。
      *   - "none"    ：正常渲染（默认）
-     *   - "global"  ：仅预览全局深度图（baseDepthTexture，排除地板）。全白=深度为空→renderAoDepthPass 没写进深度。
-     *   - "ao"      ：仅预览 AO 深度图（aoDepthTexture = 法线 pass 顺带写入的含地板深度）。用于确认深度管线本身是否工作。
+     *   - "global"  ：仅预览可见深度图（baseDepthTexture，含地板）。全白=深度为空→renderVisibleDepthPass 没写进深度。
+     *   - "ao"      ：仅预览 AO 深度图（aoDepthTexture = 法线 pass 顺带写入）。用于确认深度管线本身是否工作。
      *   - "compare" ：R=全局 base 深度，G=最近一次 glow/stroke 选区 select 深度。两路任一全白即该侧写入失败。
      *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=该面写不进深度，永远挡不住后处理）。
      *                 物体区域（G 暗）若 B 全黑 → 判定从不触发；再看该区 R/G 谁大即可定位是谁缺深度。
@@ -285,20 +286,6 @@ export default class ThreeBase extends EventDispatcher {
      * 通用控制台入口：任意页面都可 `window.__TB_DEBUG_DEPTH = "judge"`（优先级高于面板属性）。
      */
     debugDepthPreview = "none";
-    /**
-     * 可见深度图是否包含「标了 userData.aoFloor 的地板」（如 Ground1）。
-     *
-     * 默认 false —— 原设计：地板可透视，透过地板看到的物体照常显示（不被地板挡住）。
-     * 置 true 后地板会写进 baseDepthTexture，**被地板挡住的描边/辉光/毛玻璃/覆盖色会被正确遮挡**。
-     * 排查"怎么都挡不住"时先开这个试一下：若开了就正常，说明挡你的正是可透视地板。
-     */
-    get baseDepthIncludeFloor() {
-        return visibleDepthOptions.includeFloor;
-    }
-    set baseDepthIncludeFloor(v) {
-        visibleDepthOptions.includeFloor = v;
-        this.needRender = true;
-    }
     // 法线专用渲染目标（无 MSAA，存储视图空间法线，供 GTAO 风格 SSAO 使用真实法线）
     normalRenderTarget = new WebGLRenderTarget(128, 128, {
         minFilter: LinearFilter,
@@ -1019,10 +1006,11 @@ export default class ThreeBase extends EventDispatcher {
             this.renderer.setRenderTarget(this.baseRenderTarget);
             this.renderer.clear();
             this.renderer.render(this.scene, camera);
-            // 深度 pass：固定排除非实体表面后渲到 depthRenderTarget（生成 baseDepthTexture）。
+            // 可见深度 pass：用各物体自身材质渲染（含地板；sprite/线条/点与显式 aoTransparent 面除外），
+            // 产出 baseDepthTexture 供描边/发光/覆盖/磨砂做遮挡判定。
             // 必须在 base render 之后、所有依赖深度的特效（描边/发光/覆盖/磨砂）之前更新，
             // 否则这些特效会用到上一帧旧深度 → 遮挡判定错乱。法线 pass 已收进 ssao_pass 内部。
-            renderAoDepthPass(this.renderer, camera, this.scene, this.depthRenderTarget);
+            renderVisibleDepthPass(this.renderer, camera, this.scene, this.depthRenderTarget);
             // 切回 baseRenderTarget，后处理 pass 需要把效果叠加到颜色渲染目标上
             this.renderer.setRenderTarget(this.baseRenderTarget);
             // 效果 mask 灰度图尺寸 = effectiveRatio × resolution，与 baseRenderTarget / baseDepthTexture 同倍率，
@@ -1088,7 +1076,7 @@ export default class ThreeBase extends EventDispatcher {
             // 分辨率按实际帧缓冲像素（已乘 dpr）设置，修复高分屏下 FXAA 采样比例偏大失效的问题。
             // ⚠️ 深度调试预览（面板「深度调试」切换，定位"深度测试全部失效"根因）：
             //   旧控制台入口 `window.__BASE_DEPTH_VIS = true` 仍可用，等价于切到 "global"。
-            //   global  → baseDepthTexture 灰度。全白=深度为空(renderAoDepthPass 没写进)→后处理一律显示在前；有灰阶=深度正常，问题在比对侧。
+            //   global  → baseDepthTexture 灰度。全白=深度为空(renderVisibleDepthPass 没写进)→后处理一律显示在前；有灰阶=深度正常，问题在比对侧。
             //   ao      → aoDepthTexture 灰度（含地板）。确认深度管线本身是否工作（GTAO 是否拿到正确深度）。
             //   compare → R=全局 base 深度，G=最近一次 glow/stroke 选区的 select 深度。两路任一全白即该侧写入失败。
             //   judge   → R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)。

package/ThreeBase.ts

@@ -19,7 +19,7 @@ import frosted_glass_pass from "./pass/frosted_glass_pass";
 import { flushLensflareOverlays } from "./lensflare/LensFlare";
 import glow_pass from "./pass/glow_pass";
 import stroke_pass from "./pass/stroke_pass";
-import ssao_pass, { renderAoDepthPass, renderExcludedMaskPass, visibleDepthOptions } from "./pass/ssao_pass";
+import ssao_pass, { renderVisibleDepthPass, renderExcludedMaskPass } from "./pass/ssao_pass";
 import screenBloomPass from "./pass/screen_bloom_pass";
 import copyShader from "./shaders/copyShader";
 import { baseTextureToRenderShader } from "./shaders/baseTextureToRenderShader";
@@ -321,12 +321,13 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
         stencilBuffer: false,
         depthTexture: this.baseDepthTexture,
     });
-    // AO 深度纹理（含地板）：**不再单独渲染一遍** —— 它挂在 normalRenderTarget 上当 depth attachment，
-    // 法线 pass（renderAoNormalPass，includeFloor=true）渲染时深度由光栅器顺带写入，白拿一张含地板深度。
-    // （2026-09-14 优化：删掉原 ssao_pass 内那次 renderAoDepthPass(true)，每帧省一次全场景遍历。）
-    // SSAO 的 GTAO 采样它（地板保留为实体 → 接触 AO），合成时再与 depthRenderTarget
-    // （地板排除 = 可见深度）比对，作废"透过半透明地板看到的实体"上的地板接触 AO。
-    // 见 three-base/pass/ssao_pass.ts 的复合守卫说明。
+    // AO 深度纹理：**不再单独渲染一遍** —— 它挂在 normalRenderTarget 上当 depth attachment，
+    // 法线 pass（renderAoNormalPass，excludeTransparent=true）渲染时深度由光栅器顺带写入，白拿一张。
+    // （2026-09-14 优化：删掉原 ssao_pass 内那次独立的含地板深度 pass，每帧省一次全场景遍历。）
+    // SSAO 的 GTAO 采样它（与法线同源）；合成时再与 depthRenderTarget（可见深度 = 各物体自身材质渲染）
+    // 比对：AO 侧更近说明那像素记到屏幕上不可见的面（抠图空隙 / 单面墙背面）→ 作废该像素 AO。
+    // ⚠️ 2026-10-11：地板（Ground1）现在两张图都写（旧的 aoFloor 排除特例已整条拆除），
+    //   见 three-base/pass/ssao_pass.ts 文件头与复合守卫说明。
     aoDepthTexture: DepthTexture = (() => {
         const t = new DepthTexture(4096, 4096);
         t.format = DepthFormat;
@@ -337,8 +338,8 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
     /**
      * 调试用：深度预览模式。由面板「深度调试」切换，便于逐一看各深度图排查"深度测试全部失效"根因。
      *   - "none"    ：正常渲染（默认）
-     *   - "global"  ：仅预览全局深度图（baseDepthTexture，排除地板）。全白=深度为空→renderAoDepthPass 没写进深度。
-     *   - "ao"      ：仅预览 AO 深度图（aoDepthTexture = 法线 pass 顺带写入的含地板深度）。用于确认深度管线本身是否工作。
+     *   - "global"  ：仅预览可见深度图（baseDepthTexture，含地板）。全白=深度为空→renderVisibleDepthPass 没写进深度。
+     *   - "ao"      ：仅预览 AO 深度图（aoDepthTexture = 法线 pass 顺带写入）。用于确认深度管线本身是否工作。
      *   - "compare" ：R=全局 base 深度，G=最近一次 glow/stroke 选区 select 深度。两路任一全白即该侧写入失败。
      *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=该面写不进深度，永远挡不住后处理）。
      *                 物体区域（G 暗）若 B 全黑 → 判定从不触发；再看该区 R/G 谁大即可定位是谁缺深度。
@@ -347,20 +348,6 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
      */
     public debugDepthPreview: DebugDepthMode = "none";
 
-    /**
-     * 可见深度图是否包含「标了 userData.aoFloor 的地板」（如 Ground1）。
-     *
-     * 默认 false —— 原设计：地板可透视，透过地板看到的物体照常显示（不被地板挡住）。
-     * 置 true 后地板会写进 baseDepthTexture，**被地板挡住的描边/辉光/毛玻璃/覆盖色会被正确遮挡**。
-     * 排查"怎么都挡不住"时先开这个试一下：若开了就正常，说明挡你的正是可透视地板。
-     */
-    public get baseDepthIncludeFloor(): boolean {
-        return visibleDepthOptions.includeFloor;
-    }
-    public set baseDepthIncludeFloor(v: boolean) {
-        visibleDepthOptions.includeFloor = v;
-        this.needRender = true;
-    }
     // 法线专用渲染目标（无 MSAA，存储视图空间法线，供 GTAO 风格 SSAO 使用真实法线）
     normalRenderTarget: WebGLRenderTarget<Texture> = new WebGLRenderTarget(128, 128, {
         minFilter: LinearFilter,
@@ -1131,10 +1118,11 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
             this.renderer.setRenderTarget(this.baseRenderTarget);
             this.renderer.clear();
             this.renderer.render(this.scene, camera);
-            // 深度 pass：固定排除非实体表面后渲到 depthRenderTarget（生成 baseDepthTexture）。
+            // 可见深度 pass：用各物体自身材质渲染（含地板；sprite/线条/点与显式 aoTransparent 面除外），
+            // 产出 baseDepthTexture 供描边/发光/覆盖/磨砂做遮挡判定。
             // 必须在 base render 之后、所有依赖深度的特效（描边/发光/覆盖/磨砂）之前更新，
             // 否则这些特效会用到上一帧旧深度 → 遮挡判定错乱。法线 pass 已收进 ssao_pass 内部。
-            renderAoDepthPass(this.renderer, camera, this.scene, this.depthRenderTarget);
+            renderVisibleDepthPass(this.renderer, camera, this.scene, this.depthRenderTarget);
             // 切回 baseRenderTarget，后处理 pass 需要把效果叠加到颜色渲染目标上
             this.renderer.setRenderTarget(this.baseRenderTarget);
             // 效果 mask 灰度图尺寸 = effectiveRatio × resolution，与 baseRenderTarget / baseDepthTexture 同倍率，
@@ -1204,7 +1192,7 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
             // 分辨率按实际帧缓冲像素（已乘 dpr）设置，修复高分屏下 FXAA 采样比例偏大失效的问题。
             // ⚠️ 深度调试预览（面板「深度调试」切换，定位"深度测试全部失效"根因）：
             //   旧控制台入口 `window.__BASE_DEPTH_VIS = true` 仍可用，等价于切到 "global"。
-            //   global  → baseDepthTexture 灰度。全白=深度为空(renderAoDepthPass 没写进)→后处理一律显示在前；有灰阶=深度正常，问题在比对侧。
+            //   global  → baseDepthTexture 灰度。全白=深度为空(renderVisibleDepthPass 没写进)→后处理一律显示在前；有灰阶=深度正常，问题在比对侧。
             //   ao      → aoDepthTexture 灰度（含地板）。确认深度管线本身是否工作（GTAO 是否拿到正确深度）。
             //   compare → R=全局 base 深度，G=最近一次 glow/stroke 选区的 select 深度。两路任一全白即该侧写入失败。
             //   judge   → R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)。

package/WaterFlow/WaterFlow.d.ts

@@ -26,7 +26,7 @@ import type { BasinConfig, FluidParameters, FluidQuality, ReservoirState, WaterF
  *     depthMode: 'logarithmic',
  *   });
  *   // 每帧：先 renderer.setRenderTarget(baseRenderTarget); renderer.render(scene, camera);
- *   //       再 renderAoDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
+ *   //       再 renderVisibleDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
  *   //       然后 water.update(dt, elapsed);
  *   //       最后 setRenderTarget(screenRT); fsQuad.render(renderer, pass.material);
  *   // 注意：WaterFlow 的 composite 是纯消费 base 纹理的 fsQuad，可直接放进你的链。

package/WaterFlow/WaterFlow.js

@@ -25,7 +25,7 @@ import { ScreenSpaceFluidPass } from './ScreenSpaceFluidPass';
  *     depthMode: 'logarithmic',
  *   });
  *   // 每帧：先 renderer.setRenderTarget(baseRenderTarget); renderer.render(scene, camera);
- *   //       再 renderAoDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
+ *   //       再 renderVisibleDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
  *   //       然后 water.update(dt, elapsed);
  *   //       最后 setRenderTarget(screenRT); fsQuad.render(renderer, pass.material);
  *   // 注意：WaterFlow 的 composite 是纯消费 base 纹理的 fsQuad，可直接放进你的链。

package/WaterFlow/WaterFlow.ts

@@ -36,7 +36,7 @@ import type {
  *     depthMode: 'logarithmic',
  *   });
  *   // 每帧：先 renderer.setRenderTarget(baseRenderTarget); renderer.render(scene, camera);
- *   //       再 renderAoDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
+ *   //       再 renderVisibleDepthPass(renderer, camera, scene, depthRenderTarget);  // 写 baseDepthTexture
  *   //       然后 water.update(dt, elapsed);
  *   //       最后 setRenderTarget(screenRT); fsQuad.render(renderer, pass.material);
  *   // 注意：WaterFlow 的 composite 是纯消费 base 纹理的 fsQuad，可直接放进你的链。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-base",
-  "version": "2.0.169",
+  "version": "2.0.172",
   "description": "A Three.js extension library providing common 3D components, animations, materials, and utilities",
   "author": "xiaosihan",
   "publishConfig": {

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

@@ -2,8 +2,8 @@ import type { DepthTexture } from "three";
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
  *   - "none"    ：正常渲染（默认）
- *   - "global"  ：全局深度图（baseDepthTexture，排除地板）
- *   - "ao"      ：AO 深度图（aoDepthTexture，含地板）
+ *   - "global"  ：可见深度图（baseDepthTexture，各物体自身材质渲染，含地板）
+ *   - "ao"      ：AO 深度图（aoDepthTexture，法线 pass 顺带写入，override 渲染）
  *   - "compare" ：R=base 深度、G=选区 select 深度（对数反解后归一化）
  *   - "judge"   ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
  *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=挡不住任何后处理）

package/pass/debugDepthState.ts

@@ -3,8 +3,8 @@ import type { DepthTexture } from "three";
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
  *   - "none"    ：正常渲染（默认）
- *   - "global"  ：全局深度图（baseDepthTexture，排除地板）
- *   - "ao"      ：AO 深度图（aoDepthTexture，含地板）
+ *   - "global"  ：可见深度图（baseDepthTexture，各物体自身材质渲染，含地板）
+ *   - "ao"      ：AO 深度图（aoDepthTexture，法线 pass 顺带写入，override 渲染）
  *   - "compare" ：R=base 深度、G=选区 select 深度（对数反解后归一化）
  *   - "judge"   ：R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)
  *   - "excluded"：深度图灰度 + 「被排除出深度图的面」叠红（红=挡不住任何后处理）

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,
@@ -483,7 +478,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;
@@ -495,16 +489,14 @@ export default function glow_pass(renderer, camera, object3d, baseDepthTexture,
     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。

package/pass/glow_pass.ts

@@ -17,25 +17,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 视觉边缘错位，辉光边缘锯齿。
     // 边缘抗锯齿统一由 mask 内部 FXAA + 终处理 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,
@@ -521,7 +515,6 @@ export default function glow_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;
@@ -534,17 +527,14 @@ export default function glow_pass(
     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;