AI Agent智能记账与财务管家
项目简介:基于 FastAPI + LangGraph + LangChain、ReAct Agent、Function Calling 和 MySQL 持久化记忆,构建智能记账与个人财务管家,实现自然语言与截图识别记账、Excel 账单导入、分级自动分类、预算监控与超支预警、Agent 自主消费诊断、个人记忆 RAG 财务问答及周报月报生成,通过记账纠正、消费偏好提取和建议反馈积累跨会话记忆,结合真实流水校验、省钱方案去重和执行过程留痕,覆盖智能录入、账本分析、个性化建议与反馈记忆持续复用的完整闭环。
本项目覆盖的技术点
学完能答的面试题
学完这个项目,下面 28 道面试题你都能结合项目细节讲出来。题目在 AIGC 面试刷题网可以免费看。
系统架构
一张图看清整个系统的分层与核心链路,点开可缩放查看细节。
- 1记账统一核对出口文字、截图与表格得到可编辑候选,签名保留原始依据;本人确认后在事务中查重、写流水、更新预算并记录分类纠正。
- 2单 Agent 自主诊断LangGraph 的 decide / act 节点交替执行;模型按需查询账本,代码分发工具,三道额度护栏限制循环。
- 3记忆按场景读取分类和问答使用本人语义记忆,诊断读取启用记忆摘要并按需查库;明确拒绝的建议对象参与代码过滤。
- 4模型提议、程序核算建议对象、本期支出、固定支出、削减上限、历史拒绝与重叠流水均由代码检查,报告金额从真实流水和有效建议计算。
- 5业务与过程分别落库MySQL 保存流水、预算、记忆、报告,agent_run / agent_step 与工具日志记录诊断过程,ai_usage_log 记录模型调用。
技术栈
用到的框架、中间件和模型。
技术难点与解法
每一项优化都针对一个真实问题,讲清楚问题、做法和背后的原理。
01用户纠正要压过公共规则
- 问题
- 用户刚改过分类,下次同商户又被公共规则改回,记忆看似保存却不生效。
- 做法
- 识别结果签名保留原始建议;确认入账发现分类变化才写纠正记忆,同商户个人纠正优先,再走规则、商户默认、普通记忆和模型。
- 原理
- 区分用户明确纠正与一般语义参考,用确定优先级控制业务口径。
02旧向量响应不能覆盖新偏好
- 问题
- 向量生成过程中用户再次修改或删除偏好,迟到结果可能让旧事实重新生效。
- 做法
- 修改后标记待向量化;写回时锁定记忆并比较主体与正文,记录已改或已删则跳过,检索只用启用且模型维度兼容的已完成向量。
- 原理
- 派生索引写回前核对权威数据,更新失败不冒充成功。
03模型不能只说分析完成
- 问题
- Agent 可能没查账本就给结论,或循环查同一工具而不交付。
- 做法
- 限制决策轮数、总调用数与同工具连续次数,执行后反查成功账本查询和本次正式报告;未真正交付则判失败。
- 原理
- 业务完成条件由服务端验证,退出图不等于诊断成功。
04可省金额不能重复计算
- 问题
- 模型同时削减某分类和其中的商户,合计节省重复覆盖相同流水。
- 做法
- 按本人本月支出重算金额,保护固定分类并过滤拒绝对象;分类与商户方案按可省金额排序,涉及已覆盖流水组合的方案剔除。
- 原理
- 金融业务数值由确定性规则计算,模型金额只作受限的建议输入。
05图片读出字段还不能直接入账
- 问题
- 票据压缩、缺失时间或金额误读会产生看似合法的错误记录,重复点击还可能重复写账。
- 做法
- 图片转正、铺白底并限尺寸,视觉模型提取后检查字段,用户现场核对;确认验证签名、锁用户并检查去重键。
- 原理
- 把识别候选和正式交易分开,字段校验与业务幂等分别兜底。
06个人身份不能由模型填写
- 问题
- 模型传错或被诱导传入别人的用户编号,就可能越权查询账本。
- 做法
- ToolContext 通过 ContextVar 绑定服务端用户、运行和月份;工具执行再检查启用状态,finally释放上下文。
- 原理
- 业务查询条件交模型,身份与执行权限由应用控制。
功能清单
按角色看这个系统都能做什么。
记账与账本8 项
- 首页收支看板查看本人账本的收支、结余及图表,从首页进入记账。
- 手动记账填写收支方向、金额、时间、分类和交易对方,保存后直接入账。
- 一句话记账从自然语言提取多笔交易,自动分类,现场核对修改后入账。
AI财务管家5 项
- 消费诊断选择月份,由ReAct Agent按需查询收支、分类、商户、明细、预算、趋势和记忆,提交诊断报告与省钱建议。
- 省钱建议反馈查看代码校验后的建议和金额,点击采纳或填写拒绝理由,反馈写入跨会话记忆。
- 诊断执行历史在消费诊断页查看历史运行,打开详情抽屉检查工具输入、返回、失败原因和耗时。
个人偏好与账号4 项
- 个人偏好查看消费习惯、记账习惯和建议反馈,按类型编辑、启停或删除;维护后的检索数据自动更新。
- 分类纠正记忆在识别核对中修改原建议分类并成功入账后,形成商户映射,有备注时还可形成分类偏好。
- 问答偏好提取回答完成后,模型判断本轮用户是否明确表达长期消费习惯,有效内容持久化到个人偏好。
页面截图
共 13 张真实运行截图,点击大图查看高清原图。
点击放大你将获得
购买后可以拿到的全部内容。
逐章源码学习教程31章
含项目总览,从账号与账本底座,到多模态记账、记忆增强、ReAct诊断和运行观测,按真实页面与源码链路学习。
完整项目源码与SQLFastAPI + Vue 3
前后端源码、固定依赖、23张业务表及教学演示数据,包含记账、预算、记忆、诊断与管理端。
配套源码问答15组
涵盖分类纠正、向量检索、票据识别、工具循环、方案核算、SSE与统计口径,可对照代码准备项目追问。
本地运行与功能说明
项目总览、本地启动、功能测试、Agent技术说明与完整操作链路。
常见问题
下单前最常被问到的几个问题。
需要准备哪些环境?
Python、Node.js和MySQL,后端及前端依赖按项目清单安装。三个模型用途在管理端分别配置,向量维度需与模型返回一致。
模型调用需要额外付费吗?
需要自行申请模型服务密钥,调用按服务商规则计费。对话、视觉、向量通过OpenAI兼容接口接入,代码记录Token用量,不代收模型费用。
记忆增强是不是训练了专属模型?
不是。偏好与反馈保存在MySQL,调用时按需读取或语义检索后提供给模型,不修改模型权重。
所有智能功能都是Agent吗?
消费诊断采用自主工具循环;文字与图片记账、财务问答和报告采用代码规定的处理流程,也会使用模型和个人记忆。
建议采纳会自动扣款或改变真实消费吗?
采纳只保存反馈,供以后分析参考,不执行银行转账、扣费或取消订阅;实际支出仍由后续真实流水反映。
同一月份能保留多版诊断报告吗?
当前月份报告在新结果成功提交后替换,不提供多版报告并排对比;运行历史和独立保存的反馈记忆有各自用途。
基础薄弱能学会吗?
教程是喂饭级的,从登录注册、统一返回这些工程底座讲起,每章都有验证步骤。基础不够的话,可以先按上面的「学习路径」从基础项目学起。
能写进简历、用作毕业设计吗?
可以,配套面试文档里有项目介绍、难点包装和高频追问,照着就能讲清楚。至于毕业设计,有小伙伴问过我,统一回答一下:AI 实战库板块的项目拿去做毕业设计,就四个字——降维打击。
源码能用于商业项目吗?
源码和教程本质上是给大家学习、提升技能的。如果需要商用,自己二次开发一下也没问题,但禁止原项目 + 教程转手倒卖。我是一个程序员,能看到你们学习我的教程提升能力,能听你们叫我一声大佬,挺幸福的!知足~
售后答疑
买完不是结束跟着教程学习,遇到问题不用自己硬扛。