SuperAPI AI 工具集

excel-to-csv

数据与分析

查看项目

更新于 10-16 08:00

技能介绍

用途:把专有 .xlsx 或 .xls 二进制格式中受限范围的数据提取为干净、原始、可移植的 .csv,便于其他智能体原生读取和处理表格数据。

主要能力:提供转换引擎与校验引擎;支持指定工作表名称和输出目录;当用户提到某个表格时,若不支持精确表格命名空间,会尝试映射到所在工作表。

使用方式:执行 python3 ./scripts/convert.py --excel "path/to/data.xlsx" --sheets "Sheet1" --outdir "output_folder/",随后执行 python3 ./scripts/verify_csv.py "output_folder/Sheet1.csv" 校验;若返回 errors_found,根据 JSON 日志中的行号用 awk 或 sed 修复并对齐表头、空行等结构问题,再重复校验直至通过。读取数据时,超过 50 行须分块读取或写 pandas 脚本查询,避免用 cat 直接输出整份 CSV 撑爆上下文。

适用场景:需要将 Excel 表格转为 CSV 供后续分析、查询或其他智能体处理的场合。

限制:必须通过 convert.py 执行,禁止自行用 openpyxl 重写转换流程;遇到密码保护工作簿或损坏 ZIP 元数据等异常时停止,并查阅 references/fallback-tree.md 寻找替代提取方案。