如视
控制台

用 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 系列正式补丁;已有工程按实际版本读取对应资料。