Merge pull request '补齐 Folia 8 小时与五核队列饱和验收记录' (#3) from docs/stability-evidence into main

Reviewed-on: #3
This commit was merged in pull request #3.
This commit is contained in:
xhgit committed 2026-11-16 13:56:30 +00:00
commit 3eb255697e
2 files changed
+43 -8

No files matched your search

+18 -2
View File
@@ -1,6 +1,6 @@
# 0.2.0-dev 验收摘要
候选插件 JAR SHA-256 为 `123bcaae28af3c44434c5202d01e8bc0692a4dd94081cdce8af165e796bbc9ca`。完整验收使用独立 Minecraft 服务端和回环协议客户端,Java 为 Microsoft OpenJDK 21.0.13.0.2,运行环境为 Windows 11 x64。
候选插件 JAR SHA-256 为 `123bcaae28af3c44434c5202d01e8bc0692a4dd94081cdce8af165e796bbc9ca`。本次验收使用独立 Minecraft 服务端和回环协议客户端,Java 为 Microsoft OpenJDK 21.0.13.0.2,运行环境为 Windows 11 x64。
## 真实版本矩阵
@@ -20,6 +20,22 @@
- 18 个版本组合验证了原生调度、公开聊天、私聊、书本编辑与签署、AI、SMTP、SQLite、CSV、热重载和原目录重启。各组合完成短时 100 在线并发和故障恢复抽样。
- Folia 1.21.8 实测四个区域的 100 人并发,并覆盖 50 页书本、邮件队列饱和、跨区期间审核、实体失效、离线回调与审核期间热重载。1.21.11 另通过跨区与实体退役专项。
- 额外覆盖 SMTP 直接 TLS、STARTTLS、认证失败、端口拒绝与发送超时。SQLite 空间不足使用实服 SQLite 页数上限模拟,操作系统磁盘配额未测。
- Paper 1.21.8 完成 30 分钟稳定性测试。Purpur 1.21.8 完成 2 小时并发测试,100 个协议客户端发出 95,900 条消息,SQLite 完整性检查为 `ok`。Folia 8 小时稳定性按本摘要记录时仍在执行。
- Paper 1.21.8 完成 30 分钟稳定性测试。Purpur 1.21.8 完成 2 小时并发测试,100 个协议客户端发出 95,900 条消息,SQLite 完整性检查为 `ok`。
- Folia 1.21.8 的 8 小时稳定性于 2026 年 11 月 15 日 17:56(UTC+8)通过。10 个协议客户端全程在线,发出 38,370 条聊天和 10 次书本提交。Java 正常退出,SQLite 的 `PRAGMA integrity_check` 返回 `ok`。Java 进程热身后与尾段 RSS 中位数分别为 1,488 和 1,504 MiB,首小时去除前 5 分钟与最后一小时的年轻代 GC 后堆占用中位数分别为 417 和 400 MiB。
- 8 小时负载注入了 AI 超时,STRICT 审核下观察客户端收到 6,417 条聊天。AI 正常响应的独立对照中,Folia 和 Spigot 1.21.8 各用 100 个客户端发出 7,200 条聊天,观察客户端分别收到 7,200 条。
## 1.21.8 队列饱和
五种核心的实服结果均记录到 AI 和 SMTP `QUEUE_FULL`。以下为各自达到上限的场景所记录的拒绝次数。Leaves 分别使用多页书本负载和邮件洪峰取得两项记录。涉及的测试轮均以 100 个客户端起止、进程退出码 0、SQLite 完整性为 `ok` 结束。
| 核心 | AI 队列满拒绝 | SMTP 队列满拒绝 |
|---|---:|---:|
| Paper | 48 | 170 |
| Purpur | 48 | 169 |
| Spigot | 48 | 41 |
| Folia | 48 | 167 |
| Leaves | 48 | 170 |
正式发布仍等候逐版本专项故障交叉验证。Folia 1.21.1 和 Leaves 1.21.11 保持未测。
[复现命令](兼容架构.md)会将可审阅的原始日志、逐版本报告、指标和 JAR 摘要写到本地 `test-results/`。
+25 -6
View File
@@ -146,14 +146,23 @@ def report():
"Spigot 缺少相同的 Bukkit 指标接口。每次运行另保存 RSS、线程、GC、AI/SMTP 队列和数据库操作耗时采样。"])
paragraphs.extend(["", "## 长时间稳定性", ""])
for tag, label in (("stability-30m", "30 分钟"), ("stability-2h", "2 小时"), ("stability-8h", "8 小时")):
manifests = sorted(RESULTS.glob(f"*/*/{tag}-*/run.json"), reverse=True)
manifests = sorted(
(path for path in RESULTS.glob(f"*/*/{tag}-*/run.json") if jread(path).get("jar_sha256") == sha),
reverse=True,
)
manifest = manifests[0] if manifests else None
if manifest:
config = jread(manifest)
final = manifest.with_name("evidence.json")
if final.is_file():
outcome = jread(final)
outcome = jread(final) if final.is_file() else {}
if outcome.get("jar_sha256") == sha:
status = f'已结束 · {outcome["online_and_integrity_check"]}'
if outcome["cases"]:
case = outcome["cases"][0]
status += (f' · 负载 {case["durationMs"] / 1000:,.1f} 秒'
f' · 在线起止 {case["online"]}/{case["onlineAfter"]}'
f' · 发出 {case["messagesSent"]:,} 条聊天'
f' · SQLite `{outcome["db_after_stop"].get("integrity", "缺失")}`')
samples = [json.loads(line) for line in manifest.with_name("samples.jsonl")
.read_text(encoding="utf-8").splitlines()]
if len(samples) >= 10:
@@ -199,12 +208,22 @@ def report():
):
if (RESULTS / directory / "summary.md").is_file():
paragraphs.append(f"- [{title}]({directory}/summary.md)")
for prefix, title in (("rich-books", "50 页书本并发"), ("smtp-queue", "SMTP 邮件队列饱和")):
for prefix, title in (("rich-books", "50 页书本并发"), ("smtp-queue", "SMTP 邮件队列饱和"),
("healthy-provider", "AI 正常响应下的聊天送达")):
for file in sorted(RESULTS.glob(f"*/*/{prefix}-*/evidence.json")):
outcome = jread(file)
if outcome.get("jar_sha256") == sha:
link = file.with_name("stress-report.html").relative_to(RESULTS).as_posix()
paragraphs.append(f'- [{outcome["core"]} {title} · {outcome["online_and_integrity_check"]}]({link})')
details = ""
if prefix == "healthy-provider" and outcome["cases"]:
case = outcome["cases"][-1]
details = f' · 观察客户端收到 {case["firstClientObservedDeliveries"]:,}/{case["messagesSent"]:,} 条'
if prefix in ("smtp-queue", "rich-books"):
db = outcome["db_after_stop"]
ai_full = db.get("ai_failures", {}).get("QUEUE_FULL", 0)
smtp_full = db.get("mail_status", {}).get("QUEUE_FULL", 0)
details = f" · 队列满拒绝 AI {ai_full:,} / SMTP {smtp_full:,} 次"
paragraphs.append(f'- [{outcome["core"]} {title} · {outcome["online_and_integrity_check"]}{details}]({link})')
paragraphs.extend(["", "## 修复与复测", "",
"- Windows 控制台日志转码影响关闭标记。改用固定 ASCII 标记后复测自动关闭、重启。",
"- Spigot 新版正式构建返回包含 `-Spigot-` 的构建串。修复识别并补回归用例,四个小版本重测。",
@@ -213,7 +232,7 @@ def report():
"- Folia 首轮 100 并发仅 98 个进入游戏,并且测试探针在加入事件中调用传送失败。提高测试服容量并在玩家实体调度器运行传送,保留前两轮完整证据。",
"- 多轮失败与修复过程见各版本 `previous/` 或独立压力运行目录。",
"", "## 发布门禁余项", "",
"- 逐核心、逐版本的专项故障完整矩阵,以及所有队列满载、长时间内存趋势仍待完整证据。",
"- 逐核心、逐版本的专项故障与队列饱和完整交叉矩阵仍有未覆盖项。三个长时间场景均有各自的采样和结果。",
"- 磁盘空间不足使用探针对真实 SQLite 连接设置页数上限模拟。操作系统级磁盘配额未测试。",
"- 短时书本压测记录协议提交量与实际 Bukkit 事件数。Minecraft 自身的校验、频控及已签署物品会挡住部分重复提交。",
"- 超协议长度的聊天与书本标题由服务端解码器拒绝。协议边界报告保留预期断开原因与 Bukkit 实际收到的首个书本事件。",