Finance Tracker

核心用法

Finance Tracker 是一款轻量级 CLI 记账工具，主打自然语言交互。用户通过简单命令即可记录支出、查看报表、搜索历史。核心命令包括：

• finance add <amount> "<desc>" — 记录单笔支出，支持 50k 简写和空格分隔数字
• finance report [period] — 按 today/week/month/year/all 查看消费汇总
• finance search "<query>" — 关键词检索历史记录
• finance export [csv|json] — 数据导出

显著优点

1. 零配置上手：无需注册账户、无需联网，安装即用
2. 智能自动分类：内置 11 个常见消费类别，根据描述关键词自动归类（如 "lunch"→🍔 Food）
3. 双格式数据持久化：同时生成 transactions.json（机器可读）和 FINANCE_LOG.md（人类可读）
4. 模型无关：纯 CLI 工具，任何支持 bash 的 AI Agent 均可调用
5. 本地化优先：所有数据存储于 ~/.finance-tracker/，隐私可控

潜在局限

• 无预算功能：仅记录历史，不支持设定月度预算或超支提醒
• 单币种局限：虽支持货币代码设置，但无实时汇率转换
• 无云同步：设备间迁移需手动复制文件
• 分类规则固定：用户无法自定义关键词映射，需接受预设 11 类
• 无收入追踪：仅支持支出记录，无法构建完整资产负债表

适合人群

• 追求极简记账的个人用户
• 需要通过 AI Agent 自动化记账的开发者
• 对数据隐私敏感、拒绝云端服务的用户
• 仅需基础支出统计、无需复杂财务分析的场景

常规风险

• 数据丢失风险：本地存储无自动备份，设备故障可能导致历史记录丢失
• 输入验证依赖用户：金额格式错误需人工修正，Agent 误解析可能导致记录错误
• 无加密存储：transactions.json 和 FINANCE_LOG.md 均为明文，共享设备存在隐私泄露风险

核心用法

Finance Tracker 是一款轻量级命令行记账工具，主打自然语言交互与零依赖本地运行。用户通过简单的 shell 命令即可快速记录支出、生成报告、搜索历史交易，无需学习复杂语法。

典型工作流：

• finance add 50k "lunch at cafe" — 记录一笔 50,000 的餐饮支出
• finance report month — 查看本月消费统计与分类占比
• finance search "food" 或 finance export csv — 检索或导出数据

工具内置 11 类自动分类（餐饮、交通、购物、数码、娱乐等），基于关键词匹配自动归类，未命中则归入「其他」。金额支持 50k、50 000 等灵活格式，降低输入摩擦。

---

显著优点

1. 纯本地架构：数据仅存于 ~/.finance-tracker/，无云端同步、无账户体系，隐私风险极低
2. 零依赖部署：仅使用 Python 标准库（json、pathlib、re 等），无第三方包，杜绝供应链攻击
3. 双格式存储：同时生成 transactions.json（机器可读）与 FINANCE_LOG.md（人工审计），兼顾自动化与可读性
4. 模型无关：CLI 接口可被任何 AI Agent 调用，无需特定模型支持

---

潜在缺点与局限

• 无加密存储：财务数据以明文 JSON/Markdown 保存，设备丢失或共享时存在泄露风险
• 无备份机制：单一本地存储，误删或磁盘故障即永久丢失
• 分类不可定制：预设 11 类关键词匹配，无法添加自定义分类或调整权重
• 无多币种实时汇率：仅支持符号设置（如 USD），不涉及汇率转换
• 无预算/预警功能：仅记录与统计，无法设置月度限额或超支提醒

---

适合人群

• 追求极简、快速的命令行用户
• 对隐私敏感、拒绝云端记账的群体
• 开发者或 AI Agent 构建者，需结构化本地财务数据源
• 轻度记账需求者（无需投资、借贷、发票等复杂场景）

---

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据丢失 | 无自动备份 | 定期手动备份 `~/.finance-tracker/` 目录 |

| 隐私泄露 | 明文存储 | 对敏感设备启用全盘加密（如 FileVault、BitLocker） |

| 输入误操作 | 金额无上限校验 | 录入大额前用 `finance recent` 二次确认 |

| 分类误差 | 关键词匹配局限 | 定期用 `finance categories` 检查并手动修正（若支持） |