docs(vtk): 交接文档全量刷新-#1~#4全完成,§3当前状态+下一步候选表,供换会话无缝接手
This commit is contained in:
gaozheng
parent
9d8f36ff90
commit
c27bb6ab8f
|
|
@ -1,6 +1,8 @@
|
|||
# 交接：VTK 三维视图（feat/vtk-3d-view）
|
||||
|
||||
> 给下一个会话无缝接手用。更新日期 2026-06-17。分支 `feat/vtk-3d-view`，工作树：仅根目录 `grid-list-original.png`/`grid-list-small.png`/`grid-snap.yml`/`orig-dataview.png` 及 `docs/superpowers/specs/2026-06-17-web-embed-subpage-mount-design.md` 是**既有未跟踪文件，非本任务产物，勿动/勿提交**（曾被 `git add -A` 误纳、已撤回）。
|
||||
> 给下一个会话无缝接手用。更新日期 2026-06-18（#4 异常功能全部收口后）。分支 `feat/vtk-3d-view`，工作树：仅根目录 `grid-list-original.png`/`grid-list-small.png`/`grid-snap.yml`/`orig-dataview.png` 及 `docs/superpowers/specs/2026-06-17-web-embed-subpage-mount-design.md` 是**既有未跟踪文件，非本任务产物，勿动/勿提交**（曾被 `git add -A` 误纳、已撤回）。
|
||||
>
|
||||
> **进度速览（2026-06-18）**：补充需求 #1 生成三维体 ✅、#2 切片交互 ✅、#3 切片生命周期 ✅、#4 异常（圈定/保存/列表/异常体/过滤/显隐/删除/选中高亮/属性对话框）✅ 全部完成、编译绿、用户实测通过。最新提交 `c83f63a`（4c-3 属性对话框）。**剩下全是收尾/打磨项**（见 §4 末「下一步候选」），无进行中的半成品。下一会话应先问用户选哪个方向，或直接接其指定项。
|
||||
|
||||
## 1. 背景
|
||||
- 项目：geopro 桌面客户端（Qt6 + VTK9 + Qt-ADS dock），Windows/MSVC+Ninja，`build.bat`。
|
||||
|
|
@ -33,12 +35,13 @@
|
|||
- 默认底图=天地图；首个剖面重锚 frame 后经 `onFrameReanchored` 在数据位置加载底图。
|
||||
- VTK 全屏含左侧三栏（drawer 在 vtkDock 内 + 进入全屏展开）。
|
||||
|
||||
## 3. 当前状态
|
||||
## 3. 当前状态（2026-06-18 更新）
|
||||
- 底图/地形/剖面配准/增量渲染：**完成且可用**。编译绿。所有改动已提交到 `feat/vtk-3d-view`。
|
||||
- **#1 客户端「生成三维体」流程：已实现，编译链接绿（exit 0），未提交、未 GUI 实测**（Claude 无法验 VTK 渲染，待用户启动 app 实测）。详见计划 `docs/superpowers/plans/2026-06-17-vtk-3d-volume-create-flow.md`。
|
||||
- 已落地：`data::VolumeBuildParams`（不冻结 gridSpec，源 ds 锁定不变式）；`core::buildVolume` 共享管线（LocalSample/Api 同源，消 TODO 漂移）；`Api3dRepository` 内存体存储 + `createVolume/volumeRows/isVolumeDataset` + 多源 `loadVolume`（复用 `loadSection`，竖向=g.y 高程，与帘面构造性对齐）；`loadVolume` 回调改交付 `(VolumeGrid, ColorScale)`（体色阶=源剖面色阶）；`Column3DDataset`(源数据栏) 多选+右键「生成三维体」+ `VolumeParamsDialog`；**生成的体归三维分析栏**(`Column3DAnalysis`，设计 §2.1，非数据集栏)，main.cpp `lastAnalysisRows`+`refreshAnalysis` 合并注入（体行不被后端刷新冲掉）+ **两栏勾选聚合** `pushChecked`(剖面+体/切片并集下发，避免互相清除)；`VtkSceneController` 按 `isVolumeDataset` 分流体素/帘面（取代全局 showVoxel/showCurtain）。
|
||||
- **待实测**：在**三维数据集栏**多选反演剖面→右键「生成三维体」→参数→新体行出现在**三维分析栏**→在三维分析栏勾选→渲染体；体是否与帘面对齐；色阶是否正确；剖面与体可同时勾选共存。
|
||||
- 下一阶段（切片/异常 #2–#6）：**仅完成设计定稿**，未开始编码。
|
||||
- **#1 客户端「生成三维体」流程：已实现并经本会话大量使用验证**（切片/异常都在生成的体上操作过，间接验收）。详见计划 `docs/superpowers/plans/2026-06-17-vtk-3d-volume-create-flow.md`。
|
||||
- 已落地：`data::VolumeBuildParams`（不冻结 gridSpec，源 ds 锁定不变式）；`core::buildVolume` 共享管线（LocalSample/Api 同源）；`Api3dRepository` 内存体存储 + `createVolume/volumeRows/isVolumeDataset` + 多源 `loadVolume`（复用 `loadSection`，竖向=g.y 高程，与帘面对齐；`fitAxis` 按 extent 增大 cell 以覆盖跨 TM 全范围）；`loadVolume` 回调交付 `(VolumeGrid, ColorScale)`；`Column3DDataset` 多选+右键「生成三维体」(按**勾选框**选中集，非行选)+ `VolumeParamsDialog`；**生成的体归三维分析栏**(`Column3DAnalysis`)，main.cpp `refreshAnalysis` 合并注入 + `pushChecked` 两栏勾选聚合；`VtkSceneController` 按 `isVolumeDataset` 分流体素/帘面。
|
||||
- **#2/#3 切片：完成且用户实测通过**（提交 afdd98f+d56e35f）。四向创建/滚轮推进/双击正视/翻转/关闭/选中高亮；VTK 右键菜单(创建异常/保存/导出▸图片·dat/正视/翻转/关闭)；未保存↔已保存统一状态模型(保存按状态分派、无重复切片)；精确三点几何持久化；场景↔列表勾选双向同步。导出 `SliceExport`。切片持久化=`Api3dRepository` 内存 mock。
|
||||
- **#4 异常：完成且用户实测通过**（见 §4 第 4 项，4a→4c-3，最新 c83f63a）。圈定→保存→渲染→列表→异常体分组→过滤→显隐→删除→选中高亮→双击属性，全链 mock。
|
||||
- **剩余 = 收尾/打磨项**（§4 末「下一步候选」表）：体/切片详情面板、真实色阶编辑、三级树根层、坐标轴弹框、真实后端对接(阻塞)、收口 PR。**无进行中的半成品**。
|
||||
|
||||
## 4. 下一步计划（三维体 / 切片 / 异常）
|
||||
**权威设计文档**：`docs/superpowers/specs/2026-06-17-vtk-3d-volume-slice-anomaly-design.md`（数据模型 + 交互流 + 后端vs mock + 代码现状 + 实现拆解 + 持久化策略）。已与用户拍板的关键决策：
|
||||
|
|
@ -71,6 +74,16 @@
|
|||
|
||||
**其它小项**：坐标轴「O点位置」「字体」弹框仍是 stub（main.cpp:382 TODO P4）。
|
||||
|
||||
### 下一步候选（2026-06-18，主体功能已完结，以下均为收尾/打磨；下一会话先与用户确认方向）
|
||||
| 候选 | 性质 | 阻塞 | 要点 |
|
||||
|---|---|---|---|
|
||||
| **#6 三维体/切片 数据详情面板** | 功能补全 | 否 | 数据详情栏(右侧)补 体/切片 详情(源数据/插值参数/色阶/测点数/体积)。异常详情已用对话框做掉，体/切片仍缺。可参考既有 `panels/DatasetDetailPage`/`DatasetDetailPanel` 模式 + `detailRequested(dsId,ddCode,name)` 信号(Column3DAnalysis 已发，体走 ddCode 空、切片 dd_slice)。 |
|
||||
| **真实色阶编辑** | 功能 | 否 | `colorScaleRequested` 现占位("色阶开发中")。做成色阶编辑器，影响 体/切片/帘面 渲染观感。 |
|
||||
| **收口提 PR 合 main** | 流程 | 否 | 分支已积大量提交。`git diff main...HEAD` 起草摘要+测试计划，`-u` 推送。注意勿纳未跟踪文件。 |
|
||||
| **三级树 对象→三维体→切片** | 结构打磨 | 否 | `Column3DAnalysis` 体目前是顶层，缺"对象"根层(R 结构)。 |
|
||||
| **坐标轴 O点/字体弹框** | 打磨 | 否 | main.cpp 内 stub(TODO P4)落实。 |
|
||||
| **真实后端对接** | 切真实 | **是** | 三维体/切片端点未就绪，现全 mock(`Api3dRepository` 内存)。端点就绪后只换 `I3dSceneRepository` 实现，接口不动。异常端点已挖到(§4 头)，但其挂载目标(三维体)仍 mock，故异常也整链 mock。 |
|
||||
|
||||
## 5. 相关文档
|
||||
- **`docs/superpowers/specs/2026-06-17-vtk-3d-volume-slice-anomaly-design.md`** ← 下一阶段主依据。
|
||||
- `docs/questions/2026-06-16-反演剖面竖向字段(y-z-elevation)语义待确认.md` ← 已解：y=高程，z=+y 与原版一致；跨数据集 y 不一致是数据层问题（原版同样存在），非客户端 bug。
|
||||
|
|
|
|||
Loading…
Reference in New Issue