压缩包预览、选择性提取与格式转换

目标与适用范围

预览支持的压缩包，提取一个已核对的成员文件，并转换结果格式。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 只处理获授权的压缩包，每个输入不超过 100 MB。

• 先预览；只使用预览中的精确相对成员路径，拒绝含 ..、绝对路径、盘符前缀、NUL 或 shell 语法的路径。

• 决策点: 应选择哪个工具和路径？. 按格式使用 zip-preview、7z-preview、tar-preview、tar-gz-preview 或 gzip-preview，再选择对应的选择性提取器或 zip-to-、tar-to-、7z-to-* 转换器；路径必须从预览复制，不能使用主机操作系统路径。

按步骤完成工作流

1. 预览

列出压缩包，处理前记录成员路径、数量和大小。 使用 zip-preview, 7z-preview, tar-preview, tar-gz-preview, gzip-preview.

2. 选择性提取

复制一个已核对的相对路径，只提取该成员；无需选择成员的 GZIP 使用 gzip-extractor。 使用 zip-selective-extract, 7z-selective-extract, tar-selective-extract, tar-gz-selective-extract, gzip-extractor.

3. 转换并验收

选择源格式到目标格式的转换器，检查返回格式和大小，并再次预览压缩包结果。 使用 zip-to-7z-converter, zip-to-gz-converter, zip-to-tar-converter, tar-to-7z-converter, tar-to-gz-converter, tar-to-zip-converter, 7z-to-gz-converter, 7z-to-tar-converter, 7z-to-zip-converter.

交付前验收结果

• 预览记录预期成员、数量和大小，每个输入不超过 100 MB 且使用安全相对路径。
• 提取或转换返回非空结果，并具有预期文件名或目标格式及大小；交付前再次预览压缩包输出。

常见问题

• 预览会扫描恶意软件吗？ 不会。预览只列出压缩包信息和成员，不是恶意软件扫描。
• 什么是安全路径？ 使用预览中的精确相对成员路径，拒绝 ..、绝对路径或盘符路径、NUL 和 shell 语法。
• 大小限制是多少？ 每个工具公开的输入文件限制为 100 MB；展开后和输出大小没有统一公布的限制。