配置与启动
通过网页确认或手动填写服务端配置连接如视空间数据，检查配置并启动本地互动应用。
本页目录
无论工程由 AI 还是终端创建，都可以使用下面任意一种方式连接空间数据。已有有效配置时，直接跳到启动应用。
方式一：通过网页确认
这是默认的接入方式。让 AI 继续完成接入，或者在项目目录运行：
npm run setup打开提示中的如视网页链接，登录后确认组织、开发者应用和默认空间，再返回原任务或终端。接入程序会把运行所需配置写入本地服务端文件，无需复制 AK/SK 到聊天中。
网页确认用于交付配置。配置完成后，应用通过自己的服务端访问如视接口，日常启动无需重复配对。
方式二：手动填写配置
适合已经持有可用 AK/SK，或需要自行管理环境配置的用户。
- 在项目根目录复制
.env.example，将副本命名为.env.development。 - 用本地编辑器填写以下字段。不要把真实配置内容粘贴到 AI 聊天、终端命令参数或日志中。
- 确认配置文件已被 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 本身的权限。在线分享前，还需限制公开访问的空间。
手动配置有效后，可以直接运行应用，无需再执行 setup。没有可用凭据或需要确认权限时，联系我们获得协助。
检查配置
在项目目录运行：
npm run check:env该命令用于检查配置是否满足工程要求；真实空间能否访问，还需要启动后验证。若配置缺失，补全提示的字段；若鉴权失败，检查所用应用和空间访问权限，不要把凭据值输出给 AI。
启动应用
npm run dev打开终端显示的本地地址。确认能看到真实空间，并能完成一次视角移动或模型切换。修改服务端配置后，重新启动应用。
每个新工程需要自己的配置；可以分别网页确认，也可以按凭据管理要求手动配置。不要复制旧工程中的配对记录代替配置流程。
域名白名单
发布后，实际访问域名需要加入本次 AK 的域名白名单（allow host）。目前处于限时免费阶段，白名单仅支持联系我们进行后台配置，暂不支持自助修改。 提交所用组织、开发者应用和实际发布域名 即可，无需提供 SK。
本地运行成功后，继续发布与分享。