fix: 统一初始化时序，修复卡顿及记忆加载，新增 autoload 校验

- 新增 setting_ready 信号替代各处 await/while 轮询，面板统一等待 manager 就绪
- 修复初始化阶段 while 轮询和信号递归导致的编辑器卡顿
- 修复记忆面板首次无内容（删除无意义 await physics_frame）
- set_singleton 新增 class_name 冲突检测和 extends Node 校验
- 更新 help 及官网链接

Author: 925236118

.gitignore

@@ -3,4 +3,4 @@
 /android/
 .trae/rules
 .vscode/
-test/
+test/.reasonix/

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.5.0] - 2026-06-05
+## [0.5.0] - 2026-06-15
 
 ### ✨ New Features (新增功能)
 - **供应商与模型**:
@@ -25,14 +25,21 @@ All notable changes to this project will be documented in this file.
 - **性能优化**:
   - 设置页、技能页、记忆页改为首次可见时才初始化，减少插件启动时的加载压力。
   - message_item._process 改为按需启停，空闲时不再每帧运行。
+- **Tools**:
+  - set_singleton 新增 class_name 冲突检测和 extends Node 校验。
 
 ### 🐛 Bug Fixes (问题修复)
+- 修复插件加载后编辑器持续卡顿（消除 while 轮询和信号递归死循环）。
+- 修复模型开关触发 signal → update_model_selector 递归死循环导致卡死。
+- 修复记忆面板首次切换无内容。
+- 修复插件重新启用时 setting_ready 标志残留导致面板跳过初始化。
 - 修复 CheckScriptError 工具在脚本含有 `class_name` 定义时静态检查始终失败的问题。([#9](https://github.com/925236118/AlphaAgent/pull/9))
 - 优化标题生成逻辑和思考内容展示。
 - 修复 Anthropic 兼容 API 适配问题。
 - 限制输入框最大高度，防止内容过多撑破 UI 布局。
 
 ### 🔧 Improvements (优化改进)
+- 统一初始化时序：新增 setting_ready 信号，所有面板通过信号等待 manager 就绪。
 - 修改代码文件层级，优化项目结构。
 - 清理 OpenAI 聊天包装器中耦合的 DeepSeek 特殊处理逻辑。
 

addons/agent/agent.gd

@@ -14,6 +14,9 @@ func _disable_plugin() -> void:
 	pass
 
 func _enter_tree() -> void:
+	# 每次启用插件时复位就绪标志，确保面板通过信号等待新的 load_global_setting 完成
+	global_setting.setting_is_ready = false
+
 	print_greetings()
 
 	# 初始化临时文件管理器
@@ -33,7 +36,7 @@ func _enter_tree() -> void:
 	# 所有初始化完成后打印结束语
 	print_alpha_message("==$==*----*===*----*===*----*==$==")
 	print_alpha_message("初始化结束，欢迎使用 [b]Alpha[/b]，始于初心，无限可能。")
-	print_alpha_message("更多详细信息请查看：[url href='https://godotvillage.github.io/alpha/']Alpha 官方网站[/url]")
+	print_alpha_message("更多详细信息请查看：[url href='https://godotvillage.com/#/project/8665befd-9b55-46dd-9126-5d9bffdbc006']Alpha 官方网站[/url]")
 
 
 func _exit_tree() -> void:
@@ -69,6 +72,9 @@ enum SendShotcut {
 }
 
 class GlobalSetting:
+	signal setting_ready
+	var setting_is_ready: bool = false
+
 	var setting_dir = ""
 
 	var setting_file: String = ""
@@ -139,6 +145,9 @@ class GlobalSetting:
 		# 初始化技能管理器
 		skill_manager = AgentSkillConfig.SkillManager.new(skill_directory)
 
+		setting_is_ready = true
+		setting_ready.emit()
+
 	func save_global_setting():
 		var dict = {
 			"auto_clear": self.auto_clear,

addons/agent/tools/tools_nodes/set_singleton_tool.gd

@@ -2,6 +2,45 @@
 class_name SetSingletonTool
 extends AgentToolBase
 
+## 获取脚本的 class_name。先查 ProjectSettings 已注册全局类，未注册则解析文件。
+func _get_script_class_name(path: String) -> String:
+	if not path.ends_with(".gd"):
+		return ""
+
+	# 优先查 ProjectSettings：Godot 已解析过的脚本这里最准最快
+	var class_list: Array = ProjectSettings.get_global_class_list()
+	for entry in class_list:
+		if entry.path == path:
+			return entry.get("class", "")
+
+	# 未注册则读文件解析 class_name 行
+	var file = FileAccess.open(path, FileAccess.READ)
+	if file == null:
+		return ""
+	var text = file.get_as_string()
+	for line in text.split("\n"):
+		var s = line.strip_edges()
+		if s.is_empty() or s.begins_with("#"):
+			continue
+		if s.begins_with("class_name "):
+			return s.substr(11).strip_edges().split(" ")[0]  # 取 extends 前的部分
+	return ""
+
+## 检查脚本是否继承自 Node（autoload 必要条件）
+func _script_extends_node(path: String) -> bool:
+	if not path.ends_with(".gd"):
+		return true  # .tscn 场景必然是 Node
+
+	var script = load(path)
+	if not script is GDScript:
+		return false
+
+	var base: StringName = script.get_instance_base_type()
+	if base.is_empty() or not ClassDB.class_exists(base):
+		return false
+
+	return ClassDB.is_parent_class(base, "Node")
+
 func _get_tool_name() -> String:
 	return "set_singleton"
 
@@ -39,6 +78,11 @@ func do_action(tool_call: AgentModelUtils.ToolCallsInfo) -> Dictionary:
 		var singleton_name = json.name
 		var singleton_path = json.get("path", "")
 		if singleton_path:
+			var script_class := _get_script_class_name(singleton_path)
+			if script_class != "" and script_class == singleton_name:
+				return {"error": "自动加载名 '%s' 与脚本 class_name '%s' 冲突，不可挂载。请使用不同的自动加载名称。" % [singleton_name, script_class]}
+			if not _script_extends_node(singleton_path):
+				return {"error": "脚本 '%s' 不继承自 Node，无法设为自动加载。" % singleton_path}
 			var singleton = AlphaAgentSingleton.get_instance()
 			singleton.add_autoload_singleton(singleton_name, singleton_path)
 			return {

addons/agent/ui/chat/input_container.gd

@@ -137,7 +137,9 @@ func update_model_selector(suppliers: Array, current_model_id: String, current_m
 		# 设置当前选中的模型
 		if not model_id_list.has(current_idx):
 			current_idx = first_model_idx
+		model_button.set_block_signals(true)
 		model_button.selected = current_idx
+		model_button.set_block_signals(false)
 		if current_idx != -1:
 			_on_model_selected(current_idx)
 

addons/agent/ui/help/help.tscn

@@ -45,10 +45,9 @@ vertical_alignment = 1
 [node name="TabContainer" type="TabContainer" parent="MarginContainer/VBoxContainer"]
 layout_mode = 2
 size_flags_vertical = 3
-current_tab = 4
+current_tab = 0
 
 [node name="设计哲学" type="ScrollContainer" parent="MarginContainer/VBoxContainer/TabContainer"]
-visible = false
 layout_mode = 2
 size_flags_vertical = 3
 metadata/_tab_index = 0
@@ -218,6 +217,7 @@ text = "Alpha有可以记录用户输入的记忆的功能。
 fit_content = true
 
 [node name="关于" type="ScrollContainer" parent="MarginContainer/VBoxContainer/TabContainer"]
+visible = false
 layout_mode = 2
 size_flags_vertical = 3
 metadata/_tab_index = 4
@@ -259,5 +259,7 @@ Jaxson（1253318213）
 PR贡献者：
 [ul]
 TonyZhao（https://github.com/tonyzhao-jt）
+Smalldy（https://github.com/Smalldy）
+TsubakiLoL（https://github.com/TsubakiLoL）
 [/ul]"
 fit_content = true

addons/agent/ui/main_panel.gd

@@ -86,11 +86,11 @@ func _ready() -> void:
 	welcome_message.show()
 	message_container.hide()
 
-	# 初始化模型选择
-	_init_model_selector()
-
-	# 初始化角色选择
-	_init_role_selector()
+	# 初始化模型选择和角色选择（等待 setting_ready）
+	if AlphaAgentPlugin.global_setting.setting_is_ready:
+		_on_setting_ready()
+	else:
+		AlphaAgentPlugin.global_setting.setting_ready.connect(_on_setting_ready, CONNECT_ONE_SHOT)
 	_bind_message_scroll_events()
 
 	back_chat_button.pressed.connect(on_click_back_chat_button)
@@ -119,9 +119,12 @@ func _connect_plugin_signals():
 	singleton.models_changed.connect(_on_models_changed)
 	singleton.roles_changed.connect(_on_roles_changed)
 
+func _on_setting_ready():
+	_init_model_selector()
+	_init_role_selector()
+
 # 初始化模型选择器
 func _init_model_selector():
-	await AlphaAgentPlugin.wait_for_scene_tree_frame()
 	var model_manager = AlphaAgentPlugin.global_setting.model_manager
 	if model_manager == null:
 		return
@@ -137,7 +140,6 @@ func _init_model_selector():
 	)
 
 func _init_role_selector():
-	await AlphaAgentPlugin.wait_for_scene_tree_frame()
 	var role_manager = AlphaAgentPlugin.global_setting.role_manager
 	if role_manager == null:
 		return
@@ -154,6 +156,10 @@ func _on_model_selected(supplier_id: String, model_id: String):
 	if model_manager == null:
 		return
 
+	# 模型未变则跳过，打断 signal → update_model_selector → _on_model_selected 递归链
+	if model_manager.current_supplier_id == supplier_id and model_manager.current_model_id == model_id:
+		return
+
 	model_manager.set_current_model(supplier_id, model_id)
 
 	# 更新输入容器的模型选择器显示
@@ -166,6 +172,7 @@ func _on_models_changed():
 func _on_roles_changed():
 	_init_role_selector()
 
+
 func reset_message_info():
 	current_message_item = null
 	current_think = ""

addons/agent/ui/main_panel.tscn

@@ -427,7 +427,7 @@ size_flags_vertical = 4
 tooltip_text = "打开Alpha官网"
 text = "Alpha官网"
 underline = 1
-uri = "https://godotvillage.github.io/alpha/"
+uri = "https://godotvillage.com/#/project/8665befd-9b55-46dd-9126-5d9bffdbc006"
 
 [node name="Tools" parent="." instance=ExtResource("3_2usmi")]
 

addons/agent/ui/memory/memory_container.gd

@@ -13,27 +13,41 @@ extends VBoxContainer
 const MEMORY_ITEM = preload("uid://cr2sav6by4tal")
 const CONFIG = preload("uid://b4bcww0bmnxt0")
 
-var _initialized: bool = false
+var _did_load: bool = false
+var _setting_ready_connected: bool = false
 func _ready() -> void:
 	visibility_changed.connect(on_visibility_changed)
 	add_global_memory.pressed.connect(on_add_global_memory)
 	add_project_memory.pressed.connect(on_add_project_memory)
 
+	# 等待 setting_ready 后再加载和渲染记忆
+	if not _setting_ready_connected:
+		_setting_ready_connected = true
+		AlphaAgentPlugin.global_setting.setting_ready.connect(_on_setting_ready, CONNECT_ONE_SHOT)
+
+func _on_setting_ready():
+	if visible:
+		_try_render()
+
+func _try_render():
+	if not AlphaAgentPlugin.global_setting.setting_is_ready:
+		return
+	if not _did_load:
+		_did_load = true
+		load_from_project()
+		load_from_global()
+	clear_memory_nodes()
+	add_memory_nodes()
+
 func on_visibility_changed():
 	if visible:
-		if not _initialized:
-			_initialized = true
-			load_from_project()
-		clear_memory_nodes()
-		add_memory_nodes()
+		_try_render()
 	else:
 		clear_memory_nodes()
 
 func load_from_project():
 	var CONFIG := load("uid://b4bcww0bmnxt0") as AgentConfig
-	var memory = CONFIG.memory
-	await get_tree().physics_frame
-	AlphaAgentPlugin.project_memory = memory
+	AlphaAgentPlugin.project_memory = CONFIG.memory
 
 func load_from_global():
 	var memory_string = FileAccess.get_file_as_string(global_memory_file)
@@ -44,8 +58,7 @@ func load_from_global():
 	if memory_string != "":
 		json = JSON.parse_string(memory_string)
 
-	await get_tree().physics_frame
-	AlphaAgentPlugin.global_memory = json as Array[String]
+	AlphaAgentPlugin.global_memory.assign(json)
 
 func add_memory_nodes():
 	for i in AlphaAgentPlugin.global_memory.size():

addons/agent/ui/models/setting_model_item.gd

@@ -27,7 +27,9 @@ func set_setting_model_info(model: ModelConfig.ModelInfo):
 	model_id.text = model_info.model_name
 	support_reasoner.visible = model_info.supports_thinking
 	support_tool.visible = model_info.supports_tools
+	is_active.set_block_signals(true)
 	is_active.button_pressed = model_info.active
+	is_active.set_block_signals(false)
 
 func on_toggled_is_active_button(toggled_on: bool):
 	model_info.active = toggled_on