Snapshot before max-resize threshold diagnosis

2026-04-09 03:23:10 +08:00
parent 77a8fe568a
commit f567369300
25 changed files with 1489 additions and 36 deletions
@@ -0,0 +1,137 @@
+# 修改总览-20260409
+
+## 说明
+
+- 本目录用于记录本轮协作中对框架做过的修改。
+- 记录范围覆盖：
+  - 早期未建 Git 基线前的修改
+  - 已提交到仓库的阶段性修改
+  - 当前工作区中尚未提交的第二阶段重绘架构与注释整理
+- 其中相对最原始版本、但未落到 Git 基线的那部分内容，依据协作过程与当前代码状态回溯整理。
+
+## 阶段概览
+
+1. 初始基线  
+   - 提交：`dde570a`
+   - 含义：建立仓库后的第一版基线
+
+2. 第一阶段：基础治理与确定性问题修复  
+   - 主要内容：
+     - 资源所有权收紧
+     - 析构顺序修正
+     - `Table / Label / Dialog / Button / TextBox` 等基础问题修复
+
+3. 第二阶段：快照与对话框行为收口  
+   - 提交：`4a6e153`
+   - 提交：`7f8431a`
+   - 主要内容：
+     - 快照“作废”和“回贴”语义拆分
+     - `Dialog` 在窗口变化时只重新居中
+     - 模态/非模态对话框的残影、穿透、关闭后 hover 清理等问题修复
+
+4. 第三阶段：统一提交重绘（第一版）  
+   - 提交：`b07a4ec`
+   - 主要内容：
+     - 将事件阶段的“改状态”与绘制阶段的“提交”分离
+     - 窗口开始托管控件在事件分发期间的重绘请求
+
+5. 第四阶段：统一提交重绘（第二版，当前工作区）  
+   - 状态：未提交
+   - 主要内容：
+     - 从“整场景统一重绘”推进到“按 root 登记并选择性补画对话框”
+     - 为 `Canvas / TabControl / Dialog` 建立托管重绘提交语义
+     - 补充相关注释
+
+6. 测试与文档  
+   - 主要内容：
+     - `KEY == 4` 综合回归用例
+     - 日志降噪
+     - 模板体系与开发记录目录建立
+
+## 记录索引
+
+### BUG
+
+- [BUG-20260409-0001 对话框重绘、快照残留与遮挡交互异常](./BUG/BUG-20260409-0001-对话框重绘快照与遮挡交互异常.md)
+- [BUG-20260409-0002 基础控件生命周期与边界条件问题](./BUG/BUG-20260409-0002-基础控件生命周期与边界条件问题.md)
+
+### Fix
+
+- [Fix-BUG-20260409-0001 对话框重绘、快照残留与遮挡交互异常](./Fix/Fix-BUG-20260409-0001-对话框重绘快照与遮挡交互异常.md)
+- [Fix-BUG-20260409-0002 基础控件生命周期与边界条件问题](./Fix/Fix-BUG-20260409-0002-基础控件生命周期与边界条件问题.md)
+
+### 功能变更
+
+- [Feature-20260409-0001 基础资源所有权与生命周期收口](./功能变更/Feature-20260409-0001-基础资源所有权与生命周期收口.md)
+- [Feature-20260409-0002 Dialog 与 MessageBox 行为调整](./功能变更/Feature-20260409-0002-Dialog与MessageBox行为调整.md)
+- [Feature-20260409-0003 输入事件、hover 与遮挡交互调整](./功能变更/Feature-20260409-0003-输入事件与遮挡交互调整.md)
+- [Feature-20260409-0004 测试用例与可观测性调整](./功能变更/Feature-20260409-0004-测试用例与可观测性调整.md)
+- [Feature-20260409-0005 开发记录与模板体系整理](./功能变更/Feature-20260409-0005-开发记录与模板体系整理.md)
+
+### 模块
+
+- [Module-20260409-0001 Window 托管重绘与覆盖合成机制](./模块/Module-20260409-0001-Window托管重绘与覆盖合成机制.md)
+
+## 覆盖关系
+
+### 核心代码文件覆盖
+
+- `Window.h / Window.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0001`
+    - `Fix-BUG-20260409-0001`
+    - `Feature-20260409-0002`
+    - `Feature-20260409-0003`
+    - `Module-20260409-0001`
+
+- `Control.h / Control.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0002`
+    - `Fix-BUG-20260409-0002`
+    - `Feature-20260409-0001`
+    - `Module-20260409-0001`
+
+- `Canvas.h / Canvas.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0001`
+    - `Fix-BUG-20260409-0001`
+    - `Feature-20260409-0003`
+    - `Module-20260409-0001`
+
+- `TabControl.h / TabControl.cpp`
+  - 覆盖于：
+    - `Feature-20260409-0003`
+    - `Feature-20260409-0004`
+    - `Module-20260409-0001`
+
+- `Dialog.h / Dialog.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0001`
+    - `Fix-BUG-20260409-0001`
+    - `Feature-20260409-0002`
+    - `Module-20260409-0001`
+
+- `Button.cpp / TextBox.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0001`
+    - `Fix-BUG-20260409-0001`
+    - `Feature-20260409-0003`
+
+- `Table.cpp / Table.h / Label.cpp / MessageBox.cpp`
+  - 覆盖于：
+    - `BUG-20260409-0002`
+    - `Fix-BUG-20260409-0002`
+    - `Feature-20260409-0001`
+    - `Feature-20260409-0002`
+
+- `z-testDome.cpp`
+  - 覆盖于：
+    - `Feature-20260409-0004`
+
+## 当前状态
+
+- 当前工作区在 `77a8fe5` 之后还有未提交修改。
+- 这些未提交修改主要是：
+  - 第二阶段托管重绘
+  - 注释补充与校正
+  - 记录与模板体系整理