用 AI 分析空间
本页目录
让 AI 根据你的问题分析 VR 中的物体、尺寸或房间关系,并把结果放到当前应用中查看。本指南适用于 CLI 0.4 系列的项目内分析。
1. 开始分析
已有互动应用
在能读取工程、运行命令的 AI 助手中打开当前项目,发送以下指令,并把示例问题换成你的目标:
请读取当前工程的空间理解 Skill,分析当前已连接的 VR。我想找到沙发,并了解它所在的房间。先检查已有资料,说明能完成的分析;缺数据时让我选择精简分析、补充资料或暂缓。完成后给出报告和结果预览的打开方式,并把分析结果接入当前应用。需要分析其他空间时,补充你有权访问的 VR ID。AI 会检查工程内的 Skill、连接配置和运行状态,复用已有素材与有效配置;缺少 Skill 或需要更新时,按旧工程升级指引处理。
首次使用
按入门指南的分析指令发起任务。AI 会先准备工程,通过如视网页完成必要的账号与空间接入,再继续分析。已有工程但尚未连接空间时,按配置与启动完成接入。
2. 根据资料选择分析方式
AI 会先检查空间数据、可用素材和运行环境,再说明本次能够完成的分析。你可以用下表理解预检结果,无需自行判断文件格式或选择命令参数。
分析分为完整与精简两档;精简档的结果取决于是否有可用平面图。下表列出各类输入支持的分析范围,实际结果取决于素材匹配、质量检查及本次执行情况。
| 分析方式 | 需要的空间资料 | 可以得到的结果 | 主要限制 |
|---|---|---|---|
| 完整分析 | 空间基础数据(Work)、匹配的全景与扫描位姿、可解析的三角网格模型 | 物体识别、房间信息、尺寸测量与空间连通性分析 | 点云可作补充,不能代替网格;识别和测量结果需结合原始空间复核 |
| 精简分析:有平面图 | Work 中的可用点位及同一空间、核对通过的平面图 | 图纸房间、面积、门的位置、点位归属与间距 | 不提供物体识别、家具尺寸或层高;图纸结果不等同于几何实测 |
| 精简分析:只有点位 | Work 中可用的点位位置 | 点位清单、间距、最近邻和点位分布范围;有朝向数据时提供相对朝向 | 无法据此得到房间边界、墙距、门宽或家具尺寸 |
有可用平面图时,两档分析都优先采用图纸中的房间、墙、门窗和面积;完整分析在没有平面图时才从网格推算房间。报告会注明依据。
完整分析还需要相应分析依赖与检测权重,AI 会按所选方式检查环境。缺少运行依赖与缺少空间资料会分别说明。若点位等基础输入也不可用,先按预检提示补齐资料。
例如,只有点位数据时,可以先了解点位间距,但无法完成“找到沙发”的目标。需要房间方位时,AI 可能询问一个现实朝向参考;不知道时说明即可,结果会保留可计算的相对朝向。
3. 处理缺失资料
完整分析缺少资料时,AI 会列出缺项和影响,由你选择下一步:
- 先做精简分析:现有结果已经能回答部分问题时,明确回复,例如“先做点位精简分析,查看点位间距”。
- 补充资料后继续:目标需要物体识别或测量时,按缺项补充同一空间的全景、扫描位姿、模型或平面图;也可按 AI 提供的可用方式获取获授权的资源。
- 暂缓:当前不便补充时,保留预检结论,稍后在同一任务继续。
已有的有效素材会继续复用。需要下载资源、权重或补充运行依赖时,AI 会说明范围,你按现有下载提示处理。下载或分析中断后,让 AI 检查已完成的步骤并继续。
资源下载与费用
需要通过开放平台补充素材时,由 AI 按所选版本的下载试用说明(在新标签页中打开)检查资源权限,在本机开发环境显式启用,并向你确认要下载的资源。
通过开放平台发起的资源下载任务,沿用所属组织在如视管理后台的资源权限与计费规则,可能消耗资源额度或产生费用。
下载任务可在管理后台的「下载中心」查看,相关资源用量可在「费用中心」查询。具体可参考管理后台相关说明:下载中心(在新标签页中打开)、费用中心(在新标签页中打开)。
4. 查看并核对结果
分析完成后,让 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(在新标签页中打开)、最少数据与分析档位(在新标签页中打开)及标准任务说明(在新标签页中打开)。公共链接跟随 0.4 系列正式补丁;已有工程按实际版本读取对应资料。