# 单个文件夹展示 Widget PRD

版本：v0.1  
优先级：P1  
状态：待原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 明确单文件夹展示与资料集的任务边界。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 单个文件夹展示 |
| 唯一标识 | `single-folder-display` |
| 分类 | 资料内容 |
| 一句话介绍 | 在画廊、概念集等上下文中直接展示一个指定资料文件夹的内容，而非让顾客先选择文件夹。 |
| 封面图 | 画廊/概念集类型图。 |
| 设计图 | 单一资料集内容流设计示意。 |

## 2. 目标与场景

面向已由页面或内容上下文确定主题的顾客。顾客直接浏览指定文件夹内的资料、打开其中一项并返回，完成该主题资料的连续阅读。它不承担多个文件夹之间的发现和比较任务。

## 3. 内容与数据

必需为一个已选、已公开且至少含一项有效资料的文件夹；文件夹名称和每项资料的名称、类型、查看动作必需。说明、封面、标签、排序可选。无有效文件夹或资料时 Widget 不启用。

## 4. 使用与配置

只能选择一个文件夹；配置展示名称是否使用文件夹原名、资料顺序、网格/横滑展示和是否显示资料类型。选择多个文件夹视为无效配置，显示待修正而不自行拼接集合。

## 5. C端 UI 与交互

默认显示主题名称（如启用）和该文件夹的资料流。顾客可浏览、按类型查看、打开单项并返回当前资料流；图片、视频、PDF 使用相应通用查看器。单项失败局部提示；全部资料失效显示空状态。移动端保持主题连续性，不回退到文件夹选择页。

## 6. 用户用例与验收

**UC-01**：顾客直接浏览一个“概念集”中的资料。  
**UC-02**：顾客打开其中一项资料并返回同一主题流。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | Widget 仅消费一个指定有效文件夹。 |
| AC-02 | 不出现文件夹发现/选择功能。 |
| AC-03 | 单项资料失败不影响其他资料可读。 |