# invoke-helper

**Repository Path**: yabar/invoke-helper

## Basic Information

- **Project Name**: invoke-helper
- **Description**: 发票处理助手
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 发票处理工具

这是一个功能强大的发票批量处理桌面应用程序，能够自动解析发票PDF文件名中的日期、金额和报销人信息，并生成结构化的报表和可视化图表。

## 核心功能

- **智能文件名解析**：支持多种发票文件名格式自动识别
- **自定义匹配规则**：允许用户自定义正则表达式模式进行精确匹配
- **日期范围过滤**：支持按日期范围筛选发票数据
- **多格式报表导出**：可生成Excel、CSV、JSON格式的报表
- **数据可视化**：自动生成发票金额统计图表
- **高性能处理**：采用多线程处理技术，避免界面卡顿
- **友好的用户界面**：基于PyQt5开发的直观易用界面

## 支持的文件名格式

- 日期_金额_报销人.pdf（如：2024年01月15日_198.50元_张三.pdf）
- 日期_报销人_金额.pdf（如：2024年01月15日_张三_198.50元.pdf）
- 报销人_日期_金额.pdf（如：张三_2024年01月15日_198.50元.pdf）
- 2024-01-15_张三_198.50.pdf格式
- 20240115_张三_198.50.pdf格式
- 其他常见发票文件名格式

## 安装要求

- Python 3.7 或更高版本
- PyQt5 (GUI框架)
- PyMuPDF (PDF文件处理)
- openpyxl (Excel报表生成)

## 安装步骤

1. 克隆或下载项目到本地

2. 安装依赖包：
```bash
pip install -r requirements.txt
```

## 使用说明

1. 运行应用程序：
```bash
python invoke-helper.py
```

2. 在应用界面中：
   - 点击"选择文件夹"按钮，选择包含发票PDF文件的目录
   - 可选：在"自定义模式"中输入正则表达式进行精确匹配
   - 可选：设置"开始日期"和"结束日期"进行范围过滤
   - 点击"预览数据"查看解析结果
   - 选择导出格式（CSV/JSON/Excel）
   - 点击"开始处理"生成报表

## 生成的报表内容

- **发票明细**：包含所有解析后的发票详细信息
- **统计汇总**：按日期和人员进行统计的汇总数据
- **数据可视化**：自动生成的金额统计图表

## 技术架构

- **GUI框架**：PyQt5
- **文件处理**：os, re, PyMuPDF
- **数据处理**：csv, json, openpyxl
- **多线程**：QThread

## 注意事项

- 确保发票文件名包含日期、金额和报销人信息
- 建议使用统一的文件名命名规则以提高解析准确率
- 对于特殊格式的文件名，可以使用自定义正则表达式

## 许可证

本项目使用MIT许可证。详情请查看LICENSE文件。