# 3D色彩切换 Widget PRD

版本：v0.2  
优先级：P2  
状态：待独立页面原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义在三维/全景样板间中切换色彩方案的独立体验。 |
| 2026-08-03 | v0.2 | 启用与设备状态补充 | 根据 DeepSeek PM 评审统一默认方案失效时的启用门槛，并明确画布不支持的顾客可见状态。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 3D色彩切换 |
| 唯一标识 | `3d-color-switcher` |
| 分类 | 住户产品 |
| 一句话介绍 | 让顾客在同一三维或全景室内场景中切换并比较已配置的装修色彩方案。 |
| 封面图 | 三维室内空间类型图。 |
| 设计图 | 沉浸画布与方案选择设计示意。 |

## 2. 目标与场景

面向需在空间视角中判断装修风格的顾客。顾客旋转/浏览同一空间，切换可比方案并比较视觉效果，完成风格选择参考；作为独立页面主承载。

## 3. 内容与数据

必需为一个已发布三维/全景空间内容、至少两套同空间可切换方案和方案名称；说明、材质清单、默认视点可选。方案必须覆盖同一空间和相同可浏览范围；不完整方案不进入集合。

## 4. 使用与配置

配置空间、方案集合、默认方案/视点和是否允许比较。先校验同空间、完整有效的方案集合：少于两套时不启用；达到两套后，默认方案失效才取该有效集合的第一项。方案顺序可配置。

## 5. C端 UI 与交互

默认显示沉浸画布、当前方案、切换器和操作提示。顾客可浏览空间、切换方案、复位视角，且在切换中看到加载状态；失败时保持前一有效方案并提示。设备不支持该内容所需图形能力、内容明确声明不支持当前设备，或画布初始加载超时/失败时，视为“不能支持画布”：显示明确替代提示及退出/返回，不显示伪交互画布。移动端提供触控与可收起方案面板。

## 6. 用户用例与验收

**UC-01**：顾客在同一空间中切换不同色彩方案。  
**UC-02**：顾客复位视角后继续对比。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 仅可切换同一空间、完整有效的方案。 |
| AC-02 | 切换失败保留最后可用方案，不显示空白画布。 |
| AC-03 | 移动端可完成浏览、切换和退出。 |
| AC-04 | 画布不支持条件触发时显示替代提示和退出/返回，不显示不可操作画布。 |