账单分类助手

要解决的问题

个人账单文件常常分散在 Excel、CSV 和图片中，表头位置、sheet 选择、重复记录和导出模板都不一致。这个技能把整理工作拆成可审计的本地处理步骤，而不是让模型一次性吞下完整账单。

技能如何工作

工作流会先确认目标模板为 icost 或 cookie，默认币种为 CNY，并为每次运行创建独立目录和 workflow-config.json。随后按阶段执行：

• 用 inspect_bill_file.py 读取文件类型、编码、sheet、行数和预览
• 多 sheet 的 Excel 需要用户确认交易明细 sheet，agent 不自行判断
• 对确认 sheet 做 structure-detection，识别表头、交易起始行和关键列
• 用 chunk_bill_rows.py 按完整记录切块，再 normalize_table_chunks.py 生成 billList、skippedItems、warnings
• 图片由支持视觉的模型识别，并保留来源图片
• 最后校验、合并、按 datetime + price + type 去重，导出 CSV 并生成审计报告

适用边界

该技能面向本地账单整理，不依赖 Web 服务、登录、Supabase、Mastra 或项目代码。它不做汇率换算、二级分类、账户转账抵消，也不输出 XLSX。完整原始 chunk 默认不长期保留，除非配置隐私选项。