# 功能变更 ID: Feature-20260415-0008

> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。

## 基本信息

- ID: Feature-20260415-0008
- 标题: KEY5 第二阶段专项回归场景增强
- 状态：已完成
- 类型：修改
- 级别：L2 中等
- 模块: 测试用例 / 回归场景
- 版本 / 分支: 当前工作区
- 环境: Windows + EasyX
- 负责人: Codex 协作修改

## 变更背景

- 背景:
  - 旧版 `KEY5` 已能覆盖第一阶段布局主线，但场景层次不够集中，说明文字偏长，部分区域排版紧。
  - 第二阶段引入了内容驱动、overlay 补画、容器职责边界等新验证点，旧 `KEY5` 覆盖不完整。
- 目标:
  - 把 `KEY5` 重构成第二阶段专项回归入口。
  - 增加三层 `Canvas` 嵌套、通用 overlay、跨容器 hover 清理、`Label` 内容驱动规则验证。
- 不做什么：[可选]
  - 不追求视觉美化。
  - 不把测试用例变成完整 demo 页。

## 变更内容

- 变更摘要:
  - 重构 `KEY5` 的区域布局与说明文案。
  - 引入三层嵌套 `Canvas` 场景。
  - 增加 `Window / Canvas / TabControl / Table` 四类关键回归点。
- 新增项：[可选]
  - 三层 `Canvas` 嵌套与多层锚点链回归。
  - `Label` 文本变化 / 样式变化按钮。
  - 跨容器相邻按钮 hover/tooltip 回归点。
  - 顶层浮层覆盖 `Table` 的 overlay 回归点。
- 修改项：[可选]
  - 缩短说明 `Label` 文案，减少普通排版重叠。
  - 重新组织分区顺序，提升单区可读性。
- 删除 / 废弃项：[可选]
  - 删除过长、重复的说明文案。
- 受影响的文件 / 类 / 函数:
  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/app/z-testDome.cpp)
- 对外 API / 属性变化：[可选]
  - 无

## 行为对照

- 变更前:
  - `KEY5` 主要覆盖第一阶段布局规则，层次和交互链回归点相对分散。
  - 说明文字较长，部分区域排版偏挤。
- 变更后:
  - `KEY5` 成为第二阶段主回归入口。
  - 三层嵌套、overlay、跨容器 hover、`Label` 内容驱动、`Table` 分页与页码都能直接观察。
- 兼容性说明：兼容
- 迁移说明：[可选]
  - 仍然通过 `#define KEY 5` 进入，无额外迁移。

## 验证与落地

- 验证方式:
  - 编译 `z-testDome.cpp /DKEY=5`
  - 手动观察窗口 resize、hover、tooltip、overlay、分页和 `Label` 变化
- 验证结果:
  - 编译级验证通过
  - GUI 手动验证待本机执行
- 关联 BUG / Fix：[可选]
  - `BUG-20260415-0005`
  - `Fix-BUG-20260415-0005`
- Commit: 未提交（当前工作区）
- PR：[可选]
- 发布版本：[可选]
- 备注：[可选]
  - `Label` 样式变化验证明确依赖 `setDirty(true)` 使用约定。