技能介绍

记账数据为什么难长期维护

银行、支付宝、微信支付和信用卡的账单格式各不相同。更麻烦的是增量导入：同一个文件重复上传、同一个商户在同一天出现多次、导出表头中英文混用，都会让自建脚本逐渐失效。private-finance-ledger 只解决一个问题：把个人流水稳定地汇入一个本地 SQLite 数据库，并在不泄露原始数据的前提下完成查询和报告。

工作方式

支持 XLSX、CSV、XLS，先运行 scripts/inspect_file.py 识别 sheet、表头和数据范围；对新格式先确认字段映射，再用 --dry-run 预览新增、更新、跳过和错误行。正式导入前自动备份，整个批次在单个事务中执行；任一步失败即回滚，随后执行完整性检查、行数与金额汇总校验。

去重采用两层键：优先使用原账单的 order_id、流水号等来源标识，无法取得时退回 账户 + 日期时间 + 金额分值 + 币种 + 收款方 + 引用号 的组合；content_hash 负责识别同一笔记录的内容变化。分析通过 scripts/query_finance.py 的固定只读函数完成，不执行任意 SQL，输出月度收支、现金流、分类占比、重点商户、异常大额和重复缺失检查。图表和 PDF 固定写入私有目录，并统一中文展示。

适用边界

仅用于个人私有运行环境。不要在共享、公开或多租户 Agent 中接入真实数据；仅使用专用 profile 或严格用户隔离。禁止把 ledger.db、备份、CSV 或完整明细发给外部 API、LLM、MCP 等第三方；默认只输出聚合统计，必要时才限定行数。不适合报税、审计或投资建议，也不应作为团队账务系统。