icost

一个用于将中国工商银行（ICBC）账单转换为统一 icost 记账格式的命令行工具。

功能

• 从 PDF、CSV 或 Excel 账单中读取交易数据
• 自动识别信用卡/借记卡版式
• 可选调用 OpenAI API 进行分类
• 导出为包含日期、类型、金额、分类等字段的 Excel 文件

安装

pip install -r requirements.txt

使用示例

# 自动判断信用卡/借记卡
python main.py --input /path/to/icbc.pdf --output ./out/icbc_book.xlsx

# 强制按信用卡或借记卡处理
python main.py --input /path/to/icbc.pdf --output ./out.xlsx --mode credit
python main.py --input /path/to/icbc.pdf --output ./out.xlsx --mode debit

# 启用 OpenAI 分类
python main.py --input /path/to/icbc.pdf --output ./out.xlsx --use-openai --api-key YOUR_KEY

项目结构

main.py               命令行入口
icost/
    icbc_parser.py    PDF 账单解析
    cleaner.py        数据清洗与分类
    exporter.py       Excel 导出
    utils.py          工具函数

许可证

本项目基于 Apache License 2.0 开源，详见 LICENSE。