StellarX-kaifa/开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md

功能变更 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
• 对外 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) 使用约定。