个人记账

概述

面向普通人的自然语言记账工具。用户只需说"今天吃饭花了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"、"查持仓"、"投资收益"）
• 预算管理（"设定预算"、"预算多少"、"超支了吗"、"生成预算模板"）

核心能力

1. 📝 自然语言记账

输入示例：

• "今天中午吃饭花了50块"
• "昨天打车花了23.5"
• "工资到账8000"
• "充话费30"
• "买了一件外套299，用支付宝付的"
• "给小王转了200"

处理流程：

1. 使用 LLM 从用户输入中提取：日期、金额、分类、描述、账户
2. 调用 scripts/parse_entry.py 格式化为标准 CSV 行
3. 追加写入账本 CSV 文件

AI 解析规则：

分类自动映射规则：

账户自动映射规则：

2. 📊 消费查询

支持查询方式：

• 按时间："这个月花了多少"、"上周支出"、"2025年3月"
• 按分类："餐饮花了多少"、"交通费用"
• 组合："这个月餐饮花了多少"
• 全部列表："最近的账单"、"最近10笔"

处理方式： Agent 读取账本 CSV，按条件筛选并计算汇总。

输出格式：

📊 查询结果：2026年5月 餐饮支出

日期        金额      描述
2026-05-01  ¥50.00   午餐
2026-05-03  ¥128.00  火锅
2026-05-05  ¥15.00   早餐
2026-05-05  ¥45.00   午饭
─────────────────────────
合计        ¥238.00

3. 💰 账户余额管理

支持操作：

• 查看余额："微信钱包还有多少"、"各账户余额"
• 设置初始余额："微信钱包初始余额1000"
• 调整余额："银行卡余额修正为5000"

余额计算方式： 初始余额 + 收入合计 - 支出合计

Agent 读取账本 CSV，找到该账户的余额行和所有相关交易，自动计算当前余额。

4. 📐 预算管理

支持操作：

• 设定预算：python budget.py \x3C账本.csv> --set 餐饮 2000
• 查看进度：python budget.py \x3C账本.csv> --progress 2026-05
• 超支预警：python budget.py \x3C账本.csv> --alert 2026-05
• 生成模板：python budget.py \x3C账本.csv> --template 15000
• 列出预算：python budget.py \x3C账本.csv> --list
• 删除预算：python budget.py \x3C账本.csv> --remove 餐饮

命令参考：

# 设定预算
python budget.py ./default.csv --set 餐饮 2000

# 查看所有预算
python budget.py ./default.csv --list

# 查看执行进度
python budget.py ./default.csv --progress 2026-05

# 超支预警
python budget.py ./default.csv --alert 2026-05

# 生成预算模板（50/30/20法则，基于月收入）
python budget.py ./default.csv --template 15000

# 自定义比例模板
python budget.py ./default.csv --template 15000 --ratio 40 30 20 10

# 移除预算
python budget.py ./default.csv --remove 餐饮

预算指南： 详见 references/budget_guide.md

5. 📈 月度报告

触发方式： "月度报告"、"5月消费分析"、"这个月总结"

命令：

python generate_report.py ./default.csv --month 2026-05
python generate_report.py ./default.csv --month 2026-05 --output report.txt

报告内容：

1. 收支概览（总收入、总支出、净结余）
2. 分类支出排行（文字图表）
3. 日均消费
4. 最大单笔支出
5. 与上月环比对比
6. 简短消费建议

输出示例：

📈 2026年5月 月度报告

━━━ 收支概览 ━━━
收入：¥8,500.00
支出：¥4,230.50
结余：¥4,269.50

━━━ 支出分类 TOP 5 ━━━
████████████ 餐饮    ¥1,280.00  (30.3%)
██████       购物    ¥890.00    (21.0%)
████         交通    ¥620.50    (14.7%)
███          娱乐    ¥480.00    (11.3%)
██           居住    ¥450.00    (10.6%)
其他                   ¥510.00    (12.1%)

日均消费：¥201.45
最大单笔：¥299.00（购物-外套）

6. 📍 财务目标

触发方式：

• "我要攒钱旅行"、"建一个应急基金目标"
• "目标进度怎么样"、"旅行基金存了多少"
• "列出我的财务目标"

命令参考：

详细指南： 参见 references/goal_guide.md

7. 📈 投资跟踪

触发方式： "买入XX股"、"卖了XX"、"查持仓"、"投资收益"

命令参考：

详细指南： 参见 references/invest_guide.md

首次使用初始化

当用户首次触发记账时，Agent 应：

1. 检查账本文件是否存在
2. 不存在则创建，写入模板头部
3. 询问用户常用支付方式和初始余额

初始化模板：

# 日期,类型,金额,分类,描述,账户
# 个人账本 - 创建于 YYYY-MM-DD
# 格式说明见 references/ledger_format.md

# 账户初始余额
余额,微信钱包,0.00
余额,支付宝,0.00
余额,银行卡,0.00
余额,现金,0.00

# === 交易记录 ===

交互模式

单行记账（最常用）

用户: 今天中午吃了碗面花了25
Agent: 已记录 ✅
      📅 2026-05-21
      💰 ¥25.00
      📂 餐饮
      💳 微信钱包
      📝 午餐

      微信钱包余额：¥975.00

对话记账（多字段补全）

用户: 花了200块
Agent: 买的什么？

用户: 买了本书
Agent: 已记录 ✅
      📅 2026-05-21
      💰 ¥200.00
      📂 教育
      💳 微信钱包
      📝 书籍

      微信钱包余额：¥775.00

目标记账

当用户提到给某个目标存钱时，同时完成两步：

1. 调用 goal.py deposit 更新目标进度
2. 按常规记账流程记录这笔支出/转账

批量记账

用户: 今天花了：早餐15、打车30、午饭45
Agent: 已记录 3 笔 ✅
      1. 餐饮  ¥15.00  早餐
      2. 交通  ¥30.00  打车
      3. 餐饮  ¥45.00  午饭
      合计：¥90.00

修改/删除

• 删除最近一笔："删掉刚那笔"
• 删除指定笔："删除5月15日那笔餐饮"
• 修改金额："把刚才那笔改成30块"

工作流总结

用户输入
  │
  ├─ 记账意图 → 解析字段 → 生成CSV行 → 追加写入 → 确认反馈
  │
  ├─ 查询意图 → 读取CSV → 筛选过滤 → 计算汇总 → 格式化输出
  │
  ├─ 余额意图 → 读取CSV → 找余额行 → 累计收支 → 计算余额
  │
  ├─ 报告意图 → 读取CSV → 按月统计 → 分类排行 → 生成报告
  │
  ├─ 投资意图 → 写入 investments.csv / 查询持仓
  │
  ├─ 目标意图 → goals.json CRUD
  │
  └─ 预算意图 → budget.py → .budget.json

参考文档

按需加载：

• references/ledger_format.md：账本 CSV 格式详细说明
• references/budget_guide.md：预算管理功能指南
• references/goal_guide.md：财务目标功能指南
• references/invest_guide.md：投资跟踪功能指南
• references/user_guide.md：用户操作 FAQ
• references/financial_benchmarks.md：财务健康基准数据
• references/education.md：财务知识科普

专业标准（Professional Standards）

免责声明

本 Skill 提供财务记录和基础分析工具，不是投资顾问服务。

底线原则： 我帮你搞清楚「钱去哪了」，不帮你决定「钱该去哪」。

语气风格（Tone and Approach）

语气忌讳： 说教口吻、用数字羞辱、过度谨慎、假装亲密。

约束

1. 只写，不删。 删除操作需用户明确要求。
2. 金额必填。 无法确认金额时，追问。
3. 分类可猜。 有把握时自动分类，不确定时给选项。
4. 日期可省。 默认今天，支持相对日期。
5. 账户可省。 默认微信钱包。
6. 文件即数据库。 所有数据存储在 CSV 文件中，用户随时可用任何编辑器查看和修改。
7. 零外部依赖。 纯 Python 标准库，无需 pip install。