railwise-ai 1.2.32 → 1.2.34

package/agent-pack/assets/skill/di-bao-monitoring/assets/project-brief-template.md

@@ -0,0 +1,59 @@
+# 地保监测项目资料卡
+
+> 使用方式：先填本资料卡，再起草方案、日报、周报、月报或预警资料。未知字段保留占位符，不要从样例项目推断。
+
+## 1 项目基础信息
+
+| 字段 | 内容 |
+|---|---|
+| 项目全称 | {{项目全称}} |
+| 工程简称 | {{工程简称}} |
+| 委托/建设单位 | {{委托单位}} |
+| 轨道交通运营/管理单位 | {{轨道交通运营或管理单位}} |
+| 监测单位 | {{监测单位}} |
+| 施工单位 | {{施工单位}} |
+| 合同编号 | {{合同编号}} |
+| 报告编号规则 | {{日报/周报/月报编号规则}} |
+
+## 2 轨道交通与外部工程关系
+
+| 字段 | 内容 |
+|---|---|
+| 涉及线路 | {{线路}} |
+| 涉及车站/区间/高架段 | {{车站、区间或高架段}} |
+| 受影响结构类型 | {{车站/盾构隧道/高架桥墩/桥面/出入场线等}} |
+| 外部施工类型 | {{基坑/盾构/顶管/道路/桥梁/桩基等}} |
+| 最近距离/埋深/相对位置 | {{关键空间关系}} |
+| 风险等级/监测等级 | {{等级}} |
+
+## 3 当前阶段
+
+| 字段 | 内容 |
+|---|---|
+| 当前阶段 | {{资料收集/方案起草/内审/专家评审/日报/周报/月报/预警/消警/总结}} |
+| 施工工况 | {{当前施工工况}} |
+| 本期统计期 | {{YYYY-MM-DD 至 YYYY-MM-DD}} |
+| 天气/温度 | {{天气和温度}} |
+| 是否有预警/报警 | {{无/有，说明级别和点号}} |
+
+## 4 监测配置
+
+| 监测项 | 方法 | 点数 | 频率 | 阈值来源 |
+|---|---|---:|---|---|
+| {{监测项}} | {{自动化/人工/巡视}} | {{N}} | {{频率}} | {{方案/安评/专家意见/运营要求}} |
+
+## 5 可用资料
+
+- 监测方案：{{文件或状态}}
+- 安全影响评估报告：{{文件或状态}}
+- 工筹横道图/施工方案：{{文件或状态}}
+- 测点埋设/验收记录：{{文件或状态}}
+- 初始值报告/审批表：{{文件或状态}}
+- 平面/高程控制网第1期联测报告：{{文件或状态}}
+- 日报 Excel/PDF：{{文件或状态}}
+- 周报/月报 DOCX：{{文件或状态}}
+- 预警/消警资料：{{文件或状态}}
+- 控制网复测报告：{{文件或状态}}
+- 停测申请/确认资料：{{文件或状态}}
+- 项目总结资料：{{文件或状态}}
+- 现场照片/布点图/曲线图：{{文件或状态}}

package/agent-pack/assets/skill/di-bao-monitoring/assets/project-summary-template.md

@@ -0,0 +1,154 @@
+# {{项目全称}}
+
+# 监测项目总结报告
+
+| 字段 | 内容 |
+|---|---|
+| 项目名称 | {{项目全称}} |
+| 监测单位 | {{监测单位}} |
+| 委托/建设单位 | {{委托或建设单位}} |
+| 轨道交通运营/管理单位 | {{运营或管理单位}} |
+| 合同编号 | {{合同编号}} |
+| 监测周期 | {{YYYY-MM-DD 至 YYYY-MM-DD}} |
+| 总结日期 | {{YYYY年M月}} |
+
+## 目录
+
+1. 目的及编制依据
+2. 项目概况
+3. 投入人员及设备
+4. 监测监护范围、周期及工作量
+5. 监测内容、精度和频率
+6. 控制网建立与复测
+7. 监测信息反馈与预警处置
+8. 监测成果分析与评述
+9. 监护巡查与安全生产总结
+10. 结论与建议
+11. 附件
+
+## 1 目的及编制依据
+
+### 1.1 目的
+
+{{说明通过监测和监护及时掌握轨道交通结构变形、指导施工、保障运营安全、闭合项目资料。}}
+
+### 1.2 编制依据
+
+- {{监测方案}}
+- {{安全影响评估报告}}
+- {{规范、标准、运营单位要求}}
+- {{日报、周报、月报、预警资料、控制网报告等}}
+
+## 2 项目概况
+
+### 2.1 工程概述
+
+{{工程位置、规模、施工方式、施工内容、与轨道交通结构关系。}}
+
+### 2.2 周边环境和施工节点
+
+| 施工节点 | 开始时间 | 结束时间 | 备注 |
+|---|---|---|---|
+| {{节点}} | {{YYYY-MM-DD}} | {{YYYY-MM-DD}} | {{备注}} |
+
+## 3 投入人员及设备
+
+### 3.1 人员投入
+
+| 序号 | 姓名/岗位 | 职称或资格 | 职责 | 备注 |
+|---:|---|---|---|---|
+| 1 | {{姓名或岗位}} | {{职称}} | {{职责}} | {{备注}} |
+
+### 3.2 仪器设备
+
+| 序号 | 仪器类型 | 品牌/型号 | 精度指标 | 数量 | 用途 |
+|---:|---|---|---|---:|---|
+| 1 | {{仪器类型}} | {{型号}} | {{精度}} | {{N}} | {{自动化/人工/控制网}} |
+
+## 4 监测监护范围、周期及工作量
+
+### 4.1 监测监护范围
+
+{{按主体基坑、换乘通道、盾构区间、桥墩、桥面、车站/区间等分范围说明。}}
+
+### 4.2 监测周期及停测
+
+| 类型 | 起始日期 | 结束日期 | 说明 |
+|---|---|---|---|
+| 合同/方案监测周期 | {{日期}} | {{日期}} | {{说明}} |
+| 实际监测周期 | {{日期}} | {{日期}} | {{说明}} |
+| 停测/结束依据 | {{日期}} | {{日期}} | {{停测申请或确认}} |
+
+### 4.3 工作量统计
+
+| 类别 | 监测项目 | 点位数量 | 频率 | 次数 | 工作量 | 备注 |
+|---|---|---:|---|---:|---:|---|
+| {{自动化/人工/巡视/控制网}} | {{监测项目}} | {{N}} | {{频率}} | {{N}} | {{N}} | {{备注}} |
+
+## 5 监测内容、精度和频率
+
+| 监测项目 | 监测方法 | 精度要求 | 实施频率 | 备注 |
+|---|---|---|---|---|
+| {{监测项目}} | {{方法}} | {{精度}} | {{频率}} | {{备注}} |
+
+## 6 控制网建立与复测
+
+### 6.1 平面控制网
+
+{{坐标系统、网形、首级控制点、工作基点、复测次数、成果沿用或更新情况。}}
+
+### 6.2 高程控制网
+
+{{高程基准、路线、工作基点、复测次数、成果沿用或更新情况。}}
+
+## 7 监测信息反馈与预警处置
+
+| 日期 | 事件 | 监测项目 | 点号 | 数值 | 处置 | 闭合情况 |
+|---|---|---|---|---:|---|---|
+| {{日期}} | {{预警/报警/消警/会议}} | {{项目}} | {{点号}} | {{数值}} | {{措施}} | {{已闭合/持续跟踪}} |
+
+## 8 监测成果分析与评述
+
+### 8.1 总体变形情况
+
+{{说明各监测项最大累计值、最大速率、是否达到预警/报警/控制值，整体是否稳定。}}
+
+### 8.2 分项变形分析
+
+#### {{监测项目}}
+
+{{结合曲线图和施工节点，分析变化趋势、峰值、原因和影响。}}
+
+### 8.3 阶段性分析
+
+{{按围护、开挖、盾构穿越、顶管、桩基、回填、停测前稳定期等阶段分析。}}
+
+## 9 监护巡查与安全生产总结
+
+### 9.1 监护巡查
+
+{{交底对接、现状普查、日常巡视、病害或异常、处理闭合情况。}}
+
+### 9.2 安全生产总结
+
+{{人员、仪器、轨行区/登高/夜间作业、安全交底、无事故或事故处理情况。}}
+
+## 10 结论与建议
+
+### 10.1 结论
+
+{{说明项目监测期间轨道交通结构变形是否受控、预警是否闭合、是否满足停测或结束条件。}}
+
+### 10.2 建议
+
+{{后续观察、测点保留、资料移交、长期影响关注、类似项目建议。}}
+
+## 11 附件
+
+- 附件1：监测项目平面图。
+- 附件2：初始值报告。
+- 附件3：日报、周报、月报清单。
+- 附件4：控制网复测报告。
+- 附件5：预警、报警、消警资料。
+- 附件6：曲线图和统计表。
+- 附件7：巡视照片和会议纪要。

package/agent-pack/assets/skill/di-bao-monitoring/assets/warning-notice-template.md

@@ -0,0 +1,58 @@
+# {{项目全称}}
+
+# 监测{{预警/报警/红色预警/消警}}报审表
+
+| 字段 | 内容 |
+|---|---|
+| 编号 | {{编号}} |
+| 监测单位 | {{监测单位}} |
+| 委托/建设单位 | {{委托或建设单位}} |
+| 施工单位 | {{施工单位}} |
+| 发生/申请日期 | {{YYYY年M月D日}} |
+| 预警级别 | {{预警/报警/红色预警/消警}} |
+
+## 1 基本信息
+
+| 字段 | 内容 |
+|---|---|
+| 预警部位 | {{车站/区间/桥墩/桥面/施工影响区域}} |
+| 预警项目 | {{监测项目}} |
+| 预警测点 | {{点号列表}} |
+| 首次触发时间 | {{YYYY-MM-DD HH:mm}} |
+| 报告期号 | {{日报/周报/月报期号}} |
+
+## 2 数据情况
+
+| 测点 | 本次变化量(mm) | 变化速率(mm/d) | 累计变化量(mm) | 预警值(mm) | 报警值(mm) | 控制值(mm) | 当前状态 |
+|---|---:|---:|---:|---:|---:|---:|---|
+| {{点号}} | {{X.X}} | {{X.XX}} | {{X.X}} | {{±X.X}} | {{±X.X}} | {{±X.X}} | {{状态}} |
+
+## 3 施工工况
+
+{{说明触发时段保护区内/邻近施工工况、与预警部位的空间关系、是否存在加荷/卸荷/开挖/盾构/顶进/桩基/支撑拆换等关键工序。}}
+
+## 4 原因分析
+
+{{结合数据趋势、现场工况、复测结果和历史曲线分析原因。证据不足时使用审慎措辞。}}
+
+## 5 已采取及建议措施
+
+1. {{通知相关单位及人员}}
+2. {{加密监测频次}}
+3. {{复测或核查仪器/基准点/测点}}
+4. {{加强现场巡视}}
+5. {{建议施工单位核查或调整施工参数}}
+6. {{必要时组织专题会议或专家评审}}
+
+## 6 消警条件或后续跟踪
+
+{{若为预警/报警，写后续跟踪要求；若为消警，写稳定期、复测证据和申请消警依据。}}
+
+## 7 附件
+
+- 附件1：{{监测曲线或数据表}}
+- 附件2：{{相关日报/周报/月报页}}
+- 附件3：{{现场照片或巡视记录}}
+- 附件4：{{复测记录/会议纪要/专家意见}}
+
+签字：编制 {{编制人}}　校核 {{校核人}}　审核 {{审核人}}

package/agent-pack/assets/skill/di-bao-monitoring/assets/weekly-report-template.md

@@ -0,0 +1,49 @@
+# {{项目全称}}
+
+# 监测周报
+
+| 字段 | 内容 |
+|---|---|
+| 编号 | {{周报编号}} |
+| 统计期 | {{YYYY年M月D日}} 至 {{YYYY年M月D日}} |
+| 监测单位 | {{监测单位}} |
+| 报告日期 | {{YYYY年M月D日}} |
+
+## 1 本周监测工作量统计
+
+| 工程部位/对象 | 本周日常监测 | 本周巡视巡查 | 本周会议 | 本周联系单/通知 | 下周日常监测 | 下周现场巡视 | 备注 |
+|---|---|---|---:|---:|---|---|---|
+| {{轨道交通本体/桥墩/桥面/区间/车站}} | {{频率或次数}} | {{次数}} | {{N}} | {{N}} | {{计划频率}} | {{计划次数}} | {{备注}} |
+
+## 2 施工工况
+
+{{本周保护区内/邻近工程施工进展，说明与轨道交通结构的空间关系和本周重点风险工序。}}
+
+## 3 监测数据汇总
+
+> 统计区间：自动化监测 {{YYYY/MM/DD}} 至 {{YYYY/MM/DD}}；人工监测 {{YYYY/MM/DD}} 至 {{YYYY/MM/DD}}。
+
+| 监测对象 | 监测方法 | 监测项目 | 监测部位 | 本期最大变化值点号 | 变化量(mm) | 变化速率(mm/d) | 最大累计值点号 | 累计值(mm) | 状态 | 备注 |
+|---|---|---|---|---|---:|---:|---|---:|---|---|
+| {{轨道交通本体/桥面/桥墩}} | {{自动化/人工}} | {{监测项目}} | {{部位}} | {{点号}} | {{X.X}} | {{X.XX}} | {{点号}} | {{X.X}} | {{正常/预警/报警}} | {{备注}} |
+
+### 自动化与人工对比（如适用）
+
+| 对比项目 | 自动化最大累计(mm) | 人工最大累计(mm) | 差值(mm) | 结论 |
+|---|---:|---:|---:|---|
+| {{道床沉降/水平位移等}} | {{X.X}} | {{X.X}} | {{X.X}} | {{差值说明}} |
+
+## 4 存在问题及建议
+
+- 预警/报警情况：{{无/列明点号、数值、阈值、处置状态}}
+- 数据质量或复测情况：{{无/说明}}
+- 施工建议：{{建议}}
+
+## 5 下周工作计划
+
+1. 按监测方案对{{监测对象}}开展日常监测。
+2. 重点关注{{重点施工部位或监测部位}}。
+3. 对轨道交通结构及施工影响区域进行巡视并记录。
+4. {{其他计划}}
+
+签字：编制 {{编制人}}　校核 {{校核人}}　审核 {{审核人}}

package/agent-pack/assets/skill/di-bao-monitoring/references/crossing-static-level-report.md

@@ -0,0 +1,115 @@
+# 穿越工况上海华桓静力水准沉降快报
+
+本文件用于盾构、顶管、管廊、基坑、桥梁等风险源穿越轨道交通控制保护区时，从上海华桓自动化监测平台获取静力水准沉降数据，并按 15 分钟、2 小时、4 小时或项目指定频率生成沉降快报。静力水准只处理沉降/竖向位移，不使用全站仪平差坐标、水平位移或桥墩倾斜计算规则。
+
+## 平台和接口
+
+- 常见平台入口：`http://yun.shhhcl.com/project/login#{{页面或项目入口号}}`。
+- 登录接口由前端调用 `/project/login/do`，密码前端使用 md5，部分页面启用验证码；用于浏览器登录和查项目，不建议把网页登录作为正式取数唯一依据。
+- Apifox 接口文档：`https://s.apifox.cn/6e0dc985-00ab-4113-ae3b-9ed366ab85cb`。
+- 接口服务器：`http://yun.shhhcl.com/TESTAPI`。
+
+关键接口：
+
+| 接口 | 用途 | 关键参数 |
+|---|---|---|
+| `POST /API/finddateById` | 获取项目最新本期/上期时间 | `id` 项目 ID |
+| `POST /API/findSZByIdAndDate` | 获取沉降等“其他数据”本期变化和累计变化 | `id`、`statDate`、`endDate`、`type=2`、`direction=0`、`sampMinutes` |
+| `POST /API/historyCurveByprojectId` | 获取两个时间之间原始数据 | `id`、`statDate`、`endDate`、`decimalCount` |
+
+`findSZByIdAndDate` 的 `type` 枚举中 `2` 为沉降；其他类型包括水位、固定测斜、倾角、收敛、自动测斜、GNSS 等。静力水准沉降快报固定使用 `type=2`，除非项目接口文档另行确认。
+
+## 必需输入
+
+| 类别 | 内容 |
+|---|---|
+| 平台信息 | 平台 URL、项目 ID、登录账号或已登录 Cookie |
+| 报表口径 | 出报间隔、报表截止时间、上期参考时间、取样时长 `sampMinutes` |
+| 项目信息 | 项目全称、监测单位、施工单位、涉及线路和结构、施工工况 |
+| 数据口径 | 静力水准测点列表、点名映射、分区、影响区、阈值、正负号说明 |
+| 模板资料 | 快报模板、完整报表模板、点位图、影响范围图、现场照片 |
+
+用户只给平台和用户名时，先提示：
+
+```text
+要生成华桓静力水准穿越期沉降快报，请补充：平台密码或已登录 Cookie、华桓项目 ID（若没有我先登录平台按用户名可见项目查找）、出报频率、报表截止时间、上期参考时间或上一期报表、取样时长 sampMinutes、当前施工工况、测点分区/点名映射、报警阈值、报表模板和图片资料。正式计算优先用接口 findSZByIdAndDate 的 curOffset/totalOffset，不用截图手抄。
+```
+
+## 取数路线
+
+### 路线 A：接口直取
+
+已知项目 ID 时优先走接口，不需要网页登录：
+
+```bash
+python scripts/fetch_shhh_static_level.py \
+  --api-base "http://yun.shhhcl.com/TESTAPI" \
+  --project-id "{{项目ID}}" \
+  --project-name "{{项目全称}}" \
+  --report-cadence "4h" \
+  --report-cutoff-time "{{YYYY-MM-DD HH:mm:ss}}" \
+  --previous-time "{{YYYY-MM-DD HH:mm:ss}}" \
+  --samp-minutes 60 \
+  --warning-threshold-mm 5 \
+  --alarm-threshold-mm 7 \
+  --control-threshold-mm 10 \
+  --output-dir "平台数据输出"
+```
+
+如果不传 `--report-cutoff-time` 和 `--previous-time`，脚本会调用 `finddateById`，使用平台返回的 `currentTimePoint` 和 `lastTimePoint`。补跑历史报表时必须显式传入时间，不能用平台最新数据回填历史报表。
+
+### 路线 B：网页登录找项目
+
+未知项目 ID 时，先登录 `http://yun.shhhcl.com/project/login#{{入口号}}`，在页面中按用户名可见项目筛选，记录项目 ID、项目名称和测点/分区。由于登录页可能启用验证码，自动脚本不应硬猜验证码；可使用浏览器、Chrome 会话或人工登录后 Cookie 完成项目确认。确认项目 ID 后回到路线 A 取数。
+
+## 计算口径
+
+- `本次变化量`：接口 `curOffset`，表示 `statDate` 相对 `endDate` 的本期变化。
+- `累计变化量`：接口 `totalOffset`，表示本期相对平台初始值的累计变化。
+- `本次测值`：接口 `curValue`；`参考测值`：接口 `refValue`。
+- `变化速率`：源接口未给出时，按 `curOffset / 时间差天数` 计算，单位 mm/d；如果参考时间与本期时间相同或缺失，速率留空。
+- `单位`：优先使用接口 `unit`；为空时按静力水准沉降 mm 口径处理，并写入摘要。
+- `正负号`：以项目报表或方案为准；未确认时可暂写“+ 为隆起，- 为下沉（待项目确认）”。
+- `阈值`：优先项目方案/安评/运营单位要求；缺失时状态写“待确认阈值”，不要套用其他项目阈值。
+
+## CSV 字段
+
+优先使用 `assets/crossing-static-level-input-template.csv`。脚本输出字段与通用报表 CSV 兼容，核心字段如下：
+
+| 字段 | 含义 |
+|---|---|
+| `project_name` | 项目全称 |
+| `report_cadence` | 15min、2h、4h 或项目指定间隔 |
+| `previous_time`、`current_time` | 参考时间、本期时间 |
+| `monitoring_item` | 通常写 `结构沉降`、`道床沉降` 或 `沉降` |
+| `monitoring_method` | 固定写 `上海华桓静力水准自动化监测平台` 或项目确认名称 |
+| `point_id` | 报表点号，默认取接口 `name` |
+| `sensor_sn` | 传感器编号，取接口 `sn` |
+| `current_change_mm` | 本次变化量，取 `curOffset` |
+| `cumulative_mm` | 累计变化量，取 `totalOffset` |
+| `current_value`、`previous_value` | 本期测值、参考测值 |
+| `shhh_project_id`、`shhh_point_id` | 华桓项目和测点追溯 ID |
+
+## 报表表达
+
+- 报表标题写“静力水准自动化沉降监测快报”或项目模板指定名称。
+- 数据来源写“上海华桓静力水准自动化监测平台”。
+- 表格只保留沉降相关列：点号、位置/分区、本次变化、累计变化、状态、备注；不要保留全站仪水平位移、倾斜列。
+- 最大值分开统计：本次最大点和值、累计最大点和值。
+- 缺测、离线、异常值不得填 0；保留 `/` 并在备注写明数据状态。
+- 结论应写本时段沉降数据是否平稳、是否达到预警/报警、是否需要加密监测或现场复核。
+
+正常结论示例：
+
+```text
+本时段上海华桓静力水准自动化沉降监测数据总体平稳，各测点本次变化量和累计变化量均未达到预警值。后续按 {{4小时}} 频率持续采集，并结合现场施工推进情况关注重点影响区测点变化趋势。
+```
+
+## 交付检查
+
+- 项目 ID、项目名称、点号和分区经过人工确认。
+- 报表时间不得晚于接口实际数据时间；历史补报不得用未来数据。
+- `curOffset` 和 `totalOffset` 没有被二次反算或覆盖。
+- 本次最大和累计最大分别按绝对值统计。
+- 阈值、正负号、单位写清楚；接口 `unit` 为空时在摘要中留痕。
+- 输出 Excel 和 PDF 文件名包含项目名称、日期、名义小时和“静力水准沉降快报”。

package/agent-pack/assets/skill/di-bao-monitoring/references/crossing-total-station-report.md

@@ -0,0 +1,206 @@
+# 穿越工况自动化全站仪高频报表
+
+本文件用于盾构、顶管、管廊、桥梁等风险源穿越轨道交通控制保护区时，按 15 分钟、2 小时、4 小时或项目指定频率出具自动化全站仪监测快报。当前只处理全站仪/测量机器人数据；静力水准另设流程后再接入。
+
+## 触发场景
+
+- 用户要求“15 分钟一报”“2 小时一报”“4 小时一报”“穿越快报”“自动化全站仪报表”。
+- 盾构、顶管或其他施工体进入上穿/下穿/邻近正投影影响区。
+- 运营单位或监测方案要求穿越窗口加密出报。
+- 已有样例为 A3 横版、左右分栏、上部工况图像、下部数据表的快报格式。
+
+## 必需输入
+
+| 类别 | 内容 |
+|---|---|
+| 项目资料 | 项目全称、涉及线路、区间/车站/桥梁结构、监测单位、施工单位 |
+| 平台取数 | 平台URL、项目ID/prjid、平差网ID、登录方式、数据模块口径 |
+| 出报口径 | 出报间隔、报表截止时间、报告编号、平台初始值来源、上次监测时间、本次监测时间、报告统计时段 |
+| 施工进度 | 盾构/顶管环号、里程、穿越位置、正投影区段、当前风险工序 |
+| 数据资料 | 自动化全站仪平台初始值、当前平差成果、上一平差成果、本次变化量、累计变化量、速率 |
+| 监测分区 | 上行线、下行线、左右线、正投影区、延伸范围、非重点区 |
+| 阈值资料 | 预警值、报警值、控制值、速率或连续同向报警规则 |
+| 点名映射 | 平台原始点号、报表显示点号、桥墩上下点配对、倾斜率点号，经人工确认 |
+| 图片资料 | 点位图、影响范围图、现场照片或视频截图 |
+
+缺任何一类资料时保留占位符或在备注列出缺口，不要从参考项目臆造。
+
+当用户只说“做穿越期地保监测报表/快报”，先要求其提供或确认以下信息：
+
+```text
+请提供平台URL、项目ID/prjid、平差网ID、登录方式（DIBAO_PLATFORM_USER/DIBAO_PLATFORM_PASSWORD环境变量或浏览器Cookie）、出报频率、报表截止时间、当前施工工况、点名映射确认表、左/右示意图或照片、项目实施单位来源文件。自动化初始值将从全站仪自动化平台初始值接口取X/Y/H，不使用人工初始值报告起算；平台取数只使用报表截止时间前已完成的平差批次。
+```
+
+## 出报频率口径
+
+| 间隔 | 报表侧重点 | 数据口径 |
+|---|---|---|
+| 15 分钟 | 快速判断穿越窗口是否稳定 | 使用本次截止时间前最后一个完整观测批次；重点写缺测、报警、最大值 |
+| 2 小时 | 阶段性汇总穿越影响 | 表内仍用本次批次数据，可补充本时段最大值、缺测次数、趋势 |
+| 4 小时 | 半班次或班次交接汇报 | 增加工况回顾、照片、趋势判断和下一时段建议 |
+
+若自动化数据返回时间与出报时间不完全一致，以“本次监测时间”写明实际数据批次；不得用晚于出报截止的数据补当前报表。补跑历史报表时必须显式传入报表截止时间，例如补 2026-06-04 16:00 报表，应锁定 `2026-06-04 16:00:00` 之前最后一个已完成批次，而不是使用之后才完成的批次。
+
+## 数据整理
+
+1. 平台取数优先走 `数据查询 / 平差与测站数据 / 变形监测平差数据`：先确认报表截止时间之前最新已完成平差批次，再取该批次对应的平面/高程平差报告和点位累计变形。不要直接把首页“最新动态”、告警详情、晚于出报时刻的平差批次或未锁定批次的当前点位表当成最终来源。
+2. 保留通用字段：`monitoring_item`、`monitoring_method`、`structure_zone`、`point_id`、`current_change_mm`、`rate_mm_per_d`、`cumulative_mm`、阈值列。
+3. 增加高频字段：`report_cadence`、`report_start`、`report_end`、`initial_time`、`previous_time`、`current_time`、`ring_no`、`position_label`、`influence_zone`、`validity`。
+4. 先判别点位角色：`CZ` 前缀为测站，`JD` 前缀为测量基点/基准点，不作为监测点，不参与监测点数量、本次最大、累计最大和数据表统计。
+5. 先建立点名映射表：当平台原始点号与工程师快报点号不一致时，按编号、布点图和初始值报告建立映射，例如 `S12/X12 -> MCC012`、`S13/X13 -> MCC013`、`S12/X12 -> MCQX012`。映射表必须经用户/工程师人工确认后才可用于正式报表；未确认时只输出核对草稿。模板见 `assets/point-alias-map-template.json`。
+6. 自动化全站仪快报必须从全站仪自动化平台获取平台初始值。当前平台可从 `ConfigManage/MonitorConfig/Point/PointHandler3.ashx?title=get&pointtype=1` 读取监测点配置中的 `X/Y/H`，该组值作为累计变形的起算坐标；不得用人工初始值报告替代。人工初始值报告只用于提取项目实施单位等文字信息。
+7. 如果需要自动抓取平台平差后成果，应优先用环境变量或 Cookie 登录。不要把账号密码写进报告、CSV、PDF 或最终回复。命令示例：
+
+```bash
+export DIBAO_PLATFORM_USER="{{用户名}}"
+export DIBAO_PLATFORM_PASSWORD="{{密码}}"
+
+python scripts/fetch_adjusted_total_station.py \
+  --base-url "{{平台URL}}" \
+  --prjid "{{项目ID}}" \
+  --adjust-net-id "{{平差网ID}}" \
+  --report-cadence "{{15min/2h/4h}}" \
+  --report-cutoff-time "{{报表截止时间}}" \
+  --data-grace-minutes "{{整点后取数宽限分钟，常用5}}" \
+  --previous-report-cutoff-time "{{上期报表截止时间}}" \
+  --previous-data-grace-minutes "{{上期整点后取数宽限分钟，常用5}}" \
+  --cumulative-source "platform-deformation" \
+  --current-change-source "previous-batch" \
+  --initial-time "全站仪自动化平台初始值" \
+  --work-condition "{{当前施工工况}}" \
+  --output-dir "平台数据输出"
+```
+
+该脚本会抓取 `StationDataHandler.ashx?title=getPage&fpage=AdjustData1` 中报表截止时间前最新已完成平差批次、`AdjustReportChild.aspx?adjsummid={{平差ID}}&rpt=1/2` 的平面/高程报告、`AllPointCurrInfoHandler.ashx?title=get1` 的平台平差变形成果 `dX/dY/dH`、`PointHandler3.ashx?title=get&pointtype=1` 的平台初始值，以及当前/上一期报表对应批次的 `PointMonCoordHandler.ashx?title=get1&showData0=true` 坐标记录，并转换为报表 CSV。默认 `--cumulative-source platform-deformation`，即累计量采用平台平差成果表直接返回的 `dX/dY/dH`；平台初始值 `X/Y/H` 用于高差、点位配置和校核。若平台整点后几分钟才生成当次平差成果，保留名义 `--report-cutoff-time`，另设 `--data-grace-minutes 5` 等宽限值取整点后已完成批次，并在摘要中记录宽限。若计算“日变量/单次变化”，必须传 `--previous-report-cutoff-time` 和 `--previous-data-grace-minutes`，使单次变化按“本期名义窗口成果 - 上期名义窗口成果”计算。沉降取平台垂直位移/Z值 `dH`；水平位移分东西、南北两个方向，东西方向取Y坐标差，Y变大为向东方向位移，南北方向取X坐标差，X变大为向北方向位移；桥墩倾斜也分东西、南北两个方向，东西向倾斜按上下点Y坐标位移差除以上下点初始三维距离，南北向倾斜按上下点X坐标位移差除以上下点初始三维距离。若 Mac 或非 Windows 浏览器页面不显示平差报告，应先用接口响应判断后台是否有数据；后台有平差 ID 和报告正文时，可以继续出报。
+
+8. 有结构化 CSV 时运行：
+
+```bash
+python scripts/summarize_crossing_total_station.py input.csv
+```
+
+脚本会输出逐行报警判定 CSV 和 Markdown 汇总。正式报表按用户提供的截图样式输出 A3 横向 Excel 时，继续运行；若抓数脚本生成了同前缀 `*_platform_initial_values.json`，报表脚本会自动用它计算上下点高差：
+
+```bash
+python scripts/build_crossing_total_station_xlsx.py \
+  "平台数据输出/*_adjusted_total_station.csv" \
+  --template "{{快报模板.xlsx}}" \
+  --initial-report "{{初始值报告.docx}}" \
+  --image "{{左图}}" \
+  --image-right "{{右图}}" \
+  --tilt-axis "纵向变形量" \
+  --point-alias-map "{{点名映射.json}}" \
+  --manual-overrides "平台数据输出/manual_metric_overrides.json" \
+  --work-condition "{{当前施工工况}}" \
+  --output "{{输出报表.xlsx}}"
+```
+
+若平台初始值 JSON 不在同前缀位置，应显式传入：
+
+```bash
+python scripts/build_crossing_total_station_xlsx.py \
+  "平台数据输出/*_adjusted_total_station.csv" \
+  --point-config "{{平台初始值.json}}" \
+  --point-alias-map "{{点名映射.json}}" \
+  --image "{{左图}}" \
+  --image-right "{{右图}}" \
+  --output "{{输出报表.xlsx}}"
+```
+
+Excel 快报应采用 A3 横向通栏排版，保留密集黑色表格线、上部双图片区、中部数据分析表、底部最大值/备注/结论区。“施工工况”“施工进度”“各项数据分析”“结论与评价”应横向合并成一栏，不要左右重复分栏；“工况及影响范围示意图”下方左、右各放一张图，图片按图片区裁切填充，不留白、不越界；“平台最新动态”放到图片区下方，做左右两组 4 列信息表。
+
+快报页沉降、水平位移按 0.1mm 显示，桥墩倾斜按 0.01‰ 显示；完整报表的桥墩倾斜明细页坐标和倾斜计算值保留 5 位小数，并生成桥墩沉降、桥墩水平位移、桥墩倾斜三张曲线图。源 CSV 保留原始计算值用于追溯。若工程师对个别点位/监测项做人工复核修正，不要直接改 Excel 成果；应写入 `manual_metric_overrides.json` 一类的覆盖表，至少包含报表时间、平台点号、报表点号、监测项、方向、本次变化值、累计变化值和原因，再通过 `--manual-overrides` 生成，使平台动态、主表、明细公式、最大值、曲线图和留痕一致。
+
+输出文件名必须使用业务命名并带名义报表日期，不要使用技术型前缀、接口批次时间戳或内部口径词。推荐格式：`{{项目全称}}_{{YYYYMMDD}}_{{名义出报小时}}点_4小时快报.xlsx`，例如 `绕城高速管廊工程1标段施工期间轨道交通3号线控制保护区监测项目_20260605_00点_4小时快报.xlsx`；PDF 同名，仅扩展名改为 `.pdf`。其中日期和小时均按报表名义截止时间取值，不按实际触发时间或平台批次时间取值。
+
+默认情况下，脚本要求每行提供 `warning_threshold_mm`、`alarm_threshold_mm`、`control_threshold_mm`。若经项目确认可沿用通用默认阈值，再加 `--allow-inferred-thresholds`。
+
+## 计算规则
+
+- `本次变化量/日变量`：本期名义报表窗口对应的平台成果减上期名义报表窗口对应的平台成果。上期不一定是平台上一条平差批次，应按 `--previous-report-cutoff-time` 锁定上期报表窗口。
+- `累计变化量`：当前项目按工程师表坐标公式计算，沉降为 `本次Z-初值Z`，水平位移为 `本次Y-初值Y`；平台累计 `dX/dY/dH` 用于反推并校核自动化初值。单次变化为 `本次平差坐标-上期平差坐标`，补跑时要锁定上期实际平差批次。
+- `本次最大`：同一分区、同一监测项内，本次变化量绝对值最大的点。
+- `累计最大`：同一分区、同一监测项内，累计变化量绝对值最大的点。
+- `变化速率`：优先使用源表给出的速率；无速率时按本项目频率和时间差计算，单位必须说明。
+- 水平位移必须沿用本项目正方向；如果源表只有坐标差，先按项目方向轴转换再填报。
+- 水平收敛必须明确是成对点差值或系统已计算成果，不能用单点水平位移代替。
+
+## 表格字段
+
+参考样例下部数据表常用结构：
+
+| 栏目 | 说明 |
+|---|---|
+| 桩号及位置/位置 | 环号、里程、结构区段或点位位置 |
+| 监测点号 | 点号，如 S763、X765 |
+| 道床沉降 | 本次变量、总累计值、备注 |
+| 结构沉降 | 本次变量、总累计值、备注 |
+| 水平位移 | 本次变量、总累计值、备注 |
+| 水平收敛 | 本次变量、总累计值、备注 |
+| 桥墩倾斜率 | 本次倾斜率、累计倾斜率、上下测点初始三维距离或配对说明 |
+
+按项目实际监测项增删列。没有的监测项不要留空列；新增监测项可按“本次变量、总累计值、备注”三列扩展。
+
+高架桥墩倾斜率优先使用平台或人工成果中已经给出的 `MCQX/倾斜率` 字段。若平台仅给出 S/X 上下点平差坐标，则按同一桥墩上下测点成对计算，例如 S12/X12、S13/X13。当前项目按工程师公式：单次倾斜 `((本次S点X-上次S点X)-(本次X点X-上次X点X))/上下点初始三维距离×1000`；累计倾斜 `((本次S点X-初始S点X)-(本次X点X-初始X点X))/上下点初始三维距离×1000`。位移单位为 m，结果数值单位为 ‰；正值为北方向偏移，负值为南方向偏移。上下点初始三维距离用平台自动化初值 `X/Y/H` 计算；缺初值时写“初始三维距离待确认”，不得硬算。
+
+点名映射确认后，报表显示点号使用映射点号，源数据追溯仍保留平台原始点号。当前项目报表可见点名不得出现 `S12/X12/S13/X13` 等平台原始点名：沉降显示为 `MCC012/MCC013`，水平位移显示为 `MCW012/MCW013`，且按下部 `X` 点分别填列东西方向和南北方向；倾斜率配对显示为 `MCQX012/MCQX013`，按对应 `S/X` 上下点配对分别计算东西方向和南北方向。
+
+## 版式骨架
+
+使用 `assets/crossing-total-station-report-template.md` 起稿。参考样例通常按以下顺序：
+
+1. 页眉：项目全称。
+2. 一、施工工况：项目关系、线路结构、穿越风险描述。
+3. 二、施工进度：本时段施工推进，写清环号、里程或区域。
+4. 图像区：通栏标题下左、右各放一张图，可用全图 + 局部放大图，或点位/影响范围图 + 现场照片；章节标题不重复分栏。
+5. 平台最新动态：放在图片区下方，左、右各 4 列信息表，包含项目名称、项目实施单位、初始采集、本次/上次、监测方式、平台预警、本次最大、累计最大、倾斜率和说明。
+6. 三、各项数据分析：初值采集时间、上次监测时间、本次监测时间、监测方式。
+7. 数据表：按上行线/下行线、左线/右线、桥面/桥下等分区。
+8. 最大值行：分别列本次最大和累计最大。
+9. 备注：正负号、阈值、速率规则、色标。
+10. 四、结论与评价：数据稳定性、报警状态、施工建议；底部 footer 写项目实施单位和 `轨道交通控制保护区监测快报`，不保留空边框行。
+
+## 色标与备注
+
+- 黄色：当前穿越正投影区或重点影响区段。
+- 绿色：只标记主数据区本次/累计绝对值最大但未报警的数据；“本次最大/累计最大”汇总行只写点号和值，不填绿色。
+- 红色：达到预警、报警、控制值或触发速率/趋势报警。
+- 灰色：非当前重点区、暂停监测区或模板辅助区；必须能解释。
+
+常用备注：
+
+1. 水平位移：“+”为靠近风险源方向，“-”为远离风险源方向；若项目另有定义，以项目说明为准。
+2. 竖向位移：“+”表示隆起，“-”表示下沉。
+3. 收敛：“+”表示扩张，“-”表示收缩；若模板定义相反，按模板。
+4. 预警值、报警值、控制值按本项目方案、安评或运营单位要求填写。
+
+## 结论写法
+
+正常时：
+
+```text
+本时段自动化全站仪监测数据总体平稳，各监测项本次变化量和累计变化量均未达到预警值。后续按 {{15分钟/2小时/4小时}} 频率持续监测，并结合施工推进情况及时复核异常数据。
+```
+
+存在异常但未报警时：
+
+```text
+{{点号}} 本次/累计变化量相对较大，尚未达到预警值。建议继续关注该点及相邻测点趋势，检查现场反射片、视线通视和施工扰动情况。
+```
+
+达到预警或报警时：
+
+```text
+{{点号}} {{监测项}} {{本次/累计/速率}} 达到 {{预警/报警/控制}} 条件，建议立即通知相关单位，开展数据复核、现场巡视和施工参数核查，并按项目要求加密监测或组织专题研判。
+```
+
+## 交付前检查
+
+- 项目名、线路、区间、报告编号、时间均为当前项目。
+- 初值、上次、本次时间完整且前后顺序正确。
+- 表内点号与点位图、影响区段一致。
+- 黄色/绿色/红色标识和备注一致。
+- 本次最大与累计最大分别统计，不能合并。
+- 阈值来源明确；缺阈值时写“待确认阈值”。
+- 缺测、遮挡、离线、异常剔除均有备注。
+- 结论承接数据和施工工况，不写无依据的“良好”。