# 用 AI 分析空间

让 AI 根据你的问题分析 VR 中的物体、尺寸或房间关系，并把结果放到当前应用中查看。本指南适用于 CLI 0.4 系列的项目内分析。

## 1. 开始分析 {#start}

### 已有互动应用

在能读取工程、运行命令的 AI 助手中打开当前项目，发送以下指令，并把示例问题换成你的目标：

```text
请读取当前工程的空间理解 Skill，分析当前已连接的 VR。我想找到沙发，并了解它所在的房间。先检查已有资料，说明能完成的分析；缺数据时让我选择精简分析、补充资料或暂缓。完成后给出报告和结果预览的打开方式，并把分析结果接入当前应用。
```

需要分析其他空间时，补充你有权访问的 VR ID。AI 会检查工程内的 Skill、连接配置和运行状态，复用已有素材与有效配置；缺少 Skill 或需要更新时，按[旧工程升级指引](https://open.realsee.cn/docs/get-started/terminal#upgrade)处理。

### 首次使用

按[入门指南的分析指令](https://open.realsee.cn/docs/get-started#spatial-analysis)发起任务。AI 会先准备工程，通过如视网页完成必要的账号与空间接入，再继续分析。已有工程但尚未连接空间时，按[配置与启动](https://open.realsee.cn/docs/get-started/configure)完成接入。

## 2. 根据资料选择分析方式 {#analysis-options}

AI 会先检查空间数据、可用素材和运行环境，再说明本次能够完成的分析。你可以用下表理解预检结果，无需自行判断文件格式或选择命令参数。

分析分为完整与精简两档；精简档的结果取决于是否有可用平面图。**下表列出各类输入支持的分析范围，实际结果取决于素材匹配、质量检查及本次执行情况。**

| 分析方式 | 需要的空间资料 | 可以得到的结果 | 主要限制 |
| --- | --- | --- | --- |
| 完整分析 | 空间基础数据（Work）、匹配的全景与扫描位姿、可解析的三角网格模型 | 物体识别、房间信息、尺寸测量与空间连通性分析 | 点云可作补充，不能代替网格；识别和测量结果需结合原始空间复核 |
| 精简分析：有平面图 | Work 中的可用点位及同一空间、核对通过的平面图 | 图纸房间、面积、门的位置、点位归属与间距 | 不提供物体识别、家具尺寸或层高；图纸结果不等同于几何实测 |
| 精简分析：只有点位 | Work 中可用的点位位置 | 点位清单、间距、最近邻和点位分布范围；有朝向数据时提供相对朝向 | 无法据此得到房间边界、墙距、门宽或家具尺寸 |

有可用平面图时，两档分析都优先采用图纸中的房间、墙、门窗和面积；完整分析在没有平面图时才从网格推算房间。报告会注明依据。

完整分析还需要相应分析依赖与检测权重，AI 会按所选方式检查环境。缺少运行依赖与缺少空间资料会分别说明。若点位等基础输入也不可用，先按预检提示补齐资料。

例如，只有点位数据时，可以先了解点位间距，但无法完成“找到沙发”的目标。需要房间方位时，AI 可能询问一个现实朝向参考；不知道时说明即可，结果会保留可计算的相对朝向。

## 3. 处理缺失资料 {#missing-data}

完整分析缺少资料时，AI 会列出缺项和影响，由你选择下一步：

- **先做精简分析**：现有结果已经能回答部分问题时，明确回复，例如“先做点位精简分析，查看点位间距”。
- **补充资料后继续**：目标需要物体识别或测量时，按缺项补充同一空间的全景、扫描位姿、模型或平面图；也可按 AI 提供的可用方式获取获授权的资源。
- **暂缓**：当前不便补充时，保留预检结论，稍后在同一任务继续。

已有的有效素材会继续复用。需要下载资源、权重或补充运行依赖时，AI 会说明范围，你按现有下载提示处理。下载或分析中断后，让 AI 检查已完成的步骤并继续。

### 资源下载与费用 {#resource-download}

需要通过开放平台补充素材时，由 AI 按所选版本的[下载试用说明](https://unpkg.com/@realsee/vr-cli@~0.4.0/skills/realsee-spatial-analysis/references/download-api.md)检查资源权限，在本机开发环境显式启用，并向你确认要下载的资源。

通过开放平台发起的资源下载任务，沿用所属组织在如视管理后台的资源权限与计费规则，可能消耗资源额度或产生费用。

下载任务可在管理后台的「下载中心」查看，相关资源用量可在「费用中心」查询。具体可参考管理后台相关说明：[下载中心](https://www.realsee.com/book/xBxQ8gg0)、[费用中心](https://www.realsee.com/book/Y8AY9rEH/s1qOps4y)。

## 4. 查看并核对结果 {#results}

分析完成后，让 AI 给出本次结果的实际文件路径和应用地址。默认分析输出位于工程的 `analysis-output/<VR ID>/`，具体位置以 AI 的交付说明为准。

| 查看位置 | 如何打开 | 主要看什么 |
| --- | --- | --- |
| 中文报告 | 让 AI 打开输出目录 `reports/<VR ID>/` 下的本次中文报告 | 本次分析方式、结论、所用资料、质量检查与未完成项 |
| 离线结果预览 | 在浏览器中打开输出目录内的 `result-preview.html` | 本次结果汇总；有相应数据时查看平面图与图谱 |
| 应用内结果 | 分析结果接入应用后，打开或刷新 AI 给出的应用地址，进入「空间智能」 | 结合真实空间核对本次可用的房间、点位、物体或测量结果 |

离线预览是结果查看页，不承担完整的 VR 交互。精简分析中缺少物体或测量内容时，先对照报告中的范围说明；“未执行识别”和“没有识别到物体”含义不同。

核对三件事：分析的是预期的 VR；结果范围与所选分析方式一致；报告、预览和应用展示的是本次结果。若 AI 尚未完成结果接入，让它继续检查并说明原因；仅能打开原有 VR 画面，还没有完成分析结果展示。

## 技术资料

具体命令、环境要求与执行校验由工程内的 `.agents/skills/realsee-spatial-analysis/SKILL.md` 维护。也可查阅[官方空间理解 Skill](https://unpkg.com/@realsee/vr-cli@~0.4.0/skills/realsee-spatial-analysis/SKILL.md)、[最少数据与分析档位](https://unpkg.com/@realsee/vr-cli@~0.4.0/skills/realsee-spatial-analysis/references/minimum-data.md)及[标准任务说明](https://unpkg.com/@realsee/vr-cli@~0.4.0/skills/realsee-spatial-analysis/references/standard-run.md)。公共链接跟随 0.4 系列正式补丁；已有工程按实际版本读取对应资料。

网页版本：https://open.realsee.cn/docs/get-started/spatial-analysis
文档索引：https://open.realsee.cn/docs.md
