详细介绍

ArkOps-Ai Console Monitoring Skill

监控 Minecraft Purpur 控制台的警告和报错，自动分析错误并给出修复建议，支持通过 NapCatQQSkill 发送通知。

功能概览

功能	说明
实时监控	拦截控制台 WARNING 和 SEVERE 级别的日志
智能分类	自动识别 14 种常见错误类型(内存不足、插件异常、服务器卡顿等)
修复建议	每种错误类型都有对应的排查和修复建议
错误缓冲	缓存最近 200 条错误记录供 AI 查询
QQ 通知	检测到严重错误时自动通过 NapCatQQSkill 通知管理员群
统计报表	按错误类型和等级生成分布统计

快速开始

1. 编译

cd console-monitoring
mvn clean package

2. 部署

将 target/ConsoleMonitoringSkill-1.0.0.jar 复制到服务器:

plugins/ArkOps-Ai/skills/

3. 配置 (可选)

配置文件路径: plugins/ArkOps-Ai/skills/console_monitoring.yml

要启用 QQ 通知功能:

qq_notification:
  enabled: true
  admin_group_id: "你的管理群号"
  admin_qq_ids:
    - "管理员QQ号1"
    - "管理员QQ号2"
  notify_level: "ERROR"

4. 验证

重启服务器后看到以下日志即表示成功:

[ConsoleMonitoring] 控制台监控 Skill 已启用
[ConsoleMonitoring] 缓冲区大小: 200
[ConsoleMonitoring] QQ通知: 已启用/未启用

工具列表

get_recent_errors

获取最近的控制台错误/警告记录。

参数	类型	必填	说明
count	number	否	获取数量(默认20，最大100)
level	string	否	过滤等级: WARNING, ERROR, ALL(默认ALL)

analyze_error

分析特定错误条目的详细信息并获取修复建议。

参数	类型	必填	说明
error_index	number	是	错误索引号(0-based)

get_error_statistics

获取按分类和等级分布的错误统计报告。

clear_error_log

清除缓冲区中的所有错误记录。需要 SUPER_ADMIN 权限。

check_qq_notification_status

检查 QQ 通知功能的配置和运行状态。

send_test_alert

发送一条测试告警到管理群。需要 SUPER_ADMIN 权限。

错误分类

分类	说明
内存不足	OutOfMemoryError，堆内存耗尽
服务器卡顿	Can't keep up，TPS 低于正常值
插件异常	插件触发异常或事件处理错误
连接错误	玩家连接断开、超时
世界/区块错误	区块加载/保存失败
实体错误	实体 UUID 重复等
线程死锁	服务器线程死锁(严重)
磁盘IO错误	磁盘空间不足或读写失败
配置错误	插件配置文件格式错误
权限错误	权限系统配置问题
启动错误	服务器启动失败
命令执行错误	命令执行异常
网络错误	网络协议/数据包问题
未知错误	其他未分类的错误

权限说明

工具	需要权限
get_recent_errors	ADMIN
analyze_error	ADMIN
get_error_statistics	ADMIN
clear_error_log	SUPER_ADMIN
check_qq_notification_status	SUPER_ADMIN
send_test_alert	SUPER_ADMIN

依赖

ArkOps-Ai >= 2.0.0
Paper/Purpur >= 1.21
NapCatQQSkill (可选，用于 QQ 通知)

使用示例

在游戏或 QQ 中:

@ops 查看最近的错误
@ops 分析第0条错误
@ops 服务器有什么问题吗
@ops 检查QQ通知状态
@ops 发送测试告警

Console Monitoring Skill