refactor/pure-qt-ui #3

gaozheng · 2026-06-10T18:41:39+08:00

gaozheng commented

2026-06-10 18:41:39 +08:00

No description provided.

gaozheng added 56 commits 2026-06-10 18:41:39 +08:00

caf6f9ebd0 docs(build): 新增 build.bat 一键构建脚本 + README 补充构建与运行说明

1a9fb72cf0 feat(ui): impeccable 设计令牌体系 + 空状态/语义色/动效 + dock 标题修复

- typeset: Theme.hpp 新增排版令牌(type::)，统一各处散落字号/字重
- layout: 间距/圆角令牌(space::/radius::)，圆角 6 档→2 档，手调奇数余白对称化
- delight: 中央空状态引导浮层、上下文化加载文案、登录错误淡入
- colorize: 语义色令牌(semantic::)，项目状态着色、状态栏错误染色、异常徽标警示色(休眠)
- overdrive(休眠): 详情视图相机补间+actor淡入(animateReveal)，待 dd 详情渲染接通后激活
- fix(dock): restoreState 后重新隐藏 ADS 子窗口标题栏，修复已保存布局下标题栏复现

6df2c4832c chore(ela): ElaWidgetTools 评估 spike + 全面迁移计划 + 构建 TEMP 兜底

- spike/ela: 隔离 demo 验证 ElaWindow + ADS 内嵌 + QVTK + 明暗切换(Qt6.11.1/MSVC 构建通过)
- CMakeLists: FetchContent 引入 ElaWidgetTools(fork,SOURCE_SUBDIR 仅编库) + 挂 spike
- build.bat: TEMP/TMP 重定向到 D: 构建目录,规避 C: 盘满导致的 LNK1108
- docs: 全面 Ela 化迁移计划(P0-P4 + 控件映射表 + 风险登记)

c4d76f57b6 新增claude.md(karpathy)

fc282824b9 feat(ela): P1 换壳 — ElaWindow 包裹工作台(GEOPRO_UI_SHELL=ela 开关)

- src/app/CMakeLists: 链接 ElaWidgetTools + 部署 Qt 插件(platforms/imageformats/iconengines/styles)到 exe 旁
- main.cpp: GEOPRO_UI_SHELL=ela 时用 ElaWindow.setCentralCustomWidget 包裹内层 QMainWindow 承载工作台;
  经典壳为默认且行为不变(仅改堆分配); buildWorkbench 零改动; 全程可回退
- build.bat: 还原(撤销上次破坏脚本解析的中文 TEMP 注释); 构建临时目录改由调用方 TEMP->D: 设置

8d938dd848 fix(ela): P1 code review 修复

- H1: ElaWidgetTools GIT_TAG 钉到 b80eadc(可复现)
- H3: 内层 QMainWindow 以 ElaWindow 为父构造(避免无父期调色板/DPI 抖动)
- M4: spike 改 option(GEOPRO_BUILD_ELA_SPIKE) 守卫,默认不编
- 备注: ctest 53/53 通过; C2(applyTheme 顺序)为 P1 有意共存,P2 主题桥统一; H2/M1 记入 P4

af0012fd70 fix(ela): P1 底部状态栏贴底边 — setCentralCustomWidget 改 addPageNode

ElaCentralStackedWidget::setCustomWidget 用 insertWidget(0,...) 把控件插到页栈容器之上,
被禁用的空导航页栈仍占底部空间,状态栏不贴底边。改用 addPageNode 把工作台作为唯一页面
放进中心页栈,填满到底边。

26404cee2f feat(ela): P2 暗色主题桥 — ElaTheme 明/暗 → 全局 QSS+调色板联动

- Theme.cpp: kDarkMap 浅→暗 hex 映射, 复用 kStyleSheet 结构生成暗色 QSS(含 ads--*);
  buildPalette(dark) 暗色调色板; applyThemeMode(app,dark); applyTheme=浅色快捷入口
- main.cpp(ela 分支): 连 ElaTheme::themeModeChanged → applyThemeMode 同步非 Ela 面;
  初始对齐(解 review C2); Ctrl+Shift+T 切换(正式按钮待 P3 TopBar Ela 化)
- VTK 视口背景暗色联动记入 P4(渲染器在 buildWorkbench 内, 需另接)

c8812aa8a6 feat(ela): P3-a 登录窗 Ela 化 + eApp->init 无条件化

- main.cpp: eApp->init() 提到登录前无条件调用(Ela 控件在登录窗/各面板都要用,登录在选壳前)
- LoginWindow: 输入框→ElaLineEdit, 记住登录→ElaCheckBox, 登录按钮→ElaPushButton;
  去掉它们的自定义 QSS 让 Ela 自绘 Fluent+自动明暗; 品牌头/字段标签/验证码/刷新链接保留
- Ela 控件均继承对应 Qt 基类, 故成员仍用 Qt 指针(多态), 不改 .hpp; 现有方法调用照常

ef278ac335 feat(ela): P3-b 项目列表弹窗 Ela 化 — 输入/下拉/按钮→Ela*

nameEdit_→ElaLineEdit, typeCombo_→ElaComboBox, 搜索/重置/上一页/下一页→ElaPushButton;
表格(QTableWidget)保留并靠 P2 暗色 QSS 联动

9091d8c929 fix(ela): 启动主题跟随 ElaTheme 初始模式(review M2)

避免系统暗色启动时登录窗(标准控件)与 Ela 控件明暗错配。

8a82029553 fix(ela): 工作台配色改为取自 ElaTheme(里外一致) — 修明暗都不对

根因: 我那套自挑的浅/暗配色与 ElaWindow 外壳的 Fluent 配色不一致, 里外两种色, 明暗都割裂。
改法: kRoleMap 把设计稿色令牌按语义角色映射到 ElaTheme 颜色角色, styleSheetForMode/
buildPalette 用 eTheme->getThemeColor(当前模式,角色) 取真实颜色, 与外壳同源。
(已知: #FFFFFF 兼作面板底与按钮文字, 全局替换后暗色下默认按钮文字对比度略弱, 影响很小)

4a785ede88 fix(ela): 内联 chrome 也跟随主题 — 修暗色下切换器文字看不清等

截图问题根因: TopBar/PanelHeader/3D浮层 用每控件内联 setStyleSheet(硬编码浅色 hex),
未走全局 ElaTheme 替换 → 暗色下保持浅色令牌(深字落深底→看不清; 白底面板表头等)。
新增 applyThemedStyleSheet(widget,设计稿QSS): 按 ElaTheme 角色着色 + 随明暗自动重着色。
TopBar/PanelHeader/layerPanel/layerTitle 内联样式全改走它; 补 #EEF1F5/#E6EAF1/#EAEEF5 角色。

57c452e2d3 feat(ela): 菜单全换 ElaMenu/ElaMenuBar(根治圆角露直角) + 登出功能

- TopBar: 4 主菜单/子菜单/切换器菜单 → ElaMenu, 菜单栏 → ElaMenuBar(自绘透明圆角弹窗+随主题);
  去掉 #appMenuBar 内联 QSS; Theme.cpp 删除 QMenuBar/QMenu QSS(否则 border-radius 仍露直角)
- 登出: 头像改可点击 QToolButton + ElaMenu「退出登录」→ logoutRequested 信号;
  main 接信号 → forgetSession() 清凭证 + QProcess 重启回登录页(撤销之前的 GEOPRO_FORCE_LOGIN 补丁)

f5eff9e185 feat(ela): C VTK 视口背景随主题 + A 浮层勾选框 Ela 化

- vtkBackground(): 取 ElaTheme 窗口底色; CentralScene/详情渲染器初始用它; 切主题时中央+详情重设+刷新
- 浮层图层勾选(帘面/体素/切片/地形) → ElaCheckBox
- 说明: 自定义 chrome(工作空间/项目切换器/图标按钮/PanelHeader tab/工具条)保留并随主题(强换 Ela 会丢设计); 状态栏由 QSS 随主题

68d832c57b fix(ela): 登录窗主题化 + VTK 背景稳健随主题 + 扫清所有硬编码浅色 QSS 遗漏

- 登录窗: setStyleSheet → applyThemedStyleSheet(整窗随主题, 品牌带文字用 white 关键字恒白);
  refreshBtn/errorLabel 也随主题。修暗系统下浅窗+暗 Ela 控件割裂、占位文字看不清
- VTK: 改为主题切换时重跑 rebuildCentral/rebuildDetail(走完整渲染必重绘, 兼顾 syncSystemTheme
  异步切暗时序); rebuildDetail 也按 vtkBackground 设背景
- 主动扫描修掉遗漏: dockManager 分隔条、数据集/文件列表、对象树枝/hint、空状态标题/提示 全走主题
- themed() 公共助手(给需拼接 ADS 样式的 dockManager)

389a2da744 feat(ela): 表格→ElaTableWidget(直替) + 对象树→ElaTreeView+QStandardItemModel

- ProjectListDialog: QTableWidget → ElaTableWidget(item 版直接继承 QTableWidget, 1 行)
- ObjectTreePanel: QTreeWidget → ElaTreeView + Qt 自带 QStandardItemModel(非手写 model);
  QTreeWidgetItem→QStandardItem, 勾选/点击逻辑改按 QModelIndex/itemChanged; ElaTreeView 自绘
  展开折叠指示(去掉自定义 chevron QSS); 行为(TM 勾选/点击发 tmClicked/tmCheckToggled)保持

8e7563c0f5 feat(ela): 数据集/文件/异常列表 → ElaListView + QStandardItemModel

- DatasetListPanel/AnomalyListPanel: populate 签名 QListWidget*→QStandardItemModel*,
  QListWidgetItem→QStandardItem(setData(value,role)/setCheckable/setIcon/setForeground)
- main.cpp: 3 列表 → ElaListView + QStandardItemModel; removeLoadMore/addLoadMore 改 model
  (rowCount/item/removeRow/appendRow); itemClicked→clicked(QModelIndex);
  anomaly itemChanged→model itemChanged; 加载更多/勾选显隐/点击 行为保持
- 注: 列表交互(异常显隐/加载更多/数据集点击)为活逻辑, 需运行验证

b6e0142d06 feat(ela): TopBar 图标/切换器 + PanelHeader 页签/操作按钮全 Ela 化(头像除外)

- TopBar: help/bell/gear → ElaIconButton(Fluent 图标字体, 自动主题);
  工作空间/项目切换器 → ElaToolButton; 去掉 #wsSwitcher/#iconBtn QSS(Ela 自绘);
  头像保留自定义圆形(白字用 white 关键字恒白)
- PanelHeader: 数据/文件等页签 → ElaToolButton(选中态走 Ela checked 高亮);
  表头操作按钮 → ElaIconButton; headerQss 去掉 tabBtn/panelAction 规则

3aa4e1bfe2 feat(ela): 视图/详情工具条 → ElaToolButton 行(替 QToolBar+QAction)

- 视图工具条(二维地图/三维视图): QToolBar+QActionGroup → QWidget+QHBoxLayout+ElaToolButton+QButtonGroup(互斥)
- 详情工具条(原数据/网格数据 互斥 + 显示异常/电极/等值线 开关): 同上 + QFrame 分隔
- 连接: QAction::triggered→QAbstractButton::clicked, QAction::toggled→QAbstractButton::toggled;
  视图模式/详情模式/叠加显隐 行为保持
- 注: 工具条交互(2D/3D 切换/详情模式/三个显隐开关)为活逻辑, 需运行验证

2be49b205c fix(ela): 图标按钮变形 + tooltip 丑

- ElaIconButton(icon,pixelSize,parent) 不设固定尺寸→图标被压扁; 改用带固定宽高的构造
  (TopBar help/bell/gear: icon,18,34,34); PanelHeader 操作按钮(QPixmap 构造)显式 setFixedSize(30,30)
- 删全局 QToolTip QSS(深蓝底+蓝边框+圆角→弹窗露直角且不像原生)→ 用系统原生工具提示

5a945e51a7 fix(ela): 面板表头/页签图标随主题着色(点3)

- 新增 setThemedGlyph(QLabel*/QAbstractButton*, Glyph, px): 取 ElaTheme 主文本色(暗=浅/亮=深)绘制,
  主题切换自动重绘
- PanelHeader 表头标题图标(原 #44546B 固定→暗色看不清)、页签图标(原 #5A6B85) 改走 setThemedGlyph
  → 对象显示栏/数据集显示栏/异常列表等所有面板图标在明暗下都清晰

c5393e8ac3 fix(ela): 标题栏收紧 + 切换器去掉重复下拉箭头

- ElaWindow AppBarHeight 45→38(默认偏大, 更接近原生标题栏高度)(点1 过大)
- 切换器去掉文字里手加的 '▾'(ElaToolButton 给带菜单按钮自绘展开箭头, 原来与文字▾重复)(点2)
- 注: 显示为 100% 缩放, 无 DPI 模糊; 若 Ela 自带标题栏图标仍觉软, 属其 Fluent 渲染风格

0867636ea4 feat(ela): 统一品牌强调色 + 切换器箭头修复 + 图标中性化 + 树缩进收紧

配色根因: Ela 默认主色(#0067C0亮/#4CC2FF暗)与项目品牌蓝 #2D6CB5 是两种蓝, 互相打架。
- applyBrandAccent(): 用 ElaTheme::setThemeColor 把 Primary 设成品牌蓝(亮 #2D6CB5/暗 #5E9BD6,
  含 Hover/Press 三态) → 所有 Ela 原生控件选中/激活/标题栏强调 + 本项目 QSS 共用一套蓝
- 切换器图标: #2D6CB5 → setThemedGlyph 中性主题色(蓝只留给选中/激活), 与面板图标一致
- 切换器箭头: 成员 QToolButton* → ElaToolButton*, setMenu 走 Ela 重载 → Ela 自绘清晰展开箭头
  (之前去掉手加的▾后没箭头, 是因为基类 setMenu 不触发自绘)
- 对象树缩进 20→14, 更紧凑

ec428ccaca fix(ela): 面板占位按钮(筛选/上传/添加/导出/折叠)改 Ela 字体图标

之前用 makeGlyph 位图 + 30×30 → 偏大且发糊。改为 ElaIconButton 字体图标(actionElaIcon 映射
Glyph→ElaIconType: Filter/Upload/Plus/Download/ChevronUp), 16px 图标 + 28×28 按钮,
与顶栏 帮助/通知/设置 一致: 清晰、随主题、尺寸协调

107fed8182 fix(ela): 工具条选中态 + 切换器箭头改用 QToolButton+主题QSS(清晰可控)

ElaToolButton 硬限制: 选中态只画极淡 BasicHover(看不清)、展开箭头不可靠、且自绘无法被 QSS 覆盖。
故交互态强的这两类退回 QToolButton + applyThemedStyleSheet(用统一强调色):
- 视图/详情工具条(2D/3D, 原数据/网格数据, 显示异常/电极/等值线): 选中 = 强调色文字 + 2px 强调色下划线,
  明暗都清晰可辨
- 切换器: QToolButton + 文字'▾'(清晰, 不再是 ElaToolButton 那个发糙/消失的箭头) + 悬停底
其余(菜单/列表/树/表单/图标按钮)仍 Ela。强调色已全局统一为品牌蓝

464911dc57 fix(ela): 页签与工具条统一为同一套切换样式(消除三套不一致)

PanelHeader 页签(数据/文件, 异常列表/对象属性)从 ElaToolButton 退回 QToolButton, headerQss
恢复 tabBtn 下划线规则: 选中 = 强调色文字 + 2px 强调色下划线 — 与视图/详情工具条完全一致。
至此全 UI 的切换控件(页签 + 分段工具条)是同一种视觉语言。

cfd39e5be8 fix(ela): 对象树退回标准 QTreeWidget(复选框清晰) + 行内边距收紧

ElaTreeView 是 ElaWidgetTools 自绘控件(非 Qt 原生), light 下复选框对比度不足、选中渲染有局限。
- 对象树 ElaTreeView+QStandardItemModel → 标准 QTreeWidget+QTreeWidgetItem:
  复选框/展开箭头由 Fusion 原生绘制, 明暗都清晰; 行为(TM 勾选/点击)不变
- 全局 QTreeView::item padding 8px→4px: 行间距过大修正

e3a1b18efa chore(ela): 去掉 GEOPRO_UI_SHELL 兜底开关 + 新增开源 NOTICE

- main: 删除 env 选壳分支与经典 QMainWindow 回退, ElaWindow 成为唯一外壳(迁移已稳定)
- NOTICE.md: 列出第三方组件与许可证(Qt LGPL / VTK BSD / ADS LGPL / ElaWidgetTools MIT /
  QtKeychain BSD) 及合规要点、Ela 版本钉定说明

934e25be54 fix(tree): 自绘清晰复选框(明暗都可见) + 选中整行连续(去碎片框)

- 多余选中框: 全局 QTreeView::item 去掉 border-radius+margin → 选中是整行连续一条, 不再浮动碎块
- light 复选框看不清: Fusion 原生复选框浅底边框过淡。writeCheckboxIcon 自绘 PNG
  (未选=明显边框空心框, 选中=强调色底+白勾), 明暗各一套, 经 QTreeView::indicator QSS 引用,
  主题切换重绘 → 明暗都清晰

66cf432a98 fix(theme): 选中底色统一加强(对象树+所有列表)

根因: ElaListView 的 BasicSelectedAlpha 默认是半透明灰、对比度弱; 树 QSS 选中也偏淡。
设计统一的强调蓝选中底(明 #C2D9F2 / 暗 #33527A, 强对比):
- applyBrandAccent: 设 BasicSelectedAlpha/BasicSelectedHoverAlpha 为该实色 → 所有 Ela 列表
  选中底变清晰(并保留其 3px 强调色左竖条)
- 对象树: 本地 QSS item:selected 设同款蓝 + 适配文字色, :!active 防失焦变淡

52bdf054a6 fix(list): 数据/文件/异常列表退回标准 QListWidget + 写死强选中色

根因: ElaListView 的选中底走 BasicSelectedAlpha, setThemeColor 改它对 ElaListView 不生效(自绘控件坑),
选中色无法变强。与对象树同理, 退回 Qt 原生 QListWidget:
- 3 列表 ElaListView+QStandardItemModel → QListWidget+QListWidgetItem(populate/加载更多/点击/勾选 全回退)
- applyListSelection: 本地 QSS 写死强调蓝选中(明 #C2D9F2 / 暗 #33527A + 适配文字, :!active 防失焦淡),
  与对象树选中色完全一致, 100% 可控、明暗都清晰
- 行为(加载更多/数据集点击/异常勾选显隐)保持

a13b58e09f feat(settings): 设置对话框(外观/关于) + 主题持久化 + 界面字号

- 主题持久化(QSettings ui/themeMode: system/light/dark): 启动时 applyPersistedThemeMode 在弹登录窗前
  应用 → 登录页与主页明暗统一(修登录页一直 dark); 设置里改主题热切, Ctrl+Shift+T 仍可用
- 界面字号(ui/fontScale: 90/100/115/130): applyPersistedFontScale 设 qApp 基准字体; scaledPx() 让
  内联 QSS 的 chrome(顶栏/面板表头/工具条/登录/浮层)字号也随之缩放; 字号改动重启后整体统一生效
- SettingsDialog: 左分类(外观/关于)+右页; 外观=主题下拉+字号下拉(+立即重启); 关于=版本+第三方许可
- 顶栏齿轮 → settingsRequested → 打开设置

9010b20b57 refactor(ui): 方案A — 移除 ElaWidgetTools，统一为标准 Qt + 单一设计系统

根因: 此前 Fusion+自定义QSS+ElaWidgetTools(自绘控件) 三套样式系统并存、互相打架，
是各种丑/不一致的来源。本次彻底收敛为一套:

- 移除 ElaWidgetTools 依赖(CMake FetchContent + 链接 + spike)；所有 Ela* 控件 → 标准 Qt:
  ElaWindow→QMainWindow(原生标题栏)、ElaMenu/MenuBar→QMenu/QMenuBar、ElaLineEdit/ComboBox/
  CheckBox/PushButton/ToolButton/Text/TableWidget→对应 Qt、ElaIconButton→QToolButton+glyph
- 主题系统: 自建 ThemeManager(替代 ElaTheme，QStyleHints 检测系统明暗、持久化、changed 信号热切)
  + 单一「浅→暗」颜色映射(kDarkMap，全 UI 唯一颜色来源) + 单份 QSS(明色基线，暗色按表替换)
- 主题: 跟随系统/浅/深(持久化, 启动应用→登录与主页统一); 字号缩放经 scaledPx 覆盖内联 chrome
- NOTICE/关于 同步去掉 ElaWidgetTools
- ctest 53/53

a6a3979b93 fix(ui): 下拉框弹窗 — 干净填充选中 + 去边框/圆角伪影

QComboBox 弹窗当前/选中项原来显示一个细边框方块(Fusion 默认 + 缺 ::item 规则)。
补 QComboBox QAbstractItemView::item 规则: 统一行高/内边距、去边框、选中=浅蓝填充+强调色文字;
去掉 view 的 border-radius(防圆角弹窗露直角)。改一处(单一 QSS)即生效。

6c34f71177 fix(ui): 下拉框弹窗改为紧贴文本框下方的单层列表(AppProxyStyle)

根因: Fusion 的 combo 弹窗是「菜单式覆盖当前项」(SH_ComboBox_Popup=true) → 位置怪、
容器框+列表两层、选中/悬停不清。AppProxyStyle 把该 hint 改为 0 → 标准「下方下拉列表」:
位置紧贴文本框、单层、当前项与悬停项走 ::item:selected 高亮。

0edfa56ec6 docs: 设计规范落地计划 + 基线与偏离记录

18d084047f feat(theme): 语义令牌基础设施（令牌表+token/fillTokens API，规范§1）

425e17e6af feat(canvas): 数据画布常深 #0B1320（规范§0.5/§11）

b242240df6 feat(theme): 全局 QSS 模板化 + palette 从令牌，标准控件对齐规范色值（§1/§3/§6/§7）

58cabc6350 fix(view): 2D/3D 统一面板表头(分段页签) + 画布空状态提示用 canvas 令牌融入深底（规范§5/§6.5）

8eb0c7413d fix(canvas): 空状态去不透明卡片(移除OpacityEffect) + 视图详情转深色画布浮层（规范§6.5/§7.11）

e60bdbc150 fix(canvas): 空状态卡片用 canvas/bg 等色无缝底(原生GL覆盖透明失效的可靠解法)

b2ec3459c7 fix(canvas): 视图详情浮层去圆角(直角)消除浅色模式四白角伪影

b728631477 refactor(theme): TopBar/PanelHeader 内联样式迁移到语义令牌（规范§4.3/§5）

824e8bdf62 refactor(theme): 工作台内联色(对象树/数据详情工具条/停靠分隔)迁移到令牌（规范§4.2/§6.1/§6.12）

b26dcc1ca7 feat(panels): 数据/文件列表卡片化(标题+元信息双行+选中竖条)（规范§6.2）

8f31f043df feat(panels): 异常列表卡片化(色条+类型标签+显隐眼睛,真实数据)（规范§6.3）