Finance Skill

💰 你的私人离线财务管家

本地个人财务管理工具,支持账单解析、交易存储与智能查询,数据完全离线存储,适合注重隐私的用户

收藏
11.6k
安装
2.3k
版本
0.1.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

Finance Skill 是一个本地优先的个人财务管理层,通过解析银行账单(PDF/图片)自动提取交易记录,存储于 ~/.openclaw/workspace/finance/transactions.json,并提供自然语言查询能力。

主要流程:
1. 账单解析:使用 pypdf 提取完整 PDF 文本(关键:Telegram 预览会截断,必须全页提取),通过视觉模型解析交易明细

2. 数据存储:交易以 JSON 格式持久化,包含 UUID、日期、商户、金额(负数为支出)、分类、来源文件等元数据

3. 智能查询:支持按时间范围、消费类别(food/transport/shopping/bills/entertainment/health/travel/other)、金额排序等多维度聚合分析

4. 手动录入:口语化输入即可快速补录现金交易

显著优点

  • 完全离线:所有数据本地存储,无云端传输,隐私风险极低
  • 多源兼容:支持信用卡账单截图、PDF 对账单,特别标注 Coinbase Card 等无 Plaid 支持的卡种
  • 验证机制:强制校验提取金额与账单总计是否匹配,防止遗漏
  • OpenClaw 原生集成:遵循统一工作区规范,与会话记忆系统协同

潜在缺点与局限

  • 无自动同步:当前版本依赖手动上传账单,Plaid 银行直连列为未来功能
  • 解析依赖视觉模型:复杂排版账单可能存在提取错误,需人工复核
  • 单用户设计:无多账户/多币种管理,家庭共享场景不适用
  • 无预算/报表功能:仅提供原始查询,缺乏可视化图表或预警系统

适合人群

  • 隐私敏感型用户(拒绝 Mint/YNAB 等云服务)
  • 加密货币持卡人(Coinbase Card 等无 Plaid 支持的卡种)
  • 轻量级记账需求者,愿接受手动账单上传换取数据主权
  • 开发者/技术用户,可扩展 Plaid 集成或自定义分析脚本

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据安全 | 低 | 本地 JSON 存储,无网络传输;建议配合磁盘加密 |
| 解析准确性 | 中 | 依赖模型 OCR,关键交易建议人工抽查验证 |
| 数据丢失 | 中 | 无自动备份机制,需用户自行管理 `transactions.json` 副本 |
| 功能依赖 | 低 | 单一依赖 `pypdf`,社区成熟维护中 |

安全解读

核心功能

Finance Skill 是一款极简设计的本地个人财务管理工具,专注于三大核心能力:

1. 智能对账单解析:支持通过 Vision 模型从图片/PDF 提取交易信息,使用 pypdf 处理多页 PDF(解决 Telegram 预览截断问题),自动识别日期、商户、金额和分类
2. 结构化数据存储:交易数据以 JSON 格式持久化存储于 ~/.openclaw/workspace/finance/transactions.json,支持手动添加单笔交易

3. 自然语言查询:支持按时间范围、分类、金额等多维度筛选聚合,如"上月 food 支出多少""最大单笔消费"

显著优点

  • 零网络传输隐私保护:所有数据完全本地处理,无云端同步、无外发 API,符合 GDPR 数据最小化原则
  • 代码极简透明:仅 67 行可执行 Shell 代码,无第三方依赖,仅用 bash + jq,易于审计
  • 实用细节设计:内置分类体系(food/transport/shopping/bills/entertainment/health/travel/other)、交易溯源(source 字段记录原始对账单)、总额校验机制
  • 扩展性规划:预留 Plaid 集成接口,未来可支持银行自动同步

潜在局限

  • T3 来源风险:作者为个人开发者 Jason Safaiyeh,虽账号历史 12 年(2014 年至今),但项目本身较新(2026-02 创建),需用户自行代码审查
  • 功能边界明确:无预算管理、投资分析、多币种支持、数据可视化等进阶功能
  • 单点数据风险:无自动备份机制,依赖用户手动管理 ~/.openclaw/workspace/finance/ 目录
  • Coinbase Card 限制:明确不支持 Plaid,仅能通过手动上传对账单导入

适合人群

  • 重视隐私、不愿将财务数据上传云端的用户
  • 需要轻量级支出追踪、快速对账单解析的极简主义者
  • 具备基础技术能力、能自行审查 Shell 脚本的安全敏感用户
  • 主要使用 Coinbase Card 等无 Plaid 支持卡片的用户

常规风险

  • 文件权限风险:默认未设置 600 权限,多用户系统可能存在数据泄露
  • 输入验证依赖:JSON 结构验证较宽松,恶意构造输入可能导致数据污染
  • 手动操作依赖:解析结果需人工确认交易数量和总额匹配,自动化程度有限

Finance Skill 内容

scripts文件夹
手动下载zip · 4.4 kB
add-transactions.shtext/x-shellscript
请选择文件