snarky-expense-butler
# 毒舌记账管家 (Snarky Expense Butler)
纯本地 JSON 存储的个人消费记录系统，无外部依赖，无需 API Key。
## 数据路径
- 数据文件：`./expense_records.json`，可通过 `EXPENSE_DATA_FILE` 环境变量指定
- 趋势图输出：`./trends/`，可通过 `EXPENSE_TRENDS_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`），或从备注自动提取（括号内优先、地标词识别）。
标签
skill
ai
