Fix maximize resize guard and add records

2026-04-09 04:19:56 +08:00
parent f567369300
commit 97710db9e3
5 changed files with 297 additions and 6 deletions
@@ -0,0 +1,54 @@
+# 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`
+- 落地状态：
+  - 当前工作区已完成，待提交