StellarX-kaifa/开发记录/功能变更/Feature-20260409-0006-窗口最大化收口保护调整.md

Feature-20260409-0006

适用场景：记录小到中等规模的接口、行为、默认值、交互和内部机制变化。

基本信息

• ID: Feature-20260409-0006
• 标题: 窗口最大化收口保护从跨度阈值改为非法尺寸判断
• 类型：修改
• 级别：L2
• 模块：Window / Resize
• 状态：已完成 / 待用户回归
• 关联：
  • BUG-20260409-0003
  • Fix-BUG-20260409-0003

背景

• 旧实现把“大跨度尺寸变化”视为异常帧。
• 在初始窗口较小、显示器较大时，正常最大化会被误伤。

变更内容

• 删除旧的跨度保护语义：
  • 不再以 abs(finalW - width) 或 abs(finalH - height) 决定是否跳过。
• 新增非法尺寸保护语义：
  • 仅拦截 <= 0 的客户区尺寸
  • 仅拦截明显超出虚拟桌面合理范围的客户区尺寸
• 新增两类调试日志：
  • 非法尺寸跳过日志
  • 大跨度但继续执行日志

对外影响

• 直接最大化的行为更稳定。
• 之前会黑背景/残影的场景，现在理论上应恢复为正常收口。

兼容性

• 向后兼容。
• 不涉及公开 API 变化。

验证方式

• 用户回归 KEY == 1 ~ 4
• 日志检查是否继续打印 尺寸调整已完成
• 单文件编译验证 Window.cpp

落地信息

• 涉及文件：
  • Window.cpp
• 落地状态：
  • 当前工作区已完成，待提交