发票排版与打印（InvoiceLayoutAndPrinting）

一个用于将多张 PDF 发票按“上下双页”方式自动合并、预览与打印的桌面工具。基于 Python、PyQt6 与 pypdf，支持一键打包为单文件可执行程序（Nuitka）。

功能概述

• 导入单个 PDF 或目录中的所有文件（拖拽或文件选择），支持 PDF/OFD/XML
• 文件列表仅显示文件名，支持拖拽排序，右侧系统风格“关闭”图标一键移除
• 排版方式：单页、双页（上下/左右）、四宫格，以及自定义“行×列”网格
• 切割线：双页/宫格布局可在合成页中间添加切割线
• 预览窗口支持多页滚动查看，自动适配宽度，可缩放并显示页码
• 打印：优先 SumatraPDF 打印对话框（如安装）；可选择指定打印机由 SumatraPDF 直印
• 界面偏好（布局、输出目录、窗口尺寸等）自动记忆，下次启动恢复
• 兼容不同尺寸与裁剪框的发票 PDF，修复印章（PDF 注释）在合成后位置偏移的问题

快速开始

环境准备

项目使用 uv 管理依赖与运行；若未安装 uv，可使用 Python 原生虚拟环境与 pip。

• 使用 uv：

  • 安装依赖：uv sync
  • 运行 GUI：uv run python main.py --gui
  • 命令行排版：uv run python main.py -i <PDF或目录> -o <输出目录> --no-print

• 使用虚拟环境与 pip：

  • 创建虚拟环境：python -m venv .venv
  • 安装依赖：.venv\Scripts\python -m pip install -U pip nuitka pyqt6 pypdf
  • 运行 GUI：.venv\Scripts\python main.py --gui

项目脚本

• Makefile（Windows 环境适配，内部调用 PowerShell 执行 Python）：
  • 安装依赖：make install
  • 打包可执行文件：make package（生成 dist/发票排版与打印.exe）
  • 运行程序：make run
  • 清理构建产物：make clean

使用说明

• 添加发票：拖拽 PDF 到左侧卡片或点击“+ 添加发票”选择文件/目录
• 文件列表：
  • 仅显示文件名（悬停显示完整路径）
  • 右侧“关闭”图标可移除条目
  • 支持拖拽排序，列表当前顺序决定合并后的页序
• 排版：点击“🧩 排版”生成合并后的 PDF（默认输出到源目录，或指定输出目录）
• 打印：勾选“排版后打印”，或在右侧点击“🖨 打印”
• 预览：排版完成后自动加载合并文件，多页滚动查看

技术细节

• 分层：pipeline.py 承载 CLI 与 GUI 共用的编排（读取/转换 → 车票识别 → 合成 → 写出 → 打印），不依赖 Qt；main.py 的批处理与 gui_workers.py 的后台线程都是它的调用方，流水线只定义一次
• 合成逻辑在 layoutInvoice.py：
  • two_up_vertical_pages(pages) 按两页一组竖向合成；宽度取两页最大值，高度为两页高度和
  • 使用每页的 cropbox 对齐坐标系，保证不同来源 PDF 的布局一致
  • 对 PDF 注释（/Annots，如电子印章）进行同步平移与复制，确保印章位置在合成后仍处于票头处
• GUI 在 gui.py（主窗口组装），后台线程与偏好持久化拆分在 gui_workers.py / gui_preferences.py / gui_widgets.py：
  • 文件列表使用 QListWidget 自定义行控件，支持拖拽排序、系统图标删除按钮
  • 预览使用 QPdfDocument + QPdfView，启用 MultiPage 模式与 FitToWidth
• 打印在 printInvoice.py：
  • 优先 SumatraPDF 的命令行打印对话框（支持便携版放在 exe 旁）；其次系统 print 动词/PowerShell，Edge 与默认查看器兜底；策略链以 strategies 参数注入，便于测试
  • 所有外部程序均以非阻塞方式启动，不卡界面

常见问题

• 路径包含特殊字符（如 &）：命令行中会被当作分隔符；本项目的 Makefile 已通过在 PowerShell 中调用虚拟环境 Python 并对参数加引号进行规避
• 预览只显示第一页：已启用 QPdfView.PageMode.MultiPage，滚动可见所有页
• 拖拽排序时底部出现黑色条带：
  • 原因：窗口初始化后列表行控件宽度未与视口完全同步，拖拽重绘时暴露未绘制区域
  • 处理：关闭横向滚动、逐像素滚动、为行容器设置背景，并在列表 Resize 时重新计算标签省略宽度；最大化或适当调整窗口尺寸也可使现象消失

目录结构

InvoiceLayoutAndPrinting/
├─ gui.py                 # 主窗口组装与入口（MainWindow、run_gui）
├─ gui_workers.py         # GUI 后台线程（读取/合成，薄封装 pipeline）
├─ gui_preferences.py     # QSettings 偏好持久化
├─ gui_widgets.py         # 可复用小部件（拖拽导入区）
├─ pipeline.py            # CLI/GUI 共用编排（读取 → 识别 → 合成 → 写出 → 打印）
├─ main.py                # CLI 与 GUI 入口
├─ layoutInvoice.py       # 合成与注释处理逻辑
├─ printInvoice.py        # 打印实现（可注入策略链）
├─ readInvoice.py         # 读取与收集 PDF
├─ Makefile               # 构建与打包
├─ pyproject.toml         # 依赖与项目配置
├─ uv.lock                # uv 锁文件
├─ icon.ico               # 应用图标
└─ README.md              # 项目说明

打包说明（Nuitka）

• 单文件打包、禁用控制台、启用 PyQt6 插件，保留图标与元信息；构建后产物为 dist/发票排版与打印.exe
• 版本号以 pyproject.toml 的 version 为唯一来源：CI 用 tomllib 自动读取，Makefile 用 make version 查看自动补齐的四段格式
• 自动发版：把 pyproject.toml 的 version 改好并合入 main 即可，CI 会自动创建 v{version} 标签、构建 exe 并发布 GitHub Release；版本未变时只运行测试，无需手动打 tag
• 发布说明自动生成：CI 用 git-cliff 按 cliff.toml 从 Conventional Commits 生成中文分组说明（feat/fix/perf/refactor，docs/ci/chore 等不列入）；Release 附件为 InvoiceLayoutAndPrinting-<版本>.exe
• 执行：make package
• 打包后的 exe 无控制台，运行日志写入 %LOCALAPPDATA%\InvoiceLayoutAndPrinting\logs\gui.log（滚动保留 3 份），便于排查印章/打印问题

许可

本项目基于 MIT 许可证 开源。

Star History

[v0.0.2 计划与实现]

• 页面排版扩展：
  • 纸张方向可选：纵向/横向
  • 布局模式：一页一张、一页两张（上下）、一页两张（左右）、一页四张（2×2，固定横向）
  • 切割线：支持在合成页中间添加切割线（上下布局绘制水平线、左右布局绘制竖线、四宫格绘制十字线）
• 车票打印：在“车票选项”中可选“一页重复两张”，用于同一车票的两连版排版（复用 2-up 算法）
• OFD/XML 支持：内置纯 Python 转换（无需外部工具）
  • OFD：优先使用 ofdparser 将 OFD 转为 PDF；若安装了 easyofd 也可作为备选
    • 安装：uv add ofdparser（或 uv add easyofd）
  • XML：支持解析 XML 中内嵌的 base64 负载（PDF 或 OFD）并转换为 PDF
    • 若 XML 不包含内嵌 PDF/OFD 数据，则当前版本无法直接渲染
  • GUI 导入已支持 *.pdf *.ofd *.xml；在未安装上述库时，OFD/XML 会提示安装方式

使用说明（GUI）

• 左侧导入列表添加发票/票据（可多选/拖拽），支持 PDF/OFD/XML
• 右侧选择：布局模式、纸张方向、添加中间切割线、以及可选的车票重复两张
• 点击“排版”生成输出，并在中间预览窗口展示；可选“排版后打印”直接调用系统打印
• 输出文件命名示例：merged_1up.pdf、merged_2up_v.pdf、merged_2up_h.pdf、merged_4up.pdf

命令行（CLI）

• CLI 批处理与 GUI 同样支持 PDF/OFD/XML（自动转换为 PDF 后 2-up 上下合并）；多布局模式优先通过 GUI 使用