预算与支出追踪器 — AI代理金融指挥中心

追踪每一美元，执行预算，发现消费模式，构建财富 — 所有这些都通过与您的AI代理的自然对话完成。

工作原理

您自然地与代理交谈："我在杂货上花费了45美元"或"我这个月在食物上花了多少钱？"代理维护一个本地JSON账本，执行您的预算，并为您提供每周/每月的财务智能。

1. 设置 — 您的财务档案

首次使用时，在您的工作区创建budget-profile.json：

{
  "currency": "USD",
  "monthlyIncome": 5000,
  "payDays": [1, 15],
  "fiscalMonthStart": 1,
  "categories": {
    "housing": { "budget": 1500, "essential": true },
    "food": { "budget": 600, "essential": true, "subcategories": ["groceries", "dining", "delivery", "coffee"] },
    "transport": { "budget": 300, "essential": true, "subcategories": ["fuel", "public", "rideshare", "parking"] },
    "utilities": { "budget": 200, "essential": true, "subcategories": ["electric", "water", "internet", "phone"] },
    "health": { "budget": 200, "essential": true, "subcategories": ["gym", "medical", "supplements"] },
    "entertainment": { "budget": 200, "essential": false, "subcategories": ["streaming", "games", "events", "hobbies"] },
    "shopping": { "budget": 300, "essential": false, "subcategories": ["clothes", "electronics", "home", "gifts"] },
    "education": { "budget": 100, "essential": false, "subcategories": ["books", "courses", "subscriptions"] },
    "savings": { "budget": 500, "essential": true, "target": "emergency-fund" },
    "misc": { "budget": 100, "essential": false }
  },
  "alerts": {
    "budgetWarning": 0.75,
    "budgetCritical": 0.90,
    "unusualSpend": 2.0,
    "dailyMax": 200
  },
  "goals": []
}

自定义类别、预算和子类别以适应您的生活。代理会适应您定义的任何结构。

2. 账本 — 交易格式

所有交易都存储在budget-ledger.json中：

{
  "transactions": [
    {
      "id": "tx_20260213_001",
      "date": "2026-02-13",
      "type": "expense",
      "amount": 45.67,
      "category": "food",
      "subcategory": "groceries",
      "description": "Weekly shop at Aldi",
      "merchant": "Aldi",
      "paymentMethod": "debit",
      "tags": ["weekly", "essentials"],
      "recurring": false,
      "note": ""
    }
  ],
  "recurringRules": [],
  "metadata": {
    "lastUpdated": "2026-02-13T10:30:00Z",
    "transactionCount": 1,
    "ledgerVersion": "1.0"
  }
}

交易ID约定

tx_YYYYMMDD_NNN — 日期 + 序列号。永远不要重复使用ID。

3. 自然语言解析

当用户谈论金钱时，将其解析为交易：

解析规则

用户说	提取的
“在杂货上花费了45美元”	支出，45美元，食品/杂货
“支付租金1500美元”	支出，1500美元，住房
“收到2500美元”	收入，2500美元，工资
“uber 12美元”	支出，12美元，交通/共乘
“Netflix每月15.99美元”	支出，15.99美元，娱乐/流媒体，重复
“咖啡5美元”	支出，5美元，食品/咖啡
“给妈妈寄了200美元”	支出，200美元，杂项（问：礼物还是贷款？）
“退回鞋子得到80美元退款”	退款，80美元，购物/衣服

歧义解决

如果类别不明确，做出最好的猜测并确认：“在食品/杂货下记录了45美元 —— 正确吗？”
如果缺少金额，询问：“那是多少钱？”
如果提到"每月"或"每周"，创建一个重复规则
“退回"或"退款” = 负支出（信用）
“借出"与"借入” —— 始终澄清方向

重复交易

当用户提到重复支出时，创建一个规则：

{
  "id": "rec_001",
  "description": "Netflix订阅",
  "amount": 15.99,
  "category": "entertainment",
  "subcategory": "streaming",
  "frequency": "monthly",
  "dayOfMonth": 15,
  "active": true,
  "lastApplied": "2026-02-15"
}

在每次预算检查时，自动应用任何到期的重复交易。

4. 预算执行引擎

实时预算检查

在记录每笔支出后运行此检查：

1. 计算本月该类别的总支出
2. 与预算限额比较
3. 计算已使用百分比
4. 检查本月剩余天数
5. 计算剩余的每日预算
6. 如有需要，触发警报

警报级别

级别	触发器	响应
🟢 按计划进行	< 75%预算，与本月进度成比例	静默（仅记录）
🟡 警告	75-90%预算已使用	“注意 — 您已经使用了600美元食品预算的78%，剩余18天。每天剩余3.67美元。”
🔴 严重	> 90%预算已使用	“⚠️ 食品预算已达92%（552/600），剩余12天。每天只剩下4美元。本周考虑在家做饭。”
🚨 超预算	> 100%	“🚨 您的600美元食品预算已超出47美元。总计：647美元。这会影响您的储蓄目标。”
⚡ 不寻常	单笔交易 > 2倍类别平均值	“89美元的咖啡购买似乎不寻常 — 您的平均值是5.20美元。金额正确吗？”

节奏跟踪（智能预算智能）

不要只跟踪总数 — 跟踪消费节奏：

本月已过天数：13
本月剩余天数：15
预算：600美元
到目前为止已花费：380美元
每日节奏：29.23美元/天（消费）
可持续节奏：21.43美元/天（预算/总天数）
剩余节奏：14.67美元/天（剩余预算/剩余天数）

结论：消费速度比可持续速度高出37%。按当前节奏，将超出预算约160美元。

这比仅仅"您已花费X美元中的Y美元"更有用，因为它预测了未来。

5. 储蓄目标

目标结构

{
  "id": "goal_001",
  "name": "紧急基金",
  "targetAmount": 10000,
  "currentAmount": 3500,
  "deadline": "2026-12-31",
  "priority": "high",
  "contributions": [
    { "date": "2026-02-01", "amount": 500, "note": "每月自动保存" }
  ],
  "autoContribute": {
    "enabled": true,
    "amount": 500,
    "frequency": "monthly",
    "dayOfMonth": 1
  }
}

目标智能

在检查目标时计算：

按计划进行？ 将当前储蓄率与所需速率进行比较
预计完成时间： 按当前速率，何时会达到目标？
加速选项： “如果您每月多存100美元，您将提前2个月实现目标”
盈余分配： 如果本月预算有剩余，建议将盈余用于目标

6. 报告与智能

每周总结（每周日运行或按需运行）

📊 2026年2月7-13日的一周

💸 花费：487.23美元
💰 收入：2,500.00美元
📈 净额：+2,012.77美元

顶级类别：
  🏠 住房：375美元（租金分摊）
  🍔 食品：112.23美元（预算的18.7%已使用，按计划进行）

⚡ 不寻常：0美元被标记
🎯 目标：紧急基金35% → 40%（+500美元）
💡 洞察：与上周相比，食品支出下降了12%。做得好。

月度报告（每月第一天运行）

📊 2026年1月 — 完整报告

收入：         5,000.00美元
支出：         3,847.23美元
净储蓄：      1,152.77美元（23.1%储蓄率）

预算表现：
  ✅ 住房：      1,500 / 1,500（100%）— 按预算
  ✅ 食品：         534 / 600（89%）— 节省66美元
  ✅ 交通：      187 / 300（62%）— 节省113美元
  ⚠️ 购物：      342 / 300（114%）— 超出42美元
  ✅ 娱乐：      156 / 200（78%）— 节省44美元

类别趋势（与上个月相比）：
  📈 食品：+8%（534美元 vs 495美元）
  📉 交通：-23%（187美元 vs 243美元）— 很好！
  📈 购物：+37%（342美元 vs 250美元）— 注意这个

储蓄目标：
  🎯 紧急基金：4,000 / 10,000（40%）— 预计8月完成
  🎯 假期：800 / 2,000（40%）— 按计划进行

顶级商家：
  1. Aldi — 178美元（12次访问）
  2. Amazon — 156美元（8个订单）
  3. Shell — 89美元（6次加油）

💡 洞察：
  • 购物超出预算14% — 2月8日的3个Amazon订单总计120美元
  • 您在交通上节省了113美元（在家工作更多？）
  • 按当前储蓄率（每月1,153美元），紧急基金将在8月完成
  • 考虑将66美元的食品盈余转移到假期目标

年初至今仪表板（按需）

📊 2026年初至今（1-2月）

总收入：    10,000美元
总支出：    7,694美元
总储蓄：     2,306美元（23.1%比率）
目标进度：  紧急基金40%，假期40%

最佳月份：1月（24.2%储蓄率）
最差类别：购物（平均107%的预算）
最大改进：交通（-15%趋势）

7. 智能洞察引擎

超越基本跟踪，提供可操作的智能：

消费模式

一周中的哪一天分析： “您在周末的支出比工作日多40%。周六平均：67美元 vs 工作日23美元”
商家忠诚度： “这个月您去了星巴克18次。在家设置咖啡在3周内就回本。”
类别蔓延： “购物在过去3个月每个月增加了15%。预计：下个月450美元。”

优化建议

订阅审核： “您有6个流媒体服务（每月78美元）。Netflix使用了20次，Disney+一次。考虑取消Disney+。”
预算重新平衡： “您已经连续3个月低于交通预算。考虑减少到200美元，并将100美元转移到储蓄。”
现金流时机： “您最大的支出在1-5日。考虑将一些转移到15日的支付周期。”

财务健康评分（0-100）

每月计算：

因素	权重	评分
储蓄率	30%	20%+ = 100, 10-20% = 70, 5-10% = 40, <5% = 10
预算遵守	25%	全部低于 = 100, 1超过 = 80, 2-3超过 = 50, 4+ = 20
目标进度	20%	按计划进行 = 100, 略有落后 = 60, 严重落后 = 20
支出稳定性	15%	低方差 = 100, 中等 = 60, 波动大 = 20
无债消费	10%	未使用信用 = 100, 一些 = 50, 重 = 10

评分解释：

90-100: 💪 优秀 — 财富构建模式
70-89: 👍 良好 — 可能需要小的优化
50-69: ⚠️ 一般 — 需要关注特定领域
低于50: 🚨 需要工作 — 创建行动计划

8. 命令参考

命令	它的作用
“我在Y上花费了X美元”	记录支出
“收到X美元”	记录收入
“预算检查”	显示所有预算与实际的对比
“每周总结”	本周的报告
“月度报告”	整个月的分析
“在食物上花了多少钱？”	类别深入分析
“将食品预算设置为500美元”	更新预算
“添加目标：假期2000美元，6月前”	创建储蓄目标
“为假期节省200美元”	记录目标贡献
“财务健康”	计算健康评分
“不寻常的支出？”	标记异常值
“订阅审核”	列出重复+使用情况
“与上个月比较”	月度趋势
“导出CSV”	导出账本以用于电子表格
“撤销上一个”	删除上一笔交易

9. 数据管理

文件位置

budget-profile.json — 您的财务档案和预算
budget-ledger.json — 所有交易
budget-goals.json — 储蓄目标和贡献
budget-recurring.json — 重复交易规则

CSV导出格式

当用户要求导出时：

日期，类型，金额，类别，子类别，描述，商家，标签
2026-02-13,支出，45.67，食品，杂货，Aldi的每周购物，Aldi，"每周，必需品"

备份

定期提醒用户备份他们的账本。如果工作区是仓库，提供提交到git的选项。

隐私

所有数据都保持本地。没有外部API。没有云同步。您的财务数据永远不会离开您的机器。

10. 边缘案例

拆分交易： “晚餐80美元，与朋友分摊” → 记录40美元作为您的份额
外币： “在巴黎花费50欧元” → 按当前汇率转换，注明原始货币
现金返还/奖励： 作为收入子类别"现金返还"进行跟踪
账户间转账： 不计为支出或收入 — 作为"转账"类型记录
共享支出： 使用"共享"标签，并注明谁欠什么
税收抵免： 使用"税收抵免"标签进行年终过滤
同月退货： 与类别抵消。跨月：作为退款收入记录。
变动收入： 如果收入变化，使用3个月的滚动平均值进行预算计算