Commit Graph
2 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash c4faa930e2 UI 重构:生成里程碑最终报告,并在计划文档中标注阶段状态
- Documents/UI_Refactor_Report.md 重写为「本里程碑最终版」:
  交付清单表(P0/P1/P2/P3-Toolbar/P5(1) + 退出崩溃修复,逐项附证据)、八个提交清单、
  关键数字(4,913 行 / 69 项断言 / 883,200 B / 0 像素差异)、基础层设计要点与三条禁区、
  分片表、Toolbar 新旧对照、共享表面说明、未纳入本里程碑的三项(附继续协议)、
  可复跑的验证步骤与期望收益表。
- Documents/UI_Refactor_Plan.md:阶段表标注已完成的 P0/P1/P2、部分完成的 P3/P5。

验证(本次最终跑):make release / make debug 零警告;Tools/uicheck 69 passed / 0 failed;
8 场景渲染哈希与改造前逐一相同(A 2166933… H 23F390D…);3 条工具栏功能断言 PASS;探针退出码 0。
2026-10-28 12:37:44 +08:00
DeepSeek V4.1 Flash 3529c7b44f UI 重构 P0+P1:新增布局/控件基础层与离屏回归网(对产品像素零影响)
新增 Components/Shared 下的 UI 基础层:
- UiLayout:矩形原语 / 对齐 / 设备像素内侧对齐 / Stack / Flow / 布局缓存(deque 保证引用稳定、
  定向失效、按最久未命中淘汰)。
- UiWidget:控件树基类。两段式布局(Measure 自下而上带缓存、Arrange 自上而下)、
  脏区下探绘制(dirty 为空=全画;与子树矩形无交集=整棵跳过;有效裁剪=祖先裁剪切∩自身∩脏区)、
  只沿命中链派发的冒泡模型(绝不分发给同层兄弟)、capture/modal/hover/focus 仲裁、
  光标认领链、统一动画 tick、内容指纹入口。

新增 Tools/uicheck 离屏回归网(62 项断言,全程不创建窗口、不注入输入):
- 布局数学:对齐/STRETCH/超尺寸夹取、Stack 固定与自动均分且绝不产生负尺寸、Flow 换行与 overflow。
- 缓存:引用稳定、定向失效、容量淘汰。
- 绘制:全画 / 子树跳过 / 裁剪收窄 / 不可见跳过 / 失效冒泡。
- 派发:重叠子节点只投最上层、hit-transparent 穿透、消费不上抛、capture 越过边界仍投递、
  仅持有者可释放、modal 屏蔽其余子树、祖先兜底、光标由最上层认领、键盘沿焦点链。
- 动画:时间戳统一下发、活跃状态汇总。

过程中修正自身两处缺陷:补齐 AdvanceAnimationSelf/AnimationActiveSelf 声明;
把"遍历同层兄弟"改为"只沿命中链派发 + 祖先兜底"(否则一次点击可能被视觉上位于下方的控件也处理)。

验证:make release TARGET_FILE_NAME=TargetCheck 零警告(873,984 B,低于 900KB 阈值);
Tools/uicheck 62 passed / 0 failed。

本提交不改动任何现有组件,Toolbar/TabBar/SignalPanel/PlotView 仍走旧路径,产品像素零变化。
文档:Documents/UI_Refactor_Plan.md(蓝图)、Documents/UI_Refactor_Progress.md(台账)。
2026-10-28 12:15:41 +08:00