核心用法
simple-ledger 是一款面向普通人的自然语言记账工具，核心价值在于零学习成本 + 完全本地隐私。用户只需像聊天一样说"今天吃饭花了50块"，系统自动解析为结构化CSV记录，无需记忆复杂命令或分类体系。
显著优点
1. 自然语言交互极致简化
- 支持模糊表达："昨天打车23块5""工资到账8000""给小王转了200"
- AI自动提取日期、金额、分类、账户、描述5个字段，准确率依赖关键词映射表
- 分类覆盖12大生活场景（餐饮/交通/居住/娱乐/购物/通讯/医疗/教育/社交/工资/理财/其他），账户默认微信/支付宝/银行卡/现金四通道
2. 投资功能闭环设计
- 股票/基金/ETF全流程管理：买入记录（支持联网自动查代码）、持仓查询、成本价修正、收益汇总、实时行情刷新
- 关键安全机制：联网行为采用显式opt-in，需加
--allow-network或开启AUTO_REFRESH=1配置；查询时仅发送证券代码/名称，绝不传输个人持仓数据 - 投资记录（investments.csv）与日常账本物理隔离，互不影响
3. 预算与目标体系
- 50/30/20法则智能模板生成，支持自定义比例
- 攒钱目标独立追踪（旅行基金/应急金等），存入金额联动记账系统
- 月度报告含环比分析+消费建议，文本图表直观展示TOP5支出
4. 数据主权完全归属用户
- CSV/JSON本地文件即数据库，可用Excel直接打开编辑
- 零云端同步，无账号体系，物理隔离财务隐私
潜在缺点与局限性
1. 网络功能依赖第三方接口稳定性
- 行情数据来自新浪财经/东方财富公开API，存在延迟、限流或接口变更风险
- akshare库需pip单独安装，非Python环境用户存在部署门槛
2. 无多设备同步机制
- 纯本地化设计导致手机/电脑数据割裂，跨场景使用需手动迁移CSV文件
- 无移动端适配，对话式交互在触屏场景体验受限
3. 投资分析深度有限
- 仅支持基础持仓成本与浮动盈亏计算，无收益率曲线、最大回撤、夏普比率等专业指标
- 不支持多币种、期货期权、港股美股（依赖akshare覆盖范围）
4. 数据完整性风险
- CSV格式无事务保护，异常中断可能损坏文件
- 用户手动编辑CSV易破坏格式，导致解析失败
适合人群
- 隐私敏感型用户：拒绝云端财务APP的数据采集
- 轻度投资者：持仓10只以内，关注成本追踪而非复杂分析
- 记账习惯培养期：自然语言降低启动门槛，后续可迁移专业工具
- 技术爱好者：CSV开放格式便于二次开发或数据可视化
常规风险
- 行情延迟风险：实时刷新非交易所直连，价格可能存在分钟级延迟，不宜用于交易决策
- 误操作风险：删除交易/目标需二次确认，但CSV直接编辑无保护机制
- 依赖衰减风险：akshare维护状态不确定，极端情况下可能丧失自动代码查询能力
- 备份责任：所有数据本地存储，设备损坏即丢失，需用户自主备份
data/目录