票据下载与报销单填报工具

报销前的真实痛点

财务或行政要的往往是「一张表 + 附件目录」，而票据分散在邮箱附件、ZIP 里，还要自己抄日期、金额、商户。手工合并还容易把多张发票挤成一行，和「一笔票据一行」的填报规则对不上。

技能如何跑通流水线

整体是 下载 → 提取 → 清单 + 统计 三段，也可以只整理本地文件夹。

• 邮件下载：用 IMAP 读 ~/.workbuddy/credentials/ 下的授权码（如 QQ 的 qq_email_auth_code.txt），默认拉最近 7 天未读 带附件邮件；可用 --days、--seen 调整范围。PDF 进 票据/，ZIP 进 附件/ 并在内存解压出 PDF/图片，同名文件自动加编号。
• 信息提取：对 文字型 PDF 用 pdfplumber + 正则抽日期、金额、商户，并映射到预定义费用类别（交通、住宿、餐饮等）。有 assets/用户模板.xlsx 则按你的列结构填充；否则输出 7 列通用清单。
• 输出：Excel 主表之外会自动加 统计分析 页（概览、按类别、Top 商户、按日期）。核心规则是 每笔费用单独一行，一张原始票据对应清单中的一行，禁止合并金额。

一体化用法可以是「帮我下载并整理票据」（走首次引导配置邮箱与模板），或直接指定目录如整理某路径下已有票据。

能力边界

• 扫描件 / 图片票据 无 OCR，需人工补录。
• 不做跨邮件去重、费用审批或合规校验，也不删改原邮件。
• PDF 提取成功率因版式而异，生成后建议抽查 2–3 张核对金额与日期。