| 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
