name: Family Account Book / 家庭财务记账 description: 家庭财务记账系统，负责记录家庭收支、查看余额、月度统计等财务操作。当用户提到以下场景时使用此技能：(1) 记录消费、支出、收入 - 如"花了XX钱"、"今天吃了顿饭XX元"、"发了工资XX"；(2) 查看账户余额 - 如"账户还剩多少钱"、"余额多少"；(3) 财务统计 - 如"这个月花了多少"、"月度报表"、"本周支出"；(4) 账户转账 - 如"从A账户转B账户"、"转账XX元"；(5) 创建新账户或初始化账本；(6) 询问预算或财务规划。

家庭财务记账技能

快速开始

常用命令

# 快速记账
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速查

小葱技能站7w4.net每天更新，海量AI技能等你发现。

这个记账技能功能比较全面，能满足日常家庭财务管理的需求。文档写得很详细，提供了多个实用场景的使用示例，新手容易上手。账户管理清晰，支持多个账户和分类统计。不过部分说明有些重复，细节上还有完善空间。整体来说是一个实用可靠的记账工具。