# 媒体目录辅助

`fsys.openXml.media` 是 PPTX/DOCX/XLSX 共用的目录枚举和原始字节导出实现。常规任务使用 `fsys.openXml.pptx/docx/xlsx` 各自的媒体入口，同时完成文档类型识别和包的关闭。

本模块接收已打开的 `fsys.openXml` 包对象，不自行打开或关闭包，不依赖 Office 或具体的内容读取器。底层导出仍使用 `pkg.extractPart`。

## list(pkg,mainPart,standardDir)

- `mainPart` 为主部件的包内 URI。
- `standardDir` 为该格式的标准媒体目录，包含末尾 `/`，例如 `word/media/`、`ppt/media/` 或 `xl/media/`。
- 返回标准目录及主部件同级 `media/` 下的文件，按包清单顺序；含子目录和未引用项，不含目录项。
- 数组项为 `partName,name,ext,size,compressedSize,contentType`。
- 不读取媒体内容，也不从所有关系构建媒体引用图，不访问外链。

## extract(pkg,parts,outputDir,options,maxFiles)

- `parts` 为 `list` 返回的数组。使用调用者已经打开的同一个包。
- 以末级文件名平铺导出，同名（忽略大小写）在写入前拒绝。
- `options.overwrite` 默认 false；已有普通文件记入 `skipped`，不重新读取/校验。
- 可选 `maxFiles` 为非负整数，限制成功导出数，跳过不计数；0 不导出。达到限额且仍有剩余项则设置 `truncated=true`。
- 成功返回 `{outputDir,files,skipped}`，文件项额外含 `source` 与完整输出 `path`。
- 失败返回 `null,err,partial`；每个文件经 CRC/长度/限额校验后用临时文件提交，但整批不是事务，不回滚此前成功项。
- 源件保护、设备文件名拒绝和写入失败清理均由通用 `extractPart` 实现。资源只作为数据复制，不执行或转码。

调用者负责保持包有效并在成功/失败时关闭。不要将目录媒体提取等同于任意部件解压、完整媒体发现或整包验证。当前读取一个完整部件到有大小上限的内存，不是无限制流式导出。