
个人财务 · 功能说明
我在意的是“真花掉了多少”,不是“钱进进出出了多少”。同一笔钱在几个账单里出现好几次,只算一次;还款和倒钱不算花。
当前情况:消费统计在个人理解库里实现,有专项自动测试;10 月 21 日储蓄卡流水分类和美元结算核对已用于重算月均消费。重复扣款由程序先列出疑似,AI 再逐条核对。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


个人财务 · 功能说明
我在意的是“真花掉了多少”,不是“钱进进出出了多少”。同一笔钱在几个账单里出现好几次,只算一次;还款和倒钱不算花。
当前情况:消费统计在个人理解库里实现,有专项自动测试;10 月 21 日储蓄卡流水分类和美元结算核对已用于重算月均消费。重复扣款由程序先列出疑似,AI 再逐条核对。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
同一笔钱在账单里会出现好几次:支付宝付一次、信用卡记一次,月底还信用卡又出现一次,退款再回来一次。直接加起来会多算;只看一个来源,又会漏掉先用后付和储蓄卡直接扣的。
(示例)在电商平台用支付宝绑的信用卡买了件东西,后来退了一部分。支付宝、信用卡账单、电商订单里各有一条,月底还款又有一条。对完只剩一笔消费:实付减成功退款;还款那条不算;三条记录合成一笔,不重复。
(示例)上个月买的东西,这个月才退货到账。退款算回买它的那个月:上个月的消费净额被这笔已确认的退款改小,这个月不会冒出一笔“负的消费”。这个月实际收进的那笔退款另记在“期间资金流”里,用来对照银行卡和钱包当月的真实进出。月均消费和现金跑道只用前一种,按买东西的月份算。
(示例)在某家店充了储值卡或买了购物金。钱确实付出去了,但这时还没买到任何东西,所以它不进消费净额,单列成“商户预付”;它也不是能马上取出来花的钱,不算进余额。普通订阅、游戏或 AI 服务的充值,以及别人替我代充值的服务,照样算消费,不因为带“充值”两个字就排除。
按月、按币种的消费净额,加上单列的“待归并”和“币种不明”金额,单列的“商户预付”,按收付日期另记的“期间资金流”,以及一句覆盖说明:哪些算进去了、哪些没算、为什么。
对清的进消费净额,附覆盖说明。
证据不够合并的放进待归并,不算也不丢;真的重复扣款挂驾驶舱请我处理。
某个来源这个月缺了:结果只叫“已识别小计”,不说成全部花费。

用途与实际影响
同一笔钱在账单里会出现好几次:支付宝付一次、信用卡记一次,月底还信用卡又出现一次,退款再回来一次。直接加起来会多算;只看一个来源,又会漏掉先用后付和储蓄卡直接扣的。
(示例)在电商平台用支付宝绑的信用卡买了件东西,后来退了一部分。支付宝、信用卡账单、电商订单里各有一条,月底还款又有一条。对完只剩一笔消费:实付减成功退款;还款那条不算;三条记录合成一笔,不重复。
(示例)上个月买的东西,这个月才退货到账。退款算回买它的那个月:上个月的消费净额被这笔已确认的退款改小,这个月不会冒出一笔“负的消费”。这个月实际收进的那笔退款另记在“期间资金流”里,用来对照银行卡和钱包当月的真实进出。月均消费和现金跑道只用前一种,按买东西的月份算。
(示例)在某家店充了储值卡或买了购物金。钱确实付出去了,但这时还没买到任何东西,所以它不进消费净额,单列成“商户预付”;它也不是能马上取出来花的钱,不算进余额。普通订阅、游戏或 AI 服务的充值,以及别人替我代充值的服务,照样算消费,不因为带“充值”两个字就排除。
按月、按币种的消费净额,加上单列的“待归并”和“币种不明”金额,单列的“商户预付”,按收付日期另记的“期间资金流”,以及一句覆盖说明:哪些算进去了、哪些没算、为什么。
对清的进消费净额,附覆盖说明。
证据不够合并的放进待归并,不算也不丢;真的重复扣款挂驾驶舱请我处理。
某个来源这个月缺了:结果只叫“已识别小计”,不说成全部花费。

月度总更新导入完成后接着做;平时问“这个月实际花了多少”“上个月比这个月多花在哪”也走这一步。
- 已导入的账单和订单(见账单每月收一次)
- 要看的日期区间;不说就按完整自然月


月度总更新导入完成后接着做;平时问“这个月实际花了多少”“上个月比这个月多花在哪”也走这一步。
- 已导入的账单和订单(见账单每月收一次)
- 要看的日期区间;不说就按完整自然月



- aggregate_spending 把同一笔消费的订单、支付、卡记录归成一组(并查集);只有候选关联的不强行合并。
- _notice_matches_statement 把信用卡每日通知和月单对上:同一张卡、同一商户、同金额或原币金额一致;外币时日期可差一天。
- _duplicate_charge_alerts 找疑似重复扣款,结果放在 duplicate_charges:同一商户、同一币种、扣掉已关联退款后还剩同样金额的几笔独立扣款才列出;分期、预授权、冲正、撤销、失败、取消、关闭的不列,退款状态说不清的不列,商户只写成支付宝、微信支付这类泛称的也不列。它只提示,不改任何一笔的消费归属;列出来的由 AI 逐条核对,真重复才挂驾驶舱。
- classify_debit 把储蓄卡流水分成本人操作、还款借贷、收入、退款、消费五类,按配置的还款关键词和本人名称判断。


- aggregate_spending 把同一笔消费的订单、支付、卡记录归成一组(并查集);只有候选关联的不强行合并。
- _notice_matches_statement 把信用卡每日通知和月单对上:同一张卡、同一商户、同金额或原币金额一致;外币时日期可差一天。
- _duplicate_charge_alerts 找疑似重复扣款,结果放在 duplicate_charges:同一商户、同一币种、扣掉已关联退款后还剩同样金额的几笔独立扣款才列出;分期、预授权、冲正、撤销、失败、取消、关闭的不列,退款状态说不清的不列,商户只写成支付宝、微信支付这类泛称的也不列。它只提示,不改任何一笔的消费归属;列出来的由 AI 逐条核对,真重复才挂驾驶舱。
- classify_debit 把储蓄卡流水分成本人操作、还款借贷、收入、退款、消费五类,按配置的还款关键词和本人名称判断。

- 输出字段:按币种的 consumption_net;total_interpretation 默认是“已识别消费小计,不含待归并和商户预付”;uncertainty 写候选组数和是否证明完整;unresolved_amounts、unknown_currency_amounts 单列。
- 两套日期口径:consumption_net 按购买归属记账,日期取这一笔最早的付款或订单时间,已关联的成功退款(含跨月退款)在这一笔里扣掉;observed_flow_net 是期间资金流,付款按付款时间加、退款按退款时间减。退款没有真实时间的,不进资金流,也不补造日期。personal-finance 的月均和跑道只取 consumption_net(AGENTS.md 指定)。
- 只有本人确认账本基本覆盖、又没有待归并和币种不明时,total_interpretation 才改成“扣退款后的消费净额”。
- 商户预付:品名里明确写着购物金、储值卡、储值金、储值余额、储值充值或预付余额的,单列 merchant_prepayment_net(另有 merchant_prepayment_gross 和 merchant_prepayment_refunds),不进 consumption_net;付款仍记进期间资金流。merchant_prepayment_net 是本期购买的预付扣掉已关联退款,不等于商户那边的余额净增;找不到原购买的预付退款另列 unattributed_merchant_prepayment_refunds。普通 AI、游戏、通信充值不凭“充值”二字排除。personal-finance 把商户储值排除在可动用余额之外。
- 命令:daily_preferences.py spending --from --to --as-of --group-by month --json(--to 不含当天)。


- 输出字段:按币种的 consumption_net;total_interpretation 默认是“已识别消费小计,不含待归并和商户预付”;uncertainty 写候选组数和是否证明完整;unresolved_amounts、unknown_currency_amounts 单列。
- 两套日期口径:consumption_net 按购买归属记账,日期取这一笔最早的付款或订单时间,已关联的成功退款(含跨月退款)在这一笔里扣掉;observed_flow_net 是期间资金流,付款按付款时间加、退款按退款时间减。退款没有真实时间的,不进资金流,也不补造日期。personal-finance 的月均和跑道只取 consumption_net(AGENTS.md 指定)。
- 只有本人确认账本基本覆盖、又没有待归并和币种不明时,total_interpretation 才改成“扣退款后的消费净额”。
- 商户预付:品名里明确写着购物金、储值卡、储值金、储值余额、储值充值或预付余额的,单列 merchant_prepayment_net(另有 merchant_prepayment_gross 和 merchant_prepayment_refunds),不进 consumption_net;付款仍记进期间资金流。merchant_prepayment_net 是本期购买的预付扣掉已关联退款,不等于商户那边的余额净增;找不到原购买的预付退款另列 unattributed_merchant_prepayment_refunds。普通 AI、游戏、通信充值不凭“充值”二字排除。personal-finance 把商户储值排除在可动用余额之外。
- 命令:daily_preferences.py spending --from --to --as-of --group-by month --json(--to 不含当天)。



| 名词 | 意思 |
|---|---|
| 消费净额 | 实付减去同一交易链的成功退款 |
| 待归并 | 可能是同一笔、但证据不够合并的记录,单列不算 |
| 本人操作 | 在自己的账户和钱包之间倒钱 |
| 先用后付 | 花呗、电商平台自带的那一类;还它不是新消费 |
| 重复扣款 | 同一订单真被扣了两次;钱包和信用卡各记一次、分期、预授权、退款冲正都不算 |

消费净额是已识别的小计;覆盖不全时,它是下限的一种说法,不是全部花费。



消费净额是已识别的小计;覆盖不全时,它是下限的一种说法,不是全部花费。

- 网页上不放任何金额、商家或账单条目。
- 不从消费倒推余额。
- 订单和支付只证明钱的事实;偏好由个人理解库另按规则判断,退款单不拿来猜喜好。
- 关联不确定: 待归并单列,等更多来源再归
- 币种不明: 单列,不相加
- 退款状态不明: 先核订单最终状态;没证据写待核
- 真的重复扣款: 挂驾驶舱“需要你”;分期、预授权、冲正不提

- 网页上不放任何金额、商家或账单条目。
- 不从消费倒推余额。
- 订单和支付只证明钱的事实;偏好由个人理解库另按规则判断,退款单不拿来猜喜好。
- 关联不确定: 待归并单列,等更多来源再归
- 币种不明: 单列,不相加
- 退款状态不明: 先核订单最终状态;没证据写待核
- 真的重复扣款: 挂驾驶舱“需要你”;分期、预授权、冲正不提

- 个人理解库 spending.py、debit_sources.py、commerce_records.py、gmail_sources.py 消费统计、储蓄卡分类、订单与售后、信用卡邮件
- tests/test_spending.py 跨月退款、日报让位月单、外币日期相邻、同日同额不合并、未知币种不相加、还款与重复行、重复扣款候选(专项测试,只用合成数据)
- 个人理解库 docs/source-rules.md 重复扣款、先用后付、储蓄卡五类和交叉核对规则
- 测试只用合成数据,不碰真实账单。
- 真实月度结果靠覆盖说明和驾驶舱回执核对;这次没有重跑测试。

- 个人理解库 spending.py、debit_sources.py、commerce_records.py、gmail_sources.py 消费统计、储蓄卡分类、订单与售后、信用卡邮件
- tests/test_spending.py 跨月退款、日报让位月单、外币日期相邻、同日同额不合并、未知币种不相加、还款与重复行、重复扣款候选(专项测试,只用合成数据)
- 个人理解库 docs/source-rules.md 重复扣款、先用后付、储蓄卡五类和交叉核对规则
- 测试只用合成数据,不碰真实账单。
- 真实月度结果靠覆盖说明和驾驶舱回执核对;这次没有重跑测试。
复制 AI 续作说明
项目:先分清消费和还款,再算花了多少;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。




