keep-accounts（记账）

家庭财务记账技能

快速开始

常用命令

# 快速记账
python3 /path/to/finances/scripts/finance_db.py --add 账本 账户 类型 金额 分类 描述

# 查看所有账户余额
python3 /path/to/finances/scripts/finance_db.py -b

# 月度统计报表
python3 /path/to/finances/scripts/finance_db.py -s [YYYY-MM]

参数说明

记账工作流

1. 记录消费

用户: "今天搓一顿肯德基，79块7"
操作: python3 .../finance_db.py --add default 主账户 支出 79.7 餐饮 肯德基

2. 记录收入

用户: "今天发工资了，15000"
操作: python3 .../finance_db.py --add default 主账户 收入 15000 工资 月薪

3. 查看余额

用户: "看一下所有账户"
操作: python3 .../finance_db.py -b

4. 月度统计

用户: "看一下这个月花了多少"
操作: python3 .../finance_db.py -s 2026-04

5. 转账操作

转账需要记录两条交易（一出一入）：

假设用户说"从主账户转1000到日常支出"：

# 第一条：主账户支出100（转出）
python3 .../finance_db.py --add default 主账户 支出 1000 转账 转至日常支出

# 第二条：日常支出收入1000（转入）
python3 .../finance_db.py --add default 日常支出 收入 1000 转账 来自主账户

6. 近7日/特定周期查询

使用Python脚本查询：

python3 -c "
import sqlite3, datetime
conn = sqlite3.connect('{WORKSPACE}/finances/db/finance.db')
conn.row_factory = sqlite3.Row
cur = conn.cursor()
week_ago = (datetime.datetime.now() - datetime.timedelta(days=7)).strftime('%Y-%m-%d')
cur.execute('''
    SELECT t.date, t.amount, t.category, t.description, a.name as account
    FROM transactions t
    JOIN accounts a ON t.account_id = a.id
    WHERE t.date >= ?
    ORDER BY t.date DESC
''', (week_ago,))
for r in cur.fetchall():
    print(f\"  {r['date']}  ¥{r['amount']:.2f}  [{r['category']}] {r['description']}\")
conn.close()
"

核心原则

1. 严禁编造数据：金额必须由用户主动提供
2. 统一用ID记录：账户用ID（如B001），不是名称
3. 转账记录两条：内部流动需要一出一入两条记录
4. 统计排除转账：月度报表自动排除转账分类
5. 负数余额是合法的：部分账户（如投资账户）设计为跟踪盈亏，负数表示亏损

数据库信息

• 数据库路径: {WORKSPACE}/finances/db/finance.db
• 详细Schema: 参见 references/finance.md

账户ID速查