# 配置与启动

无论工程由 AI 还是终端创建，都可以使用下面任意一种方式连接空间数据。已有有效配置时，直接跳到[启动应用](https://open.realsee.cn/docs/get-started/configure#run)。

## 方式一：通过网页确认 {#setup}

这是默认的接入方式。让 AI 继续完成接入，或者在项目目录运行：

```bash
npm run setup
```

打开提示中的如视网页链接，登录后确认组织、开发者应用和默认空间，再返回原任务或终端。接入程序会把运行所需配置写入本地服务端文件，无需复制 AK/SK 到聊天中。

网页确认用于交付配置。配置完成后，应用通过自己的服务端访问如视接口，日常启动无需重复配对。

## 方式二：手动填写配置 {#manual}

适合已经持有可用 AK/SK，或需要自行管理环境配置的用户。

1. 在项目根目录复制 `.env.example`，将副本命名为 `.env.development`。
2. 用本地编辑器填写以下字段。不要把真实配置内容粘贴到 AI 聊天、终端命令参数或日志中。
3. 确认配置文件已被 Git 忽略，并将本地访问权限限制为当前用户。

| 字段 | 填写内容 |
| --- | --- |
| `REALSEE_GATEWAY_ENDPOINT` | 如视接口地址，默认 `https://app-gateway.realsee.cn` |
| `REALSEE_GATEWAY_APP_KEY` | 开发者应用的 AK |
| `REALSEE_GATEWAY_APP_SECRET` | 对应的 SK，仅供服务端使用 |
| `REALSEE_DEFAULT_RESOURCE_CODE` | 默认展示的 VR ID；需要首页直接打开指定空间时填写 |

AK/SK 的权限决定服务端能访问哪些数据。默认 VR ID 仅决定默认展示内容，不会限制 AK/SK 本身的权限。在线分享前，还需[限制公开访问的空间](https://open.realsee.cn/docs/get-started/publish#scope)。

手动配置有效后，可以直接运行应用，无需再执行 `setup`。没有可用凭据或需要确认权限时，联系我们获得协助。

## 检查配置 {#check}

在项目目录运行：

```bash
npm run check:env
```

该命令用于检查配置是否满足工程要求；真实空间能否访问，还需要启动后验证。若配置缺失，补全提示的字段；若鉴权失败，检查所用应用和空间访问权限，不要把凭据值输出给 AI。

## 启动应用 {#run}

```bash
npm run dev
```

打开终端显示的本地地址。确认能看到真实空间，并能完成一次视角移动或模型切换。修改服务端配置后，重新启动应用。

每个新工程需要自己的配置；可以分别网页确认，也可以按凭据管理要求手动配置。不要复制旧工程中的配对记录代替配置流程。

## 域名白名单

发布后，实际访问域名需要加入本次 AK 的域名白名单（allow host）。**目前处于限时免费阶段，白名单仅支持联系我们进行后台配置，暂不支持自助修改。** 提交所用组织、开发者应用和实际发布域名 即可，无需提供 SK。

本地运行成功后，继续[发布与分享](https://open.realsee.cn/docs/get-started/publish)。

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