Files
2026-09-20 16:44:22 +08:00

32 lines
1.2 KiB
Plaintext

---
title: 概览
description: 了解 Media 包、存储边界以及它负责的媒体工作流。
order: 1
toc:
- id: package-role
title: 包的职责
- id: capabilities
title: 功能范围
- id: design-boundary
title: 设计边界
---
## 包的职责 {#package-role}
`@workspace/media` 提供可复用的媒体库和资源选择界面。宿主应用通过 `MediaAdapter` 提供持久化能力;Media 负责浏览、筛选、分页、上传、目录、选择和资源操作。
## 功能范围 {#capabilities}
- 通过搜索、筛选、目录、收藏和分页浏览图片与视频。
- 上传到 Adapter 暴露的本地或云端存储目标。
- 创建、重命名、嵌套和删除分类目录。
- 通过 `MediaPickerDialog` 单选或多选资源。
- 分别解析展示 URL 和稳定引用。
- 提供 `en-US` 与 `zh-Hans` 消息词典。
## 设计边界 {#design-boundary}
Media 不会替应用选择 API、数据库、对象存储、CDN 或签名策略。应用在 `MediaAdapter` 后实现这些决策,替换实现时无需修改界面组件。
> 目录只用于媒体库内部分类,不必对应对象存储路径,也不需要改变公开 URL。