# DW05：选择、变换、模式和交互工具

- stage: `scene-workflow`
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
- 完整交付依赖：DW03, DW04
- 工作量级：L；不表示日期承诺
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`

## 优先复用的十多天成果

已有视口导航、变换、NDOF、native input 与 operator bridge。

既有任务：`NATIVE-OPERATOR-BRIDGE`（记录为 implemented）、`OPERATOR-MACRO-COMPOSER`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。

先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。

## 操作者工作流与交付

选择对象/元素 → 切换编辑模式 → 工具操作/数值输入 → 确认或取消 → 连贯重绘

操作方式连续一致的主视口工具系统；原生 modal 上下文和回滚正确接线。

## 最小生产入口

- `web/app/src/app/App.tsx`
- `web/app/src/app/WasmViewportBinding.tsx`
- `web/protocol/viewport-camera.ts`
- `web/protocol/mesh-authoring-commands.ts`
- `blender-5.2.0/source/blender/web_engine/web_engine_viewport.cpp`
- `blender-5.2.0/source/blender/windowmanager/intern/wm_event_system.cc`
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`

以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。

## 只补未完成部分

1. 补齐 click/box/circle/lasso 与点/边/面选择，选择结果由真实 native picking/context 产生。
2. 补齐平移/旋转/缩放、轴锁定、局部/全局坐标、pivot、snap、proportional editing 与数值输入。
3. 统一 gizmo、工具栏、快捷键和 modal 生命周期；预览、确认、取消不产生多余 history。
4. 落实 object/edit/sculpt/paint/pose 等模式的上下文切换与可用性；具体工具由后续对应包补齐。
5. 导航、相机视图、local/quad/locked view、overlay 和 selection feedback 同步到原生 RegionView3D。
6. 几何/拓扑修改接现有 OCCT 出口，Web/Three 层仅转发输入和显示结果。

## 失败边界

不能只更新 gizmo 或前端模型。取消必须恢复本轮操作前的数据和工具状态。

## 实现交接与后续使用

交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。

用户使用阶段的场景（现在不执行）：进入编辑模式选面挤出前先调整坐标轴与吸附，数值移动后取消，再进行一次可撤销操作。

每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。