银行流水格式批量转换

Other

将不同银行导出的流水 Excel 批量转换为监管报送标准格式(9 列)。Use when: 用户需要转换银行流水格式、汇总多银行多账户流水、整理监管报送数据。NOT for: 非银行流水文件处理、加密/损坏文件修复。需要 Python3 + openpyxl + xlrd。

Install

openclaw skills install crc-bank-statement-converter

银行流水格式批量转换

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

When to Use

USE this skill when:

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

When NOT to Use

DON'T use this skill when:

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

支持的银行格式

自动识别以下格式,无需手动选择:

  • 标准 .xlsx(openpyxl 解析)
  • 旧版 .xls 二进制(xlrd 解析)
  • HTML 表格 .xls(银行网页导出的 .xls 实际是 HTML)
  • XML Spreadsheet .xls(工行电子回单等)
  • 伪 .xls 实为 .xlsx(扩展名不匹配的 ZIP 格式)

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 流水文件的文件夹,支持子文件夹递归扫描
  • 输出 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 列:日期 | 收入 | 支出 | 余额 | 摘要 | 对方户名 | 对方银行 | 对方账号 | 备注

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

Notes

  • 自动跳过以 ~ 开头的临时文件和含 说明 的文件
  • 自动过滤汇总行(含"合计"、"小计"、"累计"、"笔数"的行)
  • 电子回单格式(无余额列)的余额字段为空
  • 如果转换失败,检查文件是否为加密或非标准格式
  • 脚本位置:/home/node/agents/skills/crc-bank-statement-converter/