2025-09-26阶段性成果整理
工程安全、时序预测与统计分析模块的阶段性梳理与文档汇总
2025/9/26
背景与目标
最近围绕“工程安全评估、时序预测建模与统计分析”三大方向，完成模型接口梳理、站点文档规范化与页面接入，便于统一展示与后续对外发布。
已完成工作
1) 模型 API 文档整理（12 篇）
- 工程安全（小型水库，按坝型拆分）
- 拱坝：
Model_小型水库工程安全_拱坝稳定性.mdx - 土石坝：
Model_小型水库工程安全_土石坝稳定性.mdx - 重力坝：
Model_小型水库工程安全_重力坝抗滑稳定性.mdx
- 拱坝：
- 时序预测（深度学习）
- LSTM：
Model1_长短期神经网络LSTM.mdx - BiLSTM：
Model_BiLSTM时序预测.mdx - CNN-LSTM：
Model_CNN-LSTM时序预测.mdx - CNN-LSTM-Attention：
Model_CNN-LSTM-Attention时序预测.mdx
- LSTM：
- 统计分析与阈值计算
- AHP 综合权重：
Model_AHP综合权重计算.mdx - 置信区间阈值：
Model_置信区间阈值计算.mdx - 小概率法阈值：
Model_小概率法阈值计算.mdx
- AHP 综合权重：
上述文档均采用统一前言/作用/调用方式（输入/输出示例）的结构，并在站点 API 列表页自动收录。
2) 工程安全模块梳理（按坝型）
- 拱坝稳定性
- 接口：
POST /gongba/calculate-stability - 输入：几何参数、材料参数、水位列表
- 输出：各水位下稳定性系数（K1/K2）
- 接口：
- 土石坝稳定性（Bishop 圆弧滑动）
- 接口：
POST /tushiba/api/stability-analysis - 输入：坝体参数、土层参数、上下游水位、分块数
- 输出：安全系数、潜在滑弧圆心/半径
- 接口：
- 重力坝抗滑稳定性
- 接口：
POST /zhongliba/calculate - 输入：坝体几何、材料摩阻参数、上下游水位
- 输出：受力分量、抗滑稳定系数 K、K’、不利工况摘要
- 接口：
3) 时序预测服务（通用特性）
- 模型族：LSTM / BiLSTM / CNN-LSTM / CNN-LSTM-Attention
- 接口：
- 训练：
POST /train（异步，提供training-status查询） - 预测：
POST /predict（基于外部特征 + 目标滞后特征，滑窗迭代） - 训练状态：
GET /training-status/{task_id} - 模型管理：
GET /models、DELETE /models/{model_id}、GET /model/{model_id}/loss-curve - 健康检查：
GET /health
- 训练：
- 说明：统一支持 Dropout、早停、损失函数/优化器可选、验证集评估与模型产物持久化。
补充：XGBoost 已完成离线批量评测（含多次批处理日志与指标输出、模型与特征缩放器持久化），当前尚未服务化暴露 API；待服务化后，将补充对应 MDX 文档与接口说明。
5) 统计分析工具
- AHP 综合权重：计算 B/C 层权重并进行一致性检验（
CR<0.1） - 置信区间阈值：基于回归残差标准差输出 95% 上限阈值
- 小概率法阈值：多分布拟合 + K-S 检验，按给定概率返回上侧阈值
- 多元线性回归：回归方程、系数、R²/MAE/RMSE 及残差明细
部署与调试要点（摘）
- 时序预测服务：默认容器内运行
8000，对外常见映射8060（示例）；访问/docs获取交互文档 - 小型水库模块：统一入口端口示例
8050，支持/health与/modules/health