抑制重复的缺失预制体哈希警告，同时保留首次警告。可选的本地预制体诊断。不会修复或删除世界对象。

预制体哈希探测

减少重复产生的日志刷屏 缺失预制体哈希 瓦尔海姆中的警告。

它的作用

• 在每个场景中保留第一条相同的缺失预制体警告，并抑制重复警告。
• 不处理其他警告和错误。
• 为调查缺失的预制体哈希提供可选的本地诊断导出。
• 不修复缺失的模组、不跳过对象创建、不删除对象，也不编辑世界存档。
• 不上传数据，也不与外部服务通信。

缺失的底层对象仍需恢复或有意移除。性能提升程度取决于记录警告所花费的时间。

安装

使用Thunderstore Mod Manager安装，然后重启Valheim。需要BepInExPack；Jotunn为可选。

手动安装时，请复制 插件/PrefabHashProbe/PrefabHashProbe.dll 到你的个人资料中 BepInEx/plugins/PrefabHashProbe/ 目录。

从私有诊断版本升级： 移除旧的 Local-PrefabHashProbe/PrefabHashProbe.dll 安装此包之前。两者使用相同的插件 GUID， 本地.诊断.预制体哈希探测，所以只应安装一份。

配置

首次启动时，插件会创建 BepInEx/配置/本地.诊断.预制体哈希探测.配置文件:

[日志] 抑制重复缺失警告 = 真 [诊断] 启用诊断 = 假

详细诊断信息默认处于禁用状态。更改 启用诊断 需要重启游戏。

启用诊断后，文件将写入以下位置 BepInEx/诊断/PrefabHashProbe/。这些包括预制体注册表和已加载对象的名称、缺失创建尝试次数、样本对象 ID 和坐标、已安装插件的路径和哈希值，以及环境详细信息。这些文件保留在本地；在公开分享之前请先检查它们。完整诊断在收集快照时可能会导致短暂停顿。

警告缓存每个场景最多跟踪10,000条不同的消息。一旦缓存已满，新的未跟踪警告将直接放行；已跟踪的重复警告仍会被抑制。

兼容性与验证

• 针对 Valheim 1.0.15 / Unity 6000.0.75 和 BepInExPack 5.4.2350 开发。
• 早期私有版本是在 Windows 客户端上使用的，抑制重复警告后，报告的帧率得到了显著提升。
• 版本0.2.0已针对那些已安装的游戏/加载器程序集进行编译，并通过了九项独立的警告过滤检查。该确切版本的完整游戏内测试尚未进行。
• Linux、专用服务器运行以及旧版游戏尚未进行运行时测试。未来的游戏或 Jotunn 更新可能会影响可选的诊断 API。

中文说明

本插件仅保留每种缺失预制体哈希的首次警告，并抑制同一场景内的重复警告。它不会修复缺失物品、跳过物品加载、删除对象或修改存档。

默认只限流，不生成诊断文件。需要调查 hash 时，将配置中的 启用诊断 改为 真 并重启。完整诊断包含本地路径、Mod 清单和部分对象坐标，请检查后再分享。

从此前手动安装的诊断版升级时，请先移除 本地预制体哈希探测 内的旧 DLL，避免重复安装。

开发披露

本插件是在OpenAI Codex的大量AI协助下开发的。Thunderstore页面应包含 AI生成 类别。