# sgwave2

**Repository Path**: sg185/sgwave2

## Basic Information

- **Project Name**: sgwave2
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 原生负载预测系统 v4.0

## 项目概述

本项目实现原生负载预测系统，主要功能包括：
- 数据获取与清洗
- 特征工程（时间编码、滞后特征、滚动统计）
- 模型训练（LightGBM基线）
- 滚动预测（5轮）
- 评估与可视化
- 数据泄露检查
- AI Agent角色管理

## 技术栈

- Python 3.8+
- LightGBM
- pandas/numpy/scipy
- matplotlib
- MySQL

## 目录结构

```
sgwave2/
├── src/              # 预测工程
│   ├── main.py       # 主入口
│   ├── config/       # 配置文件
│   ├── utils/        # 工具模块
│   ├── data/         # 数据处理
│   ├── features/     # 特征工程
│   ├── models/       # 模型模块
│   ├── evaluation/   # 评估模块
│   └── pipeline/     # 流水线
├── role/             # AI Agent角色
├── data/             # 数据留痕（清洗/特征/模型/评估）
└── doc/              # 设计文档
```

## 快速开始

```bash
# 运行滚动预测
python src/main.py <设备编码>

# 示例
python src/main.py 11010100001
```

## 滚动预测流程

| 轮次 | 训练数据 | 预测日期 |
|------|---------|---------|
| 1 | 4月28日-5月28日 | 5月29日 |
| 2 | 4月29日-5月29日 | 5月30日 |
| 3 | 4月30日-5月30日 | 5月31日 |
| 4 | 5月1日-5月31日 | 6月1日 |
| 5 | 5月2日-6月1日 | 6月2日 |

## 特征说明

- 时间周期编码（小时、星期）
- 历史负载滞后特征（1, 2, 4, 8, 16, 48, 96步）
- 滚动统计特征（均值、最大、最小、标准差）
- 电价特征（可选）

## 模型

- LightGBM（MAE损失）
- 参数自动调优支持

## 数据留痕

所有中间数据、模型、评估结果均带版本标记保存至 `data/` 目录。

## 数据泄露防护

- 时间重叠检查（训练/验证/测试集严格按时间顺序）
- 未来信息检查
- 滞后特征检查
- 滚动特征检查

## AI Agent角色

| 角色 | 职责 |
|------|------|
| DataSteward | 数据获取与清洗 |
| ModelArtisan | 模型训练与调优 |
| Forecaster | 执行预测 |
| Evaluator | 评估预测精度 |
| Diagnoser | 分析误差原因 |
| QualityInspector | 质量把关 |
| Orchestrator | 协调调度 |
| LeakageChecker | 数据泄露检查 |

## 最后更新

2026-06-02 11:45:13

## License

MIT