watch-my-money

分析交易、分类支出、追踪预算、标记超支。

工作流程

1. 获取交易记录

向用户索取银行/信用卡的CSV导出文件或粘贴的文本。

常见来源：

• 从您的银行在线门户网站下载CSV文件
• 从预算应用程序导出
• 从对账单复制/粘贴交易记录

支持的格式：

• 任何包含日期、描述、金额列的CSV文件
• 粘贴文本示例："2026-01-03 Starbucks -5.40 CHF"

2. 解析与标准化

读取输入，标准化为标准格式：

• 自动检测分隔符（逗号、分号、制表符）
• 解析日期（YYYY-MM-DD、DD/MM/YYYY、MM/DD/YYYY）
• 标准化金额（支出为负，收入为正）
• 从描述中提取商户信息
• 检测周期性交易（订阅）

3. 对交易进行分类

为每笔交易分配类别：

类别：

• 房租，水电煤气，订阅服务，食品杂货，外出就餐
• 交通，旅行，购物，健康
• 收入，转账，其他

分类顺序：

1. 检查保存的商户覆盖规则
2. 应用确定性关键词规则（参见common-merchants.md）
3. 模式匹配（订阅服务，水电煤气）
4. 启发式后备方案

对于不明确的商户（每批5-10个），请用户确认。 保存覆盖规则以供后续运行使用。

4. 检查预算

将支出与用户定义的预算进行比较。

警报阈值：

• 80% - 接近限额（黄色）
• 100% - 达到限额（红色）
• 120% - 超出预算（红色，紧急）

参见budget-templates.md用于建议的预算。

5. 检测异常

标记异常支出：

• 类别激增：支出 > 基线值的1.5倍 且 差值 > 50
• 订阅增长：订阅数量增长 > 20%
• 新的昂贵商家：首次出现 且 支出 > 30
• 潜在订阅：重复出现的等额扣款

基线 = 过去3个月的平均值（若无历史数据则使用当月数据）。

6. 生成HTML报告

创建本地HTML文件，包含：

• 月度摘要（收入、支出、净额）
• 按类别细分及预算状态
• 主要商家
• 警报部分
• 检测到的重复交易
• 隐私切换（模糊金额/商家信息）

复制template.html并注入数据。

7. 保存状态

持久化保存至~/.watch_my_money/:

• state.json- 预算、商家覆盖规则、历史记录
• reports/YYYY-MM.json- 机器可读的月度数据
• reports/YYYY-MM.html- 交互式报告

CLI 命令

# Analyze CSV
python -m watch_my_money analyze --csv path/to/file.csv --month 2026-01

# Analyze from stdin
cat transactions.txt | python -m watch_my_money analyze --stdin --month 2026-01 --default-currency CHF

# Compare months
python -m watch_my_money compare --months 2026-01 2025-12

# Set budget
python -m watch_my_money set-budget --category groceries --amount 500 --currency CHF

# View budgets
python -m watch_my_money budgets

# Export month data
python -m watch_my_money export --month 2026-01 --out summary.json

# Reset all state
python -m watch_my_money reset-state

输出结构

控制台显示：

• 包含收入/支出/净值的月度摘要
• 包含支出与预算对比的分类表格
• 检测到的周期性交易
• 前 5 大商家
• 以要点形式呈现的警报

写入的文件：

• ~/.watch_my_money/state.json
• ~/.watch_my_money/reports/2026-01.json
• ~/.watch_my_money/reports/2026-01.html

HTML 报告功能

• 可折叠的分类部分
• 预算进度条
• 定期交易列表
• 月度对比
• 隐私切换（模糊敏感数据）
• 深色模式（遵循系统偏好）
• 浮动操作按钮
• 便于截图的布局
• 自动隐藏空部分

隐私

所有数据均保留在本地。无网络调用。无外部API。 交易数据在本地分析，并仅存储在~/.watch_my_money/。