Excel Operations

---
name: excel-operations
description: Excel 报表生成技能。当需要导出监测数据表、统计汇总表或多期对比表为 .xlsx 文件时加载此技能，获取数据组织规范和工具调用指引。
---

## 适用场景

- 监测日报/周报数据附表导出
- 多测点多期次变形数据汇总表
- 基坑支撑轴力统计表
- 地下水位观测记录表
- 测斜仪深层位移数据表
- 任何需要以 Excel 格式交付给甲方或存档的结构化数据

## 可用工具

系统提供两个 Excel 导出工具，按场景选择：

### `excel_export`（通用导出）

自由定义 Sheet 结构，适用于自定义格式的数据表。

参数说明：

| 参数 | 类型 | 说明 |
|------|------|------|
| `sheets` | 数组 | 工作表列表，每个包含 name/headers/rows |
| `sheets[].name` | 字符串 | Sheet 名称，如"沉降监测"、"轴力统计" |
| `sheets[].headers` | 字符串数组 | 列标题 |
| `sheets[].rows` | 二维数组 | 数据行，元素可为字符串/数字/布尔/null |
| `sheets[].columnWidths` | 数字数组 | 可选，各列宽度（字符数） |
| `sheets[].freezeRow` | 数字 | 冻结前N行，默认1（冻结表头） |
| `title` | 字符串 | 文件名（不含扩展名） |
| `outputPath` | 字符串 | 可选，输出路径 |

### `monitoring_table_export`（监测数据快捷导出）

专为监测数据设计，直接传入测点数据即可生成带预警标识的规范化报表。

参数说明：

| 参数 | 类型 | 说明 |
|------|------|------|
| `projectName` | 字符串 | 项目名称 |
| `monitoringType` | 枚举 | settlement/displacement/axial_force/water_level/inclinometer/convergence |
| `date` | 字符串 | 报表日期 YYYY-MM-DD |
| `points` | 数组 | 测点数据列表 |
| `warningValue` | 数字 | 可选，预警值 |
| `alarmValue` | 数字 | 可选，报警值 |

## 数据组织规范

### Sheet 命名

| 场景 | 推荐名称 |
|------|---------|
| 地表沉降 | 地表沉降监测数据 |
| 桩顶位移 | 桩顶水平位移数据 |
| 深层位移 | 测斜仪深层位移 |
| 支撑轴力 | 支撑轴力监测数据 |
| 地下水位 | 地下水位观测记录 |
| 管片收敛 | 隧道收敛量测数据 |
| 数据汇总 | 监测数据汇总表 |

### 表头规范

标准监测数据表的列顺序：

```
测点编号 | 断面位置 | 初始值(mm) | 上期值(mm) | 本期值(mm) | 本期变化量(mm) | 累计变化量(mm) | 变化速率(mm/d) | 预警值(mm) | 状态
```

关键要求：
- 数值列必须注明单位（mm、kN、m 等）
- 变化量保留小数点后1位
- 速率保留小数点后2位
- 超限数据在"状态"列标注"⚠️预警"或"🔴报警"

### 多期数据对比表

当需要展示多期次数据变化时，按以下结构组织：

```
测点编号 | 第1期(日期) | 第2期(日期) | ... | 第N期(日期) | 累计变化量 | 状态
```

## 典型调用示例

### 沉降监测日报数据表

```
调用 excel_export，传入：
sheets: [{
  name: "地表沉降监测数据",
  headers: ["测点编号", "里程桩号", "初始值(mm)", "上期值(mm)", "本期值(mm)", "本期变化量(mm)", "累计变化量(mm)", "变化速率(mm/d)", "预警值(mm)", "状态"],
  rows: [具体数据行],
  freezeRow: 1
}]
title: "XX项目-沉降监测数据-20250301"
```

### 多项目汇总（多 Sheet）

```
调用 excel_export，传入多个 sheet：
sheets: [
  { name: "沉降监测", headers: [...], rows: [...] },
  { name: "位移监测", headers: [...], rows: [...] },
  { name: "轴力监测", headers: [...], rows: [...] },
  { name: "汇总统计", headers: [...], rows: [...] }
]
title: "XX项目-监测数据周报-第12周"
```

## 注意事项

- 数据量大于 50 行时，优先使用 `excel_export` 而非在 Markdown 中写大表格
- 报告正文（Word）中只放摘要表（关键测点、最大值、超限点），完整数据以 Excel 附件形式交付
- `monitoring_table_export` 会自动根据预警值/报警值标注状态，优先使用
- Excel 文件默认输出到当前工作目录
- 工具生成的 .xlsx 文件兼容 WPS Office 和 Microsoft Excel