核心用法
Treeline 是一款本地优先的个人财务管理 CLI 工具，通过 DuckDB 数据库存储所有财务数据。用户可通过自然语言风格查询（如 "我的净资产是多少？""本月 groceries 花了多少？"）获取即时财务洞察。核心工作流包括：
1. 快速开始：启用 tl demo on 加载示例数据体验功能，或连接真实数据源（SimpleFIN、Lunch Flow、CSV 导入）
2. 日常查询：使用 tl status 快速查看账户余额，或用 tl query "SQL" 执行自定义 SQL 分析
3. 数据管理：tl sync 同步银行数据，tl import 导入 CSV 交易记录，tl backup 创建本地备份
4. 高级功能：支持加密数据库（OS keychain 存储密钥）、用户自定义 skills、插件扩展（预算、储蓄目标、现金流预测等）
显著优点
- 完全本地优先：所有数据存储于
~/.treeline/treeline.duckdb，无强制云端同步，无订阅费用（可选付费银行同步服务） - 强大的 SQL 访问：底层 DuckDB 支持复杂财务分析，提供完整的数据库 schema 文档和常用查询模板
- 灵活的 CSV 导入：智能列映射、多格式支持（US/EU 数字格式）、重复交易自动检测
- 可扩展架构：插件系统支持预算管理、储蓄目标、订阅追踪等扩展功能
- 隐私优先设计：加密数据库支持、明确的隐私声明禁止外泄交易细节
潜在缺点与局限性
- 仅限个人本地使用：无法多设备同步（除非自行管理数据库文件），团队协作场景不适用
- 银行同步需付费：美国/加拿大用户需 $1.50/月的 SimpleFIN，全球用户约 $3/月的 Lunch Flow
- 技术门槛：需要 CLI 操作基础，SQL 查询对非技术用户有学习曲线
- 平台限制：CLI 支持 macOS、Linux、Windows，但加密数据库解锁需桌面应用或手动 CLI 操作
- 依赖维护：作为独立开源项目，长期维护稳定性需观察 GitHub 社区活跃度
适合人群
- 注重隐私、不愿将财务数据托管云端的技术敏感型用户
- 习惯 CLI 工作流、希望用 SQL 灵活分析个人财务的开发者/分析师
- 需要离线财务追踪、对银行同步费用敏感的用户
- 追求数据所有权、希望完全控制财务数据的个人
常规风险
- 数据丢失风险：纯本地存储意味着用户需自行负责备份策略（
tl backup命令存在但未强制自动化） - 加密密钥管理：数据库加密依赖 OS keychain，密钥丢失将导致数据不可恢复
- CSV 导入误差：自动列映射可能失败，需
--dry-run验证，错误导入可能导致分析偏差 - SQL 查询风险：
--allow-writes参数可修改数据，误操作可能破坏财务记录 - 第三方同步服务风险：SimpleFIN/Lunch Flow 的 API 安全性和服务连续性由第三方保障
- 无审计日志：缺乏操作日志追踪，无法回溯谁执行了哪些数据修改