archive-handler

name	archive-handler
description	安全通用的压缩文件处理工具。支持 ZIP/RAR/7z/TAR/TAR.GZ 格式的解压、内容预览和文件提取，无网络依赖，本地安全处理。

Archive Handler Skill

安全、通用的压缩文件处理工具。专为满意解研究所定制，满足日常文件交互需求，同时保持完全自主可控。

核心原则

1. 本地处理 — 无网络调用，不上传任何数据
2. 安全第一 — 解压前扫描，限制敏感路径写入
3. 格式全覆盖 — ZIP/RAR/7z/TAR/TAR.GZ/BZ2/XZ
4. 只读优先 — 默认预览内容，显式确认后才解压

使用方式

1. 安全预览（推荐）

先查看压缩包内容，不实际解压：

python3 /root/.openclaw/workspace/skills/archive-handler/archive_handler.py preview <压缩包路径>

返回内容：

• 文件列表（含路径、大小、类型）
• 压缩格式识别
• 安全风险评估（是否有可执行文件、隐藏文件等）

2. 智能解压

解压到指定目录（默认为 ./extracted_<文件名>/）：

python3 /root/.openclaw/workspace/skills/archive-handler/archive_handler.py extract <压缩包路径> [目标目录]

安全特性：

• 自动检测路径遍历攻击（../ 等）
• 限制单文件最大解压尺寸（默认 100MB）
• 限制总解压尺寸（默认 1GB）
• 禁止写入系统敏感路径

3. 指定文件提取

只提取需要的文件：

python3 /root/.openclaw/workspace/skills/archive-handler/archive_handler.py extract-single <压缩包路径> <包内文件路径> [目标目录]

4. 批量处理

处理目录下的所有压缩包：

python3 /root/.openclaw/workspace/skills/archive-handler/archive_handler.py batch <目录路径> [目标目录]

安全策略

自动阻止的行为

• 路径遍历（../../../etc/passwd 等）
• 绝对路径写入（/etc/、C:\Windows 等）
• 符号链接指向外部路径
• 单文件超过 100MB
• 总解压超过 1GB