https://github.com/moderras/moderbox
自用工具箱
https://github.com/moderras/moderbox
comtrade
Last synced: 19 days ago
JSON representation
自用工具箱
- Host: GitHub
- URL: https://github.com/moderras/moderbox
- Owner: ModerRAS
- License: gpl-3.0
- Created: 2024-05-25T15:13:50.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2026-05-15T03:19:04.000Z (about 1 month ago)
- Last Synced: 2026-05-15T03:40:01.967Z (about 1 month ago)
- Topics: comtrade
- Language: C#
- Homepage: https://github.com/ModerRAS/ModerBox
- Size: 86.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# ModerBox
一款现代化、跨平台的电力系统工具箱
查看最新版本
·
报告问题
---
**ModerBox** 是一款专为电力系统工程师和技术人员打造的强大桌面工具箱。它采用 [Avalonia](https://avaloniaui.net/) 框架构建，拥有现代化的 Fluent Design 用户界面，并提供流畅的跨平台体验。
本工具箱集成了多种实用功能，旨在简化和自动化复杂的工程数据处理任务，尤其是针对 **COMTRADE** 格式的录波文件分析。
## ✨ 主要功能
* ⚡️ **批量谐波分析**:
* 能够递归式地批量处理指定文件夹下的所有 COMTRADE 录波文件。
* 自动分析文件中每一个模拟量通道的谐波数据。
* 支持按"周波"或"采样点"两种模式进行高精度计算。
* 📊 **一键导出报告**:
* 将海量的计算结果一键导出为结构化的 Excel 表格，极大地方便了后续的深度分析和报告撰写。
* 🖥️ **现代化 & 跨平台**:
* 基于 Avalonia UI，完美支持 Windows、macOS 和 Linux。
* 界面设计遵循 Fluent Design，美观、直观且易于使用。
* 🧰 **滤波器分合闸波形检测（流式 & 增量续跑）**:
* 扫描 COMTRADE `*.cfg`，CFG 预过滤后按需加载 DAT，降低无效 I/O。
* 计算结果流式写入 SQLite，最终从 SQLite 流式导出 Excel，显著降低内存峰值。
* 内置 processed_files（已读文件表），支持断点/增量续跑：已处理的录波自动跳过。
* 说明文档：`Docs/滤波器分合闸波形检测-流式SQLite与增量处理.md`
* 🔌 **电缆走向自动化绘制**:
* 根据配置文件自动规划最优电缆路由，采用 Dijkstra 算法计算观测点间最短路径。
* 智能生成 L 型正交连接，支持穿管点成对配置。
* 在终点附近自动放置业务统计表格，支持碰撞检测和位置优先级调整。
* 生成高质量 PNG/JPG 输出，支持自定义底图和样式。
* 说明文档：`Docs/电缆走向绘制功能文档.md`
## 🚀 如何开始
### GUI 版本
使用 ModerBox 非常简单：
1. 前往本仓库的 **[Releases 页面](https://github.com/ModerRAS/ModerBox/releases)**。
2. 下载最新版本的软件包（例如 `ModerBox-win-x64.zip`）。
3. 解压后，直接运行 `ModerBox.exe` 即可启动！
### CLI 版本
ModerBox 同时提供命令行版本，适合自动化脚本和服务器环境：
```bash
# 进入 CLI 项目目录
cd ModerBox.Cli
# 构建项目
dotnet build
# 运行交互模式
dotnet run
# 或使用命令行模式
dotnet run -- harmonic --source "C:\data" --target "C:\result.xlsx"
```
#### CLI 命令列表
| 命令 | 功能 | 用法示例 |
|------|------|----------|
| `harmonic` / `h` | 批量谐波分析 | `ModerBox.Cli h --source "C:\data" --target "result.xlsx"` |
| `filter` / `f` | 滤波器分合闸波形检测 | `ModerBox.Cli f --source "C:\waveforms" --target "output.xlsx"` |
| `current-diff` / `cd` | 接地极电流差值分析 | `ModerBox.Cli cd --source "C:\data" --target "result.csv"` |
| `question-bank` / `qb` | 题库格式转换/合并 | `ModerBox.Cli qb merge --sources "bank1.txt" "bank2.xlsx" --target "merged.xlsx"` |
| `cable` / `c` | 电缆走向绘制 | `ModerBox.Cli c --config "config.json"` |
更多用法请参阅 `ModerBox.Cli/README.md`
## 🛠️ 技术栈
* **[.NET](https://dotnet.microsoft.com/)**
* **[C#](https://docs.microsoft.com/en-us/dotnet/csharp/)**
* **[Avalonia UI](https://avaloniaui.net/)**: 一个用于 .NET 的跨平台 UI 框架。
## 📄 许可证
本项目采用 [GPL-3.0 License](LICENSE) 许可协议。详情请参阅 `LICENSE` 文件。