# 用 WorkBuddy 发布互动应用

把已经能在本地运行的互动应用，发布成别人可以打开的网页链接。WorkBuddy 的“网站应用”可以托管前端和 Node.js 服务端；本指南中的空间展示和已有交互无需开启单独的“云服务”。

## 发布后效果示例

[查看已发布的互动应用](https://realsee-lab-vr.app.workbuddy.host/?sharecode=LBMXJTH4EY)，了解通过 WorkBuddy 分享后的网页效果。

## 开始前

确认本地应用能显示真实空间并完成一次交互。还没有应用时，先[用 AI 创建互动应用](https://open.realsee.cn/docs/get-started)。

选择允许访客查看的空间。发布后的服务端需要限制可访问的 VR ID，设置默认空间不会缩小 AK/SK 本身的数据权限。

当前验证过的配置方式会将专用服务端配置文件随应用上传，**WorkBuddy 托管环境将持有 AK/SK**。你无需把凭据发给 AI。上传前，助手应说明展示范围和配置方式，由你确认；详细要求见[服务端配置要求](https://open.realsee.cn/docs/get-started/publish-workbuddy#credentials)。

## 1. 让 WorkBuddy 发布

在已经创建应用的同一个任务中发送：

```text
请阅读 https://open.realsee.cn/docs/get-started/publish-workbuddy.md，按照指南发布当前已能运行的如视互动应用，生成可分享的网页链接，让别人能打开并使用已有功能。

使用 WorkBuddy 自带的“网站应用”。当前只展示空间和已有交互，无需开启云服务。先核对运行环境和服务端配置要求，限制公开访问的空间；上传前向我说明托管环境、展示范围和凭据配置方式，等我确认后再发布。不要把凭据值读入聊天、日志或前端。

取得链接后，告诉我需要申请白名单的实际发布域名。等我确认后台配置完成后，再验证完整分享链接中的真实 VR 和已有交互，交付可用链接。
```

应用需要前端和服务端一起运行。遇到环境或配置问题时，让 WorkBuddy 根据实际错误处理，不要只上传静态网页，也不要自行改用其他发布渠道。

## 2. 联系我们配置域名白名单

取得分享链接后，将实际发布域名加入本次 AK 的域名白名单（allow host）。**目前如视开放平台处于限时免费阶段，白名单仅支持联系我们进行后台配置，暂不支持自助修改。**

联系我们时，请说明所用组织、开发者应用及实际发布域名，无需提供 SK。提交平台分配给你的真实域名，不要照抄示例或扩大为通配域名。

## 3. 检查并分享

收到后台配置完成的确认后，回到 WorkBuddy：

```text
如视开放平台已确认完成实际发布域名的白名单配置。请打开完整分享链接，验证真实 VR 渲染与一次已有交互；通过后交付链接，保留已发布应用。
```

打开完整分享链接，确认空间和交互效果。保留链接附带的访问参数；需要手机或外部网络访问时，在对应设备和网络中检查后再分享。

首次发布验证中，配置完成后刷新即可正常渲染，无需重新发布。如果仍出现 `Host is not allowed`，联系如视核对实际发布域名 和所用 AK，保留原有校验。

## 是否需要开启 WorkBuddy 云服务

“云服务”提供云数据库、用户登录、文件存储和用户统计等能力。本指南中的空间展示、浏览和三维模型切换，由网站应用的前后端与如视接口完成，无需开启云服务。后续需要保存报名或预约记录、跨设备共享数据、让访客注册登录或上传文件时，可以告诉 WorkBuddy 具体需求，再按提示确认开启。

云服务额度随会员版本提供：目前免费体验版可为 10 个应用开启云服务，每个应用每月有 5,000 资源点；付费会员提供更高额度。使用数据库、文件存储等能力会消耗资源点，用尽后云服务暂停，可等待下次额度刷新或升级到额度充足的会员版本恢复。不开启云服务，不消耗这部分资源点，也不占用云服务应用名额。

以上规则核对于 2026 年 10 月 27 日。具体额度与消耗规则见 [WorkBuddy 云服务说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/App-Publishing/Cloud-Services)，会员价格及其他使用权益见 [官方定价](https://www.workbuddy.cn/docs/workbuddy/Pricing)，以官网及账号页面的最新显示为准。

## 更新、下线与轮换 SK

根据 [WorkBuddy 网站应用说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/App-Publishing/Web-App)，可以在“设置 > 数据管理 > 应用”管理发布状态；修改后需再次更新发布，暂时停止分享可以选择下线。上述管理步骤来自官方说明，本指南尚未实测更新与下线。

发布后，按实际用途维护：

- 临时分享结束：下线应用，并按你的凭据管理安排轮换 SK。
- 应用继续保留：轮换 SK 后，更新托管端配置并重新验证；仅修改本地文件不会自动更新线上版本。

下线应用、轮换 SK、更新远端配置是不同操作。轮换不能撤回已经访问的数据，也不能据此保证已签发的 Token 立即失效。长期运行前，还需确认平台的配额、费用、运行时与配置维护方式。

## 服务端配置要求 {#credentials}

本地接入完成后，运行所需的 AK/SK 已保存在受限的服务端配置中。发布后，托管服务端仍需使用它们换取短期 Token、访问如视接口。你无需把凭据值发送给 AI，也不需要粘贴到聊天中。

当前验证过的配置方法是：让本地程序从现有配置中读取运行所需字段，写入独立发布副本的 `.env.server`，再由线上 Node.js 服务读取。**这个文件会随发布上传，WorkBuddy 托管环境将持有 AK/SK。** 仅在你接受这一点、所选空间适合分享，并已安排应用下线或凭据维护时使用。

让 WorkBuddy 完成以下准备，只报告检查结果，不输出配置值：

- `.env.server` 位于网页静态目录 `dist` 之外，本地文件权限限制为仅当前用户读写，并排除出 Git；Git 忽略规则不等于发布工具会忽略该文件。
- 只复制运行所需配置，不上传配对记录、领取材料或整份本地开发配置。
- 前端只调用自己的服务端；服务端只允许本次选定的空间，并且只对外提供指定的网页目录和接口。
- 检查前端产物没有真实 AK/SK；验证配置文件、配对文件和源码不能通过网页下载，替换为未允许的 VR ID 会被拒绝。

上传前，由 WorkBuddy 说明托管平台、展示的空间、上传的配置文件及访问范围，再由你确认。文件权限与目录隔离用于减少泄露机会，不能把托管文件变成平台不可读取的密钥。若平台提供了经过验证的服务端密钥配置入口，可以改用该入口；长期部署应建立受控配置与轮换流程。

### 运行时兼容性

保留原工程，在独立发布副本中适配。复用同一产物有效的依赖安装和检查结果，不通过降低 engines 声明或关闭检查来掩盖不兼容。

本地创建环境与托管环境可能使用不同的 Node/npm。让 WorkBuddy 先核对实际版本，再判断平台能否选择合适运行时，或是否需要有依据的部署适配。

首次发布验证的托管环境实测为 Node 22.13.1 / npm 11.9.0，低于原工程声明；当时只在发布副本适配并验证了该版本。不要把临时降低的版本声明复制为通用要求，也不要把这个结果扩展到 CLI 0.2.3 或其他运行时。

## 适用范围

本指南已在 WorkBuddy V5.9.2、CLI 0.2.2 上人工辅助验证线上真实 VR 渲染和三维模型切换（2026 年 10 月 26 日）。CLI 0.2.3 已验证本地接入和渲染，尚未完成发布复验。持续运营、设备兼容性和平台运行保障需按实际用途验证。

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