# 外部内容承载组件 PRD

版本：v0.2

状态：待原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-06 | v0.1 | 初始创建 / 重大边界调整 | 外部页面嵌入退出 Widget 范围，改由本组件承载外部服务。 |
| 2026-08-09 | v0.2 | 重大：外部状态文案来源收敛 | 明确加载、失败、重试、退出等顾客文案须由调用方 PRD 或正式共享规则定义，组件不得暴露或推测技术原因。 |

## 定义

唯一标识：`external-content-host`。由页面或内容对象调用，承载已批准的企业自有或第三方服务；不定义外部服务内部功能，也不作为可独立装配的 Widget。

## 配置与规则

必需配置服务名称、访问地址、提供方/责任主体、启用状态和返回目标；可选配置来源提示、承载方式与不可用替代动作。所有顾客可见的加载、失败、重试、退出、新窗口和替代动作文案，必须由调用方 PRD 或正式共享规则定义；组件不得根据技术错误生成或展示“拒绝嵌入”“跨域”“网络错误”等原因。地址仅可使用已批准范围；返回目标必须为当前项目内有效且不形成循环的 C端目标。根据目标兼容性选择当前页承载或新窗口/新标签；不兼容当前页时改为明确的新窗口动作。

## 顾客体验与验收

进入前和承载期间显示服务名称与提供方。当前页承载时始终可返回 C端；新窗口方式明确告知顾客将离开当前内容。加载超时、拒绝承载、目标页面错误或运行中断时均提供顾客可理解的反馈、重试与返回。

验收：仅已批准且启用的服务可进入；不显示空白承载区；无效或循环返回目标不启用；组件不出现 WALK / VR 的帮助、复位或沉浸控制。