如何从多个文本条目创建 ZIP 压缩包

先了解输入方式

这个工具适合把一组文本内容整理成 ZIP 压缩包。例如，你可以为每段文本指定文件名，再一次生成一个包含多个文本文件的压缩包。若暂时不提供文件条目，工具会改用内置示例文本条目，并生成非空压缩包。

创建 ZIP 压缩包的步骤

1. 准备文件条目列表。每个条目填写文件名和文本内容；文件名用于确定压缩包内的名称，文本内容则是该文件的正文。
2. 将条目列表提交给工具。如果某个条目缺少文件名，工具会使用 file.txt；如果缺少文本内容，则使用空文本。
3. 选择压缩方式。未指定时使用 deflated。明确指定 deflated 时也使用 deflated；指定其他值时则采用 stored。
4. 执行创建操作，等待工具返回结果。若不传入文件条目列表，工具会使用内置示例条目，不需要另行准备文本。
5. 保存或传递返回的 base64 文本。需要查看压缩包信息时，同时记录返回的文件名、字节大小和条目数量。

如何理解返回结果

结果中的 base64 文本是创建出的 ZIP 压缩包数据，可用于后续保存或传输。返回信息还包括文件名 archive.zip、压缩包字节大小和其中的条目数量，便于确认输出是否包含预期数量的文本文件。

压缩方式需要按工具的选择规则理解：只有 deflated 会明确选择 deflated，其他值会进入 stored 分支。因此，不应把任意其他值解读为另一种已获支持的压缩格式。工具处理的是带名称和文本内容的文件条目，不应据此推断它支持其他条目类型或内容格式。

使用示例

你要把会议记录和待办事项整理成一个可传递的 ZIP 压缩包。

提交两个文件条目：第一个名称为 notes/today.txt、内容为一段会议记录；第二个名称为 todo.txt、内容为待办事项。选择 deflated 后执行创建操作，并检查返回的文件名与条目数量。

返回结果包含 base64 文本、文件名 archive.zip、字节大小和条目数量；本例的条目数量应为 2。

使用限制

• 压缩方式的选择仅明确支持 deflated 与 stored 两个分支：deflated 会选择 deflated，其他值会选择 stored。已知能力仅覆盖带名称和文本内容的文件条目，不应据此推断其他压缩格式、条目类型或内容格式。

常见错误

• 如果压缩包内出现 file.txt 或空文件，原因可能是条目遗漏了文件名或文本内容。提交前为每个条目明确填写这两项，并检查文件名是否符合预期。

常见问题

不提供文件列表也能创建 ZIP 吗？

可以，但只有在不提供文件条目列表时，工具才会使用内置示例文本条目并生成非空压缩包。

每个文本条目需要填写哪些内容？

可以。每个条目都可以提供文件名和文本内容；缺少文件名时使用 file.txt，缺少内容时使用空文本。

如何选择 ZIP 的压缩方式？

只有明确指定 deflated 时才选择 deflated；未指定时默认使用 deflated，其他值则选择 stored。