---
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。