YNK模组医生

YNK模组医生

早期版本。一个只读的PowerShell检查工具,用于处理打上模组后无法启动或在补丁后损坏的《赛博朋克2077》,包括无错误无日志关闭的情况。它会读取日志和崩溃证据,检查RED4ext和redscript,并指出需要查看的模组。它只进行报告;不修复任何内容,也从不更改你的游戏文件夹。

[size=5][b]YNK Mod Doctor[/b][/size]
[b]早期版本(0.1.0)。[/b]一个免费的、只读的 PowerShell 工具,用于尝试找出[i]为什么[/i]一个打了模组的《赛博朋克 2077》(PC)无法启动或在补丁后损坏,并指出需要检查的模组或文件。它针对的是“游戏关闭但不给我任何错误和日志”的问题,也是更新后应该首先运行的工具。

[size=4][b]请先阅读此内容[/b][/size]
[list]
[]它仍在开发中。到目前为止,它只在我自己的测试安装和为测试制作的假游戏文件夹上测试过,[b]尚未在广泛的其他人的配置上测试[/b]。它会遗漏一些问题,也可能出错。如果出错,请告诉我。[/]
[]它[b]只报告[/b]。它不修复任何东西,也从不更改、移动或删除你游戏文件夹中的文件。(可选的 -Compile 检查在临时文件夹中的副本上运行;我检查过游戏文件夹在运行前后完全一致。)[/]
[]它无法发现没有留下任何痕迹的故障。如果它什么都没找到而游戏仍然无法启动,原因很可能在模组之外(验证游戏文件、GPU 驱动、杀毒软件隔离)。[/]
[]它不知道某个模组在 Nexus 上是否有更新版本。它会告诉你哪个模组是问题所在,而不是去哪里下载修复。[/]
[/list]
[size=4][b]如何使用[/b][/size]
[list=1]
[]关闭游戏。[/]
[]将 zip 解压到任意位置。右键单击 [font=Courier New]Doctor.ps1[/font] 并选择“使用 PowerShell 运行”。如果 Windows 阻止它,请在该文件夹中打开 PowerShell 并运行 [font=Courier New]powershell -ExecutionPolicy Bypass -File .\Doctor.ps1 -Compile[/font]。[/]
[]阅读底部的列表:[b]FAIL[/b] 表示它会阻止游戏或某个模组,[b]WARN[/b] 是可能的问题,[b]INFO[/b] 是值得了解的信息。每一行都说明了它的含义以及可以尝试的方法。[/]
[]可选:添加 [font=Courier New]-Compile[/font] 还会针对你的游戏版本重新编译每个 redscript 模组(约 20 秒),添加 [font=Courier New]-ReportPath "C:\Users\you\Desktop\doctor.txt"[/font] 可以保存一份报告,方便你在求助时粘贴。[/]
[/list]它是一个纯文本脚本。你可以用记事本打开它,准确阅读它做了什么。由于它是未签名的脚本,Windows 或杀毒软件可能会在运行前询问。

[size=4][b]它检查的内容[/b][/size]
[list]
[]安装了哪些框架(RED4ext、redscript、TweakXL、ArchiveXL、Codeware、Cyber Engine Tweaks),以及 RED4ext 的加载器文件(winmm.dll)是否存在。[/]
[]最新的 RED4ext 日志:它是否运行过、游戏停止时正在加载哪个插件、错误和警告,以及它是否进行到脚本编译器阶段。[/]
[]redscript 日志:每个编译错误及其对应的模组、文件和行号。[/]
[]没有日志时的崩溃证据:游戏的 CrashInfo.json 和 Windows“应用程序错误”事件(哪个文件崩溃了)。[/]
[]安装问题:游戏 exe 旁边的 ReShade/OptiScaler 图形钩子、旧的 cybercmd 插件、位于错误文件夹中的模组文件。[/]
[]两个模组添加相同的方法(此时游戏的编译器会拒绝[i]所有[/i] redscript 模组)。[/]
[]使用 -Compile 时:重新编译你的 redscript 模组,并指出在当前游戏版本上无法编译的那个,即使游戏自身的日志尚未显示它。[/]
[/list]尚未涵盖:ArchiveXL/TweakXL 冲突、Cyber Engine Tweaks Lua 错误、控制台。

[size=4][b]我在构建它时的发现(补丁 2.5,我的测试安装)[/b][/size]
[list]
[]无法编译的脚本模组[b]不是[/b]静默的:游戏会显示一个“REDScript compilation has failed”框并指出模组名称,而 redscript 日志中有确切的行号。[/]
[]移除 RED4ext 的加载器(winmm.dll)后,游戏在没有 RED4ext 模组的情况下启动,并且 RED4ext [b]完全没有写入日志[/b],这与人们描述的“无错误、无日志”症状相同。[/]
[]我无法重现静默失败的每一个原因。插件崩溃和图形钩子被涵盖是因为 wiki 和崩溃文件指向它们,但我没有亲自测试过这些。[/]
[/list]
[size=4][b]使用 AI 制作[/b][/size]
与 AI 编码助手(Claude,通过 Claude Code)一起编写。我选择了它检查的内容,并按上述方式进行了测试。源代码和一个小型测试脚本:[url=https://github.com/OriginalLeeDunn/ynk-cyberpunk77-mods/tree/main/tools/cp77-mod-doctor]GitHub[/url]。一份不断增长的[url=https://github.com/OriginalLeeDunn/ynk-cyberpunk77-mods/tree/main/docs/modding-handbook]模组制作手册[/url](我们关于启动失败和控制台脚本模组的了解)就在旁边。

[size=4][b]欢迎反馈[/b][/size]
如果它报告了错误的内容、遗漏了你的问题或崩溃了,请评论附上报告(使用 -ReportPath)以及你的游戏/模组配置。这就是它变得更好的方式。

[size=4][b]更新日志[/b][/size]
[list]
[][b]0.1.0[/b]:首个版本。[/]
[/list]