Expense Report Wizard

SKILL.md

---
name: expense-report-wizard
version: "1.0.6"
description: "出差报销整理向导。零配置即用——发票照片 AI 视觉直接识别，按类别+时间整理发票、重建行程日志、生成报销单、自动计算差补、税额分离、退改签/红字发票处理、合规审查（连号发票/人均超标/证据链/住宿缺失/交通断链/抬头核对/发票章检测）。已接入在线文档/批量 OCR/会议日程等服务时自动增强。触发：帮我整理报销、做报销单等。"
agent_created: true
---

# 出差报销整理向导（Expense Report Wizard）

## 30 秒上手

直接说下面任何一句，向导自动走完全流程：

> 「帮我整理这次出差报销」
> 「我刚出差回来，一堆发票要整理」
> 「帮我做个报销单，发票照片我发你」
> 「我有个文件夹里全是发票，帮我整理——路径是 ~/Downloads/出差发票」

然后把发票照片拖进对话窗口、告诉文件夹路径、或者逐条口述，剩下的交给向导。

**📖 快速导航：** [遇到问题怎么办](#遇到问题怎么办) · [反模式/避坑指南](#反模式常见误用) · [常见问题](#常见问题)

---

## 设计理念

1. **没有依据，不判定** — 合规检查的每一条结论都必须可追溯到用户提供的财务制度。没有制度则仅做结构化检查，绝不杜撰标准
2. **给 AI 装上眼睛** — 发票智能识别三层调度 + 类型识别 + 有效性检测 + 抬头核对
3. **把经验固化为技能** — 合规规则引擎化，阈值全部来自用户制度，规则库独立可更新
4. **让使用者零门槛** — 零配置即用：发票照片由 AI 视觉直接识别，不装任何连接器也能完整跑完报销全流程；已接入批量 OCR、在线文档、会议日程、消息通知等服务时自动增强，三层降级兜底
5. **整理即是归档** — 不仅整理数据，还帮用户把文件本身整理好——规范命名、分类归档

---

## 能力边界

### ✅ 擅长

- 从发票图片/文字描述/本地文件夹中提取结构化数据
- **识别发票类型**：增值税专用/普通/电子发票、手撕票、火车票、机票行程单等
- **开票抬头核对**：检测发票抬头与公司名称是否一致
- **发票有效性检测**：手撕票是否盖有发票章、是否为非发票凭证
- 按类别+时间整理费用清单
- 自动推断出差行程，生成行程日志（可直接当出差报告初稿）
- **发票文件规范化重命名**：把 IMG_001.jpg 变成 2026-05-10_交通_北京→上海高铁_553.50.jpg
- 生成多种格式的报销单（标准版/简版/项目分摊版/CSV/自定义）
- **自动计算差旅补贴/补助**：根据行程天数和公司标准，自动核算并计入报销总额
- **税额分离与专票抵扣支持**：智能提取专票/电票的税额，分列含税与不含税金额，便于财务抵扣
- **退改签与红字发票处理**：自动识别退款、改签扣费及红字冲销发票，精准冲抵报销金额
- 结构化合规审查：连号发票、住宿缺失、交通断链、日期异常、发票有效性、抬头核对、**行程冲突预警**
- 阈值合规审查：餐饮人均、住宿单价、大额单笔（**需用户提供财务制度**）
- **可选增强（已接入则自动启用）**：批量 OCR、在线文档导出、会议日程核对、合规消息通知——可对接腾讯文档/腾讯云/腾讯会议/企业微信等服务；未接入时由内置 AI 视觉与本地输出兜底，不影响主流程

### ⚠️ 需素材

- 完整报销需要：发票照片或文字清单、出差大致日期、常驻城市
- **精准合规审查需要：贵公司财务制度**（没有制度仅做结构化检查，不做阈值判定）
- **开票抬头核对需要：公司全称**（没有则跳过抬头检查）
- 自定义报销单需要：公司模板格式（字段列表）
- 批量 OCR / 会议日程核对等增强能力：需对应服务已接入并授权（未接入时自动用内置 AI 视觉识别，功能不缺失）

### ❌ 超出范围

- 不替代财务审批流程（只辅助整理和检查）
- 不对接 ERP/财务系统（可导出 Excel 但不直连 SAP/用友等）
- 不判断发票真伪（只检查格式和逻辑一致性，验真需税务系统）
- 不判断税款能否实质抵扣（仅做汇总整理，最终抵扣以税务局规则为准）
- 不处理境外发票（当前仅支持中国大陆发票格式）
- 不自动提交报销（只生成材料，提交由用户操作）

---

## 遇到问题怎么办

遇到任何问题，按这个顺序排查：

| 症状 | 原因 | 建议 |
|------|------|------|
| 发票照片识别模糊 | 图片不清晰或字迹潦草 | 说「用专业 OCR 重新识别第 X 张」升级到 Layer 2/3 |
| 某张发票金额/日期识别错误 | OCR 准确率非 100% | 直接说「第 X 张金额是 XX 元」即可修正 |
| 腾讯文档/企业微信连接不可用 | 未接入对应服务 | 自动降级为本地处理：报销单存 Markdown，合规结果在对话展示 |
| 文件夹读取失败 | 路径错误或无权限 | 检查路径是否正确，或改用逐张上传 |
| OFD 文件无法识别 | 格式较新，部分环境不支持 | 在开票平台导出为 PDF 后提供 |
| 大量发票处理慢 | 分批识别需要时间 | 耐心等待，向导会逐批汇报进度 |
| 以上都不行 | — | 把已完成步骤的结果发给你确认，你手动补充后继续 |

**统一规则**：任何异常都不会导致流程中断——搞不定就降级，降级不了就交给你确认。

---

## 支持的文件格式

向导可读取以下格式的发票文件：

| 类别 | 格式 | 说明 |
|------|------|------|
| **图片** | JPG/JPEG、PNG、HEIC/HEIF、BMP、TIFF/TIF、WEBP | 拍照/扫描件 |
| **文档** | PDF | 电子发票常见格式 |
| **发票专用** | OFD | 增值税电子发票官方格式 |
| **压缩包** | ZIP | 自动解压后识别内部文件 |

> 💡 推荐使用 PDF（电子发票）或清晰拍照（纸质发票）。OFD 格式如无法直接读取，建议导出为 PDF 后提供。

---

## 完整示例：从头到尾做一次报销整理

以下用一个具体出差案例，演示向导全部 6 步的执行过程。

**背景：** 张三（常驻上海）于 5 月 12-14 日出差北京，拜访客户并交付项目。返程后整理报销。

---

### Step 1：场景感知（对话）

> **用户：** 「帮我整理这次出差报销」
>
> **向导：** 「来整理出差报销！先确认几个信息：你常驻哪个城市？这次出差什么时候到什么时候？去哪里？公司全称是什么？」
>
> **用户：** 「常驻上海，5月12日到14日去北京，客户拜访+项目交付，公司全称上海云智科技有限公司」
>
> **向导：** 「收到！我记录一下：
> - 常驻：上海　出差：5月12-14日 北京　公司：上海云智科技有限公司
> 有差旅报销制度吗？有的话发我，合规检查会更精准——没有的话我先做结构化检查。」

---

### Step 2：发票收集 + 识别

> **用户：** 「发票在 ~/Downloads/北京出差发票/ 这个文件夹里，一共 8 张」

向导读取文件夹，自动 OCR 识别，结果如下：

```
✅ 识别到 8 张发票：
  1. 5月12日 机票（上海→北京）¥553.50  同行人：李明、王芳
  2. 5月12日 住宿（北京如家）¥388         同住人：张三
  3. 5月12日 晚餐工作餐（3人）¥240        同行人：李明、王芳
  4. 5月13日 出租车费 ¥86
  5. 5月13日 客户接待餐（5人）¥850        同行人：李明、王芳、赵海、刘芳
  6. 5月13日 住宿补差价 ¥120
  7. 5月14日 高铁（北京→上海）¥553.50   同行人：李明、王芳
  8. 5月14日 午餐工作餐（2人）¥120        同行人：李明
```

---

### Step 3：分类清单 + 行程日志

**分类清单：**
```
🚂 交通（3笔）小计 ¥1,193.00
  5月12日  上海→北京 机票 ¥553.50  同行人：李明、王芳
  5月14日  北京→上海 高铁 ¥553.50  同行人：李明、王芳
  5月13日  出租车 ¥86.00

🏨 住宿（2笔）小计 ¥508.00
  5月12日  如家酒店 1晚 ¥388.00  同住人：张三
  5月13日  住宿补差价 ¥120.00

🍽️ 餐饮（3笔）小计 ¥1,210.00
  5月12日  工作餐（3人）¥240.00  同行人：李明、王芳
  5月13日  客户接待餐（5人）¥850.00  同行人：李明、王芳、赵海、刘芳
  5月14日  工作餐（2人）¥120.00  同行人：李明

📦 其他（0笔）
```

**行程日志（节选）：**
```
## 📅 出差行程日志
5月12日（周一）北京
  - 🚂 09:30 上海 → 北京（机票，**同行人：李明、王芳**）
  - 🏨 如家酒店，北京（**同住人：张三**）
  - 🍽️ 工作餐 ¥240（3人，**同行人：李明、王芳**，人均¥80）

5月13日（周二）北京
  - 🚕 市内交通 ¥86
  - 🍽️ 客户接待餐 ¥850（5人，**同行人：李明、王芳、赵海、刘芳**，人均¥170）
  当日小计：¥936.00
```

---

### Step 4：报销单生成

```
## 出差费用报销单

| 报销人 | 张三 | 部门 |  | 报销日期 | 2026-05-15 |
|--------|------|------|------|----------|--|
| 出差事由 | 客户拜访+项目交付 | 出差时间 | 2026-05-12 至 2026-05-14 | 共计天数 | 3天 |

## 费用明细
| 序号 | 日期 | 费用类别 | 用途说明 | 金额（元）| 同行人/同住人 | 备注 |
|------|------|----------|----------|-----------|------------|------|
| 1 | 2026-05-12 | 交通费 | 上海→北京机票 | 553.50 | 李明、王芳 | |
| 2 | 2026-05-12 | 住宿费 | 如家酒店1晚 | 388.00 | 张三 | |
| 3 | 2026-05-12 | 餐饮费 | 工作餐（3人） | 240.00 | 李明、王芳 | |
| 4 | 2026-05-13 | 交通费 | 出租车 | 86.00 | — | |
| 5 | 2026-05-13 | 餐饮费 | 客户接待餐（5人）| 850.00 | 李明、王芳、赵海、刘芳 | |
| 6 | 2026-05-13 | 住宿费 | 补差价 | 120.00 | — | |
| 7 | 2026-05-14 | 交通费 | 北京→上海高铁 | 553.50 | 李明、王芳 | |
| 8 | 2026-05-14 | 餐饮费 | 工作餐（2人） | 120.00 | 李明 | |

## 费用汇总
| 类别 | 金额（元） |
|------|-----------|
| 交通费 | 1,193.00 |
| 住宿费 | 508.00 |
| 餐饮费 | 1,210.00 |
| 合计 | ¥2,911.00 |
```

---

### Step 5：合规审查

```
## 🔍 合规审查摘要
| 检查项 | 类型 | 状态 | 发现 |
|--------|------|------|------|
| 连号发票 | 结构化 | ✅ | 无 |
| 发票有效性 | 有效性 | ✅ | 全部有效 |
| 抬头核对 | 有效性 | ✅ | 全部正确 |
| 住宿覆盖 | 结构化 | ✅ | 完整 |
| 交通断链 | 结构化 | ✅ | 无断链 |
| 餐饮人均 | 阈值 | ⏭️ | 未提供制度，跳过 |
| 同行人缺失 | 数据关联 | ⚠️ | 1条缺失（序号4出租车）|

⚠️ [同行人缺失] 5月13日出租车（¥86）人数未知且无同行人记录 → 如为拼车出行，建议补充同行人信息

📋 [住宿覆盖] 5月12日、13日均有住宿发票，完整
📋 [行程连续] 5月12日北京→5月14日上海，无断链
```

---

### Step 6：拓展菜单

> **向导：** 「报销单已生成！还需要以下增强功能吗？告诉我编号即可：
>
> A. 📤 一键导出到腾讯文档（直接生成在线文档提交审批）
> B. 📊 费用统计图表
> D. 🏷️ 项目/成本中心分摊」

---

现在继续阅读完整的文档结构：

---

## 核心流程（6 步自动推进）

```
Step 1: 场景感知 + 财务制度采集 + 抬头信息
  ↓
Step 2: 发票收集（📷 OCR / 📁 文件夹 / 💬 对话 / 📋 批量粘贴）
  ↓ [三层 OCR 智能调度] → [发票类型识别 + 有效性检测]
  ↓
Step 3: 分类整理 + 行程重建 + 📁 文件整理（可选重命名/归档）
  ↓ [可融合腾讯会议日程]
Step 4: 报销单生成
  ↓ [可一键导出腾讯文档]
Step 5: 合规审查（结构化检查始终执行，阈值检查需有制度依据）
  ↓ [可推送企微通知]
Step 6: 拓展菜单（用户自选）
```

每一步自动推进，无需手动触发。

---

## Step 1：场景感知 + 财务制度采集

流程启动时，主动采集以下信息（缺项不阻塞，后续可补）：

| 采集项 | 用途 | 示例 |
|--------|------|------|
| 常驻城市 | 住宿缺失检测豁免 | "上海" |
| 出差起止日期 | 行程范围、日期有效性检查 | "5月10日到5月20日" |
| 出差目的地 | 行程推断、交通断链判断 | "北京、广州" |
| 出差事由 | 行程日志封面 | "客户拜访+项目交付" |
| **同行人/同住人** | **同行人/同住人记录，餐饮合规关联** | "李明、王芳"（一起出差的同事） |
| **公司全称** | **开票抬头核对** | "XX科技有限公司" |
| **公司税号**（可选） | 增值税专票税号核对 | "91110108MA01XXXXX" |
| **支付方式**（可选）| 区分个人垄付/公司账户，便于会计做账 | "酒店公司卡付，其余个人垄付" |
| **差旅补贴标准**（可选）| **自动计算每日出差补助** | "每天补助100元，出发/返程半天" |
| **财务制度** | **阈值合规检查的判定依据** | 上传制度文件/口述标准 |

**开场语：**
> "来整理出差报销！先确认几个信息：你常驻哪个城市？这次出差什么时候到什么时候？去哪里？公司全称是什么？公司有每天的差补标准吗（例如每天100元）？——不确定的先跳过，后面再补。"

### 财务制度采集

紧接着询问：
> "有你们公司的差旅/报销制度吗？有的话发我，合规检查会更精准——没有也没关系，我会做结构化检查（连号发票、住宿缺失、交通断链、发票有效性、抬头核对），只是餐饮人均这类需要标准的检查就跳过。"

**三种采集方式：**

| 方式 | 操作 | 适用场景 |
|------|------|---------|
| 上传制度文档 | 用户上传 PDF/Word/图片，向导自动解析 | 有正式制度文件 |
| 对话式问答 | 向导逐项询问关键阈值，用户口头提供 | 记得标准但没有文件 |
| 使用模板 | 引导用户填写 `references/policy-template.md` 后上传 | 想一次填完所有标准 |

**制度解析后必须确认：**
> "我从制度中提取到以下标准，确认一下：
> - 工作餐：150元/人
> - 接待餐：300元/人
> - 住宿上限：一线城市500/晚，其他350/晚
> 以上对吗？有需要调整的直接说。"

**没有制度时：**
- 明确告知用户：仅执行结构化检查，阈值检查跳过
- 行程日志中不出现任何杜撰的标准判断
- 用户后续随时可以补充制度，触发阈值检查

---

## Step 2：发票收集 + 类型识别 + 有效性检测

请用户以任意方式提供发票信息：
- 📷 拍照上传（OCR 模式）
- 📁 **指定本地文件夹路径**（批量读取模式——一次搞定所有发票）
- 💬 手动逐条描述（对话录入模式）
- 📋 粘贴已有清单（批量录入模式）

**引导语：**
> "把你的发票信息告诉我，格式不限——可以拍照、一条条说、粘贴清单，或者告诉我发票图片在电脑上的文件夹路径，我直接读取。"

### 2.1 文件夹批量读取（推荐大批量场景）

当用户有大量发票文件（十几张甚至几十张）时，最方便的方式是**指定本地文件夹**：

> "我有个文件夹里全是发票——路径是 ~/Downloads/出差发票"

**处理流程：**

```
1. 用户提供文件夹路径
2. 向导扫描该路径下所有支持格式的文件：
   - 图片：JPG/JPEG、PNG、HEIC/HEIF、BMP、TIFF/TIF、WEBP
   - 文档：PDF
   - 发票专用：OFD
   - 压缩包：ZIP（自动解压后识别内部文件）
3. 列出找到的文件数量和格式分布：
   "找到 23 个文件：18张图片、3个PDF、2个OFD"
4. 逐个/逐批识别：
   - ≤9 个文件 → 三层 OCR 一次性处理
   - >9 个文件 → 按 9 个一组分批处理
5. 全部识别完毕后，汇总展示让用户确认
```

**扫描规则：**
- 递归扫描子文件夹
- 忽略隐藏文件（以 `.` 开头）
- 忽略 macOS 系统文件（`._` 前缀、`.DS_Store`）
- ZIP 文件自动解压到临时目录后识别
- 非支持格式的文件跳过并提示

**降级**：文件夹路径无效或无权限时，提示用户检查路径，或改用逐张上传。

### 2.2 三层 OCR 智能调度

识别发票图片时，采用三层调度——先用最轻量的方式，搞不定再升级：

| 条件 | 使用层级 | 理由 |
|------|---------|------|
| 1-3 张清晰图片 | Layer 1 (AI 视觉) | 即时识别，零延迟 |
| 4-9 张图片 | Layer 2 (批量 OCR，可选) | 批量处理更高效 |
| >9 张图片 | Layer 2 分批 + Layer 1 兜底 | 超过单次上限时分批 |
| 增值税专用发票（需税额/税号） | Layer 3 (VatInvoiceOCR) | 专业模型更精准 |
| AI 视觉识别模糊 | 自动升级到 Layer 2/3 | 提高准确率 |

#### Layer 1：AI 视觉识别（默认，零配置）

直接使用对话内置多模态能力，提取：发票号码、开票日期、金额（**含税金额、不含税金额、税额**）、项目名称、销售方、**发票类型、开票抬头**、**是否为红字/退款发票**。

#### Layer 2：批量 OCR（可选增强）

已接入批量 OCR 服务（如腾讯文档）时自动启用：调用 `mcp__tencent-docs__ocr.extract` 单张识别，或 `mcp__tencent-docs__ocr.toexcel` 批量识别（1-9张/次）。超过 9 张时分批调用。未接入时回落到 Layer 1 AI 视觉识别。

#### Layer 3：VatInvoiceOCR（可选，最精准）

引用已上架的 `tencentcloud-ocr-vatinvoice` 官方 Skill，适用于增值税专用发票的结构化识别。需配置环境变量：
```bash
export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"
```

### 2.3 发票类型识别

OCR 识别完成后，对每张凭证进行类型分类（参照 `references/invoice-types.md`）：

| 识别结果 | 处理方式 |
|---------|---------|
| 增值税专用发票 | 提取税额、购销双方税号，核对抬头 |
| 增值税普通发票 | 提取校验码，核对抬头 |
| 增值税电子发票 | 检查是否重复，核对抬头，提取税额用于抵扣 |
| 火车票/机票行程单 | 核对乘车人/乘机人姓名，**识别退票费/改签费** |
| 红字发票/退款单 | **金额标记为负数，冲减对应正数发票的报销金额** |
| 定额发票（手撕票） | **检查是否加盖发票专用章** |
| 费用清单/收据/支付截图 | 标注「📄 非发票，仅作佐证」 |
| 无法判断 | 标注「⚠️ 类型待确认」 |

### 2.4 发票有效性检测 + 抬头核对

类型识别后，自动执行有效性检测：

**抬头核对**（如已提供公司全称）：
- 发票购买方名称 = 公司全称 → ✅ 通过
- 简称/缩写（如"XX科技" vs "XX科技有限公司"）→ 🟡 [抬头简称] 购买方"XX科技"与公司全称"XX科技有限公司"不完全一致 → 建议确认是否有效
- 抬头为个人姓名 → 🔴 [抬头错误] 发票开成个人姓名，与公司名称不符 → 需重新开票
- 完全不符 → 🔴 [抬头错误] 购买方"YY公司"与贵司"XX科技有限公司"完全不符 → 需重新开票

**手撕票发票章检测**：
- 有章 → ✅ 有效
- 无章 → 🔴 [发票无效] 定额发票未加盖发票专用章 → 不可报销，需换开发票
- 无法判断 → ⚠️ [待确认] 无法判断是否盖有发票专用章 → 请人工检查

**非发票凭证标注**：
- 费用清单/消费明细 → 📄 [非发票] 仅为消费明细，非正式发票 → 需补开发票
- 收据 → 📄 [非发票] 收据不可作为报销凭证 → 需补开发票
- 支付截图 → 📄 [非发票] 支付记录仅作佐证 → 需补开发票
- 预订单 → 📄 [非发票] 预订单非发票 → 需补开发票

**有效性检测完成后，输出汇总：**

```markdown
## 发票有效性检查

| # | 日期 | 类型 | 金额 | 有效性 | 说明 |
|---|------|------|------|--------|------|
| 1 | 05-10 | 增值税电子发票 | ¥553.50 | ✅ 有效 | |
| 2 | 05-11 | 定额发票 | ¥100.00 | 🔴 无效 | 手撕票未盖发票专用章 |
| 3 | 05-12 | 费用清单 | ¥286.00 | 📄 非发票 | 仅为消费明细，需补开发票 |
| 4 | 05-12 | 增值税普通发票 | ¥388.00 | 🔴 抬头不符 | 开成了个人姓名 |
```

> 🔴 无效和非发票凭证不计入报销金额，单独列出供用户跟进。

### 2.5 对话/文本录入

用户口述或粘贴文本时，直接解析为标准字段，无需 OCR。

### 标准数据结构

所有发票统一录入为：
```
ID | 日期 | 类别 | 总金额 | 不含税金额 | 税额 | 用途说明 | 商家/供应商 | 发票号码 | 发票类型 | 人数 | 同行人/同住人 | 抬头 | 有效 | 备注
```

类别枚举：🚂 交通 / 🏨 住宿 / 🍽️ 餐饮 / 📦 其他
发票类型枚举：增值税专用发票 / 增值税普通发票 / 增值税电子发票 / 定额发票 / 火车票 / 机票行程单 / 出租车票 / 费用清单 / 收据 / 其他

---

## Step 3：分类整理 + 行程重建 + 文件整理

### 3.1 分类清单

分类顺序：交通 → 住宿 → 餐饮 → 其他，每类按日期升序，自动小计。
- 🔴 无效发票和 📄 非发票凭证单独列出，不混入正常分类
- 同行人/同住人信息附在对应条目后（交通显示同行人，住宿显示同住人，餐饮显示用餐人数）

### 3.2 行程重建

从发票时间线自动推断出差行程，输出逐日日志：

```markdown
## 📅 出差行程日志

**出差目的地：** [从交通/住宿推断]
**出差时间：** YYYY-MM-DD 至 YYYY-MM-DD（共 X 天）

### 5月10日（周一）
- 🚂 08:30 北京南 → 上海虹桥（高铁G2，¥553.50，**同行人：李明、王芳**）
- 🏨 住宿：XX酒店，上海（¥388/晚，**同住人：张三**）
- 🍽️ 晚餐工作餐（¥126，3人，人均¥42）
- 💰 **当日差旅补贴**：¥100（按公司标准100/天计）
```

如果某天信息不完整，加注 `⚠️ 信息待补充`。

### 3.3 腾讯会议日程核对（可选）

调用 `tmeet-skill` 获取出差期间的会议日程，自动填入行程日志空白天，标注来源 📎 腾讯会议日程。

**降级**：腾讯会议功能不可用时跳过，空白天保留"建议补充当日活动记录"。

### 3.4 发票文件整理（可选）

发票数据整理完成后，主动询问用户是否需要整理发票文件本身：

> "发票数据整理好了！你的发票文件要不要也整理一下？比如把 IMG_001.jpg 改成 2026-05-10_交通_北京→上海高铁_553.50.jpg 这样一眼就认得出来的名字。"

**用户可选的命名规则：**

| 规则 | 格式 | 示例 | 适合场景 |
|------|------|------|---------|
| **A** | 日期_类别_用途_金额 | `2026-05-10_交通_北京→上海高铁_553.50.jpg` | 最常用，一眼认出 |
| **B** | 序号_日期_类别 | `01_2026-05-10_交通.jpg` | 简洁，适合归档 |
| **C** | 类别_日期_序号 | `交通_2026-05-10_01.jpg` | 按类别归类 |
| **D** | 日期_发票类型_金额 | `2026-05-10_增值税电子发票_553.50.jpg` | 区分发票类型 |

**执行流程：**

```
1. 向导展示预览表：原文件名 → 新文件名
2. 用户确认命名规则和预览结果
3. 选择操作方式：
   a. 在原文件夹内重命名（原文件名消失）
   b. 复制到新文件夹（推荐，原文件保留）
4. 执行并报告结果
```

**安全设计：**
- 默认只预览不执行，用户确认后才操作
- 推荐复制到新文件夹，原文件不受影响
- 文件名中的特殊字符自动替换为下划线
- 重名文件自动添加序号避免覆盖

**脚本**：`scripts/rename_files.py`，支持 `--preview` / `--execute` / `--output-dir` 参数。

**用户也可跳过**：说"不用了"即跳过文件整理。

---

## Step 4：报销单生成

默认输出 Markdown 格式。如用户有自定义格式，直接按格式排版。

读取 `references/reimbursement-templates.md` 获取预置模板（标准版/简版/项目分摊版/CSV/精细格式）。

**差补与税额处理（金额计算一律调脚本，不凭 LLM 心算）：**

所有“算钱”的环节都调用 `scripts/amounts.py`（全程 Decimal 货币运算，可复算、有单测保障），不要手动口算：
- **差补计算**：`python amounts.py per-diem --days N --rate 每日标准 --mode full|half-end|workday [--deduct-meals 已实报餐费]`。公式 `实际天数 × 每日标准`；half-end=出发/返程各半天；workday=仅工作日。
- **税额分离**：`python amounts.py tax --input invoices.json`。从价税合计分离可抵扣税额（优先用 OCR 税额，其次按 tax_rate 反算；都没有则不杜撞、税额记 0），输出可抵扣税额合计。（最终是否可实质抵扣以税务规则为准）
- **红字冲销**：`python amounts.py offset --input invoices.json`。退改签/红字发票金额作负数冲减，按 vendor+金额与原票配对，输出冲销后净额。
- **按支付方式拆分**：`python amounts.py payment --input invoices.json`。把报销拆成个人垄付（需还款）/ 公司账户支付（已付不再报）/ 未标注，报销单按这三类分列，便于会计做账。

### 一键导出到腾讯文档

生成报销单后主动询问：
> "报销单已生成！需要导出到腾讯文档吗？可以直接生成在线文档提交审批。"

支持三种格式：
- **智能文档**（推荐）— `mcp__tencent-docs__create_smartcanvas_by_mdx`，排版丰富
- **在线表格** — `mcp__kdocs__create_file_with_content`，适合财务逐行审核
- **标准文档** — 简洁，适合打印签字

行程日志也可单独导出为智能文档（兼作出差报告）。

**降级**：腾讯文档功能不可用时，保存为本地 Markdown。

---

## Step 5：合规审查

参照 `references/compliance-rules.md` 执行合规检查。

### 核心原则：没有依据，不判定

合规检查分三类，执行逻辑完全不同：

| 类型 | 检查项 | 是否需要财务制度 | 无制度时 |
|------|--------|-----------------|---------|
| **结构化检查** | 连号发票、住宿缺失、交通断链、日期异常 | ❌ 不需要 | 始终执行 |
| **发票有效性检查** | 抬头核对、发票章检测、类型识别、重复检测 | ❌ 不需要* | 始终执行 |
| **阈值检查** | 餐饮人均、住宿单价、大额单笔 | ✅ 必须有 | ⏭️ 跳过并告知 |

*发票有效性检查中的抬头核对需要用户提供公司全称，没有则跳过该子项。

### 结构化检查（始终执行）

| 检查项 | 逻辑 | 输出格式 |
|--------|------|---------|
| 🔴 连号发票 | 同一供应商 ≥3 张连续编号 | 🔴 [连号预警] XX供应商发现3张连号发票(号码XXX-XXX) → 建议核实是否为正常开票 |
| ⚠️ 住宿缺失 | 非常驻城市过夜无住宿发票 | ⚠️ [住宿缺失] 5月12日在北京无住宿发票 → 建议补充或说明原因 |
| ⚠️ 交通断链 | A→B 城市移动无交通票 | ⚠️ [交通断链] 5月10日上海→北京无交通票 → 建议补充交通凭证 |
| 🔴 行程冲突 | 时间地点重叠、不合常理 | 🔴 [行程冲突] 5月12日同时出现上海酒店和北京餐饮记录 → 请核实发票日期或归属 |
| ⚠️ 退改签说明 | 出现退票费、改签费 | ⚠️ [退改签费] 存在一笔机票退票费¥120 → 建议在备注中说明退改签原因 |
| ⚠️ 日期异常 | 发票日期超出出差范围 ±7天 | ⚠️ [日期异常] 5月3日发票不在出差期间(5月10-20日) → 请确认是否属于本次出差 |
| ⚠️ 同行人缺失 | 多人用餐无同行人记录 | ⚠️ [同行人缺失] 用餐X人但未标注同行人姓名 → 建议补充（便于证明非私人宴请） |

### 发票有效性检查（始终执行）

| 检查项 | 逻辑 | 输出格式 |
|--------|------|---------|
| 🔴 抬头不符 | 发票购买方名称 ≠ 公司全称 | 🔴 [抬头错误] 购买方"XX"与公司全称"YY"不符 → 需重新开票（**需用户提供公司全称，没有则跳过**） |
| 🔴 手撕票无章 | 定额发票未加盖发票专用章 | 🔴 [发票无效] 定额发票未盖发票专用章 → 不可报销，需换开发票 |
| 🔴 重复发票 | 发票号码+日期+金额完全相同 | 🔴 [重复发票] 发票号XXX出现2次 → 保留一张，核实是否重复报销 |
| 📄 非发票凭证 | 费用清单/收据/支付截图等 | 📄 [非发票] 此为XX(费用清单/收据等)，非正式发票 → 需补开发票，不计入报销金额 |
| ⚠️ 类型待确认 | 无法判断发票类型 | ⚠️ [类型待确认] 无法判断此凭证类型 → 请人工确认 |

### 阈值检查（有制度才执行）

| 检查项 | 需要制度中的标准 | 输出格式 |
|--------|----------------|---------|
| 🟡/🔴 餐饮人均 | 工作餐上限、接待餐上限 | 🟡/🔴 [餐饮超标] 人均¥XX，贵司标准¥YY/人（依据：XX第X条）→ 建议附说明或调整 |
| ⚠️ 同行人缺失 | 人数 > 1 时检查同行人记录 | ⚠️ [同行人缺失] 用餐X人但未标注同行人姓名 → 建议补充（便于证明非私人宴请） |
| 🟡/🔴 住宿单价 | 各城市/级别住宿上限 | 🟡/🔴 [住宿超标] 单价¥XX，贵司标准¥YY/晚（依据：XX第X条）→ 建议附说明或调整 |
| ℹ️ 大额单笔 | 大额界定金额 | ℹ️ [大额提醒] 单笔¥XX超过贵司大额标准¥YY（依据：XX第X条）→ 建议附说明 |

**有制度时，每条结论标注依据（三段式：问题类型 → 具体原因 → 建议操作）：**
> 🔴 [餐饮超标] 5月12日工作餐人均 ¥180，贵司标准为 ¥150/人（依据：差旅管理办法第8条）→ 建议附说明或调整报销金额

**无制度时，跳过并明确告知：**
> ⏭️ [缺少依据] 餐饮人均检查：未提供财务制度 → 跳过。如需检查，请提供贵司餐饮标准

### 合规报告——分层输出

**摘要表（始终展示）：**

```markdown
## 🔍 合规审查摘要

| 检查项 | 类型 | 状态 | 发现 |
|--------|------|------|------|
| 连号发票 | 结构化 | ✅ / 🔴 | 0 / X 项 |
| 发票有效性 | 有效性 | ✅ / 🔴 | X项无效 / 全部有效 |
| 抬头核对 | 有效性 | ✅ / 🔴 / ⏭️ | 全部正确 / X项不符 / 未提供公司名称 |
| 住宿覆盖 | 结构化 | ✅ / ⚠️ | 完整 / X 天缺失 |
| 交通断链 | 结构化 | ✅ / ⚠️ | 无断链 / X 处 |
| 行程合理性 | 结构化 | ✅ / 🔴 / ⚠️ | 合理 / X 处行程冲突 / 包含退改签 |
| 餐饮人均 | 阈值 | ✅ / 🟡 / 🔴 / ⏭️ | 有制度时判定 / 无制度跳过 |
| 住宿单价 | 阈值 | ✅ / 🔴 / ⏭️ | 有制度时判定 / 无制度跳过 |
| 同行人缺失 | 数据关联 | ✅ / ⚠️ | 全部已标注 / X 条缺失 |
```

**详细问题（仅异常时展开）：** 没问题的检查项不输出详情，减少噪音。

### 企微合规通知（企业微信集成）

仅当存在 🔴 严重问题时，通过 `wecomcli-msg` 推送企微提醒（🟡/⚠️ 不推送，避免消息疲劳）。

**降级**：企业微信功能不可用时仅在对话中展示。

---

## Step 6：拓展菜单

核心流程完成后，可询问用户是否需要增强功能：

> "基础整理已完成！以下是一些可选功能，有需要告诉我："

| 编号 | 功能 | 所需环境 |
|------|------|---------|
| A | 📤 导出到腾讯文档 | 腾讯文档 |
| B | 📊 费用统计图表 | 内置 |
| C | 🔄 多次出差月度汇总 | 内置 |
| D | 🏷️ 项目/成本中心分摊 | 内置 |
| E | 📧 生成报销申请邮件 | QQ邮箱 |
| F | 💾 保存报销单为模板 | 内置 |
| G | 📋 导出在线表格 | 腾讯文档 |
| H | 📅 同步会议日程 | 腾讯会议 |
| I | 📁 整理发票文件（如未在 Step 3 执行） | 内置 |

用户回复「不用了」或「完成」即退出。标注"内置"的无需额外配置。

---

## 常见指令速查

| 用户说 | 处理方式 |
|--------|---------|
| 「帮我整理这堆发票」 | 进入完整流程 Step 1 |
| 「我有个文件夹全是发票——~/Downloads/出差发票」 | Step 2 文件夹批量读取 |
| 「只做合规检查」 | 跳至 Step 5，先确认是否有财务制度 |
| 「只要报销单，格式用我们公司的」 | 先收集数据，Step 4 询问自定义格式 |
| 「帮我补全行程」 | 运行 Step 3 行程重建 |
| 「我们公司餐饮标准是XX元/人，差补每天100」 | 设置合规阈值和差补标准，后续自动计算和核对 |
| 「发你我们公司的差旅制度」 | 解析制度提取阈值，确认后用于合规检查 |
| 「我们公司全称是XX科技有限公司」 | 设置抬头核对标准 |
| 「导出到腾讯文档」 | Step 4 一键导出 |
| 「帮我核对会议日程」 | Step 3.3 调用腾讯会议 |
| 「用专业OCR重新识别」 | 升级到 Layer 2/3 重新识别 |
| 「帮我把发票文件也整理一下」 | Step 3.4 文件重命名 |

---

## 反模式（常见误用）

| ❌ 错误用法 | ✅ 正确用法 | 原因 |
|------------|-----------|------|
| 一张张上传50张发票照片 | 指定文件夹路径让向导批量读取 | 文件夹读取自动扫描+分批识别，效率高10倍 |
| 等所有信息完美才让向导开始 | 先给部分信息，后面随时补充 | 向导支持边整理边补，不要求一次完美 |
| 只说「帮我报销」不给任何发票信息 | 至少提供发票照片/文件夹路径/文字清单 | 没有原始数据，向导无法凭空生成报销单 |
| 把私人消费发票混在出差发票里 | 出差发票单独整理，私人费用分开 | 合规审查会标记出差范围外的发票 |
| 忽略合规审查中的 🟡 提醒 | 即使 🟡 也应逐条确认 | 🟡 只是建议级，但可能是合规隐患 |
| 不提供财务制度就期望精准合规判定 | 先提供制度，或接受仅结构化检查 | 阈值检查没有制度依据会误判 |
| 不提供公司全称就期望抬头核对 | 先告诉公司全称，或接受跳过抬头检查 | 抬头核对需要公司名称作为比对基准 |
| 直接在原文件夹执行重命名 | 选择复制到新文件夹，保留原文件 | 原文件是原始凭证，建议保留备份 |

---

## 常见问题

**Q：需要什么配置才能用？**
A：零配置。直接说「帮我整理报销」就行。发票照片拖进对话，AI 视觉直接识别。有大量发票的话，告诉向导文件夹路径即可批量处理。

**Q：没有公司的财务制度能用吗？**
A：能。向导会执行结构化检查（连号发票、住宿缺失、交通断链、日期异常、发票有效性），这些不依赖公司制度。但餐饮人均超标、住宿单价上限这类检查需要制度标准，没有制度会跳过并告知原因。

**Q：怎么提供财务制度？**
A：三种方式——① 上传制度文件（PDF/Word/图片），向导自动解析；② 口头告诉关键标准（「工作餐上限150，接待餐300」）；③ 用模板（会发你一个模板填写后上传）。

**Q：开票抬头核对怎么用？**
A：在 Step 1 告诉向导你的公司全称（和税号，可选），向导会自动核对每张发票的抬头是否正确。没提供公司名称则跳过抬头核对。

**Q：一次只能上传9张发票吗？**
A：不是。三种方式绕开9张限制：① 告诉向导本地文件夹路径，向导直接批量读取所有文件；② 分批上传，每批9张；③ 粘贴文字清单。**推荐文件夹方式**，几十张发票一次搞定。

**Q：发票文件可以重命名吗？**
A：可以。Step 3 整理完成后，向导会询问是否需要把发票文件也整理一下——把 IMG_001.jpg 改成 2026-05-10_交通_北京→上海高铁_553.50.jpg 这样一眼就认出来的名字。支持4种命名规则可选，默认只预览，确认后才执行。建议复制到新文件夹，原文件保留。

**Q：支持哪些文件格式？**
A：图片（JPG/PNG/HEIC/BMP/TIFF/WEBP）、PDF、OFD（增值税发票专用格式）、ZIP压缩包（自动解压）。最常见的是手机拍照（JPG/PNG）和电子发票（PDF）。

**Q：OFD格式是什么？**
A：OFD是增值税电子发票的官方版式格式（类似PDF但国内专用）。如果向导无法直接读取OFD，建议用发票开具平台的"导出PDF"功能转为PDF后提供。

**Q：手撕票（定额发票）没有盖章能用吗？**
A：不能。定额发票必须加盖发票专用章才有效。向导会自动检测并标记无章定额发票为无效。

**Q：费用清单/收据能当发票报销吗？**
A：不能。费用清单、收据、支付截图等只是佐证材料，不是发票。向导会自动识别并标注，提醒你需要补开发票。

**Q：连接了腾讯文档/企业微信/腾讯会议有什么额外好处？**
A：连接后自动获得：批量 OCR 识别、一键导出在线文档、合规超标企微提醒、会议日程自动补全行程。

**Q：发票照片拍得不清楚怎么办？**
A：手动修正即可，直接说「第3张金额是128元」。或说「用专业OCR重新识别」，向导会升级到更精准的识别方式。

**Q：有些发票忘记拍了怎么办？**
A：用文字补录：「还有一张5月12日的出租车票，100元，从酒店到机场」。

**Q：合规审查的结论可信吗？**
A：结构化检查（连号/缺失/断链/有效性）基于逻辑一致性和发票规则，无需制度。阈值检查的每条结论都会标注依据来源（制度名称+条款号或「用户口述」），绝不使用杜撰的标准做判定。发票真伪验证需通过税务系统，本向导不提供验真服务。

**Q：生成的行程日志能当出差报告吗？**
A：能。行程日志已包含逐日活动、费用汇总，补充"工作成果与收获"部分即可提交。连接腾讯会议后，会议日程会自动填入。

**Q：VatInvoiceOCR 收费吗？**
A：腾讯文档 OCR 完全免费；VatInvoiceOCR 每月 1000 次免费额度（个人出差 20-50 张发票完全够用）。

---

## 注意事项

- **Step 1 必做**：始终先采集上下文（常驻城市、出差日期），后续步骤依赖此信息
- **财务制度优先**：有制度才能做阈值检查，没有则仅做结构化检查并明确告知
- **抬头核对需公司名称**：有公司全称才能核对抬头，没有则跳过并告知
- **发票有效性始终检测**：类型识别、发票章、非发票标注不需要额外配置
- 若用户未提供人数，餐饮合规检查注明缺失而非跳过
- 发票号码如用户未提供，该检查项标注「数据不足，跳过」而非误报
- 行程日志可直接当出差报告正文，提醒用户补充业务成果
- 自定义报销单：若用户提供公司模板，直接适配，无需二次确认
- 每个集成点都有降级策略，功能不可用时不阻塞主流程
- OCR 批量上限：`ocr.toexcel` 单次最多 9 张，超过 9 张时分批调用
- 三层 OCR 调度原则：能用 Layer 1 就不用 Layer 2，能用 Layer 2 就不用 Layer 3
- 合规报告分层原则：摘要表始终输出，详细问题仅异常时展开
- 环境变量统一：`TENCENTCLOUD_SECRET_ID` / `TENCENTCLOUD_SECRET_KEY`
- **无效发票和佐证材料不计入报销金额**，单独列出供用户跟进
- **文件重命名默认只预览**，用户确认后才执行，推荐复制到新文件夹保留原文件