[CTL] 平息泄漏

Calm The Leaks

---

通过完整的游戏内诊断 GUI 改进诊断体验——按 F8 或运行 /ctl panel 即可打开。

Calm The Leaks 是 AllTheLeaks 的伴侣模组，用于过滤误报并提供智能泄漏分析。它不会取代 ATL——而是与 ATL 协同工作，让输出更易于人类理解与诊断。

---

它的作用： CTL 会拦截 ATL 的泄漏报告并结合上下文进行评估。它会抑制误报，例如领地模组导致的稳定区块保留、启动噪音以及过渡性误报。真正的泄漏仍然会被报告，但现在会附带关于泄漏原因及修复方法的实际说明。

该模组会实时分析你的整合包，以识别哪些模组可能导致泄漏。它会随时间积累置信度，并且只有在相当确定原因时才会建议修复方案。如果你安装了 Spark，CTL 可以在泄漏看起来严重时触发性能分析（可配置）；GUI 中显示的堆内存百分比来自 JVM。

---

工作原理： CTL 会跟踪 ATL 报告的每一个泄漏，但不会立即发出警报。相反，它会观察模式：泄漏是否在增长？是否稳定？是否与特定模组相关？它会考虑服务器阶段（启动、预热、运行中），并且只有在确实存在问题时才会升级警报。

检测到泄漏时，CTL 会分析你安装的模组以识别可能的元凶。它会排查模组冲突、检查内存压力，并随时间监控趋势。收集的数据越多，其建议的置信度就越高。

---

使用方法： 只需将它与 AllTheLeaks 一起安装即可。CTL 会自动拦截 ATL 的输出并进行过滤。

按 F8 或使用 /ctl panel 打开诊断 GUI。“指南与使用方法”选项卡会解释 CTL 并显示服务器快照；“跟踪的泄漏”选项卡会列出泄漏——点击某一行即可查看完整诊断。管理员可以可选地从指南选项卡启用世界泄漏内存监控，或在更改模组时打开收窄工具包以进行快照/对比（测试之间需重启；使用 /ctl narrow）。

默认情况下，/ctl status、/ctl leaks 和 /ctl explain 会打开该 GUI，而不是刷屏聊天。如果你更喜欢纯聊天输出，可以在 config/calmtheleaks-common.toml 中将 prefer_diagnostics_gui 设置为 false。

---

你还可以使用以下命令：

/ctl panel —— 打开诊断 GUI

/ctl status —— 显示当前 CTL 状态和跟踪泄漏摘要（默认打开 GUI）

/ctl leaks —— 按模组列出所有跟踪的泄漏（默认打开 GUI）

/ctl explain —— 为每个泄漏提供详细诊断，包括置信度和建议（默认打开 GUI）

/ctl narrow —— 收窄工具包：快照、对比、模组列表等（整合包更改后需重启游戏）

---

CTL 是完全可配置的： 你可以在 config/calmtheleaks-common.toml 中调整基线保留阈值、宽限期、升级级别、Spark 行为以及 GUI 与聊天的偏好。

---

重要说明：

本模组需要 AllTheLeaks 才能运行。它不会取代 ATL——而是通过上下文和智能分析扩展 ATL。ATL 仍然负责所有检测工作；CTL 只是让输出更易于人类理解与诊断。如果你在专用服务器上使用 GUI，请在服务器和客户端上运行相同版本的 CTL，以确保面板保持同步。