# 发布与分享

发布后，其他人可以通过网页链接访问应用。先确认本地应用能展示真实空间，并且需要分享的功能已经可用。

## 选择发布方式

使用 WorkBuddy 开发时，可以继续让它通过自带的“网站应用”托管前端和 Node.js 服务端，具体步骤见 [WorkBuddy 发布指南](https://open.realsee.cn/docs/get-started/publish-workbuddy)。仅展示空间和已有交互时，无需开启它单独提供的云服务。

也可以部署到你自行管理、支持 Node.js 的托管环境。应用包含网页前端和访问如视接口的服务端，单独上传 `dist` 静态目录不能完成整个部署。

## 确认分享范围 {#scope}

选择允许访客查看的空间，并让服务端只接受这些空间的 VR ID。设置默认空间不会缩小 AK/SK 的权限；访客修改地址或请求中的 VR ID 时，也必须受到同样限制。

根据内容决定谁可以访问。需要登录或访问控制时，在分享前完成对应功能和验证；持有链接即可访问的页面应只展示适合公开或按此方式分享的数据。

## 配置托管环境

让 AI 或负责部署的开发者完成以下事项：

- 核对托管环境的 Node.js、npm 与工程版本要求，确认平台的启动命令、监听地址和端口规则。
- 使用工程的构建命令生成网页产物，启动完整的 Node.js 服务端。标准工程提供 `npm run build` 和 `npm start`，具体适配以生成工程和托管平台要求为准。
- 将 AK/SK 仅配置在服务端。优先使用平台提供的服务端密钥配置；前端产物、公开文件、日志和聊天中不得包含凭据。
- 检查服务端只对外提供预期网页目录和接口，配置文件与配对材料无法通过网页下载。

WorkBuddy 当前验证过的服务端文件配置方式，以及上传前需要确认的内容，见[对应指南](https://open.realsee.cn/docs/get-started/publish-workbuddy#credentials)。不同托管环境的配置方式不能直接照搬。

## 配置允许域名

取得发布链接后，确认实际发布域名（hostname），联系如视开放平台配置本次 AK 的域名白名单（allow host）。

**目前处于限时免费阶段，白名单仅支持联系我们进行后台配置，暂不支持自助修改。** 请说明所用组织、开发者应用和实际域名，无需提供 SK。收到配置完成的确认后再验证线上访问。

## 检查并分享

用完整分享链接打开应用，确认真实 VR 渲染和至少一项已有交互。健康检查成功、接口返回数据或页面显示空间名称，都不能代替浏览器中的真实画面。

按实际使用场景检查手机、电脑和外部网络访问。确认效果后，把完整链接交给使用者；平台附带的访问参数应一并保留。

## 更新与维护

修改功能后重新构建、发布并检查。轮换 SK 时同步更新托管端配置，仅修改本地文件不会更新线上应用。停止使用时，在托管平台下线应用，并按凭据管理要求处理相关密钥。

持续运行前，确认托管平台的配额、费用、运行时支持和配置维护方式。

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