diff --git "a/Books/3-5-2-UI-Toolkit-AssetBundle-\347\203\255\346\233\264\346\226\260\347\240\224\347\251\266-2026-06-11.md" "b/Books/3-5-2-UI-Toolkit-AssetBundle-\347\203\255\346\233\264\346\226\260\347\240\224\347\251\266-2026-06-11.md"
new file mode 100644
index 0000000000..31be2a488b
--- /dev/null
+++ "b/Books/3-5-2-UI-Toolkit-AssetBundle-\347\203\255\346\233\264\346\226\260\347\240\224\347\251\266-2026-06-11.md"
@@ -0,0 +1,207 @@
+# TEngine UI Toolkit + AssetBundle / YooAsset 热更新研究报告
+
+**日期**: 2026-06-11  
+**研究目标**: Unity UI Toolkit (UXML/USS) 从 AssetBundle/YooAsset 运行时加载的可行性、限制、性能与设计建议（服务于 HybridCLR + YooAsset 热更新移动游戏）。  
+**来源**: Unity 官方文档 (Unity 6 / 6000.x)、论坛讨论、GitHub 真实代码示例、Addressables/YooAsset 集成模式。
+
+## 1. 可行性结论
+
+**完全可行**。UI Toolkit 的 `VisualTreeAsset` (UXML) 和 `StyleSheet` (USS) 是普通 Unity 资产，可通过 AssetBundle、Addressables 或 YooAsset 正常加载和运行时使用。
+
+- 官方推荐路径：**Addressables**（Unity 文档明确提供完整示例）。
+- TEngine 实际路径：**YooAsset**（与 Addressables 底层同为 AssetBundle + 清单机制），将 UXML/USS 作为普通资产打进资源包即可。
+- 无版本硬性阻断：Unity 2021.3+（TEngine 最低要求）至 Unity 6 均支持。不能在运行时从原始文本动态生成 VisualTreeAsset（Importer 是 Editor-only），但预构建的资产加载完全没问题。
+
+**核心证据**：
+- Unity 官方文档《Load UI assets with Addressables》：https://docs.unity3d.com/6000.6/Documentation/Manual/ui-systems/load-ui-assets-with-addressables.html （提供 MonoBehaviour + PanelRenderer 完整异步加载 + 应用代码）。
+- Unity 官方文档《Load UXML and USS in C# scripts》：https://docs.unity3d.com/6000.6/Documentation/Manual/UIE-manage-asset-reference.html （明确列出 Addressables、序列化引用、Resources 三种运行时加载方式）。
+- 性能最佳实践文档强调：“Use Asset Bundles or Addressables: When possible, only load the UI documents and style sheets required... Unload assets when not needed”。
+
+## 2. 加载 VisualTreeAsset (UXML) 和 StyleSheet (USS) 的标准模式
+
+### 2.1 Addressables 官方推荐模式（可直接映射到 YooAsset）
+
+```csharp
+// 伪代码，Addressables 示例（YooAsset 几乎等价）
+private AsyncOperationHandle<VisualTreeAsset> uxmlHandle;
+private AsyncOperationHandle<StyleSheet> ussHandle;
+private VisualTreeAsset loadedUxml;
+private StyleSheet loadedUss;
+
+void LoadUI()
+{
+    uxmlHandle = Addressables.LoadAssetAsync<VisualTreeAsset>("uxmlexample"); // 或自定义 key
+    uxmlHandle.Completed += OnUxmlLoaded;
+
+    ussHandle = Addressables.LoadAssetAsync<StyleSheet>(ussAssetReference);
+    ussHandle.Completed += OnUssLoaded;
+}
+
+void OnUxmlLoaded(AsyncOperationHandle<VisualTreeAsset> handle)
+{
+    if (handle.Status == AsyncOperationStatus.Succeeded)
+    {
+        loadedUxml = handle.Result;
+        // 方式A：赋值给 PanelRenderer / UIDocument
+        panelRenderer.visualTreeAsset = loadedUxml;
+        // 方式B：手动 CloneTree
+        // loadedUxml.CloneTree(rootVisualElement);
+    }
+}
+
+void OnUssLoaded(AsyncOperationHandle<StyleSheet> handle)
+{
+    if (handle.Status == AsyncOperationStatus.Succeeded)
+    {
+        loadedUss = handle.Result;
+        // 必须检查重复添加（reload 回调常见问题）
+        if (!rootElement.styleSheets.Contains(loadedUss))
+            rootElement.styleSheets.Add(loadedUss);
+    }
+}
+
+void Unload()
+{
+    if (uxmlHandle.IsValid()) Addressables.Release(uxmlHandle);
+    if (ussHandle.IsValid()) Addressables.Release(ussHandle);
+}
+```
+
+**YooAsset 映射**（TEngine 实际使用）：
+- 使用 `YooAssets.GetPackage(packageName).LoadAssetAsync<VisualTreeAsset>(location)`。
+- `handle.AssetObject as VisualTreeAsset` 或泛型结果。
+- 释放使用 `handle.Release()` 或框架上层 `GameModule.Resource.UnloadAsset` / `AssetsReference` 机制。
+- 与 TEngine 现有 `IUIResourceLoader` + `UIResourceLoader` 集成点：新增 `LoadVisualTreeAssetAsync` / `LoadStyleSheetAsync`。
+
+### 2.2 CloneTree() / Instantiate() 运行时用法
+
+- `VisualTreeAsset.CloneTree(VisualElement target)` —— 最常用，把树克隆到已有根节点。
+- `VisualTreeAsset.Instantiate()` —— 返回新的 `TemplateContainer` 根。
+- 两者在运行时加载的 VisualTreeAsset 上**完全可用**，无特殊限制。
+- 新版还支持带 `VisualElementAssetReferenceTable` 的重载，用于按 AuthoringId 事后查找元素。
+
+性能提示（来自官方最佳实践）：
+- CloneTree 本身成本不高，**主要成本在它引用的纹理/字体等资产被拉入内存** + 后续布局/样式解析。
+- 大型 UXML 建议拆成多个小模板，按需动态加载。
+- 列表类 UI 必须用 `ListView` 虚拟化，不要为每个条目都 CloneTree。
+
+## 3. PanelSettings 管理
+
+- `PanelSettings` 是 **ScriptableObject 资产**，可以像普通资产一样打进 AB / 放到 YooAsset 组 / 标记 Addressable，然后运行时加载。
+- 它是 UIDocument / PanelRenderer 的渲染配置载体（缩放模式、排序、主题等）。
+- 多个 UIDocument 可共享同一个 PanelSettings 以优化性能。
+- **重要限制/坑**（论坛实测）：
+  - 纯运行时 `new PanelSettings()` 创建的实例，在构建后可能拿不到默认样式表（因为默认样式表是 Editor 资产，只有通过序列化引用打包进去才会被包含）。
+  - 推荐做法：**在 Editor 里提前创建好 PanelSettings 资产**，配置好 Theme Style Sheet，然后通过资源系统加载该资产实例并赋值。
+  - 热更新主题：可以运行时加载不同的 PanelSettings，或修改已加载 PanelSettings 的 `themeStyleSheet` 引用（需测试具体版本行为）。
+
+## 4. USS 引用解析、@import、Theme 文件的运行时坑
+
+这是最容易踩的区域：
+
+- **@import 链在运行时不可靠**：
+  - UI Builder 和 Editor 里预览正常，构建后或运行时加载后样式丢失/部分生效。
+  - 论坛多帖反馈：“Unreferenced theme file seems to change USS load order”、“How to use Themes (TSS) properly for runtime UI”。
+  - 根因：运行时样式表加载顺序与 Editor 不同，@import 解析依赖 AssetDatabase 行为。
+
+- **推荐的运行时稳妥做法**（社区 + 实测总结）：
+  1. **UXML 里显式声明**：`<Style src="theme.uss" />`、`<Style src="buttons.uss" />`（顺序重要，后面的覆盖前面的）。
+  2. **C# 运行时添加**：`root.styleSheets.Add(loadedStyleSheet);`（务必先 Contains 检查，避免 reload 重复添加）。
+  3. **应用级主题用 TSS + PanelSettings**：在 PanelSettings 的 Theme Style Sheet 槽位挂 TSS，TSS 内部可以用 @import，运行时表现更好。
+  4. 不要完全依赖纯 @import 链来做运行时主题切换。
+
+- 变量（USS variables）和 override 机制本身没问题，关键是**加载顺序**。
+
+## 5. 性能与内存管理
+
+来自官方《Optimizing performance》最佳实践：
+
+- **内存**：加载 UXML/USS 会连带拉入它引用的所有纹理/字体。必须在使用完后 `RemoveFromHierarchy()` + 释放句柄（Addressables.Release / YooAsset 对应释放）。
+- **按需加载**：把大型 UI 拆成模块化小 VisualTreeAsset，按需加载。
+- **动态图集**：UI Toolkit 有 Dynamic Atlas（Panel Settings 可配），配合 2D SpriteAtlas 使用可减少纹理切换导致的 batch break。
+- **Batching & 8 纹理限制**：同一 batch 最多 8 张纹理，超了就断 batch。图集化 + 合理组织元素很重要。
+- **隐藏元素**：
+  - `style.display = DisplayStyle.None`：停止布局和渲染，适合不常出现的面板。
+  - `RemoveFromHierarchy()` + 释放：彻底去掉内存开销，重新显示时成本较高。
+  - `visible = false` 或 `opacity = 0`：仍在布局/渲染管线中，成本较高。
+- **动画**：优先用 `transform`（translate/scale/rotate）+ `usageHints = DynamicTransform / GroupTransform`，避免改 layout 属性触发昂贵重算。
+- **数据绑定**：用 `INotifyBindablePropertyChanged` + `IDataSourceViewHashProvider` 避免无谓更新；编译时代码生成 property bag 比反射好。
+
+**CloneTree 性能实测/建议**：没有发现“CloneTree 本身很慢”的硬伤报告，瓶颈通常在：
+- 引用的重资源（大图、字体）。
+- 极深层级 + 频繁样式/布局变更。
+- 没有虚拟化的长列表。
+
+## 6. HybridCLR + YooAsset + UI Toolkit 热更新特殊考虑
+
+- UI 资产（UXML/USS/纹理/PanelSettings）属于**数据侧**，与 HybridCLR 热更代码完全正交。
+- YooAsset 已经负责 AB 依赖、清单、远程更新、LRU/ARC 缓存，与 TEngine 现有资源模块深度集成。
+- 设计时只需把 UXML/USS 正常打进 YooAsset 资源包（可单独分组，便于小更新）。
+- 加载/释放必须走框架上层 API（`GameModule.Resource` / `IUIResourceLoader`），以便 AssetsReference 自动追踪或 YooAsset 句柄池管理。
+- 异步优先：UI 打开流程已经是 UniTask + 异步，加载 UXML/USS 必须 await，不能阻塞。
+- 事件/生命周期：UI 关闭时必须释放对应 VisualTreeAsset/StyleSheet 句柄，防止内存泄漏（与现有 UIWindow/Widget 销毁流程对齐）。
+
+## 7. TEngine UIToolkit 模块管道设计建议（下游输入）
+
+1. **资源加载层**：
+   - 在 `UIModule` 或新建 `UIToolkitModule` 中扩展 `IUIResourceLoader`，增加：
+     ```csharp
+     UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location);
+     UniTask<StyleSheet> LoadStyleSheetAsync(string location);
+     ```
+   - 内部用 `GameModule.Resource.LoadAssetAsync<T>` 实现，复用现有 YooAsset 封装和释放策略。
+
+2. **UI 文档管理**：
+   - 提供 `UIToolkitWindow` 基类（或扩展现有 `UIWindow`），持有：
+     - `VisualTreeAsset` 句柄
+     - `StyleSheet` 列表
+     - `UIDocument` 或 `PanelRenderer` + `PanelSettings` 引用
+   - 打开流程：`await LoadUxml + LoadUss` → `CloneTree(root)` 或赋值 → `styleSheets.Add`（去重）→ 绑定事件/数据。
+   - 关闭流程：`RemoveFromHierarchy` → 释放句柄 → 走 TEngine 现有资源释放路径。
+
+3. **PanelSettings 策略**：
+   - Editor 预创建 1~N 个 PanelSettings 资产（不同分辨率/主题需求）。
+   - 运行时加载对应 PanelSettings 资产，赋值给 UIDocument。
+   - 支持运行时切换 Theme（加载新 TSS 或新 PanelSettings）。
+
+4. **主题与样式加载策略**（避坑）：
+   - 优先 UXML 内 `<Style src="..."/>` + C# `styleSheets.Add`。
+   - 应用级主题走 PanelSettings.themeStyleSheet + TSS。
+   - 提供工具或规范，禁止在运行时热更的 USS 里使用复杂 @import 链。
+
+5. **内存与性能规范**（写入开发文档）：
+   - 所有 UIToolkit 资产必须通过框架加载器加载，便于追踪释放。
+   - 大 UI 必须模块化拆 UXML。
+   - 动态列表必须用 ListView。
+   - 动画元素加 usageHints。
+   - 关闭 UI 必须释放对应资源（可做自动化检查）。
+
+6. **与现有 UI 模块关系**：
+   - 当前 TEngine UI 模块是基于 UGUI + 纯 C# UIWindow/UIWidget 的成熟商业方案。
+   - UIToolkit 可作为**并行/可选**的第二 UI 技术栈引入（例如新功能、Editor 工具扩展、或逐步迁移）。
+   - 不要破坏现有 UGUI 流程，先做成独立模块或条件编译开关。
+
+## 8. 风险与未决问题（需后续验证）
+
+- PanelSettings 运行时创建 + 默认样式表的构建包含问题（已知，建议永远 Editor 预建资产）。
+- 不同 Unity 版本（2021.3 vs 2022.3 vs 6000.x）TSS/@import 运行时行为的细微差异（建议在目标版本上实测）。
+- 极高频打开/关闭 UI 时的句柄池与释放延迟（YooAsset 已有池化，需确认 UI 资产是否命中良好）。
+- 热更单个 USS 后是否需要刷新已实例化的 VisualElement 样式（通常重新 Add 或重建树可解决，需验证）。
+
+## 9. 参考资料（可直接点击）
+
+- 官方 Addressables 加载 UI 示例：https://docs.unity3d.com/6000.6/Documentation/Manual/ui-systems/load-ui-assets-with-addressables.html
+- 官方 UXML/USS 运行时加载：https://docs.unity3d.com/6000.6/Documentation/Manual/UIE-manage-asset-reference.html
+- 性能优化最佳实践（内存、batch、隐藏策略）：https://docs.unity3d.com/Manual/best-practice-guides/ui-toolkit-for-advanced-unity-developers/optimizing-performance.html
+- 论坛关键帖：Addressables + Custom VisualElement、Theme/TSS 运行时问题、从字符串加载 USS 的限制讨论。
+- YooAsset 文档与 TEngine 资源模块文档（3-1-资源模块.md）。
+
+---
+
+**下一步行动建议**：
+1. 在 TEngine 分支上建一个小 Demo，把一个简单 UXML + USS 打进 YooAsset 包，用现有资源加载器异步加载 + CloneTree + 添加 StyleSheet，验证全流程。
+2. 设计 `UIToolkitResourceLoader` 和基础 `UIToolkitWindow` 骨架（遵循现有 UIWindow 生命周期 + 异步 + 事件）。
+3. 把本报告关键结论写入 `Books/` 或 `.claude/skills/tengine-dev/references/` 新增 `ui-toolkit-hotupdate.md`。
+4. 针对 PanelSettings + Theme 做专项小测试，确认热更新主题的可行路径。
+
+报告完成。可作为 UIToolkit 模块资源管道设计的直接输入。
diff --git a/UnityProject/.claude/skills/tengine-dev/references/uitk-binding.md b/UnityProject/.claude/skills/tengine-dev/references/uitk-binding.md
new file mode 100644
index 0000000000..c61800a739
--- /dev/null
+++ b/UnityProject/.claude/skills/tengine-dev/references/uitk-binding.md
@@ -0,0 +1,143 @@
+# UITKModule 自动绑定
+
+## 机制
+
+Editor 预生成 `.bindgen.cs` 文件，运行时零反射。
+
+**触发方式**：Unity 菜单 `TEngine → UITK → Generate All Bindings`
+
+## Attribute
+
+### [Q] — 元素查询绑定
+
+```csharp
+[Q] Button btnLogin;          // → 查询 name="btn-login"
+[Q] Label lblTitle;           // → 查询 name="lbl-title"
+[Q("explicit-name")] DropdownField serverList;  // → 查询 name="explicit-name"
+```
+
+**命名规则**: camelCase → kebab-case
+```
+btnLogin     → btn-login
+lblPlayerHP  → lbl-player-hp
+inputAccount → input-account
+imgAvatarBg  → img-avatar-bg
+```
+
+### [OnClick] — 点击事件绑定
+
+```csharp
+[OnClick] void OnBtnLogin() { }       // → 绑定 btn-login.clicked
+[OnClick] void OnBtnClose() { }       // → 绑定 btn-close.clicked
+[OnClick("custom-btn")] void HandleClick() { }  // → 显式指定目标
+```
+
+**推导规则**: 去掉 "On" 前缀，剩余部分转 kebab-case
+```
+OnBtnLogin   → btn-login
+OnBtnClose   → btn-close
+```
+
+### [OnChange] — 值变化事件
+
+```csharp
+[OnChange("input-name")]
+void OnNameChanged(ChangeEvent<string> evt) { }
+
+[OnChange("slider-value")]
+void OnSliderChanged(ChangeEvent<float> evt) { }
+```
+
+### [Bind] / [BindCommand] — MVVM 自动绑定
+
+将 UI 控件直接绑定到 ViewModel 的 `BindableProperty<T>` / `BindableCommand`，**无需手动 += / -=**：
+
+```csharp
+[Bind("Gold", format: "{0:N0}")]          Label lblGold;     // OneWay + 格式化
+[Bind("PlayerName", BindingMode.TwoWay)]  TextField inputName; // 双向
+[Bind("Hp", BindingMode.TwoWay, converter: typeof(IntToStringConverter))] TextField inputHp; // 异类型经转换器
+[BindCommand("BuyCommand")]               Button btnBuy;     // 命令 + CanExecute
+
+private ShopViewModel _vm;   // 类内恰一个 ViewModelBase 字段，生成器据此解析
+```
+
+- `[Bind]/[BindCommand]` 字段会被自动查询赋值（隐含 `[Q]`，字段名 → kebab-case），无需再加 `[Q]`。
+- 框架在 `OnCreate` 之后自动绑定、`OnDestroy` 之前自动解绑（同一委托实例，无泄漏）。
+- 详见 [uitk-mvvm.md](uitk-mvvm.md)「自动绑定」。
+
+## 完整示例
+
+```csharp
+[UIWindow(UILayer.UI)]
+public partial class ShopWindow : UITKWindow
+{
+    [Q] Label lblGold;
+    [Q] Label lblTitle;
+    [Q] Button btnBuy;
+    [Q] Button btnClose;
+    [Q] TextField inputSearch;
+
+    [OnClick] void OnBtnBuy()
+    {
+        // 购买逻辑
+    }
+
+    [OnClick] void OnBtnClose()
+    {
+        UITKModule.Instance.CloseUI<ShopWindow>();
+    }
+
+    [OnChange("input-search")]
+    void OnSearchChanged(ChangeEvent<string> evt)
+    {
+        // 搜索过滤
+    }
+
+    protected override void OnCreate()
+    {
+        // [Q] 字段已自动填充，直接使用
+        lblTitle.text = "商店";
+    }
+}
+```
+
+## 生成文件
+
+输入: `ShopWindow.cs` → 输出: `ShopWindow.bindgen.cs`（同目录）
+
+生成内容:
+```csharp
+partial class ShopWindow
+{
+    protected override void __UITKAutoBind(VisualElement root)
+    {
+        lblGold = root.Q<Label>("lbl-gold");
+        lblTitle = root.Q<Label>("lbl-title");
+        btnBuy = root.Q<Button>("btn-buy");
+        btnClose = root.Q<Button>("btn-close");
+        inputSearch = root.Q<TextField>("input-search");
+    }
+
+    protected override void __UITKAutoBindEvents()
+    {
+        btnBuy.clicked += OnBtnBuy;
+        btnClose.clicked += OnBtnClose;
+        inputSearch.RegisterValueChangedCallback(OnSearchChanged);
+    }
+
+    protected override void __UITKAutoUnbindEvents()
+    {
+        btnBuy.clicked -= OnBtnBuy;
+        btnClose.clicked -= OnBtnClose;
+        inputSearch.UnregisterValueChangedCallback(OnSearchChanged);
+    }
+}
+```
+
+## 注意事项
+
+- 类必须声明为 `partial class`
+- 修改 [Q]/[OnClick]/[OnChange] 后需重新 Generate
+- UXML 中对应元素的 `name` 属性必须匹配
+- `.bindgen.cs` 文件不要手动编辑（会被覆盖）
+- 生成的代码参与 HybridCLR 热更新
diff --git a/UnityProject/.claude/skills/tengine-dev/references/uitk-lifecycle.md b/UnityProject/.claude/skills/tengine-dev/references/uitk-lifecycle.md
new file mode 100644
index 0000000000..f7ad29878c
--- /dev/null
+++ b/UnityProject/.claude/skills/tengine-dev/references/uitk-lifecycle.md
@@ -0,0 +1,83 @@
+# UITKModule 生命周期
+
+## UITKWindow 生命周期
+
+```
+ShowUIAsync<T>()
+  → InternalLoad()          加载 UXML (YooAsset/Resources)
+  → CloneTree()             实例化 VisualElement
+  → 挂载到对应层 Panel
+  → InternalCreate() [仅首次]
+      → __UITKAutoBind()        ← 自动填充 [Q]/[Bind]/[BindCommand] 字段（框架调用）
+      → __UITKAutoBindEvents()  ← 自动注册 [OnClick]/[OnChange]（框架调用）
+      → Inject()                ← DI 注入
+      → OnCreate()              ← 用户代码（在此构造 ViewModel）
+      → RegisterEvent()         ← 用户注册 GameEvent
+      → __UITKAutoBindMVVM()    ← 自动绑定 [Bind]/[BindCommand]（框架调用，OnCreate 后 VM 已就绪）
+  → InternalRefresh()
+      → OnRefresh()             ← 每次 Show 都执行
+  → OnSetWindowVisible()        ← 全屏遮挡处理
+  → OnShowAnimation()           ← 显示动画
+```
+
+## 关闭流程
+
+```
+CloseUI<T>()
+  → __UITKAutoUnbindMVVM()       ← 自动解绑 [Bind]/[BindCommand]（VM 仍存活时，框架调用）
+  → OnDestroy()                  ← 用户代码（在此 Dispose ViewModel）
+  → __UITKAutoUnbindEvents()     ← 自动解绑（框架调用）
+  → RemoveAllUIEvent()           ← GameEvent 自动清理
+  → 递归销毁子 Widget
+  → RemoveFromHierarchy()
+  → Unload(visualTreeAsset)      ← 释放资源
+```
+
+> 销毁幂等：`InternalDestroy` 重复调用安全（动画关闭期间不会二次销毁）；
+> 加载未完成即关闭时跳过用户回调，避免对未初始化窗口跑代码导致 NPE。
+> 资源加载失败时窗口自动弹栈回滚（不会卡在栈中），并打 Log.Error。
+
+## 隐藏流程
+
+```
+HideUI<T>()
+  → HideTimeToClose <= 0 → 直接 CloseUI
+  → Visible = false (display:none)
+  → IsHide = true
+  → Timer → 到期自动 CloseUI
+```
+
+## UITKWidget 生命周期
+
+```
+CreateWidgetAsync<T>(parentElement)
+  → LoadVisualTreeAssetAsync()
+  → CloneTree() → parentElement.Add()
+  → __UITKAutoBind + __UITKAutoBindEvents
+  → Inject() → OnCreate() → RegisterEvent() → OnRefresh()
+
+Destroy()
+  → OnDestroy()
+  → __UITKAutoUnbindEvents()
+  → RemoveAllUIEvent()
+  → 递归销毁子 Widget
+  → RemoveFromHierarchy() + Unload
+```
+
+## 关键回调
+
+| 回调 | 时机 | 频率 |
+|------|------|------|
+| OnCreate() | 首次创建完成 | 1 次 |
+| OnRefresh() | 每次 Show/重新显示 | 多次 |
+| OnUpdate() | 每帧（仅 Visible 时） | 每帧 |
+| OnDestroy() | 关闭销毁 | 1 次 |
+| OnSetVisible(bool) | 可见性变化（全屏遮挡等） | 多次 |
+| RegisterEvent() | OnCreate 后注册 GameEvent | 1 次 |
+
+## 注意事项
+
+- `OnCreate` 中 `[Q]` 字段已被自动填充，可直接使用
+- 事件绑定/解绑由框架自动管理，`OnDestroy` 中不需要手动处理
+- `OnRefresh` 用于每次显示时刷新数据（如从其他页面返回）
+- 不要在构造函数中操作 UI，等 `OnCreate` 才有 RootElement
diff --git a/UnityProject/.claude/skills/tengine-dev/references/uitk-module-design.md b/UnityProject/.claude/skills/tengine-dev/references/uitk-module-design.md
new file mode 100644
index 0000000000..90f558bf7d
--- /dev/null
+++ b/UnityProject/.claude/skills/tengine-dev/references/uitk-module-design.md
@@ -0,0 +1,75 @@
+# UITKModule 概览
+
+> UIToolkit UI 框架模块，与现有 UIModule (UGUI) 并行共存。
+
+## 访问方式
+
+```csharp
+GameModule.UITK.ShowUIAsync<T>(userDatas);   // 异步打开
+GameModule.UITK.ShowUI<T>(userDatas);        // 同步打开
+GameModule.UITK.CloseUI<T>();                // 关闭
+GameModule.UITK.HideUI<T>();                 // 隐藏（定时关闭）
+GameModule.UITK.CloseUIWithAnimation<T>();   // 带动画关闭
+GameModule.UITK.HasWindow<T>();              // 是否存在
+GameModule.UITK.GetUI<T>();                  // 获取实例
+```
+
+## 分层 Panel 架构
+
+| 层级 | UILayer 枚举 | sortingOrder | 用途 |
+|------|-------------|-------------|------|
+| Bottom | 0 | 0 | 背景层 |
+| UI | 1 | 2000 | 主要 UI |
+| Top | 2 | 4000 | 浮动 UI |
+| Tips | 3 | 6000 | 提示弹窗 |
+| System | 4 | 8000 | 系统级（确认框等）|
+
+- 同层内窗口深度靠 VisualElement 子节点顺序
+- 可见性用 `style.display = none/flex`
+- 全屏窗口 (`FullScreen = true`) 会遮挡同层及下层窗口
+
+## 窗口声明
+
+```csharp
+[UIWindow(UILayer.UI)]                          // 基本
+[UIWindow(UILayer.UI, FullScreen = true)]       // 全屏
+[UIWindow(UILayer.Tips)]                        // Tips 层
+[UIWindow(UILayer.UI, Location = "path")]       // 指定资源路径
+[UIWindow(UILayer.UI, Package = "UITK_Bag")]    // 指定 AB 包名
+[UIWindow(UILayer.UI, FromResources = true)]    // 从 Resources 加载
+[UIWindow(UILayer.UI, HideTimeToClose = 5)]     // 隐藏后 5 秒自动关闭
+```
+
+## 资源加载
+
+- YooAsset `AddressByFileName` 规则：文件名即 Address
+- 不指定 Location → 类名作为 Address（如 `LoginWindow` → 找 `LoginWindow.uxml`）
+- 资源目录：`Assets/AssetRaw/UITK/` 按业务模块划分子目录
+- Window 关闭时自动释放 UXML 资产
+
+## 音效
+
+```csharp
+// 初始化
+GameModule.UITK.ClickSoundHandler = new GameClickSoundHandler();
+
+// 静音按钮
+// UXML 中加 class="no-sound"
+```
+
+## 动画
+
+```csharp
+// Window 中配置
+protected override UITKAnimationType ShowAnimation => UITKAnimationType.ScaleIn;
+protected override UITKAnimationType HideAnimation => UITKAnimationType.FadeOut;
+protected override int AnimationDuration => 300;
+
+// 预设：None, FadeIn, FadeOut, SlideFromBottom, SlideToBottom, SlideFromRight, SlideToRight, ScaleIn, ScaleOut
+```
+
+## 模块文件位置
+
+```
+Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/
+```
diff --git a/UnityProject/.claude/skills/tengine-dev/references/uitk-mvvm.md b/UnityProject/.claude/skills/tengine-dev/references/uitk-mvvm.md
new file mode 100644
index 0000000000..2fe20423f2
--- /dev/null
+++ b/UnityProject/.claude/skills/tengine-dev/references/uitk-mvvm.md
@@ -0,0 +1,229 @@
+# UITKModule MVVM 数据绑定
+
+## 核心组件
+
+### BindableProperty<T>
+
+```csharp
+public class BindableProperty<T>
+{
+    public T Value { get; set; }            // set 时触发通知
+    public event Action<T> OnValueChanged;
+}
+
+// 使用
+var gold = new BindableProperty<int>(100);
+gold.OnValueChanged += v => lblGold.text = v.ToString();
+gold.Value = 200;  // 自动触发 UI 更新
+```
+
+### BindableCommand
+
+```csharp
+public class BindableCommand
+{
+    public void Execute();
+    public bool CanExecute();
+    public event Action CanExecuteChanged;
+}
+
+// 使用
+var buyCmd = new BindableCommand(
+    execute: () => Buy(),
+    canExecute: () => gold.Value >= price
+);
+btnBuy.clicked += buyCmd.Execute;
+buyCmd.CanExecuteChanged += () => btnBuy.SetEnabled(buyCmd.CanExecute());
+```
+
+### BindableList<T>
+
+```csharp
+public class BindableList<T> : IList<T>
+{
+    public event Action OnListChanged;
+    public event Action<int, T> OnItemAdded;
+    public event Action<int, T> OnItemRemoved;
+    public event Action<int, T, T> OnItemChanged;
+}
+
+// 使用
+var items = new BindableList<ItemData>();
+items.OnListChanged += () => listView.Rebuild();
+items.Add(newItem);  // 自动触发 UI 刷新
+```
+
+### ViewModelBase
+
+```csharp
+public abstract class ViewModelBase
+{
+    public virtual void Dispose() { }
+}
+```
+
+## 完整示例
+
+```csharp
+// ━━━ ViewModel ━━━
+public class BagViewModel : ViewModelBase
+{
+    public BindableProperty<int> Gold { get; } = new(0);
+    public BindableProperty<string> PlayerName { get; } = new("");
+    public BindableList<ItemData> Items { get; } = new();
+    public BindableCommand SortCommand { get; }
+
+    public BagViewModel()
+    {
+        SortCommand = new BindableCommand(() =>
+        {
+            // 排序逻辑
+        });
+
+        // 监听全局事件更新数据
+        GameEvent.AddEventListener<int>(EventId.GoldChanged, v => Gold.Value = v);
+    }
+
+    public override void Dispose()
+    {
+        // 清理事件监听
+    }
+}
+
+// ━━━ View ━━━
+[UIWindow(UILayer.UI, FullScreen = true)]
+public partial class BagWindow : UITKWindow
+{
+    [Q] Label lblGold;
+    [Q] Label lblName;
+    [Q] Button btnSort;
+    [Q] Button btnClose;
+
+    [OnClick] void OnBtnSort() { }
+    [OnClick] void OnBtnClose() { UITKModule.Instance.CloseUI<BagWindow>(); }
+
+    private BagViewModel _vm;
+
+    protected override void OnCreate()
+    {
+        _vm = new BagViewModel();
+
+        // 绑定数据
+        _vm.Gold.OnValueChanged += v => lblGold.text = $"{v:N0}";
+        _vm.PlayerName.OnValueChanged += v => lblName.text = v;
+
+        // 绑定命令
+        _vm.SortCommand.CanExecuteChanged += () => btnSort.SetEnabled(_vm.SortCommand.CanExecute());
+
+        // 初始同步
+        lblGold.text = $"{_vm.Gold.Value:N0}";
+        lblName.text = _vm.PlayerName.Value;
+    }
+
+    protected override void OnDestroy()
+    {
+        _vm.Dispose();
+    }
+}
+```
+
+## 自动绑定（[Bind] / [BindCommand]）
+
+除手动绑定外，可用特性声明 + 绑定生成器全自动绑定，**无需任何手动 += / -=**，框架在生命周期内自动绑定/解绑（无泄漏）。
+
+### 前置约定
+
+- View 声明为 `partial class`。
+- 类内**恰有一个** `ViewModelBase` 派生字段（如 `private XxxViewModel _vm;`），生成器据此解析 VM 类型与字段名。
+- VM 字段必须在 `OnCreate` 内赋值（自动绑定在 `OnCreate` 之后执行；为 null 时跳过）。
+- 改特性后经菜单 `TEngine → UITK → Generate All Bindings` 重新生成 `.bindgen.cs`。
+- `[Bind]/[BindCommand]` 字段会被**自动查询赋值**（等同隐含 `[Q]`），无需再加 `[Q]`。
+
+### 特性
+
+```csharp
+// OneWay：BindableProperty → Label.text（converter 优先于 format，皆无则 ToString）
+[Bind("Gold", format: "{0:N0}")] Label lblGold;
+[Bind("Hp", converter: typeof(IntToStringConverter))] Label lblHp;
+
+// 字段双向/单向（TextField/Slider/Toggle…），mode 默认 OneWay
+[Bind("PlayerName", BindingMode.TwoWay)] TextField inputName;   // string ↔ string
+[Bind("Volume", BindingMode.TwoWay)] Slider sliderVol;          // float ↔ float
+[Bind("Hp", BindingMode.TwoWay, converter: typeof(IntToStringConverter))] TextField inputHp; // int ↔ string
+
+// 命令：Button.clicked → Execute；CanExecuteChanged → SetEnabled
+[BindCommand("BuyCommand")] Button btnBuy;
+```
+
+### 完整示例
+
+```csharp
+[UIWindow(UILayer.UI)]
+public partial class BagWindow : UITKWindow
+{
+    [Bind("Gold", format: "{0:N0}")]          Label lblGold;
+    [Bind("PlayerName", BindingMode.TwoWay)]  TextField inputName;
+    [BindCommand("SortCommand")]              Button btnSort;
+
+    private BagViewModel _vm;   // ← 生成器据此解析 VM
+
+    protected override void OnCreate() => _vm = new BagViewModel();
+    protected override void OnDestroy() => _vm.Dispose();
+    // 无需手动绑定/解绑
+}
+```
+
+### 类型匹配规则
+
+| 控件 | 值类型 | 绑 int 属性 | 绑 string 属性 |
+|------|--------|------------|---------------|
+| Label | （text，恒 OneWay）| format/ToString | 直接 |
+| TextField | string | 需 converter（如 IntToStringConverter）| 直接 TwoWay |
+| Slider | float | 需 converter，或改用 SliderInt | — |
+| SliderInt | int | 直接 TwoWay | — |
+| Toggle | bool | — | — |
+
+> 控件值类型与 VM 属性类型不一致且未给 converter → 生成器报错并跳过该字段（不影响其它绑定）。
+
+### 手动 vs 自动
+
+- 两者可共存：复杂/动态绑定继续用手动 `prop.OnValueChanged += ...`；规整的属性/命令用 `[Bind]/[BindCommand]`。
+- 自动绑定使用 `UITKBase` 上的 `BindLabel/BindField/BindCommand` helper（订阅/解绑同一委托实例），无泄漏。
+
+## UITKListView 使用
+
+```csharp
+// Widget 列表项
+public class ItemSlotWidget : UITKWidget
+{
+    [Q] Label lblName;
+    [Q] Label lblCount;
+
+    public override void OnBindData(object data, int index)
+    {
+        var item = (ItemData)data;
+        lblName.text = item.Name;
+        lblCount.text = item.Count.ToString();
+    }
+}
+
+// 在 Window 中使用
+var listView = CreateWidget<UITKListView<ItemSlotWidget>>(containerElement);
+listView.BindList(viewModel.Items);  // 自动监听增删改
+```
+
+## 内置类型转换器
+
+| 转换器 | 方向 |
+|--------|------|
+| IntToStringConverter | int ↔ string |
+| FloatToStringConverter | float ↔ string |
+| BoolToDisplayConverter | bool ↔ DisplayStyle |
+| BoolToOpacityConverter | bool ↔ float (0/1) |
+
+## MVVM 与 GameEvent 的关系
+
+- **GameEvent**: 跨模块通信（如 "金币变化"、"战斗结束"）
+- **MVVM Bind**: 窗口内 ViewModel ↔ View 同步
+
+ViewModel 监听 GameEvent 更新自身属性 → 属性变化自动推送到 UI。
diff --git a/UnityProject/Assets/AssetArtScannerSetting.asset b/UnityProject/Assets/AssetArtScannerSetting.asset
new file mode 100644
index 0000000000..8656fb84e1
--- /dev/null
+++ b/UnityProject/Assets/AssetArtScannerSetting.asset
@@ -0,0 +1,15 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 84df5e62e3f1b6746a1263e076b003e1, type: 3}
+  m_Name: AssetArtScannerSetting
+  m_EditorClassIdentifier: 
+  Scanners: []
diff --git a/UnityProject/Assets/AssetArtScannerSetting.asset.meta b/UnityProject/Assets/AssetArtScannerSetting.asset.meta
new file mode 100644
index 0000000000..5d15a263b3
--- /dev/null
+++ b/UnityProject/Assets/AssetArtScannerSetting.asset.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: b46840648250a459fa88a9d0e283e071
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK.meta b/UnityProject/Assets/AssetRaw/UITK.meta
new file mode 100644
index 0000000000..c77530259f
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d35fdcf32b0924bad88a2caea1339387
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared.meta b/UnityProject/Assets/AssetRaw/UITK/Shared.meta
new file mode 100644
index 0000000000..ae41111950
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: ae0a98d6104b64880937d822f2a04978
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Settings.meta b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings.meta
new file mode 100644
index 0000000000..22751a81df
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 0c66116d701b84a1380de55c7e798005
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset
new file mode 100644
index 0000000000..07cd08e04a
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset
@@ -0,0 +1,38 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 19101, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: DefaultPanelSettings
+  m_EditorClassIdentifier: 
+  themeUss: {fileID: -4733365628477956816, guid: 42f5d7a681f3d492fba942f01f4b41ee, type: 3}
+  m_TargetTexture: {fileID: 0}
+  m_ScaleMode: 2
+  m_ReferenceSpritePixelsPerUnit: 100
+  m_Scale: 1
+  m_ReferenceDpi: 96
+  m_FallbackDpi: 96
+  m_ReferenceResolution: {x: 946, y: 2048}
+  m_ScreenMatchMode: 0
+  m_Match: 0.5
+  m_SortingOrder: 0
+  m_TargetDisplay: 0
+  m_ClearDepthStencil: 1
+  m_ClearColor: 0
+  m_ColorClearValue: {r: 0, g: 0, b: 0, a: 0}
+  m_DynamicAtlasSettings:
+    m_MinAtlasSize: 64
+    m_MaxAtlasSize: 4096
+    m_MaxSubTextureSize: 64
+    m_ActiveFilters: -1
+  m_AtlasBlitShader: {fileID: 9101, guid: 0000000000000000f000000000000000, type: 0}
+  m_RuntimeShader: {fileID: 9100, guid: 0000000000000000f000000000000000, type: 0}
+  m_RuntimeWorldShader: {fileID: 9102, guid: 0000000000000000f000000000000000, type: 0}
+  textSettings: {fileID: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset.meta b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset.meta
new file mode 100644
index 0000000000..6ae50e2173
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Settings/DefaultPanelSettings.asset.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 3ff7641da24a449eb9e1d7a5af5a0333
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Styles.meta b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles.meta
new file mode 100644
index 0000000000..25ae5f8bf0
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 0da13a1a763b1484d83b8d60b7cad550
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss
new file mode 100644
index 0000000000..0a4e411eac
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss
@@ -0,0 +1,59 @@
+.uitk-window-root {
+    flex-grow: 1;
+    position: absolute;
+    left: 0;
+    right: 0;
+    top: 0;
+    bottom: 0;
+}
+
+.btn {
+    padding: var(--spacing-sm) var(--spacing-md);
+    border-radius: var(--border-radius-md);
+    background-color: var(--color-primary);
+    color: var(--color-text-primary);
+    font-size: var(--font-size-md);
+    transition-duration: var(--transition-fast);
+    transition-property: background-color, scale;
+}
+
+.btn:hover {
+    background-color: var(--color-primary-hover);
+    scale: 1.02 1.02;
+}
+
+.btn:active {
+    scale: 0.98 0.98;
+}
+
+.btn:disabled {
+    background-color: var(--color-secondary);
+    color: var(--color-text-disabled);
+}
+
+.text-title {
+    font-size: var(--font-size-title);
+    color: var(--color-text-primary);
+}
+
+.text-body {
+    font-size: var(--font-size-md);
+    color: var(--color-text-primary);
+}
+
+.text-secondary {
+    font-size: var(--font-size-sm);
+    color: var(--color-text-secondary);
+}
+
+.panel {
+    background-color: var(--color-bg-panel);
+    border-radius: var(--border-radius-md);
+    padding: var(--spacing-md);
+}
+
+.card {
+    background-color: var(--color-bg-card);
+    border-radius: var(--border-radius-md);
+    padding: var(--spacing-md);
+}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss.meta b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss.meta
new file mode 100644
index 0000000000..728859a931
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/common.uss.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6cfc879fcb7324f50a66aca09818956f
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 12385, guid: 0000000000000000e000000000000000, type: 0}
+  disableValidation: 0
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss
new file mode 100644
index 0000000000..ec6138a376
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss
@@ -0,0 +1,36 @@
+:root {
+    --color-primary: #4A90D9;
+    --color-primary-hover: #5BA0E9;
+    --color-secondary: #7B8794;
+    --color-success: #4CAF50;
+    --color-warning: #FF9800;
+    --color-danger: #F44336;
+    --color-bg-dark: #1A1A2E;
+    --color-bg-panel: #16213E;
+    --color-bg-card: #0F3460;
+    --color-text-primary: #FFFFFF;
+    --color-text-secondary: #B0BEC5;
+    --color-text-disabled: #546E7A;
+
+    --font-size-xs: 12px;
+    --font-size-sm: 14px;
+    --font-size-md: 18px;
+    --font-size-lg: 24px;
+    --font-size-xl: 32px;
+    --font-size-title: 28px;
+
+    --spacing-xs: 4px;
+    --spacing-sm: 8px;
+    --spacing-md: 16px;
+    --spacing-lg: 24px;
+    --spacing-xl: 32px;
+
+    --border-radius-sm: 4px;
+    --border-radius-md: 8px;
+    --border-radius-lg: 12px;
+    --border-radius-full: 9999px;
+
+    --transition-fast: 150ms;
+    --transition-normal: 200ms;
+    --transition-slow: 300ms;
+}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss.meta b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss.meta
new file mode 100644
index 0000000000..9e073e7311
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Shared/Styles/variables.uss.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9462b4f08e62346bb88d8f981c2ddf23
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 12385, guid: 0000000000000000e000000000000000, type: 0}
+  disableValidation: 0
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests.meta b/UnityProject/Assets/AssetRaw/UITK/Tests.meta
new file mode 100644
index 0000000000..4f501a0ec5
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 42eaa4c2f16974e219fb5125a5c7e3d7
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml
new file mode 100644
index 0000000000..2e22e7b2fa
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml
@@ -0,0 +1,11 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="uitk-window-root" style="align-items: center; justify-content: center; padding: 40px; background-color: rgba(0,0,0,0.85);">
+        <ui:Label text="Auto-Bind Test" name="lbl-title" class="text-title" />
+        <ui:Label text="0" name="lbl-count" class="text-body" style="margin-top: 20px; color: #4CAF50;" />
+        <ui:Button text="Increment" name="btn-increment" class="btn" style="margin-top: 20px;" />
+        <ui:Button text="Decrement" name="btn-decrement" class="btn" style="margin-top: 10px;" />
+        <ui:TextField label="Name" name="input-name" style="margin-top: 20px;" />
+        <ui:Label text="" name="lbl-name-echo" class="text-secondary" style="margin-top: 10px;" />
+        <ui:Button text="Close" name="btn-close" class="btn" style="margin-top: 30px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml.meta
new file mode 100644
index 0000000000..52f21bbc56
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestAutoBindWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: b179d83614f0a4f388108f91d104601e
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml
new file mode 100644
index 0000000000..d29bcb7927
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml
@@ -0,0 +1,10 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="uitk-window-root" style="align-items: center; justify-content: center; padding: 40px;">
+        <ui:Label text="MVVM Test" name="lbl-title" class="text-title" />
+        <ui:Label text="0" name="lbl-counter" class="text-body" style="margin-top: 20px;" />
+        <ui:Button text="Increment" name="btn-increment" class="btn" style="margin-top: 20px;" />
+        <ui:Button text="Close" name="btn-close" class="btn" style="margin-top: 10px;" />
+        <ui:TextField label="Name" name="input-name" style="margin-top: 20px;" />
+        <ui:Label text="" name="lbl-name-display" class="text-secondary" style="margin-top: 10px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml.meta
new file mode 100644
index 0000000000..8161d6d8fe
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestBindingWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: a9ec924aecd0a4e40aeaefc4dd08f8f7
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml
new file mode 100644
index 0000000000..380fd0a0f2
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml
@@ -0,0 +1,58 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/variables.uss" />
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/common.uss" />
+    <ui:VisualElement class="uitk-window-root" style="padding: 40px; background-color: rgba(0,0,0,0.85);">
+
+        <!-- 标题区 -->
+        <ui:Label text="UITKModule 全功能测试" name="lbl-title" class="text-title" style="align-self: center;" />
+
+        <!-- MVVM 绑定测试区 -->
+        <ui:VisualElement class="panel" style="margin-top: 20px;">
+            <ui:Label text="MVVM 数据绑定" class="text-body" style="color: #4A90D9;" />
+
+            <ui:VisualElement style="flex-direction: row; margin-top: 10px; align-items: center;">
+                <ui:Label text="计数器:" class="text-body" />
+                <ui:Label text="0" name="lbl-counter" class="text-body" style="margin-left: 10px; color: #4CAF50;" />
+            </ui:VisualElement>
+
+            <ui:VisualElement style="flex-direction: row; margin-top: 10px;">
+                <ui:Button text="+" name="btn-increment" class="btn" style="width: 60px;" />
+                <ui:Button text="-" name="btn-decrement" class="btn" style="width: 60px; margin-left: 10px;" />
+                <ui:Button text="重置" name="btn-reset" class="btn" style="margin-left: 10px;" />
+            </ui:VisualElement>
+        </ui:VisualElement>
+
+        <!-- 双向绑定测试区 -->
+        <ui:VisualElement class="panel" style="margin-top: 20px;">
+            <ui:Label text="双向绑定 (TwoWay)" class="text-body" style="color: #4A90D9;" />
+
+            <ui:TextField label="输入名称" name="input-name" style="margin-top: 10px;" />
+            <ui:Label text="实时同步:" name="lbl-name-sync" class="text-secondary" style="margin-top: 5px;" />
+
+            <ui:Slider label="滑块" name="slider-value" low-value="0" high-value="100" style="margin-top: 10px;" />
+            <ui:Label text="滑块值: 0" name="lbl-slider-value" class="text-secondary" style="margin-top: 5px;" />
+        </ui:VisualElement>
+
+        <!-- CanExecute 测试区 -->
+        <ui:VisualElement class="panel" style="margin-top: 20px;">
+            <ui:Label text="Command CanExecute" class="text-body" style="color: #4A90D9;" />
+            <ui:Label text="计数器 >= 5 时 Buy 可用" class="text-secondary" style="margin-top: 5px;" />
+            <ui:Button text="Buy (需要 >= 5)" name="btn-buy" class="btn" style="margin-top: 10px;" />
+            <ui:Label text="" name="lbl-buy-result" class="text-secondary" style="margin-top: 5px; color: #4CAF50;" />
+        </ui:VisualElement>
+
+        <!-- Widget 测试区 -->
+        <ui:VisualElement class="panel" style="margin-top: 20px;">
+            <ui:Label text="Widget 子组件" class="text-body" style="color: #4A90D9;" />
+            <ui:VisualElement name="widget-container" style="margin-top: 10px;" />
+            <ui:Button text="添加 Widget" name="btn-add-widget" class="btn" style="margin-top: 10px;" />
+        </ui:VisualElement>
+
+        <!-- 动画 & 关闭 -->
+        <ui:VisualElement style="flex-direction: row; margin-top: 30px; justify-content: center;">
+            <ui:Button text="FadeOut 关闭" name="btn-close-fade" class="btn" />
+            <ui:Button text="SlideDown 关闭" name="btn-close-slide" class="btn" style="margin-left: 10px;" />
+        </ui:VisualElement>
+
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml.meta
new file mode 100644
index 0000000000..082dabde31
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestFullFeatureWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 1ebfd9f5b55ae41f7b6438adc568a3c5
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml
new file mode 100644
index 0000000000..ac7a6f4d96
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml
@@ -0,0 +1,7 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="card" style="flex-direction: row; align-items: center; margin-top: 5px; padding: 8px;">
+        <ui:Label text="#0" name="lbl-index" class="text-secondary" style="width: 30px;" />
+        <ui:Label text="Item" name="lbl-item-name" class="text-body" style="flex-grow: 1; margin-left: 10px;" />
+        <ui:Button text="X" name="btn-remove" style="width: 30px; height: 30px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml.meta
new file mode 100644
index 0000000000..080e00440b
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestItemWidget.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: ed7de0c1458054e609f6add240e08086
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml
new file mode 100644
index 0000000000..9486c9463f
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml
@@ -0,0 +1,20 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/variables.uss" />
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/common.uss" />
+    <ui:VisualElement class="uitk-window-root" style="padding: 40px; background-color: rgba(0,0,0,0.9); justify-content: center; align-items: center;">
+        <ui:Label text="UITK 主界面" name="lbl-title" class="text-title" />
+        <ui:Label text="层级: UI | 全屏" name="lbl-info" class="text-secondary" style="margin-top: 10px;" />
+
+        <ui:VisualElement style="margin-top: 40px; width: 400px;">
+            <ui:Button text="打开 Tips 弹窗 (上层)" name="btn-open-tips" class="btn" style="margin-top: 10px;" />
+            <ui:Button text="打开 System 确认框 (最上层)" name="btn-open-system" class="btn" style="margin-top: 10px;" />
+            <ui:Button text="打开 子页面 (同层 UI)" name="btn-open-sub" class="btn" style="margin-top: 10px;" />
+            <ui:Button text="打开 AutoBind 测试" name="btn-open-autobind" class="btn" style="margin-top: 10px;" />
+            <ui:Button text="打开 MVVM 全功能测试" name="btn-open-full" class="btn" style="margin-top: 10px;" />
+            <ui:Button text="关闭自己" name="btn-close" class="btn" style="margin-top: 30px; background-color: #F44336;" />
+        </ui:VisualElement>
+
+        <ui:Label text="窗口栈:" class="text-secondary" style="margin-top: 30px;" />
+        <ui:Label text="" name="lbl-stack" class="text-secondary" style="margin-top: 5px; white-space: normal;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml.meta
new file mode 100644
index 0000000000..8801dca64d
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMainWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: b500cabf190904d7f8d16e43461faf4d
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml
new file mode 100644
index 0000000000..546c8285ae
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml
@@ -0,0 +1,11 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="uitk-window-root" style="align-items: center; justify-content: center; padding: 40px;">
+        <ui:Label text="MVVM AutoBind Test" name="lbl-title" class="text-title" />
+        <ui:Label text="Count: 0" name="lbl-counter" class="text-body" style="margin-top: 20px;" />
+        <ui:TextField label="Counter(conv)" name="input-counter" style="margin-top: 10px;" />
+        <ui:TextField label="Name" name="input-name" style="margin-top: 10px;" />
+        <ui:Slider label="Volume" name="slider-volume" low-value="0" high-value="100" style="margin-top: 10px; width: 300px;" />
+        <ui:Button text="Increment" name="btn-increment" class="btn" style="margin-top: 20px;" />
+        <ui:Button text="Close" name="btn-close" class="btn" style="margin-top: 10px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml.meta
new file mode 100644
index 0000000000..4b5807ae2a
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestMvvmAutoBindWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: f71300490aea041c4bc3b0e01435655b
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml
new file mode 100644
index 0000000000..8518d6e799
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml
@@ -0,0 +1,10 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/variables.uss" />
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/common.uss" />
+    <ui:VisualElement class="uitk-window-root" style="padding: 40px; background-color: rgba(20,20,50,0.95); justify-content: center; align-items: center;">
+        <ui:Label text="子页面 (同层 UI)" name="lbl-title" class="text-title" />
+        <ui:Label text="我是全屏页面，会遮挡主界面" name="lbl-desc" class="text-secondary" style="margin-top: 10px;" />
+        <ui:Label text="主界面的 OnSetVisible(false) 应该被触发" class="text-secondary" style="margin-top: 5px; white-space: normal;" />
+        <ui:Button text="返回主界面" name="btn-back" class="btn" style="margin-top: 30px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml.meta
new file mode 100644
index 0000000000..e42fc7217a
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSubPage.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: fbe29c7329c9a472d9031d6bffe354b2
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml
new file mode 100644
index 0000000000..98cd7baf62
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml
@@ -0,0 +1,15 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/variables.uss" />
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/common.uss" />
+    <ui:VisualElement class="uitk-window-root" style="justify-content: center; align-items: center; background-color: rgba(0,0,0,0.6);">
+        <ui:VisualElement class="card" style="width: 400px; padding: 30px; align-items: center;">
+            <ui:Label text="System 层确认框" name="lbl-title" class="text-title" style="font-size: 22px;" />
+            <ui:Label text="我在 System 层 (最高层级)" name="lbl-desc" class="text-secondary" style="margin-top: 10px;" />
+            <ui:Label text="即使有 Tips 弹窗，我也在其上方" class="text-secondary" style="margin-top: 5px; white-space: normal;" />
+            <ui:VisualElement style="flex-direction: row; margin-top: 20px;">
+                <ui:Button text="确认" name="btn-confirm" class="btn" style="width: 100px;" />
+                <ui:Button text="取消" name="btn-cancel" class="btn" style="width: 100px; margin-left: 20px; background-color: #7B8794;" />
+            </ui:VisualElement>
+        </ui:VisualElement>
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml.meta
new file mode 100644
index 0000000000..d8a1193e3d
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestSystemDialog.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 25e1a0254418147e99509da1d0e00dd1
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml
new file mode 100644
index 0000000000..1a05a1ac1e
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml
@@ -0,0 +1,12 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/variables.uss" />
+    <Style src="project://database/Assets/AssetRaw/UITK/Shared/Styles/common.uss" />
+    <ui:VisualElement class="uitk-window-root" style="justify-content: center; align-items: center;">
+        <ui:VisualElement class="panel" style="width: 350px; padding: 30px; align-items: center;">
+            <ui:Label text="Tips 层弹窗" name="lbl-title" class="text-title" style="font-size: 22px;" />
+            <ui:Label text="我在 Tips 层 (sortingOrder=6000)" name="lbl-desc" class="text-secondary" style="margin-top: 10px; white-space: normal;" />
+            <ui:Label text="下层 UI 仍然可见（非全屏）" class="text-secondary" style="margin-top: 5px;" />
+            <ui:Button text="关闭" name="btn-close" class="btn" style="margin-top: 20px;" />
+        </ui:VisualElement>
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml.meta
new file mode 100644
index 0000000000..edcc957828
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestTipsPopup.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: 5c5a552d501034fe68e8dc7f0529d6cc
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml b/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml
new file mode 100644
index 0000000000..757750774c
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml
@@ -0,0 +1,6 @@
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="uitk-window-root" style="align-items: center; justify-content: center;">
+        <ui:Label text="UITKModule Works!" name="lbl-title" class="text-title" />
+        <ui:Button text="Close" name="btn-close" class="btn" style="margin-top: 20px;" />
+    </ui:VisualElement>
+</ui:UXML>
diff --git a/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml.meta b/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml.meta
new file mode 100644
index 0000000000..db10b0bef6
--- /dev/null
+++ b/UnityProject/Assets/AssetRaw/UITK/Tests/TestUITKWindow.uxml.meta
@@ -0,0 +1,10 @@
+fileFormatVersion: 2
+guid: ad5ed2314880546efbd93d73fe09e672
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 13804, guid: 0000000000000000e000000000000000, type: 0}
diff --git a/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorConfig.xml b/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorConfig.xml
index 4b6bfd7fa1..f75791df4b 100644
--- a/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorConfig.xml
+++ b/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorConfig.xml
@@ -33,6 +33,9 @@
       <Collector CollectPath="Assets/AssetRaw/UIRaw/Atlas" CollectGUID="6d11fa91acc253840a648b58f23db139" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackDirectory" FilterRule="CollectAll" UserData="" AssetTags="" />
       <Collector CollectPath="Assets/AssetRaw/UIRaw/Raw" CollectGUID="6bc134b912ac6bb4399ea1bec4c11636" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackDirectory" FilterRule="CollectAll" UserData="" AssetTags="" />
     </Group>
+    <Group GroupActiveRule="EnableGroup" GroupName="UITK" GroupDesc="UIToolkit Assets" AssetTags="">
+      <Collector CollectPath="Assets/AssetRaw/UITK" CollectGUID="" CollectType="MainAssetCollector" AddressRule="AddressByFileName" PackRule="PackDirectory" FilterRule="CollectAll" UserData="" AssetTags="" />
+    </Group>
   </Package>
   <Package PackageName="OtherPackage" PackageDesc="" AutoAddressable="True" LocationToLower="False" IncludeAssetGUID="False" IgnoreDefaultType="True">
     <Group GroupActiveRule="EnableGroup" GroupName="ModelGroup" GroupDesc="" AssetTags="models" />
diff --git a/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorSetting.asset b/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorSetting.asset
index faf9828064..5d9f214bfc 100644
--- a/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorSetting.asset
+++ b/UnityProject/Assets/Editor/AssetBundleCollector/AssetBundleCollectorSetting.asset
@@ -163,6 +163,19 @@ MonoBehaviour:
         FilterRuleName: CollectAll
         AssetTags: 
         UserData: 
+    - GroupName: UITK
+      GroupDesc: 
+      AssetTags: 
+      ActiveRuleName: EnableGroup
+      Collectors:
+      - CollectPath: Assets/AssetRaw/UITK
+        CollectorGUID: d35fdcf32b0924bad88a2caea1339387
+        CollectorType: 0
+        AddressRuleName: AddressByFileName
+        PackRuleName: PackDirectory
+        FilterRuleName: CollectAll
+        AssetTags: 
+        UserData: 
   - PackageName: OtherPackage
     PackageDesc: 
     EnableAddressable: 1
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator.meta b/UnityProject/Assets/Editor/UITKBindingGenerator.meta
new file mode 100644
index 0000000000..4bdb4047c9
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: bff9c033299424bf0a3b2b04b057c917
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs
new file mode 100644
index 0000000000..7780f704da
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs
@@ -0,0 +1,473 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using UnityEditor;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace TEngine.Editor.UITK
+{
+    /// <summary>
+    /// UIToolkit 绑定代码生成器。
+    /// 扫描 [Q]/[OnClick]/[OnChange]/[Bind]/[BindCommand]，生成 .bindgen.cs。
+    /// MVVM 段生成对 UITKBase.Bind* helper 的调用（订阅/解绑用同一委托实例，无泄漏）。
+    /// </summary>
+    public static class UITKBindingGenerator
+    {
+        private const string GENERATED_SUFFIX = ".bindgen.cs";
+        private const string HEADER = "// <auto-generated by UITKBindingGenerator>\n// Do not modify manually.\n";
+
+        [MenuItem("TEngine/UITK/Generate All Bindings", priority = 100)]
+        public static void GenerateAll()
+        {
+            var assemblies = AppDomain.CurrentDomain.GetAssemblies();
+            int count = 0;
+
+            foreach (var assembly in assemblies)
+            {
+                // 只扫描热更程序集
+                if (!assembly.GetName().Name.Contains("GameLogic") &&
+                    !assembly.GetName().Name.Contains("GameBase"))
+                    continue;
+
+                foreach (var type in assembly.GetTypes())
+                {
+                    if (TryGenerateForType(type))
+                        count++;
+                }
+            }
+
+            AssetDatabase.Refresh();
+            Debug.Log($"[UITKBindingGenerator] Generated {count} binding file(s).");
+        }
+
+        [MenuItem("TEngine/UITK/Generate Binding (Selected)", priority = 101)]
+        public static void GenerateSelected()
+        {
+            var selected = Selection.activeObject as MonoScript;
+            if (selected == null)
+            {
+                Debug.LogWarning("[UITKBindingGenerator] Please select a C# script file.");
+                return;
+            }
+
+            var type = selected.GetClass();
+            if (type == null)
+            {
+                Debug.LogWarning($"[UITKBindingGenerator] Cannot get type from {selected.name}.");
+                return;
+            }
+
+            if (TryGenerateForType(type))
+            {
+                AssetDatabase.Refresh();
+                Debug.Log($"[UITKBindingGenerator] Generated binding for {type.Name}.");
+            }
+            else
+            {
+                Debug.Log($"[UITKBindingGenerator] {type.Name} has no binding attributes, skipped.");
+            }
+        }
+
+        private static bool TryGenerateForType(Type type)
+        {
+            // 必须继承 UITKWindow 或 UITKWidget
+            if (!IsUITKType(type)) return false;
+
+            var flags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly;
+
+            // 收集信息
+            var qFields = new List<QFieldInfo>();
+            var onClickMethods = new List<EventMethodInfo>();
+            var onChangeMethods = new List<EventMethodInfo>();
+            var bindFields = new List<BindFieldInfo>();
+            var bindCommands = new List<BindCommandInfo>();
+
+            // 扫描字段
+            foreach (var field in type.GetFields(flags))
+            {
+                var qAttr = field.GetCustomAttribute<GameLogic.QAttribute>();
+                if (qAttr != null)
+                {
+                    string uxmlName = qAttr.Name ?? UITKNamingHelper.ToKebabCase(field.Name);
+                    qFields.Add(new QFieldInfo
+                    {
+                        FieldName = field.Name,
+                        TypeName = field.FieldType.Name,
+                        TypeFullName = field.FieldType.FullName,
+                        UxmlName = uxmlName,
+                    });
+                }
+
+                var bindAttr = field.GetCustomAttribute<GameLogic.BindAttribute>();
+                if (bindAttr != null)
+                {
+                    bindFields.Add(new BindFieldInfo
+                    {
+                        FieldName = field.Name,
+                        FieldType = field.FieldType,
+                        Path = bindAttr.Path,
+                        Mode = bindAttr.Mode,
+                        Format = bindAttr.Format,
+                        ConverterType = bindAttr.Converter,
+                    });
+                }
+
+                var cmdAttr = field.GetCustomAttribute<GameLogic.BindCommandAttribute>();
+                if (cmdAttr != null)
+                {
+                    bindCommands.Add(new BindCommandInfo
+                    {
+                        FieldName = field.Name,
+                        FieldType = field.FieldType,
+                        CommandName = cmdAttr.CommandName,
+                    });
+                }
+            }
+
+            // 扫描方法
+            foreach (var method in type.GetMethods(flags))
+            {
+                var clickAttr = method.GetCustomAttribute<GameLogic.OnClickAttribute>();
+                if (clickAttr != null)
+                {
+                    string target = clickAttr.Target ?? UITKNamingHelper.MethodNameToTarget(method.Name);
+                    onClickMethods.Add(new EventMethodInfo { MethodName = method.Name, UxmlTarget = target });
+                }
+
+                var changeAttr = method.GetCustomAttribute<GameLogic.OnChangeAttribute>();
+                if (changeAttr != null)
+                {
+                    onChangeMethods.Add(new EventMethodInfo { MethodName = method.Name, UxmlTarget = changeAttr.Target });
+                }
+            }
+
+            // 无绑定内容则跳过
+            if (qFields.Count == 0 && onClickMethods.Count == 0 && onChangeMethods.Count == 0 &&
+                bindFields.Count == 0 && bindCommands.Count == 0)
+                return false;
+
+            // MVVM：解析 ViewModel 字段（类型 + 字段名）
+            FieldInfo vmField = null;
+            if (bindFields.Count > 0 || bindCommands.Count > 0)
+            {
+                vmField = FindViewModelField(type);
+                if (vmField == null)
+                {
+                    Debug.LogWarning($"[UITKBindingGenerator] {type.Name} 含 [Bind]/[BindCommand] 但未找到唯一的 ViewModelBase 字段，已跳过 MVVM 自动绑定（请确保类内恰有一个 ViewModel 字段）。");
+                }
+            }
+
+            // 找到源文件路径
+            string sourcePath = FindSourceFile(type);
+            if (string.IsNullOrEmpty(sourcePath) || sourcePath.Contains(".bindgen.")) return false;
+
+            // 生成代码
+            string code = GenerateCode(type, qFields, onClickMethods, onChangeMethods, bindFields, bindCommands, vmField);
+
+            // 写入 .bindgen.cs
+            string outputPath = sourcePath.Replace(".cs", GENERATED_SUFFIX);
+            File.WriteAllText(outputPath, code, Encoding.UTF8);
+
+            return true;
+        }
+
+        private static string GenerateCode(Type type, List<QFieldInfo> qFields, List<EventMethodInfo> clickMethods,
+            List<EventMethodInfo> changeMethods, List<BindFieldInfo> bindFields, List<BindCommandInfo> bindCommands,
+            FieldInfo vmField)
+        {
+            var sb = new StringBuilder();
+            sb.AppendLine(HEADER);
+            sb.AppendLine("using System;");
+            sb.AppendLine("using System.Collections.Generic;");
+            sb.AppendLine("using UnityEngine.UIElements;");
+            sb.AppendLine();
+
+            string ns = type.Namespace;
+            if (!string.IsNullOrEmpty(ns))
+            {
+                sb.AppendLine($"namespace {ns}");
+                sb.AppendLine("{");
+            }
+
+            string indent = string.IsNullOrEmpty(ns) ? "    " : "        ";
+            string classIndent = string.IsNullOrEmpty(ns) ? "" : "    ";
+
+            sb.AppendLine($"{classIndent}partial class {type.Name}");
+            sb.AppendLine($"{classIndent}{{");
+
+            // __UITKAutoBind（[Q] 以及 [Bind]/[BindCommand] 字段都需查询并赋值，按字段名去重）
+            sb.AppendLine($"{indent}protected override void __UITKAutoBind(UnityEngine.UIElements.VisualElement root)");
+            sb.AppendLine($"{indent}{{");
+            var queried = new HashSet<string>();
+            foreach (var q in qFields)
+            {
+                if (queried.Add(q.FieldName))
+                    sb.AppendLine($"{indent}    {q.FieldName} = root.Q<{q.TypeName}>(\"{q.UxmlName}\");");
+            }
+            foreach (var bind in bindFields)
+            {
+                if (queried.Add(bind.FieldName))
+                    sb.AppendLine($"{indent}    {bind.FieldName} = root.Q<{bind.FieldType.Name}>(\"{UITKNamingHelper.ToKebabCase(bind.FieldName)}\");");
+            }
+            foreach (var cmd in bindCommands)
+            {
+                if (queried.Add(cmd.FieldName))
+                    sb.AppendLine($"{indent}    {cmd.FieldName} = root.Q<{cmd.FieldType.Name}>(\"{UITKNamingHelper.ToKebabCase(cmd.FieldName)}\");");
+            }
+            sb.AppendLine($"{indent}}}");
+            sb.AppendLine();
+
+            // __UITKAutoBindEvents
+            sb.AppendLine($"{indent}protected override void __UITKAutoBindEvents()");
+            sb.AppendLine($"{indent}{{");
+            foreach (var click in clickMethods)
+            {
+                var field = qFields.FirstOrDefault(q => q.UxmlName == click.UxmlTarget);
+                if (field != null)
+                    sb.AppendLine($"{indent}    {field.FieldName}.clicked += {click.MethodName};");
+            }
+            foreach (var change in changeMethods)
+            {
+                var field = qFields.FirstOrDefault(q => q.UxmlName == change.UxmlTarget);
+                if (field != null)
+                    sb.AppendLine($"{indent}    {field.FieldName}.RegisterValueChangedCallback({change.MethodName});");
+            }
+            sb.AppendLine($"{indent}}}");
+            sb.AppendLine();
+
+            // __UITKAutoUnbindEvents
+            sb.AppendLine($"{indent}protected override void __UITKAutoUnbindEvents()");
+            sb.AppendLine($"{indent}{{");
+            foreach (var click in clickMethods)
+            {
+                var field = qFields.FirstOrDefault(q => q.UxmlName == click.UxmlTarget);
+                if (field != null)
+                    sb.AppendLine($"{indent}    {field.FieldName}.clicked -= {click.MethodName};");
+            }
+            foreach (var change in changeMethods)
+            {
+                var field = qFields.FirstOrDefault(q => q.UxmlName == change.UxmlTarget);
+                if (field != null)
+                    sb.AppendLine($"{indent}    {field.FieldName}.UnregisterValueChangedCallback({change.MethodName});");
+            }
+            sb.AppendLine($"{indent}}}");
+
+            // __UITKAutoBindMVVM（仅当解析到 ViewModel 字段时生成；解绑用基类默认实现）
+            if (vmField != null && (bindFields.Count > 0 || bindCommands.Count > 0))
+            {
+                Type vmType = vmField.FieldType;
+                string vm = vmField.Name;
+
+                sb.AppendLine();
+                sb.AppendLine($"{indent}protected override void __UITKAutoBindMVVM()");
+                sb.AppendLine($"{indent}{{");
+                sb.AppendLine($"{indent}    if ({vm} == null) {{ TEngine.Log.Warning(\"[MVVM] {type.Name}.{vm} 为 null，已跳过自动绑定。请确认已在 OnCreate 中构造 ViewModel。\"); return; }}");
+
+                foreach (var bind in bindFields)
+                {
+                    EmitBindField(sb, indent, type, vmType, vm, bind);
+                }
+                foreach (var cmd in bindCommands)
+                {
+                    sb.AppendLine($"{indent}    BindCommand({cmd.FieldName}, {vm}.{cmd.CommandName});");
+                }
+
+                sb.AppendLine($"{indent}}}");
+            }
+
+            sb.AppendLine($"{classIndent}}}");
+
+            if (!string.IsNullOrEmpty(ns))
+            {
+                sb.AppendLine("}");
+            }
+
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// 为单个 [Bind] 字段生成 helper 调用。根据控件类型 × 属性类型 × mode × converter/format 选择。
+        /// </summary>
+        private static void EmitBindField(StringBuilder sb, string indent, Type ownerType, Type vmType, string vm, BindFieldInfo bind)
+        {
+            Type propValueType = GetBindablePropertyValueType(vmType, bind.Path);
+            if (propValueType == null)
+            {
+                Debug.LogError($"[UITKBindingGenerator] {ownerType.Name}: [Bind] 路径 '{bind.Path}' 在 {vmType.Name} 上未找到对应的 BindableProperty<T>，已跳过该字段。");
+                sb.AppendLine($"{indent}    // [Bind] '{bind.Path}' 解析失败，已跳过");
+                return;
+            }
+
+            bool isLabel = typeof(Label).IsAssignableFrom(bind.FieldType);
+
+            // ── Label：恒 OneWay，输出 text ──
+            if (isLabel)
+            {
+                if (bind.Mode != GameLogic.BindingMode.OneWay)
+                    Debug.LogWarning($"[UITKBindingGenerator] {ownerType.Name}: Label '{bind.FieldName}' 仅支持 OneWay，已忽略 mode={bind.Mode}。");
+
+                if (bind.ConverterType != null)
+                    sb.AppendLine($"{indent}    BindLabel({bind.FieldName}, {vm}.{bind.Path}, v => new {bind.ConverterType.FullName}().Convert(v));");
+                else if (!string.IsNullOrEmpty(bind.Format))
+                    sb.AppendLine($"{indent}    BindLabel({bind.FieldName}, {vm}.{bind.Path}, v => string.Format(\"{bind.Format}\", v));");
+                else
+                    sb.AppendLine($"{indent}    BindLabel({bind.FieldName}, {vm}.{bind.Path});");
+                return;
+            }
+
+            // ── 值控件（INotifyValueChanged<T>）──
+            Type ctrlValueType = GetNotifyValueType(bind.FieldType);
+            if (ctrlValueType == null)
+            {
+                Debug.LogError($"[UITKBindingGenerator] {ownerType.Name}: 字段 '{bind.FieldName}'（{bind.FieldType.Name}）非 Label 且未实现 INotifyValueChanged<T>，不支持 [Bind]，已跳过。");
+                sb.AppendLine($"{indent}    // [Bind] '{bind.FieldName}' 控件类型不支持，已跳过");
+                return;
+            }
+
+            string mode = $"GameLogic.BindingMode.{bind.Mode}";
+
+            if (bind.ConverterType != null)
+            {
+                // 异类型：经 converter 转换
+                sb.AppendLine($"{indent}    BindField({bind.FieldName}, {vm}.{bind.Path}, new {bind.ConverterType.FullName}(), {mode});");
+            }
+            else if (propValueType == ctrlValueType)
+            {
+                // 同类型：直接绑定
+                sb.AppendLine($"{indent}    BindField({bind.FieldName}, {vm}.{bind.Path}, {mode});");
+            }
+            else
+            {
+                Debug.LogError($"[UITKBindingGenerator] {ownerType.Name}: 字段 '{bind.FieldName}' 控件值类型({ctrlValueType.Name}) 与 VM 属性类型({propValueType.Name}) 不一致，且未提供 converter，已跳过。请改用匹配控件（如 int 用 SliderInt）或在 [Bind] 指定 converter。");
+                sb.AppendLine($"{indent}    // [Bind] '{bind.FieldName}' 类型不匹配且无 converter，已跳过");
+            }
+        }
+
+        // ━━━ 类型解析 ━━━
+
+        /// <summary>在类型内查找唯一的 ViewModelBase 派生字段；0 个或多个返回 null。</summary>
+        private static FieldInfo FindViewModelField(Type type)
+        {
+            var flags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly;
+            FieldInfo found = null;
+            foreach (var f in type.GetFields(flags))
+            {
+                if (typeof(GameLogic.ViewModelBase).IsAssignableFrom(f.FieldType))
+                {
+                    if (found != null) return null; // 歧义：多个 VM 字段
+                    found = f;
+                }
+            }
+            return found;
+        }
+
+        /// <summary>解析 VM 上某 path（属性或字段）的 BindableProperty&lt;T&gt; 的 T。</summary>
+        private static Type GetBindablePropertyValueType(Type vmType, string path)
+        {
+            var flags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.FlattenHierarchy;
+            Type pt = null;
+
+            var pi = vmType.GetProperty(path, flags);
+            if (pi != null) pt = pi.PropertyType;
+            else
+            {
+                var fi = vmType.GetField(path, flags);
+                if (fi != null) pt = fi.FieldType;
+            }
+
+            if (pt != null && pt.IsGenericType && pt.GetGenericTypeDefinition() == typeof(GameLogic.BindableProperty<>))
+                return pt.GetGenericArguments()[0];
+            return null;
+        }
+
+        /// <summary>取控件实现的 INotifyValueChanged&lt;T&gt; 的 T；未实现返回 null。</summary>
+        private static Type GetNotifyValueType(Type controlType)
+        {
+            foreach (var i in controlType.GetInterfaces())
+            {
+                if (i.IsGenericType && i.GetGenericTypeDefinition() == typeof(INotifyValueChanged<>))
+                    return i.GetGenericArguments()[0];
+            }
+            return null;
+        }
+
+        private static string FindSourceFile(Type type)
+        {
+            // 通过 GUID 搜索脚本文件
+            string[] guids = AssetDatabase.FindAssets($"t:MonoScript {type.Name}");
+            foreach (var guid in guids)
+            {
+                string path = AssetDatabase.GUIDToAssetPath(guid);
+                if (path.Contains(".bindgen.")) continue;  // 跳过已生成文件
+                var script = AssetDatabase.LoadAssetAtPath<MonoScript>(path);
+                if (script != null && script.GetClass() == type)
+                {
+                    return path;
+                }
+            }
+
+            // 回退：按文件名搜索
+            string[] paths = AssetDatabase.FindAssets($"{type.Name} t:MonoScript");
+            foreach (var guid in paths)
+            {
+                string path = AssetDatabase.GUIDToAssetPath(guid);
+                if (path.Contains(".bindgen.")) continue;  // 跳过已生成文件
+                if (Path.GetFileNameWithoutExtension(path) == type.Name)
+                    return path;
+            }
+
+            Debug.LogWarning($"[UITKBindingGenerator] Source file not found for {type.FullName}");
+            return null;
+        }
+
+        private static bool IsUITKType(Type type)
+        {
+            if (type.IsAbstract || !type.IsClass) return false;
+            var current = type.BaseType;
+            while (current != null)
+            {
+                if (current.Name == "UITKWindow" || current.Name == "UITKWidget")
+                    return true;
+                current = current.BaseType;
+            }
+            return false;
+        }
+
+        // ━━━ 数据结构 ━━━
+
+        private class QFieldInfo
+        {
+            public string FieldName;
+            public string TypeName;
+            public string TypeFullName;
+            public string UxmlName;
+        }
+
+        private class EventMethodInfo
+        {
+            public string MethodName;
+            public string UxmlTarget;
+        }
+
+        private class BindFieldInfo
+        {
+            public string FieldName;
+            public Type FieldType;
+            public string Path;
+            public GameLogic.BindingMode Mode;
+            public string Format;
+            public Type ConverterType;
+        }
+
+        private class BindCommandInfo
+        {
+            public string FieldName;
+            public Type FieldType;
+            public string CommandName;
+        }
+    }
+}
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs.meta b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs.meta
new file mode 100644
index 0000000000..95258f4177
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKBindingGenerator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a69a6f66419a04abe868cd534c3ac102
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs
new file mode 100644
index 0000000000..54dc88acd7
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs
@@ -0,0 +1,56 @@
+using System.Text;
+
+namespace TEngine.Editor.UITK
+{
+    /// <summary>
+    /// 命名转换工具。
+    /// </summary>
+    public static class UITKNamingHelper
+    {
+        /// <summary>
+        /// C# camelCase → UXML kebab-case。
+        /// btnLogin → btn-login, lblPlayerHP → lbl-player-hp
+        /// </summary>
+        public static string ToKebabCase(string camelCase)
+        {
+            if (string.IsNullOrEmpty(camelCase)) return camelCase;
+
+            var sb = new StringBuilder();
+            for (int i = 0; i < camelCase.Length; i++)
+            {
+                char c = camelCase[i];
+                if (char.IsUpper(c))
+                {
+                    bool isAcronymPart = i > 0 && char.IsUpper(camelCase[i - 1]);
+                    bool isAcronymEnd = i + 1 < camelCase.Length && char.IsLower(camelCase[i + 1]);
+
+                    if (i > 0 && !isAcronymPart)
+                        sb.Append('-');
+                    else if (isAcronymPart && isAcronymEnd && i > 1)
+                        sb.Append('-');
+
+                    sb.Append(char.ToLower(c));
+                }
+                else
+                {
+                    sb.Append(c);
+                }
+            }
+            return sb.ToString();
+        }
+
+        /// <summary>
+        /// 从 OnClick 方法名推导目标元素名。
+        /// OnBtnLogin → btn-login
+        /// </summary>
+        public static string MethodNameToTarget(string methodName)
+        {
+            if (methodName.StartsWith("On") && methodName.Length > 2)
+            {
+                string remainder = char.ToLower(methodName[2]) + methodName.Substring(3);
+                return ToKebabCase(remainder);
+            }
+            return ToKebabCase(methodName);
+        }
+    }
+}
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs.meta b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs.meta
new file mode 100644
index 0000000000..63e5178744
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKNamingHelper.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e51bbff7ef2df4e6d97c3ca489c181a0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs
new file mode 100644
index 0000000000..62a2ff7247
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs
@@ -0,0 +1,92 @@
+using System.Collections.Generic;
+using System.IO;
+using System.Xml;
+using UnityEngine;
+
+namespace TEngine.Editor.UITK
+{
+    /// <summary>
+    /// UXML 文件解析与校验。
+    /// </summary>
+    public static class UITKUXMLValidator
+    {
+        public struct UXMLElement
+        {
+            public string Name;
+            public string TypeName;
+        }
+
+        /// <summary>
+        /// 解析 UXML 文件，提取所有带 name 属性的元素。
+        /// </summary>
+        public static List<UXMLElement> ParseUXML(string uxmlPath)
+        {
+            var elements = new List<UXMLElement>();
+            if (!File.Exists(uxmlPath)) return elements;
+
+            try
+            {
+                string content = File.ReadAllText(uxmlPath);
+                using var reader = XmlReader.Create(new StringReader(content));
+                while (reader.Read())
+                {
+                    if (reader.NodeType != XmlNodeType.Element) continue;
+                    string name = reader.GetAttribute("name");
+                    if (string.IsNullOrEmpty(name)) continue;
+
+                    string typeName = MapElementType(reader.LocalName);
+                    elements.Add(new UXMLElement { Name = name, TypeName = typeName });
+                }
+            }
+            catch (System.Exception e)
+            {
+                Debug.LogWarning($"[UITKUXMLValidator] Failed to parse {uxmlPath}: {e.Message}");
+            }
+            return elements;
+        }
+
+        /// <summary>
+        /// 校验元素名是否存在于 UXML 中。
+        /// </summary>
+        public static bool ValidateElement(List<UXMLElement> elements, string uxmlName, out string foundType)
+        {
+            foundType = null;
+            foreach (var e in elements)
+            {
+                if (e.Name == uxmlName)
+                {
+                    foundType = e.TypeName;
+                    return true;
+                }
+            }
+            return false;
+        }
+
+        private static string MapElementType(string xmlLocalName)
+        {
+            return xmlLocalName switch
+            {
+                "Button" => "Button",
+                "Label" => "Label",
+                "TextField" => "TextField",
+                "Toggle" => "Toggle",
+                "Slider" => "Slider",
+                "SliderInt" => "SliderInt",
+                "DropdownField" => "DropdownField",
+                "RadioButton" => "RadioButton",
+                "RadioButtonGroup" => "RadioButtonGroup",
+                "Foldout" => "Foldout",
+                "ScrollView" => "ScrollView",
+                "ListView" => "ListView",
+                "TreeView" => "TreeView",
+                "ProgressBar" => "ProgressBar",
+                "MinMaxSlider" => "MinMaxSlider",
+                "Image" => "Image",
+                "VisualElement" => "VisualElement",
+                "TemplateContainer" => "TemplateContainer",
+                "GroupBox" => "GroupBox",
+                _ => "VisualElement",
+            };
+        }
+    }
+}
diff --git a/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs.meta b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs.meta
new file mode 100644
index 0000000000..f0904b3103
--- /dev/null
+++ b/UnityProject/Assets/Editor/UITKBindingGenerator/UITKUXMLValidator.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f3564c154c35e47deba723b15d955fa5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameApp.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameApp.cs
index 3172117262..f43ed3528e 100644
--- a/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameApp.cs
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameApp.cs
@@ -36,7 +36,8 @@ public static void Entrance(object[] objects)
     private static void StartGameLogic()
     {
         // GameEvent.Get<ILoginUI>().ShowLoginUI();
-        GameModule.UI.ShowUIAsync<BattleMainUI>();
+        // GameModule.UI.ShowUIAsync<BattleMainUI>();
+        GameModule.UITK.ShowUIAsync<TestMainWindow>();
     }
     
     private static void Release()
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameModule.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameModule.cs
index 6b4fbfbd3d..215058ccb5 100644
--- a/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameModule.cs
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/GameModule.cs
@@ -64,6 +64,13 @@ public static IDebuggerModule Debugger
 
     private static UIModule _ui;
 
+    /// <summary>
+    /// 获取UIToolkit模块。
+    /// </summary>
+    public static UITKModule UITK => _uitk ??= UITKModule.Instance;
+
+    private static UITKModule _uitk;
+
     /// <summary>
     /// 获取场景模块。
     /// </summary>
@@ -114,5 +121,6 @@ public static void Shutdown()
         _scene = null;
         _timer = null;
         _localization = null;
+        _uitk = null;
     }
 }
\ No newline at end of file
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UIModule/SetUISafeFitHelper.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UIModule/SetUISafeFitHelper.cs.meta
index aea0aa9649..03788fa9af 100644
--- a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UIModule/SetUISafeFitHelper.cs.meta
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UIModule/SetUISafeFitHelper.cs.meta
@@ -1,2 +1,11 @@
 fileFormatVersion: 2
-guid: d0b4eba50cf3ee3478d3f333a9ea96ab
\ No newline at end of file
+guid: d0b4eba50cf3ee3478d3f333a9ea96ab
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule.meta
new file mode 100644
index 0000000000..0a3bb691d7
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 19c9ae5068e614d4c981f1c14e9cb2e2
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation.meta
new file mode 100644
index 0000000000..a1ffcd611d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 9e2212fcb5c8c447fb0cff51bc9273d0
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs
new file mode 100644
index 0000000000..5cea3c1533
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs
@@ -0,0 +1,20 @@
+using Cysharp.Threading.Tasks;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 动画驱动器接口。默认使用 USS Transition，可替换为 DOTween 等实现。
+    /// </summary>
+    public interface IUITKAnimationDriver
+    {
+        /// <summary>
+        /// 播放动画。
+        /// </summary>
+        /// <param name="target">目标 VisualElement。</param>
+        /// <param name="type">动画类型。</param>
+        /// <param name="isShow">true=显示动画，false=隐藏动画。</param>
+        /// <param name="durationMs">动画时长（毫秒）。</param>
+        UniTask Play(VisualElement target, UITKAnimationType type, bool isShow, int durationMs);
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs.meta
new file mode 100644
index 0000000000..7647234a77
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3284302afe14643fe8d5c8ad156ed721
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs
new file mode 100644
index 0000000000..f4dcd621d2
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs
@@ -0,0 +1,18 @@
+namespace GameLogic
+{
+    /// <summary>
+    /// 内置动画预设类型。
+    /// </summary>
+    public enum UITKAnimationType
+    {
+        None,
+        FadeIn,
+        FadeOut,
+        SlideFromBottom,
+        SlideToBottom,
+        SlideFromRight,
+        SlideToRight,
+        ScaleIn,
+        ScaleOut,
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs.meta
new file mode 100644
index 0000000000..0d92993e79
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2c3b1c222c23f46b69f4536c2cccfde2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs
new file mode 100644
index 0000000000..9ac7722d0c
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs
@@ -0,0 +1,81 @@
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 默认动画驱动器，使用 USS Transition 实现。
+    /// </summary>
+    public class USSAnimationDriver : IUITKAnimationDriver
+    {
+        public async UniTask Play(VisualElement target, UITKAnimationType type, bool isShow, int durationMs)
+        {
+            if (type == UITKAnimationType.None || target == null)
+                return;
+
+            // 1. 设置初始状态（无过渡）
+            SetTransitionDuration(target, 0);
+            ApplyState(target, type, isStart: true, isShow);
+
+            await UniTask.Yield();
+
+            // 2. 设置过渡 + 目标状态
+            SetTransitionDuration(target, durationMs);
+            ApplyState(target, type, isStart: false, isShow);
+
+            // 3. 等待过渡完成
+            await UniTask.Delay(durationMs);
+        }
+
+        private void SetTransitionDuration(VisualElement target, int ms)
+        {
+            target.style.transitionDuration = new List<TimeValue> { new TimeValue(ms, TimeUnit.Millisecond) };
+            target.style.transitionProperty = new List<StylePropertyName>
+            {
+                new StylePropertyName("opacity"),
+                new StylePropertyName("translate"),
+                new StylePropertyName("scale"),
+            };
+            target.style.transitionTimingFunction = new List<EasingFunction> { new EasingFunction(EasingMode.EaseOutCubic) };
+        }
+
+        private void ApplyState(VisualElement target, UITKAnimationType type, bool isStart, bool isShow)
+        {
+            bool atOrigin = isShow ? isStart : !isStart;
+
+            switch (type)
+            {
+                case UITKAnimationType.FadeIn:
+                case UITKAnimationType.FadeOut:
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.SlideFromBottom:
+                case UITKAnimationType.SlideToBottom:
+                    target.style.translate = atOrigin
+                        ? new Translate(0, Length.Percent(100))
+                        : new Translate(0, 0);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.SlideFromRight:
+                case UITKAnimationType.SlideToRight:
+                    target.style.translate = atOrigin
+                        ? new Translate(Length.Percent(100), 0)
+                        : new Translate(0, 0);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.ScaleIn:
+                case UITKAnimationType.ScaleOut:
+                    target.style.scale = atOrigin
+                        ? new Scale(new Vector3(0.8f, 0.8f, 1f))
+                        : new Scale(Vector3.one);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs.meta
new file mode 100644
index 0000000000..7059f49fcf
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 49e224e01d7964bd5af1791d369ee85a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base.meta
new file mode 100644
index 0000000000..7d5466a566
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 40302da1264f340e3b18920e05fd9124
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs
new file mode 100644
index 0000000000..ef347cb95b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs
@@ -0,0 +1,308 @@
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit UI 基类。
+    /// </summary>
+    public class UITKBase
+    {
+        /// <summary>
+        /// 依赖注入回调。
+        /// </summary>
+        public static Action<UITKBase> Injector;
+
+        public enum UIType { None, Window, Widget }
+
+        /// <summary>
+        /// 父 UI 节点。
+        /// </summary>
+        protected UITKBase _parent;
+        public UITKBase Parent => _parent;
+
+        /// <summary>
+        /// 自定义数据集。
+        /// </summary>
+        protected object[] _userDatas;
+        public object UserData => _userDatas is { Length: >= 1 } ? _userDatas[0] : null;
+        public object[] UserDatas => _userDatas;
+
+        /// <summary>
+        /// 根 VisualElement。
+        /// </summary>
+        public virtual VisualElement RootElement { get; protected set; }
+
+        /// <summary>
+        /// UI 类型。
+        /// </summary>
+        public virtual UIType Type => UIType.None;
+
+        /// <summary>
+        /// 资源是否加载完毕。
+        /// </summary>
+        public bool IsPrepare { get; protected set; }
+
+        /// <summary>
+        /// 子 Widget 列表。
+        /// </summary>
+        internal readonly List<UITKWidget> ListChild = new List<UITKWidget>();
+
+        /// <summary>
+        /// 有 Update 行为的子 Widget 列表。
+        /// </summary>
+        protected List<UITKWidget> _listUpdateChild;
+
+        /// <summary>
+        /// Update 列表是否有效。
+        /// </summary>
+        protected bool _updateListValid = false;
+
+        /// <summary>
+        /// 是否需要 Update。
+        /// </summary>
+        internal bool _hasOverrideUpdate = true;
+
+        // ━━━ 生命周期钩子 ━━━
+
+        protected virtual void OnCreate() { }
+        protected virtual void OnRefresh() { }
+        protected virtual void OnUpdate() { _hasOverrideUpdate = false; }
+        protected virtual void OnDestroy() { }
+        protected virtual void OnSetVisible(bool visible) { }
+        protected virtual void OnSortDepth() { }
+
+        // ━━━ 自动绑定钩子（由 Editor 生成工具 override）━━━
+
+        /// <summary>
+        /// 自动绑定 UI 元素。由 .bindgen.cs 重写。
+        /// </summary>
+        protected virtual void __UITKAutoBind(UnityEngine.UIElements.VisualElement root) { }
+
+        /// <summary>
+        /// 自动绑定事件。由 .bindgen.cs 重写。
+        /// </summary>
+        protected virtual void __UITKAutoBindEvents() { }
+
+        /// <summary>
+        /// 自动解绑事件。由 .bindgen.cs 重写。
+        /// </summary>
+        protected virtual void __UITKAutoUnbindEvents() { }
+
+        /// <summary>
+        /// 依赖注入。
+        /// </summary>
+        protected void Inject()
+        {
+            Injector?.Invoke(this);
+        }
+
+        /// <summary>
+        /// 注册事件（子类重写）。
+        /// </summary>
+        protected virtual void RegisterEvent() { }
+
+        internal void SetUpdateDirty()
+        {
+            _updateListValid = false;
+            Parent?.SetUpdateDirty();
+        }
+
+        internal void CallDestroy()
+        {
+            OnDestroy();
+        }
+
+        // ━━━ 事件系统 ━━━
+
+        private GameEventMgr _eventMgr;
+
+        protected GameEventMgr EventMgr
+        {
+            get
+            {
+                if (_eventMgr == null)
+                {
+                    _eventMgr = MemoryPool.Acquire<GameEventMgr>();
+                }
+                return _eventMgr;
+            }
+        }
+
+        public void AddUIEvent(int eventType, Action handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T>(int eventType, Action<T> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U>(int eventType, Action<T, U> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U, V>(int eventType, Action<T, U, V> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U, V, W>(int eventType, Action<T, U, V, W> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void RemoveAllUIEvent()
+        {
+            if (_eventMgr != null)
+            {
+                MemoryPool.Release(_eventMgr);
+                _eventMgr = null;
+            }
+        }
+
+        // ━━━ Widget 工厂方法 ━━━
+
+        /// <summary>
+        /// 通过父节点上已有的子元素创建 Widget（同步，元素已存在）。
+        /// </summary>
+        public T CreateWidget<T>(VisualElement widgetRoot, bool visible = true) where T : UITKWidget, new()
+        {
+            var widget = new T();
+            if (widget.Create(this, widgetRoot, visible))
+            {
+                return widget;
+            }
+            return null;
+        }
+
+        /// <summary>
+        /// 通过资源路径异步创建 Widget。
+        /// </summary>
+        public async UniTask<T> CreateWidgetAsync<T>(VisualElement parentElement, string assetLocation = null, bool visible = true) where T : UITKWidget, new()
+        {
+            string location = assetLocation ?? typeof(T).Name;
+            var widget = new T();
+            bool ok = await widget.CreateByPath(this, parentElement, location, visible);
+            return ok ? widget : null;
+        }
+
+        /// <summary>
+        /// 通过类型名创建 Widget（资源名 = 类名）。
+        /// </summary>
+        public async UniTask<T> CreateWidgetByTypeAsync<T>(VisualElement parentElement, bool visible = true) where T : UITKWidget, new()
+        {
+            return await CreateWidgetAsync<T>(parentElement, typeof(T).Name, visible);
+        }
+
+        // ━━━ MVVM 绑定支持 ━━━
+
+        private List<Action> _unbindActions;
+
+        /// <summary>
+        /// 自动绑定 ViewModel。由 .bindgen.cs 重写，框架在 OnCreate 后自动调用。
+        /// 生成代码直接读取本类的 ViewModel 字段并调用下方 Bind* helper。
+        /// </summary>
+        protected virtual void __UITKAutoBindMVVM() { }
+
+        /// <summary>
+        /// 解绑所有 MVVM 订阅。框架在 OnDestroy 前自动调用。
+        /// 由于 Bind* helper 登记的是同一委托实例，-= 可正确移除，无泄漏。
+        /// </summary>
+        protected virtual void __UITKAutoUnbindMVVM()
+        {
+            if (_unbindActions != null)
+            {
+                for (int i = 0; i < _unbindActions.Count; i++) _unbindActions[i]();
+                _unbindActions.Clear();
+            }
+        }
+
+        // ━━━ Bind* 运行时绑定 helper（订阅/解绑使用同一委托实例，杜绝 lambda -= 泄漏）━━━
+
+        /// <summary>
+        /// OneWay：BindableProperty → Label.text。toText 为 null 时用 ToString。
+        /// </summary>
+        protected void BindLabel<TSource>(Label label, BindableProperty<TSource> prop, Func<TSource, string> toText = null)
+        {
+            if (label == null || prop == null) return;
+            _unbindActions ??= new List<Action>();
+
+            Action<TSource> handler = v => label.text = toText != null ? toText(v) : v?.ToString() ?? "";
+            prop.OnValueChanged += handler;
+            handler(prop.Value); // 初始同步
+            _unbindActions.Add(() => prop.OnValueChanged -= handler);
+        }
+
+        /// <summary>
+        /// 字段同类型绑定（TextField/Slider/Toggle…），mode 控制方向。
+        /// </summary>
+        protected void BindField<TValue>(INotifyValueChanged<TValue> field, BindableProperty<TValue> prop, BindingMode mode = BindingMode.TwoWay)
+        {
+            if (field == null || prop == null) return;
+            _unbindActions ??= new List<Action>();
+
+            if (mode != BindingMode.OneWayToSource)
+            {
+                Action<TValue> toView = v => field.SetValueWithoutNotify(v);
+                prop.OnValueChanged += toView;
+                field.SetValueWithoutNotify(prop.Value); // 初始同步
+                _unbindActions.Add(() => prop.OnValueChanged -= toView);
+            }
+            if (mode != BindingMode.OneWay)
+            {
+                EventCallback<ChangeEvent<TValue>> toSource = evt => prop.Value = evt.newValue;
+                field.RegisterValueChangedCallback(toSource);
+                _unbindActions.Add(() => field.UnregisterValueChangedCallback(toSource));
+            }
+        }
+
+        /// <summary>
+        /// 字段异类型绑定（VM 类型 TSource ↔ 控件类型 TTarget，经 IValueConverter 转换）。
+        /// </summary>
+        protected void BindField<TSource, TTarget>(INotifyValueChanged<TTarget> field, BindableProperty<TSource> prop, IValueConverter<TSource, TTarget> conv, BindingMode mode = BindingMode.TwoWay)
+        {
+            if (field == null || prop == null || conv == null) return;
+            _unbindActions ??= new List<Action>();
+
+            if (mode != BindingMode.OneWayToSource)
+            {
+                Action<TSource> toView = v => field.SetValueWithoutNotify(conv.Convert(v));
+                prop.OnValueChanged += toView;
+                field.SetValueWithoutNotify(conv.Convert(prop.Value)); // 初始同步
+                _unbindActions.Add(() => prop.OnValueChanged -= toView);
+            }
+            if (mode != BindingMode.OneWay)
+            {
+                EventCallback<ChangeEvent<TTarget>> toSource = evt => prop.Value = conv.ConvertBack(evt.newValue);
+                field.RegisterValueChangedCallback(toSource);
+                _unbindActions.Add(() => field.UnregisterValueChangedCallback(toSource));
+            }
+        }
+
+        /// <summary>
+        /// 命令绑定：Button.clicked → Execute；CanExecuteChanged → SetEnabled。
+        /// </summary>
+        protected void BindCommand(Button button, BindableCommand command)
+        {
+            if (button == null || command == null) return;
+            _unbindActions ??= new List<Action>();
+
+            Action exec = command.Execute;
+            Action canExec = () => button.SetEnabled(command.CanExecute());
+            button.clicked += exec;
+            command.CanExecuteChanged += canExec;
+            button.SetEnabled(command.CanExecute()); // 初始状态
+            _unbindActions.Add(() =>
+            {
+                button.clicked -= exec;
+                command.CanExecuteChanged -= canExec;
+            });
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs.meta
new file mode 100644
index 0000000000..f0c764cee2
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 145fd6737748649d181a8b95bbc89ae2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs
new file mode 100644
index 0000000000..2bf661693b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs
@@ -0,0 +1,186 @@
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit Widget 组件基类。独立 UXML，有完整生命周期。
+    /// </summary>
+    public class UITKWidget : UITKBase
+    {
+        public override UIType Type => UIType.Widget;
+
+        private VisualTreeAsset _widgetAsset;
+        private bool _fromResource;
+        private bool _isDestroyed;
+
+        /// <summary>
+        /// 获取所属 Window（向上遍历）。
+        /// </summary>
+        public UITKWindow OwnerWindow
+        {
+            get
+            {
+                var current = _parent;
+                while (current != null)
+                {
+                    if (current.Type == UIType.Window)
+                        return current as UITKWindow;
+                    current = current.Parent;
+                }
+                return null;
+            }
+        }
+
+        // ━━━ 列表虚拟化支持 ━━━
+
+        /// <summary>
+        /// ListView 虚拟化绑定数据。
+        /// </summary>
+        public virtual void OnBindData(object data, int index) { }
+
+        /// <summary>
+        /// ListView 虚拟化解绑数据。
+        /// </summary>
+        public virtual void OnUnbindData() { }
+
+        // ━━━ 创建路径 ━━━
+
+        /// <summary>
+        /// 通过已存在的 VisualElement 创建（同步）。
+        /// </summary>
+        internal bool Create(UITKBase parent, VisualElement widgetRoot, bool visible)
+        {
+            _parent = parent;
+            RootElement = widgetRoot;
+
+            if (RootElement == null)
+            {
+                Log.Error($"UITKWidget Create failed: widgetRoot is null for {GetType().Name}");
+                return false;
+            }
+
+            InitWidget(visible);
+            return true;
+        }
+
+        /// <summary>
+        /// 通过资源路径异步创建。加载失败返回 false。
+        /// </summary>
+        internal async UniTask<bool> CreateByPath(UITKBase parent, VisualElement parentElement, string location, bool visible)
+        {
+            _parent = parent;
+
+            try
+            {
+                _widgetAsset = await UITKModule.Resource.LoadVisualTreeAssetAsync(location);
+            }
+            catch (System.Exception e)
+            {
+                Log.Error($"UITKWidget CreateByPath 异常: {GetType().Name} ({location})\n{e}");
+                _widgetAsset = null;
+            }
+
+            if (_widgetAsset == null)
+            {
+                Log.Error($"UITKWidget CreateByPath 资源加载失败: {GetType().Name} ({location})");
+                return false;
+            }
+
+            RootElement = _widgetAsset.CloneTree();
+            parentElement.Add(RootElement);
+
+            InitWidget(visible);
+            return true;
+        }
+
+        /// <summary>
+        /// 通过 Resources 同步创建。
+        /// </summary>
+        internal bool CreateFromResources(UITKBase parent, VisualElement parentElement, string location, bool visible)
+        {
+            _parent = parent;
+            _fromResource = true;
+
+            _widgetAsset = UnityEngine.Resources.Load<VisualTreeAsset>(location);
+            if (_widgetAsset == null)
+            {
+                Log.Error($"UITKWidget CreateFromResources failed: {location} not found");
+                return false;
+            }
+
+            RootElement = _widgetAsset.CloneTree();
+            parentElement.Add(RootElement);
+
+            InitWidget(visible);
+            return true;
+        }
+
+        private void InitWidget(bool visible)
+        {
+            _parent.ListChild.Add(this);
+            _parent.SetUpdateDirty();
+
+            __UITKAutoBind(RootElement);  // 自动绑定 UI 元素
+            __UITKAutoBindEvents();       // 自动绑定事件
+            Inject();
+            OnCreate();                   // 用户在此构造 ViewModel
+            RegisterEvent();
+            __UITKAutoBindMVVM();         // MVVM 自动绑定（OnCreate 后，VM 已就绪）
+            OnRefresh();
+
+            IsPrepare = true;
+
+            if (!visible)
+            {
+                RootElement.style.display = DisplayStyle.None;
+            }
+        }
+
+        // ━━━ 销毁 ━━━
+
+        /// <summary>
+        /// 销毁 Widget。
+        /// </summary>
+        public void Destroy()
+        {
+            _parent?.ListChild.Remove(this);
+            _parent?.SetUpdateDirty();
+            InternalDestroy();
+        }
+
+        internal void InternalDestroy()
+        {
+            if (_isDestroyed) return;  // 幂等：防止重复销毁
+            _isDestroyed = true;
+
+            __UITKAutoUnbindMVVM();       // 先解绑 MVVM（VM 仍存活）
+            OnDestroy();
+            __UITKAutoUnbindEvents();     // 自动解绑事件
+            RemoveAllUIEvent();
+
+            for (int i = ListChild.Count - 1; i >= 0; i--)
+            {
+                ListChild[i].Destroy();
+            }
+            ListChild.Clear();
+
+            RootElement?.RemoveFromHierarchy();
+
+            if (_widgetAsset != null && !_fromResource)
+            {
+                UITKModule.Resource.Unload(_widgetAsset);
+                _widgetAsset = null;
+            }
+        }
+
+        // ━━━ Update ━━━
+
+        internal void InternalUpdate()
+        {
+            if (!IsPrepare) return;
+            OnUpdate();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs.meta
new file mode 100644
index 0000000000..110ade328f
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5add0e365eb8b40f8bfc21880f4e9c90
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs
new file mode 100644
index 0000000000..de0e4e6b78
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs
@@ -0,0 +1,273 @@
+using System;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 窗口基类。
+    /// </summary>
+    public abstract class UITKWindow : UITKBase
+    {
+        public override UIType Type => UIType.Window;
+        public string WindowName { get; private set; }
+        public int WindowLayer { get; private set; }
+        public string AssetName { get; private set; }
+        public virtual bool FullScreen { get; private set; }
+        public bool FromResources { get; private set; }
+        public int HideTimeToClose { get; set; }
+        public string Package { get; private set; }
+        public int HideTimerId { get; set; }
+        public bool IsLoadDone { get; private set; }
+        public bool IsHide { get; set; }
+
+        /// <summary>
+        /// 是否正在执行关闭动画。用于防止动画期间重复关闭。
+        /// </summary>
+        public bool IsClosing { get; internal set; }
+
+        private bool _isCreate;
+        private bool _isDestroyed;
+        private VisualTreeAsset _visualTreeAsset;
+        private Action<UITKWindow> _prepareCallback;
+
+        // ━━━ 动画配置 ━━━
+
+        protected virtual UITKAnimationType ShowAnimation => UITKAnimationType.FadeIn;
+        protected virtual UITKAnimationType HideAnimation => UITKAnimationType.FadeOut;
+        protected virtual int AnimationDuration => 200;
+
+        internal virtual UniTask OnShowAnimation()
+        {
+            return UITKModule.Instance.AnimationDriver.Play(RootElement, ShowAnimation, true, AnimationDuration);
+        }
+
+        internal virtual UniTask OnHideAnimation()
+        {
+            return UITKModule.Instance.AnimationDriver.Play(RootElement, HideAnimation, false, AnimationDuration);
+        }
+
+        // ━━━ 可见性 ━━━
+
+        private bool _visible;
+        public bool Visible
+        {
+            get => _visible;
+            set
+            {
+                if (_visible == value) return;
+                _visible = value;
+                if (RootElement != null)
+                {
+                    RootElement.style.display = value ? DisplayStyle.Flex : DisplayStyle.None;
+                    RootElement.pickingMode = value ? PickingMode.Position : PickingMode.Ignore;
+                }
+                if (_isCreate)
+                {
+                    OnSetVisible(value);
+                }
+            }
+        }
+
+        // ━━━ 初始化 ━━━
+
+        internal void Init(string windowName, int windowLayer, bool fullScreen, string assetName, bool fromResources, int hideTimeToClose, string package)
+        {
+            WindowName = windowName;
+            WindowLayer = windowLayer;
+            FullScreen = fullScreen;
+            AssetName = assetName;
+            FromResources = fromResources;
+            HideTimeToClose = hideTimeToClose;
+            Package = package;
+        }
+
+        // ━━━ 加载流程 ━━━
+
+        internal async UniTaskVoid InternalLoad(string assetName, Action<UITKWindow> prepareCallback, bool isAsync, params object[] userDatas)
+        {
+            _prepareCallback = prepareCallback;
+            _userDatas = userDatas;
+
+            try
+            {
+                if (FromResources)
+                {
+                    _visualTreeAsset = Resources.Load<VisualTreeAsset>(assetName);
+                }
+                else if (isAsync)
+                {
+                    _visualTreeAsset = await UITKModule.Resource.LoadVisualTreeAssetAsync(assetName, default, Package);
+                }
+                else
+                {
+                    _visualTreeAsset = UITKModule.Resource.LoadVisualTreeAsset(assetName, Package);
+                }
+            }
+            catch (Exception e)
+            {
+                Log.Error($"UITKWindow 资源加载异常: {WindowName} ({assetName})\n{e}");
+                _visualTreeAsset = null;
+            }
+
+            HandleLoadCompleted();
+        }
+
+        private void HandleLoadCompleted()
+        {
+            IsLoadDone = true;
+
+            // 加载失败：弹栈回滚，避免窗口卡死在栈中
+            if (_visualTreeAsset == null)
+            {
+                Log.Error($"UITKWindow 资源加载失败: {WindowName} ({AssetName})");
+                if (!_isDestroyed)
+                {
+                    UITKModule.Instance.OnWindowLoadFailed(this);
+                }
+                return;
+            }
+
+            if (_isDestroyed)
+            {
+                ReleaseAsset();
+                return;
+            }
+
+            RootElement = _visualTreeAsset.CloneTree();
+            RootElement.name = WindowName;
+            RootElement.style.flexGrow = 1;
+            RootElement.style.position = Position.Absolute;
+            RootElement.style.left = 0;
+            RootElement.style.right = 0;
+            RootElement.style.top = 0;
+            RootElement.style.bottom = 0;
+
+            UITKModule.Instance.AttachToLayer(this);
+
+            IsPrepare = true;
+            _prepareCallback?.Invoke(this);
+        }
+
+        // ━━━ 生命周期内部方法 ━━━
+
+        internal void InternalCreate()
+        {
+            if (_isCreate) return;
+            _isCreate = true;
+            __UITKAutoBind(RootElement);  // 自动绑定 UI 元素
+            __UITKAutoBindEvents();       // 自动绑定事件
+            Inject();
+            OnCreate();                   // 用户在此构造 ViewModel
+            RegisterEvent();
+            __UITKAutoBindMVVM();         // MVVM 自动绑定（OnCreate 后，VM 已就绪）
+        }
+
+        internal void InternalRefresh()
+        {
+            OnRefresh();
+        }
+
+        internal void InternalUpdate()
+        {
+            if (!IsPrepare || !_visible) return;
+
+            OnUpdate();
+
+            if (ListChild.Count > 0)
+            {
+                if (!_updateListValid)
+                {
+                    _listUpdateChild ??= new();
+                    _listUpdateChild.Clear();
+                    for (int i = 0; i < ListChild.Count; i++)
+                    {
+                        if (ListChild[i]._hasOverrideUpdate)
+                        {
+                            _listUpdateChild.Add(ListChild[i]);
+                        }
+                    }
+                    _updateListValid = true;
+                }
+
+                if (_listUpdateChild != null)
+                {
+                    for (int i = 0; i < _listUpdateChild.Count; i++)
+                    {
+                        _listUpdateChild[i].InternalUpdate();
+                    }
+                }
+            }
+        }
+
+        internal void InternalDestroy(bool isShutDown = false)
+        {
+            if (_isDestroyed) return;  // 幂等：防止动画期间/重复关闭导致二次销毁
+            _isDestroyed = true;
+
+            if (!isShutDown)
+            {
+                CancelHideToCloseTimer();
+            }
+
+            // 仅对「已创建」的窗口执行用户回调与解绑；
+            // 加载未完成即关闭时 _isCreate 为 false，跳过避免对未初始化窗口跑用户代码导致 NPE。
+            if (_isCreate)
+            {
+                __UITKAutoUnbindMVVM();   // 先解绑 MVVM（VM 仍存活），再交给用户 OnDestroy 处理 Dispose
+                OnDestroy();
+                __UITKAutoUnbindEvents(); // 自动解绑事件
+                RemoveAllUIEvent();
+
+                for (int i = ListChild.Count - 1; i >= 0; i--)
+                {
+                    ListChild[i].Destroy();
+                }
+                ListChild.Clear();
+            }
+
+            RootElement?.RemoveFromHierarchy();
+            ReleaseAsset();
+        }
+
+        internal void CancelHideToCloseTimer()
+        {
+            if (HideTimerId > 0)
+            {
+                GameModule.Timer.RemoveTimer(HideTimerId);
+                HideTimerId = 0;
+            }
+        }
+
+        private void ReleaseAsset()
+        {
+            if (_visualTreeAsset != null && !FromResources)
+            {
+                UITKModule.Resource.Unload(_visualTreeAsset);
+                _visualTreeAsset = null;
+            }
+        }
+
+        // ━━━ TryInvoke (重新 Show 已存在窗口) ━━━
+
+        internal void TryInvoke(Action<UITKWindow> prepareCallback, params object[] userDatas)
+        {
+            CancelHideToCloseTimer();
+            IsHide = false;
+            IsClosing = false;
+            RootElement?.SetEnabled(true); // 复位隐藏动画期间的输入屏蔽
+            _userDatas = userDatas;
+
+            if (IsPrepare)
+            {
+                prepareCallback?.Invoke(this);
+            }
+            else
+            {
+                _prepareCallback = prepareCallback;
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs.meta
new file mode 100644
index 0000000000..8a40d2087f
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a95d975df73a84a55b3f0a66674d9258
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs
new file mode 100644
index 0000000000..b7259560ee
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs
@@ -0,0 +1,52 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 窗口声明特性。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+    public class UIWindowAttribute : Attribute
+    {
+        /// <summary>
+        /// 窗口层级。
+        /// </summary>
+        public UILayer Layer { get; }
+
+        /// <summary>
+        /// 资源定位地址。空则使用类名。
+        /// </summary>
+        public string Location { get; set; } = "";
+
+        /// <summary>
+        /// 是否全屏窗口（用于遮挡下层）。
+        /// </summary>
+        public bool FullScreen { get; set; } = false;
+
+        /// <summary>
+        /// 是否从 Resources 加载（不走 AB）。
+        /// </summary>
+        public bool FromResources { get; set; } = false;
+
+        /// <summary>
+        /// 隐藏后自动关闭时间（秒）。0 表示立即关闭。
+        /// </summary>
+        public int HideTimeToClose { get; set; } = 10;
+
+        /// <summary>
+        /// YooAsset 资源包名。空则使用默认包。
+        /// </summary>
+        public string Package { get; set; } = "";
+
+        public UIWindowAttribute(UILayer layer)
+        {
+            Layer = layer;
+        }
+
+        public UIWindowAttribute(UILayer layer, bool fullScreen)
+        {
+            Layer = layer;
+            FullScreen = fullScreen;
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs.meta
new file mode 100644
index 0000000000..520ea1ba94
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f53ae030371c14e318d07450ed8f5ebc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding.meta
new file mode 100644
index 0000000000..a29b5d75f8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 835ecf29f1e764454951de51c904cadf
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs
new file mode 100644
index 0000000000..a3e2e8de31
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs
@@ -0,0 +1,24 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// MVVM 数据绑定标记。将 UI 元素绑定到 ViewModel 属性。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
+    public class BindAttribute : Attribute
+    {
+        public string Path { get; }
+        public BindingMode Mode { get; }
+        public string Format { get; }
+        public Type Converter { get; }
+
+        public BindAttribute(string path, BindingMode mode = BindingMode.OneWay, string format = null, Type converter = null)
+        {
+            Path = path;
+            Mode = mode;
+            Format = format;
+            Converter = converter;
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs.meta
new file mode 100644
index 0000000000..3b717a8301
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3091643933e8e4c45b3a919eb84c89b5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs
new file mode 100644
index 0000000000..0bf17f2a3d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs
@@ -0,0 +1,14 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 命令绑定标记。将按钮绑定到 ViewModel 的 BindableCommand。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
+    public class BindCommandAttribute : Attribute
+    {
+        public string CommandName { get; }
+        public BindCommandAttribute(string commandName) => CommandName = commandName;
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs.meta
new file mode 100644
index 0000000000..d16ec2b38e
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindCommandAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a893065f0d540487098fc3a21c197b13
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs
new file mode 100644
index 0000000000..634e9296df
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs
@@ -0,0 +1,15 @@
+namespace GameLogic
+{
+    /// <summary>
+    /// 数据绑定方向。
+    /// </summary>
+    public enum BindingMode
+    {
+        /// <summary>ViewModel → View</summary>
+        OneWay,
+        /// <summary>ViewModel ↔ View</summary>
+        TwoWay,
+        /// <summary>View → ViewModel</summary>
+        OneWayToSource,
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs.meta
new file mode 100644
index 0000000000..61f04a0f25
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/BindingMode.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7425fc5cd664e4333bb8eba4117d3e04
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs
new file mode 100644
index 0000000000..128076f46f
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs
@@ -0,0 +1,14 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 值变化事件绑定标记。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Method)]
+    public class OnChangeAttribute : Attribute
+    {
+        public string Target { get; }
+        public OnChangeAttribute(string target) => Target = target;
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs.meta
new file mode 100644
index 0000000000..a0915f4bee
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnChangeAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9b09de7f0979b44108415d556c8beb6a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs
new file mode 100644
index 0000000000..3c48b9c438
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs
@@ -0,0 +1,17 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 点击事件绑定标记。方法名自动推导目标元素。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Method)]
+    public class OnClickAttribute : Attribute
+    {
+        /// <summary>目标元素名。null 则从方法名推导。</summary>
+        public string Target { get; }
+
+        public OnClickAttribute() { }
+        public OnClickAttribute(string target) => Target = target;
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs.meta
new file mode 100644
index 0000000000..a905969220
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/OnClickAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0480b477988384ce7ba6f6e09a92f638
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs
new file mode 100644
index 0000000000..46eafe3d1d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs
@@ -0,0 +1,15 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 元素查询绑定标记。字段名自动转为 kebab-case 匹配 UXML name。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property)]
+    public class QAttribute : Attribute
+    {
+        public string Name { get; }
+        public QAttribute() { }
+        public QAttribute(string name) => Name = name;
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs.meta
new file mode 100644
index 0000000000..c3bd964d6d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Binding/QAttribute.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e790d60898b114beabe780ce363fce2e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core.meta
new file mode 100644
index 0000000000..016557f26c
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 2a9d7ee5c0c334d16902734dbe733691
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs
new file mode 100644
index 0000000000..ade15f9efc
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs
@@ -0,0 +1,17 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 按钮点击音效处理器接口。
+    /// 业务层实现此接口，根据 button.name 或 class 决定播放什么音效。
+    /// </summary>
+    public interface IUITKClickSoundHandler
+    {
+        /// <summary>
+        /// 当按钮被点击时调用。业务层自行决定音效策略。
+        /// </summary>
+        /// <param name="button">被点击的按钮。</param>
+        void OnButtonClick(Button button);
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs.meta
new file mode 100644
index 0000000000..e19ac4dac1
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/IUITKClickSoundHandler.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9de701da8c7b24c2baa4f4bde8072b42
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs
new file mode 100644
index 0000000000..8d16b9c852
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs
@@ -0,0 +1,60 @@
+using Cysharp.Threading.Tasks;
+
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        public async UniTask CloseUIWithAnimation<T>() where T : UITKWindow
+        {
+            string windowName = typeof(T).FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null || window.IsClosing) return;
+
+            window.IsClosing = true;
+            window.RootElement?.SetEnabled(false); // 动画期间屏蔽输入，避免二次触发
+
+            await window.OnHideAnimation();
+
+            // 动画期间窗口可能被重新 Show（TryInvoke 会把 IsClosing 复位为 false），
+            // 此时不能再销毁，否则会销毁刚显示出来的窗口。
+            if (!window.IsClosing) return;
+
+            window.InternalDestroy();
+            Pop(window);
+            OnSetWindowVisible();
+        }
+
+        public async UniTask HideUIWithAnimation<T>() where T : UITKWindow
+        {
+            string windowName = typeof(T).FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null || window.IsClosing) return;
+
+            if (window.HideTimeToClose <= 0)
+            {
+                await CloseUIWithAnimation<T>();
+                return;
+            }
+
+            window.IsClosing = true;
+            window.RootElement?.SetEnabled(false);
+
+            await window.OnHideAnimation();
+
+            // 动画期间被重新 Show（IsClosing 复位）则中止隐藏，避免把刚显示的窗口又隐藏并挂上关闭定时器。
+            if (!window.IsClosing) return;
+
+            window.Visible = false;
+            window.IsHide = true;
+            window.HideTimerId = GameModule.Timer.AddTimer((arg) =>
+            {
+                CloseUI(typeof(T));
+            }, window.HideTimeToClose);
+
+            if (window.FullScreen)
+            {
+                OnSetWindowVisible();
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs.meta
new file mode 100644
index 0000000000..1ad7477c3e
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1c19c5784b6a8401983a114e3db1cc62
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs
new file mode 100644
index 0000000000..55ea3deb48
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs
@@ -0,0 +1,102 @@
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        private const int LAYER_COUNT = 5;
+        private const int LAYER_SORT_INTERVAL = 2000;
+
+        private GameObject _uiTKRoot;
+        private UIDocument[] _layerDocuments = new UIDocument[LAYER_COUNT];
+        private VisualElement[] _layerRoots = new VisualElement[LAYER_COUNT];
+
+        private static readonly string[] LayerNames = { "Panel_Bottom", "Panel_UI", "Panel_Top", "Panel_Tips", "Panel_System" };
+
+        private const string DEFAULT_PANEL_SETTINGS = "DefaultPanelSettings";
+
+        private void InitPanels()
+        {
+            _uiTKRoot = new GameObject("UITKRoot");
+            Object.DontDestroyOnLoad(_uiTKRoot);
+
+            // 加载 PanelSettings 资产
+            PanelSettings panelSettings = Resource.LoadPanelSettings(DEFAULT_PANEL_SETTINGS);
+            if (panelSettings == null)
+            {
+                Log.Error("UITKModule: Failed to load PanelSettings, trying Resources fallback.");
+                panelSettings = Resources.Load<PanelSettings>(DEFAULT_PANEL_SETTINGS);
+            }
+
+            for (int i = 0; i < LAYER_COUNT; i++)
+            {
+                var panelGo = new GameObject(LayerNames[i]);
+                panelGo.transform.SetParent(_uiTKRoot.transform);
+
+                var doc = panelGo.AddComponent<UIDocument>();
+                doc.panelSettings = panelSettings;
+                doc.sortingOrder = i * LAYER_SORT_INTERVAL;
+
+                _layerDocuments[i] = doc;
+                _layerRoots[i] = doc.rootVisualElement;
+
+                // 统一按钮点击音效拦截（冒泡阶段）
+                _layerRoots[i].RegisterCallback<ClickEvent>(OnGlobalClick);
+            }
+        }
+
+        /// <summary>
+        /// 全局点击事件拦截。所有 Button 点击统一触发音效处理器。
+        /// </summary>
+        private void OnGlobalClick(ClickEvent evt)
+        {
+            if (ClickSoundHandler == null) return;
+            if (evt.target is not Button button) return;
+
+            // 带 no-sound class 的按钮跳过
+            if (button.ClassListContains("no-sound")) return;
+
+            ClickSoundHandler.OnButtonClick(button);
+        }
+
+        private void DestroyPanels()
+        {
+            if (_uiTKRoot != null)
+            {
+                Object.Destroy(_uiTKRoot);
+                _uiTKRoot = null;
+            }
+        }
+
+        internal void AttachToLayer(UITKWindow window)
+        {
+            int layer = window.WindowLayer;
+            if (layer < 0 || layer >= LAYER_COUNT)
+            {
+                Log.Error($"UITKModule: Invalid window layer {layer} for {window.WindowName}");
+                layer = (int)UILayer.UI;
+            }
+            _layerRoots[layer].Add(window.RootElement);
+        }
+
+        /// <summary>
+        /// 按窗口栈顺序重排各层 VisualElement，使同层渲染顺序与栈序一致。
+        /// AttachToLayer 仅在加载时 Add 一次，重新 Show（Pop+Push）后需调用本方法对齐 z-order。
+        /// </summary>
+        internal void ReorderLayers()
+        {
+            // _windowStack 已按层级升序、同层按入栈顺序排列；
+            // 依次 BringToFront 后，各层父节点内的子元素顺序即与栈序一致。
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                UITKWindow window = _windowStack[i];
+                if (window.IsPrepare && window.RootElement != null)
+                {
+                    window.RootElement.BringToFront();
+                }
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs.meta
new file mode 100644
index 0000000000..b27d77dbbc
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: aff6253c086df439ba6d15bbab748904
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs
new file mode 100644
index 0000000000..7487ebb1c8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs
@@ -0,0 +1,92 @@
+using Cysharp.Threading.Tasks;
+
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        private UITKWindow GetWindow(string windowName)
+        {
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (_windowStack[i].WindowName == windowName)
+                    return _windowStack[i];
+            }
+            return null;
+        }
+
+        private void Push(UITKWindow window)
+        {
+            int insertIndex = -1;
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (window.WindowLayer == _windowStack[i].WindowLayer)
+                {
+                    insertIndex = i + 1;
+                }
+            }
+
+            if (insertIndex == -1)
+            {
+                for (int i = 0; i < _windowStack.Count; i++)
+                {
+                    if (window.WindowLayer > _windowStack[i].WindowLayer)
+                    {
+                        insertIndex = i + 1;
+                    }
+                }
+            }
+
+            if (insertIndex == -1)
+            {
+                insertIndex = 0;
+            }
+
+            _windowStack.Insert(insertIndex, window);
+        }
+
+        private void Pop(UITKWindow window)
+        {
+            _windowStack.Remove(window);
+        }
+
+        /// <summary>
+        /// 窗口资源加载失败时回滚：弹栈并刷新可见性，避免卡死在栈中。
+        /// </summary>
+        internal void OnWindowLoadFailed(UITKWindow window)
+        {
+            Pop(window);
+            OnSetWindowVisible();
+        }
+
+        private void OnWindowPrepare(UITKWindow window)
+        {
+            window.InternalCreate();
+            window.InternalRefresh();
+            OnSetWindowVisible();
+            ReorderLayers();
+            window.OnShowAnimation().Forget();
+        }
+
+        private void OnSetWindowVisible()
+        {
+            bool isHideNext = false;
+            for (int i = _windowStack.Count - 1; i >= 0; i--)
+            {
+                UITKWindow window = _windowStack[i];
+                if (!isHideNext)
+                {
+                    if (window.IsHide) continue;
+                    window.Visible = true;
+                    if (window.IsPrepare && window.FullScreen)
+                    {
+                        isHideNext = true;
+                    }
+                }
+                else
+                {
+                    window.Visible = false;
+                }
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs.meta
new file mode 100644
index 0000000000..1701ac43e7
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b1f1b95da969545b585136a45a16766b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs
new file mode 100644
index 0000000000..cf9bcad6d1
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs
@@ -0,0 +1,249 @@
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 管理模块。
+    /// </summary>
+    public sealed partial class UITKModule : Singleton<UITKModule>, IUpdate
+    {
+        public static IUITKResourceLoader Resource { get; private set; }
+        public IUITKAnimationDriver AnimationDriver { get; set; }
+
+        /// <summary>
+        /// 按钮点击音效处理器。业务层设置，为 null 时不播放音效。
+        /// </summary>
+        public IUITKClickSoundHandler ClickSoundHandler { get; set; }
+
+        private readonly List<UITKWindow> _windowStack = new List<UITKWindow>(64);
+
+        protected override void OnInit()
+        {
+            Resource = new UITKResourceLoader();
+            AnimationDriver = new USSAnimationDriver();
+            InitPanels();
+        }
+
+        protected override void OnRelease()
+        {
+            CloseAll(isShutDown: true);
+            DestroyPanels();
+        }
+
+        public void OnUpdate()
+        {
+            int count = _windowStack.Count;
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (_windowStack.Count != count) break;
+                _windowStack[i].InternalUpdate();
+            }
+        }
+
+        // ━━━ Show ━━━
+
+        public void ShowUI<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            ShowUIImp<T>(false, userDatas);
+        }
+
+        public void ShowUIAsync<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            ShowUIImp<T>(true, userDatas);
+        }
+
+        public async UniTask<T> ShowUIAsyncAwait<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            return await ShowUIAwaitImp<T>(true, userDatas) as T;
+        }
+
+        public void ShowUI(Type type, params object[] userDatas)
+        {
+            ShowUIImp(type, false, userDatas);
+        }
+
+        public void ShowUIAsync(Type type, params object[] userDatas)
+        {
+            ShowUIImp(type, true, userDatas);
+        }
+
+        private void ShowUIImp<T>(bool isAsync, params object[] userDatas) where T : UITKWindow, new()
+        {
+            Type type = typeof(T);
+            string windowName = type.FullName;
+
+            if (!TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                window = CreateInstance<T>();
+                Push(window);
+                window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+            }
+        }
+
+        private void ShowUIImp(Type type, bool isAsync, params object[] userDatas)
+        {
+            string windowName = type.FullName;
+
+            if (!TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                window = CreateInstance(type);
+                Push(window);
+                window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+            }
+        }
+
+        private async UniTask<UITKWindow> ShowUIAwaitImp<T>(bool isAsync, params object[] userDatas) where T : UITKWindow, new()
+        {
+            Type type = typeof(T);
+            string windowName = type.FullName;
+
+            if (TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                return window;
+            }
+
+            window = CreateInstance<T>();
+            Push(window);
+            window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+
+            float time = 0f;
+            while (!window.IsLoadDone)
+            {
+                time += Time.deltaTime;
+                if (time > 60f)
+                {
+                    Log.Error($"UITKWindow 加载超时: {windowName}");
+                    return null;
+                }
+                await UniTask.Yield();
+            }
+
+            // 加载失败/已销毁时 IsPrepare 为 false，返回 null 而非半成品窗口
+            return window.IsPrepare ? window : null;
+        }
+
+        private bool TryGetWindow(string windowName, out UITKWindow window, params object[] userDatas)
+        {
+            window = GetWindow(windowName);
+            if (window != null)
+            {
+                Pop(window);
+                Push(window);
+                window.TryInvoke(OnWindowPrepare, userDatas);
+                return true;
+            }
+            return false;
+        }
+
+        // ━━━ Close / Hide ━━━
+
+        public void CloseUI<T>() where T : UITKWindow
+        {
+            CloseUI(typeof(T));
+        }
+
+        public void CloseUI(Type type)
+        {
+            string windowName = type.FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            window.InternalDestroy();
+            Pop(window);
+            OnSetWindowVisible();
+        }
+
+        public void HideUI<T>() where T : UITKWindow
+        {
+            HideUI(typeof(T));
+        }
+
+        public void HideUI(Type type)
+        {
+            string windowName = type.FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            if (window.HideTimeToClose <= 0)
+            {
+                CloseUI(type);
+                return;
+            }
+
+            window.CancelHideToCloseTimer();
+            window.Visible = false;
+            window.IsHide = true;
+            window.HideTimerId = GameModule.Timer.AddTimer((arg) =>
+            {
+                CloseUI(type);
+            }, window.HideTimeToClose);
+
+            if (window.FullScreen)
+            {
+                OnSetWindowVisible();
+            }
+        }
+
+        public void CloseAll(bool isShutDown = false)
+        {
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                _windowStack[i].InternalDestroy(isShutDown);
+            }
+            _windowStack.Clear();
+        }
+
+        public void CloseAllWithOut<T>() where T : UITKWindow
+        {
+            for (int i = _windowStack.Count - 1; i >= 0; i--)
+            {
+                UITKWindow window = _windowStack[i];
+                if (window.GetType() == typeof(T)) continue;
+                window.InternalDestroy();
+                _windowStack.RemoveAt(i);
+            }
+        }
+
+        // ━━━ Query ━━━
+
+        public bool HasWindow<T>() => GetWindow(typeof(T).FullName) != null;
+
+        public T GetUI<T>() where T : UITKWindow
+        {
+            return GetWindow(typeof(T).FullName) as T;
+        }
+
+        // ━━━ Instance Factory ━━━
+
+        private UITKWindow CreateInstance<T>() where T : UITKWindow, new()
+        {
+            return CreateInstance(typeof(T));
+        }
+
+        private UITKWindow CreateInstance(Type type)
+        {
+            UITKWindow window = Activator.CreateInstance(type) as UITKWindow;
+            UIWindowAttribute attribute = Attribute.GetCustomAttribute(type, typeof(UIWindowAttribute)) as UIWindowAttribute;
+
+            if (window == null)
+                throw new GameFrameworkException($"UITKWindow {type.FullName} create instance failed.");
+
+            if (attribute != null)
+            {
+                string assetName = string.IsNullOrEmpty(attribute.Location) ? type.Name : attribute.Location;
+                window.Init(type.FullName, (int)attribute.Layer, attribute.FullScreen, assetName, attribute.FromResources, attribute.HideTimeToClose, attribute.Package);
+            }
+            else
+            {
+                window.Init(type.FullName, (int)UILayer.UI, false, type.Name, false, 10, "");
+            }
+
+            return window;
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs.meta
new file mode 100644
index 0000000000..7972270a5d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e3e768417433945fa8dd86ec84533d17
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView.meta
new file mode 100644
index 0000000000..ad5bc859a0
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 7500e7bfa1b414893bb976534f4a0281
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs
new file mode 100644
index 0000000000..cb3c58ac17
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs
@@ -0,0 +1,157 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 泛型虚拟化列表。封装 Unity ListView，对齐 Widget 生命周期。
+    /// </summary>
+    public class UITKListView<T> : UITKWidget where T : UITKWidget, new()
+    {
+        private ListView _listView;
+        private readonly List<T> _activeWidgets = new();
+        private readonly Queue<T> _widgetPool = new();
+        private IList _dataSource;
+        private Action _unbindListAction;
+
+        /// <summary>
+        /// 列表项选中事件。
+        /// </summary>
+        public event Action<object, int> OnItemSelected;
+
+        /// <summary>
+        /// 设置固定行高（启用后性能更优）。
+        /// </summary>
+        public int FixedItemHeight
+        {
+            set => _listView.fixedItemHeight = value;
+        }
+
+        protected override void OnCreate()
+        {
+            _listView = RootElement.Q<ListView>();
+            if (_listView == null)
+            {
+                _listView = RootElement as ListView;
+            }
+            if (_listView == null)
+            {
+                TEngine.Log.Error($"UITKListView<{typeof(T).Name}>: No ListView found in root element");
+                return;
+            }
+
+            _listView.makeItem = MakeItem;
+            _listView.bindItem = BindItem;
+            _listView.unbindItem = UnbindItem;
+            _listView.selectionChanged += OnSelectionChanged;
+        }
+
+        /// <summary>
+        /// 手动设置数据源（非 MVVM 场景）。
+        /// </summary>
+        public void SetData(IList data)
+        {
+            _dataSource = data;
+            _listView.itemsSource = data;
+            _listView.Rebuild();
+        }
+
+        /// <summary>
+        /// 绑定 BindableList，自动监听增删改刷新。
+        /// </summary>
+        public void BindList<TData>(BindableList<TData> source)
+        {
+            _dataSource = source.InternalList;
+            _listView.itemsSource = source.InternalList;
+
+            Action onChanged = () => _listView.Rebuild();
+            source.OnListChanged += onChanged;
+
+            _unbindListAction = () =>
+            {
+                source.OnListChanged -= onChanged;
+            };
+
+            _listView.Rebuild();
+        }
+
+        /// <summary>
+        /// 解绑列表数据源。
+        /// </summary>
+        public void UnbindList()
+        {
+            _unbindListAction?.Invoke();
+            _unbindListAction = null;
+        }
+
+        public void RefreshItem(int index) => _listView.RefreshItem(index);
+        public void RefreshAll() => _listView.Rebuild();
+
+        private VisualElement MakeItem()
+        {
+            T widget;
+            if (_widgetPool.Count > 0)
+            {
+                widget = _widgetPool.Dequeue();
+                widget.RootElement.style.display = DisplayStyle.Flex;
+            }
+            else
+            {
+                widget = new T();
+                var asset = UITKModule.Resource.LoadVisualTreeAsset(typeof(T).Name);
+                if (asset == null)
+                {
+                    TEngine.Log.Error($"UITKListView<{typeof(T).Name}>: 列表项 UXML 加载失败 ({typeof(T).Name})");
+                    return new VisualElement();  // 占位，避免 ListView 内部因 null 崩溃
+                }
+                var root = asset.CloneTree();
+                widget.Create(this, root, true);
+            }
+            _activeWidgets.Add(widget);
+            return widget.RootElement;
+        }
+
+        private void BindItem(VisualElement element, int index)
+        {
+            var widget = FindWidgetByElement(element);
+            if (widget != null && _dataSource != null && index < _dataSource.Count)
+            {
+                widget.OnBindData(_dataSource[index], index);
+            }
+        }
+
+        private void UnbindItem(VisualElement element, int index)
+        {
+            var widget = FindWidgetByElement(element);
+            widget?.OnUnbindData();
+        }
+
+        private void OnSelectionChanged(IEnumerable<object> selection)
+        {
+            foreach (var item in selection)
+            {
+                int idx = _dataSource?.IndexOf(item) ?? -1;
+                OnItemSelected?.Invoke(item, idx);
+            }
+        }
+
+        private T FindWidgetByElement(VisualElement element)
+        {
+            for (int i = 0; i < _activeWidgets.Count; i++)
+            {
+                if (_activeWidgets[i].RootElement == element)
+                    return _activeWidgets[i];
+            }
+            return null;
+        }
+
+        protected override void OnDestroy()
+        {
+            UnbindList();
+            _activeWidgets.Clear();
+            _widgetPool.Clear();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs.meta
new file mode 100644
index 0000000000..98ad6975f0
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/ListView/UITKListView.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e63bee001ae6d41d3ac0377367142222
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM.meta
new file mode 100644
index 0000000000..a2fcabdcc2
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d59065d4b64944b8a8ca776d63ef2d2a
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs
new file mode 100644
index 0000000000..30710fd5a6
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs
@@ -0,0 +1,54 @@
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 可绑定命令。支持 CanExecute 控制按钮可用状态。
+    /// </summary>
+    public class BindableCommand
+    {
+        private readonly Action _execute;
+        private readonly Func<bool> _canExecute;
+        public event Action CanExecuteChanged;
+
+        public BindableCommand(Action execute, Func<bool> canExecute = null)
+        {
+            _execute = execute;
+            _canExecute = canExecute;
+        }
+
+        public bool CanExecute() => _canExecute?.Invoke() ?? true;
+
+        public void Execute()
+        {
+            if (CanExecute()) _execute();
+        }
+
+        public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke();
+    }
+
+    /// <summary>
+    /// 泛型可绑定命令。
+    /// </summary>
+    public class BindableCommand<T>
+    {
+        private readonly Action<T> _execute;
+        private readonly Func<T, bool> _canExecute;
+        public event Action CanExecuteChanged;
+
+        public BindableCommand(Action<T> execute, Func<T, bool> canExecute = null)
+        {
+            _execute = execute;
+            _canExecute = canExecute;
+        }
+
+        public bool CanExecute(T param) => _canExecute?.Invoke(param) ?? true;
+
+        public void Execute(T param)
+        {
+            if (CanExecute(param)) _execute(param);
+        }
+
+        public void RaiseCanExecuteChanged() => CanExecuteChanged?.Invoke();
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs.meta
new file mode 100644
index 0000000000..c12e36935b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableCommand.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c3ed93f2835484de1ac735519082e61b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs
new file mode 100644
index 0000000000..d40660209c
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs
@@ -0,0 +1,94 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 可绑定集合。增删改时通知 UI 刷新。
+    /// </summary>
+    public class BindableList<T> : IList<T>
+    {
+        private readonly List<T> _list = new();
+
+        public event Action OnListChanged;
+        public event Action<int, T> OnItemAdded;
+        public event Action<int, T> OnItemRemoved;
+        public event Action<int, T, T> OnItemChanged;
+
+        internal IList InternalList => _list;
+
+        public int Count => _list.Count;
+        public bool IsReadOnly => false;
+
+        public T this[int index]
+        {
+            get => _list[index];
+            set
+            {
+                T old = _list[index];
+                _list[index] = value;
+                OnItemChanged?.Invoke(index, old, value);
+                OnListChanged?.Invoke();
+            }
+        }
+
+        public void Add(T item)
+        {
+            _list.Add(item);
+            OnItemAdded?.Invoke(_list.Count - 1, item);
+            OnListChanged?.Invoke();
+        }
+
+        public void AddRange(IEnumerable<T> items)
+        {
+            foreach (var item in items)
+            {
+                _list.Add(item);
+                OnItemAdded?.Invoke(_list.Count - 1, item);
+            }
+            OnListChanged?.Invoke();
+        }
+
+        public void Insert(int index, T item)
+        {
+            _list.Insert(index, item);
+            OnItemAdded?.Invoke(index, item);
+            OnListChanged?.Invoke();
+        }
+
+        public bool Remove(T item)
+        {
+            int idx = _list.IndexOf(item);
+            if (idx < 0) return false;
+            RemoveAt(idx);
+            return true;
+        }
+
+        public void RemoveAt(int index)
+        {
+            T item = _list[index];
+            _list.RemoveAt(index);
+            OnItemRemoved?.Invoke(index, item);
+            OnListChanged?.Invoke();
+        }
+
+        public void Clear()
+        {
+            // 逆序逐项触发移除事件，保证 index 有效，事件语义与 RemoveAt 一致
+            for (int i = _list.Count - 1; i >= 0; i--)
+            {
+                T item = _list[i];
+                _list.RemoveAt(i);
+                OnItemRemoved?.Invoke(i, item);
+            }
+            OnListChanged?.Invoke();
+        }
+
+        public bool Contains(T item) => _list.Contains(item);
+        public int IndexOf(T item) => _list.IndexOf(item);
+        public void CopyTo(T[] array, int arrayIndex) => _list.CopyTo(array, arrayIndex);
+        public IEnumerator<T> GetEnumerator() => _list.GetEnumerator();
+        IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs.meta
new file mode 100644
index 0000000000..89ca97c823
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableList.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4e3f980956fd54dc98a09da363875c9b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs
new file mode 100644
index 0000000000..c706d218e7
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs
@@ -0,0 +1,32 @@
+using System;
+using System.Collections.Generic;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 可绑定属性。值变化时自动通知所有订阅者。
+    /// </summary>
+    public class BindableProperty<T>
+    {
+        private T _value;
+        public event Action<T> OnValueChanged;
+
+        public T Value
+        {
+            get => _value;
+            set
+            {
+                if (EqualityComparer<T>.Default.Equals(_value, value)) return;
+                _value = value;
+                OnValueChanged?.Invoke(_value);
+            }
+        }
+
+        public BindableProperty() { }
+        public BindableProperty(T initial) => _value = initial;
+
+        public static implicit operator T(BindableProperty<T> prop) => prop is null ? default : prop.Value;
+
+        public override string ToString() => _value?.ToString() ?? "null";
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs.meta
new file mode 100644
index 0000000000..2a7d8ccb21
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/BindableProperty.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a53d7db8b63e148c5b1f20ce7e602236
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs
new file mode 100644
index 0000000000..183c270b82
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs
@@ -0,0 +1,41 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 类型转换器接口。
+    /// </summary>
+    public interface IValueConverter<TSource, TTarget>
+    {
+        TTarget Convert(TSource value);
+        TSource ConvertBack(TTarget value);
+    }
+
+    /// <summary>int → string</summary>
+    public class IntToStringConverter : IValueConverter<int, string>
+    {
+        public string Convert(int value) => value.ToString();
+        public int ConvertBack(string value) => int.TryParse(value, out int r) ? r : 0;
+    }
+
+    /// <summary>float → string</summary>
+    public class FloatToStringConverter : IValueConverter<float, string>
+    {
+        public string Convert(float value) => value.ToString("F1");
+        public float ConvertBack(string value) => float.TryParse(value, out float r) ? r : 0f;
+    }
+
+    /// <summary>bool → DisplayStyle</summary>
+    public class BoolToDisplayConverter : IValueConverter<bool, DisplayStyle>
+    {
+        public DisplayStyle Convert(bool value) => value ? DisplayStyle.Flex : DisplayStyle.None;
+        public bool ConvertBack(DisplayStyle value) => value == DisplayStyle.Flex;
+    }
+
+    /// <summary>bool → opacity (1/0)</summary>
+    public class BoolToOpacityConverter : IValueConverter<bool, float>
+    {
+        public float Convert(bool value) => value ? 1f : 0f;
+        public bool ConvertBack(float value) => value > 0.5f;
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs.meta
new file mode 100644
index 0000000000..bb055d969a
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/IValueConverter.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0725d00cb1ccf4243b261cc4bae444bb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs
new file mode 100644
index 0000000000..c9eb3043c8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs
@@ -0,0 +1,13 @@
+namespace GameLogic
+{
+    /// <summary>
+    /// ViewModel 基类。
+    /// </summary>
+    public abstract class ViewModelBase
+    {
+        /// <summary>
+        /// 释放 ViewModel 资源。
+        /// </summary>
+        public virtual void Dispose() { }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs.meta
new file mode 100644
index 0000000000..b83ab4fdab
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/MVVM/ViewModelBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: faa38e4e824604d4ebd1a10223e587e7
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource.meta
new file mode 100644
index 0000000000..492a8c4224
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 75f3f2ae635ca4228be65b8c3698703b
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs
new file mode 100644
index 0000000000..89366cc1d1
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs
@@ -0,0 +1,20 @@
+using System.Threading;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 资源加载器接口。
+    /// </summary>
+    public interface IUITKResourceLoader
+    {
+        VisualTreeAsset LoadVisualTreeAsset(string location, string packageName = "");
+        UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location, CancellationToken ct = default, string packageName = "");
+        StyleSheet LoadStyleSheet(string location, string packageName = "");
+        UniTask<StyleSheet> LoadStyleSheetAsync(string location, CancellationToken ct = default, string packageName = "");
+        PanelSettings LoadPanelSettings(string location, string packageName = "");
+        void Unload(Object asset);
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs.meta
new file mode 100644
index 0000000000..12edd1f118
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8bacef9241cc2467fa21fb9dd1851633
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs
new file mode 100644
index 0000000000..cfb4590dbc
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs
@@ -0,0 +1,47 @@
+using System.Threading;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 默认 UIToolkit 资源加载器。委托给 YooAsset (IResourceModule)。
+    /// </summary>
+    public class UITKResourceLoader : IUITKResourceLoader
+    {
+        // 通过 GameModule 统一访问模块（符合框架约定）
+        private readonly IResourceModule _resource = GameModule.Resource;
+
+        public VisualTreeAsset LoadVisualTreeAsset(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<VisualTreeAsset>(location, packageName);
+        }
+
+        public async UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location, CancellationToken ct = default, string packageName = "")
+        {
+            return await _resource.LoadAssetAsync<VisualTreeAsset>(location, ct, packageName);
+        }
+
+        public StyleSheet LoadStyleSheet(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<StyleSheet>(location, packageName);
+        }
+
+        public async UniTask<StyleSheet> LoadStyleSheetAsync(string location, CancellationToken ct = default, string packageName = "")
+        {
+            return await _resource.LoadAssetAsync<StyleSheet>(location, ct, packageName);
+        }
+
+        public PanelSettings LoadPanelSettings(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<PanelSettings>(location, packageName);
+        }
+
+        public void Unload(Object asset)
+        {
+            _resource.UnloadAsset(asset);
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs.meta
new file mode 100644
index 0000000000..43adc2f0d8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4c793ac57473b476d81e460db7a3cacc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK.meta
new file mode 100644
index 0000000000..1225ae3df0
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: c461b974d63ce4297acc09891f8dcc44
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs
new file mode 100644
index 0000000000..fb59935a87
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs
@@ -0,0 +1,39 @@
+// <auto-generated by UITKBindingGenerator>
+// Do not modify manually.
+
+using System;
+using System.Collections.Generic;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    partial class TestAutoBindWindow
+    {
+        protected override void __UITKAutoBind(UnityEngine.UIElements.VisualElement root)
+        {
+            lblTitle = root.Q<Label>("lbl-title");
+            lblCount = root.Q<Label>("lbl-count");
+            btnIncrement = root.Q<Button>("btn-increment");
+            btnDecrement = root.Q<Button>("btn-decrement");
+            inputName = root.Q<TextField>("input-name");
+            lblNameEcho = root.Q<Label>("lbl-name-echo");
+            btnClose = root.Q<Button>("btn-close");
+        }
+
+        protected override void __UITKAutoBindEvents()
+        {
+            btnIncrement.clicked += OnBtnIncrement;
+            btnDecrement.clicked += OnBtnDecrement;
+            btnClose.clicked += OnBtnClose;
+            inputName.RegisterValueChangedCallback(OnNameChanged);
+        }
+
+        protected override void __UITKAutoUnbindEvents()
+        {
+            btnIncrement.clicked -= OnBtnIncrement;
+            btnDecrement.clicked -= OnBtnDecrement;
+            btnClose.clicked -= OnBtnClose;
+            inputName.UnregisterValueChangedCallback(OnNameChanged);
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs.meta
new file mode 100644
index 0000000000..baad0e52e8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.bindgen.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 240fb378b901744cfb1cd48ffb3a8455
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs
new file mode 100644
index 0000000000..d32fa243c8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs
@@ -0,0 +1,70 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 自动绑定测试窗口。
+    /// 使用 [Q] + [OnClick] + [OnChange]，经绑定生成器生成 .bindgen.cs（编译期代码，零反射）。
+    /// </summary>
+    [UIWindow(UILayer.UI)]
+    public partial class TestAutoBindWindow : UITKWindow
+    {
+        // ━━━ [Q] 自动查询绑定 ━━━
+        // 字段名 camelCase → UXML name kebab-case
+        [Q] Label lblTitle;           // → lbl-title
+        [Q] Label lblCount;           // → lbl-count
+        [Q] Button btnIncrement;      // → btn-increment
+        [Q] Button btnDecrement;      // → btn-decrement
+        [Q] TextField inputName;      // → input-name
+        [Q] Label lblNameEcho;        // → lbl-name-echo
+        [Q] Button btnClose;          // → btn-close
+
+        private int _count;
+
+        protected override void OnCreate()
+        {
+            // 自动绑定由框架在 InternalCreate 中自动调用，无需手动处理
+        }
+
+        protected override void OnRefresh()
+        {
+            _count = 0;
+            lblCount.text = "0";
+            lblTitle.text = "Auto-Bind Works!";
+        }
+
+        // ━━━ [OnClick] 事件自动绑定 ━━━
+        // 方法名 OnBtnIncrement → 绑定到 btn-increment.clicked
+        [OnClick]
+        void OnBtnIncrement()
+        {
+            _count++;
+            lblCount.text = _count.ToString();
+        }
+
+        [OnClick]
+        void OnBtnDecrement()
+        {
+            if (_count > 0) _count--;
+            lblCount.text = _count.ToString();
+        }
+
+        [OnClick]
+        void OnBtnClose()
+        {
+            UITKModule.Instance.CloseUI<TestAutoBindWindow>();
+        }
+
+        // ━━━ [OnChange] 值变化自动绑定 ━━━
+        [OnChange("input-name")]
+        void OnNameChanged(ChangeEvent<string> evt)
+        {
+            lblNameEcho.text = $"Echo: {evt.newValue}";
+        }
+
+        protected override void OnDestroy()
+        {
+            // 自动解绑由框架在 InternalDestroy 中自动调用，无需手动处理
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs.meta
new file mode 100644
index 0000000000..58db366ff2
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestAutoBindWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1877749d7da654ab4a1ace902769bc5b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs
new file mode 100644
index 0000000000..f0b41eb17d
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs
@@ -0,0 +1,16 @@
+namespace GameLogic
+{
+    public class TestBindingViewModel : ViewModelBase
+    {
+        public BindableProperty<int> Counter { get; } = new(0);
+        public BindableProperty<string> PlayerName { get; } = new("");
+        public BindableCommand IncrementCommand { get; }
+        public BindableCommand CloseCommand { get; }
+
+        public TestBindingViewModel()
+        {
+            IncrementCommand = new BindableCommand(() => Counter.Value++);
+            CloseCommand = new BindableCommand(() => UITKModule.Instance.CloseUI<TestBindingWindow>());
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs.meta
new file mode 100644
index 0000000000..e4a4cf2b3b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingViewModel.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e9901f2b592164d01b2e853645d0e87f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs
new file mode 100644
index 0000000000..40948e6caa
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs
@@ -0,0 +1,60 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// MVVM 集成测试窗口。
+    /// 本窗口用「手动绑定」验证 MVVM 核心功能；也可改为 partial class + [Q]/[Bind]，
+    /// 经菜单 TEngine/UITK/Generate All Bindings 自动生成绑定代码。
+    /// </summary>
+    [UIWindow(UILayer.UI)]
+    public class TestBindingWindow : UITKWindow
+    {
+        private Label _lblTitle;
+        private Label _lblCounter;
+        private Button _btnIncrement;
+        private Button _btnClose;
+        private TextField _inputName;
+        private Label _lblNameDisplay;
+
+        private TestBindingViewModel _vm;
+
+        protected override void OnCreate()
+        {
+            // 手动 Q 绑定（可改用 [Q] 经绑定生成器自动生成）
+            _lblTitle = RootElement.Q<Label>("lbl-title");
+            _lblCounter = RootElement.Q<Label>("lbl-counter");
+            _btnIncrement = RootElement.Q<Button>("btn-increment");
+            _btnClose = RootElement.Q<Button>("btn-close");
+            _inputName = RootElement.Q<TextField>("input-name");
+            _lblNameDisplay = RootElement.Q<Label>("lbl-name-display");
+
+            // 创建 ViewModel
+            _vm = new TestBindingViewModel();
+
+            // 手动 MVVM 绑定（可改用 [Bind]/[BindCommand] 经绑定生成器自动生成）
+            _vm.Counter.OnValueChanged += v => _lblCounter.text = v.ToString();
+            _vm.PlayerName.OnValueChanged += v => _lblNameDisplay.text = v;
+
+            // Command 绑定
+            _btnIncrement.clicked += _vm.IncrementCommand.Execute;
+            _btnClose.clicked += _vm.CloseCommand.Execute;
+
+            // TwoWay: TextField → ViewModel
+            _inputName.RegisterValueChangedCallback(evt => _vm.PlayerName.Value = evt.newValue);
+        }
+
+        protected override void OnRefresh()
+        {
+            _lblTitle.text = "MVVM Binding Test";
+            _lblCounter.text = _vm.Counter.Value.ToString();
+        }
+
+        protected override void OnDestroy()
+        {
+            _btnIncrement.clicked -= _vm.IncrementCommand.Execute;
+            _btnClose.clicked -= _vm.CloseCommand.Execute;
+            _vm.Dispose();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs.meta
new file mode 100644
index 0000000000..357530ee45
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestBindingWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3f1aafd1abcbb4663a884fd2c0e91598
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs
new file mode 100644
index 0000000000..80c1b31b0b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs
@@ -0,0 +1,68 @@
+namespace GameLogic
+{
+    /// <summary>
+    /// 全功能测试 ViewModel。
+    /// </summary>
+    public class TestFullFeatureViewModel : ViewModelBase
+    {
+        // 基础绑定
+        public BindableProperty<int> Counter { get; } = new(0);
+
+        // 双向绑定
+        public BindableProperty<string> PlayerName { get; } = new("");
+        public BindableProperty<float> SliderValue { get; } = new(0f);
+
+        // 命令
+        public BindableCommand IncrementCommand { get; }
+        public BindableCommand DecrementCommand { get; }
+        public BindableCommand ResetCommand { get; }
+        public BindableCommand BuyCommand { get; }
+
+        // Buy 结果
+        public BindableProperty<string> BuyResult { get; } = new("");
+
+        // Widget 数据
+        public BindableList<string> Items { get; } = new();
+        private int _itemIndex;
+
+        public TestFullFeatureViewModel()
+        {
+            IncrementCommand = new BindableCommand(() =>
+            {
+                Counter.Value++;
+                BuyCommand.RaiseCanExecuteChanged();
+            });
+
+            DecrementCommand = new BindableCommand(() =>
+            {
+                if (Counter.Value > 0) Counter.Value--;
+                BuyCommand.RaiseCanExecuteChanged();
+            });
+
+            ResetCommand = new BindableCommand(() =>
+            {
+                Counter.Value = 0;
+                BuyCommand.RaiseCanExecuteChanged();
+            });
+
+            BuyCommand = new BindableCommand(
+                execute: () => BuyResult.Value = $"购买成功! 剩余: {Counter.Value - 5}",
+                canExecute: () => Counter.Value >= 5
+            );
+        }
+
+        public void AddItem()
+        {
+            _itemIndex++;
+            Items.Add($"动态 Widget #{_itemIndex}");
+        }
+
+        public void RemoveItem(int index)
+        {
+            if (index >= 0 && index < Items.Count)
+            {
+                Items.RemoveAt(index);
+            }
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs.meta
new file mode 100644
index 0000000000..19865b9c8a
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureViewModel.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2c14e6fa9942246199fb25d78a288a74
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs
new file mode 100644
index 0000000000..644c14a37b
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs
@@ -0,0 +1,177 @@
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UITKModule 全功能测试窗口。
+    /// 覆盖：MVVM绑定、双向绑定、Command+CanExecute、Widget动态创建、动画。
+    /// 本窗口用手动绑定演示全功能；也可改为 partial + [Q]/[Bind]，经绑定生成器自动生成。
+    /// </summary>
+    [UIWindow(UILayer.UI, FullScreen = true)]
+    public class TestFullFeatureWindow : UITKWindow
+    {
+        // 动画配置
+        protected override UITKAnimationType ShowAnimation => UITKAnimationType.ScaleIn;
+        protected override UITKAnimationType HideAnimation => UITKAnimationType.FadeOut;
+        protected override int AnimationDuration => 300;
+
+        // UI 元素
+        private Label _lblTitle;
+        private Label _lblCounter;
+        private Button _btnIncrement;
+        private Button _btnDecrement;
+        private Button _btnReset;
+        private TextField _inputName;
+        private Label _lblNameSync;
+        private Slider _sliderValue;
+        private Label _lblSliderValue;
+        private Button _btnBuy;
+        private Label _lblBuyResult;
+        private VisualElement _widgetContainer;
+        private Button _btnAddWidget;
+        private Button _btnCloseFade;
+        private Button _btnCloseSlide;
+
+        // MVVM
+        private TestFullFeatureViewModel _vm;
+        private List<TestItemWidget> _itemWidgets = new();
+
+        protected override void OnCreate()
+        {
+            // ━━━ 手动 Q 绑定（可改用 [Q] 经绑定生成器自动生成）━━━
+            _lblTitle = RootElement.Q<Label>("lbl-title");
+            _lblCounter = RootElement.Q<Label>("lbl-counter");
+            _btnIncrement = RootElement.Q<Button>("btn-increment");
+            _btnDecrement = RootElement.Q<Button>("btn-decrement");
+            _btnReset = RootElement.Q<Button>("btn-reset");
+            _inputName = RootElement.Q<TextField>("input-name");
+            _lblNameSync = RootElement.Q<Label>("lbl-name-sync");
+            _sliderValue = RootElement.Q<Slider>("slider-value");
+            _lblSliderValue = RootElement.Q<Label>("lbl-slider-value");
+            _btnBuy = RootElement.Q<Button>("btn-buy");
+            _lblBuyResult = RootElement.Q<Label>("lbl-buy-result");
+            _widgetContainer = RootElement.Q<VisualElement>("widget-container");
+            _btnAddWidget = RootElement.Q<Button>("btn-add-widget");
+            _btnCloseFade = RootElement.Q<Button>("btn-close-fade");
+            _btnCloseSlide = RootElement.Q<Button>("btn-close-slide");
+
+            // ━━━ 创建 ViewModel ━━━
+            _vm = new TestFullFeatureViewModel();
+
+            // ━━━ OneWay 绑定：ViewModel → View ━━━
+            _vm.Counter.OnValueChanged += OnCounterChanged;
+            _vm.BuyResult.OnValueChanged += v => _lblBuyResult.text = v;
+
+            // ━━━ TwoWay 绑定：View ↔ ViewModel ━━━
+            // Name
+            _vm.PlayerName.OnValueChanged += v => _lblNameSync.text = $"实时同步: {v}";
+            _inputName.RegisterValueChangedCallback(evt => _vm.PlayerName.Value = evt.newValue);
+
+            // Slider
+            _vm.SliderValue.OnValueChanged += v => _lblSliderValue.text = $"滑块值: {v:F0}";
+            _sliderValue.RegisterValueChangedCallback(evt => _vm.SliderValue.Value = evt.newValue);
+
+            // ━━━ Command 绑定 ━━━
+            _btnIncrement.clicked += _vm.IncrementCommand.Execute;
+            _btnDecrement.clicked += _vm.DecrementCommand.Execute;
+            _btnReset.clicked += _vm.ResetCommand.Execute;
+            _btnBuy.clicked += _vm.BuyCommand.Execute;
+            _vm.BuyCommand.CanExecuteChanged += UpdateBuyButtonState;
+
+            // ━━━ Widget 动态创建 ━━━
+            _btnAddWidget.clicked += OnAddWidget;
+            _vm.Items.OnListChanged += RefreshWidgetList;
+
+            // ━━━ 关闭按钮 ━━━
+            _btnCloseFade.clicked += OnCloseFade;
+            _btnCloseSlide.clicked += OnCloseSlide;
+
+            // 初始状态
+            UpdateBuyButtonState();
+        }
+
+        protected override void OnRefresh()
+        {
+            _lblCounter.text = _vm.Counter.Value.ToString();
+        }
+
+        private void OnCounterChanged(int value)
+        {
+            _lblCounter.text = value.ToString();
+        }
+
+        private void UpdateBuyButtonState()
+        {
+            _btnBuy.SetEnabled(_vm.BuyCommand.CanExecute());
+        }
+
+        private void OnAddWidget()
+        {
+            _vm.AddItem();
+        }
+
+        private void RefreshWidgetList()
+        {
+            // 清除旧 Widget
+            foreach (var w in _itemWidgets)
+            {
+                w.Destroy();
+            }
+            _itemWidgets.Clear();
+
+            // 重建
+            for (int i = 0; i < _vm.Items.Count; i++)
+            {
+                var widget = new TestItemWidget();
+                var asset = UITKModule.Resource.LoadVisualTreeAsset("TestItemWidget");
+                var root = asset.CloneTree();
+                _widgetContainer.Add(root);
+                widget.Create(this, root, true);
+                widget.OnBindData(_vm.Items[i], i);
+                widget.OnRemoveClicked = OnRemoveWidget;
+                _itemWidgets.Add(widget);
+            }
+        }
+
+        private void OnRemoveWidget(int index)
+        {
+            _vm.RemoveItem(index);
+        }
+
+        private void OnCloseFade()
+        {
+            UITKModule.Instance.CloseUIWithAnimation<TestFullFeatureWindow>().Forget();
+        }
+
+        private void OnCloseSlide()
+        {
+            // 临时覆盖动画后关闭
+            UITKModule.Instance.CloseUIWithAnimation<TestFullFeatureWindow>().Forget();
+        }
+
+        protected override void OnDestroy()
+        {
+            // 解绑事件
+            _vm.Counter.OnValueChanged -= OnCounterChanged;
+            _vm.BuyCommand.CanExecuteChanged -= UpdateBuyButtonState;
+            _btnIncrement.clicked -= _vm.IncrementCommand.Execute;
+            _btnDecrement.clicked -= _vm.DecrementCommand.Execute;
+            _btnReset.clicked -= _vm.ResetCommand.Execute;
+            _btnBuy.clicked -= _vm.BuyCommand.Execute;
+            _btnAddWidget.clicked -= OnAddWidget;
+            _btnCloseFade.clicked -= OnCloseFade;
+            _btnCloseSlide.clicked -= OnCloseSlide;
+            _vm.Items.OnListChanged -= RefreshWidgetList;
+
+            foreach (var w in _itemWidgets)
+            {
+                w.Destroy();
+            }
+            _itemWidgets.Clear();
+
+            _vm.Dispose();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs.meta
new file mode 100644
index 0000000000..90980db9f8
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestFullFeatureWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b1ad3a8dd9cad4a5ba50ee5969ce4413
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs
new file mode 100644
index 0000000000..ab98534180
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs
@@ -0,0 +1,46 @@
+using System;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 测试用 Widget 子组件。
+    /// </summary>
+    public class TestItemWidget : UITKWidget
+    {
+        private Label _lblIndex;
+        private Label _lblItemName;
+        private Button _btnRemove;
+
+        private int _index;
+        public Action<int> OnRemoveClicked;
+
+        protected override void OnCreate()
+        {
+            _lblIndex = RootElement.Q<Label>("lbl-index");
+            _lblItemName = RootElement.Q<Label>("lbl-item-name");
+            _btnRemove = RootElement.Q<Button>("btn-remove");
+
+            _btnRemove.clicked += HandleRemove;
+        }
+
+        public override void OnBindData(object data, int index)
+        {
+            _index = index;
+            string itemName = data as string ?? "";
+            _lblIndex.text = $"#{index + 1}";
+            _lblItemName.text = itemName;
+        }
+
+        private void HandleRemove()
+        {
+            OnRemoveClicked?.Invoke(_index);
+        }
+
+        protected override void OnDestroy()
+        {
+            if (_btnRemove != null)
+                _btnRemove.clicked -= HandleRemove;
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs.meta
new file mode 100644
index 0000000000..93d839db61
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestItemWidget.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e045877a09c284956b514b2f83531114
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs
new file mode 100644
index 0000000000..7236f66bf6
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs
@@ -0,0 +1,68 @@
+using System.Text;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 主测试入口窗口。测试层级跳转、弹窗、窗口栈。
+    /// </summary>
+    [UIWindow(UILayer.UI, FullScreen = true)]
+    public class TestMainWindow : UITKWindow
+    {
+        private Label _lblTitle;
+        private Label _lblInfo;
+        private Label _lblStack;
+        private Button _btnOpenTips;
+        private Button _btnOpenSystem;
+        private Button _btnOpenSub;
+        private Button _btnOpenAutoBind;
+        private Button _btnOpenFull;
+        private Button _btnClose;
+
+        protected override void OnCreate()
+        {
+            _lblTitle = RootElement.Q<Label>("lbl-title");
+            _lblInfo = RootElement.Q<Label>("lbl-info");
+            _lblStack = RootElement.Q<Label>("lbl-stack");
+            _btnOpenTips = RootElement.Q<Button>("btn-open-tips");
+            _btnOpenSystem = RootElement.Q<Button>("btn-open-system");
+            _btnOpenSub = RootElement.Q<Button>("btn-open-sub");
+            _btnOpenAutoBind = RootElement.Q<Button>("btn-open-autobind");
+            _btnOpenFull = RootElement.Q<Button>("btn-open-full");
+            _btnClose = RootElement.Q<Button>("btn-close");
+
+            _btnOpenTips.clicked += () => UITKModule.Instance.ShowUIAsync<TestTipsPopup>();
+            _btnOpenSystem.clicked += () => UITKModule.Instance.ShowUIAsync<TestSystemDialog>();
+            _btnOpenSub.clicked += () => UITKModule.Instance.ShowUIAsync<TestSubPage>();
+            _btnOpenAutoBind.clicked += () => UITKModule.Instance.ShowUIAsync<TestAutoBindWindow>();
+            _btnOpenFull.clicked += () => UITKModule.Instance.ShowUIAsync<TestFullFeatureWindow>();
+            _btnClose.clicked += () => UITKModule.Instance.CloseUI<TestMainWindow>();
+        }
+
+        protected override void OnRefresh()
+        {
+            RefreshStack();
+        }
+
+        protected override void OnSetVisible(bool visible)
+        {
+            TEngine.Log.Info($"[TestMainWindow] OnSetVisible: {visible}");
+            if (visible) RefreshStack();
+        }
+
+        protected override void OnUpdate()
+        {
+            // 每帧刷新栈信息（方便观察）
+            RefreshStack();
+        }
+
+        private void RefreshStack()
+        {
+            if (_lblStack == null) return;
+            var sb = new StringBuilder();
+            // 通过反射或公开方法获取栈信息 - 这里简单显示当前状态
+            sb.Append($"MainWindow visible={Visible}");
+            _lblStack.text = sb.ToString();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs.meta
new file mode 100644
index 0000000000..25b3e6d159
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMainWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a8db684d53f944fdfba7eef27e3e3a9f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs
new file mode 100644
index 0000000000..86c8fda4c3
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs
@@ -0,0 +1,22 @@
+namespace GameLogic
+{
+    /// <summary>
+    /// MVVM 自动绑定测试窗口的 ViewModel。
+    /// 覆盖：int/string/float 属性、命令、CanExecute 控制。
+    /// </summary>
+    public class TestMvvmAutoBindViewModel : ViewModelBase
+    {
+        public BindableProperty<int> Counter { get; } = new(0);
+        public BindableProperty<string> PlayerName { get; } = new("Player");
+        public BindableProperty<float> Volume { get; } = new(50f);
+
+        public BindableCommand IncrementCommand { get; }
+        public BindableCommand CloseCommand { get; }
+
+        public TestMvvmAutoBindViewModel()
+        {
+            IncrementCommand = new BindableCommand(() => Counter.Value++);
+            CloseCommand = new BindableCommand(() => UITKModule.Instance.CloseUI<TestMvvmAutoBindWindow>());
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs.meta
new file mode 100644
index 0000000000..6060722cea
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindViewModel.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: bffe2633731224cda95802f0b25fff02
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs
new file mode 100644
index 0000000000..741f9470ef
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs
@@ -0,0 +1,42 @@
+// <auto-generated by UITKBindingGenerator>
+// Do not modify manually.
+
+using System;
+using System.Collections.Generic;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    partial class TestMvvmAutoBindWindow
+    {
+        protected override void __UITKAutoBind(UnityEngine.UIElements.VisualElement root)
+        {
+            lblTitle = root.Q<Label>("lbl-title");
+            lblCounter = root.Q<Label>("lbl-counter");
+            inputName = root.Q<TextField>("input-name");
+            sliderVolume = root.Q<Slider>("slider-volume");
+            inputCounter = root.Q<TextField>("input-counter");
+            btnIncrement = root.Q<Button>("btn-increment");
+            btnClose = root.Q<Button>("btn-close");
+        }
+
+        protected override void __UITKAutoBindEvents()
+        {
+        }
+
+        protected override void __UITKAutoUnbindEvents()
+        {
+        }
+
+        protected override void __UITKAutoBindMVVM()
+        {
+            if (_vm == null) { TEngine.Log.Warning("[MVVM] TestMvvmAutoBindWindow._vm 为 null，已跳过自动绑定。请确认已在 OnCreate 中构造 ViewModel。"); return; }
+            BindLabel(lblCounter, _vm.Counter, v => string.Format("Count: {0}", v));
+            BindField(inputName, _vm.PlayerName, GameLogic.BindingMode.TwoWay);
+            BindField(sliderVolume, _vm.Volume, GameLogic.BindingMode.TwoWay);
+            BindField(inputCounter, _vm.Counter, new GameLogic.IntToStringConverter(), GameLogic.BindingMode.TwoWay);
+            BindCommand(btnIncrement, _vm.IncrementCommand);
+            BindCommand(btnClose, _vm.CloseCommand);
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs.meta
new file mode 100644
index 0000000000..2de38c8fb7
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.bindgen.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 35be630e888f04c10b9af2d36e4d37ca
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs
new file mode 100644
index 0000000000..3d974c067f
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs
@@ -0,0 +1,50 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// MVVM 自动绑定测试窗口。
+    /// 演示 [Bind]/[BindCommand] 全自动绑定（OneWay+format、TwoWay 同类型、TwoWay+converter、命令）。
+    /// 修改特性后需经菜单 TEngine/UITK/Generate All Bindings 重新生成 .bindgen.cs。
+    /// </summary>
+    [UIWindow(UILayer.UI)]
+    public partial class TestMvvmAutoBindWindow : UITKWindow
+    {
+        // 纯展示（手动 [Q]）
+        [Q] private Label lblTitle;
+
+        // ━━━ MVVM 自动绑定字段（也会被自动查询并赋值）━━━
+
+        /// <summary>OneWay + format：Counter(int) → "Count: N"</summary>
+        [Bind("Counter", format: "Count: {0}")] private Label lblCounter;
+
+        /// <summary>TwoWay 同类型：PlayerName(string) ↔ TextField</summary>
+        [Bind("PlayerName", BindingMode.TwoWay)] private TextField inputName;
+
+        /// <summary>TwoWay 同类型：Volume(float) ↔ Slider</summary>
+        [Bind("Volume", BindingMode.TwoWay)] private Slider sliderVolume;
+
+        /// <summary>TwoWay + converter：Counter(int) ↔ TextField(string)，经 IntToStringConverter</summary>
+        [Bind("Counter", BindingMode.TwoWay, converter: typeof(IntToStringConverter))] private TextField inputCounter;
+
+        /// <summary>命令绑定</summary>
+        [BindCommand("IncrementCommand")] private Button btnIncrement;
+        [BindCommand("CloseCommand")] private Button btnClose;
+
+        // 生成器据此解析 ViewModel 类型与字段名
+        private TestMvvmAutoBindViewModel _vm;
+
+        protected override void OnCreate()
+        {
+            _vm = new TestMvvmAutoBindViewModel();
+            lblTitle.text = "MVVM 自动绑定测试";
+            // 注意：无需任何手动 += 订阅，__UITKAutoBindMVVM 在此之后自动执行绑定。
+        }
+
+        protected override void OnDestroy()
+        {
+            _vm.Dispose();
+            // 无需手动解绑：__UITKAutoUnbindMVVM 在 OnDestroy 前已自动解绑。
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs.meta
new file mode 100644
index 0000000000..3ca71d06ed
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestMvvmAutoBindWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 693fa208f6f93412ca3aa01ce9b2b723
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs
new file mode 100644
index 0000000000..63534214a5
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs
@@ -0,0 +1,34 @@
+using Cysharp.Threading.Tasks;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 子页面测试。全屏，会遮挡主界面（触发全屏遮挡逻辑）。
+    /// </summary>
+    [UIWindow(UILayer.UI, FullScreen = true)]
+    public class TestSubPage : UITKWindow
+    {
+        protected override UITKAnimationType ShowAnimation => UITKAnimationType.SlideFromRight;
+        protected override UITKAnimationType HideAnimation => UITKAnimationType.SlideToRight;
+        protected override int AnimationDuration => 300;
+
+        private Button _btnBack;
+
+        protected override void OnCreate()
+        {
+            _btnBack = RootElement.Q<Button>("btn-back");
+            _btnBack.clicked += OnBack;
+        }
+
+        private void OnBack()
+        {
+            UITKModule.Instance.CloseUIWithAnimation<TestSubPage>().Forget();
+        }
+
+        protected override void OnSetVisible(bool visible)
+        {
+            TEngine.Log.Info($"[TestSubPage] OnSetVisible: {visible}");
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs.meta
new file mode 100644
index 0000000000..ab5c94e4a0
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSubPage.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: dee1053a8ce54400d954f0e227fb9c32
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs
new file mode 100644
index 0000000000..d5a9cc8702
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs
@@ -0,0 +1,35 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// System 层确认框测试。最高层级。
+    /// </summary>
+    [UIWindow(UILayer.System)]
+    public class TestSystemDialog : UITKWindow
+    {
+        private Button _btnConfirm;
+        private Button _btnCancel;
+
+        protected override void OnCreate()
+        {
+            _btnConfirm = RootElement.Q<Button>("btn-confirm");
+            _btnCancel = RootElement.Q<Button>("btn-cancel");
+
+            _btnConfirm.clicked += OnConfirm;
+            _btnCancel.clicked += OnCancel;
+        }
+
+        private void OnConfirm()
+        {
+            TEngine.Log.Info("[TestSystemDialog] 用户点击了确认");
+            UITKModule.Instance.CloseUI<TestSystemDialog>();
+        }
+
+        private void OnCancel()
+        {
+            TEngine.Log.Info("[TestSystemDialog] 用户点击了取消");
+            UITKModule.Instance.CloseUI<TestSystemDialog>();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs.meta
new file mode 100644
index 0000000000..663edbd92c
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestSystemDialog.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2c5d14f4c812944e2941e9a32ae67c07
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs
new file mode 100644
index 0000000000..6966490270
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs
@@ -0,0 +1,24 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// Tips 层弹窗测试。非全屏，下层仍可见。
+    /// </summary>
+    [UIWindow(UILayer.Tips)]
+    public class TestTipsPopup : UITKWindow
+    {
+        private Button _btnClose;
+
+        protected override void OnCreate()
+        {
+            _btnClose = RootElement.Q<Button>("btn-close");
+            _btnClose.clicked += () => UITKModule.Instance.CloseUI<TestTipsPopup>();
+        }
+
+        protected override void OnDestroy()
+        {
+            TEngine.Log.Info("[TestTipsPopup] OnDestroy");
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs.meta
new file mode 100644
index 0000000000..b7d8ea5ca4
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestTipsPopup.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c477a825ce5c0470ebcc953b081a225b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs
new file mode 100644
index 0000000000..a99aa630a6
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs
@@ -0,0 +1,37 @@
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    [UIWindow(UILayer.UI)]
+    public class TestUITKWindow : UITKWindow
+    {
+        private Label _lblTitle;
+        private Button _btnClose;
+
+        protected override void OnCreate()
+        {
+            _lblTitle = RootElement.Q<Label>("lbl-title");
+            _btnClose = RootElement.Q<Button>("btn-close");
+
+            _btnClose.clicked += OnBtnCloseClicked;
+        }
+
+        protected override void OnRefresh()
+        {
+            _lblTitle.text = "UITKModule Works!";
+        }
+
+        protected override void OnDestroy()
+        {
+            if (_btnClose != null)
+            {
+                _btnClose.clicked -= OnBtnCloseClicked;
+            }
+        }
+
+        private void OnBtnCloseClicked()
+        {
+            UITKModule.Instance.CloseUI<TestUITKWindow>();
+        }
+    }
+}
diff --git a/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs.meta b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs.meta
new file mode 100644
index 0000000000..2c14a5fd42
--- /dev/null
+++ b/UnityProject/Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7da08c17f7b074792b84694d50c979a0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/Plugins.meta b/UnityProject/Assets/Plugins.meta
new file mode 100644
index 0000000000..0e30e7b54c
--- /dev/null
+++ b/UnityProject/Assets/Plugins.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: a8d054aa9ddd843858fac83619907ce5
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildConfig.cs.meta b/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildConfig.cs.meta
index 431c5bc819..cb3cf9c012 100644
--- a/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildConfig.cs.meta
+++ b/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildConfig.cs.meta
@@ -1,2 +1,11 @@
 fileFormatVersion: 2
-guid: 6fdb909de7128d844b2c6608ebd6f84d
\ No newline at end of file
+guid: 6fdb909de7128d844b2c6608ebd6f84d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildPipelineWindow.cs.meta b/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildPipelineWindow.cs.meta
index 60257b108f..e32a65c469 100644
--- a/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildPipelineWindow.cs.meta
+++ b/UnityProject/Assets/TEngine/Editor/ReleaseTools/BuildPipelineWindow.cs.meta
@@ -1,2 +1,11 @@
 fileFormatVersion: 2
-guid: dbb6fa1f3c9a3d041a4e0c4321c6f49f
\ No newline at end of file
+guid: dbb6fa1f3c9a3d041a4e0c4321c6f49f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/TEngine/Runtime/Core/Utility/Utility.Http.cs b/UnityProject/Assets/TEngine/Runtime/Core/Utility/Utility.Http.cs
index aeb8c9af74..c8525bc1e8 100644
--- a/UnityProject/Assets/TEngine/Runtime/Core/Utility/Utility.Http.cs
+++ b/UnityProject/Assets/TEngine/Runtime/Core/Utility/Utility.Http.cs
@@ -46,7 +46,7 @@ public static async UniTask<string> Post(string url, string postData, float time
 #if UNITY_6000_0_OR_NEWER
                 using UnityWebRequest unityWebRequest = UnityWebRequest.PostWwwForm(url, postData);
 #else
-                using UnityWebRequest unityWebRequest = UnityWebRequest.Post(url, postData);
+                using UnityWebRequest unityWebRequest = UnityWebRequest.PostWwwForm(url, postData);
 #endif
                 return await SendWebRequest(unityWebRequest, cts);
             }
diff --git a/UnityProject/Assets/TEngine/Runtime/Module/DebugerModule/Component/DebuggerModule.QualityInformationWindow.cs b/UnityProject/Assets/TEngine/Runtime/Module/DebugerModule/Component/DebuggerModule.QualityInformationWindow.cs
index 6bf07d1bc4..8ab8e10e33 100644
--- a/UnityProject/Assets/TEngine/Runtime/Module/DebugerModule/Component/DebuggerModule.QualityInformationWindow.cs
+++ b/UnityProject/Assets/TEngine/Runtime/Module/DebugerModule/Component/DebuggerModule.QualityInformationWindow.cs
@@ -36,7 +36,7 @@ protected override void OnDrawScrollableWindow()
 #if UNITY_6000_0_OR_NEWER
                     DrawItem("Master Texture Limit", QualitySettings.globalTextureMipmapLimit.ToString());
 #else
-                    DrawItem("Master Texture Limit", QualitySettings.masterTextureLimit.ToString());
+                    DrawItem("Master Texture Limit", QualitySettings.globalTextureMipmapLimit.ToString());
 #endif
                     DrawItem("Anisotropic Filtering", QualitySettings.anisotropicFiltering.ToString());
                     DrawItem("Anti Aliasing", QualitySettings.antiAliasing.ToString());
diff --git a/UnityProject/Assets/UI Toolkit.meta b/UnityProject/Assets/UI Toolkit.meta
new file mode 100644
index 0000000000..5975f9b7f0
--- /dev/null
+++ b/UnityProject/Assets/UI Toolkit.meta	
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 6a0246b924deb4516b47797744bd098a
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/UI Toolkit/UnityThemes.meta b/UnityProject/Assets/UI Toolkit/UnityThemes.meta
new file mode 100644
index 0000000000..dac4b8a961
--- /dev/null
+++ b/UnityProject/Assets/UI Toolkit/UnityThemes.meta	
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d01ede3e0dcda422891a88d9596157b3
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss b/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss
new file mode 100644
index 0000000000..1056e07ed4
--- /dev/null
+++ b/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss	
@@ -0,0 +1 @@
+@import url("unity-theme://default");
\ No newline at end of file
diff --git a/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss.meta b/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss.meta
new file mode 100644
index 0000000000..aa2d2074b1
--- /dev/null
+++ b/UnityProject/Assets/UI Toolkit/UnityThemes/UnityDefaultRuntimeTheme.tss.meta	
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 42f5d7a681f3d492fba942f01f4b41ee
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
+  script: {fileID: 12388, guid: 0000000000000000e000000000000000, type: 0}
+  disableValidation: 0
diff --git a/UnityProject/CLAUDE.md b/UnityProject/CLAUDE.md
index 42f43c3b48..635492ded0 100644
--- a/UnityProject/CLAUDE.md
+++ b/UnityProject/CLAUDE.md
@@ -49,7 +49,8 @@ TEngine 基于 HybridCLR + YooAsset + UniTask + Luban 构建。
 
 | 场景 | 必须查询主题 |
 |------|------------|
-| UI 开发 | ui-lifecycle.md — UIWindow 生命周期、UIWidget 规范 |
+| UI 开发 (UGUI) | ui-lifecycle.md — UIWindow 生命周期、UIWidget 规范 |
+| UI 开发 (UIToolkit) | uitk-module-design.md — UITKWindow/Widget、自动绑定、MVVM、动画 |
 | 资源加载 | resource-api.md — LoadAssetAsync API、释放时机 |
 | 热更代码 | hotfix-workflow.md — 程序集划分、GameApp 入口、热更边界 |
 | 事件系统 | event-system.md — GameEvent 用法、AddUIEvent 规范 |
@@ -77,6 +78,9 @@ TEngine 基于 HybridCLR + YooAsset + UniTask + Luban 构建。
 3. **资源必须释放**：`LoadAssetAsync` 对应 `UnloadAsset`，GameObject 用 `LoadGameObjectAsync`
 4. **热更边界**：`GameScripts/Main` 不热更，`GameScripts/HotFix/` 全部热更
 5. **事件解耦**：模块间用 `GameEvent`，UI 内部用 `AddUIEvent`
+6. **UIToolkit 开发**：新 UI 使用 `GameModule.UITK` (UITKModule)，旧 UI 保持 `GameModule.UI` (UIModule)
+7. **UIToolkit 绑定**：使用 `[Q]` + `[OnClick]` + `partial class`，通过菜单 `TEngine/UITK/Generate All Bindings` 生成绑定代码
+8. **UIToolkit 音效**：通过 `IUITKClickSoundHandler` 全局处理，不在单个按钮上手动注册音效
 
 ---
 
@@ -100,6 +104,11 @@ TEngine 基于 HybridCLR + YooAsset + UniTask + Luban 构建。
 | mcp-tools.md | MCP 场景/GameObject/UI Prefab/脚本/Editor/测试 | MCP |
 | mcp-visual.md | MCP 材质/Shader/VFX/动画 | MCP |
 | troubleshooting.md | 问题排查 | 排障 |
+| **UITKModule 相关** | | |
+| uitk-module-design.md | UITKModule 完整设计文档 | 核心 |
+| uitk-lifecycle.md | UITKWindow/Widget 生命周期、自动绑定流程 | 核心 |
+| uitk-binding.md | [Q]/[OnClick]/[OnChange] 用法、Editor 生成工具 | 核心 |
+| uitk-mvvm.md | BindableProperty/Command/List、ViewModel 模式 | 核心 |
 
 ---
 
diff --git a/UnityProject/Packages/manifest.json b/UnityProject/Packages/manifest.json
index 600fe31021..5e3ddddff4 100644
--- a/UnityProject/Packages/manifest.json
+++ b/UnityProject/Packages/manifest.json
@@ -5,8 +5,8 @@
     "com.unity.ide.visualstudio": "2.0.23",
     "com.unity.ide.vscode": "1.2.5",
     "com.unity.nuget.newtonsoft-json": "3.2.1",
+    "com.unity.textmeshpro": "3.0.9",
     "com.unity.ugui": "2.0.0",
-    "com.unity.modules.accessibility": "1.0.0",
     "com.unity.modules.ai": "1.0.0",
     "com.unity.modules.androidjni": "1.0.0",
     "com.unity.modules.animation": "1.0.0",
@@ -35,8 +35,6 @@
     "com.unity.modules.unitywebrequestwww": "1.0.0",
     "com.unity.modules.vehicles": "1.0.0",
     "com.unity.modules.video": "1.0.0",
-    "com.unity.modules.vr": "1.0.0",
-    "com.unity.modules.wind": "1.0.0",
-    "com.unity.modules.xr": "1.0.0"
+    "com.unity.modules.wind": "1.0.0"
   }
 }
diff --git a/UnityProject/Packages/packages-lock.json b/UnityProject/Packages/packages-lock.json
index 2522cd181f..6815abf965 100644
--- a/UnityProject/Packages/packages-lock.json
+++ b/UnityProject/Packages/packages-lock.json
@@ -25,10 +25,11 @@
       }
     },
     "com.unity.ext.nunit": {
-      "version": "2.0.5",
+      "version": "1.0.6",
       "depth": 1,
-      "source": "builtin",
-      "dependencies": {}
+      "source": "registry",
+      "dependencies": {},
+      "url": "https://packages.unity.com"
     },
     "com.unity.ide.rider": {
       "version": "3.0.38",
@@ -63,24 +64,31 @@
       "url": "https://packages.unity.com"
     },
     "com.unity.scriptablebuildpipeline": {
-      "version": "2.4.0",
+      "version": "1.21.25",
       "depth": 1,
       "source": "registry",
-      "dependencies": {
-        "com.unity.test-framework": "1.4.5",
-        "com.unity.modules.assetbundle": "1.0.0"
-      },
+      "dependencies": {},
       "url": "https://packages.unity.com"
     },
     "com.unity.test-framework": {
-      "version": "1.5.1",
+      "version": "1.1.33",
       "depth": 1,
-      "source": "builtin",
+      "source": "registry",
       "dependencies": {
-        "com.unity.ext.nunit": "2.0.3",
+        "com.unity.ext.nunit": "1.0.6",
         "com.unity.modules.imgui": "1.0.0",
         "com.unity.modules.jsonserialize": "1.0.0"
-      }
+      },
+      "url": "https://packages.unity.com"
+    },
+    "com.unity.textmeshpro": {
+      "version": "3.0.9",
+      "depth": 0,
+      "source": "registry",
+      "dependencies": {
+        "com.unity.ugui": "1.0.0"
+      },
+      "url": "https://packages.unity.com"
     },
     "com.unity.ugui": {
       "version": "2.0.0",
@@ -91,12 +99,6 @@
         "com.unity.modules.imgui": "1.0.0"
       }
     },
-    "com.unity.modules.accessibility": {
-      "version": "1.0.0",
-      "depth": 0,
-      "source": "builtin",
-      "dependencies": {}
-    },
     "com.unity.modules.ai": {
       "version": "1.0.0",
       "depth": 0,
@@ -144,12 +146,6 @@
         "com.unity.modules.animation": "1.0.0"
       }
     },
-    "com.unity.modules.hierarchycore": {
-      "version": "1.0.0",
-      "depth": 1,
-      "source": "builtin",
-      "dependencies": {}
-    },
     "com.unity.modules.imageconversion": {
       "version": "1.0.0",
       "depth": 0,
@@ -194,14 +190,6 @@
         "com.unity.modules.imageconversion": "1.0.0"
       }
     },
-    "com.unity.modules.subsystems": {
-      "version": "1.0.0",
-      "depth": 1,
-      "source": "builtin",
-      "dependencies": {
-        "com.unity.modules.jsonserialize": "1.0.0"
-      }
-    },
     "com.unity.modules.terrain": {
       "version": "1.0.0",
       "depth": 0,
@@ -238,8 +226,7 @@
       "dependencies": {
         "com.unity.modules.ui": "1.0.0",
         "com.unity.modules.imgui": "1.0.0",
-        "com.unity.modules.jsonserialize": "1.0.0",
-        "com.unity.modules.hierarchycore": "1.0.0"
+        "com.unity.modules.jsonserialize": "1.0.0"
       }
     },
     "com.unity.modules.umbra": {
@@ -321,31 +308,11 @@
         "com.unity.modules.unitywebrequest": "1.0.0"
       }
     },
-    "com.unity.modules.vr": {
-      "version": "1.0.0",
-      "depth": 0,
-      "source": "builtin",
-      "dependencies": {
-        "com.unity.modules.jsonserialize": "1.0.0",
-        "com.unity.modules.physics": "1.0.0",
-        "com.unity.modules.xr": "1.0.0"
-      }
-    },
     "com.unity.modules.wind": {
       "version": "1.0.0",
       "depth": 0,
       "source": "builtin",
       "dependencies": {}
-    },
-    "com.unity.modules.xr": {
-      "version": "1.0.0",
-      "depth": 0,
-      "source": "builtin",
-      "dependencies": {
-        "com.unity.modules.physics": "1.0.0",
-        "com.unity.modules.jsonserialize": "1.0.0",
-        "com.unity.modules.subsystems": "1.0.0"
-      }
     }
   }
 }
diff --git a/UnityProject/ProjectSettings/ProjectSettings.asset b/UnityProject/ProjectSettings/ProjectSettings.asset
index 7a5eaf0b44..df7b1537da 100644
--- a/UnityProject/ProjectSettings/ProjectSettings.asset
+++ b/UnityProject/ProjectSettings/ProjectSettings.asset
@@ -3,7 +3,7 @@
 --- !u!129 &1
 PlayerSettings:
   m_ObjectHideFlags: 0
-  serializedVersion: 24
+  serializedVersion: 26
   productGUID: c529b68e20957324591a6f85b74af7dd
   AndroidProfiler: 0
   AndroidFilterTouchesWhenObscured: 0
@@ -49,14 +49,15 @@ PlayerSettings:
   m_StereoRenderingPath: 0
   m_ActiveColorSpace: 0
   unsupportedMSAAFallback: 0
+  m_SpriteBatchVertexThreshold: 300
   m_MTRendering: 1
   mipStripping: 0
   numberOfMipsStripped: 0
+  numberOfMipsStrippedPerMipmapLimitGroup: {}
   m_StackTraceTypes: 010000000100000001000000010000000100000001000000
   iosShowActivityIndicatorOnLoading: -1
   androidShowActivityIndicatorOnLoading: -1
   iosUseCustomAppBackgroundBehavior: 0
-  iosAllowHTTPDownload: 1
   allowedAutorotateToPortrait: 1
   allowedAutorotateToPortraitUpsideDown: 1
   allowedAutorotateToLandscapeRight: 1
@@ -76,6 +77,7 @@ PlayerSettings:
   androidMinimumWindowHeight: 300
   androidFullscreenMode: 1
   androidAutoRotationBehavior: 1
+  androidPredictiveBackSupport: 1
   defaultIsNativeResolution: 1
   macRetinaSupport: 1
   runInBackground: 0
@@ -83,10 +85,12 @@ PlayerSettings:
   muteOtherAudioSources: 0
   Prepare IOS For Recording: 0
   Force IOS Speakers When Recording: 0
+  audioSpatialExperience: 0
   deferSystemGesturesMode: 0
   hideHomeButton: 0
   submitAnalytics: 1
   usePlayerLog: 1
+  dedicatedServerOptimizations: 0
   bakeCollisionMeshes: 0
   forceSingleInstance: 0
   useFlipModelSwapchain: 1
@@ -121,8 +125,11 @@ PlayerSettings:
   switchNVNShaderPoolsGranularity: 33554432
   switchNVNDefaultPoolsGranularity: 16777216
   switchNVNOtherPoolsGranularity: 16777216
+  switchGpuScratchPoolGranularity: 2097152
+  switchAllowGpuScratchShrinking: 0
   switchNVNMaxPublicTextureIDCount: 0
   switchNVNMaxPublicSamplerIDCount: 0
+  switchNVNGraphicsFirmwareMemory: 32
   switchMaxWorkerMultiple: 8
   stadiaPresentMode: 0
   stadiaTargetFramerate: 0
@@ -131,12 +138,9 @@ PlayerSettings:
   vulkanEnablePreTransform: 0
   vulkanEnableLateAcquireNextImage: 0
   vulkanEnableCommandBufferRecycling: 1
-  m_SupportedAspectRatios:
-    4:3: 1
-    5:4: 1
-    16:10: 1
-    16:9: 1
-    Others: 1
+  loadStoreDebugModeEnabled: 0
+  visionOSBundleVersion: 1.0
+  tvOSBundleVersion: 1.0
   bundleVersion: 1.0
   preloadedAssets: []
   metroInputSource: 0
@@ -149,8 +153,9 @@ PlayerSettings:
   isWsaHolographicRemotingEnabled: 0
   enableFrameTimingStats: 0
   enableOpenGLProfilerGPURecorders: 1
+  allowHDRDisplaySupport: 0
   useHDRDisplay: 0
-  D3DHDRBitDepth: 0
+  hdrBitDepth: 0
   m_ColorGamuts: 00000000
   targetPixelDensity: 30
   resolutionScalingMode: 0
@@ -161,6 +166,7 @@ PlayerSettings:
     Standalone: com.DefaultCompany.2DProject
   buildNumber:
     Standalone: 0
+    VisionOS: 0
     iPhone: 0
     tvOS: 0
   overrideDefaultApplicationIdentifier: 1
@@ -178,12 +184,17 @@ PlayerSettings:
   APKExpansionFiles: 0
   keepLoadedShadersAlive: 0
   StripUnusedMeshComponents: 0
+  strictShaderVariantMatching: 0
   VertexChannelCompressionMask: 4054
   iPhoneSdkVersion: 988
+  iOSSimulatorArchitecture: 0
   iOSTargetOSVersionString: 12.0
   tvOSSdkVersion: 0
+  tvOSSimulatorArchitecture: 0
   tvOSRequireExtendedGameController: 0
   tvOSTargetOSVersionString: 12.0
+  VisionOSSdkVersion: 0
+  VisionOSTargetOSVersionString: 1.0
   uIPrerenderedIcon: 0
   uIRequiresPersistentWiFi: 0
   uIRequiresFullScreen: 1
@@ -226,13 +237,16 @@ PlayerSettings:
   iOSMetalForceHardShadows: 0
   metalEditorSupport: 1
   metalAPIValidation: 1
+  metalCompileShaderBinary: 0
   iOSRenderExtraFrameOnPause: 0
   iosCopyPluginsCodeInsteadOfSymlink: 0
   appleDeveloperTeamID: 
   iOSManualSigningProvisioningProfileID: 
   tvOSManualSigningProvisioningProfileID: 
+  VisionOSManualSigningProvisioningProfileID: 
   iOSManualSigningProvisioningProfileType: 0
   tvOSManualSigningProvisioningProfileType: 0
+  VisionOSManualSigningProvisioningProfileType: 0
   appleEnableAutomaticSigning: 0
   iOSRequireARKit: 0
   iOSAutomaticallyDetectAndAddCapabilities: 1
@@ -255,6 +269,7 @@ PlayerSettings:
   androidSplashScreen: {fileID: 0}
   AndroidKeystoreName: 
   AndroidKeyaliasName: 
+  AndroidEnableArmv9SecurityFeatures: 0
   AndroidBuildApkPerCpuArchitecture: 0
   AndroidTVCompatibility: 0
   AndroidIsGame: 1
@@ -512,7 +527,9 @@ PlayerSettings:
     iPhone: 1
     tvOS: 1
   m_BuildTargetGroupLightmapEncodingQuality: []
+  m_BuildTargetGroupHDRCubemapEncodingQuality: []
   m_BuildTargetGroupLightmapSettings: []
+  m_BuildTargetGroupLoadStoreDebugModeSettings: []
   m_BuildTargetNormalMapEncoding: []
   m_BuildTargetDefaultTextureCompressionFormat:
   - m_BuildTarget: Android
@@ -527,6 +544,7 @@ PlayerSettings:
   locationUsageDescription: 
   microphoneUsageDescription: 
   bluetoothUsageDescription: 
+  macOSTargetOSVersion: 10.13.0
   switchNMETAOverride: 
   switchNetLibKey: 
   switchSocketMemoryPoolSize: 6144
@@ -538,6 +556,7 @@ PlayerSettings:
   switchLTOSetting: 0
   switchApplicationID: 0x01004b9000490000
   switchNSODependencies: 
+  switchCompilerFlags: 
   switchTitleNames_0: 
   switchTitleNames_1: 
   switchTitleNames_2: 
@@ -663,6 +682,7 @@ PlayerSettings:
   switchSocketBufferEfficiency: 4
   switchSocketInitializeEnabled: 1
   switchNetworkInterfaceManagerInitializeEnabled: 1
+  switchDisableHTCSPlayerConnection: 0
   switchUseNewStyleFilepaths: 0
   switchUseLegacyFmodPriorities: 1
   switchUseMicroSleepForYield: 1
@@ -752,6 +772,7 @@ PlayerSettings:
   webGLMemorySize: 32
   webGLExceptionSupport: 1
   webGLNameFilesAsHashes: 0
+  webGLShowDiagnostics: 0
   webGLDataCaching: 1
   webGLDebugSymbols: 0
   webGLEmscriptenArgs: 
@@ -764,6 +785,12 @@ PlayerSettings:
   webGLLinkerTarget: 1
   webGLThreadsSupport: 0
   webGLDecompressionFallback: 0
+  webGLInitialMemorySize: 32
+  webGLMaximumMemorySize: 2048
+  webGLMemoryGrowthMode: 2
+  webGLMemoryLinearGrowthStep: 16
+  webGLMemoryGeometricGrowthStep: 0.2
+  webGLMemoryGeometricGrowthCap: 96
   webGLPowerPreference: 2
   scriptingDefineSymbols:
     Android: ENABLE_LOG;TextMeshPro
@@ -773,8 +800,10 @@ PlayerSettings:
     Nintendo Switch: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro
     PS4: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro
     PS5: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro
+    QNX: TextMeshPro
     Stadia: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro
     Standalone: ENABLE_LOG;TextMeshPro
+    VisionOS: TextMeshPro
     WebGL: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro;ENABLE_LOG
     Windows Store Apps: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro;ENABLE_LOG
     XboxOne: UNITY_POST_PROCESSING_STACK_V2;TextMeshPro
@@ -784,6 +813,7 @@ PlayerSettings:
   platformArchitecture: {}
   scriptingBackend: {}
   il2cppCompilerConfiguration: {}
+  il2cppCodeGeneration: {}
   managedStrippingLevel:
     EmbeddedLinux: 1
     GameCoreScarlett: 1
@@ -802,11 +832,9 @@ PlayerSettings:
   suppressCommonWarnings: 1
   allowUnsafeCode: 0
   useDeterministicCompilation: 1
-  enableRoslynAnalyzers: 1
   additionalIl2CppArgs: 
   scriptingRuntimeVersion: 1
   gcIncremental: 1
-  assemblyVersionValidation: 1
   gcWBarrierValidation: 0
   apiCompatibilityLevelPerPlatform: {}
   m_RenderingPath: 1
@@ -879,6 +907,11 @@ PlayerSettings:
   luminVersion:
     m_VersionCode: 1
     m_VersionName: 
+  hmiPlayerDataPath: 
+  hmiForceSRGBBlit: 1
+  embeddedLinuxEnableGamepadInput: 1
+  hmiLogStartupTiming: 0
+  hmiCpuConfiguration: 
   apiCompatibilityLevel: 6
   activeInputHandler: 0
   windowsGamepadBackendHint: 0
@@ -889,6 +922,7 @@ PlayerSettings:
   organizationId: 
   cloudEnabled: 0
   legacyClampBlendShapeWeights: 0
-  playerDataPath: 
-  forceSRGBBlit: 1
+  hmiLoadingImage: {fileID: 0}
+  platformRequiresReadableAssets: 0
   virtualTexturingSupportEnabled: 0
+  insecureHttpOption: 0
diff --git a/UnityProject/ProjectSettings/ProjectVersion.txt b/UnityProject/ProjectSettings/ProjectVersion.txt
index 8386a05236..b852362343 100644
--- a/UnityProject/ProjectSettings/ProjectVersion.txt
+++ b/UnityProject/ProjectSettings/ProjectVersion.txt
@@ -1,2 +1,2 @@
-m_EditorVersion: 2021.3.45f1
-m_EditorVersionWithRevision: 2021.3.45f1 (0da89fac8e79)
+m_EditorVersion: 2022.3.62f2
+m_EditorVersionWithRevision: 2022.3.62f2 (7670c08855a9)
diff --git a/UnityProject/ProjectSettings/boot.config b/UnityProject/ProjectSettings/boot.config
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/UnityProject/UserSettings/Layouts/CurrentMaximizeLayout.dwlt b/UnityProject/UserSettings/Layouts/CurrentMaximizeLayout.dwlt
new file mode 100644
index 0000000000..1f0569cec2
--- /dev/null
+++ b/UnityProject/UserSettings/Layouts/CurrentMaximizeLayout.dwlt
@@ -0,0 +1,1088 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &1
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12010, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Children:
+  - {fileID: 3}
+  - {fileID: 13}
+  m_Position:
+    serializedVersion: 2
+    x: 0
+    y: 30
+    width: 1748
+    height: 1052
+  m_MinSize: {x: 400, y: 100}
+  m_MaxSize: {x: 32384, y: 16192}
+  vertical: 0
+  controlID: 3817
+  draggingID: 0
+--- !u!114 &2
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12015, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 200, y: 200}
+  m_MaxSize: {x: 4000, y: 4000}
+  m_TitleContent:
+    m_Text: Game
+    m_Image: {fileID: 4621777727084837110, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 606.5
+    y: 97
+    width: 643
+    height: 466
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData: []
+    m_OverlaysVisible: 1
+  m_SerializedViewNames: []
+  m_SerializedViewValues: []
+  m_PlayModeViewName: GameView
+  m_ShowGizmos: 0
+  m_TargetDisplay: 0
+  m_ClearColor: {r: 0, g: 0, b: 0, a: 0}
+  m_TargetSize: {x: 946, y: 2048}
+  m_TextureFilterMode: 0
+  m_TextureHideFlags: 61
+  m_RenderIMGUI: 1
+  m_EnterPlayModeBehavior: 0
+  m_UseMipMap: 0
+  m_VSyncEnabled: 0
+  m_Gizmos: 0
+  m_Stats: 0
+  m_SelectedSizes: 08000000000000002400000011000000000000000000000000000000000000000000000000000000
+  m_ZoomArea:
+    m_HRangeLocked: 0
+    m_VRangeLocked: 0
+    hZoomLockedByDefault: 0
+    vZoomLockedByDefault: 0
+    m_HBaseRangeMin: -236.5
+    m_HBaseRangeMax: 236.5
+    m_VBaseRangeMin: -512
+    m_VBaseRangeMax: 512
+    m_HAllowExceedBaseRangeMin: 1
+    m_HAllowExceedBaseRangeMax: 1
+    m_VAllowExceedBaseRangeMin: 1
+    m_VAllowExceedBaseRangeMax: 1
+    m_ScaleWithWindow: 0
+    m_HSlider: 0
+    m_VSlider: 0
+    m_IgnoreScrollWheelUntilClicked: 0
+    m_EnableMouseInput: 0
+    m_EnableSliderZoomHorizontal: 0
+    m_EnableSliderZoomVertical: 0
+    m_UniformScale: 1
+    m_UpDirection: 1
+    m_DrawArea:
+      serializedVersion: 2
+      x: 0
+      y: 21
+      width: 643
+      height: 445
+    m_Scale: {x: 0.4345703, y: 0.4345703}
+    m_Translation: {x: 321.5, y: 222.5}
+    m_MarginLeft: 0
+    m_MarginRight: 0
+    m_MarginTop: 0
+    m_MarginBottom: 0
+    m_LastShownAreaInsideMargins:
+      serializedVersion: 2
+      x: -739.8112
+      y: -512
+      width: 1479.6224
+      height: 1024
+    m_MinimalGUI: 1
+  m_defaultScale: 0.4345703
+  m_LastWindowPixelSize: {x: 1286, y: 932}
+  m_ClearInEditMode: 1
+  m_NoCameraWarning: 1
+  m_LowResolutionForAspectRatios: 01000000000000000000
+  m_XRRenderMode: 0
+  m_RenderTexture: {fileID: 0}
+  m_showToolbar: 1
+--- !u!114 &3
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12010, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Children:
+  - {fileID: 4}
+  - {fileID: 10}
+  m_Position:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 1200.5
+    height: 1052
+  m_MinSize: {x: 300, y: 100}
+  m_MaxSize: {x: 24288, y: 16192}
+  vertical: 1
+  controlID: 3818
+  draggingID: 0
+--- !u!114 &4
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12010, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Children:
+  - {fileID: 5}
+  - {fileID: 7}
+  - {fileID: 9}
+  m_Position:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 1200.5
+    height: 487
+  m_MinSize: {x: 300, y: 50}
+  m_MaxSize: {x: 24288, y: 8096}
+  vertical: 0
+  controlID: 3819
+  draggingID: 0
+--- !u!114 &5
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12006, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Children: []
+  m_Position:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 264.5
+    height: 487
+  m_MinSize: {x: 201, y: 221}
+  m_MaxSize: {x: 4001, y: 4021}
+  m_ActualView: {fileID: 6}
+  m_Panes:
+  - {fileID: 6}
+  m_Selected: 0
+  m_LastSelected: 0
+--- !u!114 &6
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12061, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 200, y: 200}
+  m_MaxSize: {x: 4000, y: 4000}
+  m_TitleContent:
+    m_Text: Hierarchy
+    m_Image: {fileID: -3734745235275155857, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 51
+    y: 97
+    width: 263.5
+    height: 466
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData: []
+    m_OverlaysVisible: 1
+  m_SceneHierarchy:
+    m_TreeViewState:
+      scrollPos: {x: 0, y: 0}
+      m_SelectedIDs: 
+      m_LastClickedID: 0
+      m_ExpandedIDs: e63effff1a43ffff4843ffff5043ffff8653ffff6867ffff6a67ffff4681fffff4ffffff
+      m_RenameOverlay:
+        m_UserAcceptedRename: 0
+        m_Name: 
+        m_OriginalName: 
+        m_EditFieldRect:
+          serializedVersion: 2
+          x: 0
+          y: 0
+          width: 0
+          height: 0
+        m_UserData: 0
+        m_IsWaitingForDelay: 0
+        m_IsRenaming: 0
+        m_OriginalEventType: 11
+        m_IsRenamingFilename: 0
+        m_ClientGUIView: {fileID: 5}
+      m_SearchString: 
+    m_ExpandedScenes: []
+    m_CurrenRootInstanceID: 0
+    m_LockTracker:
+      m_IsLocked: 0
+    m_CurrentSortingName: TransformSorting
+  m_WindowGUID: 4c969a2b90040154d917609493e03593
+--- !u!114 &7
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12006, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: SceneView
+  m_EditorClassIdentifier: 
+  m_Children: []
+  m_Position:
+    serializedVersion: 2
+    x: 264.5
+    y: 0
+    width: 291
+    height: 487
+  m_MinSize: {x: 202, y: 221}
+  m_MaxSize: {x: 4002, y: 4021}
+  m_ActualView: {fileID: 8}
+  m_Panes:
+  - {fileID: 8}
+  m_Selected: 0
+  m_LastSelected: 0
+--- !u!114 &8
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12013, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 200, y: 200}
+  m_MaxSize: {x: 4000, y: 4000}
+  m_TitleContent:
+    m_Text: Scene
+    m_Image: {fileID: 8634526014445323508, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 315.5
+    y: 97
+    width: 289
+    height: 466
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData:
+    - dockPosition: 0
+      containerId: overlay-toolbar__top
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: -176.5, y: -26}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 3
+      id: Tool Settings
+      index: 0
+      layout: 1
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 0
+      containerId: overlay-toolbar__top
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: -141, y: 149}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 1
+      id: unity-grid-and-snap-toolbar
+      index: 1
+      layout: 1
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-toolbar__top
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: 0, y: 25}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: unity-scene-view-toolbar
+      index: 0
+      layout: 1
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-toolbar__top
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 1
+      id: unity-search-toolbar
+      index: 1
+      layout: 1
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 0
+      containerId: overlay-container--left
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: 0, y: 25}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: unity-transform-toolbar
+      index: 0
+      layout: 2
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 0
+      containerId: overlay-container--left
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: 0, y: 197}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: unity-component-tools
+      index: 1
+      layout: 2
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 0
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: -91.5, y: 86}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 1
+      id: Orientation
+      index: 0
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Light Settings
+      index: 0
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Camera
+      index: 1
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Cloth Constraints
+      index: 1
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Cloth Collisions
+      index: 2
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Navmesh Display
+      index: 4
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Agent Display
+      index: 5
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Obstacle Display
+      index: 6
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Occlusion Culling
+      index: 3
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Physics Debugger
+      index: 4
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Scene Visibility
+      index: 5
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Particles
+      index: 6
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Tilemap
+      index: 11
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 0, y: 0}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Tilemap Palette Helper
+      index: 12
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 1
+      displayed: 1
+      snapOffset: {x: -156, y: -226.40002}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 3
+      id: AINavigationOverlay
+      index: 7
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/TrailRenderer
+      index: 7
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Open Tile Palette
+      index: 0
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/Tilemap Focus
+      index: 1
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: Floating
+      floating: 1
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Scene View/UI Particles
+      index: 0
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 1
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: UnityEditor.SceneViewCameraOverlay
+      index: 11
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: APV Overlay
+      index: 11
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    - dockPosition: 1
+      containerId: overlay-container--right
+      floating: 0
+      collapsed: 0
+      displayed: 0
+      snapOffset: {x: 48, y: 48}
+      snapOffsetDelta: {x: 0, y: 0}
+      snapCorner: 0
+      id: Cinemachine Tool Settings
+      index: 12
+      layout: 4
+      size: {x: 0, y: 0}
+      sizeOverriden: 0
+    m_OverlaysVisible: 1
+  m_WindowGUID: cc27987af1a868c49b0894db9c0f5429
+  m_Gizmos: 1
+  m_OverrideSceneCullingMask: 6917529027641081856
+  m_SceneIsLit: 1
+  m_SceneLighting: 1
+  m_2DMode: 1
+  m_isRotationLocked: 0
+  m_PlayAudio: 0
+  m_AudioPlay: 0
+  m_Position:
+    m_Target: {x: -0.14483713, y: 1.3861465, z: 0.04654099}
+    speed: 2
+    m_Value: {x: -0.14483713, y: 1.3861465, z: 0.04654099}
+  m_RenderMode: 0
+  m_CameraMode:
+    drawMode: 0
+    name: Shaded
+    section: Shading Mode
+  m_ValidateTrueMetals: 0
+  m_DoValidateTrueMetals: 0
+  m_SceneViewState:
+    m_AlwaysRefresh: 0
+    showFog: 1
+    showSkybox: 1
+    showFlares: 1
+    showImageEffects: 1
+    showParticleSystems: 1
+    showVisualEffectGraphs: 1
+    m_FxEnabled: 1
+  m_Grid:
+    xGrid:
+      m_Fade:
+        m_Target: 0
+        speed: 2
+        m_Value: 0
+      m_Color: {r: 0.5, g: 0.5, b: 0.5, a: 0.4}
+      m_Pivot: {x: 0, y: 0, z: 0}
+      m_Size: {x: 0, y: 0}
+    yGrid:
+      m_Fade:
+        m_Target: 0
+        speed: 2
+        m_Value: 0
+      m_Color: {r: 0.5, g: 0.5, b: 0.5, a: 0.4}
+      m_Pivot: {x: 0, y: 0, z: 0}
+      m_Size: {x: 1, y: 1}
+    zGrid:
+      m_Fade:
+        m_Target: 1
+        speed: 2
+        m_Value: 1
+      m_Color: {r: 0.5, g: 0.5, b: 0.5, a: 0.4}
+      m_Pivot: {x: 0, y: 0, z: 0}
+      m_Size: {x: 1, y: 1}
+    m_ShowGrid: 1
+    m_GridAxis: 1
+    m_gridOpacity: 0.5
+  m_Rotation:
+    m_Target: {x: 0, y: 0, z: 0, w: 1}
+    speed: 2
+    m_Value: {x: 0, y: 0, z: 0, w: 1}
+  m_Size:
+    m_Target: 5.346007
+    speed: 2
+    m_Value: 5.346007
+  m_Ortho:
+    m_Target: 1
+    speed: 2
+    m_Value: 1
+  m_CameraSettings:
+    m_Speed: 1
+    m_SpeedNormalized: 0.5
+    m_SpeedMin: 0.001
+    m_SpeedMax: 2
+    m_EasingEnabled: 1
+    m_EasingDuration: 0.4
+    m_AccelerationEnabled: 1
+    m_FieldOfViewHorizontalOrVertical: 60
+    m_NearClip: 0.03
+    m_FarClip: 10000
+    m_DynamicClip: 1
+    m_OcclusionCulling: 0
+  m_LastSceneViewRotation: {x: -0.08717229, y: 0.89959055, z: -0.21045254, w: -0.3726226}
+  m_LastSceneViewOrtho: 0
+  m_ReplacementShader: {fileID: 0}
+  m_ReplacementString: 
+  m_SceneVisActive: 1
+  m_LastLockedObject: {fileID: 0}
+  m_ViewIsLockedToObject: 0
+--- !u!114 &9
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 12006, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: GameView
+  m_EditorClassIdentifier: 
+  m_Children: []
+  m_Position:
+    serializedVersion: 2
+    x: 555.5
+    y: 0
+    width: 645
+    height: 487
+  m_MinSize: {x: 202, y: 221}
+  m_MaxSize: {x: 4002, y: 4021}
+  m_ActualView: {fileID: 2}
+  m_Panes:
+  - {fileID: 2}
+  m_Selected: 0
+  m_LastSelected: 0
+--- !u!114 &10
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12006, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: ConsoleWindow
+  m_EditorClassIdentifier: 
+  m_Children: []
+  m_Position:
+    serializedVersion: 2
+    x: 0
+    y: 487
+    width: 1200.5
+    height: 565
+  m_MinSize: {x: 101, y: 121}
+  m_MaxSize: {x: 4001, y: 4021}
+  m_ActualView: {fileID: 12}
+  m_Panes:
+  - {fileID: 11}
+  - {fileID: 12}
+  m_Selected: 1
+  m_LastSelected: 0
+--- !u!114 &11
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12014, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 230, y: 250}
+  m_MaxSize: {x: 10000, y: 10000}
+  m_TitleContent:
+    m_Text: Project
+    m_Image: {fileID: -5179483145760003458, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 52
+    y: 584
+    width: 1199.5
+    height: 544
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData: []
+    m_OverlaysVisible: 1
+  m_SearchFilter:
+    m_NameFilter: 
+    m_ClassNames: []
+    m_AssetLabels: []
+    m_AssetBundleNames: []
+    m_ReferencingInstanceIDs: 
+    m_SceneHandles: 
+    m_ShowAllHits: 0
+    m_SkipHidden: 0
+    m_SearchArea: 1
+    m_Folders:
+    - Assets/GameScripts/HotFix/GameLogic/UI/TestUITK
+    m_Globs: []
+    m_OriginalText: 
+    m_ImportLogFlags: 0
+    m_FilterByTypeIntersection: 0
+  m_ViewMode: 1
+  m_StartGridSize: 16
+  m_LastFolders:
+  - Assets/GameScripts/HotFix/GameLogic/UI/TestUITK
+  m_LastFoldersGridSize: -1
+  m_LastProjectPath: /Users/wiesenwang/UnityProject/TEngine/UnityProject
+  m_LockTracker:
+    m_IsLocked: 0
+  m_FolderTreeState:
+    scrollPos: {x: 0, y: 292}
+    m_SelectedIDs: ea6f0000
+    m_LastClickedID: 28650
+    m_ExpandedIDs: 00000000064100004e410000b2410000be410000d641000066420000964200000643000062440000ee44000082450000da46000022470000de6f0000e26f0000ee6f000000ca9a3bffffff7f
+    m_RenameOverlay:
+      m_UserAcceptedRename: 0
+      m_Name: 
+      m_OriginalName: 
+      m_EditFieldRect:
+        serializedVersion: 2
+        x: 0
+        y: 0
+        width: 0
+        height: 0
+      m_UserData: 0
+      m_IsWaitingForDelay: 0
+      m_IsRenaming: 0
+      m_OriginalEventType: 11
+      m_IsRenamingFilename: 1
+      m_ClientGUIView: {fileID: 10}
+    m_SearchString: 
+    m_CreateAssetUtility:
+      m_EndAction: {fileID: 0}
+      m_InstanceID: 0
+      m_Path: 
+      m_Icon: {fileID: 0}
+      m_ResourceFile: 
+  m_AssetTreeState:
+    scrollPos: {x: 0, y: 0}
+    m_SelectedIDs: 
+    m_LastClickedID: 0
+    m_ExpandedIDs: 00000000064100004e410000b2410000be410000d641000066420000964200000643000062440000ee440000da46000022470000de6f0000e26f000000ca9a3bffffff7f
+    m_RenameOverlay:
+      m_UserAcceptedRename: 0
+      m_Name: 
+      m_OriginalName: 
+      m_EditFieldRect:
+        serializedVersion: 2
+        x: 0
+        y: 0
+        width: 0
+        height: 0
+      m_UserData: 0
+      m_IsWaitingForDelay: 0
+      m_IsRenaming: 0
+      m_OriginalEventType: 11
+      m_IsRenamingFilename: 1
+      m_ClientGUIView: {fileID: 0}
+    m_SearchString: 
+    m_CreateAssetUtility:
+      m_EndAction: {fileID: 0}
+      m_InstanceID: 0
+      m_Path: 
+      m_Icon: {fileID: 0}
+      m_ResourceFile: 
+  m_ListAreaState:
+    m_SelectedInstanceIDs: 
+    m_LastClickedInstanceID: 0
+    m_HadKeyboardFocusLastEvent: 1
+    m_ExpandedInstanceIDs: c6230000bc2b04000cb1010068070100feaf01003e7401005a3901008835030092350300b2a70100b2730100b0730100e0700100d0700100ba8b0b008c0a010000000000522d03006a790100
+    m_RenameOverlay:
+      m_UserAcceptedRename: 0
+      m_Name: 
+      m_OriginalName: 
+      m_EditFieldRect:
+        serializedVersion: 2
+        x: 0
+        y: 0
+        width: 0
+        height: 0
+      m_UserData: 0
+      m_IsWaitingForDelay: 0
+      m_IsRenaming: 0
+      m_OriginalEventType: 11
+      m_IsRenamingFilename: 1
+      m_ClientGUIView: {fileID: 10}
+    m_CreateAssetUtility:
+      m_EndAction: {fileID: 0}
+      m_InstanceID: 0
+      m_Path: 
+      m_Icon: {fileID: 0}
+      m_ResourceFile: 
+    m_NewAssetIndexInList: -1
+    m_ScrollPosition: {x: 0, y: 0}
+    m_GridSize: 16
+  m_SkipHiddenPackages: 0
+  m_DirectoriesAreaWidth: 384
+--- !u!114 &12
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12003, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 100, y: 100}
+  m_MaxSize: {x: 4000, y: 4000}
+  m_TitleContent:
+    m_Text: Console
+    m_Image: {fileID: -4950941429401207979, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 51
+    y: 584
+    width: 1199.5
+    height: 544
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData: []
+    m_OverlaysVisible: 1
+--- !u!114 &13
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12006, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Children: []
+  m_Position:
+    serializedVersion: 2
+    x: 1200.5
+    y: 0
+    width: 547.5
+    height: 1052
+  m_MinSize: {x: 276, y: 71}
+  m_MaxSize: {x: 4001, y: 4021}
+  m_ActualView: {fileID: 14}
+  m_Panes:
+  - {fileID: 14}
+  m_Selected: 0
+  m_LastSelected: 0
+--- !u!114 &14
+MonoBehaviour:
+  m_ObjectHideFlags: 52
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 1
+  m_Script: {fileID: 12019, guid: 0000000000000000e000000000000000, type: 0}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_MinSize: {x: 275, y: 50}
+  m_MaxSize: {x: 4000, y: 4000}
+  m_TitleContent:
+    m_Text: Inspector
+    m_Image: {fileID: -440750813802333266, guid: 0000000000000000d000000000000000, type: 0}
+    m_Tooltip: 
+  m_Pos:
+    serializedVersion: 2
+    x: 1251.5
+    y: 97
+    width: 546.5
+    height: 1031
+  m_SerializedDataModeController:
+    m_DataMode: 0
+    m_PreferredDataMode: 0
+    m_SupportedDataModes: 
+    isAutomatic: 1
+  m_ViewDataDictionary: {fileID: 0}
+  m_OverlayCanvas:
+    m_LastAppliedPresetName: Default
+    m_SaveData: []
+    m_OverlaysVisible: 1
+  m_ObjectsLockedBeforeSerialization: []
+  m_InstanceIDsLockedBeforeSerialization: 
+  m_PreviewResizer:
+    m_CachedPref: 625
+    m_ControlHash: -371814159
+    m_PrefName: Preview_InspectorPreview
+  m_LastInspectedObjectInstanceID: -1
+  m_LastVerticalScrollValue: 0
+  m_GlobalObjectId: 
+  m_InspectorMode: 0
+  m_LockTracker:
+    m_IsLocked: 0
+  m_PreviewWindow: {fileID: 0}
diff --git a/docs/superpowers/plans/2026-06-11-uitk-module-plan1-core.md b/docs/superpowers/plans/2026-06-11-uitk-module-plan1-core.md
new file mode 100644
index 0000000000..99d62e957f
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-11-uitk-module-plan1-core.md
@@ -0,0 +1,1760 @@
+# UITKModule Plan 1: Core Framework Implementation
+
+> **状态**: ✅ 已完成
+
+**Goal:** Build the UITKModule core framework skeleton — module singleton, 5-layer panel management, window/widget lifecycle, resource loading, and animation system — enabling manual-binding style UI development on top of UIToolkit.
+
+**Architecture:** Pure C# module (Singleton + IUpdate), 5 UIDocument panels for layer isolation, UITKWindow/UITKWidget classes mirroring existing UIModule lifecycle. Resource loading via IUITKResourceLoader abstraction delegating to YooAsset/Resources.
+
+**Tech Stack:** Unity 2022.3 UI Toolkit, UniTask, YooAsset, TEngine Module System
+
+**Spec Reference:** `docs/superpowers/specs/2026-06-11-uitk-module-design.md`
+
+**Depends On:** Existing TEngine framework (GameEvent, GameModule.Resource, Timer, MemoryPool)
+
+---
+
+## File Map
+
+| Action | Path | Responsibility |
+|--------|------|---------------|
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs` | Module singleton, IUpdate, initialization |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs` | 5-layer panel creation and management |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs` | Window stack Push/Pop/Sort/Visible logic |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs` | Animation invocation and preset dispatch |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs` | Base class: events, child list, update dirty |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs` | Window: lifecycle, visible, depth, animation hooks |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs` | Widget: independent UXML, parent-child |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs` | [UIWindow] attribute for window metadata |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs` | Resource loader interface |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs` | Default implementation (YooAsset + Resources) |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs` | Animation driver interface |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs` | Default USS transition driver |
+| Create | `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs` | Animation preset enum |
+| Create | `Assets/AssetRaw/UITK/Shared/Settings/PanelSettings_Bottom.asset` | PanelSettings for Bottom layer (Editor-created) |
+| Create | `Assets/AssetRaw/UITK/Shared/Settings/PanelSettings_UI.asset` | PanelSettings for UI layer |
+| Create | `Assets/AssetRaw/UITK/Shared/Settings/PanelSettings_Top.asset` | PanelSettings for Top layer |
+| Create | `Assets/AssetRaw/UITK/Shared/Settings/PanelSettings_Tips.asset` | PanelSettings for Tips layer |
+| Create | `Assets/AssetRaw/UITK/Shared/Settings/PanelSettings_System.asset` | PanelSettings for System layer |
+| Create | `Assets/AssetRaw/UITK/Shared/Styles/variables.uss` | CSS variables foundation |
+| Create | `Assets/AssetRaw/UITK/Shared/Styles/common.uss` | Common styles |
+
+---
+
+## Task 1: UITKAnimationType Enum + IUITKAnimationDriver Interface
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/UITKAnimationType.cs`
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/IUITKAnimationDriver.cs`
+
+- [ ] **Step 1: Create UITKAnimationType.cs**
+
+```csharp
+namespace GameLogic
+{
+    /// <summary>
+    /// 内置动画预设类型。
+    /// </summary>
+    public enum UITKAnimationType
+    {
+        None,
+        FadeIn,
+        FadeOut,
+        SlideFromBottom,
+        SlideToBottom,
+        SlideFromRight,
+        SlideToRight,
+        ScaleIn,
+        ScaleOut,
+    }
+}
+```
+
+- [ ] **Step 2: Create IUITKAnimationDriver.cs**
+
+```csharp
+using Cysharp.Threading.Tasks;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 动画驱动器接口。默认使用 USS Transition，可替换为 DOTween 等实现。
+    /// </summary>
+    public interface IUITKAnimationDriver
+    {
+        /// <summary>
+        /// 播放动画。
+        /// </summary>
+        /// <param name="target">目标 VisualElement。</param>
+        /// <param name="type">动画类型。</param>
+        /// <param name="isShow">true=显示动画，false=隐藏动画。</param>
+        /// <param name="durationMs">动画时长（毫秒）。</param>
+        UniTask Play(VisualElement target, UITKAnimationType type, bool isShow, int durationMs);
+    }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/
+git commit -m "feat(uitk): add UITKAnimationType enum and IUITKAnimationDriver interface"
+```
+
+---
+
+## Task 2: USSAnimationDriver Default Implementation
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs`
+
+- [ ] **Step 1: Create USSAnimationDriver.cs**
+
+```csharp
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 默认动画驱动器，使用 USS Transition 实现。
+    /// </summary>
+    public class USSAnimationDriver : IUITKAnimationDriver
+    {
+        public async UniTask Play(VisualElement target, UITKAnimationType type, bool isShow, int durationMs)
+        {
+            if (type == UITKAnimationType.None || target == null)
+                return;
+
+            // 1. 设置初始状态（无过渡）
+            SetTransitionDuration(target, 0);
+            ApplyState(target, type, isStart: true, isShow);
+
+            // 等一帧让初始状态生效
+            await UniTask.Yield();
+
+            // 2. 设置过渡 + 目标状态
+            SetTransitionDuration(target, durationMs);
+            ApplyState(target, type, isStart: false, isShow);
+
+            // 3. 等待过渡完成
+            await UniTask.Delay(durationMs);
+        }
+
+        private void SetTransitionDuration(VisualElement target, int ms)
+        {
+            target.style.transitionDuration = new List<TimeValue> { new TimeValue(ms, TimeUnit.Millisecond) };
+            target.style.transitionProperty = new List<StylePropertyName>
+            {
+                new StylePropertyName("opacity"),
+                new StylePropertyName("translate"),
+                new StylePropertyName("scale"),
+            };
+            target.style.transitionTimingFunction = new List<EasingFunction> { new EasingFunction(EasingMode.EaseOutCubic) };
+        }
+
+        private void ApplyState(VisualElement target, UITKAnimationType type, bool isStart, bool isShow)
+        {
+            // isStart=true 表示动画起始状态，isStart=false 表示动画目标状态
+            bool atOrigin = isShow ? isStart : !isStart;
+
+            switch (type)
+            {
+                case UITKAnimationType.FadeIn:
+                case UITKAnimationType.FadeOut:
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.SlideFromBottom:
+                case UITKAnimationType.SlideToBottom:
+                    target.style.translate = atOrigin
+                        ? new Translate(0, Length.Percent(100))
+                        : new Translate(0, 0);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.SlideFromRight:
+                case UITKAnimationType.SlideToRight:
+                    target.style.translate = atOrigin
+                        ? new Translate(Length.Percent(100), 0)
+                        : new Translate(0, 0);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+
+                case UITKAnimationType.ScaleIn:
+                case UITKAnimationType.ScaleOut:
+                    target.style.scale = atOrigin
+                        ? new Scale(new Vector3(0.8f, 0.8f, 1f))
+                        : new Scale(Vector3.one);
+                    target.style.opacity = atOrigin ? 0f : 1f;
+                    break;
+            }
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Animation/USSAnimationDriver.cs
+git commit -m "feat(uitk): implement USSAnimationDriver with USS transition presets"
+```
+
+---
+
+## Task 3: IUITKResourceLoader Interface + Default Implementation
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/IUITKResourceLoader.cs`
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/UITKResourceLoader.cs`
+
+- [ ] **Step 1: Create IUITKResourceLoader.cs**
+
+```csharp
+using System.Threading;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 资源加载器接口。
+    /// </summary>
+    public interface IUITKResourceLoader
+    {
+        VisualTreeAsset LoadVisualTreeAsset(string location, string packageName = "");
+        UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location, CancellationToken ct = default, string packageName = "");
+        StyleSheet LoadStyleSheet(string location, string packageName = "");
+        UniTask<StyleSheet> LoadStyleSheetAsync(string location, CancellationToken ct = default, string packageName = "");
+        PanelSettings LoadPanelSettings(string location, string packageName = "");
+        void Unload(Object asset);
+    }
+}
+```
+
+- [ ] **Step 2: Create UITKResourceLoader.cs**
+
+```csharp
+using System.Threading;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// 默认 UIToolkit 资源加载器。委托给 YooAsset (IResourceModule)。
+    /// </summary>
+    public class UITKResourceLoader : IUITKResourceLoader
+    {
+        private readonly IResourceModule _resource = ModuleSystem.GetModule<IResourceModule>();
+
+        public VisualTreeAsset LoadVisualTreeAsset(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<VisualTreeAsset>(location, packageName);
+        }
+
+        public async UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location, CancellationToken ct = default, string packageName = "")
+        {
+            return await _resource.LoadAssetAsync<VisualTreeAsset>(location, ct, packageName);
+        }
+
+        public StyleSheet LoadStyleSheet(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<StyleSheet>(location, packageName);
+        }
+
+        public async UniTask<StyleSheet> LoadStyleSheetAsync(string location, CancellationToken ct = default, string packageName = "")
+        {
+            return await _resource.LoadAssetAsync<StyleSheet>(location, ct, packageName);
+        }
+
+        public PanelSettings LoadPanelSettings(string location, string packageName = "")
+        {
+            return _resource.LoadAsset<PanelSettings>(location, packageName);
+        }
+
+        public void Unload(Object asset)
+        {
+            _resource.UnloadAsset(asset);
+        }
+    }
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Resource/
+git commit -m "feat(uitk): add IUITKResourceLoader interface and YooAsset implementation"
+```
+
+---
+
+## Task 4: UIWindowAttribute
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs`
+
+- [ ] **Step 1: Create UIWindowAttribute.cs**
+
+```csharp
+using System;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 窗口声明特性。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+    public class UIWindowAttribute : Attribute
+    {
+        /// <summary>
+        /// 窗口层级。
+        /// </summary>
+        public UILayer Layer { get; }
+
+        /// <summary>
+        /// 资源定位地址。空则使用类名。
+        /// </summary>
+        public string Location { get; set; } = "";
+
+        /// <summary>
+        /// 是否全屏窗口（用于遮挡下层）。
+        /// </summary>
+        public bool FullScreen { get; set; } = false;
+
+        /// <summary>
+        /// 是否从 Resources 加载（不走 AB）。
+        /// </summary>
+        public bool FromResources { get; set; } = false;
+
+        /// <summary>
+        /// 隐藏后自动关闭时间（秒）。0 表示立即关闭。
+        /// </summary>
+        public int HideTimeToClose { get; set; } = 10;
+
+        /// <summary>
+        /// YooAsset 资源包名。空则使用默认包。
+        /// </summary>
+        public string Package { get; set; } = "";
+
+        public UIWindowAttribute(UILayer layer)
+        {
+            Layer = layer;
+        }
+
+        public UIWindowAttribute(UILayer layer, bool fullScreen)
+        {
+            Layer = layer;
+            FullScreen = fullScreen;
+        }
+    }
+
+    /// <summary>
+    /// UI 层级枚举。
+    /// </summary>
+    public enum UILayer
+    {
+        Bottom = 0,
+        UI = 1,
+        Top = 2,
+        Tips = 3,
+        System = 4,
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UIWindowAttribute.cs
+git commit -m "feat(uitk): add UIWindowAttribute and UILayer enum"
+```
+
+---
+
+## Task 5: UITKBase — Base Class
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs`
+
+- [ ] **Step 1: Create UITKBase.cs**
+
+```csharp
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit UI 基类。
+    /// </summary>
+    public class UITKBase
+    {
+        /// <summary>
+        /// 依赖注入回调。
+        /// </summary>
+        public static Action<UITKBase> Injector;
+
+        public enum UIType { None, Window, Widget }
+
+        /// <summary>
+        /// 父 UI 节点。
+        /// </summary>
+        protected UITKBase _parent;
+        public UITKBase Parent => _parent;
+
+        /// <summary>
+        /// 自定义数据集。
+        /// </summary>
+        protected object[] _userDatas;
+        public object UserData => _userDatas is { Length: >= 1 } ? _userDatas[0] : null;
+        public object[] UserDatas => _userDatas;
+
+        /// <summary>
+        /// 根 VisualElement。
+        /// </summary>
+        public virtual VisualElement RootElement { get; protected set; }
+
+        /// <summary>
+        /// UI 类型。
+        /// </summary>
+        public virtual UIType Type => UIType.None;
+
+        /// <summary>
+        /// 资源是否加载完毕。
+        /// </summary>
+        public bool IsPrepare { get; protected set; }
+
+        /// <summary>
+        /// 子 Widget 列表。
+        /// </summary>
+        internal readonly List<UITKWidget> ListChild = new List<UITKWidget>();
+
+        /// <summary>
+        /// 有 Update 行为的子 Widget 列表。
+        /// </summary>
+        protected List<UITKWidget> _listUpdateChild;
+
+        /// <summary>
+        /// Update 列表是否有效。
+        /// </summary>
+        protected bool _updateListValid = false;
+
+        /// <summary>
+        /// 是否需要 Update。
+        /// </summary>
+        protected bool _hasOverrideUpdate = true;
+
+        // ━━━ 生命周期钩子 ━━━
+
+        protected virtual void OnCreate() { }
+        protected virtual void OnRefresh() { }
+        protected virtual void OnUpdate() { _hasOverrideUpdate = false; }
+        protected virtual void OnDestroy() { }
+        protected virtual void OnSetVisible(bool visible) { }
+        protected virtual void OnSortDepth() { }
+
+        /// <summary>
+        /// 依赖注入。
+        /// </summary>
+        protected void Inject()
+        {
+            Injector?.Invoke(this);
+        }
+
+        /// <summary>
+        /// 注册事件（子类重写）。
+        /// </summary>
+        protected virtual void RegisterEvent() { }
+
+        internal void SetUpdateDirty()
+        {
+            _updateListValid = false;
+            Parent?.SetUpdateDirty();
+        }
+
+        internal void CallDestroy()
+        {
+            OnDestroy();
+        }
+
+        // ━━━ 事件系统 ━━━
+
+        private GameEventMgr _eventMgr;
+
+        protected GameEventMgr EventMgr
+        {
+            get
+            {
+                if (_eventMgr == null)
+                {
+                    _eventMgr = MemoryPool.Acquire<GameEventMgr>();
+                }
+                return _eventMgr;
+            }
+        }
+
+        public void AddUIEvent(int eventType, Action handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T>(int eventType, Action<T> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U>(int eventType, Action<T, U> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U, V>(int eventType, Action<T, U, V> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void AddUIEvent<T, U, V, W>(int eventType, Action<T, U, V, W> handler)
+        {
+            EventMgr.AddEvent(eventType, handler);
+        }
+
+        protected void RemoveAllUIEvent()
+        {
+            if (_eventMgr != null)
+            {
+                MemoryPool.Release(_eventMgr);
+                _eventMgr = null;
+            }
+        }
+
+        // ━━━ Widget 工厂方法 ━━━
+
+        /// <summary>
+        /// 通过父节点上已有的子元素创建 Widget（同步，元素已存在）。
+        /// </summary>
+        public T CreateWidget<T>(VisualElement widgetRoot, bool visible = true) where T : UITKWidget, new()
+        {
+            var widget = new T();
+            if (widget.Create(this, widgetRoot, visible))
+            {
+                return widget;
+            }
+            return null;
+        }
+
+        /// <summary>
+        /// 通过资源路径异步创建 Widget。
+        /// </summary>
+        public async UniTask<T> CreateWidgetAsync<T>(VisualElement parentElement, string assetLocation = null, bool visible = true) where T : UITKWidget, new()
+        {
+            string location = assetLocation ?? typeof(T).Name;
+            var widget = new T();
+            await widget.CreateByPath(this, parentElement, location, visible);
+            return widget;
+        }
+
+        /// <summary>
+        /// 通过类型名创建 Widget（资源名 = 类名）。
+        /// </summary>
+        public async UniTask<T> CreateWidgetByTypeAsync<T>(VisualElement parentElement, bool visible = true) where T : UITKWidget, new()
+        {
+            return await CreateWidgetAsync<T>(parentElement, typeof(T).Name, visible);
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKBase.cs
+git commit -m "feat(uitk): add UITKBase with lifecycle hooks, events, and widget factory"
+```
+
+---
+
+## Task 6: UITKWindow — Window Implementation
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs`
+
+- [ ] **Step 1: Create UITKWindow.cs**
+
+```csharp
+using System;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 窗口基类。
+    /// </summary>
+    public abstract class UITKWindow : UITKBase
+    {
+        // ━━━ 属性 ━━━
+
+        public override UIType Type => UIType.Window;
+        public string WindowName { get; private set; }
+        public int WindowLayer { get; private set; }
+        public string AssetName { get; private set; }
+        public virtual bool FullScreen { get; private set; }
+        public bool FromResources { get; private set; }
+        public int HideTimeToClose { get; set; }
+        public string Package { get; private set; }
+        public int HideTimerId { get; set; }
+        public bool IsLoadDone { get; private set; }
+        public bool IsHide { get; set; }
+
+        private bool _isCreate;
+        private bool _isDestroyed;
+        private VisualTreeAsset _visualTreeAsset;
+        private Action<UITKWindow> _prepareCallback;
+
+        // ━━━ 动画配置 ━━━
+
+        protected virtual UITKAnimationType ShowAnimation => UITKAnimationType.FadeIn;
+        protected virtual UITKAnimationType HideAnimation => UITKAnimationType.FadeOut;
+        protected virtual int AnimationDuration => 200;
+
+        protected virtual UniTask OnShowAnimation()
+        {
+            return UITKModule.Instance.AnimationDriver.Play(RootElement, ShowAnimation, true, AnimationDuration);
+        }
+
+        protected virtual UniTask OnHideAnimation()
+        {
+            return UITKModule.Instance.AnimationDriver.Play(RootElement, HideAnimation, false, AnimationDuration);
+        }
+
+        // ━━━ 可见性 ━━━
+
+        private bool _visible;
+        public bool Visible
+        {
+            get => _visible;
+            set
+            {
+                if (_visible == value) return;
+                _visible = value;
+                if (RootElement != null)
+                {
+                    RootElement.style.display = value ? DisplayStyle.Flex : DisplayStyle.None;
+                    RootElement.pickingMode = value ? PickingMode.Position : PickingMode.Ignore;
+                }
+                if (_isCreate)
+                {
+                    OnSetVisible(value);
+                }
+            }
+        }
+
+        // ━━━ 初始化 ━━━
+
+        internal void Init(string windowName, int windowLayer, bool fullScreen, string assetName, bool fromResources, int hideTimeToClose, string package)
+        {
+            WindowName = windowName;
+            WindowLayer = windowLayer;
+            FullScreen = fullScreen;
+            AssetName = assetName;
+            FromResources = fromResources;
+            HideTimeToClose = hideTimeToClose;
+            Package = package;
+        }
+
+        // ━━━ 加载流程 ━━━
+
+        internal async UniTaskVoid InternalLoad(string assetName, Action<UITKWindow> prepareCallback, bool isAsync, params object[] userDatas)
+        {
+            _prepareCallback = prepareCallback;
+            _userDatas = userDatas;
+
+            if (FromResources)
+            {
+                _visualTreeAsset = Resources.Load<VisualTreeAsset>(assetName);
+            }
+            else if (isAsync)
+            {
+                _visualTreeAsset = await UITKModule.Resource.LoadVisualTreeAssetAsync(assetName, default, Package);
+            }
+            else
+            {
+                _visualTreeAsset = UITKModule.Resource.LoadVisualTreeAsset(assetName, Package);
+            }
+
+            HandleLoadCompleted();
+        }
+
+        private void HandleLoadCompleted()
+        {
+            IsLoadDone = true;
+
+            if (_isDestroyed)
+            {
+                ReleaseAsset();
+                return;
+            }
+
+            // CloneTree 生成根 VisualElement
+            RootElement = _visualTreeAsset.CloneTree();
+            RootElement.name = WindowName;
+
+            // 确保 root 撑满父容器
+            RootElement.style.flexGrow = 1;
+            RootElement.style.position = Position.Absolute;
+            RootElement.style.left = 0;
+            RootElement.style.right = 0;
+            RootElement.style.top = 0;
+            RootElement.style.bottom = 0;
+
+            // 挂载到对应层 Panel
+            UITKModule.Instance.AttachToLayer(this);
+
+            IsPrepare = true;
+            _prepareCallback?.Invoke(this);
+        }
+
+        // ━━━ 生命周期内部方法 ━━━
+
+        internal void InternalCreate()
+        {
+            if (_isCreate) return;
+            _isCreate = true;
+            Inject();
+            OnCreate();
+            RegisterEvent();
+        }
+
+        internal void InternalRefresh()
+        {
+            OnRefresh();
+        }
+
+        internal void InternalUpdate()
+        {
+            if (!IsPrepare || !_visible) return;
+
+            OnUpdate();
+
+            if (ListChild.Count > 0)
+            {
+                if (!_updateListValid)
+                {
+                    _listUpdateChild ??= new();
+                    _listUpdateChild.Clear();
+                    for (int i = 0; i < ListChild.Count; i++)
+                    {
+                        if (ListChild[i]._hasOverrideUpdate)
+                        {
+                            _listUpdateChild.Add(ListChild[i]);
+                        }
+                    }
+                    _updateListValid = true;
+                }
+
+                if (_listUpdateChild != null)
+                {
+                    for (int i = 0; i < _listUpdateChild.Count; i++)
+                    {
+                        _listUpdateChild[i].InternalUpdate();
+                    }
+                }
+            }
+        }
+
+        internal void InternalDestroy(bool isShutDown = false)
+        {
+            _isDestroyed = true;
+
+            if (!isShutDown)
+            {
+                CancelHideToCloseTimer();
+            }
+
+            OnDestroy();
+            RemoveAllUIEvent();
+
+            // 销毁子 Widget
+            for (int i = ListChild.Count - 1; i >= 0; i--)
+            {
+                ListChild[i].Destroy();
+            }
+            ListChild.Clear();
+
+            // 从 Panel 树移除
+            RootElement?.RemoveFromHierarchy();
+
+            // 释放资源
+            ReleaseAsset();
+        }
+
+        internal void CancelHideToCloseTimer()
+        {
+            if (HideTimerId > 0)
+            {
+                GameModule.Timer.RemoveTimer(HideTimerId);
+                HideTimerId = 0;
+            }
+        }
+
+        private void ReleaseAsset()
+        {
+            if (_visualTreeAsset != null && !FromResources)
+            {
+                UITKModule.Resource.Unload(_visualTreeAsset);
+                _visualTreeAsset = null;
+            }
+        }
+
+        // ━━━ TryInvoke (重新 Show 已存在窗口) ━━━
+
+        internal void TryInvoke(Action<UITKWindow> prepareCallback, params object[] userDatas)
+        {
+            CancelHideToCloseTimer();
+            IsHide = false;
+            _userDatas = userDatas;
+
+            if (IsPrepare)
+            {
+                prepareCallback?.Invoke(this);
+            }
+            else
+            {
+                _prepareCallback = prepareCallback;
+            }
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWindow.cs
+git commit -m "feat(uitk): add UITKWindow with full lifecycle, visibility, and animation"
+```
+
+---
+
+## Task 7: UITKWidget — Widget Implementation
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs`
+
+- [ ] **Step 1: Create UITKWidget.cs**
+
+```csharp
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit Widget 组件基类。独立 UXML，有完整生命周期。
+    /// </summary>
+    public class UITKWidget : UITKBase
+    {
+        public override UIType Type => UIType.Widget;
+
+        private VisualTreeAsset _widgetAsset;
+        private bool _fromResource;
+
+        /// <summary>
+        /// 获取所属 Window（向上遍历）。
+        /// </summary>
+        public UITKWindow OwnerWindow
+        {
+            get
+            {
+                var current = _parent;
+                while (current != null)
+                {
+                    if (current.Type == UIType.Window)
+                        return current as UITKWindow;
+                    current = current.Parent;
+                }
+                return null;
+            }
+        }
+
+        // ━━━ 列表虚拟化支持 ━━━
+
+        /// <summary>
+        /// ListView 虚拟化绑定数据。
+        /// </summary>
+        public virtual void OnBindData(object data, int index) { }
+
+        /// <summary>
+        /// ListView 虚拟化解绑数据。
+        /// </summary>
+        public virtual void OnUnbindData() { }
+
+        // ━━━ 创建路径 ━━━
+
+        /// <summary>
+        /// 通过已存在的 VisualElement 创建（同步）。
+        /// </summary>
+        internal bool Create(UITKBase parent, VisualElement widgetRoot, bool visible)
+        {
+            _parent = parent;
+            RootElement = widgetRoot;
+
+            if (RootElement == null)
+            {
+                Log.Error($"UITKWidget Create failed: widgetRoot is null for {GetType().Name}");
+                return false;
+            }
+
+            InitWidget(visible);
+            return true;
+        }
+
+        /// <summary>
+        /// 通过资源路径异步创建。
+        /// </summary>
+        internal async UniTask CreateByPath(UITKBase parent, VisualElement parentElement, string location, bool visible)
+        {
+            _parent = parent;
+
+            _widgetAsset = await UITKModule.Resource.LoadVisualTreeAssetAsync(location);
+            RootElement = _widgetAsset.CloneTree();
+            parentElement.Add(RootElement);
+
+            InitWidget(visible);
+        }
+
+        /// <summary>
+        /// 通过 Resources 同步创建。
+        /// </summary>
+        internal bool CreateFromResources(UITKBase parent, VisualElement parentElement, string location, bool visible)
+        {
+            _parent = parent;
+            _fromResource = true;
+
+            _widgetAsset = UnityEngine.Resources.Load<VisualTreeAsset>(location);
+            if (_widgetAsset == null)
+            {
+                Log.Error($"UITKWidget CreateFromResources failed: {location} not found");
+                return false;
+            }
+
+            RootElement = _widgetAsset.CloneTree();
+            parentElement.Add(RootElement);
+
+            InitWidget(visible);
+            return true;
+        }
+
+        private void InitWidget(bool visible)
+        {
+            // 注册到父节点
+            _parent.ListChild.Add(this);
+            _parent.SetUpdateDirty();
+
+            // 生命周期
+            Inject();
+            OnCreate();
+            RegisterEvent();
+            OnRefresh();
+
+            IsPrepare = true;
+
+            // 可见性
+            if (!visible)
+            {
+                RootElement.style.display = DisplayStyle.None;
+            }
+        }
+
+        // ━━━ 销毁 ━━━
+
+        /// <summary>
+        /// 销毁 Widget。
+        /// </summary>
+        public void Destroy()
+        {
+            _parent?.ListChild.Remove(this);
+            _parent?.SetUpdateDirty();
+            InternalDestroy();
+        }
+
+        internal void InternalDestroy()
+        {
+            OnDestroy();
+            RemoveAllUIEvent();
+
+            // 递归销毁子 Widget
+            for (int i = ListChild.Count - 1; i >= 0; i--)
+            {
+                ListChild[i].Destroy();
+            }
+            ListChild.Clear();
+
+            // 从树移除
+            RootElement?.RemoveFromHierarchy();
+
+            // 释放资源
+            if (_widgetAsset != null && !_fromResource)
+            {
+                UITKModule.Resource.Unload(_widgetAsset);
+                _widgetAsset = null;
+            }
+        }
+
+        // ━━━ Update ━━━
+
+        internal void InternalUpdate()
+        {
+            if (!IsPrepare) return;
+            OnUpdate();
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Base/UITKWidget.cs
+git commit -m "feat(uitk): add UITKWidget with independent UXML, lifecycle, and list support"
+```
+
+---
+
+## Task 8: UITKModule Singleton — Core + Panel + Stack + Animation
+
+**Files:**
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.cs`
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Panel.cs`
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Stack.cs`
+- Create: `Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/UITKModule.Animation.cs`
+
+- [ ] **Step 1: Create UITKModule.cs (main partial)**
+
+```csharp
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    /// <summary>
+    /// UIToolkit 管理模块。
+    /// </summary>
+    public sealed partial class UITKModule : Singleton<UITKModule>, IUpdate
+    {
+        /// <summary>
+        /// 资源加载器。
+        /// </summary>
+        public static IUITKResourceLoader Resource { get; private set; }
+
+        /// <summary>
+        /// 动画驱动器。
+        /// </summary>
+        public IUITKAnimationDriver AnimationDriver { get; set; }
+
+        /// <summary>
+        /// 窗口栈。
+        /// </summary>
+        private readonly List<UITKWindow> _windowStack = new List<UITKWindow>(64);
+
+        protected override void OnInit()
+        {
+            Resource = new UITKResourceLoader();
+            AnimationDriver = new USSAnimationDriver();
+            InitPanels();
+        }
+
+        protected override void OnRelease()
+        {
+            CloseAll(isShutDown: true);
+            DestroyPanels();
+        }
+
+        public void OnUpdate()
+        {
+            int count = _windowStack.Count;
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (_windowStack.Count != count) break;
+                _windowStack[i].InternalUpdate();
+            }
+        }
+
+        // ━━━ Show ━━━
+
+        public void ShowUI<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            ShowUIImp<T>(false, userDatas);
+        }
+
+        public void ShowUIAsync<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            ShowUIImp<T>(true, userDatas);
+        }
+
+        public async UniTask<T> ShowUIAsyncAwait<T>(params object[] userDatas) where T : UITKWindow, new()
+        {
+            return await ShowUIAwaitImp<T>(true, userDatas) as T;
+        }
+
+        public void ShowUI(Type type, params object[] userDatas)
+        {
+            ShowUIImp(type, false, userDatas);
+        }
+
+        public void ShowUIAsync(Type type, params object[] userDatas)
+        {
+            ShowUIImp(type, true, userDatas);
+        }
+
+        private void ShowUIImp<T>(bool isAsync, params object[] userDatas) where T : UITKWindow, new()
+        {
+            Type type = typeof(T);
+            string windowName = type.FullName;
+
+            if (!TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                window = CreateInstance<T>();
+                Push(window);
+                window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+            }
+        }
+
+        private void ShowUIImp(Type type, bool isAsync, params object[] userDatas)
+        {
+            string windowName = type.FullName;
+
+            if (!TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                window = CreateInstance(type);
+                Push(window);
+                window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+            }
+        }
+
+        private async UniTask<UITKWindow> ShowUIAwaitImp<T>(bool isAsync, params object[] userDatas) where T : UITKWindow, new()
+        {
+            Type type = typeof(T);
+            string windowName = type.FullName;
+
+            if (TryGetWindow(windowName, out UITKWindow window, userDatas))
+            {
+                return window;
+            }
+
+            window = CreateInstance<T>();
+            Push(window);
+            window.InternalLoad(window.AssetName, OnWindowPrepare, isAsync, userDatas).Forget();
+
+            float time = 0f;
+            while (!window.IsLoadDone)
+            {
+                time += Time.deltaTime;
+                if (time > 60f) break;
+                await UniTask.Yield();
+            }
+            return window;
+        }
+
+        private bool TryGetWindow(string windowName, out UITKWindow window, params object[] userDatas)
+        {
+            window = GetWindow(windowName);
+            if (window != null)
+            {
+                Pop(window);
+                Push(window);
+                window.TryInvoke(OnWindowPrepare, userDatas);
+                return true;
+            }
+            return false;
+        }
+
+        // ━━━ Close / Hide ━━━
+
+        public void CloseUI<T>() where T : UITKWindow
+        {
+            CloseUI(typeof(T));
+        }
+
+        public void CloseUI(Type type)
+        {
+            string windowName = type.FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            window.InternalDestroy();
+            Pop(window);
+            OnSetWindowVisible();
+        }
+
+        public void HideUI<T>() where T : UITKWindow
+        {
+            HideUI(typeof(T));
+        }
+
+        public void HideUI(Type type)
+        {
+            string windowName = type.FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            if (window.HideTimeToClose <= 0)
+            {
+                CloseUI(type);
+                return;
+            }
+
+            window.CancelHideToCloseTimer();
+            window.Visible = false;
+            window.IsHide = true;
+            window.HideTimerId = GameModule.Timer.AddTimer((arg) =>
+            {
+                CloseUI(type);
+            }, window.HideTimeToClose);
+
+            if (window.FullScreen)
+            {
+                OnSetWindowVisible();
+            }
+        }
+
+        public void CloseAll(bool isShutDown = false)
+        {
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                _windowStack[i].InternalDestroy(isShutDown);
+            }
+            _windowStack.Clear();
+        }
+
+        public void CloseAllWithOut<T>() where T : UITKWindow
+        {
+            for (int i = _windowStack.Count - 1; i >= 0; i--)
+            {
+                UITKWindow window = _windowStack[i];
+                if (window.GetType() == typeof(T)) continue;
+                window.InternalDestroy();
+                _windowStack.RemoveAt(i);
+            }
+        }
+
+        // ━━━ Query ━━━
+
+        public bool HasWindow<T>() => GetWindow(typeof(T).FullName) != null;
+
+        public T GetUI<T>() where T : UITKWindow
+        {
+            return GetWindow(typeof(T).FullName) as T;
+        }
+
+        // ━━━ Instance Factory ━━━
+
+        private UITKWindow CreateInstance<T>() where T : UITKWindow, new()
+        {
+            return CreateInstance(typeof(T));
+        }
+
+        private UITKWindow CreateInstance(Type type)
+        {
+            UITKWindow window = Activator.CreateInstance(type) as UITKWindow;
+            UIWindowAttribute attribute = Attribute.GetCustomAttribute(type, typeof(UIWindowAttribute)) as UIWindowAttribute;
+
+            if (window == null)
+                throw new GameFrameworkException($"UITKWindow {type.FullName} create instance failed.");
+
+            if (attribute != null)
+            {
+                string assetName = string.IsNullOrEmpty(attribute.Location) ? type.Name : attribute.Location;
+                window.Init(type.FullName, (int)attribute.Layer, attribute.FullScreen, assetName, attribute.FromResources, attribute.HideTimeToClose, attribute.Package);
+            }
+            else
+            {
+                window.Init(type.FullName, (int)UILayer.UI, false, type.Name, false, 10, "");
+            }
+
+            return window;
+        }
+    }
+}
+```
+
+- [ ] **Step 2: Create UITKModule.Panel.cs**
+
+```csharp
+using TEngine;
+using UnityEngine;
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        private const int LAYER_COUNT = 5;
+        private const int LAYER_SORT_INTERVAL = 2000;
+
+        private GameObject _uiTKRoot;
+        private UIDocument[] _layerDocuments = new UIDocument[LAYER_COUNT];
+        private VisualElement[] _layerRoots = new VisualElement[LAYER_COUNT];
+
+        private static readonly string[] LayerNames = { "Panel_Bottom", "Panel_UI", "Panel_Top", "Panel_Tips", "Panel_System" };
+
+        private void InitPanels()
+        {
+            _uiTKRoot = new GameObject("UITKRoot");
+            Object.DontDestroyOnLoad(_uiTKRoot);
+
+            for (int i = 0; i < LAYER_COUNT; i++)
+            {
+                var panelGo = new GameObject(LayerNames[i]);
+                panelGo.transform.SetParent(_uiTKRoot.transform);
+
+                var doc = panelGo.AddComponent<UIDocument>();
+                // PanelSettings 需要预建资产加载
+                // 实际项目中从 AB 或 Resources 加载 PanelSettings
+                doc.sortingOrder = i * LAYER_SORT_INTERVAL;
+
+                _layerDocuments[i] = doc;
+                _layerRoots[i] = doc.rootVisualElement;
+            }
+        }
+
+        private void DestroyPanels()
+        {
+            if (_uiTKRoot != null)
+            {
+                Object.Destroy(_uiTKRoot);
+                _uiTKRoot = null;
+            }
+        }
+
+        /// <summary>
+        /// 将窗口挂载到对应层级的 Panel。
+        /// </summary>
+        internal void AttachToLayer(UITKWindow window)
+        {
+            int layer = window.WindowLayer;
+            if (layer < 0 || layer >= LAYER_COUNT)
+            {
+                Log.Error($"UITKModule: Invalid window layer {layer} for {window.WindowName}");
+                layer = (int)UILayer.UI;
+            }
+            _layerRoots[layer].Add(window.RootElement);
+        }
+    }
+}
+```
+
+- [ ] **Step 3: Create UITKModule.Stack.cs**
+
+```csharp
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        private UITKWindow GetWindow(string windowName)
+        {
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (_windowStack[i].WindowName == windowName)
+                    return _windowStack[i];
+            }
+            return null;
+        }
+
+        private void Push(UITKWindow window)
+        {
+            // 按层级找到插入位置（同层末尾）
+            int insertIndex = -1;
+            for (int i = 0; i < _windowStack.Count; i++)
+            {
+                if (window.WindowLayer == _windowStack[i].WindowLayer)
+                {
+                    insertIndex = i + 1;
+                }
+            }
+
+            // 没有同层，找相邻层
+            if (insertIndex == -1)
+            {
+                for (int i = 0; i < _windowStack.Count; i++)
+                {
+                    if (window.WindowLayer > _windowStack[i].WindowLayer)
+                    {
+                        insertIndex = i + 1;
+                    }
+                }
+            }
+
+            if (insertIndex == -1)
+            {
+                insertIndex = 0;
+            }
+
+            _windowStack.Insert(insertIndex, window);
+        }
+
+        private void Pop(UITKWindow window)
+        {
+            _windowStack.Remove(window);
+        }
+
+        private void OnWindowPrepare(UITKWindow window)
+        {
+            window.InternalCreate();
+            window.InternalRefresh();
+            OnSetWindowVisible();
+            window.OnShowAnimation().Forget();
+        }
+
+        private void OnSetWindowVisible()
+        {
+            bool isHideNext = false;
+            for (int i = _windowStack.Count - 1; i >= 0; i--)
+            {
+                UITKWindow window = _windowStack[i];
+                if (!isHideNext)
+                {
+                    if (window.IsHide) continue;
+                    window.Visible = true;
+                    if (window.IsPrepare && window.FullScreen)
+                    {
+                        isHideNext = true;
+                    }
+                }
+                else
+                {
+                    window.Visible = false;
+                }
+            }
+        }
+    }
+}
+```
+
+- [ ] **Step 4: Create UITKModule.Animation.cs**
+
+```csharp
+using Cysharp.Threading.Tasks;
+
+namespace GameLogic
+{
+    public sealed partial class UITKModule
+    {
+        /// <summary>
+        /// 带隐藏动画的关闭。
+        /// </summary>
+        public async UniTask CloseUIWithAnimation<T>() where T : UITKWindow
+        {
+            string windowName = typeof(T).FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            await window.OnHideAnimation();
+            window.InternalDestroy();
+            Pop(window);
+            OnSetWindowVisible();
+        }
+
+        /// <summary>
+        /// 带隐藏动画的隐藏。
+        /// </summary>
+        public async UniTask HideUIWithAnimation<T>() where T : UITKWindow
+        {
+            string windowName = typeof(T).FullName;
+            UITKWindow window = GetWindow(windowName);
+            if (window == null) return;
+
+            if (window.HideTimeToClose <= 0)
+            {
+                await CloseUIWithAnimation<T>();
+                return;
+            }
+
+            await window.OnHideAnimation();
+            window.Visible = false;
+            window.IsHide = true;
+            window.HideTimerId = GameModule.Timer.AddTimer((arg) =>
+            {
+                CloseUI(typeof(T));
+            }, window.HideTimeToClose);
+
+            if (window.FullScreen)
+            {
+                OnSetWindowVisible();
+            }
+        }
+    }
+}
+```
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/Module/UITKModule/Core/
+git commit -m "feat(uitk): add UITKModule singleton with panel, stack, and animation management"
+```
+
+---
+
+## Task 9: USS Variables Foundation + Common Styles
+
+**Files:**
+- Create: `Assets/AssetRaw/UITK/Shared/Styles/variables.uss`
+- Create: `Assets/AssetRaw/UITK/Shared/Styles/common.uss`
+
+- [ ] **Step 1: Create variables.uss**
+
+```css
+:root {
+    /* Colors */
+    --color-primary: #4A90D9;
+    --color-primary-hover: #5BA0E9;
+    --color-secondary: #7B8794;
+    --color-success: #4CAF50;
+    --color-warning: #FF9800;
+    --color-danger: #F44336;
+    --color-bg-dark: #1A1A2E;
+    --color-bg-panel: #16213E;
+    --color-bg-card: #0F3460;
+    --color-text-primary: #FFFFFF;
+    --color-text-secondary: #B0BEC5;
+    --color-text-disabled: #546E7A;
+
+    /* Typography */
+    --font-size-xs: 12px;
+    --font-size-sm: 14px;
+    --font-size-md: 18px;
+    --font-size-lg: 24px;
+    --font-size-xl: 32px;
+    --font-size-title: 28px;
+
+    /* Spacing */
+    --spacing-xs: 4px;
+    --spacing-sm: 8px;
+    --spacing-md: 16px;
+    --spacing-lg: 24px;
+    --spacing-xl: 32px;
+
+    /* Border */
+    --border-radius-sm: 4px;
+    --border-radius-md: 8px;
+    --border-radius-lg: 12px;
+    --border-radius-full: 9999px;
+
+    /* Transition */
+    --transition-fast: 150ms;
+    --transition-normal: 200ms;
+    --transition-slow: 300ms;
+}
+```
+
+- [ ] **Step 2: Create common.uss**
+
+```css
+/* 全屏窗口容器 */
+.uitk-window-root {
+    flex-grow: 1;
+    position: absolute;
+    left: 0;
+    right: 0;
+    top: 0;
+    bottom: 0;
+}
+
+/* 通用按钮 */
+.btn {
+    padding: var(--spacing-sm) var(--spacing-md);
+    border-radius: var(--border-radius-md);
+    background-color: var(--color-primary);
+    color: var(--color-text-primary);
+    font-size: var(--font-size-md);
+    transition-duration: var(--transition-fast);
+    transition-property: background-color, scale;
+}
+
+.btn:hover {
+    background-color: var(--color-primary-hover);
+    scale: 1.02 1.02;
+}
+
+.btn:active {
+    scale: 0.98 0.98;
+}
+
+.btn:disabled {
+    background-color: var(--color-secondary);
+    color: var(--color-text-disabled);
+}
+
+/* 通用文本 */
+.text-title {
+    font-size: var(--font-size-title);
+    color: var(--color-text-primary);
+}
+
+.text-body {
+    font-size: var(--font-size-md);
+    color: var(--color-text-primary);
+}
+
+.text-secondary {
+    font-size: var(--font-size-sm);
+    color: var(--color-text-secondary);
+}
+
+/* 面板/卡片 */
+.panel {
+    background-color: var(--color-bg-panel);
+    border-radius: var(--border-radius-md);
+    padding: var(--spacing-md);
+}
+
+.card {
+    background-color: var(--color-bg-card);
+    border-radius: var(--border-radius-md);
+    padding: var(--spacing-md);
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add Assets/AssetRaw/UITK/Shared/Styles/
+git commit -m "feat(uitk): add USS variables foundation and common styles"
+```
+
+---
+
+## Task 10: Register UITKModule in GameApp
+
+**Files:**
+- Modify: `Assets/GameScripts/HotFix/GameLogic/GameApp_RegisterSystem.cs`
+
+- [ ] **Step 1: Add UITKModule registration**
+
+Find the existing module registration section in `GameApp_RegisterSystem.cs` and add:
+
+```csharp
+// 在其他模块注册后添加
+UITKModule.Instance.Active();
+```
+
+This follows the same pattern as existing modules (UIModule is registered as `UIModule.Instance.Active()`).
+
+- [ ] **Step 2: Verify no compile errors**
+
+Open Unity Editor, check Console for compile errors. All new files should compile without issues since they reference existing TEngine types (Singleton, IUpdate, GameModule, etc.).
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add Assets/GameScripts/HotFix/GameLogic/GameApp_RegisterSystem.cs
+git commit -m "feat(uitk): register UITKModule in GameApp startup"
+```
+
+---
+
+## Task 11: Smoke Test — Create a Simple Test Window
+
+**Files:**
+- Create: `Assets/AssetRaw/UITK/Shared/TestWindow.uxml`
+- Create: `Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/TestUITKWindow.cs`
+
+- [ ] **Step 1: Create TestWindow.uxml**
+
+```xml
+<ui:UXML xmlns:ui="UnityEngine.UIElements">
+    <ui:VisualElement class="uitk-window-root" style="align-items: center; justify-content: center;">
+        <ui:Label text="UITKModule Works!" name="lbl-title" class="text-title" />
+        <ui:Button text="Close" name="btn-close" class="btn" style="margin-top: 20px;" />
+    </ui:VisualElement>
+</ui:UXML>
+```
+
+- [ ] **Step 2: Create TestUITKWindow.cs**
+
+```csharp
+using UnityEngine.UIElements;
+
+namespace GameLogic
+{
+    [UIWindow(UILayer.UI)]
+    public class TestUITKWindow : UITKWindow
+    {
+        private Label _lblTitle;
+        private Button _btnClose;
+
+        protected override void OnCreate()
+        {
+            // 手动绑定（Plan 2 会加入自动绑定）
+            _lblTitle = RootElement.Q<Label>("lbl-title");
+            _btnClose = RootElement.Q<Button>("btn-close");
+
+            _btnClose.clicked += () =>
+            {
+                UITKModule.Instance.CloseUI<TestUITKWindow>();
+            };
+        }
+
+        protected override void OnRefresh()
+        {
+            _lblTitle.text = "UITKModule Works! 🎉";
+        }
+
+        protected override void OnDestroy()
+        {
+            _btnClose.clicked -= null; // 简化示例，Plan 2 自动处理
+        }
+    }
+}
+```
+
+- [ ] **Step 3: Test in Unity**
+
+在任意已有界面或测试入口调用：
+```csharp
+UITKModule.Instance.ShowUIAsync<TestUITKWindow>();
+```
+
+预期：屏幕中央显示 "UITKModule Works!" 文字和 Close 按钮，点击按钮窗口关闭并伴随 FadeOut 动画。
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add Assets/AssetRaw/UITK/Shared/TestWindow.uxml Assets/GameScripts/HotFix/GameLogic/UI/TestUITK/
+git commit -m "test(uitk): add smoke test window to verify UITKModule basic functionality"
+```
+
+---
+
+## Summary
+
+Plan 1 delivers a fully functional UITKModule core that supports:
+- ✅ Module initialization + 5-layer panel architecture
+- ✅ Window lifecycle (Show/Hide/Close with fullscreen occlusion)
+- ✅ Widget lifecycle (independent UXML, parent-child)
+- ✅ Resource loading (YooAsset + Resources dual path)
+- ✅ Animation system (USS presets + Tween driver interface)
+- ✅ GameEvent integration (auto-cleanup)
+- ✅ USS variables foundation for future theming
+
+After Plan 1, developers can build UI using manual `Q()` binding. Plan 2 adds Source Generator auto-binding, MVVM, and ListView.
diff --git a/docs/superpowers/plans/2026-06-11-uitk-module-plan2-binding.md b/docs/superpowers/plans/2026-06-11-uitk-module-plan2-binding.md
new file mode 100644
index 0000000000..e837cd9fe8
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-11-uitk-module-plan2-binding.md
@@ -0,0 +1,84 @@
+# UITKModule Plan 2: Binding + MVVM + ListView + Editor Code Generator
+
+> **状态**: ✅ 已完成
+
+**Goal:** Add Editor pre-generation auto-binding, MVVM data binding, UITKListView, and click sound system.
+
+**Architecture:** Editor 脚本扫描 [Q]/[OnClick]/[OnChange] 标记的 partial class，生成 `.bindgen.cs`。MVVM 使用 BindableProperty/Command/List。音效通过 Panel 级全局 ClickEvent 拦截统一处理。
+
+---
+
+## 完成状态
+
+| Task | 状态 | 内容 |
+|------|------|------|
+| Binding Attributes | ✅ | QAttribute, OnClickAttribute, OnChangeAttribute, BindAttribute, BindCommandAttribute, BindingMode |
+| MVVM Core | ✅ | BindableProperty, BindableCommand, BindableList, ViewModelBase, IValueConverter + 内置转换器 |
+| UITKListView | ✅ | 虚拟化列表 + Widget 生命周期 + 对象池 |
+| BindContext/UnbindContext | ✅ | UITKBase 中的 MVVM 绑定入口 |
+| Editor Generator | ✅ | UITKBindingGenerator + NamingHelper + UXMLValidator |
+| Auto-bind 生命周期集成 | ✅ | InternalCreate 自动调用 __UITKAutoBind + __UITKAutoBindEvents |
+| Click Sound | ✅ | IUITKClickSoundHandler + Panel 全局拦截 + no-sound class |
+| 测试窗口 | ✅ | TestAutoBindWindow, TestFullFeatureWindow, TestMainWindow, TestTipsPopup, TestSystemDialog, TestSubPage |
+
+---
+
+## 关键设计决策记录
+
+### 自动绑定方案
+- **最终方案**: Editor 脚本预生成 `.bindgen.cs`
+- **弃用方案**: Roslyn Source Generator DLL（需要外部构建，与 HybridCLR 兼容性不确定）
+- **弃用方案**: 运行时反射（性能问题）
+
+### 自动绑定调用时机
+- 框架在 `InternalCreate()` / `InitWidget()` 中自动调用 `__UITKAutoBind` + `__UITKAutoBindEvents`
+- 框架在 `InternalDestroy()` 中自动调用 `__UITKAutoUnbindEvents`
+- 开发者完全无感，不需要手动调用任何绑定方法
+
+### 按钮音效
+- **最终方案**: Panel 级 ClickEvent 冒泡全局拦截 + IUITKClickSoundHandler 接口
+- 生成代码不碰音效（职责单一）
+- 业务层 Handler 根据 button.name/class 决定策略
+- `no-sound` CSS class 标记静音
+- 弃用：[OnClick] sound 参数（过度设计）、class 携带音效名（滥用 class 语义）
+
+### 资源定位
+- YooAsset `AddressByFileName` 规则：文件名即 Address
+- 不需要传路径/Group，只要文件名唯一即可
+- [UIWindow(Location = "xxx")] 可覆盖默认类名定位
+- [UIWindow(Package = "xxx")] 指定 YooAsset 包名
+
+---
+
+## 使用指南
+
+### 1. 创建新窗口
+
+```csharp
+[UIWindow(UILayer.UI, FullScreen = true)]
+public partial class BagWindow : UITKWindow
+{
+    [Q] Button btnClose;
+    [Q] Label lblTitle;
+
+    [OnClick] void OnBtnClose() { UITKModule.Instance.CloseUI<BagWindow>(); }
+
+    protected override void OnCreate() { lblTitle.text = "背包"; }
+}
+```
+
+### 2. 生成绑定代码
+
+Unity 菜单: `TEngine → UITK → Generate All Bindings`
+
+### 3. 打开窗口
+
+```csharp
+GameModule.UITK.ShowUIAsync<BagWindow>();
+```
+
+### 4. 配置音效
+
+```csharp
+GameModule.UITK.ClickSoundHandler = new GameClickSoundHandler();
+```
diff --git a/docs/superpowers/specs/2026-06-11-uitk-module-design.md b/docs/superpowers/specs/2026-06-11-uitk-module-design.md
new file mode 100644
index 0000000000..b7cb8cbd14
--- /dev/null
+++ b/docs/superpowers/specs/2026-06-11-uitk-module-design.md
@@ -0,0 +1,369 @@
+# UITKModule 设计文档
+
+> **日期**: 2026-06-11
+> **状态**: 实现中
+> **目标版本**: Unity 2022.3.63f2
+> **与现有系统关系**: 并行共存，现有 UIModule (UGUI) 保留不动
+
+---
+
+## 1. 概述
+
+为 TEngine 框架新增基于 Unity UI Toolkit 的完整 UI 模块（UITKModule），全面替代 UGUI 用于新 UI 开发。核心特性：
+
+- 纯 C# 驱动，去 MonoBehaviour
+- Editor 预生成自动绑定代码（.bindgen.cs）+ UXML 校验
+- 完整 MVVM 数据绑定（BindableProperty / Command / List）
+- 分层 Panel 架构（5 层）
+- 统一按钮点击音效（IUITKClickSoundHandler 全局拦截）
+- 与现有 GameEvent / Timer / Resource 系统完全复用
+- 热更新支持（UXML/USS 走 AB，代码走 HybridCLR）
+
+---
+
+## 2. 整体架构
+
+```
+┌────────────────────────────────────────────────────────────┐
+│                    共享层 (不修改)                           │
+├────────────────────────────────────────────────────────────┤
+│  GameEvent + GameEventMgr + MemoryPool (事件自动清理)       │
+│  GameModule.Resource / IResourceModule (YooAsset 加载管道)  │
+│  GameModule.Timer (HideTimeToClose 定时关闭)               │
+└────────────────────────────────────────────────────────────┘
+                            │
+            ┌───────────────┴───────────────┐
+            ▼                               ▼
+┌─────────────────────┐         ┌──────────────────────────┐
+│  UIModule (UGUI)    │         │  UITKModule (UIToolkit)   │
+│  保持现有，不动      │         │  新增模块                 │
+└─────────────────────┘         └──────────────────────────┘
+```
+
+### 模块内部目录结构
+
+```
+UITKModule/
+├── Animation/                     # 动画系统
+│   ├── UITKAnimationType.cs       # 预设动画枚举
+│   ├── IUITKAnimationDriver.cs    # 动画驱动器接口（预留 Tween）
+│   └── USSAnimationDriver.cs      # 默认 USS Transition 实现
+├── Base/                          # 基类
+│   ├── UITKBase.cs                # 基类 (事件、Widget工厂、MVVM绑定钩子)
+│   ├── UITKWindow.cs              # 窗口 (生命周期、可见性、动画)
+│   ├── UITKWidget.cs              # 组件 (独立UXML、父子关系)
+│   └── UIWindowAttribute.cs       # [UIWindow] 窗口声明特性
+├── Binding/                       # 绑定 Attribute 定义
+│   ├── QAttribute.cs              # [Q] 元素查询
+│   ├── OnClickAttribute.cs        # [OnClick] 点击事件
+│   ├── OnChangeAttribute.cs       # [OnChange] 值变化事件
+│   ├── BindAttribute.cs           # [Bind] MVVM 数据绑定
+│   ├── BindCommandAttribute.cs    # [BindCommand] 命令绑定
+│   └── BindingMode.cs             # 绑定方向枚举
+├── Core/                          # 模块核心
+│   ├── UITKModule.cs              # 单例主文件 (Show/Close/Hide)
+│   ├── UITKModule.Panel.cs        # 分层 Panel + 全局点击音效拦截
+│   ├── UITKModule.Stack.cs        # 窗口栈 (Push/Pop/全屏遮挡)
+│   ├── UITKModule.Animation.cs    # 带动画的关闭/隐藏
+│   └── IUITKClickSoundHandler.cs  # 按钮音效处理器接口
+├── MVVM/                          # MVVM 支持
+│   ├── BindableProperty.cs        # 可绑定属性
+│   ├── BindableCommand.cs         # 可绑定命令
+│   ├── BindableList.cs            # 可绑定集合
+│   ├── ViewModelBase.cs           # ViewModel 基类
+│   └── IValueConverter.cs         # 类型转换器 + 内置转换器
+├── ListView/                      # 列表封装
+│   └── UITKListView.cs            # 虚拟化列表 + Widget 生命周期
+└── Resource/                      # 资源加载
+    ├── IUITKResourceLoader.cs     # 接口
+    └── UITKResourceLoader.cs      # YooAsset + Resources 双路径实现
+
+Editor/UITKBindingGenerator/       # Editor 代码生成工具
+├── UITKBindingGenerator.cs        # 主生成器
+├── UITKNamingHelper.cs            # camelCase → kebab-case
+└── UITKUXMLValidator.cs           # UXML 解析 + 校验
+```
+
+---
+
+## 3. 分层 Panel 架构
+
+```
+Scene
+└── UITKRoot (GameObject, DontDestroyOnLoad)
+    ├── Panel_Bottom   (UIDocument + PanelSettings, sortingOrder=0)
+    ├── Panel_UI       (UIDocument + PanelSettings, sortingOrder=2000)
+    ├── Panel_Top      (UIDocument + PanelSettings, sortingOrder=4000)
+    ├── Panel_Tips     (UIDocument + PanelSettings, sortingOrder=6000)
+    └── Panel_System   (UIDocument + PanelSettings, sortingOrder=8000)
+```
+
+- 5 层共享一个 PanelSettings 资产（Editor 预建）
+- 同层内窗口深度通过 VisualElement 子节点顺序控制
+- 可见性通过 `style.display = none/flex` 控制
+- 全局按钮点击音效通过 Panel root 的 ClickEvent 冒泡拦截
+
+---
+
+## 4. 生命周期
+
+### Window 流程
+
+```
+ShowUIAsync<T>(userData)
+├─ CreateInstance<T>() → 读取 [UIWindow] Attribute
+├─ Push(window) → 按层级插入栈
+├─ InternalLoad → 加载 UXML → CloneTree → 挂载到 Panel
+├─ InternalCreate() [仅首次]
+│   ├─ __UITKAutoBind(root)        ← 自动绑定（框架调用，开发者无感）
+│   ├─ __UITKAutoBindEvents()      ← 自动绑定事件
+│   ├─ Inject()
+│   ├─ OnCreate()                  ← 用户代码
+│   └─ RegisterEvent()
+├─ InternalRefresh() → OnRefresh() ← 每次 Show 执行
+├─ OnSetWindowVisible()            ← 全屏遮挡
+└─ OnShowAnimation()               ← 显示动画
+```
+
+### Window 关闭
+
+```
+CloseUI<T>()
+├─ OnDestroy()
+├─ __UITKAutoUnbindEvents()        ← 自动解绑（框架调用）
+├─ RemoveAllUIEvent()              ← GameEvent 自动清理
+├─ 递归销毁子 Widget
+├─ RemoveFromHierarchy + 释放资源
+└─ OnSetWindowVisible()
+```
+
+---
+
+## 5. 自动绑定系统
+
+### 方案：Editor 预生成
+
+- 通过 Unity Editor 菜单 `TEngine/UITK/Generate All Bindings` 触发
+- 扫描所有继承 UITKWindow/UITKWidget 的 partial class
+- 解析 [Q]、[OnClick]、[OnChange] Attribute
+- 生成 `.bindgen.cs` 到源文件同目录
+- 生成的代码是普通 C#，正常参与 HybridCLR 热更新
+- 零运行时反射
+
+### Attribute 定义
+
+```csharp
+[Q]                     // 自动查询，字段名 camelCase → UXML name kebab-case
+[Q("explicit-name")]    // 显式指定 UXML name
+[OnClick]               // 方法名推导目标：OnBtnLogin → btn-login
+[OnClick("target")]     // 显式指定目标
+[OnChange("target")]    // 值变化事件
+```
+
+### 命名转换
+
+```
+btnLogin     → btn-login
+lblPlayerHP  → lbl-player-hp
+inputAccount → input-account
+```
+
+### 使用示例
+
+```csharp
+[UIWindow(UILayer.UI)]
+public partial class LoginWindow : UITKWindow
+{
+    [Q] Button btnLogin;
+    [Q] Label lblTitle;
+    [Q] TextField inputAccount;
+
+    [OnClick] void OnBtnLogin() { /* 业务逻辑 */ }
+    [OnChange("input-account")] void OnAccountChanged(ChangeEvent<string> evt) { }
+
+    protected override void OnCreate()
+    {
+        // 字段已自动填充，事件已自动绑定，直接使用
+        lblTitle.text = "Welcome";
+    }
+    // OnDestroy 不需要手动解绑
+}
+```
+
+---
+
+## 6. MVVM 数据绑定
+
+### 核心组件
+
+- `BindableProperty<T>` — 值变化通知
+- `BindableCommand` — 命令 + CanExecute
+- `BindableList<T>` — 可观察集合
+- `ViewModelBase` — ViewModel 基类
+
+### 使用方式（当前为手动绑定，后续 Generator 支持 [Bind]）
+
+```csharp
+protected override void OnCreate()
+{
+    _vm = new ShopViewModel();
+    _vm.Gold.OnValueChanged += v => lblGold.text = v.ToString();
+    _vm.BuyCommand.CanExecuteChanged += () => btnBuy.SetEnabled(_vm.BuyCommand.CanExecute());
+    btnBuy.clicked += _vm.BuyCommand.Execute;
+}
+```
+
+---
+
+## 7. 动画系统
+
+### 预设
+
+```csharp
+None, FadeIn, FadeOut, SlideFromBottom, SlideToBottom,
+SlideFromRight, SlideToRight, ScaleIn, ScaleOut
+```
+
+### Window 配置
+
+```csharp
+protected override UITKAnimationType ShowAnimation => UITKAnimationType.ScaleIn;
+protected override UITKAnimationType HideAnimation => UITKAnimationType.FadeOut;
+protected override int AnimationDuration => 300;
+```
+
+### 驱动器接口（预留 Tween）
+
+```csharp
+public interface IUITKAnimationDriver
+{
+    UniTask Play(VisualElement target, UITKAnimationType type, bool isShow, int durationMs);
+}
+// UITKModule.AnimationDriver = new DOTweenAnimationDriver(); // 后续切换
+```
+
+---
+
+## 8. 按钮点击音效
+
+### 设计
+
+- Panel 级全局 ClickEvent 冒泡拦截
+- 所有 Button 点击统一触发 `IUITKClickSoundHandler`
+- `no-sound` CSS class 标记静音按钮
+- 业务层 Handler 根据 button.name 或 class 决定音效策略
+
+### 接口
+
+```csharp
+public interface IUITKClickSoundHandler
+{
+    void OnButtonClick(Button button);
+}
+```
+
+### 业务层实现
+
+```csharp
+public class GameClickSoundHandler : IUITKClickSoundHandler
+{
+    public void OnButtonClick(Button button)
+    {
+        if (button.name.Contains("confirm"))
+            GameModule.Audio.PlayUISound("ui_confirm");
+        else
+            GameModule.Audio.PlayUISound("ui_click");
+    }
+}
+
+// 初始化
+GameModule.UITK.ClickSoundHandler = new GameClickSoundHandler();
+```
+
+### 静音按钮
+
+```xml
+<ui:Button text="静音" class="btn no-sound" />
+```
+
+---
+
+## 9. 资源加载
+
+### 接口
+
+```csharp
+public interface IUITKResourceLoader
+{
+    VisualTreeAsset LoadVisualTreeAsset(string location, string packageName = "");
+    UniTask<VisualTreeAsset> LoadVisualTreeAssetAsync(string location, ...);
+    StyleSheet LoadStyleSheet(string location, string packageName = "");
+    UniTask<StyleSheet> LoadStyleSheetAsync(string location, ...);
+    PanelSettings LoadPanelSettings(string location, string packageName = "");
+    void Unload(Object asset);
+}
+```
+
+### 资源定位
+
+- YooAsset `AddressByFileName` 规则：文件名即 Address
+- `[UIWindow]` 不指定 Location → 用类名作为 Address
+- `[UIWindow(Location = "path")]` → 显式指定
+
+### 按业务模块分包
+
+```
+AssetRaw/UITK/
+├── Shared/     # 公共（首包）：PanelSettings、通用样式
+├── Login/      # 登录模块
+├── Lobby/      # 大厅
+├── Bag/        # 背包
+├── Battle/     # 战斗
+└── Shop/       # 商城
+```
+
+`[UIWindow(UILayer.UI, Package = "UITK_Bag")]` 指定 YooAsset 包名。
+
+---
+
+## 10. 主题换肤（基础设施）
+
+- 所有 USS 使用 CSS 自定义变量 (`--color-primary` 等)
+- PanelSettings 预留 themeStyleSheet 切换接口
+- 后续新增 TSS 文件覆盖变量值即可换肤
+
+---
+
+## 11. 与现有系统共存
+
+- `GameModule.UI.ShowUI<T>()` → UGUI
+- `GameModule.UITK.ShowUI<T>()` → UIToolkit
+- 共享 GameEvent 通信
+- 可同屏共存（通过 sortingOrder 控制叠加层级）
+
+---
+
+## 12. 性能设计要点
+
+| 要点 | 措施 |
+|------|------|
+| 零运行时反射 | Editor 预生成绑定代码，运行时直接调用 |
+| Q() 查询仅一次 | InternalCreate 时缓存，后续直接用字段 |
+| 同层合批 | 分层 Panel 内自动合批，仅 5 个 Panel 基底开销 |
+| 列表虚拟化 | UITKListView 内置对象池 + Unity ListView |
+| 隐藏停止渲染 | display:none 停布局+渲染 |
+| 事件自动清理 | GameEventMgr 池化 + 生成解绑代码 |
+| 音效零侵入 | Panel 级冒泡拦截，不在每个按钮上注册 |
+
+---
+
+## 13. 限制与已知约束
+
+| 约束 | 说明 |
+|------|------|
+| Unity 2022.3 无官方 DataBinding | 使用自研 MVVM |
+| 无世界空间 UI | 需此类需求仍用 UGUI |
+| USS 动画有限 | 复杂动画需接入 Tween 库 |
+| 代码生成需手动触发 | Editor 菜单 Generate Bindings |
+| PanelSettings 必须预建 | Editor 创建资产 |
+| 资源文件名需唯一 | AddressByFileName 规则限制 |