finance-skill

💰 隐私优先的本地智能记账助手

纯本地运行的个人财务管理工具,安全解析银行对账单并存储交易记录,确保财务数据隐私零泄露。

收藏
3.4k
安装
1.6k
版本
v0.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Finance Skill 是一款专注于隐私保护的个人财务管理技能,通过本地化的数据存储和解析能力,帮助用户建立完全私有的财务记忆层。

核心用法:该技能主要提供三大功能模块。首先是智能解析,支持用户上传银行对账单(PDF 或图片格式),利用 pypdf 提取全部页面文本(特别注意解决 Telegram 等平台的 PDF 预览截断问题),自动识别交易日期、商户名称、金额和类别,生成结构化 JSON 数据。其次是手动记账,允许用户通过自然语言快速添加单笔交易(如"我在超市花了50美元"),自动补全元数据并持久化存储。最后是智能查询,支持按时间范围、消费类别、金额大小等多维度筛选和聚合数据,回答诸如"上月餐饮支出多少"或"最大单笔消费是什么"等问题。

显著优点:最突出的优势是极致的隐私保护,所有数据严格存储于用户本地的 ~/.openclaw/workspace/finance/ 目录,明确宣称"No cloud. No sync",彻底杜绝数据上传和第三方泄露风险。功能设计务实高效,内置9大消费类别(餐饮、交通、购物等)自动分类,并具备总额校验机制,确保提取的交易金额与对账单总计匹配,防止漏页或识别错误。技术实现简洁透明,依赖 jq 和 pypdf 等成熟开源工具,脚本逻辑清晰,便于技术用户审计和理解。

潜在缺点与局限性:自动化程度有限,目前不支持 Plaid 等银行 API 自动同步(虽然路线图中有规划),每次都需要手动上传对账单。多设备体验受限,由于数据 purely local,用户在多台设备间无法自动同步财务数据,且不适合多用户共享环境。对非技术用户有一定门槛,需要自行安装 jq 和 pypdf 依赖,且 JSON 格式的数据存储不如专业财务软件直观。此外,作为个人开发者(T3)维护的项目,长期更新和支持的持续性需要观察。

适合的目标群体:特别适合对财务隐私极度敏感、不愿意将银行数据上传至云端服务的用户;适合希望轻量级管理个人账目、不需要复杂投资分析功能的技术从业者;也适合作为临时性的支出追踪工具,帮助用户在换用正式财务管理软件前快速整理历史账单。

使用风险:主要风险集中在数据管理责任完全由用户承担,需要定期手动备份 transactions.json 文件以防本地磁盘损坏;依赖项版本兼容性可能带来维护成本;PDF 解析准确率虽经校验,但仍需人工确认关键交易;无加密机制,物理设备被入侵时数据以明文存储。

安全解读

核心用法

Finance Skill 是一款基于本地文件系统的个人财务记忆层工具,专为注重隐私的用户设计。其核心功能围绕三大模块展开:

1. 智能账单解析

  • 支持图像/PDF 格式银行对账单导入
  • 使用 pypdf 提取完整文本(规避 Telegram 预览截断问题)
  • 自动识别日期、商户、金额、分类,输出标准 JSON
  • 内置总额校验机制,确保提取完整性

2. 交易数据管理

  • 数据持久化存储于 ~/.openclaw/workspace/finance/transactions.json
  • 支持手动录入单笔交易
  • 分类体系覆盖:food/transport/shopping/bills/entertainment/health/travel/other
  • 金额符号约定:负数为支出,正数为收入/退款

3. 自然语言查询

  • 支持时间范围筛选("last month")
  • 支持分类聚合("spend on food")
  • 支持排序分析("biggest expenses")

显著优点

  • 隐私优先架构:100% 本地存储,无网络外发,符合 GDPR/CCPA 数据最小化原则
  • 零订阅成本:开源 MIT 协议,无第三方服务依赖
  • 轻量依赖:仅需 jqpypdf 两个常见工具
  • 扩展友好:预留 Plaid 集成接口,未来可升级银行自动同步

潜在局限

  • 纯手动导入:当前无自动同步,需用户主动上传账单或录入
  • T3 来源可信度:作者为个人开发者,代码虽开源但社区验证度有限
  • 无数据加密:本地 JSON 明文存储,依赖系统文件权限保护
  • 缺乏可视化:仅支持文本查询,无图表报表功能

适合人群

  • 对财务隐私极度敏感、拒绝云同步的用户
  • 愿意投入时间手动维护账本的技术用户
  • 需要基础支出分析但不需要复杂功能的轻量需求者

常规风险

1. 数据丢失风险:本地文件无自动备份,需用户自行定期备份 transactions.json
2. PDF 提取准确性:依赖 pypdf 的文本提取质量,复杂格式账单可能解析失败

3. 未来 Plaid 升级风险:若启用银行自动同步,将引入 OAuth 授权和第三方 API 依赖,安全模型将发生本质变化

finance-skill 内容

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