让 AI 接管你的账本:基于 Firefly III 的大模型智能记账技能深度体验
随着 AI Agent 技术的爆发,我们越来越习惯用自然语言让大模型帮我们处理日常琐事。但在个人财务管理领域,很多人依然面临着一个痛点:记账太反人类了。
传统记账软件往往需要你手动打开 App、输入金额、选择账户、挑选分类、填写备注……这种繁琐的流程常常让人难以坚持。如果能把这项高频且机械的任务交给 AI,只需“动动嘴”或“发张图”,那绝对是极客玩家的福音。
今天为大家推荐一款由开发者 zh-Littlebird 开源的利器——Firefly III 记账技能 (where-is-my-money)。它将强大的开源财务管理系统 Firefly III 与大模型(如 Claude Code)完美融合,为你打造了一个全自动的私人财务管家。
🌟 为什么我们需要 AI 记账?
Firefly III 是一款极其优秀的开源自托管财务管理工具,拥有复式记账、预算、存钱罐等专业特性。但它的缺点也很明显:操作界面相对复杂,录入成本高。
而 where-is-my-money 项目通过提供大模型专用的 SKILL.md 和底层脚本,直接赋予了 AI 操作你私人账本的权限,彻底改变了记账范式:
1. 极致的自然语言记账
告别死板的表单!你现在可以在对话框里直接告诉 AI:
- “刚打车花了 20”
- “昨天晚上在罗森便利店买了饮料和饭团,总共 15.6 元,微信支付”
- “帮我查一下这个月在餐饮上花了多少钱?”
AI 会自动解析意图,提取金额、描述,并智能匹配你 Firefly III 中的对应账户和消费分类,瞬间完成录入。
2. 票据截图智能入账
去餐厅吃完饭,直接拍下小票或支付凭证截图发给 AI。结合多模态大模型的视觉能力,它可以自动识别图片内容,提取交易时间、商家名称、具体明细和总金额,生成结构化的账单记录。这对高频消费或容易忘账的“懒人”来说简直是杀手级功能。
3. 全面的财务大盘管理
这不仅仅是一个录入工具,它还支持对整个账本的高级管理:
- 交易管理:增删改查无所不能,支持多字段、布尔逻辑的复杂搜索。
- 资产规划:管理周期性支出的账单(Bills)、追踪你的储蓄目标(存钱罐 Piggybanks)。
- 自动化分析:一句话生成月度报告,按分类、预算、标签或账户等多维度汇总你的收支情况,甚至还能输出多期净增长的趋势分析。
🛠 极客视角的原理解析
对于关注技术的极客朋友来说,这个项目的实现非常优雅。它本质上包含两层:
- 底层的 Python CLI 客户端 (
scripts/firefly_client.py):纯 Python 3 标准库编写,零第三方依赖(不需要 pip install 任何包)。它封装了 Firefly III 的复杂 API,提供了清晰的命令行接口。 - 大模型技能定义 (
SKILL.md):这是专门为 Claude Code 等 AI 终端编写的配置文件。它告诉大模型:“如果你收到关于记账的需求,请调用对应的 Python 脚本,并按这种格式传递参数。”
这种解耦设计意味着,底层的脚本不仅可以被 AI 调用,你完全可以把它集成到自己的自动化脚本(如 Shortcuts、Cron 任务)中,作为独立的 CLI 工具使用。
🚀 快速上手指南
想要体验这种“霸总式”的 AI 记账服务,你需要准备:
- Python 3.7+ 环境
- 一个运行中的 Firefly III 实例
- Firefly III 的 Personal Access Token (PAT)
- Claude Code CLI 终端
部署步骤非常简单:
-
克隆项目仓库:
git clone https://github.com/zh-Littlebird/where-is-my-money.git cd where-is-my-money -
配置鉴权信息:
复制配置文件模板并填入你的实例地址和 Token:cp config.example.json config.json(注:
config.json已在.gitignore中排除,确保了敏感 Token 不会被意外提交到代码库。) -
在 Claude Code 中激活:
在项目目录下启动 Claude Code,加载SKILL.md,随后你就可以直接对 Claude 说话了:“帮我查一下这个月的账单汇总”。
💡 总结
where-is-my-money 为开源财务工具与 AI Agent 的结合提供了一个极佳的示范。通过将复杂的 API 调用转化为 LLM 可理解的 Skill,它大大降低了专业财务工具的使用门槛。
如果你已经是 Firefly III 的重度用户,并且平时习惯使用 Claude Code 等 AI 工具,那么这款技能绝对值得加入你的工具箱。让我们把繁琐的数据录入交给 AI,把精力留给真正的财务规划与生活体验吧!
评论区