From 7ab8bac5063d0967758e915ff82735e342883342 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=81=AB=E7=84=B0=E5=BA=93=E6=8B=89?= <820449643@qq.com>
Date: Thu, 26 Feb 2026 10:26:17 +0800
Subject: [PATCH] =?UTF-8?q?fix(scene-script):=20=E6=8B=A6=E6=88=AA?=
 =?UTF-8?q?=E5=AF=B9=E7=BB=84=E4=BB=B6=E6=A0=B8=E5=BF=83=E5=B1=9E=E6=80=A7?=
 =?UTF-8?q?(node=E7=AD=89)=E7=9A=84=E4=BF=AE=E6=94=B9=EF=BC=8C=E9=98=B2?=
 =?UTF-8?q?=E6=AD=A2=E7=BC=96=E8=BE=91=E5=99=A8=E5=8D=A1=E6=AD=BB=E5=B4=A9?=
 =?UTF-8?q?=E6=BA=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 UPDATE_LOG.md   | 9 +++++++++
 scene-script.js | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/UPDATE_LOG.md b/UPDATE_LOG.md
index c5cf915..3eca84d 100644
--- a/UPDATE_LOG.md
+++ b/UPDATE_LOG.md
@@ -193,3 +193,12 @@
     1. **直接拦截节点**: 当检测到传入 `cc.Node` 或 `Node` 作为组件类型时直接驳回，并返回富含指导意义的中文提示词（如“请使用 create-node 创建节点”）。
     2. **继承链校验**: 提取引擎类定义后，强制要求通过 `cc.js.isChildClassOf` 判断该类必须继承自 `cc.Component`。若不合法则即时截断并提示。
 - **价值**: 通过将冰冷的底层异常翻译为“手把手教 AI 怎么重试”的指导性异常，彻底根治了 AI 在操作组件时乱认对象、反复撞墙的通病。
+
+---
+
+## 防止核心属性被篡改崩溃 (2026-02-26)
+
+### 1. `manage_components` 核心属性保护
+
+- **问题**: AI 助手在使用 `manage_components` 尝试修改 `Label` 位置时，错误地对组件传参 `{ node: { position: ... } }`，导致 Label 的 `this.node` 强引用被覆写为普通对象。引发渲染报错 (`Cannot read property 'a' of undefined`) 和删除卡死 (`this.node._removeComponent is not a function`)。
+- **修复**: 在 `scene-script.js` 的 `applyProperties` 中增加了核心属性黑名单机制。强制拦截对 `node`, `uuid`, `_id` 的直接写入并给出警告。彻底杜绝由于组件的节点引用被破坏所引发的场景崩溃和编辑器卡死问题。
diff --git a/scene-script.js b/scene-script.js
index 1f54b86..67e3356 100644
--- a/scene-script.js
+++ b/scene-script.js
@@ -341,6 +341,15 @@ module.exports = {
 			const compClass = component.constructor;
 
 			for (const [key, value] of Object.entries(props)) {
+				// 【防呆设计】拦截对核心只读属性的非法重写
+				// 如果直接修改组件的 node 属性，会导致该引用丢失变成普通对象，进而引发编辑器卡死
+				if (key === "node" || key === "uuid" || key === "_id") {
+					Editor.warn(
+						`[scene-script] 拒绝覆盖组件的只读/核心属性: ${key}。请勿对组件执行此操作，修改位置/激活状态等请操作 Node 节点！`,
+					);
+					continue;
+				}
+
 				// 【核心修复】专门处理各类事件属性 (ClickEvents, ScrollEvents 等)
 				const isEventProp =
 					Array.isArray(value) && (key.toLowerCase().endsWith("events") || key === "clickEvents");