支出追踪器

以按月组织的 Markdown 文件记录并追踪日常支出。

快速开始

记录一笔支出

python3 scripts/log_expense.py log   [--description "text"] [--tags "tag1,tag2"] [--date YYYY-MM-DD]

示例：

# 简单支出
python3 scripts/log_expense.py log 45000 Coffee

# 带描述
python3 scripts/log_expense.py log 250000 Dining --description "Lunch with team"

# 带标签
python3 scripts/log_expense.py log 500000 Shopping --tags "clothes,sale" --description "New shirt"

# 指定日期（用于补录历史支出）
python3 scripts/log_expense.py log 1200000 Vehicle --description "Gas" --date 2026-02-15

查看月度汇总

# 当前月份
python3 scripts/log_expense.py summary

# 指定月份
python3 scripts/log_expense.py summary 2026-02

# JSON 格式输出（便于程序解析）
python3 scripts/log_expense.py summary 2026-02 --json

文件组织结构

支出数据存储在工作区根目录下的 expenses/ 目录中：

expenses/
├── 2026-01.md
├── 2026-02.md
└── 2026-03.md

每个文件包含一个 Markdown 表格：

# Expenses - 2026-02

| Date | Category | Amount (VND) | Description | Tags |
|------|----------|-------------|-------------|------|
| 2026-02-17 | Coffee | 45,000 | | |
| 2026-02-17 | Dining | 250,000 | Lunch with team | |
| 2026-02-17 | Shopping | 500,000 | New shirt | clothes,sale |

支出类别

常见支出类别请参阅 references/categories.md。可直接使用已有类别，也可根据需要创建自定义类别。

常用类别包括：

• Housing — 房租、水电费、家居相关支出
• Vehicle — 汽油、车辆保养、停车费
• Dining — 餐厅用餐、外卖
• Coffee — 咖啡馆、咖啡店消费
• Shopping — 服装、电子产品、一般购物
• Entertainment — 电影、游戏、兴趣爱好
• Healthcare — 药品、就医费用
• Subscriptions — Netflix、Spotify、健身房会员、各类 App 订阅
• Savings — 投资、应急资金储蓄
• Debt Payment — 贷款、信用卡还款
• Miscellaneous — 其他未归类支出

典型工作流示例

从对话中实时记录每日支出

当用户提及某笔支出时：

# 用户：“刚花了 35k 买咖啡”
python3 scripts/log_expense.py log 35000 Coffee

# 用户：“在 Phở 24 吃了顿午饭，120k”
python3 scripts/log_expense.py log 120000 Dining --description "Phở 24"

# 用户：“加了次油，400k”
python3 scripts/log_expense.py log 400000 Vehicle --description "Gas"

月度回顾

# 获取汇总信息
python3 scripts/log_expense.py summary 2026-02

# 查看支出文件详情
cat expenses/2026-02.md

分析消费模式

# 获取 JSON 格式数据用于分析
python3 scripts/log_expense.py summary 2026-02 --json

# 对比多个月份
python3 scripts/log_expense.py summary 2026-01 --json > jan.json
python3 scripts/log_expense.py summary 2026-02 --json > feb.json

自动备份

每次写入前，脚本会自动将当前支出文件备份至：

~/Documents/expenses_backup/YYYY-MM.md

• 备份操作在任何修改 之前 执行（即使写入失败也确保安全）
• 若该月文件尚不存在（即当月首笔支出），则跳过备份
• 每次备份均会覆盖前一次，仅保留最新一次写入前的快照
• 该机制可防范误执行 rm -rf 或工作区损坏导致的数据丢失

使用提示

• 批量记录：用户可一次性提供多笔支出，应全部记录
• 类别一致性：统一使用相同类别名称，以保障汇总统计准确性
• 标签用于筛选：使用标签表示子类（例如 “work”、“weekend”、“urgent”）
• 添加描述：补充有助于后续识别该笔支出的上下文信息
• 定期回顾：建议每月生成汇总报告，持续跟踪消费趋势

与财务目标的整合

在追踪支出过程中，请考虑以下方面：

1. 预算跟踪：将月度总支出与目标预算进行对比
2. 消费模式识别：定位高支出类别
3. 应急资金：追踪储蓄进度
4. 债务偿还：监控债务还款进展
5. 财务比率：计算支出占收入的百分比

脚本参考说明

log_expense.py

支持命令：

• log — 添加一笔支出记录
• summary — 查看月度汇总

log 命令参数：

• amount — 金额（单位：VND，必填）
• category — 类别名称（必填）
• --description/-d — 可选描述
• --tags/-t — 可选逗号分隔的标签列表
• --date — 可选日期（格式：YYYY-MM-DD，默认为当天）
• --workspace — 可选工作区路径（默认为 ~/.openclaw/workspace）

summary 命令参数：

• year_month — 可选 YYYY-MM 格式（默认为当前月份）
• --json — 以 JSON 格式输出
• --workspace — 可选工作区路径

输出行为：

• 在 expenses/ 目录下创建或更新 Markdown 文件
• 打印确认信息，含文件保存路径
• 汇总结果展示总额、总笔数及各分类明细