Excel 工具（免费版）

概述

Excel 是最通用的数据交换格式之一。本工具让 AI Agent 能够直接读写 xlsx 文件、执行数据清洗与基础统计，无需安装 Microsoft Excel。免费版聚焦于"能读能写能算"——覆盖单文件基础操作；多表合并、透视表、图表生成与大数据处理留给专业版。

通过 openpyxl 与 pandas 等成熟开源库操作，支持格式保留与公式计算。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Excel、文件处理免费版、公式计算与基础统、面向个人用户与独、立开发者、文件的基础处理能、openpyxl、pandas、等标准库操作、无需安装、Microsoft、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：销售数据统计

用户说"统计这个 Excel 里销售额的总和与平均值"。Agent 读取 xlsx 文件，识别"销售额"列，计算 SUM 与 AVERAGE，输出结果。

场景二：数据清洗

用户说"这个表有很多重复行和空值，帮我清理"。Agent 用 pandas 去重、填充或删除空值、转换数据类型，输出清洗后的文件。

场景三：格式化报表

用户说"把这个表加上标题行、边框和合计行"。Agent 用 openpyxl 写入格式（粗体、边框、背景色），追加合计行并写入 SUM 公式。

快速开始

60 秒上手

1. 安装依赖：pip install openpyxl pandas
2. 把 Excel 文件发给 Agent，描述需求
3. Agent 生成 Python 脚本并执行，输出结果或新文件

读取 Excel 文件

import pandas as pd

# 读取第一个 sheet
df = pd.read_excel('data.xlsx')

# 读取指定 sheet
df = pd.read_excel('data.xlsx', sheet_name='Sheet1')

# 读取所有 sheet
sheets = pd.read_excel('data.xlsx', sheet_name=None)
for name, df in sheets.items():
    print(f"Sheet: {name}, 行数: {len(df)}")

写入 Excel 文件

import pandas as pd

df = pd.DataFrame({
    '产品': ['A', 'B', 'C'],
    '销量': [100, 200, 150],
    '单价': [10, 20, 15]
})
df['总额'] = df['销量'] * df['单价']
df.to_excel('output.xlsx', index=False)

示例

数据清洗模板

import pandas as pd

df = pd.read_excel('data.xlsx')

# 1. 去除完全重复的行
df = df.drop_duplicates()

# 2. 处理空值
df = df.dropna(subset=['必填列'])          # 删除关键字段为空的行
df['可选列'] = df['可选列'].fillna(0)        # 填充默认值
df['文本列'] = df['文本列'].fillna('未知')    # 填充文本

# 3. 类型转换
df['日期'] = pd.to_datetime(df['日期'])
df['金额'] = df['金额'].astype(float)

# 4. 输出清洗结果
df.to_excel('cleaned.xlsx', index=False)
print(f"清洗完成：{len(df)} 行")

公式计算模板

from openpyxl import load_workbook

wb = load_workbook('report.xlsx')
ws = wb.active

# 在最后一行追加合计
last_row = ws.max_row
ws.cell(row=last_row + 1, column=1, value='合计')
ws.cell(row=last_row + 1, column=2, value=f'=SUM(B2:B{last_row})')
ws.cell(row=last_row + 1, column=3, value=f'=AVERAGE(C2:C{last_row})')
ws.cell(row=last_row + 1, column=4, value=f'=MAX(D2:D{last_row})')

wb.save('report_with_totals.xlsx')

格式化报表模板

from openpyxl import Workbook
from openpyxl.styles import Font, Border, PatternFill, Alignment

wb = Workbook()
ws = wb.active
ws.title = '销售报表'

# 标题行格式
header_font = Font(bold=True, color='FFFFFF', size=12)
header_fill = PatternFill(start_color='4472C4', end_color='4472C4', fill_type='solid')
thin_border = Border(left=True, right=True, top=True, bottom=True)

headers = ['产品', '销量', '单价', '总额']
for col, header in enumerate(headers, 1):
    cell = ws.cell(row=1, column=col, value=header)
    cell.font = header_font
    cell.fill = header_fill
    cell.border = thin_border
    cell.alignment = Alignment(horizontal='center')

# 数据行
data = [
    ['A', 100, 10, 1000],
    ['B', 200, 20, 4000],
    ['C', 150, 15, 2250],
]
for row_idx, row_data in enumerate(data, 2):
    for col_idx, value in enumerate(row_data, 1):
        cell = ws.cell(row=row_idx, column=col_idx, value=value)
        cell.border = thin_border

wb.save('formatted_report.xlsx')

最佳实践

1. 读取大文件用 openpyxl 只读模式

from openpyxl import load_workbook
wb = load_workbook('large.xlsx', read_only=True)

只读模式不加载整个文件到内存，适合大文件。

2. 写入时关闭索引

df.to_excel('output.xlsx', index=False)

避免生成无意义的索引列。

3. 数据清洗顺序

1. 去重 → 2. 处理空值 → 3. 类型转换 → 4. 异常值处理 顺序很重要，先去重可减少后续处理量。

4. 公式 vs 计算

• 需要在 Excel 中动态更新 → 用公式（=SUM(B2:B10)）
• 只需要最终结果 → 用 Python 计算后写入值
• 公式适合交付给非技术人员，计算适合自动化流水线

5. 日期处理

• 读取时用 pd.to_datetime() 转换
• 写入时用 datetime 对象，pandas 自动识别
• 避免用字符串存日期，会导致排序与比较错误

6. 编码问题

• xlsx 是二进制格式，无编码问题
• 如导出 CSV，统一用 utf-8-sig 编码（兼容 Excel 中文）

常见问题

Q1：读取 xlsx 报错"zipfile.BadZipFile"？

A：文件可能不是真正的 xlsx，或已损坏。检查文件扩展名与实际格式是否一致。旧版 .xls 需用 xlrd 库读取。

Q2：写入后打开显示乱码？

A：xlsx 不存在编码问题。如出现乱码，可能是字符串本身编码错误。检查数据源编码，统一转为 UTF-8。

Q3：公式写入后不计算？

A：openpyxl 写入公式是字符串，需要 Excel 打开后才会计算。如需在 Python 中获取计算结果，用 data_only=True 读取（但前提是文件曾被 Excel 打开并保存过）。

Q4：日期读取后变成数字？

A：Excel 日期本质是数字序列。用 pd.read_excel(..., parse_dates=['日期列']) 或读取后用 pd.to_datetime() 转换。

Q5：大文件内存溢出？

A：① 用 read_only=True 模式；② 用 pd.read_excel(..., chunksize=1000) 分块读取；③ 超大文件考虑转为 CSV 或用专业版的大数据处理能力。

Q6：如何保留原格式编辑？

A：用 openpyxl.load_workbook() 读取（保留格式），修改后 save()。pandas 读取会丢失格式，只保留数据。

Q7：多 sheet 怎么处理？

A：pd.read_excel(..., sheet_name=None) 返回字典，key 是 sheet 名，value 是 DataFrame。可遍历处理每个 sheet。

已知限制

本免费体验版限制以下高级功能：

• 多表合并（多文件 xlsx 合并与 JOIN 操作）
• 数据透视表（pivot table 生成与分析）
• 图表生成（柱状图、折线图、饼图嵌入）
• 大数据处理（分块读取、流式处理、内存优化）
• 自动化流水线（定时任务、批处理、邮件分发）
• 高级公式与条件格式
• 与 PostgreSQL 等数据库的数据导入导出

解锁全部功能请使用专业版：ws-excel-tool-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Python：3.8+
• 内存：建议 ≥ 4GB（处理大文件时）

依赖详情

API Key 配置

• 本 Skill 基于 Markdown 指令，无需额外 API Key
• 如需调用大模型进行代码生成，由 Agent 平台内置 LLM 提供
• 数据文件路径由用户提供，Agent 通过 exec 执行 Python 脚本处理

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
• 模型路由建议：免费版使用低成本模型（如 GPT-4o-mini / Claude Haiku）
• 数据位置建议：处理后的文件默认存放在用户指定目录或工作区 data/ 子目录

错误处理