延迟尖峰日记

卡顿日志

📋 描述

卡顿日志是用于诊断 Minecraft 卡顿的“黑匣子”。该模组会自动追踪 FPS 冻结和 TPS 尖峰，保存详细报告，并提供一种便捷方式，将诊断信息快速附加到问题报告中。

🎯 主要功能

• 自动冻结检测 — 实时监控 FPS 和帧时间
• 上下文收集 — 保存尖峰前后的坐标、维度、速度和其他信息
• 详细报告 — 生成包含系统、模组和事件完整信息的 JSON 文件
• 用户友好界面 — 暂停菜单按钮和快捷键，方便快速访问
• 与 Spark 集成 — 如果安装了 Spark 模组，会显示提示

🚀 快速开始

1. 将模组安装到 mods/ 文件夹
2. 启动游戏 — 模组会自动运行
3. 发生卡顿时，打开暂停菜单（ESC）并点击“报告上次尖峰”
4. 将生成的报告发送给开发者

⚙️ 设置

所有设置都在文件 config/lag_spike_diary.json 中：

• frameSpikeMsThreshold（150）— 帧时间阈值，单位为毫秒
• contextBufferSeconds（10）— 保留多少秒的上下文
• maxReports（20）— 磁盘上的最大报告数量
• autoNotifyOnSpike（true）— 在聊天中显示通知

🎮 管理

• 暂停菜单中的按钮位于右下角
• 快捷键 — 可在“控制” → “卡顿日志” → “报告上次尖峰”中配置
• 命令 /testspike — 用于测试模组（创建人工卡顿）

📄 报告

报告保存在配置文件旁的 lag_spike_reports/ 文件夹中。每份报告包含：

• summary.json — 尖峰摘要（FPS、帧时间、时间）
• timeline.json — 尖峰前后的事件时间线
• environment.json — 系统信息（Java、操作系统、Minecraft 版本）
• mods.json — 所有已安装模组的列表

🌍 语言

该模组支持：

• 英语（默认）
• 俄语

🔧 技术细节

• 性能影响极小 — 数据收集非常轻量
• 自动清理 — 旧报告会自动删除
• 兼容性 — 可与大型整合包配合使用，不与其他模组冲突

---

注意： 本模组不能替代 Spark 作为完整的性能分析器。它专注于用户友好性和为开发者快速创建报告。