Smart Ledger

智能收支追踪器 — 通过自然语言快速记账,自动分类,生成日/周/月报告和趋势分析。 支持中文自然语言输入("今天午饭花了35元"),数据本地JSON存储保护隐私。 适用于个人财务管理、预算追踪和消费分析场景。

安装

概览

什么是Smart Ledger

Smart Ledger 是一款专为个人财务管理设计的智能收支追踪工具,通过简洁的自然语言输入实现快速记账与消费分析。用户只需用日常语言描述收支情况(如“今天午饭花了35元”或“收到工资8000”),系统即可自动识别金额、时间、类型并完成分类记录。其核心优势在于完全本地化的数据存储机制,所有财务信息以 JSON 格式保存在本地文件中,确保隐私安全且无需担心云端泄露风险。该工具支持中英文混合输入,覆盖从餐饮到交通、购物、娱乐等常见消费场景,并能根据关键词智能归类,极大降低了手动记账的复杂度。 除了基础记账功能,Smart Ledger 还提供多维度财务报告体系,涵盖日报、周报、月报及趋势分析模块。每日可查看当日的收支明细与分类汇总;每周生成包含日均支出和TOP消费类别的周度总结;月度报告则深入展示预算执行情况和环比变化趋势。特别值得一提的是其异常消费检测能力,能够自动标记超出历史均值两倍的支出行为,帮助用户及时发现非理性消费模式。此外,用户还可通过命令行灵活调用不同统计周期(如最近7天/30天摘要)或导出JSON格式数据供其他程序处理,满足自动化集成需求。 整个系统采用纯Python标准库开发,无外部依赖,部署简单且运行稳定。无论是刚接触财务管理的初学者还是希望精细化控制支出的进阶用户,都能通过定期复盘生成的可视化报告清晰掌握自己的资金流向,从而制定更合理的预算规划并培养健康的消费习惯。

核心功能特点

  1. 自然语言快速记账:支持中文口语化表达(如’今天午饭花了35元’),自动解析金额、时间和交易类型
  2. 智能自动分类:基于关键词匹配将收支归入餐饮、交通、购物等预设类别,支持自定义扩展
  3. 多周期财务报告:提供日报、周报、月报模板,包含收支概览、分类统计与趋势图表
  4. 本地数据保护:全部财务信息以JSON格式存储在本地路径,不上传云端保障隐私安全
  5. 异常消费预警:自动检测超过历史均值2倍以上的大额支出,提示潜在过度消费风险

适用场景

Smart Ledger 特别适合需要精细化管理日常开支的个人用户。对于上班族而言,每天下班后花几分钟录入当日餐饮、通勤、购物等小额支出,配合每周生成的周报,能清晰看出哪类开销占比过高,从而调整消费结构。例如发现外卖支出连续三周超预算,便可考虑减少频次或改用自制餐食。学生群体也可借助此工具追踪奖学金使用、兼职收入分配等情况,避免冲动消费导致生活费紧张。 家庭主妇或自由职业者同样受益于该工具的灵活性与透明度。通过设置各分类的月度预算阈值(如交通费不超过1000元),系统会在接近限额时发出预警;而每月末的汇总报告则能对比实际支出与计划差异,为下月制定更精准的开支策略。对于经常出差的商务人士,还可利用其跨地域消费记录分析差旅成本,优化报销流程。 此外,程序员或技术爱好者若希望将记账过程融入现有工作流,可通过调用`expense-tracker.py`模块实现API级集成,甚至结合脚本批量导入历史账单数据。由于其输出支持JSON格式,也便于与其他财务软件(如Excel、Notion数据库)联动,构建个性化的个人财务管理系统。无论你是想遏制剁手冲动、规划旅行基金,还是单纯了解钱都花去了哪里,Smart Ledger 都能成为高效可靠的数字助手。