# 3D 智能建模编辑器（实验）
> 实验性的 3D 房间智能建模编辑器，可用 AI 识别或示例数据生成房间模型。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor/ModelingTest
- 所属模块：全景编辑器
- 页面用途：面向 3D 房间建模的实验性工具页。输入场景标识后可提交 AI 智能识别，也可加载示例数据（Mock）在右侧 3D 画布中生成房间模型。支持第一人称与上帝视角切换、线框与纹理显示开关，并在地平线倾斜时提供调平提示。该页处于实验/内测阶段，功能与表现可能随版本调整。
- 适用用户：参与 3D 智能建模能力尝鲜的体验用户
- 访问条件：公开访问

## 2. 功能说明

- 输入场景标识提交 AI 智能识别房间布局
- 加载示例数据（Mock）快速体验建模效果
- 右侧 3D 画布实时展示生成的房间模型
- 第一人称 / 上帝视角切换
- 显示线框、显示纹理开关
- 地平线倾斜检测与一键调平提示
- 置信度指示器，显示识别结果的可信程度
- 内置运行日志，反馈每个步骤的结果

## 3. 业务说明

### 能力说明

- AI 识别：提交场景标识后由后台处理，完成后通过实时通道回传结果并自动生成模型
- 示例数据：无需等待识别，直接使用内置示例数据生成房间，用于快速体验与验证
- 视角：第一人称贴近在地面观察，上帝视角从上方俯瞰整体布局
- 调平：识别结果包含倾斜预测，角度超出阈值时提示并支持一键调平

### 阶段说明

本页为实验性功能，部分能力仍在打磨中，实际可用范围与稳定性可能随版本变化。

## 4. 使用说明

1. 填写场景标识（可选填写全景图地址）
2. 点击「AI 智能识别」提交识别，或点击「加载 Mock」使用示例数据
3. 等待识别结果返回后，在右侧 3D 画布查看房间模型
4. 按需切换视角、开关线框与纹理，查看置信度与调平提示

## 5. 规则与限制

- 提交 AI 识别必须先填写场景标识，否则无法提交
- 识别结果为异步返回，需要等待处理完成
- 本页为实验功能，不代表正式发布能力

## 6. 状态与异常

- 等待识别：画布显示「等待加载 3D 模型」
- 识别中：按钮进入加载态，日志提示任务已投递
- 识别完成：日志提示完成并在画布生成模型
- 调平提示：倾斜超出阈值时显示调平工具
- 未填场景标识：提示请输入场景标识
- 识别失败：日志提示识别失败及原因
- 网络异常：日志提示网络异常

## 7. 相关文档

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

## 8. 文档信息

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