Maybe Finance 技能

由 Maybe Finance 驱动的个人财务管理 —— 一款开源的个人财务操作系统。

概述

Maybe Finance 是一款可自托管的个人财务平台，用于追踪以下内容：

• 交易记录（Transactions） —— 收入与支出
• 账户（Accounts） —— 银行账户、投资账户、贷款账户
• 预算（Budgets） —— 每月支出目标
• 净资产（Net Worth） —— 随时间变化的资产减去负债
• 现金流（Cash Flow） —— 收入与支出对比分析

前提条件

1. 自托管的 Maybe 实例 —— 通过 Docker 部署：

   docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest
   

2. API Token —— 在 Maybe 界面中生成：设置 → API Keys

配置

设置环境变量：

export MAYBE_API_URL="http://localhost:3000"
export MAYBE_API_TOKEN="your-api-token"

使用方法

账户管理

# 列出所有账户
maybe-finance accounts list

# 添加新账户
maybe-finance accounts add --name "Alipay" --type checking --balance 5000

# 更新账户余额
maybe-finance accounts update  --balance 6000

# 删除账户
maybe-finance accounts delete 

交易追踪

# 列出最近的交易记录
maybe-finance transactions list --limit 20

# 添加收入
maybe-finance transactions add --amount 10000 --type income --category "工资" --description "三月工资"

# 添加支出
maybe-finance transactions add --amount -150 --type expense --category "餐饮" --description "午餐"

# 搜索交易记录
maybe-finance transactions search --category "餐饮" --from 2024-01-01 --to 2024-03-31

预算分析

# 查看当月预算
maybe-finance budget current

# 按类别分析支出
maybe-finance budget analyze --month 2024-03

# 对比多个月份
maybe-finance budget compare --from 2024-01 --to 2024-03

净资产与报表

# 当前净资产快照
maybe-finance networth

# 现金流报表
maybe-finance cashflow --period monthly

# 生成财务汇总报告
maybe-finance summary --year 2024

脚本

全部功能均可通过 scripts/maybe-cli.py 调用：

• 处理 API 认证
• 格式化输出以提升可读性
• 支持导出为 JSON 格式，便于后续处理

集成思路

• 与 CSV 导入技能对接，实现批量交易录入
• 通过 cron 定期（如每日/每周）生成财务报表
• 导出数据用于税务申报
• 在预算超支时触发告警