# 开发文档

用 AI 创建可以浏览、互动和分享的网页应用，也可以分析空间中的物体、尺寸与房间关系。从你的目标和已有工程出发，找到对应的使用指南。

## 用 AI 开始 {#start}

把下面的指令发给你常用的 AI 助手，让它读取指南并创建应用。你可以补充想做的导览、展厅、游戏或其他功能。

```text
请阅读并按照 https://open.realsee.cn/spatial-apps/create/SKILL.md 的指引，帮我创建一个如视互动应用。
```

[用 AI 创建互动应用](https://open.realsee.cn/docs/get-started)会带你完成准备、空间选择和首次运行。如果你习惯自己操作终端，也可以[通过终端创建](https://open.realsee.cn/docs/get-started/terminal)。

## 按已有条件继续

- 能力咨询、架构评估或只读代码分析：从[技术知识入口](https://open.realsee.cn/docs/skills#vr-app-knowledge)直接读取对应版本资料，无需创建应用或准备开发环境。
- 已有应用或业务系统需要开发：提供现有工程与目标，AI 复用技术栈、配置和有效成果，完成必要实现与验证；明确需要独立原型时再新建。

## 分析空间 {#spatial-analysis}

想了解 VR 中的物体、尺寸或房间关系，阅读[用 AI 分析空间](https://open.realsee.cn/docs/get-started/spatial-analysis)。教程说明如何发起任务、根据现有资料选择分析方式，以及查看报告、离线预览和应用内结果。

已有互动应用时，在当前工程中直接提出分析需求；首次使用时，按教程中的接入指引准备工程并连接空间，再继续分析。

## 配置与启动 {#configure}

工程创建后，需要连接如视空间数据。你可以通过网页确认接入，也可以手动填写服务端配置；已有有效配置时直接启动。

查看[配置与启动](https://open.realsee.cn/docs/get-started/configure)，了解两种方式、配置字段和运行结果。

## 发布与分享 {#publish}

本地运行成功后，把应用发布成别人可以打开的网页链接。先阅读[发布与分享](https://open.realsee.cn/docs/get-started/publish)，使用 WorkBuddy 的用户可以直接查看[WorkBuddy 发布指南](https://open.realsee.cn/docs/get-started/publish-workbuddy)，使用豆包工作时查看[妙搭发布指南](https://open.realsee.cn/docs/get-started/publish-doubao)。

## 开发参考 {#resources}

- [Five SDK](https://open.realsee.cn/docs/five-sdk)：网页中的全景浏览、三维展示与交互能力。
- [API 文档](https://open.realsee.cn/docs/api-reference)：服务端接口、参数和响应结构。
- [空间数据与样例](https://open.realsee.cn/spatial-data)：可用的数据类型、空间示例和样例下载。
- [互动应用案例](https://open.realsee.cn/cases#spatial-apps)：查看已经实现的效果。

## 给 AI 的资料 {#skills}

[Skills 目录](https://open.realsee.cn/docs/skills)列出官方 Skill 的适用范围、使用指南和 AI 可读原文。创建和空间分析指南会引导 AI 使用对应 Skill。

本指南的每一页都提供“复制本页”和“查看 Markdown”。需要让 AI 查阅多篇指南时，可以把文档索引 https://open.realsee.cn/docs.md 交给它。

网页版本：https://open.realsee.cn/docs
文档索引：https://open.realsee.cn/docs.md

## Markdown 文档索引

- [用 AI 创建互动应用](https://open.realsee.cn/docs/get-started.md)：把想法交给 AI，创建工程、连接如视空间数据，在浏览器中运行第一个互动应用。
- [通过终端创建](https://open.realsee.cn/docs/get-started/terminal.md)：使用官方命令行工具创建互动应用工程，再选择网页确认或手动配置，启动本地应用。
- [配置与启动](https://open.realsee.cn/docs/get-started/configure.md)：通过网页确认或手动填写服务端配置连接如视空间数据，检查配置并启动本地互动应用。
- [用 AI 分析空间](https://open.realsee.cn/docs/get-started/spatial-analysis.md)：在已有互动应用中发起空间分析，按现有资料选择分析方式，补充缺失素材并查看报告、预览和应用内结果。
- [发布与分享](https://open.realsee.cn/docs/get-started/publish.md)：将本地可运行的互动应用发布为网页链接，选择托管方式，配置服务端和允许域名，并验证访问效果。
- [用 WorkBuddy 发布互动应用](https://open.realsee.cn/docs/get-started/publish-workbuddy.md)：使用 WorkBuddy 网站应用发布如视互动应用，了解云服务的启用条件与费用，申请域名白名单并分享网页链接。
- [用豆包工作与妙搭发布互动应用](https://open.realsee.cn/docs/get-started/publish-doubao.md)：在豆包工作中通过妙搭发布如视互动应用，使用加密环境变量配置凭据，完成域名授权、功能验收和后续更新。
- [Skills](https://open.realsee.cn/docs/skills.md)：查找如视官方 Skill，直接读取技术知识与代码分析资料，或按需开展互动应用开发、空间理解与 Blender 创作。
- [Five SDK](https://open.realsee.cn/docs/five-sdk.md)：了解如视 Web 三维空间渲染与交互 SDK，查阅官方文档和项目安装版本配套的资料。
