frontend-miniapp/docs/SGS_MAP_SDK_IFRAME_NOT_ENABLED.md

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 代码。