账单扫描退款助手

技能简介

refund-radar 是一款本地运行的银行账单分析工具，可自动识别重复扣款、标记可疑交易、检测周期性订阅费用，并生成交互式 HTML 审计报告与退款请求模板。

能做什么

• 解析 CSV 或文本格式的银行/信用卡账单数据
• 自动识别周期性订阅扣款（同一商户90天内出现≥2次）
• 标记可疑交易：重复扣款、金额突增、新商户大额消费、手续费等
• 生成三种语气的退款请求模板（邮件、在线客服、银行争议）
• 输出带隐私保护功能的交互式 HTML 报告

使用说明

安装要求：Python 3.9+，无外部依赖。

安装步骤：

1. 克隆仓库：git clone https://github.com/andreolf/refund-radar.git
2. 进入目录：cd refund-radar
3. 无需额外安装，直接使用 Python 模块运行

基础用法：

# 分析 CSV 账单
python -m refund_radar analyze --csv statement.csv --month 2026-01

# 分析粘贴的文本数据
python -m refund_radar analyze --stdin --month 2026-01 --default-currency USD

# 标记已知商户
python -m refund_radar mark-expected --merchant "Amazon"
python -m refund_radar mark-recurring --merchant "Netflix"

# 查看已学习的商户
python -m refund_radar expected

# 重置学习状态
python -m refund_radar reset-state

报告默认保存至 ~/.refund_radar/reports/YYYY-MM.html，支持一键模糊商户名称保护隐私。

输入与输出

见下方输入与输出表格。

风险提示

• 本工具仅作辅助分析，退款结果取决于银行或商户政策
• 生成的争议文本需用户自行核实后提交
• 建议定期备份 ~/.refund_radar/state.json 以防学习记录丢失
• 处理敏感财务数据时确保设备安全

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/andreolf/refund-radar/SKILL.md
来源类型：GitHub 开源项目