Invoice Processor

Key Design Principles

1. LLM视觉识别优先: 使用LLM的多模态能力直接识别发票图片内容，无需OCR中间件
2. 分类驱动命名: 根据报销类别(住宿费/交通费/办公用品/其他)+事项自动生成文件名
3. Excel模板适配: 严格匹配报销模板的9列结构，自动填充已有字段
4. 人工审核兜底: 识别置信度低时标记待审核，不强制填入
5. OpenClaw兼容: 支持zip输入/输出，智能检测内部结构，无缝衔接现有流程
6. 智能去重: 基于识别信息（日期+金额+发票号）去重，避免误删不同日期的同金额记录

⚠️ Mandatory Prerequisites (强制前置条件)

⛔ 禁止跳过: 在执行任何操作之前，必须完整阅读以下文档。

规范文档 (必读)

模板文件 (生成前必读)

运行模式

local 模式 (默认)

用户指定本地目录，skill 直接扫描 图/ 和 发票/ 子目录。

Phase 1(扫描) → Phase 2(识别) → Phase 3(分类重命名) → Phase 4(填Excel) → Phase 5(验证)

openclaw 模式

用户通过聊天发送zip压缩包，skill 自动解压、检测结构、处理、打包回传。

Phase 0.5(解压+检测) → Phase 1-5(不变) → Phase 6(打包回传)

触发方式: 用户消息中包含 .zip 文件路径

zip内部结构支持:

• 标准结构: 含 图/ + 发票/ 目录 + 报销模板.xlsx
• 非标准结构: 含子目录但名称不同，自动归类
• 平铺结构: 无子目录，全部文件自动按类型归类

Directory Setup

local 模式

const timestamp = new Date().toISOString().slice(0,19).replace(/[-:T]/g, '');
const workDir = `${projectDir}/invoice-processor/.scratchpad/invoice-${timestamp}`;

Bash(`mkdir -p "${workDir}"`);
Bash(`mkdir -p "${workDir}/context"`);
Bash(`mkdir -p "${workDir}/classified"`);

openclaw 模式

const timestamp = new Date().toISOString().slice(0,19).replace(/[-:T]/g, '');
const extractDir = `${skillDir}/.scratchpad/invoice-${timestamp}/extracted`;
const workDir = `${skillDir}/.scratchpad/invoice-${timestamp}`;

// Phase 0.5 会自动创建 extractDir 和标准目录结构

Output Structure

local 模式

{projectDir}/
├── 报销清单.xlsx                 # 最终输出的报销Excel
├── 发票/                         # 已分类重命名的发票
│   ├── 住宿费/
│   ├── 交通费/
│   ├── 办公用品/
│   └── 其他/
├── 图/                           # 已分类重命名的图片
│   ├── 住宿费/
│   ├── 交通费/
│   ├── 办公用品/
│   └── 其他/
└── invoice-processor/
    └── .scratchpad/
        └── invoice-{timestamp}/
            ├── invoices-index.json
            ├── recognition-results.json
            ├── renamed-files.json
            └── validation-report.json

openclaw 模式

invoice-processor/.scratchpad/invoice-{timestamp}/
├── extracted/                    # 解压后的标准目录
│   ├── 图/                       # 归类的图片
│   ├── 发票/                     # 归类的发票/PDF
│   ├── 分类/                     # 已分类重命名的文件
│   └── project-config.json
├── invoices-index.json
├── recognition-results.json
├── renamed-files.json
├── validation-report.json
└── 报销处理结果-{timestamp}.zip   # 最终回传给用户的zip

Reference Documents