用 WorkBuddy 发布互动应用

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

发布后效果示例

查看已发布的互动应用（在新标签页中打开），了解通过 WorkBuddy 分享后的网页效果。

开始前

确认本地应用能显示真实空间并完成一次交互。还没有应用时，先用 AI 创建互动应用。

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

当前验证过的配置方式会将专用服务端配置文件随应用上传，WorkBuddy 托管环境将持有 AK/SK。你无需把凭据发给 AI。上传前，助手应说明展示范围和配置方式，由你确认；详细要求见服务端配置要求。

1. 让 WorkBuddy 发布

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

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

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

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

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

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

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

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

3. 检查并分享

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

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

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

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

是否需要开启 WorkBuddy 云服务

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

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

以上规则核对于 2026 年 10 月 27 日。具体额度与消耗规则见 WorkBuddy 云服务说明（在新标签页中打开），会员价格及其他使用权益见 官方定价（在新标签页中打开），以官网及账号页面的最新显示为准。

更新、下线与轮换 SK

根据 WorkBuddy 网站应用说明（在新标签页中打开），可以在“设置 > 数据管理 > 应用”管理发布状态；修改后需再次更新发布，暂时停止分享可以选择下线。上述管理步骤来自官方说明，本指南尚未实测更新与下线。

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

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

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

服务端配置要求

本地接入完成后，运行所需的 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 已验证本地接入和渲染，尚未完成发布复验。持续运营、设备兼容性和平台运行保障需按实际用途验证。