finance-tracker

💰 零依赖隐私优先的智能记账助手

🥥5总安装量 2评分人数 2
100% 的用户推荐

开源个人财务管理工具,支持多币种记账、智能分析与储蓄目标追踪,数据完全本地存储保障隐私安全。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 数据完全本地存储,无云端上传或第三方数据共享风险
  • ✅ 零第三方依赖,仅使用 Python 标准库,供应链攻击面极小
  • ✅ 文件系统操作受限,所有读写限定于 `~/.finance-tracker//` 目录,无路径遍历漏洞
  • ⚠️ 财务数据以明文 JSON 存储,建议用户自行配置目录权限(chmod 700)及磁盘加密
  • ⚠️ 汇率更新依赖外部 API(exchangerate-api.com),存在网络请求日志记录 IP 的潜在隐私暴露

使用说明

核心用法

Finance Tracker v2.0 是一款命令行个人财务管理工具,通过简洁的 CLI 交互实现全功能记账。核心工作流围绕 finance add 快速录入支出,支持智能金额解析(如 50k 自动识别为 50,000)、多币种自动转换($20 自动按实时汇率换算)。配合 finance report 查看周期报表、、finance insights 获取 AI 驱动的消费分析,形成"录入-分析-优化"的完整闭环。

工具采用模块化设计:Recurring 模块管理订阅账单自动记账,Goals 模块设定储蓄目标并计算每日需存金额,Portfolio 模块追踪资产净值,Currency 模块提供实时汇率与离线备用方案。所有数据以 JSON 格式存储于 ~/.finance-tracker/,支持 CSV/JSON 导出,便于跨平台迁移。

显著优点

零依赖架构:纯 Python 标准库实现,无第三方包引入供应链风险,部署极简。 隐私优先设计:财务数据完全本地存储,不上传云端,规避数据泄露风险。 智能交互体验:自然语言解析(50k lunch)、自动分类(12 类消费场景关键词匹配)、异常消费预警,大幅降低记账认知负担。 多币种原生支持:实时汇率 API 双备份 + 内置 fallback 汇率表,确保离线可用性。 可扩展生态:预留 Telegram 集成接口与 Heartbeat 自动化钩子,支持定时任务触发。

潜在缺点与局限性

平台绑定:CLI 交互对非技术用户门槛较高,缺乏图形界面与移动端原生 App。 汇率精度:免费汇率 API 存在 6 小时缓存延迟,高频跨境消费场景下可能存在换算偏差。 数据同步:纯本地存储导致多设备间需手动同步 ~/.finance-tracker// 目录,无内置云同步机制。 分析深度:智能洞察基于规则统计,非真正 AI 模型,复杂财务规划建议能力有限。 社区生态:作为个人开源项目,长期维护稳定性与功能迭代速度存不确定性。

适合的目标群体

技术型个人用户:熟悉命令行操作、重视数据隐私的开发者或 IT 从业者。 轻量记账需求者:无需复杂投资分析、企业级报表的日常生活支出管理场景。 多币种消费者:频繁进行跨境消费、需要自动汇率换算的留学生或远程工作者。 隐私敏感群体:拒绝将银行流水、消费习惯上传至商业记账 App 的用户。 自动化爱好者:希望通过脚本、定时任务实现财务数据自动处理的技术极客。

使用风险

数据安全风险:本地 JSON 文件未加密,设备丢失或被盗可能导致财务信息泄露,建议配合磁盘加密使用。 汇率服务可用性:依赖外部汇率 API,服务中断时虽可 fallback 至内置汇率,但精度下降。 数据完整性风险:异常断电或进程崩溃可能导致 JSON 文件损坏,需建立定期备份机制。 版本兼容性:未来大版本升级可能存在数据格式变更,迁移前需验证兼容性。

finance-tracker 内容

文件夹图标bin文件夹
文件夹图标lib文件夹
手动下载zip · 33.2 kB
finance.pytext/plain
请选择文件