# 用豆包工作与妙搭发布互动应用

在豆包工作中继续已有的如视应用任务，通过妙搭托管网页和服务端，生成可分享链接。你需要完成两项配置：在妙搭中保存服务端凭据，以及取得发布链接后联系如视配置域名白名单。随后检查线上空间和原有功能，再分享链接。

[查看豆包／妙搭发布示例](https://4mc9gdazb0pv7.doubao.link/app/app_17gvmw76pem)，体验通过公开链接浏览真实空间的效果。示例展示基础浏览，完整功能以你自己的应用需求为准。

## 开始前

先确认本地应用能显示真实空间，并列出本次要保留的功能，例如漫游、三维模型切换、平面图和标签。还没有应用时，先[用 AI 创建互动应用](https://open.realsee.cn/docs/get-started)。

本指南依据 2026 年 10 月 27 日的辅助实践，已验证加密配置、真实全景发布和拖拽浏览。完整功能迁移、手机兼容、长期运行、凭据轮换与下线尚未实测。套餐、费用与额度以平台当前账号页面为准。

选择允许访客查看的空间，并确认谁可以访问链接。公开范围与服务端限制见[确认分享范围](https://open.realsee.cn/docs/get-started/publish#scope)。默认 VR 只是默认配置，不会缩小开发者凭据的数据权限。

### 从本地开发到妙搭发布，有什么不同？

豆包在本地开发时修改的是电脑上的项目；通过妙搭发布时，应用运行在妙搭的云端开发与托管环境中，代码、依赖和服务端配置可能需要适配。本次实践中，豆包另建了云端工程并重新实现了基础查看器，没有完整保留本地的“漫游／三维模型”切换和平面图。

因此，这一步需要按应用迁移来检查，不能预期发布后自动获得与本地完全一致的功能。先让豆包说明如何复用原工程、列出要保留的功能，发布后逐项核对；后续修改也要明确针对现有妙搭应用。本次功能缺失不代表妙搭不支持这些功能。

## 1. 让豆包准备发布应用

把以下指令发给已创建应用的豆包工作任务：

```text
请阅读 https://open.realsee.cn/docs/get-started/publish-doubao.md，使用豆包内的妙搭发布当前如视互动应用。

先检查原工程，列出要保留的功能、可复用代码和云端需要适配的部分。保留原工程；若需另建妙搭工程，按功能清单迁移，不要用仅能加载全景的简化页面代替完整应用。

前端通过本应用的服务端访问如视，服务端只允许本次选定的空间。使用妙搭原生加密环境变量保存运行配置，告诉我应填写的字段名和入口，不要读取或输出凭据值，也不要要求我把凭据发到聊天中。

先完成不含真实凭据的代码与配置准备，说明托管平台和访问范围。我完成加密配置后再发布，取得实际分享域名并指导我联系如视配置白名单。最后从公开链接逐项验证真实空间与原有功能。
```

妙搭本次可以运行前端和服务端，无需自行另找后端托管。让豆包按照当前妙搭工程接入服务端接口，沿用平台请求封装及 CSRF 保护；直接打开 API 地址遭拒绝，不足以证明后端不可用。

## 2. 填写加密配置并发布 {#credentials}

在豆包中打开该应用的妙搭开发台：

1. 点击顶部 **＋ → 环境变量 → 添加**。
2. 填写变量名，点击值输入框旁的锁图标。
3. 确认切换为加密值。平台提示：切换后值将不再可被查看。
4. 在该表单中填写对应值并保存，依次完成下表三项。

| 变量名 | 填写内容 |
| --- | --- |
| `REALSEE_GATEWAY_APP_KEY` | 本次开发者应用的 AK |
| `REALSEE_GATEWAY_APP_SECRET` | 同一开发者应用的 SK |
| `REALSEE_DEFAULT_RESOURCE_CODE` | 本次展示的 VR ID |

这些名称对应本次已验证的应用约定。若你的云端工程使用不同名称，先让豆包核对服务端读取代码，统一名称后再填写；不要反复添加多个猜测字段。

凭据可从自己的[开发者应用](https://open.realsee.cn/dashboard/apps)中取得，或在本地受限配置中查看后自行填入平台表单。**保存后，豆包／妙搭托管环境将持有这组凭据，供应用后端使用。** 加密值不可回看，并不意味着运行中的后端无法读取；不要将其注入前端或记录到日志。

保存配置后按平台提示重启服务，并完成**发布**，再检查公开链接。本次只重启开发服务没有使线上配置生效，发布后才验证通过。开发预览与线上版本应分别检查。

如果 AI 声称没有安全配置入口，先检查上述原生界面。本次已通过非敏感测试值验证加密保存与服务端读取，无需为此另建收集密钥的网页。

## 3. 联系如视配置域名白名单

取得分享链接后，将实际 hostname 提交给如视开放平台配置本次 AK 的域名白名单。**目前白名单需联系我们后台配置，暂不支持自助修改。** 提供组织、开发者应用及实际域名即可，无需提供 SK。

让豆包从分享链接中提取实际域名（不含 `https://` 和后面的路径），连同组织、开发者应用信息，通过[官网联系入口](https://open.realsee.cn/)申请配置。使用自己的真实发布域名，不照抄他人的域名，也不主动扩大为通配域名。

收到如视确认后，在原豆包任务中发送：

```text
如视已确认配置完成本应用的实际发布域名。请打开完整公开链接，检查真实 VR 和迁移前的功能清单。缺失功能请明确列出，不要仅凭接口成功就判断发布完成。
```

## 4. 检查并分享

打开完整公开链接，按准备阶段的功能清单验收：

- 页面显示你选定的真实 VR，并可拖拽改变视角。
- 原应用有“漫游”“三维模型”等按钮时，逐项点击，确认画面与状态确实变化；平面图按当前空间数据能力检查。
- 检查自定义标签、导航或其他业务交互，以及访客可以访问的空间范围。
- 需要手机或外部网络访问时，在对应设备和网络中检查后再分享。

确认需要分享的功能均可用后，再把完整链接发给使用者。若按钮或交互缺失，回到原豆包任务要求补齐，并重新发布验收。

## 发布后如何更换 VR 或修改功能

**更换展示的 VR：**在同一应用的环境变量中更新 `REALSEE_DEFAULT_RESOURCE_CODE`，同步核对服务端允许展示的空间范围，按平台提示使配置生效并检查线上页面。此方式已由实践用户确认生效。

**修改功能：**在原豆包任务中明确要求修改现有妙搭应用，保留加密配置与已验证功能。发布新版本后，重新检查完整功能清单。本地文件改动不会自动同步到另建的云端工程。

**轮换凭据：**在如视完成轮换后，同步更新妙搭的加密配置并验证服务端取数和网页渲染。此流程本次未实测；操作前先确认是否有其他应用共用该凭据。若发布域名变化，重新联系如视核对域名授权。

## 不再分享时

停止分享时，让豆包定位当前应用的发布或访问管理入口，说明如何停止访客访问，再按你的决定处理。本指南尚未实测下线，操作入口需以当前平台为准。

完成后，用原分享链接验证访客已无法访问。关闭本地预览、退出豆包或删除本地文件，都不能作为线上应用已下线的依据。

另外按凭据管理安排处理托管端配置；若需轮换 SK，先检查共用应用。下线、删除配置、轮换凭据是不同操作，轮换也无法撤回已被访问的数据，或保证已签发 Token 立即失效。

## 遇到问题时

| 现象 | 下一步 |
| --- | --- |
| 能获取空间数据，但出现 `Host is not allowed` | 核对本次 AK 与实际发布域名的白名单，保留 SDK 校验。不要修改 Work 中的授权字段来绕过检查。 |
| 更换 VR 后没有出现模式按钮 | 配置更新只更换数据。让豆包对照原工程检查模式切换组件与调用是否已迁移。 |
| 配置已保存，线上仍提示未配置 | 核对服务端变量名、目标应用和发布状态，再访问公开链接；不要仅凭开发预览判断。 |
| 页面打印很长的 Work 或原始异常 | 让豆包改成简洁的用户提示，避免在页面和日志输出完整 Work、签名或原始异常。 |
| 发布后出现 HTTPS 连接错误 | 先核对发布完成状态和官方分享地址，再正常重试。本次曾短暂出现连接错误，随后新开页面恢复，根因未确定。不要关闭证书校验或降级 HTTP。 |

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