📄 发票酱

轻量桌面应用，专为批量打印电子发票设计。支持 PDF、OFD、图片等多格式导入，智能排版，一键打印或导出。

提供 轻量版 和 OCR 版（含 PP-OCRv5 智能识别），单文件 exe 即开即用。

✨ 功能特性

🏆 OFD 完整支持

OFD（开放版式文档）是国家标准电子发票格式，本工具提供原生完整支持 — 矢量渲染、发票信息直提、印章保真，拖入即用，无需 OCR。

⚠️ 不同厂商/转换工具生成的 OFD 发票格式存在差异（如税务原版 OFD、iloveofd 转换、dzcp 公共服务平台等），如遇解析渲染问题请及时反馈，我们会持续适配。

📥 文件管理

• 多格式支持：PDF、OFD、XML 数电票、JPG、PNG、BMP、WebP、TIFF
• XML 数电票（v2.0.7）：解析 <EInvoice> 格式，提取发票号码/日期/金额/买卖方信息，汇总表、CSV 导出、批量重命名全兼容；纯数据格式不参与排版打印
• 文件列表记忆（v2.0.7）：可选开关，启动时自动恢复上次打开的文件列表，仅记忆文件路径
• 打印状态追踪（v2.0.7）：三种过滤（全部/未打印/已打印），打印后自动标记绿色 ✓，状态持久化
• PDF 渲染双引擎（v1.10.0+）：首选 WinRT 原生渲染（Windows.Data.Pdf），自动 fallback PDFium（Chromium 内核），兼容企业精简版/LTSC 系统
• PDF 文字层提取（轻量版也可用）：解析 PDF 内容流 Tm+Tj/TJ 指令直接提取文字坐标，~5ms/页，无需 OCR 即可识别发票信息
• PP-OCRv5 智能识别（OCR 版，适用于图片型 PDF 和图片）：文本优先 + 坐标回退双重架构，含税价 / 不含税价 / 税额数学验证配对，发票号码 / 日期 / 买卖方信息自动提取
• 金额校验可视化：OCR / PDF 提取金额求和校验失败时，发票卡片金额徽章 ⚠ 警告标识，hover 可查看含税/不含税/税额验证详情
• EXIF 方向自动修正：导入图片/车票时自动读取 EXIF Orientation 旋转像素，PDF /Rotate 属性 + CropBox 坐标归一化保障页面方向正确
• 发票查验：一键跳转国家税务总局查验平台
• 骨架屏渐进加载：批量导入时骨架屏秒出 + 逐文件渐进渲染 + 持久进度 toast，大文件不卡 UI
• 日期排序（v2.0.8）：📅 按钮弹出菜单，可选旧→新 / 新→旧，空日期自动排末尾
• ↑↓ 排序：↑↓ 按钮排序（替换 Tauri webview 拖拽卡顿），hover 浮动显示不占空间
• 批量重命名（v2.0.5）：汇总表内嵌面板，预设模板（金额+销售方+号码等）或自定义字段勾选，一键批量重命名发票磁盘文件，重名自动序号
• 设置自动记忆：关闭后自动记住布局、纸张、打印模式等全部设置，打开即恢复

📐 排版设置

• 纸张：A4 / A5 / B5 / Letter / Legal / 自定义
• 布局：6 预设（1×1 / 2×1 / 3×2 / 1×2 / 2×2 / 3×3）+ 自定义行列（1-10 × 1-10），自动横纵方向
• 边距 / 间距：独立可调，预设快捷按钮
• 缩放：自适应 / 拉伸填充 / 原始大小 / 自定义百分比
• 旋转：全局 0° / 90° / 180° / 270° / 自动 + 单张旋转
• 单票独立调整（v1.9.0+，v2.0.1-v2.0.2, v2.0.8 增强）：每张发票预览拖拽移动 + 角落 handle 缩放，九宫格快速对齐，滚轮微调 + 滚轮单票缩放（5%/步），±150mm 偏移范围，拖拽约束动态化，放大上限 3x，编辑态溢出预览，打印区域虚线标识，双击重置，调整参数可选持久化记忆，侧边栏「单票调整」面板或发票弹窗参数编辑，PDF 按参数裁剪输出

✂️ 辅助功能

• 裁切线、编号标记、边框显示、裁剪白边、自定义水印
• 金额统计、车票票种标签、发票类型自动检测
• 页脚：打印页码（第 X 页 / 共 Y 页）、打印日期、自定义页脚文本，独立下边距控制

📊 数据导出

• 发票汇总表（v2.0.3）：报销必备，一键导出所有发票明细，字段可勾选（14 项），金额/名称等可直接编辑修正，合计行自动汇总含税/不含税/税额，CSV 格式 Excel 直接打开，列选择和备注持久化记忆

🖨️ 打印与导出

• 打印模式：四种模式可选
• PDF 阅读器（默认）：生成 PDF 后由系统默认程序处理，保持矢量质量，数据量最小
• 弹窗确认：预览后确认打印，可选 PDFium 或 SumatraPDF 引擎
• 静默打印（PDFium）：Chromium PDFium 引擎直打打印机 DC，打印清晰（需下载 pdfium.dll）
• 静默打印（SumatraPDF）：通过 SumatraPDF 直接发送到打印机（需安装 SumatraPDF）
• PDF 统一直通（v1.9.0+）：lopdf Form XObject + JPEG DCTDecode 直通，PDF 页面以原始质量嵌入合成 PDF，无二次压缩
• 印章烘焙（v2.0.4）：生成 PDF 时自动将原票印章/签章标注烘焙到输出，印章位置/大小与原票一致
• 份数控制：全局 + 单张份数，逐份 / 逐页打印，双面打印，彩色 / 灰度 / 黑白
• PDF 导出：自动打开或自定义保存目录
• 确认弹窗：打印前显示发票数量 / 版面 / 纸张 / 打印机 / 引擎 / 份数，防止误操作

🎨 界面

• 深色 / 浅色模式、实时预览（缩放 + 翻页）
• 快捷键：Ctrl+O 添加 · Ctrl+P 打印 · Ctrl++/- 缩放 · Ctrl+0 自适应 · ←→ 翻页

📸 界面预览

☀️ 浅色模式	🌙 深色模式

📦 下载

从 Releases 下载最新版本：

文件	说明
发票酱_x64-setup.exe	轻量版安装包
发票酱_x64_绿色版.exe	轻量版便携（单文件 exe，无需安装）
发票酱_x64_OCR版-setup.exe	OCR 版安装包（含 PP-OCRv5）
发票酱_x64_OCR绿色版.zip	OCR 版便携（exe + models/）

💡 文字型 PDF / OFD 发票选轻量版即可自动提取金额和销售方信息；图片型 PDF 和图片需 OCR 版。

系统要求：仅支持 Windows 10 1803 及以上版本 或 Windows 11。

⚠️ 不支持 Windows 7/8：依赖的 WebView2 和系统 PDF 组件已停止支持，无法正常运行。

💡 如遇「找不到 WebView2」报错，说明系统未安装或已被卸载。请从 微软官网 下载 Evergreen 引导程序（约 2MB），安装后重启应用即可。

📋 使用说明

1. 添加发票：点击「➕ 添加」或拖放文件（支持 PDF / OFD / 图片混选）
2. 排版设置：左侧「⚙ 排版」面板调整纸张、布局、边距
3. 预览检查：主区域实时预览，支持缩放翻页；文字型 PDF / OFD 自动提取金额信息，图片型 PDF 和图片需 OCR 版
4. 打印：点击「🖨 打印」，选择弹出预览或直接打印
5. 保存 PDF：点击「📥 PDF」导出合成 PDF

🛠 技术栈

层级	技术	说明
前端	原生 HTML/CSS/JS	模块化（app / ocr / layout / print），零依赖框架
后端	Tauri 2.x (Rust)	轻量桌面框架，Rust 条件编译管理功能开关
PDF 渲染	WinRT + PDFium 双引擎	WinRT 原生渲染优先，自动 fallback PDFium（Chromium 内核）
PDF 生成	printpdf 0.9 + lopdf 0.39	JPEG 直通零质量损失、PDF 页面 Form XObject 全布局直通
OFD/XML 解析	Rust 独立 crate (invoice-engine/)	矢量 SVG 渲染 + 发票 XML/数电票字段直提 + 红章 Appearance 偏移叠加 + DrawParam 继承链 + ImageMask 遮罩合成
OCR	ocr-rs 2.2 (PP-OCRv5 + MNN)	文本优先 + 坐标回退，对比度增强，Lanczos3 锐化（OCR 版可选）
图像处理	image 0.25 (Rust)	原生 WebP/TIFF 支持，kamadak-exif 方向自动修正
打印	Print Spooler API + PDFium + SumatraPDF + ShellExecuteW (Win32)	静默打印（PDFium 直打 DC / SumatraPDF CLI）/ 弹窗确认 / PDF 阅读器

📁 项目结构

ticketchan/
├── src/                            # 前端
│   ├── index.html / styles.css
│   ├── app.js                      # 主入口、状态、文件加载
│   ├── ocr.js                      # OCR 提取（文本优先 + 坐标回退）
│   ├── layout.js                   # calculateLayout() + 预览渲染
│   └── print.js                    # 打印 / 导出 PDF
├── src-tauri/                      # Tauri / Rust 后端
│   ├── src/
│   │   ├── main.rs                 # 入口
│   │   ├── lib.rs                  # 命令、拖放、进程管理、OFD 解析
│   │   ├── pdf_engine.rs           # PDF 生成（JPEG 直通 / 全布局直通）、WinRT 渲染、OCR
│   │   └── pdfium_print.rs         # PDFium 矢量打印（直打打印机 DC）
│   ├── invoice-engine/              # 发票引擎独立 crate（OFD SVG 渲染 + XML 数电票解析）
│   │   ├── Cargo.toml              # 通过 path 依赖引入主项目
│   │   └── src/lib.rs              # parse_ofd → OfdResult { svg, invoice_info } / parse_xml_invoice
│   ├── models/                     # PP-OCRv5 MNN 模型（OCR 版打包用）
│   ├── Cargo.toml                  # ocr feature flag + lopdf 0.39
│   ├── tauri.conf.json             # 轻量版配置
│   └── tauri.ocr.conf.json         # OCR 版配置（含 models）
├── scripts/
│   ├── build-all.js                # 一键全量构建（4 产物）
│   └── bump-version.js             # 版本号同步
└── package.json

🚀 开发

环境要求：Node.js 18+、Rust 1.77+、Windows 10/11

npm install

# 开发
npm run dev          # 轻量版
npm run dev:ocr      # OCR 版

# 构建
npm run build        # 轻量版
npm run build:ocr    # OCR 版
npm run build:all    # 一键全量构建（4 产物）

# 版本号
npm run bump 1.9.8   # 同步 package.json → Cargo.toml → tauri.conf.json

🗺 路线图

• [x] OFD 完整支持（矢量渲染 + 信息直提 + 印章 + 字体保真）
• [x] PDF 全布局直通（JPEG 零损失 + lopdf Form XObject）
• [x] 单票独立调整（预览拖拽/缩放 + PDF 按参数裁剪）
• [x] Print Spooler API 静默打印
• [x] PDFium 矢量静默打印（Chromium PDFium 直打打印机 DC）
• [x] OCR Feature Flag 双版本构建
• [x] PDF 文字层提取（轻量版无需 OCR 也能识别发票信息）
• [x] EXIF 方向 / PDF Rotate / CropBox 归一化自动修正
• [x] OFD 自闭合标签解析修复 + 字段级联保护
• [x] OFD ImageMask 遮罩兼容（iloveofd 等二次转换 OFD 红章黑色背景修复）
• [x] 设置持久化 — 关闭后自动记忆所有设置
• [x] 金额校验可视化 — ⚠ 警告标识 + hover 验证详情
• [x] 预览加载 2-3x 加速 — JPEG 预览 + DPI 150
• [x] PDF 文字提取批量并行 — rayon 加速 + 按文件分组
• [x] 单票调整九宫格快速对齐 + 滚轮微调 + 调整记忆（v2.0.1）
• [x] 单票调整滚轮缩放 + 拖拽约束动态化 + 放大上限 3x + 编辑态溢出预览（v2.0.2）
• [x] 发票汇总表导出 — 可编辑预览 + CSV + 持久化记忆（v2.0.3）
• [x] PDF 印章烘焙 — 标注直通输出（v2.0.4）
• [x] 批量重命名发票文件 — 预设模板 + 自定义字段（v2.0.5）
• [x] 备注作为命名字段 + 汇总表行内编辑（v2.0.6）
• [x] 品牌升级 — 正式更名「发票酱 (TicketChan)」（v2.0.6）
• [x] XML 数电票支持 — <EInvoice> 格式解析（v2.0.7）
• [x] 文件列表记忆 — 启动时自动恢复上次打开的发票（v2.0.7）
• [x] 打印状态追踪 — 已打印/未打印过滤 + 自动标记（v2.0.7）
• [x] 单票调整打印区域虚线标识 — 选中/拖拽时显示裁切边界（v2.0.8）
• [x] 发票列表日期排序 — 📅 旧→新 / 新→旧（v2.0.8）
• [x] 打印机选择持久化 — saveSettings/loadSettings 补全（v2.0.8）

🤖 关于此项目

本项目由 AI 辅助生成，历经 175+ 轮迭代。主要攻克：Tauri 2.x 对话框死锁、WebView2 拖放失效、WinRT COM 接口适配、ocr-rs 条件编译集成、OFD 矢量渲染（DrawParam 继承链 / 文字排版 / 印章偏移 / 自闭合标签陷阱 / ImageMask 遮罩合成）、PDF 引擎 JPEG 直通与 lopdf Form XObject 全布局直通、PDFium 矢量打印（DLL 生命周期管理 / 直打打印机 DC / SEH 原生崩溃保护 / DEVMODE 完整缓冲区）、PDF 文字层坐标提取（批量 rayon 并行 / 按文件分组回退）、预览 DPI/JPEG 加速、设置持久化、打印流程解耦、金额校验可视化、排版份数批量设置、单票独立调整增强（九宫格快速对齐 / 滚轮缩放 / 拖拽约束动态化 / 调整记忆持久化）、PDF 印章烘焙、发票汇总表导出、批量文件重命名、XML 数电票解析、文件列表记忆、打印状态追踪等。

📄 许可证

MIT License

Star History