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

  本技能來自小蔥技能站7w4.net。

賬戶ID速查

這個記賬技能功能比較全面，能滿足日常家庭財務管理的需求。文件寫得很詳細，提供了多個實用場景的使用示例，新手容易上手。賬戶管理清晰，支援多個賬戶和分類統計。不過部分說明有些重複，細節上還有完善空間。整體來說是一個實用可靠的記賬工具。