智能记账助手

任务目标

• 本Skill用于:个人与家庭的日常收支记录与分析
• 能力包含:口语化记账、多笔同记、自动分类、流水查询、统计报表、记录修改与删除
• 触发条件:用户表达记/查/改/删账相关意图

类目定义

收入类目

支出类目

数据存储

数据文件位置:./expense_records.json

记录结构:

{
  "id": "uuid",
  "type": "income|expense",
  "category": "类目名称",
  "amount": 数字(元),
  "description": "描述备注",
  "date": "YYYY-MM-DD",
  "created_at": "ISO时间戳"
}

操作流程

1. 记账(记多笔)

智能体解析步骤:

1. 识别用户输入中的所有收支项(一句多笔时用"和"/"还有"/"再"/"等连接词拆分)
2. 每笔提取:金额、类型(收入/支出)、类目、日期、备注
3. 日期默认当天，可用"昨天"/"3号"/"本月5号"等表述
4. 金额解析:"50"→50元，"50块"→50元，"1500"→1500元

调用脚本:

python scripts/record.py --records '[{"type":"expense","category":"餐饮","amount":35,"description":"午餐","date":"2024-01-15"}]'

脚本参数:

• --records: JSON数组，每项包含type/category/amount/description/date

2. 查账统计

查询方式:

• 按时间:本月/上月/本周/指定日期范围
• 按类目:某类目的所有记录
• 按类型:仅收入/仅支出
• 汇总统计:总收支/类目占比/趋势分析

调用脚本:

# 本月统计
python scripts/query.py --mode summary --period month

# 指定类目查询
python scripts/query.py --mode detail --category 餐饮 --period month

# 日期范围查询
python scripts/query.py --mode detail --start-date 2024-01-01 --end-date 2024-01-31

# 查看最近10条
python scripts/query.py --mode recent --limit 10

脚本参数:

• --mode: summary(统计汇总)|detail(明细)|recent(最近记录)
• --period: today/week/month/year 或省略
• --category: 指定类目(支持模糊匹配)
• --start-date/--end-date: 日期范围(YYYY-MM-DD)
• --type: income|expense 过滤
• --limit: 返回条数(默认20)

3. 修改记录

调用脚本:

python scripts/manage.py --action update --id <记录ID> --field <字段名> --value <新值>

可修改字段: category/amount/description/date

4. 删除记录

调用脚本:

# 删除单条
python scripts/manage.py --action delete --id <记录ID>

# 批量删除(按日期范围)
python scripts/manage.py --action delete-batch --start-date 2024-01-01 --end-date 2024-01-31 --category 餐饮

使用示例

示例1:一句话记多笔账

• 输入:"今天中午吃了碗面15块，下午网购了一件衣服200，晚上请客户吃饭花了350"
• 智能体解析:
• 餐饮:15元(午餐面条)
• 购物:200元(衣服)
• 人情:350元(请客户)
• 脚本调用:record.py 写入3条记录

示例2:查询统计

• 输入:"帮我看看这个月花了多少钱"
• 智能体调用:query.py --mode summary --period month
• 输出:本月总支出/各类目金额及占比

示例3:修改记录

• 输入:"把昨天那笔50块的餐饮改成购物"
• 智能体先query查找到记录，确认id后调用:manage.py --action update --id xxx --field category --value 购物

示例4:删除记录

• 输入:"删掉上周三那条地铁费记录"
• 智能体查询定位后调用:manage.py --action delete --id xxx

资源索引

• 脚本:见 scripts/record.py(用途:新增记账记录，支持多笔批量写入)
• 脚本:见 scripts/query.py(用途:查询明细与统计汇总)
• 脚本:见 scripts/manage.py(用途:修改与删除已有记录)
• 参考:见 references/category_rules.md(何时读取:需调整类目关键词匹配规则时)

注意事项

• 金额默认单位为元，大额可用"万"为单位(如"工资2万")
• 日期表述优先按自然语言解析，确实模糊时默认当天
• 删除操作需先确认记录存在，涉及金额较大的删除应二次确认
• 跨设备同步依赖文件存储位置(建议放在云盘同步目录)