Bank Statement Converter

银行流水格式批量转换

将不同银行导出的流水 Excel / CSV 文件批量转换为监管流水导入模板格式（9 列标准格式）。

When to Use

✅ USE this skill when:

• "帮我把这些银行流水转成标准格式"
• "把这个月所有子公司的流水汇总到一份 Excel"
• "把各银行导出的流水统一整理成报送格式"
• "批量转换流水文件，要汇总表和分项表"
• 监管报送需要统一格式的银行流水
• 多个公司/多个银行的流水文件需要汇总
• 每月重复性的流水格式整理工作

When NOT to Use

❌ DON'T use this skill when:

• 非 Excel / CSV 格式的文件（PDF、Word 等）→ 用对应的文件转换工具
• 需要修改流水内容或金额 → 这是格式转换工具，不改变数据
• 需要分析流水数据（趋势、统计）→ 转换后用数据分析技能
• 加密的银行文件 → 需先解密再转换
• 非银行流水类 Excel（如发票、合同）→ 不适用

支持的银行格式

自动识别以下格式，无需手动选择：

• 标准 .xlsx（openpyxl 解析）
• 旧版 .xls 二进制（xlrd 解析）
• HTML 表格 .xls（银行网页导出的 .xls 实际是 HTML）
• XML Spreadsheet .xls（工行电子回单等）
• 伪 .xls 实为 .xlsx（扩展名不匹配的 ZIP 格式）
• 标准 .csv（自动识别 UTF-8 BOM、GB18030/GBK、UTF-16 等常见编码；支持中国银行等“中文[英文]”表头导出）

Commands

首次使用 — 环境初始化

pip install openpyxl xlrd

验证环境：

python3 -c "import openpyxl, xlrd; print('OK')"

转换流水文件

# 基本用法（自动输出 zip 到输入文件夹同级的"输出"目录）
python3 /home/node/agents/skills/crc-bank-statement-converter/converter.py "<输入文件夹路径>"

# 指定输出 zip 路径
python3 /home/node/agents/skills/crc-bank-statement-converter/converter.py "<输入文件夹路径>" "<输出 zip 路径>"

参数说明：

• 输入文件夹路径（必填）：包含 .xls / .xlsx / .csv 流水文件的文件夹，支持子文件夹递归扫描
• 输出 zip 路径（可选）：不提供时自动生成到输入文件夹同级的 输出 目录下，文件名 监管流水_<时间戳>.zip

Quick Responses

"帮我把这批银行流水转成标准格式"

1. 确认用户提供了文件夹路径
2. 检查 Python 环境和脚本是否就绪
3. 执行转换（推荐输出到 workspace 方便用户下载）：

python3 /home/node/agents/skills/crc-bank-statement-converter/converter.py "/home/node/workspace/流水数据" "/home/node/workspace/监管流水.zip"

1. 报告转换结果（成功/失败数量）+ 提示用户去 workspace 下载 zip

"把本月所有子公司的银行流水统一转换"

python3 /home/node/agents/skills/crc-bank-statement-converter/converter.py "/home/node/workspace/本月流水" "/home/node/workspace/本月监管流水.zip"

"检查转换后的文件是否与原始流水金额一致"

转换完成后解压 zip，读取「汇总.xlsx」或某家公司单独的 Excel，抽查几行与原始文件对比金额列。

输出格式

输出一个 zip 压缩包，结构如下：

监管流水_<时间戳>.zip
├── 汇总.xlsx             # 所有公司流水合并到一张表，含 _来源公司 列
├── <原文件名 1>.xlsx     # 每个源文件对应一份独立 Excel（9 列）
├── <原文件名 2>.xlsx
└── ...

模板 9 列：日期 | 收入 | 支出 | 余额 | 摘要 | 对方户名 | 对方银行 | 对方账号 | 备注

• 日期 固定输出为 YYYY-MM-DD 文本格式，例如 2026-04-14，不会保留时分秒。
• 对方户名、对方银行、对方账号 会兼容常见的“对方/交易对方/交易对手/付款人/收款人/付方/收方/借方/贷方”等银行导出表头叫法。

zip 输出到 workspace 后，普通用户可直接从文件管理面板下载。

Notes

• 输出按交易日期时间正序（旧→新）排列；银行导出的倒序流水（含同一日期/时间戳内的倒序）会自动检测并反转
• 自动跳过以 ~ 开头的临时文件和含 说明 的文件
• 自动过滤汇总行（含"合计"、"小计"、"累计"、"笔数"的行）
• CSV 支持逗号、Tab、分号分隔；如果银行导出文件前几行是查询摘要，会自动定位真正表头行
• 电子回单格式（无余额列）的余额字段为空
• 如果转换失败，检查文件是否为加密或非标准格式
• 脚本位置：/home/node/agents/skills/crc-bank-statement-converter/