核心用法
simple-ledger 是一款以自然语言为核心的个人记账与投资管理工具。用户只需用日常口语描述收支（如"今天中午吃面花了25"），系统自动解析日期、金额、分类、账户等字段并写入本地 CSV 账本。支持多账户余额管理（微信、支付宝、银行卡、现金）、月度预算设定、攒钱目标追踪，以及股票/基金/ETF 的买入卖出记录与持仓收益分析。
关键操作路径：
- 记账：自然语言输入 → 确认解析 → 写入 CSV → 返回余额
- 查询：时间/分类/账户维度筛选，支持"这个月花了多少""餐饮多少钱"等口语化问法
- 投资：离线记录交易，可选联网获取实时行情（需显式授权）
显著优点
1. 零门槛交互：无需记忆固定指令格式，中文自然语言直接录入，降低记账摩擦
2. 数据主权：纯 CSV/JSON 本地存储，无云端同步，用户完全掌控原始文件
3. 离线优先：核心功能（记账、查询、预算、报告）不依赖网络，投资模块的联网功能为显式 opt-in
4. 多场景覆盖：从日常消费到证券投资组合，统一账本管理
5. 可审计性：文件格式公开透明，可用 Excel 直接打开编辑
潜在缺点与局限性
1. 无自动导入：不支持银行/支付宝/微信自动同步，需手动录入
2. 无多端协作：CSV 文件本地化，跨设备需手动迁移
3. 投资功能依赖第三方：实时行情通过 akshare 调用新浪财经/东方财富接口，存在 API 稳定性风险
4. 无税务规划：不涉及个税、资本利得税计算
5. 非投资顾问：不提供买卖建议、市场预测或资产配置方案
适合人群
- 追求隐私、不愿将财务数据上传云端的用户
- 希望用中文自然语言快速记账、反感复杂 App 操作的人群
- 需要同时管理日常开支与证券投资的个人投资者
- 愿意接受手动录入、换取数据完全可控的技术倾向用户
常规风险
1. 数据丢失：本地 CSV 文件需用户自行备份，无自动云端冗余
2. 联网泄露：投资行情查询会暴露关注的证券代码至公共 API，虽不含个人持仓数量，但存在查询行为画像风险
3. 误操作覆盖：直接文件编辑可能导致格式损坏，建议通过工具命令修改
4. 依赖特定目录：数据固定在 ~/.openclaw/workspace/data/ledger/，迁移或重装系统需手动备份