Snapshot before max-resize threshold diagnosis

开发记录/功能变更/Feature-20260409-0004-测试用例与可观测性调整.md

@@ -0,0 +1,69 @@
+# 功能变更 ID: Feature-20260409-0004
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260409-0004
+- 标题: 测试用例与可观测性调整
+- 状态：已完成
+- 类型：修改
+- 级别：L1 轻量
+- 模块：z-testDome / 日志
+- 版本 / 分支：`master`
+- 环境：Windows + EasyX + VS2022
+- 负责人：Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - 对话框、遮挡、hover、分页和页签的组合问题需要更有针对性的回归入口。
+- 目标:
+  - 增加一组综合用例，并降低 DEBUG 日志噪音。
+- 不做什么：[可选]
+  - 不改变原有 `KEY == 1 / 2 / 3` 的默认运行逻辑
+
+## 变更内容
+
+- 变更摘要:
+  - 新增 `KEY == 4` 的综合回归用例，覆盖对话框遮挡、Tab、Table、模态 resize 等场景。
+- 新增项：[可选]
+  - `KEY == 4` 测试分支
+- 修改项：[可选]
+  - hover 相关日志降噪
+  - 事件日志补充更清晰的事件名
+- 删除 / 废弃项：[可选]
+  - 无
+- 受影响的文件 / 类 / 函数:
+  - `z-testDome.cpp`
+  - `Window.cpp`
+  - `Canvas.cpp`
+  - `Button.cpp`
+- 对外 API / 属性变化：[可选]
+  - 无
+
+## 行为对照
+
+- 变更前:
+  - 回归更多依赖手工拼场景，hover 日志容易刷屏。
+- 变更后:
+  - 有固定综合回归入口，日志更适合看关键路径。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 测试 `KEY == 4` 需手动切换宏值
+
+## 验证与落地
+
+- 验证方式:
+  - 编译 `z-testDome.cpp`
+  - 静态推演 `KEY == 4` 控件创建、显示、对话框触发和关闭链
+- 验证结果:
+  - 当前默认 `KEY == 2` 未被带坏，`KEY == 4` 逻辑链自洽
+- 关联 BUG / Fix：[可选]
+  - 可作为 `BUG-20260409-0001` 相关问题的回归入口
+- Commit:
+  - 当前工作区未提交阶段
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]