个人记账 — 个人财务管理

概述 面向普通人的自然语言记账工具。用户只需说“今天吃饭花了50块”，即可自动生成 CSV 格式账本条目。原创 CSV 格式，无需安装数据库，一个 CSV 文件搞定一切。

账本格式（CSV） 本 Skill 使用完全原创的 CSV 格式，简单直观。 # 日期,类型,金额,分类,描述,账户 余额,微信钱包,1000.00 余额,支付宝,2000.00 余额,银行卡,50000.00 余额,现金,500.00 2026-05-21,支出,50.00,餐饮,午餐,微信钱包 2026-05-22,收入,8000.00,工资,5月工资,银行卡 2026-05-23,支出,299.00,购物,外套,支付宝

格式规则： 6 个字段：日期,类型,金额,分类,描述,账户 类型只能是 收入 或 支出 金额填正数（系统通过类型字段判断方向） 账户用扁平中文名，无需层级路径 初始余额用 余额,账户,金额 格式 默认位置 ~/.openclaw/workspace/data/ledger/default.csv

触发条件 当用户提到以下意图时激活本 Skill： 记一笔账（"花了XX"、"买了XX"、"收入XX"、"工资到账"） 查询消费（"这个月花了多少"、"上个月餐饮多少钱"、"查账"） 账户管理（"我的余额"、"银行卡还有多少"） 月度报告（"月度报告"、"这个月花销总结"、"消费分析"） 投资操作（"买入XX股"、"卖了XX"、"查持仓"、"投资收益"） 预算管理（"设定预算"、"预算多少"、"超支了吗"、"生成预算模板"）

核心能力

• 自然语言记账

输入示例： "今天中午吃饭花了50块" "昨天打车花了23.5" "工资到账8000" "充话费30" "买了一件外套299，用支付宝付的" "给小王转了200" 处理流程：使用 LLM 从用户输入中提取：日期、金额、分类、描述、账户，调用 scripts/parse_entry.py 格式化为标准 CSV 行，追加写入账本 CSV 文件 AI 解析规则： 字段 说明 默认值 date 日期（"今天"、"昨天"、"上周三"等） 当天 amount 金额（支持小数） 必填 category 消费分类 自动推断 description 摘要描述 提取关键信息 account 支付账户 默认微信钱包

分类自动映射规则： 关键词 分类 吃饭、午餐、晚餐、外卖、火锅、奶茶、咖啡、零食、水果、饮料 餐饮 打车、地铁、公交、加油、停车、高铁、机票 交通 租房、水电、物业、网费、燃气 居住 电影、游戏、会员、视频、音乐、KTV 娱乐 衣服、鞋子、包包、化妆品、日用品 购物 话费、充值、流量 通讯 药、医院、体检 医疗 课程、书、考试 教育 红包、礼物、请客 社交 工资、薪资、奖金 工资 理财、利息、分红 理财收益

账户自动映射规则： 关键词 账户 微信、微信支付、零钱 微信钱包 支付宝、花呗 支付宝 银行卡、银行 银行卡 现金 现金 无关键词 微信钱包（默认）

• 消费查询

支持查询方式：按时间、按分类、组合、全部列表 处理方式：Agent 读取账本 CSV，按条件筛选并计算汇总。 输出格式：查询结果

• 账户余额管理

支持操作：查看余额、设置初始余额、调整余额 余额计算方式：初始余额 + 收入合计 - 支出合计 Agent 读取账本 CSV，找到该账户的余额行和所有相关交易，自动计算当前余额。

• 预算管理

支持操作：设定预算、查看进度、超支预警、生成模板、列出预算、删除预算 命令参考：python budget.py <账本.csv> --set 餐饮 2000 预算指南：详见 references/budget_guide.md

• 月度报告

触发方式： "月度报告"、"5月消费分析"、"这个月总结" 命令：python generate_report.py ./default.csv --month 2026-05 报告内容：收支概览、分类支出排行、日均消费、最大单笔支出、与上月环比对比、简短消费建议

• 财务目标

触发方式： "我要攒钱旅行"、"建一个应急基金目标" 命令参考：goal.py create "旅行基金" 10000 2026-12-31 详细指南：参见 references/goal_guide.md

• 投资跟踪

触发方式： "买入XX股"、"卖了XX"、"查持仓"、"投资收益" 命令参考：invest.py --buy "沪深300ETF" 510050 1000 3.50 2026-01-15 详细指南：参见 references/invest_guide.md

首次使用初始化 当用户首次触发记账时，Agent 应：检查账本文件是否存在、不存在则创建、写入模板头部、询问用户常用支付方式和初始余额、初始化模板。

交互模式 单行记账、对话记账、目标记账、批量记账、修改/删除

工作流总结 用户输入 │ ├─ 记账意图 → 解析字段 → 生成CSV行 → 追加写入 → 确认反馈 │ ├─ 查询意图 → 读取CSV → 筛选过滤 → 计算汇总 → 格式化输出 │ ├─ 余额意图 → 读取CSV → 找余额行 → 累计收支 → 计算余额 │ ├─ 报告意图 → 读取CSV →