Finance Skill

核心用法

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 脚本执行需确保文件权限正确，防止恶意篡改交易记录

核心用法

Finance Skill 是一款面向个人用户的本地财务管理工具，核心功能围绕交易数据的捕获、存储与分析展开：

数据输入：支持两种主要方式——(1) 上传银行对账单（PDF或图片），通过 pypdf 提取完整文本并解析为结构化交易数据；(2) 手动录入单笔交易。解析时会自动识别日期、商户、金额，并按预设9大类别（餐饮、交通、购物、账单、娱乐、健康、旅行等）分类，同时验证交易总额与对账单总计是否匹配，确保数据完整性。

数据存储：所有交易记录以 JSON 格式存储于 ~/.openclaw/workspace/finance/transactions.json，遵循 OpenClaw 标准数据目录规范。每条记录包含唯一ID、时间戳、数据来源追踪，便于审计与回溯。

数据查询：支持自然语言风格的财务询问，如"上月花了多少""餐饮开销多少""最大支出是什么"等。底层通过 jq 工具对本地 JSON 进行过滤、聚合与排序，响应迅速且无需联网。

账户管理：内置简单的账户元数据管理（如 Coinbase Card），支持追踪各账户最后更新时间。

显著优点

1. 完全离线，隐私零泄露：无任何网络请求，财务数据不上云，从根本上杜绝第三方数据滥用风险。
2. 轻量依赖，易于部署：仅需系统工具 jq 和 Python 库 pypdf，无复杂第三方服务集成。
3. 对账单智能解析：特别针对 Telegram 等平台 PDF 预览截断问题，强制使用 pypdf 全页提取，确保数据完整。
4. 可审计的数据追踪：每笔交易记录来源文件（如 statement-2026-01.pdf）和录入时间，便于核对。
5. 可扩展架构：预留 Plaid API 集成接口，未来可平滑升级为自动银行同步，而不改变查询交互层。

潜在缺点与局限性

1. 无自动同步：目前依赖手动上传对账单或手动录入，无法实时追踪账户变动（Coinbase Card 等无 Plaid 支持的卡片尤其不便）。
2. 解析准确度依赖 PDF 质量：扫描版 PDF 或格式复杂的对账单可能提取失败，需人工校验。
3. 无数据可视化：仅有 JSON 查询，缺乏图表、趋势分析等高级功能。
4. 单设备局限：数据本地存储，跨设备同步需手动处理。
5. 来源可信度 T3：由个人开发者维护，无组织级代码审查保障。

适合人群

• 注重隐私、不愿将财务数据托管至云端服务的用户
• 愿意投入时间手动整理对账单的轻度财务追踪需求者
• 技术背景用户，可自主审查和扩展代码
• 目前使用 Coinbase Card 等无 Plaid 支持银行卡的用户

常规风险

• 本地数据丢失风险：无云端备份，设备故障可能导致数据永久丢失，需定期手动备份。
• PDF 解析依赖风险：pypdf 版本更新或特定格式兼容性问题可能影响解析稳定性。
• 本地文件权限风险：财务数据文件存储于用户目录，共享设备时需注意访问权限设置。
• 开发者维护风险：个人项目长期维护不确定性较高，需关注仓库更新动态。