侦探

你的整合包卡住了。Detective 会向你展示当时正在发生什么。

Detective 是一个用于 Minecraft 的客户端诊断模组，它会记录卡顿和渲染线程性能停滞时的证据，然后帮助你理解问题发生时正在发生的事情。

检测。衡量。解释。绝不指责。

Detective 不会简单地指出某个模组并宣称它负有责任。它会在停滞期间对渲染线程进行采样，保留附近的性能历史，对捕获到的最强证据进行排名，并在结果模糊、证据不足或可能与系统相关时清晰地传达这一信息。

自动卡顿检测

Detective 会在后台监控活跃的游戏过程，并使用自适应检测阈值自动记录有意义的性能停滞。

黑匣子

在每一个检测到的事件周围，Detective 都会保留大约 30 秒的附近性能上下文，包括帧时间历史、JVM 内存使用情况、维度和玩家位置。这使得查看卡顿之前、期间和之后发生的事情成为可能。

基于证据的归因

当捕获到的证据支持归因时，Detective 可以呈现一个首要嫌疑人，并附上技术证据，例如叶节点所有权、堆栈存在性和捕获的样本数量。

首要嫌疑人并不是模组存在缺陷或负全部责任的证明。配置、游戏状态、另一个模组或组件之间的交互也可能有关系。

模糊归因

当多个模组的可能性相似时，Detective 拒绝任意选择一个。相反，它会报告一个模糊的归因并显示可用的证据。

整合包更改

Detective 会比较每次启动时记录的模组快照，并显示新增、更新或移除的模组，帮助你在更改整合包后调查性能回退问题。

支持报告

生成一份轻量级的本地支持报告，可在故障排查时与模组开发者或整合包作者分享。

报告在本地生成。不会自动上传任何内容。

Detective 不包含遥测、分析、自动上传或远程 API 调用。标准支持报告不会自动包含 latest.log。

仅客户端

Detective 只需要安装在客户端。服务器不需要安装 Detective。

要求

Minecraft 1.21.1
NeoForge 21.1.235 或更新版本（21.1.x 系列）
Java 21

NeoForge 21.1.248 是推荐的测试运行版本。

早期 Alpha

Detective 的核心检测、归因、UI 和支持报告系统已经过验证，包括对 257 个加载模组 ID 的兼容性冒烟测试。

在非常大的整合包上进行长时间验证仍在进行中。在这个早期 Alpha 阶段，欢迎反馈意外行为。

隐私

Detective 将其诊断数据存储在本地。在分享任何支持报告之前，请像处理任何其他诊断文件一样，先进行审查。

源代码与问题追踪器

GitHub：<code><a href="https://github.com/blueez93/Detective" target="_blank" rel="nofollow">https://github.com/blueez93/Detective</a></code>

Detective 负责寻找证据。由你来做出判断。