From 63fe99dba5a9c7b08398061e44212ba423737ddc Mon Sep 17 00:00:00 2001
From: gaozheng <gaozheng.cn@gmail.com>
Date: Thu, 25 Jun 2026 18:15:41 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E5=85=A8=E5=B1=80?=
 =?UTF-8?q?=E5=BE=85=E4=BC=98=E5=8C=96=E6=B8=85=E5=8D=95=20OPTIMIZATION-BA?=
 =?UTF-8?q?CKLOG.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

后续所有「能用但不够理想、需更大改造」的优化点登记于此并随进展更新状态(区别于当场修的bug)。
首条 OPT-001=放大系数(VE)完全无重绘的即时缩放(当前保留相机重建仍有一次重绘,纯actor缩放待办)。
---
 docs/OPTIMIZATION-BACKLOG.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 docs/OPTIMIZATION-BACKLOG.md

diff --git a/docs/OPTIMIZATION-BACKLOG.md b/docs/OPTIMIZATION-BACKLOG.md
new file mode 100644
index 0000000..5b7a618
--- /dev/null
+++ b/docs/OPTIMIZATION-BACKLOG.md
@@ -0,0 +1,34 @@
+# 待优化清单（Optimization Backlog）
+
+> 全局「待优化 / 技术债 / 性能与体验改进」登记簿。**所有**后续发现但当下不做（或暂以折中实现）的优化点
+> 都登记到此，并随进展更新状态。区别于 bug（bug 当场修，见 CLAUDE.md 技术债规则）——这里收录的是
+> 「能用但不够理想、需要更大改造才能做到位」的优化项。
+
+## 状态图例
+- 🔴 Open — 待优化，尚未动工
+- 🟡 In Progress — 正在做
+- 🟢 Done — 已完成（保留记录，标注完成 commit/日期）
+- ⚪ Won't Do — 评估后决定不做（标注原因）
+
+## 维护约定
+- 新增项用递增 ID（OPT-NNN），不复用已删 ID。
+- 每项含：背景/现状、期望、难点、状态、记录日期、关联 commit。
+- 状态变更时更新「状态」行与「更新」行，不删历史。
+
+---
+
+## OPT-001 · 放大系数(VE) 完全无重绘的即时缩放
+- **状态**：🔴 Open
+- **记录日期**：2026-06-25
+- **背景/现状**：`VtkSceneController::setVerticalExaggeration` 当前走「保留相机重建」（commit `7ff6f18`）——
+  改 VE 时相机不再跳远视角、原地按新夸张重绘，但**数据/底图仍会重建并重绘一次**（有一次闪烁）。
+  根因：VE 被烤进几何——帘面用 `actor->SetScale(1,1,VE)`、体素把 VE 烤进 image 的 z origin/spacing、
+  地形烤进 `buildTerrain`；且切片附着依赖**含 VE 的 currentVolumeImage_**。
+- **期望**：拖动放大系数时纯 actor 层 Z 缩放，**零重载零重绘**、即时跟手（理想可恢复拖动实时预览）。
+- **难点**：
+  - 体素须改为「image 建在 VE=1、vtkVolume prop 用 `SetScale(1,1,VE)`」，但切片重采样依赖含 VE 的 image
+    几何，需同步改造切片附着/重采样链（InteractionManager）。
+  - 地形/帘面/体素三类 actor 的 VE 应统一走 actor 变换，避免混用（部分烤几何、部分 actor 缩放）。
+  - 底图(TileBasemap) VE 同步是否也能免重载需评估。
+- **关联**：`7ff6f18`（当前保留相机的折中实现）。
+- **更新**：—