SuperAPI AI 工具集

excel

办公与效率

查看项目

更新于 10-15 16:37

技能介绍

Excel 是一个用于操作 Excel 文件(.xlsx)的命令行工具,提供读取、写入、编辑、格式化和导出等能力。它基于 Python 的 openpyxl 库实现,适合在脚本或自动化流程中批量处理电子表格。

用途

该工具面向需要对 Excel 文件进行程序化操作的场景,例如从数据生成报表、更新已有报表、提取数据用于分析,以及在不同格式之间转换。

主要能力

  • 读取:获取工作簿元信息(工作表、维度、行列数)、读取整个工作表或指定区域、读取单个单元格(含值、公式、数据类型、合并状态)。
  • 创建与写入:创建新工作簿并指定工作表,写入二维数组、带表头的数据、键值对,支持指定起始单元格;也可从 CSV 或 JSON 创建 Excel。
  • 编辑:修改单元格的值或公式,查找文本,查找并替换。
  • 工作表管理:添加、重命名、删除、复制工作表,支持指定插入位置。
  • 行列操作:插入或删除行与列,支持指定数量。
  • 单元格操作:合并与取消合并单元格。
  • 格式化:设置粗体、斜体、字体大小、字体颜色、字体名称、背景色、对齐方式、垂直对齐、自动换行、边框(thin、medium、thick、double)。
  • 调整尺寸与冻结窗格:设置行高、列宽,冻结行或列。
  • 导出:导出为 CSV、JSON(首行为表头)、Markdown 表格。

使用方式

安装依赖:

pip install openpyxl

或使用 uv(推荐):

uv run --with openpyxl python3 scripts/excel.py --help

进入技能目录后通过命令行调用:

cd skills/excel

常用命令示例:

  • 获取文件信息:python3 scripts/excel.py info report.xlsx
  • 读取工作表:python3 scripts/excel.py read report.xlsx,可加 --format markdown、--sheet "Sales"、--range A1:D10
  • 读取单元格:python3 scripts/excel.py cell report.xlsx B5
  • 创建工作簿:python3 scripts/excel.py create output.xlsx,可加 --sheets "Data,Summary,Charts"
  • 写入数据:python3 scripts/excel.py write output.xlsx --data '[[1,2,3],[4,5,6]]'
  • 编辑单元格:python3 scripts/excel.py edit report.xlsx A1 "New Value",公式加 --formula
  • 导出:python3 scripts/excel.py to-csv report.xlsx output.csv、to-json、to-markdown

颜色支持命名颜色(RED、GREEN、BLUE、YELLOW、WHITE、BLACK、GRAY、ORANGE、PURPLE、PINK、CYAN)和十六进制颜色(如 #FF0000、#4472C4、00FF00,可带或不带 #)。

所有命令输出 JSON,包含 success: true/false 字段。

适用场景

  • 从 JSON 或 CSV 数据生成带格式的 Excel 报表。
  • 更新已有报表:插入行、写入新数据、更新公式、批量替换。
  • 提取数据用于分析:读取为 JSON、读取指定区域为 Markdown、导出指定工作表为 CSV。

限制

资料未提供关于平台兼容性、性能上限、并发处理、文件大小限制或错误处理细节的说明。该工具仅处理 .xlsx 格式,其他 Excel 格式(如 .xls)暂未提供支持说明。