financial-expense-automation

Financial Expense Automation

目标

运行本地 Financial Automation 流水线，对用户上传的报销票据进行：

• 识别
• 结构化提取
• 校验
• 真实写入飞书多维表格

请始终记住：

• bitable_write_plan 只是中间产物
• 识别成功不等于任务完成
• 只有真实调用 Feishu Bitable create/update 成功，并完成回读确认，才算完成

项目依赖

这个 skill 依赖完整项目仓库，不能只拷贝 SKILL.md 单独使用。

按以下顺序定位项目根目录：

1. 环境变量 FINANCIAL_AUTOMATION_ROOT
2. ~/projects/agentic-ai/financial-automation
3. ~/.openclaw/workspace/financial-automation

若这些路径都不存在，应明确告诉用户：当前环境尚未部署完整项目仓库，请先完成部署。

主要入口与配置：

• <repo_root>/src/skill_entry.py
• <repo_root>/config/app_config.yaml

支持输入

附件输入格式：

[
    {"file_name": "hotel_invoice.pdf", "content_bytes": b"..."},
    {"file_name": "ticket.jpg", "source_path": "/path/to/ticket.jpg"},
]

支持文件类型：

• .pdf
• .jpg
• .jpeg
• .png

若过滤后没有可处理附件，应直接告知用户：没有收到可处理的报销附件。

非报销内容处理

识别完成后，若内容不是报销票据（如普通图片、截图、合同等），应：

1. 告知用户：该附件不是可识别的报销票据
2. 简述识别到的内容类型
3. 终止流程，不继续写表

唯一入口

必须通过：

from src.skill_entry import run_skill_job
result = run_skill_job(attachments)

如有需要可显式传配置：

result = run_skill_job(
    attachments,
    config_path=f"{repo_root}/config/app_config.yaml",
)

不要手工拼接 ingest / OCR / validate / formatter 流程。

正式执行流程

1. 定位 repo root
2. 将用户上传文件整理成 run_skill_job(...) 所需的附件 payload
3. 调用 run_skill_job(...)
4. 使用返回的 skill_result 作为识别结果主对象
5. 生成真实写表输入
6. 若当前会话具备 Feishu Bitable 工具能力，继续执行真实写表
7. 写入后回读确认，再向用户回复结果

写表强制规则

1. bitable_write_plan 只是中间产物，不是最终结果
2. 只要当前会话可用飞书多维表格工具，就必须继续真实写表
3. 禁止停留在“建议写入 / 准备写入 / 可写入”状态
4. 只有真正调用 create/update 成功，才算完成
5. 如果没有真实写入成功，必须明确说明失败点
6. 禁止把“已识别 / 已生成 plan / 已生成 handoff”描述成已经完成落表

目标表路由规则

• transportation_fee → 交通报销表
• 其他费用类票据 → 费用报销表

写入策略

默认采用：

• update_first_blank_row_then_create

具体规则：

1. 先查询目标表
2. 若存在可复用空白行（优先判断 doc_id 为空），优先 update
3. 若不存在可复用空白行，再 create
4. 不要盲目追加新记录

附件写入规则

附件字段必须遵守以下规则：

1. 禁止直接使用通用 Drive upload token 作为 Bitable 附件
2. 必须先上传到当前 bitable attachment context
3. 再将返回的合法 file_token 写入附件字段
4. 图片走 bitable_image
5. PDF/其他文件走 bitable_file