refund-radar

🔍 本地隐私优先的账单审计助手

基于纯本地 Python 的银行账单智能审计工具,无需联网即可识别重复扣费、异常交易并生成退款模板,保障财务隐私安全。

收藏
14.4k
安装
3.1k
版本
v1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

refund-radar 是一款专注于个人银行账单分析的本地工具,用户通过导入银行或信用卡的 CSV 交易记录,即可启动自动化审计流程。工具支持多种数据源格式(Apple Card、Chase、Mint 等主流银行导出格式),并能智能解析日期、金额、货币等字段。核心功能包括:识别周期性订阅扣费(基于商户名称、金额波动范围和扣费规律)、标记可疑交易(重复扣费、金额异常飙升、新商户大额消费等)、生成交互式 HTML 审计报告,以及提供三种语气风格的退款申请邮件/聊天/申诉模板。

显著优点

隐私优先设计是该工具最突出的特性——完全离线运行,零网络调用,不依赖 Plaid 等第三方金融服务 API,用户敏感财务数据始终保留在本地机器。其次,零依赖部署极大降低了使用门槛,仅需 Python 3.9+ 环境即可运行,无需安装额外包。工具的智能识别能力也值得称道,能够自动检测 90 天内的周期性扣费模式,支持多种日期和货币格式,并针对不同类型的可疑交易设置分级预警(高/中/低)。生成的 HTML 报告具备完善的交互功能,包括隐私模糊模式(一键隐藏商户名称)、深色/浅色主题切换、可折叠章节和一键复制模板等贴心设计。

潜在缺点与局限性

作为个人开发者项目,来源可信度受限(T3 等级),缺乏企业级背书和长期维护保障。当前 Skill 文档未包含实际可执行代码,用户需自行从 GitHub 安装 Python 包,存在供应链验证风险。功能层面,工具不支持实时银行同步,必须依赖用户手动导出 CSV,对于追求自动化的用户不够便捷。此外,退款模板生成存在明显瑕疵——文档明确要求"生成的文本中不得包含任何撇号(apostrophes)",这一限制可能导致英文退款信语法不自然,影响专业性。对于非技术用户,命令行操作界面存在一定学习成本。

适合的目标群体

该工具最适合注重隐私的个人财务管理者,尤其是对将银行数据上传云端持谨慎态度的用户。订阅服务繁多的消费者能从中显著受益,可清晰掌握 Netflix、Spotify 等周期性扣费的时间节点和金额变化。需要 dispute 银行交易的用户也能获得结构化支持,工具提供的分级预警和现成模板可降低与银行或商户沟通的门槛。此外,具备基础 Python 环境配置能力的技术用户会更易上手,而完全的非技术用户可能需要额外指导。

使用风险

供应链风险:实际执行的 Python 代码未包含在 Skill 中,用户需自行从 GitHub 安装,建议验证仓库完整性和发布签名。数据残留风险:分析历史和报告默认存储于 ~/.refund_radar// 目录,包含原始交易数据,建议定期清理或启用隐私模糊功能。模板可用性风险:撇号限制可能导致英文退款信语法异常,重要申诉场景建议人工复核。功能边界风险:工具仅作分析辅助,不保证退款成功率,银行 dispute 最终结果仍取决于发卡行政策。

安全解读

核心用法

refund-radar 是一款专注于个人财务审计的本地分析工具,通过解析银行或信用卡账单的 CSV 文件,帮助用户发现隐藏的财务问题。用户可通过命令行将账单数据导入,工具自动完成日期格式识别、金额归一化、货币检测等预处理,无需手动调整格式。

核心功能模块包括:

1. 订阅识别引擎:基于 90 天滑动窗口,检测同一商户的重复交易模式,识别周/月/年订阅周期,标注下次扣款预测时间
2. 可疑交易标记:五层风控规则覆盖重复扣款(2 天内同金额)、金额异常波动(>1.8 倍基准且差额>$25)、陌生商户大额首刷、费用类关键词(ATM/透支费)、货币异常

3. 交互式审计报告:生成本地化 HTML 文件,支持明暗主题切换、商户名称隐私模糊、可折叠区块设计,报告完全离线可用

4. 退款模板工厂:为每笔标记交易生成三场景(邮件/在线客服/银行申诉)× 三语气(简洁/强硬/友好)的共 9 套话术模板,包含交易详情与占位符

显著优点

  • 绝对隐私优先:零网络调用、零外部 API、零云服务依赖,所有数据处理与存储完全本地,敏感财务信息不出设备
  • 零依赖轻量架构:仅需 Python 3.9+,无 pip 安装负担,适合快速部署与离线环境
  • 智能格式自适应:自动识别全球主流银行的 CSV 格式变体,支持 6+ 日期格式与多种金额列布局
  • 渐进式学习系统:通过 mark-expectedmark-recurring 命令训练用户偏好,减少误报
  • 开源可审计:MIT 协议,代码完全透明,无黑箱算法

潜在局限

  • T3 来源可信度:作者为个人开发者(andreolf),无企业或开源基金会背书,生产环境建议二次代码审查
  • 无实时同步能力:依赖手动导出 CSV,无法对接 Plaid 等开放银行 API 实现自动监控
  • 模板需人工介入:退款话术为半自动草稿,最终发送需用户手动复制至邮件/聊天窗口
  • 英文界面局限:当前版本输出为英文,中文用户需额外适配
  • 无多用户隔离:状态文件存储于单用户目录,家庭共享设备存在数据混淆风险

适合人群

  • 注重隐私、拒绝 SaaS 财务工具的敏感用户
  • 需定期审计订阅、发现僵尸会员的技术型个人用户
  • 信用卡盗刷受害者的事后取证与申诉准备
  • 小微企业主的简单费用对账需求

常规风险

  • CSV 来源可信度:工具本身安全,但输入的银行 CSV 若被中间人篡改,将导致错误分析结论
  • 本地数据泄露~/.refund_radar/ 目录权限配置不当可能导致其他用户读取财务数据
  • 模板误用风险:自动生成的强硬语气模板若用于非欺诈性争议,可能损害商户关系
  • 状态文件损坏state.json 损坏将导致学习偏好丢失,需定期备份

refund-radar 内容

assets文件夹
references文件夹
手动下载zip · 11.4 kB
template.htmltext/plain
请选择文件