猎魔人冲突解决器 (W3CR)

Witcher Conflict Resolver (W3CR) — 0.3.2 Alpha

不用再反复解决相同的《巫师3》模组冲突了。

当两个模组修改同一个脚本时，总得有人想办法把这些改动合并起来，同时不破坏任何东西。Script Merger 这类工具能帮你完成合并，但解决方案通常只留在了你自己的电脑上。

如果别人已经解决并测试过完全相同的冲突呢？为什么每个人都要重新解决一遍？

这就是 Witcher Conflict Resolver (W3CR) 的出发点。 W3CR 是一款免费、离线的工具，旨在识别、复现并共享经过验证的 WitcherScript 冲突解决方案。 解决一次冲突，让这个方案可复用。

W3CR 与 Script Merger 有什么区别？

Script Merger 帮助你合并冲突的脚本。W3CR 采用不同的思路：它致力于让已解决的冲突自动可复用。

例如：

• 两个热门模组修改了同一个函数。
• 有人找到了可用的解决方案，并在游戏中进行了测试。
• 该方案被转换成一个小型 W3R recipe，并提交到社区数据库。
• 另一位用户安装了相同版本的冲突脚本。
• W3CR 识别出匹配的冲突，并根据该用户自己的模组文件重建已知方案。

无需每个用户重复相同的手动合并。 Recipe 不包含其他作者的脚本副本。它们描述的是如何使用你电脑上已安装的原始文件来复现某个特定的解决方案。

与通用的自动合并不同，recipe 代表的是一个特定的、此前已经过审阅的决定。W3CR 会在应用前验证所需的源版本是否匹配。 如果脚本已发生变化，recipe 不会被盲目应用。

W3CR 目前能做什么？

即使没有社区 recipe，W3CR 也可以：

• 分析已安装的 WitcherScript 模组并识别重叠的改动。
• 当其保守检查确认结果具有确定性时，自动解决安全的冲突。
• 应用来自兼容 W3R recipe 的已知解决方案。
• 识别需要人工决策的冲突，而不是靠猜测。
• 检查脚本并比较来自不同模组的改动。
• 识别此前安装过的 W3CR 合并结果，因此已解决的冲突不会反复被当作新工作出现。
• 当源模组发生变化时检测过时的合并结果，并在安全的情况下重建受影响的文件。
• 保护现有的第三方合并结果免遭意外覆盖。
• 在安装前构建并验证合并后的脚本。
• 备份和恢复此前的合并安装以及相关的加载顺序设置。

文件检查器还可以将已安装的合并结果与新生成的预览进行比较，而不会修改你的游戏。 W3CR 并不声称所有冲突都能自动解决。有些问题仍然需要人工判断和游戏内测试。

社区数据库——核心理念

这部分需要你的帮助。

目前，公开的 recipe 数据库仍处于早期阶段，尚未包含通用的社区解决方案合集。 W3CR 已经可以导入并使用 W3R recipe，但它的最大潜力取决于能否建立一个经过测试的冲突解决方案共享合集。 想想有多少人安装了相同的热门《巫师3》模组，并遇到了相同的兼容性问题。 其中一些冲突早已被经验丰富的模组作者解决。但他们的解决方案往往埋没在个人模组文件夹、讨论帖或兼容性补丁中。

W3CR 旨在将个人的工作转化为可复用的知识。

你不需要手动编写 recipe，也不需要了解其内部格式。 如果你已经解决了一个冲突，并确认合并后的脚本可以正常工作，你可以使用内置的 Community Collector 提交它们以供审阅。

如何贡献

1. 保留原始冲突模组和你可用的合并脚本。
2. 在 W3CR 中打开 Community → Submission ZIP…。
3. 生成提交归档，并包含相关模组版本、游戏版本、编译结果以及已测试的功能。
4. 通过 Nexus Mods 私信发送归档或下载链接。

不会自动上传任何内容。 提交内容包含 recipe 候选和验证元数据，而非原始 .ws 脚本的副本。 我会在将合适的解决方案添加到公开数据库之前审阅提交内容。经过审阅的 recipe 之后可以通过单独的数据库更新进行分发，而无需所有人下载新的 W3CR 应用程序。

社区贡献的已测试解决方案越多，每个人需要重复解决的冲突就越少。

快速上手

1. 安装 Python 3 for Windows (64-bit)。勾选 Add Python to PATH，并保留 tcl/tk and IDLE 的选中状态。
2. 将完整的 W3CR 文件夹解压到一个可写且位于游戏目录之外的位置。
3. 运行 Launch_Witcher_Conflict_Resolver.bat。
4. 选择你的《巫师3》安装位置，然后点击 1 Analyze。
5. 查看结果。需要时使用 Inspect file… 或 Resolve function…。
6. 点击 2 Build staging 生成并验证解决后的脚本。
7. 关闭游戏，然后点击 3 Backup + Install。
8. 启动游戏，验证脚本编译情况，并测试受影响的模组功能。

Analyze 和 Build staging 不会修改你的游戏安装。 使用 Undo / Restore… 可撤销最近一次的 W3CR 安装。

理解结果

状态	含义
AUTO_SAFE	W3CR 根据其静态检查可以安全地合并这些改动。
KNOWN_RESOLUTION	匹配的已保存 recipe 提供了可复现的解决方案。
KNOWN_PRIORITY	已验证的规则指定了哪个模组应优先。
NEEDS_USER	W3CR 无法自动确定安全的解决方案。
INSTALLED_VERIFIED	现有的 W3CR 合并结果已成功验证。
INSTALLED_STALE	已安装的 W3CR 合并结果需要重建，因为其相关输入已发生变化。
MERGE_NEEDS_REVIEW	存在已安装的合并结果，但其有效性无法完全确认。

W3CR 会刻意拒绝不确定的操作，而不是静默地生成可能错误的合并结果。

兼容性与限制

已在 The Witcher 3 Remastered 5.01 上测试，包括安装和游戏内测试。

• 支持 WitcherScript (.ws) 冲突，不涵盖所有《巫师3》模组资源格式。
• 精确匹配的 recipe 需要兼容的源脚本以及任何适用的游戏版本约束。
• 静态验证不能替代游戏的脚本编译器或实际游玩测试。
• Remastered 的 precompiled.rsblob 基于作用域的覆盖尚未完全覆盖。
• 外部或手动编辑的合并结果不会被自动假定为正确。
• 某些模组需要额外的安装步骤或兼容性更新。

W3CR 是 Alpha 软件。请保留备份并在游戏内测试你的合并结果。

AI 披露、许可与隐私

W3CR 包含在人工指导下开发、并通过反复验证测试的 AI 生成代码。 该应用程序完全离线工作。它不会联系 AI 服务，也不会自动将你的文件发送到任何地方。 依据 W3CR Source-Available License 1.0 分发，供个人、非商业使用。允许源代码查阅和私下修改；公开再分发、修改后的公开发布以及商业使用需事先获得书面许可。 完整条款请参阅随附的 LICENSE。

查看 Changelogs 标签页了解版本历史。