技能介绍

要解决什么问题

月度或出差归来后，财务要的往往是「按项目拆好的费用表 + 对应 PDF 发票包」，而票散落在 12306、南航、滴滴等渠道的邮箱里。手工下载、对抬头和出差地点猜项目、再按甲方/博维拆 sheet，既重复又容易错归属。

技能如何工作

工作区以 _config/ 为标志：没有 mailbox.yaml 时走 Setup Mode（拷模板、配 IMAP 授权码、projects.yaml 里的抬头/地点/报销方/项目组成员）；已有配置则走 Monthly Mode。

核心流水线大致是：

拉邮件：fetch_mail.py，附件落到 _收件箱/YYYY-MM/，并生成 manifest.csv
解析与归属：parse_and_attribute.py 产出 03_归属预览.csv；必要时再跑机票/酒店/餐饮补解析脚本
人工兜底：99_待人工确认.csv 结合 Step 0 的归属说明（$ATTRIBUTION_HINT）或逐条问答
填表：fill_excel.py 按项目写「项目费用报销表」，经办人、使用人员来自本次会话收集
打包：package_for_reimbursement.py 按 --filter-side（甲方/博维）或 --filter-project 出 zip

业务节奏分三种：博维月度（上月、side=博维）、甲方即时（近期、指定项目、side=甲方）、月度全量（上月全部票）。归属优先级是 抬头命中 > 地点规则（含滴滴硬规则、大交通接驳）> 用户 hint。

边界与注意点

本技能不做开票、改票、提交公司报销系统或算个税。mailbox.yaml 含明文授权码，勿贴到对话里。Windows 跑脚本需设 PYTHONIOENCODING=utf-8。fill_excel.py 默认会删掉非本次生成的 sheet，需保留历史表时加 --keep-other-sheets。