核心用法
simple-ledger 是一款专为个人财务管理设计的本地化工具，采用完全原创的 CSV 格式存储数据，无需数据库即可运行。核心功能包括：
自然语言记账：用户用日常口语即可记账，如"今天吃饭花了50块"，系统自动解析日期、金额、分类、描述和账户，生成标准 CSV 条目。
多维度查询：支持按时间（本月、上周、2025年3月）、按分类（餐饮、交通等）或组合条件查询消费记录，自动计算汇总并格式化输出。
预算与目标管理：可设定分类预算并跟踪执行进度，支持创建攒钱目标（如旅行基金、应急金），实时查看完成度。
投资跟踪：记录股票、基金、ETF 等持仓，支持买入/卖出登记、成本价修改、收益计算。持仓数据与日常账本完全隔离，互不影响。
月度报告生成：自动统计收支概况、分类排行、日均消费、环比对比，并给出简短消费建议。
显著优点
- 隐私优先：日常记账、预算、目标功能完全离线，数据仅存本地 CSV/JSON 文件，不上传任何服务器
- 显式联网控制：投资行情查询采用 opt-in 机制，默认禁止联网，需用户主动允许（--allow-network）或开启自动刷新（AUTO_REFRESH=1）
- 格式透明开放：CSV 文件可直接用 Excel、记事本打开编辑，用户完全掌控数据
- 自然语言交互：无需记忆命令语法，口语化输入即可完成功能
- 数据隔离设计：投资记录（investments.csv）与日常账本（default.csv）独立存储，避免误操作
潜在缺点与局限性
- 手动备份依赖：虽建议定期备份 data/ 目录，但无自动云同步机制，设备损坏可能导致数据丢失
- 投资功能联网风险：查询证券代码和实时行情需连接新浪/东方财富等接口，虽仅发送代码/名称，但仍会暴露用户关注的证券品种
- CSV 并发限制：多进程同时写入同一 CSV 文件可能产生数据竞争，适合单用户本地使用
- 无多币种支持：当前版本未提及外汇或加密货币支持
- 分类依赖关键词匹配：自动分类基于预设关键词列表，冷门消费描述可能误分类
适合人群
- 重视财务隐私、不愿将数据上传云端的用户
- 希望用自然语言快速记账，无需学习复杂财务软件的个人
- 需要简单投资持仓记录，但不需要专业级投资组合分析的用户
- 偏好数据完全本地化、可手动编辑备份的技术偏好者
常规风险
- 数据安全风险：本地文件若未加密，设备被他人访问可能导致财务信息泄露
- 误操作风险：删除交易记录、预算条目、财务目标等操作需二次确认，但确认后不可恢复
- 第三方接口风险：投资行情依赖 akshare 库调用新浪财经等公开 API，接口变更或限流可能影响功能
- 无投资顾问资质：工具仅做记录和计算，不提供任何投资建议或收益保证