spending-log

生活服务

个人支出记账。触发词：记账、花了、消费、支出、账单、开销、统计消费、月度报表。支持自然语言记账、自动分类、月度统计、预算提醒和月度报表生成。

个人计划消费决策

425

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

消费记录#

个人支出记账技能，数据存储在 data/expenses.json。

数据文件#

data/expenses.json — 所有支出记录，格式如下：

json

[
  {
    "id": "becd186675a34bb0",
    "amount": 35.0,
    "category": "餐饮",
    "description": "午饭",
    "date": "2026-04-08",
    "timestamp": 1772952046769
  }
]

data/config.json — 配置（月预算等）：

json

{ "monthly_budget": 2000 }

分类#

餐饮、交通、购物、娱乐、医疗、房租、日用、社交、其他

根据用户输入内容智能归类，无法判断时归为"其他"并标注。

操作#

记账#

用户用自然语言说，例如：

"午饭35" "今天打车花了25" "昨天买日用品60" "充话费50"

解析规则：

金额：从文本中提取数字，默认单位为元。支持大写数字（壹/贰/叁等）和口语化表达（"一块五" "两块钱"），自动转换为小数
日期：今天/昨天/前天/具体日期，省略则默认今天
分类：根据描述关键词自动归类
描述：提取金额和日期后的剩余内容作为描述
多金额歧义：文本中出现多个数字时，优先取最大值作为金额并标注；若明显不可能是金额（如日期中的数字）则跳过

解析后追加到 data/expenses.json，回复确认信息：金额、分类、描述、日期。

删除记录#

"删除刚才那条" / "删掉午餐那条" — 找到最近匹配的记录删除，确认后执行。

修改记录#

通过 scripts/crud.py edit 命令修改已有记录的金额、分类、描述或日期：

bash

python3 scripts/crud.py edit --id <记录ID> --amount 40 --description "午饭加菜"

月度统计#

"这个月花了多少" / "4月餐饮花了多少" / "本月交通支出"

必须使用 scripts/query.py 脚本计算，禁止心算。

bash

# 查某分类当月支出
python3 scripts/query.py --category 餐饮

# 查当月总支出（省略分类）
python3 scripts/query.py

# 查指定月份
python3 scripts/query.py --month 2026-03

# 最近7天详细明细
python3 scripts/query.py --days 7 --format detail

# 指定日期范围（场景：出差/旅行期间的花费）
python3 scripts/query.py --from 2026-04-10 --to 2026-04-15

# 查全量数据
python3 scripts/query.py --all

默认按日期倒序排列。 --days 使用精确的日期边界（当天 00:00 起），避免模糊区间。 --month 和 --days 同时传时优先 --month。

脚本会返回：笔数、合计金额、逐笔明细。直接将结果呈现给用户即可。

预算检查#

每次记账后自动检查： 当月累计支出是否超过月预算（默认2000元）。超过时主动提醒用户。

用户也可主动问"预算还剩多少"来查询。

月度报表#

用户说"月度报表" / "生成报表" / "本月账单"时，使用 scripts/report.py 生成 HTML 报表。

报表生成#

bash

python3 scripts/report.py --month 2026-04
python3 scripts/report.py --month 2026-04 --force   # 强制重新生成
python3 scripts/report.py --month 2026-04 --csv

将生成的 HTML 通过消息发送给用户（使用 <qqmedia> 标签发送文件）。同时备份到 /volume2/Download/OpenClaw/reports/ 目录。

禁止使用 canvas 展示报表。

生成的报表包含：