finance-tracker

核心用法

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 v2.0 是一款命令行个人财务管理工具，主打纯本地数据存储与极简交互。核心用法围绕 finance add 展开，支持智能金额解析（50k 简写、$20 多币种自动转换）。完整功能覆盖：日常记账、周期性订阅追踪、储蓄目标管理、多币种实时汇率、资产组合统计及 AI 风格消费洞察。

显著优点

隐私安全极致化：所有数据仅存于 ~/.finance-tracker/ 本地目录，无云端同步、无遥测、无账号体系，通过 S+ 安全认证（96/100）。代码层面零外部依赖，纯 Python 标准库实现，无 eval/exec/system 等危险函数。

多币种体验流畅：自动识别 $50/€30/100 USD 等格式，调用公开汇率 API（只读 GET）实时转换，缓存 6 小时，支持 150+ 货币对。

自动化程度高：recurring process 一键结算到期订阅，insights 生成消费速度、同比环比、异常支出、目标进度等维度的智能报告。

数据可携带性：原生支持 CSV/JSON 导出，FINANCE_LOG.md 人类可读日志，符合 GDPR 数据可携带原则。

潜在局限

• 无可视化界面：纯 CLI 工具，依赖终端操作，对非技术用户存在学习成本。
• 无跨设备同步：本地存储虽保障隐私，但多设备用户需自行解决数据同步（如 Git 私有仓库、Syncthing）。
• 汇率 API 依赖：离线场景下汇率功能受限，虽可手动设置汇率，但体验下降。
• 功能深度有限：无发票 OCR、无银行自动对账、无投资收益率计算，适合轻中度财务管理需求。

适合人群

• 隐私敏感型用户：拒绝云端财务 App，要求数据完全自主可控。
• 开发者/技术用户：熟悉命令行，追求高效键盘驱动的工作流。
• 多币种收支者：跨境工作、留学、海淘用户，需实时汇率转换。
• 极简主义者：不需要复杂功能，追求快速记账与清晰洞察。

常规风险提醒

1. 本地备份责任：数据仅本地存储，设备损坏或误删 ~/.finance-tracker/ 将导致不可恢复丢失，建议配合备份策略。
2. 汇率 API 可用性：公开 API 存在服务中断或限流可能，虽已实现双 API 冗余，极端情况下可能需手动更新汇率。
3. 多用户系统权限：建议按安全报告建议设置数据目录权限为 0600，防止共享设备上的数据泄露。
4. 金融数据非投资建议：资产追踪功能仅做记录，无实时市值更新（股票/加密货币需手动更新净值）。