# 状态反馈组件 PRD

版本：v0.2
状态：待原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 统一加载、空结果、局部失败、整体不可用和重试表达。 |
| 2026-08-09 | v0.2 | 重大：状态文案来源收敛 | 明确状态信息和恢复动作必须由调用方 PRD或正式共享规则定义，组件不得推测原因或生成文案。 |

## 定义

唯一标识：`content-state-feedback`。为 Widget/组件显示与其范围匹配的状态和可恢复动作；不将局部内容失败升级为页面全局错误。

## 内容与配置

状态类型和顾客可读信息必需，且必须来自调用方 PRD、对应 Widget PRD 或正式共享状态规则；重试、清除筛选、返回等动作由调用方按同一来源提供。组件不得根据技术错误、页面上下文或 AI 推测失败原因和恢复建议。可配置紧凑/完整、局部/整体范围。没有已定义的可恢复动作时不显示虚假的“重试”。

## 交互、状态与验收

顾客执行有效恢复动作；状态消失后恢复调用方内容。验收：空结果保留可恢复条件；媒体/路线等局部错误只作用于本区域；整体不可用说明范围。