From bc68a9e88439efc92d17a685cc2537146db522ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Thu, 24 Sep 2026 17:28:02 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9F=A5=E7=9C=8B=E5=99=A8=E6=9C=AA=E7=9F=A5?=
 =?UTF-8?q?=E5=A4=B1=E8=B4=A5=E5=8E=9F=E5=9B=A0=E9=80=80=E5=9B=9E=E5=85=9C?=
 =?UTF-8?q?=E5=BA=95=E6=96=87=E6=A1=88?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- src/components/image-editor/model3d-preview/Model3dViewerModel.ts：default 分支保留 `never` 的编译期穷尽检查，但运行时（宿主与查看器版本错配）改回 fallbackText，不再把原始原因码当用户文案显示
---
 .../image-editor/model3d-preview/Model3dViewerModel.ts       | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/components/image-editor/model3d-preview/Model3dViewerModel.ts b/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
index e4f9516eb..e2595ee9d 100644
--- a/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
+++ b/src/components/image-editor/model3d-preview/Model3dViewerModel.ts
@@ -65,8 +65,11 @@ export function resolveModel3dViewerFailureText(
       return '当前环境不支持 WebGL2，无法预览模型。';
     default: {
       // 查看器新增失败原因时这里会编译报错，不会静默退化成通用文案。
+      // 编译不过就补分支；真到运行时（宿主与查看器版本错配）仍然退回兜底文案，
+      // 不把 `decode-failed` 这类内部原因码直接显示给用户。
       const unhandledReason: never = reason;
-      return unhandledReason;
+      void unhandledReason;
+      return fallbackText;
     }
   }
 }