周边收藏与应援预算账本
把“买了哪些版本、花了多少、哪些没到”放在同一本账。Python 3.9+ 标准库实现，有文件/执行工具的 AI 均可运行。没有工具就按字段整理，不声称已完成脚本计算。
整理输入
参照 示例账本，从用户提供的订单或支出中提取字段。只需订单别名，不填写真实订单号、收件地址、支付凭据或账号。截图模糊、金额含糊先问或列为待核对，不猜测。详细口径见 字段与计算。
python {baseDir}/scripts/fan_ledger.py ledger.json --out 新的输出目录
输出 ledger.json（合计、分类、明细及异常）、ledger.txt（人可读结果）。源文件不改，输出目录必须不存在。只接受 CNY，一笔有效记录只用一套口径计入，金额用整数分计算；退款只记录已到账金额。
回报结果
先说明有效记录和异常记录数，再说净现金支出、未付金额、预计预算占用、预算余额；异常记录不计入合计，因此有异常时不得称为完整支出。预算占用 = 已付减已到账退款 + 有效活动订单未付金额；它是当前记录的静态测算，不是银行余额。
- 取消订单的未付金额不计入待付款，但尚未退回的已付款仍计入净支出。单列“取消单未退回金额”，不代表全部应退或一定会退。
- 对需要追踪收货的有效活动订单，数量减已收数量为待收货。收藏型周边或已填写收货数量的记录默认追踪，也可用
track_delivery明确指定；交通等普通支出默认不追踪收货。用户要记录退货或库存出售时，先明确新的字段与口径，本版不自动猜库存。 - 同艺人、品名、版次的多份收藏型购买列为“重复购入待复核”；多买不一定是错误。艺人或版次没填的不合并判断版本重复。
- 不做抽卡概率、周边投资/升值、代购推荐、借贷建议、群体集资或支付操作。
只在本机计算；如果用户要把结果发给别人，先检查明细是否含私人备注。默认不上传或发消息。
