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

功能变更 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：[可选]
• 发布版本：[可选]
• 备注：[可选]