openclawkit-excel

Excel文件操作工具套件，提供基础的Excel文件读写、数据处理和报表生成功能。

Install

openclaw skills install @wanghao20150901/openclawkit-excel

Excel工具套件 (Excel Toolkit)

功能概述

这是一个功能完整的Excel文件操作工具套件，提供基础的Excel文件读写、数据处理和报表生成功能。

核心功能

📁 文件操作：创建、读取、写入、合并Excel文件
📊 数据处理：数据清洗、转换、分析
🔧 格式设置：单元格格式、样式、图表
📈 报表生成：多工作表报表、统计图表
🔍 数据验证：数据完整性检查、错误处理

使用时机

✅ 使用此工具当：

需要批量处理Excel文件
需要自动化Excel报表生成
需要进行数据清洗和转换
需要合并多个Excel文件
需要创建复杂的Excel模板

环境要求

Python 3.6+
依赖包：
- pandas (数据处理)
- openpyxl (Excel文件操作)

安装依赖：

pip install pandas openpyxl

使用方法

命令行使用

# 查看帮助
python scripts/main.py --help

# 合并多个Excel文件
python scripts/main.py merge --input "file1.xlsx,file2.xlsx" --output merged.xlsx

# 转换CSV到Excel
python scripts/main.py convert --input data.csv --output data.xlsx

# 数据清洗
python scripts/main.py clean --input raw_data.xlsx --output clean_data.xlsx

# 生成统计报表
python scripts/main.py report --input sales.xlsx --output sales_report.xlsx

Python API使用

from openclawkit_excel import ExcelToolkit

# 初始化工具
excel = ExcelToolkit(debug=True)

# 创建Excel文件
data = {
    '姓名': ['张三', '李四', '王五'],
    '年龄': [25, 30, 35],
    '部门': ['技术部', '市场部', '销售部']
}
excel.create_excel('员工信息.xlsx', data)

# 读取Excel文件
df = excel.read_excel('员工信息.xlsx')
print(df)

# 数据清洗
cleaned_df = excel.clean_data(df)
excel.write_excel('清洗后数据.xlsx', cleaned_df)

功能模块

1. 文件操作模块

创建新Excel文件
读取现有Excel文件
写入数据到Excel
合并多个Excel文件
拆分Excel文件

2. 数据处理模块

数据清洗（去重、填充空值、格式转换）
数据转换（类型转换、编码转换）
数据筛选（条件筛选、随机抽样）
数据聚合（分组统计、透视表）

3. 格式设置模块

单元格格式（字体、颜色、对齐）
数字格式（货币、百分比、日期）
条件格式（数据条、色阶、图标集）
图表生成（柱状图、折线图、饼图）

4. 报表生成模块

多工作表报表
统计摘要报表
数据透视报表
可视化报表

5. 数据验证模块

数据类型验证
数据范围验证
唯一性验证
业务规则验证

示例代码

基础示例

from openclawkit_excel import ExcelToolkit

# 创建工具实例
excel = ExcelToolkit()

# 检查文件是否存在
if excel.file_exists('data.xlsx'):
    # 读取文件
    df = excel.read_excel('data.xlsx')
    
    # 数据清洗
    df_clean = excel.clean_data(df)
    
    # 保存清洗后的数据
    excel.write_excel('data_clean.xlsx', df_clean)
    
    # 生成统计报表
    excel.generate_report(df_clean, 'report.xlsx')

高级示例

from openclawkit_excel import ExcelToolkit

excel = ExcelToolkit(debug=True)

# 合并多个文件
files = ['q1.xlsx', 'q2.xlsx', 'q3.xlsx', 'q4.xlsx']
merged_df = excel.merge_files(files, merge_on='日期')
excel.write_excel('年度数据.xlsx', merged_df)

# 创建复杂报表
report_data = {
    'summary': excel.generate_summary(merged_df),
    'monthly': excel.group_by_month(merged_df),
    'top10': excel.get_top_items(merged_df, '销售额', 10),
    'trend': excel.calculate_trend(merged_df, '销售额')
}

excel.create_multi_sheet_report('年度分析报告.xlsx', report_data)

错误处理

工具包含完善的错误处理机制：

文件不存在或损坏处理
数据格式错误处理
内存不足处理
并发访问处理

性能优化

批量处理：支持大文件分批处理
内存映射：减少内存占用
并行计算：多核CPU加速
缓存机制：减少重复计算

更新日志

v1.0.1 (2026-03-28)

初始版本发布
基础文件操作功能
数据处理和清洗功能
报表生成功能
完整的错误处理

许可证

MIT License

作者

浩哥 (Hao Ge)

反馈与贡献

欢迎提交Issue和Pull Request：

GitHub: https://github.com/wanghao20150901/openclawkit-excel.git
Email: 512975801@qq.com