REDscope

REDscope

一个全面的崩溃日志记录器，可检测游戏目录中的松散文件。

实用工具

REDscope预览查看大图

REDscope

崩溃记录器 · Beta 版本

▍ 概览

REDscope 是一个全面的日志记录工具，可在崩溃发生时读取崩溃信息，并生成一个纯文本的 .crash 文件，指明可疑元凶：出错的模块、脚本正在执行的操作、引擎正在加载的内容，以及自上次正常启动以来发生变化的模组。

目前处于 Beta 阶段。核心的崩溃捕获功能稳定；部分较新的功能（如下所述）已包含在内，但尚未经过实际测试。

▍ 报告内容

每次崩溃都会生成一份报告，从上到下依次为：

  • 可疑元凶，位于顶部。 带有置信度的最佳推测结果。例如“Mod ArchiveXL.dll+0x8124”、“检测到堆损坏”、“堆栈溢出/无限递归”。当故障发生在模组内部时，会直接指出模组名称；当故障发生在游戏自身代码中时，会提供模块和偏移量，以及堆栈中模组帧的指针。
  • 按模组分组的原生调用堆栈。 每一个堆栈帧都标注了来源的 DLL，因此你可以直接看到是哪个模块出错，而不是一堆十六进制数字。游戏引擎帧显示为偏移量（游戏未附带公开符号），因此关键信号是哪个模组模块出错，以及脚本触发点。
  • 你的脚本正在执行的操作。 来自崩溃线程的进行中的 RedScript 调用堆栈。
  • 引擎正在加载的内容。 加载器在崩溃时失败或仍在流式加载的资源，使用内置字典解析为真实文件路径。
  • 自上次启动以来发生变化的模组。 自上次正常游戏会话以来，你添加、删除或更新的内容差异。对于新出现的崩溃，这是最强有力的线索。
  • 崩溃时的实时引擎状态。 已使用的 GPU 内存对比预算、内存不足试探、引擎生命周期标志。
  • 最近的日志活动。 来自 red4ext、RedScript、CET 和主要框架日志的大约最后一分钟内容，错误和警告被置于顶部。
  • 你的完整系统和模组列表。 CPU、GPU、内存、驱动、操作系统以及按类型分类的模组列表摘要，这样在反馈 Bug 时所有信息都可以一次性粘贴。
  • 卡死检测（Beta 功能）。 REDscope 还会监控游戏完全卡死的情况，并生成一份报告，指出最后正在运行的脚本函数。

报告会自动清除个人信息：你的用户文件夹在生成任何内容之前会被替换为 %USERPROFILE%。

▍ 特征库

REDscope 会将每次崩溃与已知特征库进行匹配：特定的异常、出错的模块、正在运行的脚本函数，甚至包括在调用链中特定版本模组的封装。

它预装了引擎级别的特征。模组特定特征部分初始为空，并会逐步增长：识别出真实冲突并上报后，该特征将被添加到 REDscope，这样后续遇到相同崩溃的所有玩家都会自动获知元凶和修复方案。

这是一个会随时间推移而价值倍增的崩溃记录器。社区上报的已解决问题，永远不必再次解决。

▍ 命名堆栈帧（调试符号）

面向高级用户。

如果模组提供了调试符号文件（.pdb），原生崩溃帧将显示真实的函数名称——

例如： RED4ext.dll!PluginSystem::Load

而不是： RED4ext.dll + 0x705160

五个框架模组发布了可用的符号：RED4ext、Cyber Engine Tweaks、Mod Settings、Audioware、Input Loader。

  • 自动获取（自愿加入）： 在 REDscope 的 CET 面板中，找到“调试符号”设置，勾选“启动时自动下载”或点击“立即下载”——REDscope 会获取并验证与你当前安装版本匹配的符号。

警告： 此操作会自动从下方 GitHub 链接下载 .pdb 文件。此功能默认关闭。如果不信任，请保持关闭并手动获取——将 .pdb 文件放入 REDscope 的 symbols 文件夹（路径：red4ext/plugins/REDscope/symbols）。

符号必须与你安装的每个模组的版本相匹配。

▍ 如何阅读崩溃报告

  • 打开文件。 .crash 报告是纯文本格式。阅读“可疑元凶”一行即可，或继续查看完整信息。
  • 游戏中。 Cyber Engine Tweaks 面板可以在不离开游戏的情况下分析你的最新崩溃：显示主要线索、你遇到该崩溃的次数以及崩溃历史记录。
  • REDscope 指南 也应该能告诉你理解崩溃报告所需的一切。

▍ 使用方法

  1. 安装后正常游戏。
  2. 当游戏崩溃时，从 red4ext/plugins/REDscope/crashes/ 文件夹中获取最新的文件（Mod Organizer 2 用户：文件位于你的 Overwrite 文件夹下）。

没有崩溃要报告？ 游戏内面板还可以按需生成诊断报告：包含你的硬件规格、游戏内图形和游戏设置，以及完整的模组列表，所有内容都可以一次性分享。当你寻求模组支持时，如果有人要求“请提供你的配置”，你就可以直接发送这份报告。

▍ 需求与安装

兼容 Mod Organizer 2、Vortex 以及手动安装。

▍ 鸣谢

  • WopsS 以及 RED4ext 团队
  • psiberx
  • alandtse / CrashLoggerSSE
  • WolvenKit
  • CDPR
  • jac3km4