核心功能与用法
Expense Tracker 是一款完全本地运行的个人财务管理技能，用户无需打开任何应用或填写表单，只需像聊天一样说出消费记录，AI 即可完成自动解析、分类、记账和预算追踪。
核心交互方式
自然语言录入：支持多种口语化表达，如「spent $45 at Costco」「grabbed lunch for $18 at Chipotle yesterday」「split a $90 dinner with Jake」。系统会自动提取金额、商家、日期，并匹配16个预设消费类别（Groceries、Dining、Gas/Transport、Subscriptions、Health/Fitness、Entertainment、Shopping、Utilities、Housing、Personal Care、Education、Gifts、Travel、Insurance、Pets、Miscellaneous）。
智能分类机制：基于关键词匹配（精确匹配→模糊匹配→上下文线索），遇到多义商家（如 Walmart 可能是 Groceries 或 Shopping）时优先猜测并主动确认，学习用户偏好优化后续匹配。
预算管理
用户可自定义月度预算限额，系统实时监控支出进度：
- < 50%：静默跟踪
- 50-79%：信息展示
- 80-99%：主动预警（🟡）
- ≥ 100%：超支告警（🔴）
每次记账后自动检查预算状态，超阈值时即时提醒。
报表生成
- 周报表：类别 breakdown、TOP 支出、预算状态、周环比趋势
- 月报表：完整类别分析、周度拆分、月度对比、储蓄率计算（需配置收入）
进阶功能
| 功能 | 说明 |
|------|------|
| 退款/报销 | 识别 "refund""reimbursed" 等关键词，记为负金额冲减类别支出 |
| 分账处理 | "split $80 dinner with Sarah" → 自动计算并记录用户应付部分 |
| 多币种（可选） | 记录原币种金额，换算为 USD 计入预算 |
| 数据修正 | 支持修改金额、删除条目、更换类别 |
| 预算调整 | 对话中直接调整当月预算限额 |
显著优点
1. 零摩擦体验：无需打开 App、无需手动选择分类、无需填写表单，对话即记账，大幅降低记账行为成本
2. 隐私优先：完全本地运行（Runs entirely local），消费数据仅存储在用户设备，不上传任何云服务
3. 智能自动化：自然语言解析 + 自动分类 + 实时预算预警，减少人工决策负担
4. 灵活分账与退款：原生支持 AA 制分账和退款冲减，贴合真实消费场景
5. 渐进式学习：通过用户确认修正，持续优化分类准确性
潜在局限与风险
| 局限 | 说明 |
|------|------|
| 手动录入依赖 | 仍需用户主动发起对话记录，无自动同步银行/信用卡交易功能 |
| 单设备局限 | 纯本地存储意味着跨设备数据不互通，换设备需手动迁移 `expenses/ledger.json` |
| 无云备份 | 数据安全性依赖用户本地备份策略，设备损坏/丢失可能导致数据丢失 |
| 脚本依赖 | 依赖 `jq` 和 bash 脚本执行，Windows 用户需额外配置环境 |
| 货币转换 | 多币种支持为「可选」且需手动输入汇率，无实时汇率 API |
| 无 recurring 自动记账 | 月度固定支出需每次手动记录，不支持自动创建 |
适合人群
- 隐私敏感型用户：拒绝将财务数据上传云端
- 极简主义者：追求「说完即走」的轻量记账体验
- 预算控制者：需要实时预算预警和周期性财务复盘
- 技术用户：能接受本地脚本依赖，有能力处理数据备份/迁移
常规风险提示
- 数据持久化：建议定期备份
expenses/ledger.json和references/budgets.json - 脚本安全：
add-expense.sh等脚本涉及文件写入操作，确保目录权限正确，避免误删或覆盖 - 金额确认：自然语言解析可能存在歧义（如 "like 50 bucks"），系统会按精确值记录并建议用户确认
- 预算基准：月度预算需用户主动配置，未配置类别的支出将仅记录而无预警