# SGS Map SDK 2.5.0 iframe 状态说明

## 当前应用边界

`frontend-miniapp` 不加载 `SGSMapSDK`，不创建 iframe，也不发送 SDK Bridge `postMessage` 命令。H5 馆内渲染继续使用 `ThreeMap`。

`VITE_GUIDE_DATA_SOURCE_MODE=sdk` 仅表示导览楼层和 POI 通过 SGS REST Repository 获取；它不是 SDK Bridge 或渲染器开关。

## 2.5.0 发布记录

本地静态包版本为 2.5.0。其公开 TypeScript 方法面相较 2.4.1 没有变化。业务 POI、精品路线/流线、POI 间导航、诊断和漫游均是更早已有能力，不会因升级到 2.5.0 而自动被本应用采用。

2.5.0 的运行层变化是渲染架构：旧的 `/h5-sdk` 路由被独立部署的 `/engine/index.html` 运行时取代。未来若接入 iframe，必须使用匹配的 2.5.x Bridge 与 Engine，采用 HTTPS 安全部署、显式 `targetOrigin`，并完成 `HELLO -> ENGINE_READY` 握手。

## 保持禁用的原因

当前同源 `/engine/index.html` 返回的是博物馆应用 SPA 回退页面，而不是 `SGS Map SDK Engine` 文档。仅有 HTTP 200 不能代表健康。已知的 HTTP Engine 参考地址不能嵌入 HTTPS 生产 H5，否则会产生 mixed content。

在未来实施前，运维必须在 HTTPS 源站部署或反向代理完整的 Engine 资源，并验证文档标识、资源与握手。本项目届时需要新增专用 renderer 边界和生命周期/浏览器测试；当前不保留闲置的 iframe 代码。