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

记录索引

BUG

• BUG-20260409-0001 对话框重绘、快照残留与遮挡交互异常
• BUG-20260409-0002 基础控件生命周期与边界条件问题

Fix

• Fix-BUG-20260409-0001 对话框重绘、快照残留与遮挡交互异常
• Fix-BUG-20260409-0002 基础控件生命周期与边界条件问题

功能变更

• Feature-20260409-0001 基础资源所有权与生命周期收口
• Feature-20260409-0002 Dialog 与 MessageBox 行为调整
• Feature-20260409-0003 输入事件、hover 与遮挡交互调整
• Feature-20260409-0004 测试用例与可观测性调整
• Feature-20260409-0005 开发记录与模板体系整理

模块

• Module-20260409-0001 Window 托管重绘与覆盖合成机制

覆盖关系

核心代码文件覆盖

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