# 3D 沙盘编辑器
> 在 3D 画布中搭建多房间沙盘，支持 AI 识别房间、漫游预览与保存布局。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor/SandboxEditor
- 所属模块：全景编辑器
- 页面用途：用于把多个房间组织成一个可漫游的 3D 沙盘。左侧为房间列表，中间为可拖拽旋转的 3D 画布。可添加房间（AI 识别或使用示例数据）、调整房间形状、在漫游预览中沿房间穿行，并将布局保存到对应作品。该页处于实验/内测阶段。
- 适用用户：制作多房间 3D 漫游沙盘的用户
- 访问条件：公开访问

## 2. 功能说明

- 房间列表：查看已添加房间数量，选中或删除房间
- 添加房间：输入场景标识后可用 AI 识别或使用示例数据生成房间
- 移动 / 旋转工具：在画布中调整选中房间的位置与朝向
- 调整形状：进入编辑模式后拖拽节点微调房间轮廓
- 漫游预览：以人眼高度在房间之间穿行，进入新房间时提示
- 保存布局 / 加载布局：按作品维度保存并恢复沙盘布局
- 实时提示：低置信度时建议手动微调墙角位置

## 3. 业务说明

### 典型流程

- 添加房间：可先用示例数据快速搭建，再用 AI 识别生成真实房间
- 排布房间：用移动/旋转工具把房间放到合适位置
- 微调形状：对识别不够准确的房间进入调整形状，拖拽节点修正
- 漫游检查：进入漫游预览沿走道检查连通与朝向
- 保存：把整份布局保存后即为该作品的 3D 沙盘

### 阶段说明

本页为实验性功能，房间删除等部分能力仍标注为待开发，实际表现可能随版本调整。

## 4. 使用说明

1. 进入页面后自动尝试加载该作品已有沙盘布局
2. 点击「添加」新增房间，选择示例数据或 AI 识别
3. 用移动/旋转工具摆好房间位置，必要时进入调整形状微调
4. 切换到漫游预览检查穿行效果
5. 点击「保存布局」保存整份沙盘

## 5. 规则与限制

- 保存布局需要带作品标识，缺少时无法保存
- AI 识别为异步返回，需等待处理完成
- 房间删除能力当前待开发，点击会提示暂未实现

## 6. 状态与异常

- 加载中：进入时尝试加载已有布局
- 有布局：房间列表与画布展示已保存的沙盘
- 无布局：room 列表为空，可从添加房间开始
- 漫游中：相机降到人眼高度，穿越门洞时提示进入的房间
- 缺少作品标识：保存时提示缺少作品标识
- AI 识别失败：提示识别失败及原因
- 保存失败：提示保存失败

## 7. 相关文档

- [芊云编辑器（作品编辑主界面）](https://9kvr.cn/site/tour/editor.md)
- [3D 智能建模编辑器（实验）](https://9kvr.cn/site/tour/editor/ModelingTest.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面与公开产品配置
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验