InvoiceFlowAI — 电子发票整理与报销准备工具

DeepSeek Harness 插件

@ethanyoq/dsh-invoice-downloader 将本地 IMAP 发票下载、OCR、归档和 Excel 汇总带到 DeepSeek Harness 的右侧边栏。适用于希望把重复整理工作交给本地自动化、同时保留人工复核的报销场景。

dsh plugin --profile web add @ethanyoq/dsh-invoice-downloader
dsh web --profile web

打开右侧的“发票下载”入口，选择保存位置，安装一次本地引擎后填写 QQ 或 163 邮箱的 IMAP 授权码。首次安装需要联网下载 Python 依赖和 Chromium；rapidocr-onnxruntime 的 pip wheel 自带默认 PP-OCRv3 模型，无需额外手动下载模型。发票文件在本地 OCR；OCR 文本发送给当前选择的 DeepSeek 模型提取字段。插件支持 Windows x64 和 macOS Apple Silicon，授权码由 DSH 凭据服务保存，不写入插件设置或扫描日志。

✨ 核心亮点

🏗️ 整体工作流程

flowchart LR
    A["📧 QQ / 163\n邮箱 IMAP"] --> B["📥 邮件抓取\nEmailFetcher"]
    B --> C{"🔍 四层\n智能漏斗"}
    C -->|"通过"| D["📎 附件提取\nZIP 递归解包"]
    C -->|"丢弃"| X["🗑️ 非发票邮件"]
    D --> E{"附件类型?"}
    E -->|"PDF/OFD/XML"| F["🤖 AI 提取引擎"]
    E -->|"URL 链接"| G["🌐 PDF 恢复\nPlaywright"]
    G --> F
    F --> H{"提取\n成功?"}
    H -->|"✅"| I["📂 智能分类\n规则重命名"]
    H -->|"❌"| J["📁 Manual_Check"]
    I --> K["🗂️ 本地归档"]
    K --> L["📊 Excel 报表"]

🤖 双引擎 AI 提取架构

系统采用 Track A + Track B + Local Fallback 三层防线，任何一层成功即采用结果，确保极高的识别成功率。

为什么这样设计？

• Track A（OCR + LLM）：精度最高，先提取文字结构再理解
• Track B（glm-4.5V 视觉）：直接"看图"，适合复杂排版或图片类发票
• Local Fallback：本地正则规则，断网可用，零 API 消耗

🔍 四层智能筛选漏斗

系统不会对每封邮件都调用 AI，而是先经过四层漏斗精准判断，大幅降低误识别率和 API 费用。

筛选通过后，附件还会经过 三级决策：

🌐 三级 PDF 恢复方案

许多发票邮件只有"点击下载"的链接，系统自动识别平台并选择最优方案：

flowchart TD
    Link(["🔗 邮件中的发票链接"]) --> Detect{"识别链接平台"}
    Detect -->|"百望云"| BW["🏢 Playwright 自动化\n登录 → 点击下载 → 捕获文件\n字段匹配验证"]
    Detect -->|"国税·诺诺·航信"| DI["📥 HTTP 直接下载\n识别发票族群\n本地字段校验"]
    Detect -->|"未知网页"| Generic["🌐 网页转 PDF\n检测登录/验证码\nA4 格式渲染"]
    BW & DI & Generic --> Final(["📄 本地 PDF"])
    Final --> AI(["🤖 AI 提取流程"])

⚙️ 配置指南

首次使用只需配置一次，之后每次扫描直接点击运行。

第一步 · 开启 163 邮箱 IMAP

第二步 · 开启 QQ 邮箱 IMAP

第三步 · 获取智谱 GLM API Key

🚀 快速开始

Windows（安装版 / 免安装版）

1. 安装版：运行 InvoiceFlowAI-*-windows-x64-setup.exe；免安装版：解压 InvoiceFlowAI-*-windows-x64-portable.zip 到普通文件夹（避免云盘同步目录），并保持 _internal 文件夹与 InvoiceFlowAI.exe 同级。
2. 双击 InvoiceFlowAI.exe；首次启动会自动弹出设置界面。
3. 填入邮箱地址与授权码（QQ 或 163）、GLM API Key，保存后点击「开始扫描」。发票会自动归档到桌面「发票整理」文件夹。

macOS（Apple Silicon）

1. 打开 InvoiceFlowAI-*-macos-arm64.dmg，将 InvoiceFlowAI 拖入“应用程序”文件夹。
2. 首次启动会自动弹出设置界面。此版本未签名、未公证；若 macOS 阻止打开，请在“系统设置 → 隐私与安全性”中确认仍要打开。
3. 填入邮箱地址与授权码（QQ 或 163）、GLM API Key，保存后点击「开始扫描」。

📁 输出目录结构

发票整理/
├── 火车票/
│   └── 20260315-北京-上海-火车票.pdf
├── 机票/
│   └── 20260301_机票_1280.00_中国国际航空.pdf
├── 住宿发票/
│   ├── 20260310-住宿-01-发票_888.00元.pdf
│   └── 20260310-住宿-01-水单_888.00元.pdf
├── 打车/
│   ├── 0312-滴滴-01-发票_45.50元.pdf
│   └── 0312-滴滴-01-行程单_45.50元.pdf
├── 餐饮/
├── 待人工复核/        ← 无法可靠确认的材料，需人工处理
├── 非目标公司发票/
└── summary_report.xlsx

❓ 常见问题

🛡️ 隐私与安全

• 所有邮件、发票文件均在本地处理，不上传任何服务器
• 邮箱凭据在 Windows 通过 DPAPI 加密存储，在 macOS 通过 Keychain 存储
• GLM API 仅接收发票图片（Base64）用于文字识别，不发送邮件原文内容

⚠️ 免责声明

使用本软件即表示您已理解并接受以下内容。

合规使用 · 本软件通过 IMAP 只读访问邮箱，不发送、删除或修改任何邮件。用户须确保对所处理邮箱拥有合法授权。

用途 · 本软件仅用于发票邮件下载、识别、分类、归档等自动化辅助。

准确性与合规性 · 作者不保证发票数据或生成结果的准确性、完整性、合法性、税务合规性、财务合规性或会计合规性。用户必须自行核验所有发票、报销、税务、会计和合规结果后再使用。

数据 · 调用 GLM API 时，发票图片会发送至智谱 AI 服务器进行识别，受 智谱 AI 隐私政策 约束；邮件原文不会发送。

责任限制 · 作者不对使用本软件造成的损失、遗漏、错误、报销失败、税务风险、合规问题或数据丢失承担责任。

第三方服务

📜 许可证

本项目基于 Apache License 2.0 授权。允许商业使用、修改、分发和闭源集成，但再分发时必须保留 copyright notice、license notice，以及 NOTICE 中的作者署名。