# VTK 三栏结构重构 Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 把 VTK 工作台的"旧二维/三维切换 + 三浮层"过渡态，重构成需求 A1 的「三个子列表栏」（三维数据集 / 二维数据集 / 三维分析），内嵌在唯一的中央「VTK视图」左侧，并接通已有渲染/切片能力；同时给 VTK视图 + 数据详情 加全屏按钮。

**Architecture:** 三栏抽成独立 widget（`src/app/panels/columns/`），各自只发信号、不依赖控制器；`ColumnDrawer` 作为 `vtkWidget` 在 HBox 中的**左侧兄弟控件**（非 GL 浮层，规避原生 GL 浮层 z 序/圆角伪影），可折叠。`main.cpp::buildWorkbench` 删三浮层+分段切换，改挂三栏并把信号接到既有 `VtkSceneController`/`InteractionManager`/`DatasetDetailController`。数据集列表由 `WorkbenchNavController` 取 `DsRow`、按 `I3dSceneRepository::dimensionOf` 过滤后分发到三栏。

**Tech Stack:** C++17, Qt6 Widgets, VTK9, Qt-ADS。构建 `build.bat`（见"构建/验证铁律"），测试 GoogleTest/CTest。

---

## ⚠️ 构建/验证铁律（每个 Task 都遵守）

- 构建：从 Git Bash 调 `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat test"`。命令：`app`/`test`/`rebuild`(全量)/`configure`。
- **ninja 偶发漏编** → 改头/布局后用 `build.bat rebuild`；验 exe 新鲜：`stat -c '%y' build/release/src/app/geopro_desktop.exe`。
- **切勿 `rm -rf build/release`**（vcpkg 重编依赖极慢）。
- **Claude 工具跑 build 偶被 Start-Process 钩子劫持静默不跑** → **所有"用户实测"步骤必须由用户在其终端 `build.bat rebuild` 跑并目视**。Claude 不能 GUI 测 VTK 交互。
- 纯逻辑（如维度过滤）抽函数 + GoogleTest 单测；UI/交互靠 build 绿 + 用户实测清单。

## 测试方式约定（本计划特例，覆盖默认 TDD-everywhere）

- **逻辑步骤**（标 `[逻辑]`）：先写失败测试 → 跑红 → 实现 → 跑绿 → 提交。
- **UI 步骤**（标 `[UI]`）：实现 → `build.bat rebuild` 编绿 → **用户实测清单** → 提交。Claude 不声称"已验证"交互，只验证编译通过 + 代码读校。

---

## File Structure

**新建：**
- `src/app/panels/columns/ColumnDrawer.hpp/.cpp` — 抽屉容器（QTabWidget 三 tab + 折叠开关）。
- `src/app/panels/columns/Column3DDataset.hpp/.cpp` — 三维数据集栏（4 工具条栏位 + 3D 数据集树）。
- `src/app/panels/columns/Column2DDataset.hpp/.cpp` — 二维数据集栏（地图/2D视图控件 + 2D 数据集树）。
- `src/app/panels/columns/Column3DAnalysis.hpp/.cpp` — 三维分析栏（对象→三维体→切片 树 + 两个右键菜单）。
- `src/app/DatasetDimension.hpp/.cpp` — 纯函数 `splitByDimension(...)`（可单测）。
- `tests/app/test_dataset_dimension.cpp` — 维度过滤单测。

**修改：**
- `src/app/main.cpp` — `buildWorkbench`：删三浮层(393-556)/分段切换(380-389,832-843)/showLayerPanel(804-827)/相关 connect；改挂 ColumnDrawer；接信号；rename vtkDock；bump dockState 版本；接维度过滤；全屏按钮。
- `src/app/Glyphs.hpp/.cpp` — 加 `Glyph::Fullscreen` + SVG。
- `src/app/CMakeLists.txt` — 加新源文件。
- `tests/CMakeLists.txt`（或对应）— 加 test_dataset_dimension。

---

## Task 1: 加 Fullscreen 图标 [UI]

**Files:**
- Modify: `src/app/Glyphs.hpp:15-35`（Glyph 枚举）
- Modify: `src/app/Glyphs.cpp`（SVG path 映射，参照现有 case）

- [ ] **Step 1: 在 Glyph 枚举加 Fullscreen**

`src/app/Glyphs.hpp`，在 `Collapse,` 之后加：
```cpp
    Collapse,  // 折叠（双箭头）
    Fullscreen,  // 全屏 / 最大化
```

- [ ] **Step 2: 在 Glyphs.cpp 的 svg 映射加 case**

找到 `makeGlyph`/svg path 的 `switch`（参照 `case Glyph::Collapse:`），加：
```cpp
    case Glyph::Fullscreen:
        return QStringLiteral("<path d='M8 3H5a2 2 0 0 0-2 2v3m13-5h3a2 2 0 0 1 2 2v3"
                              "M21 16v3a2 2 0 0 1-2 2h-3M8 21H5a2 2 0 0 1-2-2v-3'/>");
```
（若已有 restore/缩小语义图标可复用，但需一个独立 Fullscreen 项。）

- [ ] **Step 3: 编译**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat app"`
Expected: 编译通过（exe 重新生成）。

- [ ] **Step 4: 提交**
```bash
git add src/app/Glyphs.hpp src/app/Glyphs.cpp
git commit -m "feat(vtk): 加 Glyph::Fullscreen 图标(三栏重构全屏按钮用)"
```

---

## Task 2: 维度过滤纯函数 [逻辑]

把"DsRow 列表 → 按维度分三组"抽成可单测纯函数。`dimensionOf` 已在 `I3dSceneRepository`（接口），这里做的是**列表分流**。

**Files:**
- Create: `src/app/DatasetDimension.hpp`
- Create: `src/app/DatasetDimension.cpp`
- Test: `tests/app/test_dataset_dimension.cpp`
- Modify: `src/app/CMakeLists.txt`、`tests/CMakeLists.txt`

- [ ] **Step 1: 写失败测试**

`tests/app/test_dataset_dimension.cpp`：
```cpp
#include <gtest/gtest.h>
#include "app/DatasetDimension.hpp"
#include "data/repo/RepoTypes.hpp"

using geopro::data::DsRow;
using geopro::app::splitByDimension;
using geopro::app::DimBuckets;

static DsRow row(const char* id, const char* ddCode) {
    DsRow r; r.id = id; r.ddCode = ddCode; return r;
}

TEST(DatasetDimension, SplitsByDdCode) {
    std::vector<DsRow> in{
        row("a", "dd_section"),          // 3D
        row("b", "dd_voxel"),            // 3D
        row("c", "dd_trajectory_data"),  // 2D
        row("d", "dd_slice"),            // Analysis
        row("e", "dd_unknownxyz"),       // Other → 不入任何栏
    };
    DimBuckets b = splitByDimension(in);
    ASSERT_EQ(b.dim3D.size(), 2u);
    EXPECT_EQ(b.dim3D[0].id, "a");
    EXPECT_EQ(b.dim3D[1].id, "b");
    ASSERT_EQ(b.dim2D.size(), 1u);
    EXPECT_EQ(b.dim2D[0].id, "c");
    ASSERT_EQ(b.analysis.size(), 1u);
    EXPECT_EQ(b.analysis[0].id, "d");
}

TEST(DatasetDimension, EmptyInput) {
    DimBuckets b = splitByDimension({});
    EXPECT_TRUE(b.dim3D.empty());
    EXPECT_TRUE(b.dim2D.empty());
    EXPECT_TRUE(b.analysis.empty());
}
```

- [ ] **Step 2: 跑测试确认失败**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat test"`
Expected: FAIL（`DatasetDimension.hpp` 不存在 / 链接失败）。

- [ ] **Step 3: 写实现**

`src/app/DatasetDimension.hpp`：
```cpp
#pragma once
#include <vector>
#include "data/repo/RepoTypes.hpp"

namespace geopro::app {

struct DimBuckets {
    std::vector<geopro::data::DsRow> dim3D;
    std::vector<geopro::data::DsRow> dim2D;
    std::vector<geopro::data::DsRow> analysis;
};

// 按 ddCode 把 ds 分流到 三维数据集 / 二维数据集 / 三维分析 三栏。
// Other 维度不入任何栏（保留 parentId 顺序，调用方可直接喂 populateDatasetList）。
DimBuckets splitByDimension(const std::vector<geopro::data::DsRow>& rows);

}  // namespace geopro::app
```

`src/app/DatasetDimension.cpp`：
```cpp
#include "app/DatasetDimension.hpp"

namespace geopro::app {

namespace {
// 与 LocalSample3dRepository::dimensionOf 同一映射（spec §6.1）。
// 抽到此处以便纯函数单测；将来后端返 dimension 字段时此函数改读字段即可。
enum class Dim { D3, D2, Analysis, Other };
Dim dimOf(const std::string& c) {
    if (c == "dd_voxel" || c == "dd_Structual3D" || c == "dd_Property3D" ||
        c == "dd_section" || c == "dd_inversion_data")
        return Dim::D3;
    if (c == "dd_slice") return Dim::Analysis;
    if (c == "dd_trajectory_data") return Dim::D2;
    return Dim::Other;
}
}  // namespace

DimBuckets splitByDimension(const std::vector<geopro::data::DsRow>& rows) {
    DimBuckets b;
    for (const auto& r : rows) {
        switch (dimOf(r.ddCode)) {
            case Dim::D3: b.dim3D.push_back(r); break;
            case Dim::D2: b.dim2D.push_back(r); break;
            case Dim::Analysis: b.analysis.push_back(r); break;
            case Dim::Other: break;
        }
    }
    return b;
}

}  // namespace geopro::app
```

> 注：`dimensionOf` 同时存在于 `LocalSample3dRepository`（渲染编排用）。此处复制映射是**有意**——纯函数便于单测、且与"将来后端返 dimension 字段"解耦。后续若收敛为单一真源，再让本函数调用注入的 repo。落地时若 reviewer 要求单一真源，可改签名 `splitByDimension(rows, const I3dSceneRepository&)`，本期按纯函数。

- [ ] **Step 4: 注册到 CMake**

`src/app/CMakeLists.txt`：把 `DatasetDimension.cpp` 加入 app 目标源列表（仿照同目录 .cpp 的加法）。
`tests/CMakeLists.txt`（或 tests/app）：把 `test_dataset_dimension.cpp` 加入测试目标（仿照 `test_3d_repo` 的注册）。

- [ ] **Step 5: 跑测试确认通过**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat test"`
Expected: `DatasetDimension.*` 2 项 PASS；总数 ≥ 223/223。

- [ ] **Step 6: 提交**
```bash
git add src/app/DatasetDimension.hpp src/app/DatasetDimension.cpp tests/app/test_dataset_dimension.cpp src/app/CMakeLists.txt tests/CMakeLists.txt
git commit -m "feat(vtk): 维度过滤纯函数 splitByDimension + 单测"
```

---

## Task 3: 三维数据集栏 widget [UI]

独立 widget：4 工具条栏位（坐标轴设置 / 水平垂直比例 / 快捷视图 / 缩放）+ 数据集树。只发信号。控件创建可**搬运** `main.cpp:433-516`（axisBar）的 combo/slider/button 构造与样式，重排成 4 分组（参照原型 `docs/superpowers/mockups/2026-06-16-three-column-layout.html` 的 `toolbar3D`）。

**Files:**
- Create: `src/app/panels/columns/Column3DDataset.hpp/.cpp`
- Modify: `src/app/CMakeLists.txt`

- [ ] **Step 1: 写头文件（信号 API）**

`src/app/panels/columns/Column3DDataset.hpp`：
```cpp
#pragma once
#include <QWidget>
#include <QStringList>
#include <vector>
#include "controller/I3dSceneView.hpp"   // AxesMode/AxesUnit/ViewDir
#include "data/repo/RepoTypes.hpp"

class QTreeWidget;

namespace geopro::app {

// 三维数据集栏：坐标轴设置 + 水平/垂直比例 + 快捷视图 + 缩放 + 3D 数据集列表。
class Column3DDataset : public QWidget {
    Q_OBJECT
public:
    explicit Column3DDataset(QWidget* parent = nullptr);
    // 用 3D 维度的 ds 填充列表（调用 populateDatasetList）。
    void setDatasets(const std::vector<geopro::data::DsRow>& rows);

signals:
    void axesModeChanged(geopro::controller::AxesMode mode);
    void axesUnitChanged(geopro::controller::AxesUnit unit);
    void verticalExaggerationChanged(double ve);
    void viewRequested(geopro::controller::ViewDir dir);
    void zoomInRequested();
    void zoomOutRequested();
    void fitRequested();
    void oPointClicked();   // O点位置按钮（本期弹框留 stub）
    void fontClicked();     // 字体按钮（本期 stub）
    void checkedDatasetsChanged(const QStringList& dsIds);  // 列表勾选变化

private:
    QTreeWidget* list_ = nullptr;
};

}  // namespace geopro::app
```

- [ ] **Step 2: 写实现（构造 4 分组 + 列表）**

`src/app/panels/columns/Column3DDataset.cpp`：用 `QVBoxLayout` 堆 4 个分组 `QGroupBox`/`QFrame`（标题 + 表单行）+ `QTreeWidget` 列表。控件构造照搬 `main.cpp:464-500`（axesModeCombo/axesUnitCombo/veSlider/btnFront..btnFit），样式用 `applyTokenizedStyleSheet` 照搬 `main.cpp:437-457`。各控件 `connect` 到本类 `emit ...`。要点（完整骨架）：
```cpp
#include "app/panels/columns/Column3DDataset.hpp"
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QFormLayout>
#include <QComboBox>
#include <QSlider>
#include <QPushButton>
#include <QLabel>
#include <QTreeWidget>
#include "app/Theme.hpp"
#include "app/panels/DatasetListPanel.hpp"   // populateDatasetList

using geopro::controller::AxesMode;
using geopro::controller::AxesUnit;
using geopro::controller::ViewDir;

namespace geopro::app {

Column3DDataset::Column3DDataset(QWidget* parent) : QWidget(parent) {
    auto* root = new QVBoxLayout(this);
    root->setContentsMargins(space::kMd, space::kMd, space::kMd, space::kMd);
    root->setSpacing(space::kMd);

    // —— 坐标轴设置 组：显示方式▾ / O点位置(按钮) / 刻度▾ / 字体(按钮) ——
    {
        auto* form = new QFormLayout();
        auto* mode = new QComboBox();
        mode->addItem(QStringLiteral("标准"), static_cast<int>(AxesMode::Standard));
        mode->addItem(QStringLiteral("三维立体"), static_cast<int>(AxesMode::Stereo));
        mode->addItem(QStringLiteral("不显示"), static_cast<int>(AxesMode::None));
        connect(mode, qOverload<int>(&QComboBox::currentIndexChanged), this,
                [this, mode](int){ emit axesModeChanged(static_cast<AxesMode>(mode->currentData().toInt())); });
        auto* oPoint = new QPushButton(QStringLiteral("设置…"));
        connect(oPoint, &QPushButton::clicked, this, &Column3DDataset::oPointClicked);
        auto* unit = new QComboBox();
        unit->addItem(QStringLiteral("无刻度"), static_cast<int>(AxesUnit::None));
        unit->addItem(QStringLiteral("米"), static_cast<int>(AxesUnit::Meter));
        unit->addItem(QStringLiteral("英尺"), static_cast<int>(AxesUnit::Feet));
        unit->addItem(QStringLiteral("经纬度"), static_cast<int>(AxesUnit::LatLon));
        unit->setCurrentIndex(1);
        connect(unit, qOverload<int>(&QComboBox::currentIndexChanged), this,
                [this, unit](int){ emit axesUnitChanged(static_cast<AxesUnit>(unit->currentData().toInt())); });
        auto* font = new QPushButton(QStringLiteral("设置…"));
        connect(font, &QPushButton::clicked, this, &Column3DDataset::fontClicked);
        form->addRow(QStringLiteral("显示方式"), mode);
        form->addRow(QStringLiteral("O点位置"), oPoint);
        form->addRow(QStringLiteral("刻度"), unit);
        form->addRow(QStringLiteral("字体"), font);
        root->addWidget(new QLabel(QStringLiteral("坐标轴设置")));
        root->addLayout(form);
    }
    // —— 水平/垂直比例 组：单个滑块 + 数值 ——
    {
        auto* row = new QHBoxLayout();
        auto* slider = new QSlider(Qt::Horizontal);
        slider->setMinimum(1); slider->setMaximum(10); slider->setValue(2);
        auto* val = new QLabel(QStringLiteral("2.0×"));
        connect(slider, &QSlider::valueChanged, this, [this, val](int v){
            val->setText(QStringLiteral("%1.0×").arg(v));
            emit verticalExaggerationChanged(static_cast<double>(v));
        });
        row->addWidget(slider, 1); row->addWidget(val);
        root->addWidget(new QLabel(QStringLiteral("水平/垂直比例")));
        root->addLayout(row);
    }
    // —— 快捷视图 组：前/后/左/右/上/下 ——
    {
        auto* row = new QHBoxLayout();
        struct V { const char* t; ViewDir d; };
        for (V v : { V{"前",ViewDir::Front}, V{"后",ViewDir::Back}, V{"左",ViewDir::Left},
                     V{"右",ViewDir::Right}, V{"上",ViewDir::Top}, V{"下",ViewDir::Bottom} }) {
            auto* b = new QPushButton(QString::fromUtf8(v.t));
            ViewDir d = v.d;
            connect(b, &QPushButton::clicked, this, [this, d]{ emit viewRequested(d); });
            row->addWidget(b);
        }
        root->addWidget(new QLabel(QStringLiteral("快捷视图")));
        root->addLayout(row);
    }
    // —— 缩放 组：放大/缩小/适配 ——
    {
        auto* row = new QHBoxLayout();
        auto* in = new QPushButton(QStringLiteral("放大"));
        auto* out = new QPushButton(QStringLiteral("缩小"));
        auto* fit = new QPushButton(QStringLiteral("适配"));
        connect(in, &QPushButton::clicked, this, &Column3DDataset::zoomInRequested);
        connect(out, &QPushButton::clicked, this, &Column3DDataset::zoomOutRequested);
        connect(fit, &QPushButton::clicked, this, &Column3DDataset::fitRequested);
        row->addWidget(in); row->addWidget(out); row->addWidget(fit);
        root->addWidget(new QLabel(QStringLiteral("缩放")));
        root->addLayout(row);
    }
    // —— 数据集列表（3D 维度）——
    list_ = new QTreeWidget();
    list_->setHeaderHidden(true);
    list_->setRootIsDecorated(true);
    applyDatasetCardDelegate(list_);
    connect(list_, &QTreeWidget::itemChanged, this, [this](QTreeWidgetItem*, int){
        QStringList ids;
        for (QTreeWidgetItemIterator it(list_); *it; ++it)
            if ((*it)->checkState(0) == Qt::Checked)
                ids << (*it)->data(0, /*kDsIdRole*/ Qt::UserRole + 1).toString();
        emit checkedDatasetsChanged(ids);
    });
    root->addWidget(list_, 1);
}

void Column3DDataset::setDatasets(const std::vector<geopro::data::DsRow>& rows) {
    populateDatasetList(list_, rows, /*append=*/false);
    // 列表项需可勾选：populateDatasetList 后给每项加 Qt::ItemIsUserCheckable + Unchecked。
    for (QTreeWidgetItemIterator it(list_); *it; ++it) {
        (*it)->setFlags((*it)->flags() | Qt::ItemIsUserCheckable);
        if ((*it)->checkState(0) == Qt::Unchecked || (*it)->checkState(0) == Qt::Checked) {}
        else (*it)->setCheckState(0, Qt::Unchecked);
    }
}

}  // namespace geopro::app
```
> 注 1：`kDsIdRole` 的真实值见 `src/app/panels/DatasetListPanel.cpp`（`Qt::UserRole+? `）。落地时 include 该常量或用其公开定义，勿硬编码 `UserRole+1`——读 DatasetListPanel.hpp/.cpp 取真实 role 常量。
> 注 2：`populateDatasetList` 生成的项默认不可勾选；本栏需勾选渲染，故 setDatasets 后补 `ItemIsUserCheckable` + `Unchecked`（见上）。
> 注 3：分组标题/表单样式照原型；可用 `applyTokenizedStyleSheet` 套深色令牌（搬 `main.cpp:437-457`）。

- [ ] **Step 3: 注册 CMake + 编译**

`src/app/CMakeLists.txt` 加 `panels/columns/Column3DDataset.cpp`。
Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat app"`
Expected: 编译通过。

- [ ] **Step 4: 提交**
```bash
git add src/app/panels/columns/Column3DDataset.hpp src/app/panels/columns/Column3DDataset.cpp src/app/CMakeLists.txt
git commit -m "feat(vtk): 三维数据集栏 widget(4工具条栏位+3D数据集列表,只发信号)"
```

---

## Task 4: 二维数据集栏 widget [UI]

**Files:**
- Create: `src/app/panels/columns/Column2DDataset.hpp/.cpp`
- Modify: `src/app/CMakeLists.txt`

- [ ] **Step 1: 写头文件**

`Column2DDataset.hpp`：
```cpp
#pragma once
#include <QWidget>
#include <QStringList>
#include <vector>
#include "data/repo/RepoTypes.hpp"
class QTreeWidget;
namespace geopro::app {
class Column2DDataset : public QWidget {
    Q_OBJECT
public:
    explicit Column2DDataset(QWidget* parent = nullptr);
    void setDatasets(const std::vector<geopro::data::DsRow>& rows);
signals:
    void basemapChanged(int index);      // 0 天地图 / 1 Google / 2 隐藏
    void view2DModeChanged(int index);   // 0 关闭 /1 Z=0 /2 顶部 /3 底部 /4 自定义
    void customZChanged(double z);        // 世界绝对高程(米),向上为正
    void checkedDatasetsChanged(const QStringList& dsIds);
private:
    QTreeWidget* list_ = nullptr;
};
}
```

- [ ] **Step 2: 写实现**

`Column2DDataset.cpp`：地图 combo（天地图/Google Map/隐藏）→ `basemapChanged`；2D视图 combo（关闭/Z=0/顶部/底部/自定义）→ `view2DModeChanged`，选"自定义"时显一个 `QDoubleSpinBox`（范围 ±1e6，后缀 " m"）→ `customZChanged`；`QTreeWidget` 列表同 Task3（可勾选 + setDatasets 用 populateDatasetList）。骨架同 Column3DDataset 模式（QFormLayout 两组 + 列表），此处不赘述控件 connect（与 Task3 同形）。自定义 Z 输入框默认 `setVisible(false)`，在 `view2DModeChanged` 槽里 `zEdit->setVisible(index==4)`。

- [ ] **Step 3: 注册 CMake + 编译**

`src/app/CMakeLists.txt` 加 `panels/columns/Column2DDataset.cpp`。
Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat app"`
Expected: 编译通过。

- [ ] **Step 4: 提交**
```bash
git add src/app/panels/columns/Column2DDataset.hpp src/app/panels/columns/Column2DDataset.cpp src/app/CMakeLists.txt
git commit -m "feat(vtk): 二维数据集栏 widget(地图/2D视图+自定义Z输入+2D列表)"
```

---

## Task 5: 三维分析栏 widget + 两个右键菜单 [UI]

**Files:**
- Create: `src/app/panels/columns/Column3DAnalysis.hpp/.cpp`
- Modify: `src/app/CMakeLists.txt`

- [ ] **Step 1: 写头文件**

`Column3DAnalysis.hpp`：
```cpp
#pragma once
#include <QWidget>
#include <QStringList>
#include <vector>
#include "data/repo/RepoTypes.hpp"
#include "render/interact/SlicePlaneMath.hpp"   // SliceAxis
class QTreeWidget;
class QTreeWidgetItem;
namespace geopro::app {
// 三维分析栏：对象→三维体模型→切片 树 + 三维体/切片两套右键菜单。
class Column3DAnalysis : public QWidget {
    Q_OBJECT
public:
    explicit Column3DAnalysis(QWidget* parent = nullptr);
    void setDatasets(const std::vector<geopro::data::DsRow>& rows);  // Analysis 维度(三维体/切片)
signals:
    // 三维体右键：切片▸(上下/前后/左右/任意)
    void sliceRequested(geopro::render::interact::SliceAxis axis);
    void colorScaleRequested(const QString& dsId);        // 三维体&切片(本期 stub)
    void visibilityToggled(const QString& dsId);          // 显示/隐藏
    void detailRequested(const QString& dsId, const QString& ddCode, const QString& name);
    // 切片右键(本期 stub,菜单可见但发信号给上层提示"待实现")
    void sliceSaveRequested(const QString& dsId);
    void sliceSaveAsRequested(const QString& dsId);
    void sliceExportRequested(const QString& dsId);
    void sliceDeleteRequested(const QString& dsId);
    void checkedItemsChanged(const QStringList& dsIds);
private:
    void onContextMenu(const QPoint& pos);
    QTreeWidget* tree_ = nullptr;
};
}
```

- [ ] **Step 2: 写实现（树 + 右键分派）**

`Column3DAnalysis.cpp`：`tree_` 设 `setContextMenuPolicy(Qt::CustomContextMenu)`，connect `customContextMenuRequested` → `onContextMenu`。节点类型用 `item->data(0, role)` 区分"三维体" vs "切片"（建树时按 ddCode：`dd_voxel/dd_Structual3D/dd_Property3D/dd_section` 为三维体；`dd_slice` 为切片）。右键分派（核心）：
```cpp
void Column3DAnalysis::onContextMenu(const QPoint& pos) {
    QTreeWidgetItem* it = tree_->itemAt(pos);
    if (!it) return;
    const QString dsId = it->data(0, kDsIdRole).toString();
    const QString ddCode = it->data(0, kDsDdCodeRole).toString();
    const QString name = it->data(0, kDsNameRole).toString();
    const bool isSlice = (ddCode == QStringLiteral("dd_slice"));
    QMenu menu(this);
    if (!isSlice) {
        // 三维体数据集：切片▸(上下/前后/左右/任意) / 色阶 / 显示·隐藏 / 数据详情
        QMenu* sub = menu.addMenu(QStringLiteral("切片"));
        using SA = geopro::render::interact::SliceAxis;
        sub->addAction(QStringLiteral("上下"), this, [this]{ emit sliceRequested(SA::UpDown); });
        sub->addAction(QStringLiteral("前后"), this, [this]{ emit sliceRequested(SA::FrontBack); });
        sub->addAction(QStringLiteral("左右"), this, [this]{ emit sliceRequested(SA::LeftRight); });
        sub->addAction(QStringLiteral("任意"), this, [this]{ emit sliceRequested(SA::Oblique); });
        menu.addAction(QStringLiteral("色阶"), this, [this, dsId]{ emit colorScaleRequested(dsId); });
        menu.addAction(QStringLiteral("显示 / 隐藏"), this, [this, dsId]{ emit visibilityToggled(dsId); });
        menu.addAction(QStringLiteral("数据详情"), this, [this, dsId, ddCode, name]{ emit detailRequested(dsId, ddCode, name); });
    } else {
        // 切片数据集：保存/保存为/导出/删除 — 色阶/显示·隐藏/数据详情
        menu.addAction(QStringLiteral("保存"), this, [this, dsId]{ emit sliceSaveRequested(dsId); });
        menu.addAction(QStringLiteral("保存为"), this, [this, dsId]{ emit sliceSaveAsRequested(dsId); });
        menu.addAction(QStringLiteral("导出"), this, [this, dsId]{ emit sliceExportRequested(dsId); });
        menu.addAction(QStringLiteral("删除"), this, [this, dsId]{ emit sliceDeleteRequested(dsId); });
        menu.addSeparator();
        menu.addAction(QStringLiteral("色阶"), this, [this, dsId]{ emit colorScaleRequested(dsId); });
        menu.addAction(QStringLiteral("显示 / 隐藏"), this, [this, dsId]{ emit visibilityToggled(dsId); });
        menu.addAction(QStringLiteral("数据详情"), this, [this, dsId, ddCode, name]{ emit detailRequested(dsId, ddCode, name); });
    }
    menu.exec(tree_->viewport()->mapToGlobal(pos));
}
```
> `kDsIdRole/kDsDdCodeRole/kDsNameRole`：用 DatasetListPanel 的公开 role 常量（读 DatasetListPanel.hpp）。树构建：用 `populateDatasetList(tree_, analysisRows, false)` 起步（它已按 parentId 建树：切片挂三维体下），再补可勾选标志（同 Task3 注 2）。

- [ ] **Step 3: 注册 CMake + 编译**

`src/app/CMakeLists.txt` 加 `panels/columns/Column3DAnalysis.cpp`。
Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat app"`
Expected: 编译通过。

- [ ] **Step 4: 提交**
```bash
git add src/app/panels/columns/Column3DAnalysis.hpp src/app/panels/columns/Column3DAnalysis.cpp src/app/CMakeLists.txt
git commit -m "feat(vtk): 三维分析栏 widget(对象→三维体→切片树+两套右键菜单)"
```

---

## Task 6: 抽屉容器 ColumnDrawer [UI]

**Files:**
- Create: `src/app/panels/columns/ColumnDrawer.hpp/.cpp`
- Modify: `src/app/CMakeLists.txt`

- [ ] **Step 1: 写头文件**

`ColumnDrawer.hpp`：
```cpp
#pragma once
#include <QWidget>
namespace geopro::app {
class Column3DDataset; class Column2DDataset; class Column3DAnalysis;
// VTK视图左侧内嵌抽屉：三 tab(三维数据集/二维数据集/三维分析) + 折叠开关。
class ColumnDrawer : public QWidget {
    Q_OBJECT
public:
    explicit ColumnDrawer(QWidget* parent = nullptr);
    Column3DDataset* col3D() const { return col3D_; }
    Column2DDataset* col2D() const { return col2D_; }
    Column3DAnalysis* colAnalysis() const { return colAnalysis_; }
public slots:
    void toggleCollapsed();    // 折叠/展开(宽度切换)
private:
    Column3DDataset* col3D_ = nullptr;
    Column2DDataset* col2D_ = nullptr;
    Column3DAnalysis* colAnalysis_ = nullptr;
    QWidget* body_ = nullptr;  // QTabWidget 容器,折叠时隐藏
    bool collapsed_ = false;
};
}
```

- [ ] **Step 2: 写实现**

`QTabWidget` 三页（三维数据集/二维数据集/三维分析）放入 `body_`；旁边一个细长折叠按钮（◀/▶，调 `toggleCollapsed`）。`toggleCollapsed`：`collapsed_ = !collapsed_; body_->setVisible(!collapsed_);` 并切按钮箭头。固定展开宽度约 300（`setFixedWidth` 或 `setMaximumWidth`，折叠时设 0/隐藏 body）。

- [ ] **Step 3: 注册 CMake + 编译**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat app"`
Expected: 编译通过。

- [ ] **Step 4: 提交**
```bash
git add src/app/panels/columns/ColumnDrawer.hpp src/app/panels/columns/ColumnDrawer.cpp src/app/CMakeLists.txt
git commit -m "feat(vtk): ColumnDrawer 抽屉容器(三tab+折叠)"
```

---

## Task 7: main.cpp 装配——删三浮层/切换，挂抽屉，接信号，改名 [UI]

这是核心整合。**一次性**替换，因 axisBar/sliceBar/layerPanel 的 connect 互相牵连，无法逐控件保持编译。改完一次编绿。

**Files:**
- Modify: `src/app/main.cpp`（多处，见下）

- [ ] **Step 1: 删旧 UI 构造**

删除：
- `layerPanel` 块（393-429）、`axisBar` 块（433-516）、`RightTopAnchor`（520）、`sliceBar` 块（525-556）、`BottomLeftAnchor`（556）。
- 分段切换：`buildSegmentedHeader`/`viewHeader`/`act2D`/`act3D`（380-389）改为**简单标题头**（见 Step 3）。
- `showLayerPanel` lambda（804-827）及其所有调用。
- `updateSliceButtons`（559-569）、`addSlice`（572-575）、sliceBar 按钮 connect（576-590）。
- 旧 connect：layer checkboxes（846-851）、axisBar 控件（857-889）、act2D/act3D（832-843）。
- 保留 `interactionMgr` 创建（309-321）、`emptyState`、`sceneCtrl`、`vtkWidget`。

- [ ] **Step 2: 建 ColumnDrawer + 改 centerWidget 布局为 [抽屉 | GL]**

在 `centerWidget` 构造处（374 一带）改为：顶部一个标题头（Step 3），下面一个 `QHBoxLayout` 装 `drawer` + `vtkWidget`：
```cpp
#include "app/panels/columns/ColumnDrawer.hpp"
#include "app/panels/columns/Column3DDataset.hpp"
#include "app/panels/columns/Column2DDataset.hpp"
#include "app/panels/columns/Column3DAnalysis.hpp"
// ...
auto* drawer = new geopro::app::ColumnDrawer(centerWidget);
auto* viewRow = new QHBoxLayout();
viewRow->setContentsMargins(0,0,0,0); viewRow->setSpacing(0);
viewRow->addWidget(drawer);            // 左侧抽屉
viewRow->addWidget(vtkWidget, 1);      // 右侧 GL 画布
// centerLayout: [标题头] + [viewRow]
centerLayout->addWidget(viewHeader);   // Step 3 的新标题头
centerLayout->addLayout(viewRow, 1);
```
> 设计：抽屉是 vtkWidget 的**布局兄弟**（非 GL 子浮层），规避 `main.cpp:397-399` 注释提到的原生 GL 浮层圆角/底色伪影。视觉等同原型（栏在左、画布在右）。

- [ ] **Step 3: 新标题头(含全屏按钮,Task 8 接线)**

替换分段头为 `buildPanelHeader`：
```cpp
auto* viewHeader = geopro::app::buildPanelHeader(
    geopro::app::Glyph::Map, QStringLiteral("VTK视图"),
    {{geopro::app::Glyph::Fullscreen, QStringLiteral("全屏")}});
```
（全屏按钮的 connect 在 Task 8。）

- [ ] **Step 4: 接三维数据集栏信号 → VtkSceneController**
```cpp
auto* c3 = drawer->col3D();
QObject::connect(c3, &geopro::app::Column3DDataset::axesModeChanged, sceneCtrl, &VtkSceneController::setAxesMode);
QObject::connect(c3, &geopro::app::Column3DDataset::axesUnitChanged, sceneCtrl, &VtkSceneController::setAxesUnit);
QObject::connect(c3, &geopro::app::Column3DDataset::verticalExaggerationChanged, sceneCtrl, &VtkSceneController::setVerticalExaggeration);
QObject::connect(c3, &geopro::app::Column3DDataset::viewRequested, sceneCtrl, &VtkSceneController::applyView);
QObject::connect(c3, &geopro::app::Column3DDataset::zoomInRequested, sceneCtrl, &VtkSceneController::zoomIn);
QObject::connect(c3, &geopro::app::Column3DDataset::zoomOutRequested, sceneCtrl, &VtkSceneController::zoomOut);
QObject::connect(c3, &geopro::app::Column3DDataset::fitRequested, sceneCtrl, &VtkSceneController::fit);
// O点位置/字体本期 stub：connect 到一个提示(可空 lambda)。
```
> 类型匹配：`Column3DDataset` 的枚举即 `geopro::controller::AxesMode/AxesUnit/ViewDir`（同 I3dSceneView.hpp），与 `setAxesMode/setAxesUnit/applyView` 形参一致，可直接连。

- [ ] **Step 5: 接三维分析栏「切片」→ InteractionManager**
```cpp
auto* ca = drawer->colAnalysis();
QObject::connect(ca, &geopro::app::Column3DAnalysis::sliceRequested, vtkWidget,
                 [interactionMgr](geopro::render::interact::SliceAxis axis){
                     interactionMgr->addSlice(axis);
                 });
QObject::connect(ca, &geopro::app::Column3DAnalysis::detailRequested, &detailCtrl,
                 [&detailCtrl](const QString& dsId, const QString& ddCode, const QString& name){
                     detailCtrl.openDataset(dsId, ddCode, name);
                 });
// colorScale/visibility/slice CRUD 本期 stub：connect 到提示 lambda（如 statusBar 显"待实现"）。
```

- [ ] **Step 6: 编译（维度过滤接线在 Task 9，此处先空列表）**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat rebuild"`
Expected: 全量编译通过，exe 刷新。

- [ ] **Step 7: 用户实测清单**（用户在其终端跑）
  - [ ] app 启动，中央改名「VTK视图」，左侧出现三 tab 抽屉。
  - [ ] 旧「二维地图/三维视图」分段按钮已消失；左上/右上/左下三浮层消失。
  - [ ] 抽屉折叠开关：点 ◀ 收起、画布变宽；点 ▶ 展开。
  - [ ] 三维数据集栏工具条：坐标轴下拉/比例滑块/快捷视图 6 钮/缩放 3 钮可点（功能接通后续 Task 9 验，但点击不崩）。
  - [ ] 三维分析栏右键三维体 → 出「切片▸(上下/前后/左右/任意)/色阶/显隐/详情」；右键切片 → 出「保存/保存为/导出/删除/色阶/显隐/详情」。

- [ ] **Step 8: 提交**
```bash
git add src/app/main.cpp
git commit -m "refactor(vtk): 删三浮层+分段切换,改挂三栏抽屉,接信号,中央改名VTK视图"
```

---

## Task 8: dockState 版本 bump + 全屏按钮 [UI]

**Files:**
- Modify: `src/app/main.cpp`（dockState 键 1428-1442；全屏 connect）

- [ ] **Step 1: bump dock 布局版本**

`main.cpp:1430` 与 1440：把 `ui/dockState_v2` 两处改为 `ui/dockState_v3`（dock 名/结构已变，旧布局须丢弃回落默认排布；遵循 1428-1430 注释）。

- [ ] **Step 2: 全屏切换实现**

全屏 = 隐藏其余 dock，仅留目标 dock 充满 dock 区；再点还原。用 ADS `CDockWidget::toggleView(bool)`。加一个 lambda + 状态：
```cpp
// 全屏：隐藏其余 dock,仅留 target;再点还原。docks 列表见 hideDockTitleBars(733-740)。
bool* vtkFs = new bool(false);  // 或用 QObject property,避免裸 new:可挂到 window
auto makeFullscreen = [dockManager](ads::CDockWidget* target, const QList<ads::CDockWidget*>& others, bool on){
    for (ads::CDockWidget* d : others) d->toggleView(!on);  // on→隐藏其余
    Q_UNUSED(target);
};
```
> 落地建议：用 `QToolButton::setCheckable(true)` 的全屏按钮 + `toggled(bool)` 切换；状态存按钮 checked，免裸指针。`others` = 除目标外的全部 dock（vtkDock 全屏时 others={leftDock,datasetDock,detailDock,rightDock,propDock}；detailDock 全屏时 others={其余}）。

- [ ] **Step 3: 接全屏按钮**

用 `findHeaderAction(box, Glyph::Fullscreen)`（main.cpp:1016-1020 的 helper）取到 VTK视图标题头与 数据详情头里的全屏按钮，connect 到 `makeFullscreen`。VTK视图头是 Step3(Task7) 的 `viewHeader`；数据详情头是 `detailDock` 的 `wrapWithHeader`（654-663）——给它加 `{{Glyph::Fullscreen,"全屏"}}` action。
```cpp
// 数据详情头加全屏 action（修改 654-663 的 wrapWithHeader 调用，加 actions 参数）。
// 然后:
auto* vtkFsBtn = findHeaderAction(viewHeader, geopro::app::Glyph::Fullscreen);
auto* detFsBtn = findHeaderAction(detailHeaderBox, geopro::app::Glyph::Fullscreen);
// 各自 setCheckable(true) + connect(&QToolButton::toggled, ... makeFullscreen ...)
```

- [ ] **Step 4: 编译**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat rebuild"`
Expected: 编译通过。

- [ ] **Step 5: 用户实测清单**
  - [ ] 点 VTK视图标题栏右侧全屏按钮 → VTK视图充满工作区（其余 dock 隐藏）；再点 → 还原。
  - [ ] 点 数据详情标题栏全屏按钮 → 同理。
  - [ ] 首次启动（旧布局丢弃）dock 排布为默认，无错位。

- [ ] **Step 6: 提交**
```bash
git add src/app/main.cpp
git commit -m "feat(vtk): dockState bump v3 + VTK视图/数据详情 全屏按钮(隐藏其余dock)"
```

---

## Task 9: 维度过滤接线——三栏数据集列表数据驱动 [UI+逻辑]

把"勾选对象 → 取 ds → 按维度分三栏"接通，替换 `main.cpp:891-899` 的 "grid1" 假实现。

**Files:**
- Modify: `src/app/main.cpp`

- [ ] **Step 1: 取勾选对象的 ds 行**

现状：`checkedTmsChanged(QStringList tmIds)` → 假 "grid1"。改为：用 `WorkbenchNavController`/`repo_.loadRowsAsync` 对每个勾选 TM 取 `DsRow`，汇总。`nav` 已有 `datasetsLoaded(tmObjectId, rows, total, append)` 信号（WorkbenchNavController.hpp:52）。**最简路径**：复用 nav 的取数，但 nav 现按"单击对象"取数（selectObject），勾选多 TM 需逐个取并合并。

实现：在 `checkedTmsChanged` 槽里，对每个 tmId 调 `nav.selectObject(tmId, 2)` 不合适（会刷左下列表）。改为直接调 repo：
```cpp
// 汇总所有勾选 TM 的 ds，按维度分三栏。projectRepo 是 IAsyncProjectRepository。
QObject::connect(objectTree, &geopro::app::ObjectTreePanel::checkedTmsChanged, &window,
    [&projectRepo, drawer, sceneCtrl, emptyState, &window](const QStringList& tmIds){
        emptyState->setVisible(tmIds.isEmpty());
        auto acc = std::make_shared<std::vector<geopro::data::DsRow>>();
        auto remaining = std::make_shared<int>(tmIds.size());
        if (tmIds.isEmpty()) {
            drawer->col3D()->setDatasets({});
            drawer->col2D()->setDatasets({});
            drawer->colAnalysis()->setDatasets({});
            sceneCtrl->setCheckedDatasets({});
            return;
        }
        for (const QString& tm : tmIds) {
            // classifyType=3, pageNo=1, 大 pageSize 取整树(同 WorkbenchNavController kFetchAllPageSize)
            geopro::data::NavRequest* req = projectRepo.loadRowsAsync(
                currentProjectIdStdString, tm.toStdString(), /*parentConfType*/2, /*classifyType*/3, 1, 100000);
            req->onDone = [acc, remaining, drawer](const geopro::data::DsPage& page){
                acc->insert(acc->end(), page.rows.begin(), page.rows.end());
                if (--(*remaining) == 0) {
                    geopro::app::DimBuckets b = geopro::app::splitByDimension(*acc);
                    drawer->col3D()->setDatasets(b.dim3D);
                    drawer->col2D()->setDatasets(b.dim2D);
                    drawer->colAnalysis()->setDatasets(b.analysis);
                }
            };
            // req->onFail 同样 --remaining 并在归零时刷新(避免一个失败卡死)。
        }
    });
#include "app/DatasetDimension.hpp"
```
> 注：`NavRequest` 的回调字段真名见 `src/data/repo/IAsyncProjectRepository.hpp` / NavRequest 定义（onDone/onFail 或 done/failed）——落地按真实字段。`currentProjectIdStdString` 取当前项目 id（main.cpp 里已有项目 id 来源，搜 `currentProjectId`/`projectId`）。

- [ ] **Step 2: 勾选数据集 → 渲染**

三栏列表勾选 → `setCheckedDatasets`。汇总三栏勾选的 dsId：
```cpp
auto pushChecked = [drawer, sceneCtrl]{
    QStringList ids;
    // 收集三栏当前勾选(各栏暴露 checkedDatasetsChanged;此处也可各自直接连)
    // 简化:各栏 checkedDatasetsChanged 直接 setCheckedDatasets(合并)。
};
QObject::connect(drawer->col3D(), &geopro::app::Column3DDataset::checkedDatasetsChanged,
                 sceneCtrl, &VtkSceneController::setCheckedDatasets);
// 若需三栏合并,改为聚合后再 setCheckedDatasets;本期可先只接 col3D(3D 渲染主路径)。
```
> 本期渲染主路径是 3D 数据集（帘面/体素/地形），故先接 `col3D` 的勾选 → `setCheckedDatasets`。2D/分析渲染随各自维度后续完善。

- [ ] **Step 3: 编译**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat rebuild"`
Expected: 编译通过。

- [ ] **Step 4: 用户实测清单**
  - [ ] 勾选含 ds 的对象 → 三维数据集栏列表出现 3D 维度 ds（样本 "剖面网格数据1" dd_section）。
  - [ ] 勾选三维数据集栏里的 ds → 中央渲染帘面（原 grid1 路径效果）。
  - [ ] 取消全部勾选 → 三栏列表清空、中央清场、引导层 emptyState 显示。
  - [ ] （样本数据若无 2D/切片 ds，2D/分析栏为空属正常；可后续在 LocalSample 加样本演示。）

- [ ] **Step 5: 提交**
```bash
git add src/app/main.cpp
git commit -m "feat(vtk): 三栏数据集列表按维度过滤数据驱动(替换grid1假实现)"
```

---

## Task 10: 全量回归 + 收尾 [逻辑]

- [ ] **Step 1: 全量 build + ctest**

Run: `cmd.exe /c "chcp 65001 >nul && cd /d D:\Git\lanbingtech\geopro && .\build.bat rebuild && .\build.bat test"`
Expected: 编译通过；ctest 全绿（≥ 223/223，含新 DatasetDimension.* 2 项）。

- [ ] **Step 2: 派 cpp-reviewer 审查本分支改动**

对 `src/app/panels/columns/*`、`DatasetDimension.*`、`main.cpp` diff 跑 cpp-reviewer，修 CRITICAL/HIGH（重点：裸 new/生命周期、信号槽断连、ADS toggleView 还原正确性、role 常量硬编码）。

- [ ] **Step 3: 对照 spec 验收**

逐条核对 `2026-06-16-vtk-3d-three-column-refactor-design.md` §0 IN 项全部落地、OUT 项为 stub/禁用。

- [ ] **Step 4: 用户最终实测**（完整走查实测清单 Task7/8/9）

- [ ] **Step 5: 提交收尾（如有修改）**
```bash
git add -A && git commit -m "chore(vtk): 三栏重构 review 修复 + 回归"
```

---

## Self-Review（写计划后自查）

**Spec 覆盖：**
- A1 三栏 → Task 3-7 ✅；单一 VTK视图/删切换/改名 → Task 7 ✅；三浮层收编 → Task 7 ✅；维度过滤列表 → Task 2+9 ✅；三维数据集 4 栏位 → Task 3 ✅；二维 地图/2D视图/自定义Z → Task 4 ✅；三维分析树+两右键菜单+切片接 SliceTool → Task 5+7 ✅；全屏 → Task 1+8 ✅；自定义Z绝对高程 → Task 4(spec 已记) ✅；dock 版本 bump → Task 8 ✅。
- OUT 项（CRUD/色阶/底图/异常体/详情/任务）→ stub 信号(Task 5)，不实现 ✅。

**占位符扫描：** 已用真实 API/行号；少数"读真实 role 常量/NavRequest 字段名"是**有意指向源文件**（避免硬编码错值），非 TODO。

**类型一致性：** `AxesMode/AxesUnit/ViewDir`(I3dSceneView.hpp) 跨 Task3/7 一致；`SliceAxis`(SlicePlaneMath.hpp) 跨 Task5/7 一致；`DsRow/DsPage/DimBuckets` 跨 Task2/3/9 一致；`splitByDimension` 签名 Task2 定义、Task9 使用一致。

**风险：** Task 9 的多 TM 异步汇总 + NavRequest 回调字段名是最大不确定点（落地前先读 IAsyncProjectRepository.hpp 确认）；全屏 toggleView 还原需保证 dock 顺序/可见性正确（Task8 用户实测把关）。