脚本合并器 – 新鲜且自动化版

《巫师 3》脚本合并器：新鲜且自动版（SM-FAE）MOD 使用指南
【核心介绍】
一款基于原脚本合并器深度优化的现代化工具，专为《巫师 3》模组玩家设计：提供全新响应式界面（支持 Windows 浅色/深色模式），并集成 5 项可开关的自动化功能，显著降低脚本合并操作门槛与重复劳动。
【安装指南】
1. 下载版本选择：
– 「SM-FAE 独立版」：需自行安装依赖工具（KDiff3、QuickBMS、wcc_lite、网址链接），适合已有工具链的用户；
– 「SM-FAE 完整版」：已预置全部依赖，解压即用，推荐新手首选。
2. 手动安装（无模组管理器）：
– 将 .7z 文件解压至任意干净目录（如：游戏根目录 /WitcherScriptMerger）；
– 启动「WitcherScriptMerger.exe」即可运行。
3. Vortex 用户升级：
– 将原 Vortex 安装目录 `[Witcher 3]WitcherScriptMerger` 重命名为 `WitcherScriptMerger.old`；
– 解压新版本至 `[Witcher 3]WitcherScriptMerger`；
– 后续由 Vortex 自动调用 SM-FAE。
4. W3MM 用户配置：
– 手动完成上述安装后，打开 W3MM → 顶部菜单「设置」→「配置设置」→「更改 Script Merger 路径」；
– 浏览并指向你解压目录中的「WitcherScriptMerger.exe」。
5. 回退至原版脚本合并器前必做：
– 删除 `[Witcher 3]Modsmod0000_MergedFiles` 目录，否则原版合并器可能误读文件导致失败或游戏无法启动。
【功能详情】
✅ 已优化：
– 全新 UI，适配 Windows 浅色/深色主题，支持高缩放（≥250%）与多分辨率；
– 首次启动自动识别 GOG/Steam 游戏路径，并自动修复缺失的 `/Mods` 目录；
– 新增键盘快捷键、恢复默认设置按钮、“一键创建全部合并”与“一键删除全部合并”按钮；
– 内置快捷键说明面板与选项页面 5 项自动化开关（见【更新日志】）。
❌ 未修改：
– 核心合并逻辑与冲突解决机制（仍依赖 KDiff3 处理硬冲突）；
– 对原始游戏脚本文件的底层解析方式（兼容性与原版一致）。
✨ 额外调整：
– KDiff3 默认启用「忽略空白字符差异」，降低人工比对难度；
– 检测到历史合并记录但未被识别时，主动提示并支持一键修复；
– 自动监测模组更新，通过 xxHash 快速判断是否需重新合并。
【使用要求】
– 必备系统：Windows 10 或更高版本；
– 运行环境：SM-FAE 0.9.7 及以上版本需安装「.NET 桌面运行时 8.0.11」（x64 或 x86）；
→ 下载地址：网址链接；
– Steam Deck 用户：需通过 ProtonTricks 安装 .NET 8 运行时，并将 SM-FAE 放置于 `Z:homedeck.steamsteamsteamappscommonThe Witcher 3WitcherScriptMerger`。
【兼容性说明】
– 兼容范围：完全兼容所有基于原脚本合并器开发的《巫师 3》脚本类模组（含「血与酒」「石之心」扩展包）；
– 不兼容模组：无直接不兼容模组，但以下情况需注意：
– 修改同一脚本文件相同代码行的模组会产生硬冲突，必须人工通过 KDiff3 处理；
– 不兼容非脚本类合并工具（如 WolvenKit 的 bundle 编辑流程）；
– 兼容补丁：暂未推出专用兼容补丁。
【注意事项】
– 硬冲突无法自动化处理，需人工判断——请优先选用将逻辑拆分至独立脚本文件的优质模组；
– Steam Deck 用户开启「选项」界面会导致程序崩溃，暂勿点击该按钮；如需调整设置，请直接编辑 `WitcherScriptMerger.dll.config` 文件；
– 「自动覆盖旧的合并」功能仅作用于脚本文件，不影响 bundle 打包行为；
– 「所有合并完成后自动退出」不处理“捆绑合并”（Bundle Merge），建议通过模组优先级管理此类内容。
【更新日志】
– 2023 年 8 月 3 日新增 5 项自动化选项：自动创建全部脚本合并、自动删除过期合并、自动覆盖旧合并、自动跳过 KDiff3 提示框、合并完成自动退出；
– 2023 年 8 月 3 日优化首次启动逻辑，支持自动定位游戏目录与修复 Mods 路径；
– 2023 年 8 月 3 日更新 KDiff3 默认配置，启用空白字符忽略；
– 2023 年 8 月 3 日发布完整版内置全部第三方工具（KDiff3、QuickBMS、wcc_lite、网址链接）；
– 2023 年 8 月 3 日正式切换为 .NET 8.0 运行时，提升性能与稳定性。