消费账单分析

这个技能做什么、不做什么

• 做：把用户自己导出的账单流水（支付宝 / 微信支付 / 银行卡）读进来，识列、归类、去重，
  出一份月度报告——这个月花了多少、花在哪、比上个月多花了多少、有哪些还在扣的订阅、
  哪几笔比自己的常态大得多。全是用户账单上已经发生的事实。
• 不做：不联网（不查汇率、不查任何行情、不上传任何数据）；
  不碰投资理财（股票、基金、理财产品、保险、加密货币一概不在范围内）；
  不推荐任何产品、任何平台、任何消费方式；不给「你该怎么省钱」之类的建议。
• 用户问「这钱该买点什么理财」「XX 基金能不能买」时，明确说这不在本技能范围内，
  把话题拉回「你的账单里这类支出是多少」。
• 报告里出现的每一个数字，都能在用户自己的账单文件里追溯到具体某一行。

隐私：全部在本地

• 账单里有商户、金额、对方姓名，属于高敏感数据。本技能只在本机读文件、在本机算、在本机写报告，
  不发起任何网络请求，不把任何一行数据发到外部。
• 脚本只读用户在命令行里点名的文件，不扫描目录、不翻用户的其他文件。
• 输出只有两个文件：bill-YYYY-MM.md 和 bill-YYYY-MM.json，写在 --out 指定的目录（默认当前目录）。
• 生成的报告本身也含隐私，往外发之前先提醒用户一句。

使用流程

1. 让用户自己导出账单（别替用户去登录任何账号）：

   • 支付宝 App → 我的 → 账单 → 右上角 → 开具交易流水证明 / 导出账单 → 邮箱收 CSV
   • 微信 → 我 → 服务 → 钱包 → 账单 → 常见问题 → 下载账单 → 邮箱收 CSV
   • 网银 / 手机银行 → 交易明细 → 导出（CSV 或 xlsx）

2. 先跑一次 --months，确认文件读对了、月份齐不齐：

   codeBlock.copy

   python {baseDir}/scripts/bill.py <账单1> [账单2 ...] --months

3. 出月报（不给 --month 就是账单里最近的一个月）：

   codeBlock.copy

   python {baseDir}/scripts/bill.py <账单1> [账单2 ...] --month 2026-08 --out <输出目录>

4. 看「疑似重复」那一节。确认那几对确实是同一笔钱之后，加 --dedup 重跑，数字才准。

5. 把报告原样展示给用户，再用两三句话点出最扎眼的一两个数字（只指方向，不下判断、不劝）。

命令

{baseDir} 是本技能目录。账单文件可以给多个，会合并成一份报告。

# 只看账单覆盖了哪些月份、每月多少（不出报告，适合先确认文件没读错）
python {baseDir}/scripts/bill.py 支付宝.csv 微信.csv 银行.csv --months

# 单文件月报（默认最近一个月，写到当前目录）
python {baseDir}/scripts/bill.py 微信.csv

# 多文件合并 + 指定月份 + 指定输出目录
python {baseDir}/scripts/bill.py 支付宝.csv 微信.csv 银行.xlsx --month 2026-08 --out ./报告

# 确认过疑似重复之后，真删重复笔再出一次
python {baseDir}/scripts/bill.py 支付宝.csv 微信.csv 银行.csv --dedup --out ./报告

# 用自己的分类规则表（覆盖内置规则）
python {baseDir}/scripts/bill.py 微信.csv --rules {baseDir}/assets/categories.example.json

# 不在终端刷报告正文，只要文件
python {baseDir}/scripts/bill.py 微信.csv --quiet --out ./报告

报告里有什么

分类

内置 14 个类目：餐饮、交通、购物、日用、居住、通讯、医疗、教育、娱乐、人情往来、转账、还款、收入、其他。

• 命中优先级：用户规则 > 内置规则 > 其他。

• 匹配范围是「交易对方 + 商品说明/摘要 + 备注 + 账单自带的交易分类」四项拼起来做包含匹配，
  不含支付方式那一列（不然「招商银行储蓄卡」会把一堆消费误判成银行相关）。

• 收入笔统一归到「收入」，除非用户规则明确另指一类。

• 自定义规则表见 assets/categories.example.json，两种写法都认：

  codeBlock.copy

  {
    "rules": [{"category": "宠物", "keywords": ["猫粮", "宠物医院"]}],
    "ignore_keywords": ["ATM取现"]
  }

  或者最简单的 {"宠物": ["猫粮", "宠物医院"]}。
  ignore_keywords 命中的行整行不计入统计，只在「解析情况」里报个数，
  适合排掉自己往自己账户里搬钱的流水。

• 分类是关键词猜的，猜错很正常。用户说某笔归错了，就往规则表里加一条，别去改脚本。

去重口径

同一笔钱经常出现两次：微信里记「支付 128 给海底捞」，银行流水里记「财付通-消费 128」。判定条件（四条全中才算）：

1. 时间相差 ≤ 5 分钟；
2. 金额完全相同；
3. 收支方向相同；
4. 来自不同的账单文件，且其中一方的文本里出现「微信 / 财付通 / 支付宝 / 云闪付 / 银联」等通道词。

保留信息多的那一条（写了商户名的微信/支付宝那侧），丢掉银行那侧的通道流水。
默认只在报告里列出来，不删——因为「同一天同样金额买了两次同一件东西」也完全可能是真的。
用户确认过之后再加 --dedup。

报告怎么说话

• 数字先行，不加形容词。说「本月餐饮 424.90 元，占 2.5%，5 笔」，
  不说「餐饮花得有点多」「这个月花超了」「要控制一下」。
• 不劝、不教、不安慰。异常大额那一节只是「这笔和你自己的常态不一样」，不是「这笔花错了」。
• 不推荐任何商户、平台、支付方式、省钱办法、记账 App。
• 用户问「我这样花钱正常吗」，把分类占比那张表念出来，再说一句这只是他自己的数字，没有对照标准。
• 每份报告结尾固定一句：
  以上全部来自你自己导出的账单文件，只做了归类和加总，没有联网取任何数据，也不构成任何消费或理财建议。
  （脚本已自动附上，不要删。）

口径与边界

• 识列失败就停：前 30 行里找不到同时含「时间/日期」和「金额」的表头行时，脚本打印第一行并退出。
  把表头发给用户确认，别猜，也别自己改数据文件。
• 编码：CSV 依次尝试 utf-8-sig、utf-8、gbk、gb18030、utf-16；
  xlsx 用标准库的 zipfile + xml 自己解（共享字符串、内联字符串、日期序列号都处理），
  解析不了会明确报错让用户另存为 CSV；.xls 老格式不支持，直接报错。
• 表头位置：支付宝/微信/银行的导出前面都有几行说明文字，脚本自动往下找真正的列名行，
  并在报告里写明认的是第几行。
• 日期与时间分两列（银行常见）：以日期列为准，把时间列拼回去；选中的列如果解析不出日期，
  自动换一列能解析出来的。
• 不计收支：支付宝/微信标「不计收支」的行（余额宝转入、零钱通转入之类）不进支出也不进收入，
  只在「解析情况」里报个数。
• 交易关闭 / 失败 / 撤销 / 已全额退款的行直接跳过，并报个数。
• 退款：账单里标成「收入」的退款就按收入计，不去和原始那笔支出对冲（对冲不了，账单里没有配对关系）。
• 转账和还款算不算「花掉」：脚本把它们当支出统计，但单列成「转账」「还款」两类，
  用户想看「真实消费」时，让用户自己把这两类减掉——不要替用户定义什么叫真实消费。
• 订阅识别只看「同对方 + 同金额 + 连续月份」，年付、变价、免密小额扣费认不出来；
  账单只覆盖 1～2 个月时这一项本来就判不出来，报告里会直说。
• 异常大额用的是「该分类其余各笔的笔均」（把这笔自己剔掉再算均值），样本不足 3 笔的分类不判。
• 不做预算、不做目标、不做预测：没有「这个月还能花多少」，没有「照这个速度年底会花掉多少」。
• 不改用户的账单文件，一个字节都不写回去。

脚本

纯 Python 3 标准库，零第三方依赖（xlsx 也是自己用 zipfile + xml 解的，不需要 openpyxl）。

assets/ 下有三份可直接跑的虚构样例（sample_alipay.csv、sample_wechat.csv、sample_bank.csv），
用来演示或自检；references/columns.md 是各家导出格式的列名对照。

# 自检：三份样例合并，应报出 3 对疑似重复、2 笔订阅
python {baseDir}/scripts/bill.py {baseDir}/assets/sample_alipay.csv \
  {baseDir}/assets/sample_wechat.csv {baseDir}/assets/sample_bank.csv --dedup --out .