Commit Graph
9 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash 4479aa52a5 UI 重构:其余计划项全部结案(附不采用理由),计划不再有悬空阶段
评估阶段最后的产物:把"能做但收益不成立"的项显式结案,而不是留成待办。
- Documents/UI_Refactor_Plan.md:P3 行改为「Toolbar/TabBar 已迁移;PopupMenu/ColorPicker/
  SignalPanel 行经评估不采用」;P4 行改为「经评估不采用」。
- Documents/UI_Refactor_Report.md 第 7 节重写为「其余计划项的处理结论(均已结论,无悬空项)」,
  逐项给出基于代码事实的理由:
  * PopupMenu / ColorPicker:模态浮层每帧整体重画、命中是 <=20 行矩形线性扫描,
    且已有单一 BuildLayout 同时产出绘制与命中矩形(已是同源几何)⇒ 控件树额外收益近零,
    风险集中在子菜单悬停/内联编辑/滚动/拖拽钳制。
  * SignalPanel 行:性能来自行位图缓存(PaintRowCached + RowCacheKey)与抽拉式折叠动画,
    控件化会把缓存键与控件生命周期耦合,且"行高永不变、只平移"与通用布局模型冲突。
  * 5 个浮动面板(P4):面板像素层已缓存到 0.3ms(全画 24~35ms)⇒ 控件化无帧时间收益;
    几何已是单一纯函数(5 种面板共享);控件化需重写吸顶/滚动/滚动条/滑块复位/行悬停压暗,
    回归面极大。
  * 56 处 InvalidateRect 并集:InvalidatePlotRect() 已是按消息的批处理点,逐处替换只增间接层。

验证:make release 零警告;Tools/uicheck 69/69;Tools/rendercheck 7 条功能断言 PASS,退出码 0。
2026-10-28 12:47:01 +08:00
DeepSeek V4.1 Flash 47bb500954 UI 重构:文档按 M1/M2 里程碑划分,M1 标记为已验收
- Documents/UI_Refactor_Report.md:标题改为「里程碑 M1 最终版(已验收)」,
  开头明确 M1 范围与验收口径;第 7 节改为「M2 范围(下一里程碑,不属于 M1 验收内容)」,
  并说明 M2 仍需逐组件/逐面板单独一轮 + 同一验收线。
- Documents/UI_Refactor_Progress.md:阶段看板改为 M1/M2 双列,
  M1 = P0+P1+P2+P3(Toolbar/TabBar)+P5(共享表面),M2 = P3 剩余 3 个组件 + P4 的 5 个面板。

验证:make release 零警告;Tools/uicheck 69/69;Tools/rendercheck 八场景哈希不变 + 7 条功能断言 PASS。
2026-10-28 12:45:31 +08:00
DeepSeek V4.1 Flash 0bb38a887e UI 重构:关闭「脏区并集」计划项并记录评估结论
- Documents/UI_Refactor_Report.md §7:把「56 处 InvalidateRect 收敛为脏区并集」改为
  **评估后不采用(计划项已关闭)**,理由基于代码事实:ApplicationInternal.hpp 的
  InvalidatePlotRect() 已是「按消息一次回送」的批处理点,现状不存在同一消息多次回送;
  逐处替换只会多一层间接调用,并把「回送必须有无条件 else」这条历史教训藏得更深。
  真正需要脏区并集的是控件树接入之后(节点失效 → 根聚合),属下一里程碑前置。
- 同节把 PopupMenu / ColorPicker 的迁移说明改为「TabBar 已完成,这两者待做」并沿用同一验收线。
- Documents/UI_Refactor_Plan.md:P5 行同步标注该结论。

验证:make release 零警告;Tools/uicheck 69/69;8 场景像素哈希不变;
7 条功能断言(3 工具栏 + 4 标签栏)全 PASS。
2026-10-28 12:43:14 +08:00
DeepSeek V4.1 Flash f242fb076c UI 重构:文档纳入 TabBar 迁移(P3 完成 2/5)
- Documents/UI_Refactor_Progress.md:阶段看板 P3 标记为「Toolbar + TabBar 已完成」;
  新增第 6 条提交记录(TabBar 新旧实现对照 + 手势语义未变的说明 + 8 场景哈希 + 4 条交互断言)。
- Documents/UI_Refactor_Report.md:交付表 P3 改为 2/5;关键数字(已迁移组件、产物 886,784 B);
  提交清单加入 cd3a3fa;新增 5.1 节描述 TabBar 迁移与双轨验证。

验证:make release / make debug 零警告;Tools/uicheck 69/69;8 场景像素哈希与迁移前一致。
2026-10-28 12:42:31 +08:00
DeepSeek V4.1 Flash c3b79a6d2c UI 重构 P3(2):TabBar 迁移到控件树(逐像素 0 差异 + 4 条交互断言)
TabBar 的标签 / 「+」/ 覆盖层拆成控件,手势语义原样保留(自行判双击、3px 拖拽阈值、
关闭 ✕ 的「移开取消」、拖拽排序的 drop 位置),公开 API 未变:

- 新增(TabBar.cpp 内实现的内部控件)
  * UiTabItemWidget:单格标签的绘制(底色/描边/激活指示条/文本或重命名输入框/关闭 ✕),
    关闭按钮热区由基类的悬停点自行判定。
  * UiAddWidget:「+」按钮绘制与悬停配色。
  * UiOverlayWidget:命中透明的覆盖层,最后绘制「拖拽插入指示条 + 底部分隔线」
    (必须晚于标签与「+」,否则会被它们压住)。
  * UiTabRootWidget:只铺标签栏底色。
- TabBar 移除 m_hoverIndex / m_hoverClose / m_hoverAdd 三个手工下标,
  改为 dispatch MOUSE_MOVE 后由 root->TakeDirty() 判断是否需要重绘。
- 绘制顺序保持:底色 → 各标签 → 「+」→ 拖拽指示条 → 底部分隔线(与旧实现逐像素一致)。
- UiWidget 新增 HoverPoint(x,y):派生控件据此自行判断「悬停在自身内部哪个热区」。

验证:
- 像素:8 场景哈希与迁移前逐一相同(A 2166933…、H 23F390D…)。
- 交互断言(全部 PASS):
  * tabbar-hover-marks-dirty (1,0)         —— 进入标签只标记一次脏区;
  * tabbar-add-creates-tab (1 -> 2)        —— 「+」新建标签;
  * tabbar-click-selects-tab (active=0)    —— 点击标签切换激活页;
  * tabbar-close-removes-tab (2 -> 1)      —— 点击 ✕ 关闭标签。
- Tools/uicheck 69 passed / 0 failed。
- make release / make debug 零警告;Target.exe 886,784 B(< 900KB)。
2026-10-28 12:41:57 +08:00
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 4f3c88f398 UI 重构:文档更新为 P0-P3 + P5(1)(共享表面与退出崩溃修复)
- Documents/UI_Refactor_Progress.md:阶段看板标记 P5 部分完成;新增第 5 条提交记录
  (UiSurface / top-down DIB / Shutdown 顺序修复 / Render 保护 / 69 项断言 / 8 场景哈希);
  修正重复标题;「下一步」重写为 TabBar→菜单→面板→脏区并集。
- Documents/UI_Refactor_Report.md:标题与交付表纳入 P5(1);关键数字更新(69 项断言、
  产物 883,200 B、共享 DIB);新增第 7 节描述共享表面与退出期崩溃修复;后续章节重编号。

验证:make release / make debug 零警告;Tools/uicheck 69/69;8 场景渲染哈希与改造前一致。
2026-10-28 12:35:39 +08:00
DeepSeek V4.1 Flash 9a9802e589 UI 重构:报告更新为 P0-P3(含 Toolbar 迁移),并补记框架裁剪约定变更
- Documents/UI_Refactor_Report.md:标题改为 P0/P1/P2/P3-Toolbar;新增第 6 节
  「P3:Toolbar 迁移到控件树」(新旧实现对照表、UiButtonWidget、kUiClipBleed 约定、
  8 场景像素哈希 + 3 条功能断言);关键数字更新(产物 881,664 B、已迁移 1 个组件);
  重排后续章节编号(7 未做项 / 8 下一步 / 9 结论)。
- Documents/UI_Refactor_Progress.md:阶段看板标记 P3 为「Toolbar 已完成,其余待做」,
  补第 4 条提交记录与新的「下一步」。

验证:make release / make debug 零警告;Tools/uicheck 62/62;Target.exe 881,664 B。
2026-10-28 12:29:59 +08:00
DeepSeek V4.1 Flash 7e1852c2d2 UI 重构:补充进度台账、阶段报告与共享记忆同步
- Documents/UI_Refactor_Progress.md 补齐 P2 续(PlotViewPanels.cpp)的完成状态、七个分片行数、
  逐像素 A/B 哈希与"回退到旧文件做 A/B 时必须先删陈旧 .o"的复现要求。
- 新增 Documents/UI_Refactor_Report.md:第一阶段(P0/P1/P2)交付物、关键数字、
  基础层契约、验证方式、过程中修掉的 4 个自身缺陷、明确未做项与下一步排序。
- Documents/agent_mem.md:§11.2 追加第 235-240 条(基础层位置与边界、只沿命中链派发、
  Paint 三条契约、布局缓存纪律、PlotView 七分片硬约束、uicheck 回归网),
  并在 §10 变更日志追加本阶段一行。

验证:make release / make debug 零警告;Tools/uicheck 62 passed / 0 failed;
Target.exe 877,568 B(< 900KB)。
2026-10-28 12:22:09 +08:00