用途:把新的财务导出文件解析并规范化写入 ~/Documents/finances/ 下的追加式交易账本。
主要能力:支持多类来源,包括 BofA CSV、Strike 年度对账单、River 活动 CSV、Robinhood 等;按来源写入对应 jsonl 目标文件,例如 BofA 写入 data/transactions/bofa.jsonl,Strike 写入 strike.jsonl,River 写入 river.jsonl,Robinhood 写入 robinhood.jsonl。去重规则为 sha256(source+date+amount+description)[:16],确定性生成交易 ID,重复导入同一文件安全,重复项会被计数并跳过。Copilot 是银行类主要来源(BofA 支票、Apple Card、Apple Cash、Apple Savings),原始 BofA CSV 仅作补充明细,避免重复计支出。
使用方式:把新导出文件放入 ~/Documents/finances/source/ 对应子目录(bank、crypto、brokerage),或运行 uv run python scripts/sync_moneta.py 从 Moneta 同步;然后执行 cd ~/Documents/finances && uv run python scripts/ingest.py。可用 --dry-run 只计数不写入,用 --source bofa 仅处理单一来源。Copilot 交易通过 scripts/backfill.py 一次性导入,或把新导出放到 ~/Documents/finances/ 根目录。导入后可运行 /finances-report 查看更新后的分析。
适用场景:个人财务数据归档与统一账本维护,适合定期导入银行、加密与券商导出。
限制:资料未提供安装步骤、依赖版本、支持文件格式细节、错误处理、平台兼容性、收费或价格信息;具体字段映射与账本结构暂未提供。