小紫压缩解压

v1.1.0 · 办公自动化 · 官方

压缩解压 ZIP 打包备份归档办公小紫

简介

小紫压缩解压插件让 AI 员工帮你 打包 ZIP/TAR、解压 ZIP/TAR/RAR/7z、查看压缩包内容。

ZIP/TAR 使用 Python 标准库，无需 pip。 RAR/7z 解压需本机安装 7-Zip（Windows 安装后一般即可用）。支持 Windows / macOS / Linux。

谁需要安装？ 需要 AI 帮忙压缩文件夹、解压收到的 zip、查看压缩包里有哪些文件的用户。

包含能力

action	功能
`zip`	压缩为 .zip
`tar`	打包为 .tar / .tar.gz 等
`unzip`	解压 zip/tar/rar/7z（自动识别）
`list`	查看压缩包内容（自动识别）
`info`	检查各格式支持情况

格式	压缩	解压
ZIP	✅	✅
TAR / tar.gz / tar.bz2 / tar.xz	✅	✅
RAR	❌	✅（需 7-Zip）
7z	❌	✅（需 7-Zip）

只需注册 1 个技能 archive_tool，用 action 区分功能。

适用场景

资料归档：把项目文件夹、周报文档打包备份
解压附件：收到 zip 后一键解压到指定目录
先看再解压：列出压缩包内容，确认无误再解压
配合清理：大文件先压缩归档，再删除原文件（可配合磁盘清理插件）
内网传输：日志、报表压缩后推送

安装步骤

1. 下载解压

下载对应系统版本，解压到固定目录，例如：

D:\xiaozi-plugins\办公自动化\压缩解压插件\

解压后应包含：archive_plugin.py、run.bat（或 run.sh）、python/ 文件夹。

2. 测试

在插件目录打开命令行，执行：

run.bat --action info

看到 "success": true 即表示安装成功。

其他测试：

run.bat --action zip --source D:\test\demo.txt --output D:\test\demo.zip
run.bat --action list --archive D:\test\demo.zip
run.bat --action unzip --archive D:\test\demo.zip --output_dir D:\test\extracted

注册技能（供 AI 调用）

打开小紫工作台 → 技能 → 添加技能。

技能名称

archive_tool

技能描述

压缩解压 v1.1。zip/tar 压缩；unzip/list 自动识别 zip、tar、rar、7z。rar/7z 解压需本机 7-Zip。用户打包、解压附件、查看压缩包时使用。

脚本路径（改成你的实际路径）

D:\xiaozi-plugins\办公自动化\压缩解压插件\run.bat

参数 JSON

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["zip", "tar", "unzip", "list", "info"], "description": "操作类型"},
    "source": {"type": "string", "description": "zip 单个文件或目录路径"},
    "sources": {"type": "string", "description": "zip 多个路径，逗号分隔或 JSON 数组"},
    "output": {"type": "string", "description": "zip 输出 .zip 路径"},
    "archive": {"type": "string", "description": "unzip/list 的 zip 文件路径"},
    "filepath": {"type": "string", "description": "archive 别名"},
    "output_dir": {"type": "string", "description": "unzip 解压目标目录"},
    "compression": {"type": "string", "description": "zip 压缩方式：deflated(默认) 或 store"}
  },
  "required": ["action"]
}

AI 怎么说

帮我把 D:\docs 文件夹打包成 zip
解压 D:\download\附件.zip 到 D:\extract
看看 D:\backup\data.zip 里面有什么文件
把这个目录压缩备份一下

常见错误

现象	处理
python folder missing	复制完整插件包（含 python 文件夹）
路径不存在	检查 source / archive 路径是否正确
不是有效的 ZIP 文件	确认文件未损坏，且为 .zip 格式
解压失败 / 非法路径	压缩包可能含恶意路径，插件已拦截
压缩包为空	检查 source 目录是否有文件

能力边界

已支持	暂不支持
ZIP / TAR 压缩解压列表	创建 RAR（专有格式）
RAR / 7z 解压（需 7-Zip）	加密 zip、分卷压缩
自动识别格式	在线云盘直接操作
Zip/Tar Slip 安全防护	图形界面拖拽操作
Win / macOS / Linux	—

配合：磁盘清理插件（归档后清理）· 文件格式转换 · 内网推送

小紫 压缩解压

简介