shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析无需 API Key

ai-finance

AI 财务记录表 - 个人/家庭收支记账、分类统计、预算管理和 Excel 报表导出。使用场景：记录收入支出、查看月度/年度财务报表、设置预算提醒、导出 Excel 账单、分析消费习惯。

person作者: user_87fe1a85hubcommunity
download下载资源包

AI 财务记录表 (AI Finance Tracker)

基于 SQLite + Python CLI 的个人财务管理工具，支持记账、统计分析和 Excel 导出。

初始化

首次使用时，安装脚本和初始化数据库：

# 1. 安装脚本到用户目录
SKILL_DIR="<SKILL安装时的实际路径，AI自动获取>"
TARGET="$HOME/.ai-finance/scripts"
mkdir -p "$TARGET"
cp "$SKILL_DIR/scripts/finance.py" "$TARGET/"
cp "$SKILL_DIR/scripts/export_excel.py" "$TARGET/"
echo "✅ 脚本安装完成"

# 2. 安装依赖
sudo pip3 install openpyxl --break-system-packages -q 2>/dev/null || true

# 3. 初始化数据库（自动创建表和默认分类）
python3 "$TARGET/finance.py" list --limit 1 2>/dev/null || echo "数据库就绪"

SKILL_DIR 由 AI 在加载 SKILL 时自动填写（即 skills/ai-finance/ 的绝对路径）。

记录收支

用户说"记一笔收入/支出"、"花了35块吃午饭"、"收到工资12000"等，提取参数后执行：

python3 ~/.ai-finance/scripts/finance.py add <income|expense> <分类名> <金额> [备注] [--date YYYY-MM-DD]

快捷解析规则（AI 自动提取，无需询问）： | 用户原话 | 类型 | 分类 | 金额 | 备注 | |-----------|------|------|------|------| | "花了35块吃午饭" | expense | 餐饮 | 35 | 午饭 | | "收到工资12000" | income | 工资 | 12000 | — | | "房租2500" | expense | 住房 | 2500 | 房租 | | "打车花了42" | expense | 交通 | 42 | 打车 |

如分类名不完全匹配，CLI 会列出可用分类，AI 取最相近的一项或询问用户。

查看流水

用户说"查看账单"、"最近花了什么"、"本月收支"：

python3 ~/.ai-finance/scripts/finance.py list [--month YYYY-MM] [--limit N]
  • 不传 --month 则显示全部
  • --limit 默认 20 条

收支统计

用户说"本月花了多少"、"5月账单"、"今年消费分析"：

python3 ~/.ai-finance/scripts/finance.py stats [--month YYYY-MM]
  • 不传 --month 显示全部 + 月度趋势
  • 传 --month 2026-05 显示该月分类 TOP 柱状条

预算管理

设置预算：

python3 ~/.ai-finance/scripts/finance.py budget-set <分类名> <金额> [YYYY-MM]

不传月份默认为当前月

查看预算执行：

python3 ~/.ai-finance/scripts/finance.py budget-check [YYYY-MM]

显示每类支出/预算比，超支 ⚠️、接近 ⚡、安全 ✅

导出 Excel

用户说"导出Excel"、"生成账单报表"：

python3 ~/.ai-finance/scripts/export_excel.py <YYYY-MM|ALL> [输出路径]
  • 不传输出路径时，自动保存到 ~/.ai-finance/exports/
  • 生成的文件含 2~3 个 Sheet：
    • 收支明细 — 每笔记录 + 汇总行
    • 分类统计 — 按分类汇总
    • 月度趋势 — （仅 ALL 模式）各月收支对比

导出完成后，AI 告知用户完整路径，可直接打开。

添加自定义分类

python3 ~/.ai-finance/scripts/finance.py cat-add <income|expense> <分类名> [emoji图标]

默认分类

| 收入 | 支出 | |------|------| | 💰 工资 | 🍜 餐饮 | | 🎁 奖金 | 🚇 交通 | | 💼 兼职 | 🛒 购物 | | 📥 其他收入 | 🏠 住房 | | | 🎮 娱乐 | | | 💊 医疗 | | | 📚 教育 | | | 📱 通讯 | | | 📤 其他支出 |

注意事项

  • 金额单位：人民币（¥），精度 2 位小数
  • 日期格式：YYYY-MM-DD（默认当天）
  • 数据库自动创建，无需手动建表
  • 分类名支持模糊匹配，AI 在首次使用时可建议用户使用已有分类
  • Windows 用户路径：C:\Users\<用户名>\.ai-finance\（脚本同理）