| name | immersive-backdrop-sheet |
| description | 沉浸式媒体详情 Bottom Sheet：海报/backdrop 作全屏背景 + 自上而下渐变遮罩 + 半透明内容卡。首屏用已有实体信息瞬时渲染，列表异步加载。参考订阅文件统计 Sheet。 |
沉浸式 Backdrop Sheet（媒体详情）
适用：从列表 Item 点开的「次级详情」——文件统计、资源明细、分集状态等。需要媒体氛围感，但不必做成独立路由全页。
参考实现
lib/modules/subscribe/pages/subscribe_files_page.dart
showSubscribeFilesSheet / SubscribeFilesSheet
- 入口：列表
onTap 直接弹 Sheet（编辑等操作留在菜单）
设计风格
整体气质
- Immersive + Exaggerated Minimalism：大标题、少装饰、强对比，靠海报氛围而非多层卡片堆叠
- 色板：统一
DashboardPalette.of(context)，不硬编码品牌色；下载用 coolAccent，媒体库用 successAccent
- 图标：只用 Cupertino/Material Icon，禁止 emoji 当图标
- 触控：关闭/刷新/复制等热区 ≥ 44×44
视觉结构（从上到下）
- 全屏 Backdrop（
Stack 最底层）
- 优先
backdrop → poster → 分集 still
BoxFit.cover 铺满 Sheet
- 自上而下渐变遮罩（盖在 backdrop 上）
- 颜色用
palette.pageBackground 的 alpha 渐变，不是纯黑
- 推荐 stops：
0 / 0.28 / 0.58 / 0.82
- alpha：
0.18 → 0.42 → 0.82 → 1.0
- 目的：顶部能透出海报，下部与列表区自然融合，避免「大海报块 + 灰白列表」割裂
- Intro 区（可滚动内容顶部）
- 拖拽条 + 关闭/刷新
- 大字标题（约 26、w900、轻微 letterSpacing 负值）
- 次要 meta 一行（年 / 季 / 类型）
- Metric chip：分集 / 下载 / 媒体库（半透明底 + 细描边）
- 列表 Item
- 卡片本身半透明：
surface alpha 约 dark 0.78 / light 0.90，让背景海报隐约透出
- 顶区：分集 still + 大字
E{n} + 状态胶囊（下载/媒体库数量）
- 底区：分区标题 + 侧强调色条的文件行（左 4px accent）
- 路径用等宽字体；点击/长按复制，复制按钮 44px
交互与性能
Sheet 容器
showModalBottomSheet(
isScrollControlled: true,
useSafeArea: true,
backgroundColor: Colors.transparent,
→ DraggableScrollableSheet(0.92 / 0.42 / 1)
→ ClipRRect(topRadius: 20)
)
- 内容主滚动必须吃
DraggableScrollableSheet 的 scrollController，否则无法下滑关闭
- Controller 用
Get.put(..., tag:)，Sheet 关闭后 Get.delete(tag:)
首屏加速（强制）
- 禁止整页转圈等接口：打开瞬间用传入的
SubscribeItem 渲染 backdrop / 标题 / meta
onInit 即发起请求；列表区单独轻量 loading（「正在加载文件…」）- 打开前
precacheImage(NetworkImage(convertedBackdrop))
- 指标未返回时 chip 可显示
…，有 totalEpisode 可先填分集预估值
反模式（Avoid）
- 顶部再塞一块独立「大海报墙」与下方白底列表硬切
- 纯黑渐变盖死海报，或 alpha 过低导致浅色模式文字不可读
- 整 Sheet 阻塞在
loading && data == null 全屏 spinner
- 为该次级详情再注册独立 GetPage 路由（除非要深链分享）
- emoji / 过小复制按钮 / 路径与标题信息重复堆砌无层级
复用检查清单
