Ingest Archive Zip Extractor
Documentsingest_archive_zip_extractorIngest Archive Zip Extractor is an Agent Skill for documents published in the cas-bigdatalab/piflow repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
ZIP 压缩包解压工具。递归扫描目录内 .zip 文件及分卷（.z01/.z02 等），合并分卷后解压并输出解压清单。当用户需要批量解压 zip 或分卷 zip 时使用此 skill。不负责 7z、rar 等其他格式的解压。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/cas-bigdatalab/piflow/blob/HEAD/workspace/skills/ingest_archive_zip_extractor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ingest-archive-zip-extractor, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
ingest_archive_zip_extractor — ZIP 压缩包解压
功能概述
递归扫描目录内 .zip 文件，若存在同名前缀的 .z01/.z02/... 分卷文件，则合并后解压；否则按普通 zip 处理。输出解压清单与错误信息。
参数说明
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
--input_dir | 是 | 待解压目录（递归） | |
--output_dir | 是 | 解压输出根目录 | |
--report | 是 | 解压报告输出路径（JSON） | |
--max_entries | 否 | 0 | 单包最大解压文件数（0 不限） |
使用方法
python scripts/run_ingest_archive_zip_extractor.py \
--input_dir <input_dir> \
--output_dir <output_dir> \
--report <report.json>
环境要求
使用 Python 标准库 zipfile，无需额外依赖。