目 录CONTENT

文章目录

让 AI 接管你的账本:基于 Firefly III 的大模型智能记账技能深度体验

让 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)。
  • 自动化分析:一句话生成月度报告,按分类、预算、标签或账户等多维度汇总你的收支情况,甚至还能输出多期净增长的趋势分析。

🛠 极客视角的原理解析

对于关注技术的极客朋友来说,这个项目的实现非常优雅。它本质上包含两层:

  1. 底层的 Python CLI 客户端 (scripts/firefly_client.py):纯 Python 3 标准库编写,零第三方依赖(不需要 pip install 任何包)。它封装了 Firefly III 的复杂 API,提供了清晰的命令行接口。
  2. 大模型技能定义 (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 终端

部署步骤非常简单:

  1. 克隆项目仓库:

    git clone https://github.com/zh-Littlebird/where-is-my-money.git
    cd where-is-my-money
    
  2. 配置鉴权信息:
    复制配置文件模板并填入你的实例地址和 Token:

    cp config.example.json config.json
    

    (注:config.json 已在 .gitignore 中排除,确保了敏感 Token 不会被意外提交到代码库。)

  3. 在 Claude Code 中激活:
    在项目目录下启动 Claude Code,加载 SKILL.md,随后你就可以直接对 Claude 说话了:“帮我查一下这个月的账单汇总”。

💡 总结

where-is-my-money 为开源财务工具与 AI Agent 的结合提供了一个极佳的示范。通过将复杂的 API 调用转化为 LLM 可理解的 Skill,它大大降低了专业财务工具的使用门槛。

如果你已经是 Firefly III 的重度用户,并且平时习惯使用 Claude Code 等 AI 工具,那么这款技能绝对值得加入你的工具箱。让我们把繁琐的数据录入交给 AI,把精力留给真正的财务规划与生活体验吧!

0

评论区

引用声明:

本页面包含了一些引用自其他作者或来源的内容,旨在支持和补充本博客的主题。所有引用内容的版权归原作者或来源所有。

免责声明:

本博客的目的是用于个人学习、研究和知识分享,不以商业用途为目的。如有侵权或引用内容错误,请联系我们进行更正。

GeekScribe
2023/11/8