StellarX-kaifa/开发记录/00-修改总览-20260409.md

# 修改总览-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` 综合回归用例
     - 日志降噪
     - 模板体系与开发记录目录建立

7. 第五阶段：全量缺陷修复与自动化验证（当前工作区）
   - 主要内容：
     - 新增 `StellarX.Core` 核心静态库，拆分框架实现与应用入口
     - 修复控件所有权、空页签、快照、几何残影、Dialog、Table、日志、MBCS、Tooltip 和事件循环问题
     - 新增 Native Unit Test、x64 ASan、EasyX UI Fixture 和 PowerShell 自动化测试入口
     - 完成 Debug x64 / ASan、Release x64、Debug Win32 逻辑测试，以及 UI 三轮回归

## 记录索引

### 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)
- [Feature-20260915-0001 全量缺陷修复与 API 调整](./功能变更/Feature-20260915-0001-全量缺陷修复与API调整.md)

### 模块

- [Module-20260409-0001 Window 托管重绘与覆盖合成机制](./模块/Module-20260409-0001-Window托管重绘与覆盖合成机制.md)
- [Module-20260915-0001 StellarX 核心库与自动化测试基础设施](./模块/Module-20260915-0001-StellarX核心库与自动化测试基础设施.md)

### 配套文档

- [MIGRATION.md](./MIGRATION.md)：破坏性 API 迁移说明
- [TESTING.md](./TESTING.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` 之后还有未提交修改。
- 这些未提交修改主要是：
  - 第二阶段托管重绘
  - 注释补充与校正
  - 记录与模板体系整理

## 第五阶段覆盖关系

- `StellarX.Core.vcxproj`
  - 统一承载框架源码和公共/内部头文件。
  - 关联：
    - [Module-20260915-0001 StellarX 核心库与自动化测试基础设施](./模块/Module-20260915-0001-StellarX核心库与自动化测试基础设施.md)
    - [Feature-20260915-0001 全量缺陷修复与 API 调整](./功能变更/Feature-20260915-0001-全量缺陷修复与API调整.md)

- `tests / scripts`
  - 覆盖逻辑单元测试、ASan、EasyX UI Fixture、关键像素断言和诊断产物。
  - 关联：
    - [TESTING.md](./TESTING.md)
    - [Module-20260915-0001 StellarX 核心库与自动化测试基础设施](./模块/Module-20260915-0001-StellarX核心库与自动化测试基础设施.md)

- `Control / Window / Canvas / Button / Label / TextBox / Table / Dialog / TabControl / SxLogger`
  - 本批次高、中、低严重度问题和验证用例统一记录于：
    - [Feature-20260915-0001 全量缺陷修复与 API 调整](./功能变更/Feature-20260915-0001-全量缺陷修复与API调整.md)