# 修改总览-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` 之后还有未提交修改。
- 这些未提交修改主要是：
  - 第二阶段托管重绘
  - 注释补充与校正
  - 记录与模板体系整理
