Geopro 3.0 桌面客户端

地球物理勘探数据可视化桌面客户端（Qt 6 + VTK 9，C++）。复刻 Geopro 3.0 核心「项目分析视图」。

M1 范围、架构与决策见 docs/superpowers/specs/2026-06-07-geopro-desktop-m1-design.md。 上位技术基线见 docs/Geopro3.0_技术选型与架构规约.md。 环境搭建见 docs/ENV_SETUP_Windows.md。

技术栈

Qt 6.11（QtWidgets）+ VTK 9.6 · CMake + Ninja · 官方 MSVC 预编译 Qt + vcpkg（仅非 Qt 依赖）· MSVC（VS 2022/2026）/ C++17 · ADS 停靠 · GDAL/PROJ · OpenSSL · QtKeychain。

目录（设计 §3）

src/core/        纯业务，零 Qt/VTK
src/data/        Repository + 解析器
src/net/         ApiClient / AuthService / Credential
src/render/      VTK 场景与 actor（单一场景 + 相机预设）
src/view/        QtWidgets 面板
src/controller/  联动编排
src/app/         入口 + 主窗（M1 spike：Qt+VTK 冒烟程序）
tests/           gtest / Qt Test
tools/           离线验证脚本（validate_samples.py）
docs/            规约、API、样本数据、设计文档

构建与运行

前置：Visual Studio 2022/2026（勾选「使用 C++ 的桌面开发」工作负载，自带 CMake + Ninja）、Git、vcpkg 并设环境变量 VCPKG_ROOT。构建方案②：单一官方 MSVC 预编译 Qt（CMAKE_PREFIX_PATH → D:/Qt/6.11.1/msvc2022_64）、VTK 预编译于 external/vtk-install、ADS/QtKeychain 经 FetchContent 对接同一份 Qt、仅非 Qt 依赖（GDAL/PROJ/OpenSSL/…）走 vcpkg。详见 docs/ENV_SETUP_Windows.md。

⚠️ 本机 cmake / ninja / cl 默认不在 PATH，必须在已激活 MSVC 环境的终端里构建。下面三种方式都已处理好这一点。

方式一：一键脚本（推荐）

项目根的 build.bat 自动用 vswhere 定位 VS、激活 MSVC 环境、按需配置并编译。在 cmd 里于项目根执行 build <命令>：

命令	作用
build（或 build app）	编译主程序 geopro_desktop（默认）
build run	编译并运行主程序
build test	编译并跑单元测试（ctest）
build all	编译全部目标
build configure	改了 CMakeLists / 新增源文件后，强制重新配置

方式二：Visual Studio 打开文件夹

VS →「打开本地文件夹」→ 选仓库根 → 自动识别 CMakePresets.json → 选配置 MSVC Release → 菜单「生成 → 全部生成」；运行/调试目标选 geopro_desktop。

方式三：手动命令行

开始菜单打开「x64 Native Tools Command Prompt for VS」（已带 MSVC 环境），在仓库根（CMake 用 VS 自带的全路径，因其不在 PATH）：

set CMAKE="%VSINSTALLDIR%Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe"
%CMAKE% --preset msvc-release                          :: 配置（首次 / 改 CMakeLists 后）
%CMAKE% --build build/release --target geopro_desktop  :: 编译主程序
build\release\src\app\geopro_desktop.exe               :: 运行
%CMAKE% --build build/release --target geopro_tests    :: 编译测试
ctest --test-dir build/release --output-on-failure     :: 跑测试

（Debug 用 --preset msvc-debug，对应 build/debug。%VSINSTALLDIR% 在 Native Tools 提示符里已设好。）

构建目标与产物

• geopro_desktop — 主程序，产物 build/release/src/app/geopro_desktop.exe
• geopro_tests — 单元测试，配 ctest
• 不带 --target 编译全部

改了已有 .cpp/.hpp 直接 --build（Ninja 增量）；改了 CMakeLists.txt 或新增源文件需先 --preset / build configure。链接报 LNK1104（文件被占用）时，先关掉运行中的 geopro_desktop.exe。

当前状态

M1 设计完成（v2，经双专家评审）。进入 spike 预研（设计 §15）：① 全 vcpkg 构建/部署 ② ADS + QVTKOpenGLStereoWidget 停靠稳定 ③ 真实样本跑通 banded contour。spike 通过后展开完整实现计划。