本地记账·账单解析·支出洞察

个人财务记忆层，支持解析银行账单、存储交易记录、分类查询支出，帮助用户追踪消费与理财规划。

基本信息

• 技能名称?Finance Skill
• 中文名称?本地记账·账单解析·支出洞察
• 作者?safaiyeh
• 分类?其他
• 版本?0.1.2
• 标签?finance, budgeting, expense-tracking, privacy-first, local-storage, data-analysis, banking

使用方法

使用说明
核心用法
Finance Skill 是一个本地优先的个人财务管理工具，专注于交易数据的提取、存储与查询。主要流程包括：

1. 账单解析 ：用户上传 PDF 或图片格式的银行对账单，使用 pypdf 提取完整文本（解决 Telegram 预览截断问题），再通过视觉模型解析交易明细，输出标准 JSON 格式
2. 数据存储 ：交易记录持久化存储于 ~/.openclaw/workspace/finance/transactions.json ，支持手动添加单笔交易
3. 智能查询 ：基于 jq 实现按时间范围、消费类别、金额等多维度筛选与聚合，回答"上月花了多少""餐饮支出占比"等问题
   显著优点
   本地隐私优先 ：所有财务数据仅存储于用户本地，不上传云端，降低数据泄露风险
   多源兼容 ：支持主流信用卡账单（含 Coinbase Card 等无 Plaid 支持的卡片），手动上传弥补自动同步盲区
   验证机制 ：强制校验提取金额与账单总计是否匹配，减少漏扫、错扫
   轻量依赖 ：仅需 jq 和 pypdf ，无重型数据库或云服务依赖
   潜在缺点与局限性
   无自动同步 ：当前版本依赖用户手动上传账单，Plaid 集成尚处未来规划阶段
   解析可靠性 ：PDF 排版差异可能导致提取失败，复杂表格或非标准格式需人工复核
   单用户设计 ：无多账户隔离或家庭共享机制
   无预算/分析功能 ：仅提供原始数据查询，缺乏趋势预测、预算超支预警等高级功能
   适合人群
   注重隐私、不愿将银行数据授权给第三方聚合平台的用户
   使用非主流银行卡（如加密信用卡）需手动记账的人群
   希望快速追溯特定时段消费明细的轻度理财用户
   常规风险
   数据丢失 ：本地 JSON 文件损坏或误删将导致历史记录不可恢复，建议定期备份
   凭证安全 ：若未来扩展 Plaid 集成，OAuth 令牌需妥善保管于 ~/.config/finance/
   解析错误 ：视觉模型可能对模糊账单、手写备注识别偏差，建议关键交易人工核对
   权限风险 ： add-transactions.sh 脚本执行需确保文件权限正确，防止恶意篡改交易记录