three-base 2.0.197 → 2.0.199

package/MktMesh/modelSlot.ts

@@ -42,6 +42,11 @@ import threeLoader from "../threeLoader";
 import threeUtils from "../threeUtils";
 import BoxLine2 from "./boxLine2";
 
+/** glb 地址 → 文件名（日志唯一口径：去掉查询串取最后一段；⛔ 别在打印点各写一份 split） */
+export function glbFileName(url: string): string {
+    return url.split("?")[0].split("/").pop() || url;
+}
+
 /** 模型槽的持久化数据（进 exportData / importData / 预览 loadData） */
 export interface ModelSlotData {
     name?: string;
@@ -219,6 +224,9 @@ export class ModelSlot extends Group {
             this._loaded = true;
             return true;
         }
+        // 用户 2026-11-04「日志少打印点吧」⇒ 这一颗的取回入口⛔ 不出声：整层重建一次几十颗，逐颗一行会刷屏。
+        //   文件名改由两个批次入口各打一条 —— 单颗动作（上传/复制/换地址）在下面的 `setModelUrl`，
+        //   整层重建在 `MktMesh.setModels`（那边一条列全）⇒ 一颗不落，但一拍一条。
         // 取回失败（404 / 解析报错都从这一档走）：`threeLoader.loadModel` 是会 reject 的，⚠️ 必须当「落定在占位方块」处理
         //   —— 整层重建时这一颗是压着不亮的，不落定就永远隐形（旧写法里它至少还露得出占位方块）。
         let obj: Object3D | undefined;
@@ -263,6 +271,10 @@ export class ModelSlot extends Group {
      * @returns 是否真的挂上了（地址无效/载入失败/这次结果已作废 ⇒ false；空地址 = 退回占位，返回 true）
      */
     async setModelUrl(url: string): Promise<boolean> {
+        // 用户 2026-11-04「日志少打印点吧」⇒ 逐颗一行从 `loadModel` 挪到这里：这一路一次动作只动一/几颗
+        //   （上传 .glb、复制模型、换同名 glb），一条就是他能对上号的那一颗；整层重建那几十颗由
+        //   `MktMesh.setModels` 攒成一条 ⇒ 文件名仍「一颗不落」，行数从 N 降到 1。空地址 = 退回占位，不打。
+        if (url) console.log(`[MktMesh] 加载 glb「${this.name}」：${glbFileName(url)}`);
         if (!(await this.loadModel(url))) return false;
         if (this._staged) this.mountStaged();
         return true;

package/ThreeBase.js

@@ -971,10 +971,8 @@ export default class ThreeBase extends EventDispatcher {
             //   compare → R=全局 base 深度，G=最近一次 glow/stroke 选区的 select 深度。两路任一全白即该侧写入失败。
             //   judge   → R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)。
             //   strokeSelect     → 【描边步骤 1】选区本体深度（selectDepthTexture），白色=空背景、灰=物体本体。
-            //   strokeSelectBlur → 【描边步骤 5.5】描边外扩后的选区深度（selectDepthBlurTextureTarget），
-            //                      物体轮廓比本体档更胖一圈即外扩生效。
             // 通用控制台入口（任意页面可用，优先级高于面板属性）：
-            //   `window.__TB_DEBUG_DEPTH = "global" | "ao" | "compare" | "judge" | "strokeSelect" | "strokeSelectBlur"`，
+            //   `window.__TB_DEBUG_DEPTH = "global" | "ao" | "compare" | "judge" | "strokeSelect"`，
             //   设回 "none" 恢复。
             const dbgWin = window.__TB_DEBUG_DEPTH;
             const dbgMode = window.__BASE_DEPTH_VIS
@@ -1011,13 +1009,6 @@ export default class ThreeBase extends EventDispatcher {
                         debugDepthState.lastSelectDepth ?? this.baseDepthTexture;
                     fsQuad.render(this.renderer, baseDepthVisShader);
                 }
-                else if (dbgMode === "strokeSelectBlur") {
-                    // 描边步骤 5.5：外扩后的选区深度（RGBA8 目标，对数深度存在 .r 通道）。
-                    // 与本体档对比看：外扩生效时物体轮廓会「胖一圈」，被遮挡的外扩环则被判 discard 后不参与。
-                    baseDepthVisShader.uniforms.tDepth.value =
-                        debugDepthState.lastSelectBlurDepth ?? this.baseDepthTexture;
-                    fsQuad.render(this.renderer, baseDepthVisShader);
-                }
                 flushLensflareOverlays(this.renderer, camera);
                 return;
             }

package/ThreeBase.ts

@@ -1071,10 +1071,8 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
             //   compare → R=全局 base 深度，G=最近一次 glow/stroke 选区的 select 深度。两路任一全白即该侧写入失败。
             //   judge   → R=base 原始深度、G=select 原始深度、B=判定结果(1=判为被遮挡应 discard)。
             //   strokeSelect     → 【描边步骤 1】选区本体深度（selectDepthTexture），白色=空背景、灰=物体本体。
-            //   strokeSelectBlur → 【描边步骤 5.5】描边外扩后的选区深度（selectDepthBlurTextureTarget），
-            //                      物体轮廓比本体档更胖一圈即外扩生效。
             // 通用控制台入口（任意页面可用，优先级高于面板属性）：
-            //   `window.__TB_DEBUG_DEPTH = "global" | "ao" | "compare" | "judge" | "strokeSelect" | "strokeSelectBlur"`，
+            //   `window.__TB_DEBUG_DEPTH = "global" | "ao" | "compare" | "judge" | "strokeSelect"`，
             //   设回 "none" 恢复。
             const dbgWin = (window as unknown as { __TB_DEBUG_DEPTH?: DebugDepthMode }).__TB_DEBUG_DEPTH;
             const dbgMode = (window as unknown as { __BASE_DEPTH_VIS?: boolean }).__BASE_DEPTH_VIS
@@ -1106,12 +1104,6 @@ export default class ThreeBase extends EventDispatcher<ThreeBaseEventTypeMap> {
                     baseDepthVisShader.uniforms.tDepth.value =
                         debugDepthState.lastSelectDepth ?? this.baseDepthTexture;
                     fsQuad.render(this.renderer, baseDepthVisShader);
-                } else if (dbgMode === "strokeSelectBlur") {
-                    // 描边步骤 5.5：外扩后的选区深度（RGBA8 目标，对数深度存在 .r 通道）。
-                    // 与本体档对比看：外扩生效时物体轮廓会「胖一圈」，被遮挡的外扩环则被判 discard 后不参与。
-                    baseDepthVisShader.uniforms.tDepth.value =
-                        debugDepthState.lastSelectBlurDepth ?? this.baseDepthTexture;
-                    fsQuad.render(this.renderer, baseDepthVisShader);
                 }
                 flushLensflareOverlays(this.renderer, camera);
                 return;

package/package.json

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

package/pass/debugDepthState.d.ts

@@ -1,4 +1,4 @@
-import type { DepthTexture, Texture } from "three";
+import type { DepthTexture } from "three";
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
  *   - "none"            ：正常渲染（默认）
@@ -7,22 +7,18 @@ import type { DepthTexture, Texture } from "three";
  *   - "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 的排除判据整条删除，已无「写不进深度图的面」可标。
+ * ⚠️ 2026-11-04 描边回到年初口径 ⇒ 原 "strokeSelectBlur" 档（步骤 5.5 外扩后的选区深度）连同
+ *    那条 min-blur 整条删除，管线里已无「外扩深度」可供显示。
  */
-export type DebugDepthMode = "none" | "global" | "ao" | "compare" | "judge" | "strokeSelect" | "strokeSelectBlur";
+export type DebugDepthMode = "none" | "global" | "ao" | "compare" | "judge" | "strokeSelect";
 /**
  * 调试用全局状态：记录最近一次 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,11 +3,7 @@
  * 供 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,4 +1,4 @@
-import type { DepthTexture, Texture } from "three";
+import type { DepthTexture } from "three";
 
 /**
  * 深度调试预览模式（面板按钮与控制台 `window.__TB_DEBUG_DEPTH` 共用同一枚举）：
@@ -8,10 +8,10 @@ import type { DepthTexture, Texture } from "three";
  *   - "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 的排除判据整条删除，已无「写不进深度图的面」可标。
+ * ⚠️ 2026-11-04 描边回到年初口径 ⇒ 原 "strokeSelectBlur" 档（步骤 5.5 外扩后的选区深度）连同
+ *    那条 min-blur 整条删除，管线里已无「外扩深度」可供显示。
  */
 export type DebugDepthMode =
     | "none"
@@ -19,22 +19,16 @@ export type DebugDepthMode =
     | "ao"
     | "compare"
     | "judge"
-    | "strokeSelect"
-    | "strokeSelectBlur";
+    | "strokeSelect";
 
 /**
  * 调试用全局状态：记录最近一次 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;
-    lastSelectBlurDepth: Texture | null;
 } = {
     lastSelectDepth: null,
-    lastSelectBlurDepth: null,
 };

package/pass/stroke_pass.js

@@ -38,12 +38,6 @@ const selectDepthTestTextureTarget = new WebGLRenderTarget(1024, 1024, {
 });
 const blur1TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
 const blur2TextureTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-// 外扩深度临时/结果目标：depthMinBlurShader 把本体深度图随描边一起外扩，
-// 外扩区取邻域最近深度（忽略背景 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 });
 const size = new Vector2();
 const depthTestShader = new ShaderMaterial({
     uniforms: {
@@ -383,52 +377,6 @@ const strokeShader = new RawShaderMaterial({
     depthWrite: false,
     transparent: true
 });
-// 深度 min-blur（最近深度，忽略背景 1.0）：随描边一起把深度图向外扩，
-// 外扩区 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 filterSelectShader = new RawShaderMaterial({
     uniforms: {
         selectTexture: { value: null },
@@ -508,9 +456,6 @@ export default function stroke_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（灰度）。⭐ 本体深度由同一趟光栅化顺带写进 selectDepthTexture
     //   （挂在 selectTextureTarget 的 depth attachment 上）—— 原先这里还有第 2 趟「只渲深度」，
     //   同材质/同相机/同几何 ⇒ 深度逐位相同，纯重复遍历，2026-10-11 皇上旨简化时删除。
@@ -532,7 +477,8 @@ export default function stroke_pass(renderer, camera, object3d, baseDepthTexture
     depthTestShader.uniforms.cameraFar.value = camera.far;
     depthTestShader.uniforms.uDebugVis.value = (window.__STROKE_DEPTH_VIS) ? 1.0 : 0.0;
     fsQuad.render(renderer, depthTestShader);
-    // 4. 从「深度测试后的本体描边」开始外扩（外扩环自动继承本体遮挡判定 → 不漏光），
+    // 4. 从「深度测试后的本体描边」开始外扩（外扩的源头是本体判过的结果，被挡掉的本体不会再长出描边；
+    //    但外扩出来那圈像素本身不再判深度 ⇒ 贴着遮挡物时会压到遮挡物前面，见步骤 6 的代价点名），
     //    描边粗细由 stroke_width 控制的迭代次数决定。
     strokeShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
     FXAAShaderMaterial.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
@@ -557,42 +503,14 @@ export default function stroke_pass(renderer, camera, object3d, baseDepthTexture
     renderer.setRenderTarget(blur1TextureTarget);
     FXAAShaderMaterial.uniforms.tDiffuse.value = blur2TextureTarget.texture;
     fsQuad.render(renderer, FXAAShaderMaterial);
-    // 5.5 ⭐ 外扩环深度测试（补齐此前只定义未调用的死代码）：
-    //   本体深度随描边一起外扩（separable H/V，外扩区取邻域最近深度），
-    //   再用它对外扩后的描边做一次 depthTest。
-    //   缺了这一步，外扩环（描边的视觉主体）永远不参与遮挡判定 →
-    //   物体被挡住时描边依旧从遮挡物前方漏出来（"深度测试看起来失效"的真根因之一）。
-    depthMinBlurShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    depthMinBlurShader.uniforms.radius.value = Math.max(1, stroke_width);
-    // H：直接采 DepthTexture（selectDepthTexture），其 .r 即对数深度
-    depthMinBlurShader.uniforms.direction.value.set(1, 0);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthTexture;
-    renderer.setRenderTarget(selectDepthBlurTmpTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-    // V
-    depthMinBlurShader.uniforms.direction.value.set(0, 1);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthBlurTmpTextureTarget.texture;
-    renderer.setRenderTarget(selectDepthBlurTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-    // 调试：记录「外扩后的选区深度」，供面板「深度图（分步）」的步骤 5.5 档读取。
-    // 它是 RGBA8 目标、对数深度存在 .r 里（与 DepthTexture 取 .r 的读法一致）。
-    debugDepthState.lastSelectBlurDepth = selectDepthBlurTextureTarget.texture;
-    // 5.6 对外扩后的描边判遮挡：被更近几何挡住的外扩环像素 discard。
-    //     ⚠️ 输出到独立 target，绝不回写 blur1（历史回归 bug：blur1 被 depthTest 结果覆盖
-    //        会导致步骤 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;
-    depthTestShader.uniforms.uDebugVis.value = 0.0;
-    fsQuad.render(renderer, depthTestShader);
-    // 6. 合成：最终外扩描边(blurDepthTest，已判遮挡) 减去 深度测试后的本体描边
-    //    = 仅保留描边外扩环；本体被减掉。filterSelectShader 用 NormalBlending 叠到场景上。
+    // 6. 合成：FXAA 后的外扩描边(blur1) 减去 深度测试后的本体 = 仅保留描边外扩环；本体被减掉。
+    //    ⚠️ 2026-11-04 决定回到「年初口径」：原先这里有 5.5（本体深度随描边一起 separable min-blur 外扩）
+    //    与 5.6（用外扩后的深度再判一次遮挡）两趟，作用是外扩环也参与遮挡判定 ⇒ 物体被挡住时描边不漏光。
+    //    撤掉换来的是每个描边对象每帧全屏绘制 10 趟降 7 趟（min-blur 那两趟是 ±10 共 21 次采样/像素，最贵）；
+    //    代价点名：只有本体参与判遮挡，外扩环不参与 ⇒ 物体贴着遮挡物边缘时，一圈描边会压在遮挡物前面。
     renderer.setRenderTarget(originRenderTarget);
     filterSelectShader.uniforms.selectTexture.value = selectDepthTestTextureTarget.texture;
-    filterSelectShader.uniforms.blurTexture.value = blurDepthTestTextureTarget.texture;
+    filterSelectShader.uniforms.blurTexture.value = blur1TextureTarget.texture;
     filterSelectShader.blending = NormalBlending;
     fsQuad.render(renderer, filterSelectShader);
 }

package/pass/stroke_pass.ts

@@ -44,12 +44,6 @@ const selectDepthTestTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(10
 const blur1TextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
 
 const blur2TextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-// 外扩深度临时/结果目标：depthMinBlurShader 把本体深度图随描边一起外扩，
-// 外扩区取邻域最近深度（忽略背景 1.0），使外扩区 selD<1.0，depthTest 才能正确判遮挡（不漏光）。
-const selectDepthBlurTmpTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-const selectDepthBlurTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
-// 外扩描边经深度测试后的结果（步骤 5.6）：独立 target，避免回写 blur1 触发历史回归 bug
-const blurDepthTestTextureTarget: WebGLRenderTarget = new WebGLRenderTarget(1024, 1024, { minFilter: LinearFilter, magFilter: LinearFilter, format: RGBAFormat });
 
 const size: Vector2 = new Vector2();
 
@@ -394,53 +388,6 @@ const strokeShader: RawShaderMaterial = new RawShaderMaterial({
     transparent: true
 });
 
-// 深度 min-blur（最近深度，忽略背景 1.0）：随描边一起把深度图向外扩，
-// 外扩区 selD = 物体最近深度(<1.0) 而非清屏 1.0，depthTest 在外扩区才能正确判遮挡（不漏光），
-// 同时本体区仍靠 depthTestShader 的 EPSILON 容差防自遮挡闪烁（无缝）。separable（direction 控制 H/V）。
-const depthMinBlurShader: ShaderMaterial = 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 filterSelectShader: RawShaderMaterial = new RawShaderMaterial({
     uniforms: {
         selectTexture: { value: null },
@@ -536,9 +483,6 @@ export default function stroke_pass(
     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（灰度）。⭐ 本体深度由同一趟光栅化顺带写进 selectDepthTexture
     //   （挂在 selectTextureTarget 的 depth attachment 上）—— 原先这里还有第 2 趟「只渲深度」，
@@ -563,7 +507,8 @@ export default function stroke_pass(
     depthTestShader.uniforms.uDebugVis.value = ((window as unknown as { __STROKE_DEPTH_VIS?: boolean }).__STROKE_DEPTH_VIS) ? 1.0 : 0.0;
     fsQuad.render(renderer, depthTestShader);
 
-    // 4. 从「深度测试后的本体描边」开始外扩（外扩环自动继承本体遮挡判定 → 不漏光），
+    // 4. 从「深度测试后的本体描边」开始外扩（外扩的源头是本体判过的结果，被挡掉的本体不会再长出描边；
+    //    但外扩出来那圈像素本身不再判深度 ⇒ 贴着遮挡物时会压到遮挡物前面，见步骤 6 的代价点名），
     //    描边粗细由 stroke_width 控制的迭代次数决定。
     strokeShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
     FXAAShaderMaterial.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
@@ -590,45 +535,14 @@ export default function stroke_pass(
     FXAAShaderMaterial.uniforms.tDiffuse.value = blur2TextureTarget.texture;
     fsQuad.render(renderer, FXAAShaderMaterial);
 
-    // 5.5 ⭐ 外扩环深度测试（补齐此前只定义未调用的死代码）：
-    //   本体深度随描边一起外扩（separable H/V，外扩区取邻域最近深度），
-    //   再用它对外扩后的描边做一次 depthTest。
-    //   缺了这一步，外扩环（描边的视觉主体）永远不参与遮挡判定 →
-    //   物体被挡住时描边依旧从遮挡物前方漏出来（"深度测试看起来失效"的真根因之一）。
-    depthMinBlurShader.uniforms.resolution.value.set(1 / size.x, 1 / size.y);
-    depthMinBlurShader.uniforms.radius.value = Math.max(1, stroke_width);
-    // H：直接采 DepthTexture（selectDepthTexture），其 .r 即对数深度
-    depthMinBlurShader.uniforms.direction.value.set(1, 0);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthTexture;
-    renderer.setRenderTarget(selectDepthBlurTmpTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-    // V
-    depthMinBlurShader.uniforms.direction.value.set(0, 1);
-    depthMinBlurShader.uniforms.tDepth.value = selectDepthBlurTmpTextureTarget.texture;
-    renderer.setRenderTarget(selectDepthBlurTextureTarget);
-    fsQuad.render(renderer, depthMinBlurShader);
-
-    // 调试：记录「外扩后的选区深度」，供面板「深度图（分步）」的步骤 5.5 档读取。
-    // 它是 RGBA8 目标、对数深度存在 .r 里（与 DepthTexture 取 .r 的读法一致）。
-    debugDepthState.lastSelectBlurDepth = selectDepthBlurTextureTarget.texture;
-
-    // 5.6 对外扩后的描边判遮挡：被更近几何挡住的外扩环像素 discard。
-    //     ⚠️ 输出到独立 target，绝不回写 blur1（历史回归 bug：blur1 被 depthTest 结果覆盖
-    //        会导致步骤 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 as PerspectiveCamera).far;
-    depthTestShader.uniforms.uDebugVis.value = 0.0;
-    fsQuad.render(renderer, depthTestShader);
-
-    // 6. 合成：最终外扩描边(blurDepthTest，已判遮挡) 减去 深度测试后的本体描边
-    //    = 仅保留描边外扩环；本体被减掉。filterSelectShader 用 NormalBlending 叠到场景上。
+    // 6. 合成：FXAA 后的外扩描边(blur1) 减去 深度测试后的本体 = 仅保留描边外扩环；本体被减掉。
+    //    ⚠️ 2026-11-04 决定回到「年初口径」：原先这里有 5.5（本体深度随描边一起 separable min-blur 外扩）
+    //    与 5.6（用外扩后的深度再判一次遮挡）两趟，作用是外扩环也参与遮挡判定 ⇒ 物体被挡住时描边不漏光。
+    //    撤掉换来的是每个描边对象每帧全屏绘制 10 趟降 7 趟（min-blur 那两趟是 ±10 共 21 次采样/像素，最贵）；
+    //    代价点名：只有本体参与判遮挡，外扩环不参与 ⇒ 物体贴着遮挡物边缘时，一圈描边会压在遮挡物前面。
     renderer.setRenderTarget(originRenderTarget);
     filterSelectShader.uniforms.selectTexture.value = selectDepthTestTextureTarget.texture;
-    filterSelectShader.uniforms.blurTexture.value = blurDepthTestTextureTarget.texture;
+    filterSelectShader.uniforms.blurTexture.value = blur1TextureTarget.texture;
     filterSelectShader.blending = NormalBlending;
     fsQuad.render(renderer, filterSelectShader);
 }