Finance Tracker v2.0

完整的个人财务管理工具。支持记录支出、定期订阅、储蓄目标、多币种支持以及智能分析。

安装

clawdhub install finance-tracker

或添加到 PATH 环境变量：

export PATH="$PATH:/path/to/finance-tracker/bin"

快速上手

# 记录一笔支出
finance add 50k "咖啡馆午餐"

# 带货币转换的记录
finance add $20 "在线购物"

# 查看消费情况
finance report week

# 获取智能分析建议
finance insights

核心命令

添加支出

finance add <金额> "<描述>"

金额格式：

• 50000 — 简单数字
• 50k — 使用 k 后缀（表示 50,000）
• $50 — 美元，自动转换为默认货币
• €100 — 欧元
• 100 USD — 明确指定币种

示例：

finance add 50000 "午餐"
finance add 50k "杂货采购"
finance add $25 "Netflix 订阅"

撤销与编辑

# 取消最近一条交易
finance undo

# 编辑某条交易
finance edit <id> --amount=60000
finance edit <id> --desc="朋友聚餐"
finance edit <id> --category=food

# 删除特定交易
finance delete <id>

查看与搜索

finance report [周期]    # today, week, month, year, all
finance recent [n]         # 最近 n 条交易
finance search "food"      # 按关键词搜索

🔄 定期支出

自动追踪重复发生的订阅和账单。

添加定期支出

finance recurring add <金额> "<描述>" <频率> [--day=N]

频率选项： daily, weekly, biweekly, monthly, quarterly, yearly

示例：

finance recurring add 110k "手机服务费" monthly --day=1
finance recurring add 50k "Netflix" monthly
finance recurring add 200k "健身房会员" monthly --day=15

管理定期支出

finance recurring              # 列出所有定期支出
finance recurring list         # 与上同
finance recurring due          # 显示今天到期的项目
finance recurring process      # 自动记录所有到期支出
finance recurring remove <id>  # 停用某项

工作原理

• 定期支出会记录下次到期时间
• 建议每日运行 finance recurring process（或在心跳任务中执行）以自动记录
• 每次记录的支出都会出现在常规交易中
• 月度汇总会在定期支出报告中显示

🎯 储蓄目标

设定财务目标并跟踪进度。

添加目标

finance goal add "<名称>" <目标金额> [--by=日期] [--current=当前金额]

示例：

finance goal add "新笔记本电脑" 5000000 --by=2026-06-01
finance goal add "应急基金" 10000000
finance goal add "度假" 3000000 --by=2026-08-01 --current=500000

跟踪进度

# 向目标增加金额（累加）
finance goal update "Laptop" 500k

# 设置精确金额
finance goal set "Laptop" 2000000

# 查看所有目标
finance goal
finance goal list

目标功能

• 截止日期追踪 — 显示剩余天数
• 日/周/月目标值 — 达到截止日期所需每日储蓄额
• 优先级设置 — 高、中、低
• 完成状态追踪 — 达成目标时可庆祝！

💱 多币种支持

基于实时汇率的自动货币转换。

查看汇率

finance rates              # 显示常见币种汇率
finance rates USD          # 查看特定币种汇率
finance rates EUR

转换货币

finance convert 100 USD UZS
finance convert 50 EUR USD

支出中的自动转换

# 这些会自动转换为默认货币（UZS）
finance add $50 "亚马逊购物"
finance add €30 "应用订阅"
finance add 100 USD "在线课程"

设置默认币种

finance currency         # 显示当前默认币种
finance currency USD     # 更改默认币种

汇率缓存机制： 每 6 小时自动刷新一次。

💡 智能分析

基于 AI 的支出分析与提醒功能。

finance insights    # 完整分析报告
finance summary     # 快速每日摘要
finance digest      # 每周摘要

分析报告内容

• 支出速度 — 日均、周均、月均支出
• 周期对比 — 本周 vs 上周
• 类别变化 — 哪些类别上升或下降
• 异常检测 — 标记异常大额支出
• 目标进度 — 每日需储蓄金额
• 定期支出提醒 — 今日到期的订阅

示例输出

💡 智能分析
━━━━━━━━━━━━━━━━━━━━━

📈 支出速度
   日均：85,000 UZS
   本月至今：1,200,000 UZS
   预计本月总额：2,550,000 UZS

📊 本周 vs 上周
   📈 支出增长 23%
   本周：595,000 UZS
   上周：484,000 UZS

🏷️ 类别变动
   🍔 食品：↑ 45%
   🚗 交通：↓ 20%

⚠️ 提醒事项
   • 异常大额支出：电子产品花费 350,000

🎯 储蓄目标
   每日需储蓄：50,000 UZS
   下个截止日期：笔记本电脑，45 天后

收入与资产

记录收入

finance income 5000000 "工资"
finance income 500k "自由职业项目"

系统自动识别收入类型：salary（工资）、freelance（自由职业）、business（商业）、investment（投资）、gift（礼物）

管理资产

finance asset add "银行账户" 10000000 cash
finance asset add "股票" 5000000 stocks
finance asset add "比特币" 2000000 crypto
finance asset remove "旧账户"
finance asset list
finance portfolio          # 净资产概览

资产类型：cash（现金）、stocks（股票）、crypto（加密货币）、realestate（房地产）、savings（储蓄）、investments（投资）

分析功能

finance trends [天数]      # 过去一段时间的支出趋势
finance compare [天数]     # 当前周期与前一周期对比
finance budget <每日额度>     # 检查是否超出每日预算

预算检查

finance budget 100k

显示：

• 今日支出与预算对比
• 本周支出与周预算对比（7倍日预算）
• 剩余金额
• 超支警告

分类管理

系统根据描述自动识别支出类别：

技能：财务追踪器

版本：2.0.0

分块：2/2

数据存储

所有数据本地存储在 ~/.finance-tracker/ 目录下：

~/.finance-tracker/
├── transactions.json     # 所有支出记录
├── FINANCE_LOG.md        # 可读性高的日志文件
├── portfolio.json        # 资产信息
├── income.json           # 收入记录
├── recurring.json        # 定期支出
├── goals.json            # 储蓄目标
└── exchange_rates.json   # 缓存的汇率数据

导出功能

finance export csv
finance export json

Telegram 集成

在聊天中快速记录支出，支持常见模式：

"花费 50k 午餐" → finance add 50000 "午餐"
"出租车 15k"    → finance add 15000 "出租车"
"咖啡 8k"      → finance add 8000 "咖啡"

心跳集成（Heartbeat）

将以下内容加入你的 HEARTBEAT.md 以实现自动化处理：

## 财务（每日）
- 执行：finance recurring process
- 执行：finance summary

完整命令参考

支出相关：
  finance add <金额> "<描述>"         添加一笔支出
  finance undo                      撤销上一条记录
  finance edit <ID> [--amount=数值]  编辑交易记录
  finance delete <ID>               删除交易记录
  finance report [时间段]           生成支出报告
  finance recent [数量]             查看最近的交易
  finance search "<关键词>"         搜索交易

定期支出：
  finance recurring                 列出所有定期支出
  finance recurring add ...         添加订阅项目
  finance recurring remove <ID>     移除定期支出
  finance recurring process         自动记录到期项
  finance recurring due             显示今日到期项

储蓄目标：
  finance goal                      列出所有目标
  finance goal add "<名称>" <目标金额> [--by=日期]
  finance goal update "<名称>" <已存金额>
  finance goal set "<名称>" <当前金额>
  finance goal remove "<名称>"

货币相关：
  finance rates [货币代码]          显示汇率
  finance convert <金额> <源币种> <目标币种>
  finance currency [代码]           获取或设置默认货币

收入与资产：
  finance income <金额> "<描述>"
  finance asset add/remove/list
  finance portfolio

分析功能：
  finance insights                  智能分析建议
  finance summary                   每日汇总
  finance digest                    每周摘要
  finance trends [天数]
  finance compare [天数]
  finance budget <每日预算>

其他功能：
  finance categories                查看分类列表
  finance export [csv|json]         导出数据
  finance help                      查看帮助

使用小贴士

1. 使用 'k' 表示千 — 输入 50k 比 50000 更快捷
2. 支持货币前缀 — 如 $50 会自动识别并转换
3. 每日定期检查 — 在心跳任务中运行 finance recurring process
4. 每周分析 — 运行 finance digest 获取总结
5. 目标跟踪 — 每次存钱后更新目标进度
6. 预算提醒 — 运行 finance budget 100k 设置每日预算以保持控制

由 Salen 用 🦞 制作