# LitePDFKit

**Repository Path**: hnnuxuan/lite-pdfkit

## Basic Information

- **Project Name**: LitePDFKit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LitePDFKit

一个轻量级的跨平台PDF处理CLI工具，支持PDF合并、拆分、压缩和信息查看功能。

<!-- 移除了logo引用 -->

## 功能特性

- **PDF合并**: 将多个PDF文件合并为一个PDF文件
- **PDF拆分**: 根据页码范围拆分PDF文件
- **PDF压缩**: 支持无损和有损压缩
- **信息查看**: 查看PDF文件的基本信息
- **跨平台**: 支持Windows、macOS和Linux
- **离线可用**: 无需网络连接即可使用

## 安装依赖

```bash
pip install -r requirements.txt
```

## 使用方法

### 查看帮助

```bash
python pdf_tool.py -h
```

![Help Command](images/help_command.png "Help Command Output")
*图1: 帮助命令输出 - 显示所有可用的子命令*

### PDF合并

```bash
python pdf_tool.py merge -o out.pdf in1.pdf in2.pdf ...
```

![Merge PDFs](images/merge_example.png "Merge PDFs Example")
*图2: PDF合并示例 - 将多个PDF文件合并为一个*

### PDF拆分

```bash
python pdf_tool.py split in.pdf -r "1-3,5,-1" -o out_dir
```

![Split PDF](images/split_example.png "Split PDF Example")
*图3: PDF拆分示例 - 根据页码范围拆分PDF文件*

### PDF压缩

```bash
python pdf_tool.py compress in.pdf -o out.pdf -l lossless|medium|high [--dpi 150] [--quality 70]
```

![Compress PDF](images/compress_example.png "Compress PDF Example")
*图4: PDF压缩示例 - 有损压缩大幅减小文件大小*

### 查看PDF信息

```bash
python pdf_tool.py info in.pdf
```

![PDF Info](images/info_example.png "PDF Info Example")
*图5: PDF信息查看示例 - 显示PDF文件的详细信息*

## 参数说明

### 页码范围语法

- 逗号分隔多个范围
- 闭区间表示法，如"1-3"表示第1页到第3页
- 支持"-1"表示最后一页
- 支持"7-"表示第7页到末尾

### 压缩等级

- `lossless`: 无损压缩，使用pypdf压缩内容流、移除元数据/嵌入文件
- `medium`: 中等压缩，如安装了PyMuPDF，优先对图片重采样与有损重压；否则回退到`lossless`
- `high`: 高压缩，如安装了PyMuPDF，优先对图片重采样与有损重压；否则回退到`lossless`

## 性能表现

### 压缩效果示例

1. **文本PDF文件**:
   - 原始大小：2326字节
   - 压缩后大小：2030字节
   - 压缩率：12.73%

2. **图像PDF文件**:
   - 原始大小：360794字节
   - 压缩后大小：24284字节
   - 压缩率：93.27%

![Compression Results](images/compression_results.png "Compression Results")
*图6: 压缩效果对比 - 展示不同类型PDF文件的压缩效果*

## 开发指南

### 项目开发提示词

本项目的开发过程遵循一系列提示词指导，详细信息请参阅 [LitePDFKit项目开发提示词.md](LitePDFKit项目开发提示词.md) 文件。

### 运行测试

```bash
python -m pytest tests/
```

### 查看变更日志

参考 [CHANGELOG.md](CHANGELOG.md) 文件

## 项目信息

- **创建日期**: 2025年9月29日
- **最后更新**: 2025年9月29日
- **作者**: Yuxuan (余珝安)
- **邮箱**: yuxuan6426@foxmail.com
- **Gitee主页**: https://gitee.com/hnnuxuan

## 许可证

本项目采用MIT许可证，详情请参阅 [LICENSE](LICENSE) 文件。
MIT License