综合评价
Simple Ledger 是一款面向个人用户的本地化财务记账工具，采用纯CSV文件存储方案，无需安装数据库即可完成完整的财务记录与分析。核心理念是"极简操作、数据自主、隐私优先"。
核心用法
用户通过自然语言指令完成记账，如"今天吃饭花了50块"，系统自动解析日期、金额、分类、账户等字段，生成标准CSV记录。支持六大功能模块：
1. 自然语言记账 — 智能解析口语化消费描述，自动映射消费分类（餐饮/交通/购物等14大类）和支付账户
2. 消费查询 — 按时间、分类、账户多维度筛选，实时计算余额与汇总
3. 预算管理 — 支持50/30/20法则模板生成、超支预警、执行进度追踪
4. 月度报告 — 自动生成收支概览、分类排行、环比对比与消费建议
5. 财务目标 — 攒钱目标创建、进度追踪、存入记录
6. 投资跟踪 — 股票/基金/ETF持仓记录、成本计算、收益分析，可选联网获取实时行情
显著优点
- 零门槛部署：单CSV文件即数据库，无需配置MySQL/PostgreSQL等外部服务
- 隐私优先：日常功能完全离线，财务数据永不外泄；投资行情查询仅发送证券代码，不传输个人资产数据
- 自然语言交互：告别复杂表单，口语化指令即可完成记账
- 扩展性强：开放CSV格式规范，用户可随时用Excel/Numbers直接编辑
- 开源透明：Python脚本化架构，数据处理逻辑完全可见
潜在局限
- 非高并发设计：CSV文件读写适合个人使用，不适合多人协作场景
- 无移动端原生支持：依赖OpenClaw/终端环境，手机端需通过聊天界面间接使用
- 投资行情依赖第三方：akshare库调用新浪/东方财富接口，存在服务稳定性风险
- 无自动银行同步：不支持直连银行卡/支付宝自动导入，需手动记录或定期导入
- 数据备份责任在用户：本地存储意味着用户需自行负责备份策略
适合人群
| 推荐场景 | 不推荐场景 |
|---------|-----------|
| 追求数据隐私的保守型用户 | 需要多人共享账本的家庭/团队 |
| 厌恶复杂财务App的极简主义者 | 希望自动同步银行流水的自动化用户 |
| 技术背景用户（偏好CSV可编辑性） | 需要复杂投资分析工具的专业投资者 |
| 基础投资跟踪需求的散户投资者 | 高频交易者或需实时Level2行情的用户 |
常规风险提示
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 本地CSV文件损坏或误删 | 定期备份`data/ledger/`目录 |
| 权限误用 | 脚本拥有文件读写权限 | 确认权限范围仅限于财务数据目录 |
| 投资决策 | 工具仅记录数据，不做任何投资建议 | 明确区分"记录工具"与"投资建议" |
| 第三方行情 | 投资功能依赖外部API | 理解行情延迟，重大决策需交叉验证 |
安全设计亮点
- 数据隔离：日常账本(
default.csv)与投资持仓(investments.csv)物理分离 - 显式确认机制：删除操作、投资写入均需终端Y/N二次确认
- 网络最小化：投资查询可选
--allow-network参数，默认离线运行 - 路径白名单：严格限制文件操作于
~/.openclaw/workspace/data/ledger/目录