excel-parser

SKILL.md

---
name: excel-parser
description: 支持多种Excel格式的内容提取技能，使用calamine库处理.xls、.xlsx、.xlsm等格式。当用户需要解析Excel文件、提取表格数据、将Excel转换为文本格式、分析Excel内容或批量处理Excel文件时，务必使用此技能。适用于数据提取、报表分析、内容审核等场景。
---

# Excel Parser Skill

Excel Parser技能用于从Excel文件中提取内容，支持多种Excel格式。

## Compatibility

- Python 3.7+
- 依赖: `python-dotenv`, `python-calamine`
- 备选依赖: `xlrd` (用于.xls文件), `openpyxl` (用于.xlsx文件)

## 使用方法

### 基本使用

```python
from excel_parser import ExcelParser, process_excel

# 方法1: 使用ExcelParser类
parser = ExcelParser()
result = parser.parse_excel('path/to/file.xlsx')

# 方法2: 使用便捷函数
result = process_excel('path/to/file.xlsx')

# 获取文本格式输出
text = parser.parse_excel_to_text('path/to/file.xlsx')
```

### 返回结果格式

```python
{
    "text": "格式化的文本内容",
    "sheets": [
        {
            "name": "Sheet1",
            "rows": [["A1", "B1"], ["A2", "B2"]],
            "row_count": 2,
            "column_count": 2
        }
    ],
    "sheet_count": 1,
    "total_cells": 4,
    "engine": "python-calamine"
}
```

## 支持的文件格式

- .xls (Excel 97-2003)
- .xlsx, .xlsm (Excel 2007+)
- .xltx, .xltm (Excel模板)

## 环境变量配置

创建 `.env` 文件:

```env
# 最大行数限制，默认100行
EXCEL_MAX_ROWS=100

# 是否保留空行，默认false
EXCEL_KEEP_EMPTY_ROWS=false
```

## 详细文档

更多使用示例和故障排除信息，参见 [README.md](README.md)。