技术文档
详细技术数据与使用说明
项目文件清单
C# 源代码文件（26个）
Models（2个）
文件 行数 大小 说明
SettingsModel.cs ~340 行 12.1 KB 全局配置模型，包含 15 个子类
VersionInfo.cs ~10 行 0.3 KB 版本信息模型
Services（18个）
文件 行数 大小 说明
ServerProcessService.cs ~410 行 15.6 KB Java 进程管理
WebServerService.cs ~630 行 22.4 KB 内置 HTTP 服务器 + 18 个 API
MainWindow.xaml.cs ~2250 行 86.3 KB 主窗口逻辑（核心文件）
BackupService.cs ~250 行 9.8 KB 备份与回档
LogMonitorService.cs ~190 行 7.2 KB 日志监控
DiagnosticService.cs ~240 行 8.9 KB AI + 本地规则诊断
EmailAlertService.cs ~280 行 10.1 KB SMTP 邮件
BanlistService.cs ~340 行 12.5 KB 黑名单管理
TimedCommandService.cs ~250 行 8.8 KB 定时命令
RconService.cs ~240 行 8.5 KB RCON 协议
AIServerConfigService.cs ~230 行 7.8 KB AI 配置助手
PlayerTrackerService.cs ~200 行 7.3 KB 玩家追踪
PlayerProfileService.cs ~210 行 7.6 KB 玩家档案
DailyAnalysisService.cs ~200 行 6.9 KB 定时报告
MemoryGuardService.cs ~90 行 3.1 KB 内存守护
UpdateService.cs ~40 行 1.3 KB 更新检测
ModManagerService.cs ~180 行 6.7 KB Mod 管理
WhitelistService.cs ~210 行 7.2 KB 白名单管理
新增服务（3个）
文件 行数 大小 说明
DeviceAuthService.cs ~50 行 1.8 KB 设备白名单持久化
PlayTimeService.cs ~150 行 5.2 KB 玩家游玩时长
UpdateServerService.cs ~400 行 14.5 KB 在线更新服务
Utils（2个）
文件 行数 大小 说明
ZipHelper.cs ~270 行 9.6 KB ZIP 压缩解压
CryptoHelper.cs ~50 行 1.6 KB AES/RSA 加密
其他（2个）
文件 行数 大小 说明
App.xaml.cs ~140 行 5.1 KB 应用入口
FirstRunWindow.xaml.cs ~130 行 4.7 KB 首次配置
XAML 界面文件（5个）
文件 行数 大小 说明
MainWindow.xaml ~260 行 9.8 KB 主窗口布局
FirstRunWindow.xaml ~180 行 6.4 KB 首次配置窗口
TimedCommandsWindow.xaml ~60 行 2.2 KB 定时命令窗口
WebConfigWindow.xaml ~50 行 1.8 KB Web 配置窗口
App.xaml ~10 行 0.3 KB 应用资源
Web 前端文件（2个）
文件 行数 大小 说明
login.html ~55 行 2.0 KB 登录页面
dashboard.html ~250 行 15.8 KB 仪表盘页面
配置文件（6个）
文件 格式 说明
NLog.config XML 日志配置（3 个 target）
app.manifest XML 管理员权限声明
admin.key XML RSA 密钥对
version.json JSON 版本号存储
update_config.json JSON 更新地址配置
MinecraftServerManager.csproj XML 项目构建配置
代码统计明细
类别 文件数 总行数 总大小
C# 后端代码 25 ~5,960 ~219 KB
XAML 界面 5 ~560 ~21 KB
HTML/JS 2 ~305 ~18 KB
配置文件 6 ~80 ~5 KB
合计 38 ~6,905 ~263 KB
功能模块统计
模块 API 端点 服务方法 UI 按钮
服务器控制 3 5 3
Web 管理 18 25 1
玩家管理 3 8 2
备份回档 3 4 2
定时命令 2 6 1
AI 功能 4 3 1
白名单 2 3 1
黑名单 2 4 1
Mod 管理 2 2 1
日志监控 2 3 0
邮件告警 0 3 0
在线更新 0 5 2
崩溃诊断 0 4 0
合计 41 75 15
API 端点完整列表
端点 方法 用途
/api/status GET 服务器状态
/api/start GET 启动服务器
/api/stop GET 停止服务器
/api/command POST 发送命令
/api/logs GET 软件日志
/api/serverlog GET 游戏日志
/api/players GET 在线玩家
/api/timedcommands GET/POST 定时命令
/api/backups GET 备份列表
/api/backupnow GET 立即备份
/api/rollback POST 回档
/api/whitelist GET/POST 白名单管理
/api/banlist GET/POST 黑名单管理
/api/mods GET/POST Mod 管理
/api/profiles GET 玩家档案
/api/settings GET/POST 设置管理
/api/modpacks GET 整合包列表
/api/ai/ask POST AI 问答
/api/ai/analyze POST AI 日志分析
/api/ai/sessions GET 对话列表
/api/ai/session GET 对话消息
/api/login POST 登录
/api/logout GET 登出
NuGet 依赖
包名 版本 大小 用途
Newtonsoft.Json 13.0.4 721 KB JSON 序列化
NLog 6.1.3 929 KB 日志框架
Autoupdater.NET.Official 4.0.1 272 KB 在线更新
.NET Framework 系统引用
程序集 用途
System 基础类型
System.Core LINQ
System.Drawing 图标/图像
System.IO.Compression ZIP 操作
System.Net.Http HTTP 请求
System.Security 加密
System.Windows.Forms 托盘图标
System.Xaml WPF 支持
WindowsBase WPF 基础
PresentationCore WPF 核心
PresentationFramework WPF 框架
Microsoft.CSharp 动态类型
Microsoft.VisualBasic 硬件信息
性能指标
指标 值
内存占用（空载） ~80-120 MB
内存占用（含 Java） ~1.5-8 GB（取决于 JVM 设置）
启动时间 ~2-3 秒
Web 面板并发 单线程异步，适合 1-3 管理员
日志轮转 每天自动归档
目录结构
MinecraftServerManager/
├── .csproj, .sln # 项目文件
├── App.xaml/cs # 入口
├── MainWindow.xaml/cs # 主窗口 (2250+ 行)
├── Models/ # 2 个模型文件
├── Services/ # 18 个服务文件
├── Views/ # 4 个视图窗口
├── Utils/ # 2 个工具类
├── wwwroot/pages/ # Web 前端
├── runtime/ # 运行环境
├── config/ # 配置（运行时生成）
├── adminuser/ # 设备白名单
├── chathistory/ # AI 对话记录
├── timeuser/ # 玩家时长
├── Software-Log/ # 软件日志
└── Software-Debug/ # 调试日志
C# 源代码文件（26个）
Models（2个）
文件 行数 大小 说明
SettingsModel.cs ~340 行 12.1 KB 全局配置模型，包含 15 个子类
VersionInfo.cs ~10 行 0.3 KB 版本信息模型
Services（18个）
文件 行数 大小 说明
ServerProcessService.cs ~410 行 15.6 KB Java 进程管理
WebServerService.cs ~630 行 22.4 KB 内置 HTTP 服务器 + 18 个 API
MainWindow.xaml.cs ~2250 行 86.3 KB 主窗口逻辑（核心文件）
BackupService.cs ~250 行 9.8 KB 备份与回档
LogMonitorService.cs ~190 行 7.2 KB 日志监控
DiagnosticService.cs ~240 行 8.9 KB AI + 本地规则诊断
EmailAlertService.cs ~280 行 10.1 KB SMTP 邮件
BanlistService.cs ~340 行 12.5 KB 黑名单管理
TimedCommandService.cs ~250 行 8.8 KB 定时命令
RconService.cs ~240 行 8.5 KB RCON 协议
AIServerConfigService.cs ~230 行 7.8 KB AI 配置助手
PlayerTrackerService.cs ~200 行 7.3 KB 玩家追踪
PlayerProfileService.cs ~210 行 7.6 KB 玩家档案
DailyAnalysisService.cs ~200 行 6.9 KB 定时报告
MemoryGuardService.cs ~90 行 3.1 KB 内存守护
UpdateService.cs ~40 行 1.3 KB 更新检测
ModManagerService.cs ~180 行 6.7 KB Mod 管理
WhitelistService.cs ~210 行 7.2 KB 白名单管理
新增服务（3个）
文件 行数 大小 说明
DeviceAuthService.cs ~50 行 1.8 KB 设备白名单持久化
PlayTimeService.cs ~150 行 5.2 KB 玩家游玩时长
UpdateServerService.cs ~400 行 14.5 KB 在线更新服务
Utils（2个）
文件 行数 大小 说明
ZipHelper.cs ~270 行 9.6 KB ZIP 压缩解压
CryptoHelper.cs ~50 行 1.6 KB AES/RSA 加密
其他（2个）
文件 行数 大小 说明
App.xaml.cs ~140 行 5.1 KB 应用入口
FirstRunWindow.xaml.cs ~130 行 4.7 KB 首次配置
XAML 界面文件（5个）
文件 行数 大小 说明
MainWindow.xaml ~260 行 9.8 KB 主窗口布局
FirstRunWindow.xaml ~180 行 6.4 KB 首次配置窗口
TimedCommandsWindow.xaml ~60 行 2.2 KB 定时命令窗口
WebConfigWindow.xaml ~50 行 1.8 KB Web 配置窗口
App.xaml ~10 行 0.3 KB 应用资源
Web 前端文件（2个）
文件 行数 大小 说明
login.html ~55 行 2.0 KB 登录页面
dashboard.html ~250 行 15.8 KB 仪表盘页面
配置文件（6个）
文件 格式 说明
NLog.config XML 日志配置（3 个 target）
app.manifest XML 管理员权限声明
admin.key XML RSA 密钥对
version.json JSON 版本号存储
update_config.json JSON 更新地址配置
MinecraftServerManager.csproj XML 项目构建配置
代码统计明细
类别 文件数 总行数 总大小
C# 后端代码 25 ~5,960 ~219 KB
XAML 界面 5 ~560 ~21 KB
HTML/JS 2 ~305 ~18 KB
配置文件 6 ~80 ~5 KB
合计 38 ~6,905 ~263 KB
功能模块统计
模块 API 端点 服务方法 UI 按钮
服务器控制 3 5 3
Web 管理 18 25 1
玩家管理 3 8 2
备份回档 3 4 2
定时命令 2 6 1
AI 功能 4 3 1
白名单 2 3 1
黑名单 2 4 1
Mod 管理 2 2 1
日志监控 2 3 0
邮件告警 0 3 0
在线更新 0 5 2
崩溃诊断 0 4 0
合计 41 75 15
API 端点完整列表
端点 方法 用途
/api/status GET 服务器状态
/api/start GET 启动服务器
/api/stop GET 停止服务器
/api/command POST 发送命令
/api/logs GET 软件日志
/api/serverlog GET 游戏日志
/api/players GET 在线玩家
/api/timedcommands GET/POST 定时命令
/api/backups GET 备份列表
/api/backupnow GET 立即备份
/api/rollback POST 回档
/api/whitelist GET/POST 白名单管理
/api/banlist GET/POST 黑名单管理
/api/mods GET/POST Mod 管理
/api/profiles GET 玩家档案
/api/settings GET/POST 设置管理
/api/modpacks GET 整合包列表
/api/ai/ask POST AI 问答
/api/ai/analyze POST AI 日志分析
/api/ai/sessions GET 对话列表
/api/ai/session GET 对话消息
/api/login POST 登录
/api/logout GET 登出
NuGet 依赖
包名 版本 大小 用途
Newtonsoft.Json 13.0.4 721 KB JSON 序列化
NLog 6.1.3 929 KB 日志框架
Autoupdater.NET.Official 4.0.1 272 KB 在线更新
.NET Framework 系统引用
程序集 用途
System 基础类型
System.Core LINQ
System.Drawing 图标/图像
System.IO.Compression ZIP 操作
System.Net.Http HTTP 请求
System.Security 加密
System.Windows.Forms 托盘图标
System.Xaml WPF 支持
WindowsBase WPF 基础
PresentationCore WPF 核心
PresentationFramework WPF 框架
Microsoft.CSharp 动态类型
Microsoft.VisualBasic 硬件信息
性能指标
指标 值
内存占用（空载） ~80-120 MB
内存占用（含 Java） ~1.5-8 GB（取决于 JVM 设置）
启动时间 ~2-3 秒
Web 面板并发 单线程异步，适合 1-3 管理员
日志轮转 每天自动归档
目录结构
MinecraftServerManager/
├── .csproj, .sln # 项目文件
├── App.xaml/cs # 入口
├── MainWindow.xaml/cs # 主窗口 (2250+ 行)
├── Models/ # 2 个模型文件
├── Services/ # 18 个服务文件
├── Views/ # 4 个视图窗口
├── Utils/ # 2 个工具类
├── wwwroot/pages/ # Web 前端
├── runtime/ # 运行环境
├── config/ # 配置（运行时生成）
├── adminuser/ # 设备白名单
├── chathistory/ # AI 对话记录
├── timeuser/ # 玩家时长
├── Software-Log/ # 软件日志
└── Software-Debug/ # 调试日志