# pyzipper

**Repository Path**: ssssllll/pyzipper

## Basic Information

- **Project Name**: pyzipper
- **Description**: pyzipper：一个专注于Python压缩文件处理的开源项目，提供高效、易用的API，支持ZIP格式的各种操作，适用于数据备份、传输等场景。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🗜️ PyZipper 使用文档

> 一款类似 7-Zip 的跨平台压缩文件管理工具
> 
> 开发者: ccli | 邮箱: 2584953999@qq.com
> 
> 🆓 免费使用，请勿商业用途

---

## 📋 目录

1. [软件简介](#软件简介)
2. [安装说明](#安装说明)
3. [界面介绍](#界面介绍)
4. [基本操作](#基本操作)
5. [高级功能](#高级功能)
6. [快捷键大全](#快捷键大全)
7. [常见问题](#常见问题)

---

## 软件简介

PyZipper 是一款现代化的压缩文件管理工具，采用深色主题设计，支持直接浏览和编辑压缩包内容，无需完全解压即可进行文件操作。

### 支持的格式

| 格式 | 扩展名 | 读取 | 写入 |
|------|--------|------|------|
| ZIP | .zip | ✅ | ✅ |
| JAR | .jar | ✅ | ✅ |
| TAR | .tar | ✅ | ✅ |
| TAR.GZ | .tar.gz, .tgz | ✅ | ✅ |
| TAR.BZ2 | .tar.bz2, .tbz2 | ✅ | ✅ |

### 主要特性

- 🎨 现代深色 UI 界面
- 📦 支持多种压缩格式
- 👁️ 内置文件预览（文本、图片）
- 🔍 实时搜索过滤
- 📂 嵌套压缩包支持
- ⌨️ 丰富快捷键
- 🕐 最近打开记录
- 📊 压缩包统计分析

---

## 安装说明

### Windows

1. 下载 `PyZipper-Windows.zip`
2. 解压到任意目录
3. 双击 `PyZipper.exe` 运行

### macOS

1. 下载 `PyZipper-macOS.zip`
2. 解压得到 `PyZipper.app`
3. 将应用拖入「应用程序」文件夹
4. 首次运行如提示安全警告，请在「系统偏好设置 → 安全性与隐私」中允许

### Linux

1. 下载 `PyZipper-Linux.tar.gz`
2. 解压: `tar -xzvf PyZipper-Linux.tar.gz`
3. 运行: `./PyZipper/PyZipper`

### 从源码运行

```bash
# 安装 Python 3.8+
# 克隆或下载源码

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install PyQt6

# 运行
python run.py
```

---

## 界面介绍

```
┌─────────────────────────────────────────────────────────────┐
│  🗜️ PyZipper | 👨‍💻 开发者: ccli | 📧 邮箱 | 🆓 免费  [❤️ 赞赏] │  ← 标题栏
├─────────────────────────────────────────────────────────────┤
│ [⬅️返回][📂打开][🕐最近][📦新建][➕添加][📁文件夹][📂新建目录]... │  ← 工具栏
├─────────────────────────────────────────────────────────────┤
│              📥 拖放文件到此处添加到压缩包                      │  ← 拖放区
│                 或拖放压缩包打开 / 双击打开                     │
├─────────────────────────────────────────────────────────────┤
│ [🔍 搜索文件名...]  [按名称排序 ▼] [📂展开] [📁折叠] [📊统计]  │  ← 搜索栏
├─────────────────────────────────────────────────────────────┤
│ 名称                    │ 大小      │ 压缩大小  │ 修改时间    │
│─────────────────────────┼───────────┼───────────┼─────────────│
│ 📁 src/                 │           │           │             │  ← 文件列表
│   ☕ Main.java          │ 2.5 KB    │ 1.2 KB    │ 2024-01-01  │
│   📋 config.xml         │ 512 B     │ 256 B     │ 2024-01-01  │
│ 📦 lib.jar              │ 1.5 MB    │ 1.2 MB    │ 2024-01-01  │
├─────────────────────────────────────────────────────────────┤
│ 📊 25 个文件, 5 个文件夹                                      │  ← 状态栏
└─────────────────────────────────────────────────────────────┘
```

### 文件图标说明

| 图标 | 类型 |
|------|------|
| 📁 | 文件夹 |
| 📦 | JAR 压缩包 |
| 🗜️ | ZIP/TAR 压缩包 |
| ☕ | Java 文件 |
| 🐍 | Python 文件 |
| 📋 | XML 文件 |
| 📊 | JSON/YAML 文件 |
| 🖼️ | 图片文件 |
| 📄 | 其他文件 |

---

## 基本操作

### 打开压缩包

**方式一：拖放**
- 将压缩包文件拖放到窗口中

**方式二：双击拖放区**
- 双击顶部拖放区域，弹出文件选择对话框

**方式三：工具栏**
- 点击「📂 打开」按钮

**方式四：快捷键**
- 按 `Ctrl+O`

**方式五：最近记录**
- 点击「🕐 最近」按钮，选择最近打开的文件

### 浏览文件

- 文件以树形结构显示
- 点击文件夹前的箭头展开/折叠
- 使用「📂 展开」「📁 折叠」按钮快速操作全部

### 预览文件

**双击文件** 或 **选中后按 Enter**

支持预览的文件类型：
- 文本文件：.txt, .md, .json, .xml, .java, .py, .js 等
- 图片文件：.png, .jpg, .gif, .bmp 等

预览窗口支持语法高亮显示代码。

### 添加文件

1. 打开或创建压缩包
2. （可选）选中目标文件夹
3. 点击「➕ 添加文件」或「📁 添加文件夹」
4. 选择要添加的文件

**拖放添加：**
- 直接将文件拖放到文件列表区域

### 删除文件

1. 选中要删除的文件（支持多选，按住 Ctrl 点击）
2. 点击「🗑️ 删除」或按 `Delete` 键
3. 确认删除

### 解压文件

**解压选中：**
1. 选中要解压的文件
2. 点击「📤 解压选中」
3. 选择目标目录

**解压全部：**
- 点击「📤 解压全部」或按 `Ctrl+E`

**解压到当前目录：**
- 右键菜单选择「📤 解压到当前目录」
- 自动解压到压缩包所在目录

### 创建压缩包

1. 点击「📦 新建」或按 `Ctrl+N`
2. 选择保存位置和格式
3. 添加文件到新压缩包

---

## 高级功能

### 嵌套压缩包

当压缩包内包含其他压缩包（如 ZIP 中的 JAR）时：

1. 双击内部压缩包
2. 自动在同一窗口打开
3. 点击「⬅️ 返回」或按 `Backspace` 返回上一级
4. 状态栏显示导航路径：`📍 outer.zip → inner.jar`

### 搜索过滤

1. 在搜索框输入关键词
2. 实时过滤显示匹配的文件
3. 支持模糊匹配
4. 按 `Ctrl+F` 快速聚焦搜索框

### 排序功能

点击排序下拉框选择：
- 按名称排序
- 按大小排序
- 按时间排序

### 统计信息

点击「📊 统计」按钮查看：
- 文件/文件夹数量
- 原始大小/压缩大小
- 压缩率
- 文件类型分布 Top 10

### 右键菜单

选中文件后右键点击：

| 选项 | 功能 |
|------|------|
| 📦 打开压缩包 | 打开嵌套的压缩包 |
| 👁️ 预览 | 内置预览文件 |
| 🚀 用系统程序打开 | 调用系统默认程序 |
| 📤 解压到... | 选择目录解压 |
| 📤 解压到当前目录 | 解压到压缩包所在目录 |
| 📋 复制路径 | 复制文件路径到剪贴板 |
| 🗑️ 删除 | 删除选中文件 |
| ✏️ 重命名 | 重命名文件 |
| 📂 新建文件夹 | 创建新目录 |

### 新建文件夹

1. （可选）选中目标父文件夹
2. 点击「📂 新建目录」或右键选择
3. 输入文件夹名称

---

## 快捷键大全

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+O` | 打开压缩包 |
| `Ctrl+N` | 新建压缩包 |
| `Ctrl+F` | 聚焦搜索框 |
| `Ctrl+E` | 解压全部 |
| `Ctrl+A` | 全选文件 |
| `Ctrl+W` | 关闭当前压缩包 |
| `Delete` | 删除选中文件 |
| `Backspace` | 返回上一级（嵌套压缩包） |
| `F5` | 刷新文件列表 |
| `Enter` | 预览选中文件 |
| `双击` | 预览文件 / 打开嵌套压缩包 |

---

## 常见问题

### Q: 为什么打开大型压缩包很慢？

A: 首次打开需要读取压缩包索引，这是正常现象。后续操作会很快。

### Q: 修改后需要保存吗？

A: 不需要。所有修改（添加、删除、重命名）都会立即生效，自动保存到压缩包。

### Q: 支持加密压缩包吗？

A: 当前版本暂不支持加密压缩包，后续版本会添加此功能。

### Q: 如何打开 .rar 文件？

A: 当前版本不支持 RAR 格式，建议使用 ZIP 或 7z 格式。

### Q: macOS 提示"无法打开，因为无法验证开发者"？

A: 
1. 打开「系统偏好设置」→「安全性与隐私」
2. 点击「仍要打开」
3. 或者右键点击应用，选择「打开」

### Q: Linux 下无法运行？

A: 确保安装了必要的依赖：
```bash
sudo apt-get install libxcb-cursor0
```

### Q: 如何关联文件类型？

**Windows:**
1. 右键点击 .zip 文件
2. 选择「打开方式」→「选择其他应用」
3. 选择 PyZipper.exe
4. 勾选「始终使用此应用」

**macOS:**
1. 右键点击 .zip 文件
2. 选择「显示简介」
3. 在「打开方式」中选择 PyZipper
4. 点击「全部更改」

---

## 版本历史

### v1.0.0 (2025)
- 🎉 首次发布
- 支持 ZIP/JAR/TAR 格式
- 内置文件预览
- 搜索过滤功能
- 嵌套压缩包支持
- 快捷键支持
- 最近打开记录
- 压缩包统计

---

## 联系与反馈

- 👨‍💻 开发者: ccli
- 📧 邮箱: 2584953999@qq.com
- ❤️ 如果觉得好用，欢迎赞赏支持！

---

*感谢使用 PyZipper！*