# energy-storage-software

**Repository Path**: git_mystore/energy-storage-software

## Basic Information

- **Project Name**: energy-storage-software
- **Description**: 用户侧储能辨识模型应用及结果分析
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 储能负荷分析桌面软件

Windows 中文桌面应用：批量导入 96 点负荷曲线、调用已有学生模型、按户汇总、核实正确/错误、查看关键时段解释、导出 Excel 和曲线图片。所有负荷和模型推理均在本地处理。

## 启动

推荐发送并安装 `dist/installers/StorageInsight-Setup-1.1.0-x64.exe`，安装后从桌面或开始菜单启动。适用于 Windows 11 64 位，无需 Python，默认仅安装到当前用户。

免安装版可双击根目录 `启动软件.cmd`，优先运行已打包程序。也可直接启动 `dist/StorageInsight/StorageInsight.exe`。

源码运行：安装 Python 3.13，执行 `python -m pip install -r requirements.txt`，再执行 `python scripts/launch.py`。现有模型须位于 `adding_problem/train_student/best_model_student.pt`。模型和真实负荷数据不提交到 Git；新克隆仓库需由项目维护者通过受控渠道补齐权重。

## 文件布局

| 路径 | 用途 |
|---|---|
| `src/storage_inspector/` | 桌面界面、分析服务、曲线绘图 |
| `adding_problem/`、`tcn.py` | 保留的研究代码、原有模型结构与推理逻辑 |
| `scripts/` | 启动、打包和验证脚本 |
| `packaging/` | 可版本管理的打包配置 |
| `tests/` | 数据与模型行为测试 |
| `docs/` | 使用说明和验证记录 |
| `outputs/` | 本机测试结果、截图、导出文件（忽略） |
| `build/`、`dist/` | 构建临时文件与可分发软件（忽略） |

使用步骤、输入格式、评价口径见 [使用说明](docs/使用说明.md)。

## 打包和测试

```powershell
python -m pip install -r requirements-build.txt
powershell -ExecutionPolicy Bypass -File scripts/build.ps1
powershell -ExecutionPolicy Bypass -File scripts/build-installer.ps1
python -m unittest discover -s tests -v
```

安装包编译需要 Inno Setup 6.5+，可用 `-CompilerPath` 指定编译器。编译脚本同时生成 SHA-256 校验文件。安装包包含模型与运行库，不包含原始负荷数据；无需发送源码或整个工作区。免安装分发请复制完整 `dist/StorageInsight/` 文件夹，不能单独复制其中的 exe。PyTorch 运行库使软件较大。

1.1.0 界面采用已选定的方案 3：浅色报告工作台、森林绿配色、上方统计、中间曲线与核实结论、下方用户明细。设计参考与检查记录统一位于 `docs/design/`。

`.gitignore` 排除原始数据、模型权重、训练输出、依赖环境、缓存和导出结果。它不会移除已被 Git 跟踪的文件；如旧仓库已跟踪敏感数据，需要另行清理索引和历史。