什么是Personal Finance
Personal Finance 是一个专注于个人财务数据处理的命令行工具，旨在帮助用户在本地安全地解析、验证和分类银行或信用卡导出的 CSV 交易记录。该工具默认以只读方式运行，不会自动上传数据、调用外部 API 或进行任何写入操作，从而确保用户隐私与数据安全。所有核心逻辑均封装在 `personal-finance.sh` 脚本中，并依赖本地的配置文件与样本数据运行，完全离线工作，适合对隐私敏感或网络环境受限的用户使用。 该工具支持多种基本操作，包括验证 CSV 文件结构是否完整、按时间段汇总收支总额、根据自定义规则对交易进行分类，以及生成包含消费商户、类别统计等洞察的报告。每个命令均可通过命令行参数灵活配置输入路径、输出路径和时间周期，例如按月、季度或年度聚合数据。特别的是，当未提供 `–output` 参数时，所有操作均保持只读模式，避免意外修改原始文件；若需保存处理结果，则可通过指定输出路径生成新的 CSV 文件。 为了适配不同用户的消费习惯，工具内置了可编辑的规则配置文件 `config/category-rules.json`，允许用户通过关键词匹配将交易描述映射到自定义类别（如餐饮、交通、娱乐等）。同时，项目还附带一个示例 CSV 文件，便于快速上手测试和熟悉数据结构。整体设计强调轻量化、可定制性和零外部依赖，是个人财务管理者、开发者或技术爱好者处理本地财务数据的实用选择。
核心功能特点
- 支持读取银行或信用卡导出的 CSV 文件，全程本地处理，无自动上传或网络请求
- 提供数据验证功能，检查 CSV 是否包含必需的字段（日期、描述、金额、账号）及数值格式正确性
- 可按月、季度或年周期汇总收入与支出，计算净现金流并提供清晰的总览
- 基于本地关键词规则自动为交易分配类别（如餐饮、购物），支持自定义分类逻辑
- 生成消费洞察报告，展示高消费商户、主要支出类别及交易频次统计
- 所有输出默认屏蔽账号信息（仅保留末四位），保护个人敏感数据
适用场景
Personal Finance 特别适合那些希望在不依赖第三方云服务的情况下掌控自己财务数据的用户。例如，经常使用网银导出交易记录的上班族可以通过该工具快速分析每月开销趋势，识别非必要支出，从而优化预算管理。对于自由职业者或个体经营者而言，定期整理收入与成本有助于更准确地核算经营状况，尤其在报税季前进行数据归类尤为实用。 此外，该工具也适用于技术爱好者或开发者进行自动化财务脚本开发。由于其完全基于命令行操作且代码开源，用户可以轻松集成到定时任务中，实现每周自动生成财务报告的功能。结合简单的配置调整，还能适应不同银行卡或支付平台的交易命名习惯，提升分类准确率。无论是用于家庭账本维护、学生生活费追踪，还是作为个人理财系统的基础模块，Personal Finance 都能提供高效、透明且可控的数据处理能力。