Add core detection and scheduler adapters

This commit is contained in:
xhgit committed 2026-11-15 10:30:58 +08:00
1 parent f06ad804a5
commit 06a4e67e80
28 files changed
+1440 -2

No files matched your search

+29 -2
View File
@@ -1,3 +1,30 @@
# ItxiaohuiContentGuard
# ItxiaohuiContentGuard · 小慧内容卫士
Minecraft Java 1.21.x 多核心智能内容审核插件,兼容 Paper、Purpur、Spigot、Folia、Leaves,支持本地敏感词过滤、AI 智能审核、SMTP 邮件告警及 SQLite 违规记录,自动识别服务端核心并适配调度器。
面向 Minecraft Java 1.21.x 的服务端内容审核插件。当前阶段提供 Java 21 构建、核心识别、调度适配和实服兼容探针。聊天、书本、AI、SMTP 和 SQLite 审核将在后续阶段提交。
## 兼容适配
- 启动时核对服务端品牌、构建版本和调度 API 能力。`/icg info` 输出检测结果和已选适配器。
- Spigot 使用 Bukkit 调度器。Paper、Purpur、Leaves 在原生接口完整时使用 Paper 调度器。
- Folia 将全局、区块、实体和异步任务提交到对应的原生调度器。实体任务处理失效、取消和停用。
- 未知核心按 API 能力检测。识别到原生调度能力却缺少完整接口时会记录失败并停用插件。
## 构建
需要 Java 21。Windows 使用以下命令,其他系统使用 `./gradlew`。
```powershell
.\gradlew.bat build compatProbeJar
```
## 复现实服探针
1. 使用 `python scripts/fetch-servers.py --download --version 1.21.8` 获取 Paper、Purpur、Folia 和 Leaves。使用 `python scripts/build-spigot.py --java <java路径> --version 1.21.8` 编译 Spigot。
2. 每个核心采用独立的工作目录、服务端、配置、世界与日志。测试服监听回环地址。
3. 将 `build/libs/ItxiaohuiContentGuard-0.1.0-dev.jar` 和 `build/libs/ItxiaohuiContentGuard-0.1.0-dev-compat-probe.jar` 装到测试实例的 `plugins` 目录。
4. 启动后从控制台运行 `icg info` 和 `icgprobe`。通过客户端登录以触发实体调度与取消。Folia 探针同时检查全局线程与区块权属。
5. 正常关服并在同一实例目录重启。核对 `ICG_LIFECYCLE scheduler=closed`、核心信息和 `ICG_PROBE` 各项结果。
协议客户端测试可使用 Node.js 和固定版本 `minecraft-protocol@1.68.0`。运行 `node scripts/compat-client.cjs <minecraft-protocol 的绝对模块路径> <端口> 1.21.8`。
每个核心和小版本都需要完整功能、压力、故障与稳定性证据后才会标记为正式兼容。