毒舌记账管家 (Snarky Expense Butler)

纯本地 JSON 存储的个人消费记录系统，无外部依赖，无需 API Key。

数据路径

• - 数据文件：./expenserecords.json，可通过 EXPENSEDATAFILE 环境变量指定
• 趋势图输出：./trends/，可通过 EXPENSETRENDS_DIR 环境变量指定
• 首次使用自动创建数据文件

命令

bash

记账（自动记录时间戳 + 自动提取地点 + 文件锁防并发）

python3 scripts/add_expense.py <分类> <金额> [备注] [--location 地点]

查询

python3 scripts/expense_query.py today|week|month|stats|list

报告（支持 crontab 定时推送）

python3 scripts/expense_report.py daily|weekly|monthly|yearly

预算检查（✅正常 ⚠️接近80% 🚨超支）

python3 scripts/expense_budget.py today|week|month

毒舌分析（调侃风格，非模板报告）

python3 scripts/expense_analysis.py today|YYYY-MM-DD

地域统计（按地点聚合，标注吞金兽🐷/省钱区💰）

python3 scripts/expense_location.py summary|top|backfill

趋势图（优先大模型出图，matplotlib 兜底）

python3 scripts/expense_trends.py week|month|year

分类

交通、餐饮、购物、娱乐、医疗、教育、其他

配置

预算在数据文件 settings.budget 中配置，默认值：日 ¥50 / 周 ¥350 / 月 ¥1500。

数据格式

每条 item 结构：
json
{datetime: 2026-03-18 14:05, category: 餐饮, amount: 17.9, note: 午餐, location: 福田cocopark}

location 可选：支持手动指定（--location），或从备注自动提取（括号内优先、地标词识别）。