# invoice

**Repository Path**: ranjing/invoice

## Basic Information

- **Project Name**: invoice
- **Description**: 一个现代化的桌面批量打印应用
支持 macOS 和 Windows | 基于 PySide6 开发
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 批量打印工具

<div align="center">

<img src="assets/logo.png" alt="批量打印工具" width="200"/>

**一个现代化的桌面批量打印应用**

支持 macOS 和 Windows | 基于 PySide6 开发

[快速开始](docs/快速开始.md) • [查看文档](docs/) • [报告问题](https://gitee.com/ranjing/invoice/issues)

</div>

---

## 🌟 特性

### 核心功能

- 📋 **批量打印** - 一次性打印多个 PDF 和图片文件
- 🖱️ **拖放支持** - 直接拖入文件即可添加到列表
- ⚙️ **完整设置** - 纸张大小、方向、份数、双面、彩色等
- 📊 **队列管理** - 查看和管理打印队列
- 🗑️ **快捷操作** - 单个删除、批量删除、清空列表

### 界面特点

- 🎨 **现代化 UI** - 精美的 PySide6 界面
- 📋 **表格展示** - 清晰显示文件名、路径、大小
- 💡 **实时反馈** - 文件统计和状态提示
- 🌈 **QSS 样式** - 优雅的视觉效果

### 跨平台支持

- 🍎 [**macOS**](https://gitee.com/ranjing/invoice/releases/tag/v1.0.0) - 完美支持 macOS 10.14+
- 🪟 [**Windows**](https://gitee.com/ranjing/invoice/releases/tag/v1.0.0) - 完美支持 Windows 10/11

## 🚀 快速开始

### macOS

```bash
git clone https://gitee.com/your-username/batch-print-tool.git
cd batch-print-tool
pip3 install PySide6
python3 src/print_tool.py
```

### Windows

```cmd
git clone https://gitee.com/your-username/batch-print-tool.git
cd batch-print-tool
pip install PySide6 pywin32
python src\print_tool_windows.py
```

详细说明：[快速开始文档](docs/快速开始.md)

## 📦 下载

### 预编译版本（推荐）

直接下载安装包使用：

- 🍎 [macOS DMG](https://gitee.com/ranjing/invoice/releases/tag/v1.0.0) - 双击安装
- 🪟 [Windows EXE](https://gitee.com/ranjing/invoice/releases/tag/v1.0.0) - 双击运行

### 从源码运行

查看[安装文档](docs/快速开始.md)

## 📸 应用截图

<img src="assets/run1.png" alt="批量打印工具" width="800"/>

## 💻 系统要求

| 系统      | 最低版本   | Python | 备注         |
|---------|--------|--------|------------|
| macOS   | 10.14+ | 3.9+   | 推荐 3.11    |
| Windows | 10/11  | 3.9+   | 需要 pywin32 |

## 📖 文档

- [快速开始](docs/快速开始.md) - 5 分钟上手
- [macOS 打包](docs/macOS打包说明.md) - 打包 DMG 安装包
- [Windows 打包](docs/Windows打包说明.md) - 打包 EXE 程序
- [跨平台打包](docs/跨平台打包指南.md) - 多平台打包方案
- [项目结构](docs/项目结构.md) - 代码组织说明

## 🛠️ 开发

### 安装依赖

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

### 运行测试

```bash
# 诊断打印机
python tools/check_printer.py

# 测试图标
python tools/test_icon.py
```

### 打包应用

**macOS**:

```bash
cd scripts/macos
./build_dmg.sh
```

**Windows**:

```cmd
cd scripts\windows
build_exe.bat
```

## 🤝 参与贡献

欢迎提交 Pull Request！

请阅读[贡献指南](CONTRIBUTING.md)了解详情。

## 📝 更新日志

查看[CHANGELOG.md](CHANGELOG.md)了解版本更新内容。

## ❓ 常见问题

**Q: 为什么有两个版本的代码？**

- A: macOS 和 Windows 的打印机管理方式完全不同，分开维护更稳定。

**Q: Windows 版本找不到打印机？**

- A: 确保 Python >= 3.9，安装 `pywin32`：`pip install pywin32`

**Q: macOS 应用打不开？**

- A: 右键点击 → 打开 → 仍要打开

更多问题查看[快速开始](docs/快速开始.md)

## 📄 开源协议

[MIT License](LICENSE) © 2024

## 🙏 致谢

- [PySide6](https://www.qt.io/qt-for-python) - Qt for Python
- [PyInstaller](https://www.pyinstaller.org/) - 应用打包
- [Pillow](https://python-pillow.org/) - 图像处理

---

<div align="center">

**如果觉得有用，请点个 ⭐️ Star 支持一下！**

[报告问题](https://gitee.com/your-username/batch-print-tool/issues) • [功能建议](https://gitee.com/your-username/batch-print-tool/issues/new)

</div>