# 平面色彩切换 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义在平面 CG 图上比较装修色彩方案的独立体验。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 平面色彩切换 |
| 唯一标识 | `floorplan-color-switcher` |
| 分类 | 住户产品 |
| 一句话介绍 | 让顾客在同一平面空间视角中切换并比较已配置的装修色彩方案。 |
| 封面图 | 室内平面 CG 类型图。 |
| 设计图 | 主画面、方案选择和对比说明设计示意。 |

## 2. 目标与场景

面向需要判断室内色彩风格的顾客。顾客切换两种或以上同一视角的方案、阅读方案名称/说明，完成风格比较；以独立页面主承载。

## 3. 内容与数据

必需为一个户型/空间上下文、至少两套方案以及每套可加载的同视角平面 CG 图；方案名称必需，色材说明可选。方案之间视角不一致时不得进入比较集合。

## 4. 使用与配置

选择空间与方案集合，配置默认方案、排序、是否启用快速对比。默认方案失效时取第一有效方案；少于两套有效方案时不启用。方案资料不完整时移除单项。

## 5. C端 UI 与交互

默认显示主图、方案选择器和当前说明。顾客切换方案、放大查看，并可开启左右/叠加对比（如启用）。图片加载时显示局部占位，失败方案不可选；不将不同空间素材混为同一比较。移动端方案选择固定可见或收入底部面板。

## 6. 用户用例与验收

**UC-01**：顾客在两个以上方案间切换。  
**UC-02**：顾客比较同一视角的两套方案。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 仅显示空间和视角可比的有效方案。 |
| AC-02 | 当前图片、方案名称、说明同步更新。 |
| AC-03 | 少于两套有效方案时不进入色彩切换体验。 |