excel-operations

## 适用场景 - 监测日报/周报数据附表导出 - 多测点多期次变形数据汇总表 - 基坑支撑轴力统计表 - 地下水位观测记录表 - 测斜仪深层位移数据表 - 任何需要以 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