BG3 模组管理器 Redux

[center]
[heading][color=#B89CFF]Baldur's Gate 3 Mod Manager Redux[/color][/heading]
[size=4][b]让混乱归于秩序。[/b][/size]

一个现代、社区驱动的分支版本，基于 [url=https://github.com/LaughingLeader/BG3ModManager]LaughingLeader 的 BG3 Mod Manager[/url]，专为更清晰的组织、深思熟虑的加载顺序管理、更安全的包工作流以及深度个性化而构建。

[color=#AFA4BC][b]0.1.0-alpha.15[/b] • 首个公开 Alpha 版 • Windows 10/11 x64 • .NET 8[/color]

[url=https://bg3mm-redux.com/][b]网站[/b][/url] • [url=https://github.com/circleainn/BG3ModManager-Redux][b]GitHub 与文档[/b][/url] • [url=https://discord.gg/rJJF89vqFZ][b]Discord[/b][/url] • [url=https://github.com/circleainn/BG3ModManager-Redux/issues][b]报告问题[/b][/url]
[/center]

[quote]
[color=#F0B44D][b]Redux 现已进入公开 Alpha 阶段。[/b][/color]

Alpha.15 是 Redux 的首个公开发布版本。

[b]Redux 由一个人开发和维护。[/b]虽然我在测试应用程序及其核心工作流上投入了大量时间，但不可避免地存在一些我无法亲自测试的模组组合、系统配置、显示设置、工作流和边缘情况。

你应当预期会遇到 Bug、未完成的部分，以及在开发或私下测试中未曾出现的行为。一些较新或较少见的工作流所获得的实际测试可能远少于核心模组管理体验。

如果你决定在公开 Alpha 阶段使用 Redux，请将其视为 Alpha 软件：对重要的配置文件、存档、已下载的压缩包、你的 BG3 Mods 文件夹以及 [i]modsettings.lsx[/i] 保留独立备份，并在将更改应用到游戏之前仔细审查。

在此阶段，Bug 报告和详细的复现步骤极为宝贵。[/quote]
[heading][color=#B89CFF]什么是 Redux？[/color][/heading]

Redux 构建于 BG3 Mod Manager 经过验证的基础之上，而非取代已经行之有效的工作流。

你仍然控制哪些模组处于“已激活”或“未激活”状态。你仍然决定加载顺序如何排列。你仍然决定何时保存顺序以及何时将其写入 Baldur's Gate 3。

Redux 将该基础扩展为一个更完整的工作空间，用于管理大型模组配置、下载、存档、原生包、诊断以及模组相关信息。

其核心理念很简单：

[b]重要操作应保持可见、审慎，并在你的掌控之下。[/b]

下载与安装是分开的。安装普通 PAK 与激活它是分开的。编辑加载顺序与保存它是分开的。保存与同步到游戏是分开的。

Redux 不会在你不知情的情况下静默地排序、修复、激活或重写你的配置。

[heading][color=#B89CFF]为大型模组库而构建[/color][/heading]

Redux 为熟悉的“已激活模组”、“未激活模组”和“覆盖模组”工作流提供了更强大的组织层。

[list]
[][b]分类[/b] — 分配多个分类，支持自定义名称、颜色、图标、描述、排序、计数和筛选。[/]
[][b]分隔符[/b] — 直接在你的激活加载顺序中创建带名称、带颜色、可折叠的分区。[/]
[][b]选中模组抽屉[/b] — 无需离开主工作区即可查看描述、依赖要求、文件、更新日志、来源信息、诊断以及你自己的备注。[/]
[][b]搜索与快速访问[/b] — 快速访问模组、配置文件、顺序、分类、主题、命令、文件夹和工具。[/]
[][b]灵活工作空间[/b] — 可配置的列、筛选、多选、键盘快捷键、撤销/重做，以及适用于密集配置的响应式面板。[/]
[/list]
分类、分隔符、图标和备注仅存在于 Redux 内部。它们永远不会被添加到你的模组中，也不会被写入 [i]modsettings.lsx[/i]。

[heading][color=#B89CFF]带审查步骤的加载顺序[/color][/heading]

Redux 将你当前正在编辑的加载顺序、已保存的 Redux 顺序以及 BG3 当前使用的顺序三者分开。

这使得实验更容易理解，也更容易恢复。

[list]
[]创建、重命名、导入、导出和比较已保存的加载顺序。[/]
[]在替换顺序之前查看新增、移除和位置变化。[/]
[]查看加载顺序历史记录和还原点。[/]
[]对支持的编辑操作使用有界的 [b]撤销[/b] 和 [b]重做[/b]。[/]
[]在 Redux 写入 BG3 之前预览 [b]将加载顺序同步到游戏[/b]。[/]
[]防止覆盖在 Redux 上次写入后外部发生变化的游戏顺序。[/]
[/list]
[b]保存和同步是有意分开的操作。[/b]

[heading][color=#B89CFF]下载管理器[/color][/heading]

Redux 包含一个持久化下载管理器，支持本地包和可选的 Nexus Mod Manager 下载。

将支持的包直接拖放到 Redux 上，或通过下载管理器添加。Redux 会检查包并将识别出的内容路由到相应的工作流，而不是将所有压缩包一视同仁。

[list]
[]普通 PAK 模组会安装到 [b]未激活模组[/b] 以供审查。[/]
[]存档包会通过 [b]存档管理器[/b] 处理。[/]
[]经审查的脚本扩展器和原生/根级包使用 [b]游戏目录模组管理器[/b]。[/]
[][b]全部安装[/b] 为多种支持的包类型提供单一审查步骤。[/]
[]可选的 Nexus Mod Manager 链接处理可将 [i]nxm://[/i] 下载直接发送到 Redux 收件箱。[/]
[]暂停、恢复、重试、重启恢复、安装历史和包检查已内置于工作流中。[/]
[/list]
接收包不会自动安装它，安装普通 PAK 也不会激活、重新排序、保存或同步它。

[heading][color=#B89CFF]包存档库[/color][/heading]

Redux 可选择在安装后保留已验证的包，以便日后重用，而无需手动维护一堆单独的压缩包。

存档保留是可选的且受配额限制。安装历史、保留的包、收件箱下载和已安装模组保持为独立的状态，因此清除其中一个不会静默移除其他内容。

[heading][color=#B89CFF]存档管理器[/color][/heading]

存档管理器提供以战役为导向的 BG3 存档视图。

在元数据可用的情况下，Redux 可以显示缩略图、日期、大小和难度信息，并支持通过分阶段审查流程导入存档。

现有存档不会被静默覆盖，删除存档会使用 Windows 回收站。

Redux 不会编辑或修复存档内容。请保留独立备份，并注意 Steam 云同步可能会恢复本地已删除的存档。

[heading][color=#B89CFF]游戏目录模组管理器[/color][/heading]

并非每个 BG3 模组都属于普通的 Mods 文件夹。

游戏目录模组管理器为经过审查的脚本扩展器、原生和根级包布局的有限目录提供了单独的安全工作流。

Redux 在应用更改之前会验证包结构和预期目标位置，并维护所有权信息，以便可以更安全地更新、修复或移除受管理的文件。

未知或不支持的原生布局会被阻止，而不会被猜测性地放置。

[quote]
原生布局验证不是发布者签名、恶意软件扫描或兼容性保证。原生 DLL 在游戏内执行，因此请仅从你信任的来源安装原生代码。[/quote]
[heading][color=#B89CFF]模组诊断[/color][/heading]

模组诊断将本地可检测的包信息直接带入主工作区。

根据包和可用证据，Redux 可能会显示缺失或未激活的依赖项、重复或无效的 UUID、声明的冲突、脚本扩展器要求、覆盖、Mod Fixer 行为、创作者元数据、提供者信息以及其他包信号。

[b]诊断是只读的。[/b]

它们不会自动下载、移除、修复、激活、重新排序、保存或同步任何内容。

[heading][color=#B89CFF]可选的加载顺序顾问[/color][/heading]

加载顺序顾问是一个实验性层，构建在诊断和有限审查知识库之上。

其 [b]整理激活加载顺序[/b] 工作流会在更改任何内容之前创建预览。它可以尊重现有分隔符、建议结构、解释已知关系，并允许忽略单个建议。

应用预览会创建一个未保存、可撤销的编辑。它不会自动保存或同步结果。

[quote]
加载顺序顾问不是通用兼容性解决方案。其知识有意不完整，它无法知晓每一个补丁、兼容性规则或作者意图的关系。

请将其输出视为指导，并自行审查推理过程。[/quote]
[heading][color=#B89CFF]Redux 模组列表[/color][/heading]

Redux 引入了 [b].bg3redux[/b] Redux 模组列表格式，用于将加载顺序与选定的 Redux 展示数据一起分享。

Redux 模组列表可以包含顺序信息、分类、分配、分隔符、图标、公开提供者引用以及可选备注。

[b]它不包含已安装的 PAK、存档、配置文件、API 密钥或 [i]modsettings.lsx[/i]。[/b]

导入 Redux 模组列表也不会自动下载或安装缺失的模组。

[heading][color=#B89CFF]模组信息与来源识别[/color][/heading]

Redux 可以将本地解析的包元数据与可选的 Nexus Mods、mod.io、创作者以及经过审查的离线信息相结合。

在可用的情况下，这可以提供更丰富的描述、依赖要求、文件、更新日志、版本信息、来源链接和更新上下文。

识别是有意保守的。

如果 Redux 没有足够强的证据来可靠地识别一个包，它会保持为 [b]本地[/b]，而不会被分配一个令人信服但可能错误的来源。

[heading][color=#B89CFF]主题与个性化[/color][/heading]

Redux 包含三个内置主题：

[list]
[][b]Redux 深色[/b][/]
[][b]Redux 浅色[/b][/]
[][b]羊皮纸[/b][/]
[/list]
你还可以使用实时颜色预览和界面语义样式构建自定义主题。

其他外观选项包括自定义字体、PNG 分类图标、生成的渐变、多种文字大小、图标和标签可见性控制、背景效果以及主题感知界面样式。

[heading][color=#B89CFF]无障碍[/color][/heading]

Redux 包含可配置的文字大小、导入字体、减少动态效果、背景模糊和调暗控制、可自定义键盘快捷键、可选择对话框文本以及继承的屏幕阅读器/语音基础。

无障碍工作在公开 Alpha 期间持续进行，特别是在不常见的显示缩放、密集布局和较少使用的窗口方面。

[heading][color=#B89CFF]面向模组作者的工具[/color][/heading]

[b]工具 > 检查模组包...[/b] 为支持的 PAK、发布压缩包、原生布局、混合包、存档压缩包和松散存档文件提供只读预检。

它可以显示包标识、可能的安装目标、依赖项、创作者元数据、脚本扩展器和 Osiris 信号、覆盖行为、不安全的压缩包路径、重复名称、意外捆绑的文件以及其他有用的打包信息。

选定的包不会被安装或修改。

[url=https://github.com/circleainn/BG3ModManager-Redux/blob/main/docs/MOD_DEVELOPER_TOOLS.md][b]模组开发者文档[/b][/url]

[heading][color=#B89CFF]安装[/color][/heading]

Redux 有两种形式可供选择。

[b]引导安装[/b]

轻量级的 [b]BG3ModManager-Redux-Setup.exe[/b] 引导程序会下载并验证当前的 Redux 包，协助处理所需的前置条件，并提供常规的已安装应用程序和卸载路径。

[b]便携版[/b]

便携版 ZIP 包含完整的 Redux 应用程序，供手动解压和维护。

无论你选择哪种方式：

[list]
[]使用专用的可写文件夹。[/]
[]不要从 ZIP 内部运行 Redux。[/]
[]不要将 Redux 放在 Baldur's Gate 3 安装目录内。[/]
[]启动 [b]Redux.exe[/b] 并完成欢迎设置。[/]
[]在进行更改之前验证检测到的游戏和用户数据路径。[/]
[/list]
仅从此 Nexus Mods 页面或官方 GitHub Releases 页面下载 Redux。

[url=https://github.com/circleainn/BG3ModManager-Redux/blob/main/docs/INSTALLATION.md][b]完整的安装、更新、回滚和移除文档[/b][/url]

[heading][color=#B89CFF]系统要求[/color][/heading]

[list]
[]Windows 10 或 Windows 11，x64[/]
[].NET 8 桌面运行时[/]
[]Baldur's Gate 3[/]
[/list]
目前不支持 Linux、macOS、Wine 和 Proton。

[heading][color=#B89CFF]公开 Alpha 版的限制[/color][/heading]

Alpha.15 是公开测试的开始，而非开发的终点。

由于 Redux 目前由唯一开发者开发，公开使用将覆盖比开发期间实际可复现的更多的硬件配置、模组组合、工作流和边缘情况。

已知正在进行的工作领域包括：

[list]
[]提供者、分类、依赖项、识别和加载顺序顾问的覆盖范围；[/]
[]个人 Nexus API 密钥认证而非公开的 Redux SSO；[/]
[]一些有限的 mod.io 元数据路径；[/]
[]依赖用户提供文件的导入字体和 PNG 图标行为；[/]
[]不常见的 DPI/显示缩放以及异常小或密集的布局；[/]
[]较少见的下载、原生包、存档、恢复操作和迁移状态的组合。[/]
[/list]
[b]一定会有 Bug。[/b]

有些会很明显。其他的只会在特定的模组、电脑、路径、Windows 配置、显示设置或操作序列下出现。

请报告可复现的问题，而不要假设异常行为是有意为之。

[heading][color=#B89CFF]隐私[/color][/heading]

Redux 是一个本地桌面应用程序。

没有 Redux 账户、广告、分析或通用遥测，Redux 不会将你的模组列表、存档、分类、备注、设置或诊断上传到 Redux 服务。

可选的提供者、更新、贡献和链接工作流仅在启用或被调用时发起网络请求。

Nexus 集成目前使用你的个人 Nexus API 密钥。

[color=#E26473][b]切勿分享 API 密钥、已签名的下载 URL、凭据或包含这些内容的截图。[/b][/color]

[url=https://github.com/circleainn/BG3ModManager-Redux/blob/main/docs/PRIVACY_AND_DATA.md][b]隐私和本地数据文档[/b][/url]

[heading][color=#B89CFF]报告 Bug 和反馈[/color][/heading]

公开 Alpha 的存在部分是为了将 Redux 暴露给我无法独自复现的工作流和模组配置。

如果出现问题，请使用 [url=https://github.com/circleainn/BG3ModManager-Redux/issues][b]GitHub 问题追踪器[/b][/url]。

有用的报告包括：

[list]
[]你的确切 Redux 版本；[/]
[]Windows 版本；[/]
[]相关的 BG3 补丁或热修复；[/]
[]复现问题的最短步骤序列；[/]
[]你期望发生什么；[/]
[]实际发生了什么；[/]
[]相关时受影响的模组名称或 UUID；[/]
[]有用时附上截图或少量脱敏的日志摘录。[/]
[/list]
对于视觉 Bug，还请包括你的主题、字体、文字大小、窗口大小和 Windows 显示缩放。

[color=#E26473][b]不要发布 API 密钥、已签名的 URL、原始存档、私人备注、完整的模组压缩包或未经审查的日志。[/b][/color]

安全敏感的报告应使用 GitHub 的私密漏洞报告功能，而非公开问题或 Discord 帖子。

[heading][color=#B89CFF]致谢[/color][/heading]

Baldur's Gate 3 Mod Manager Redux 构建于 [url=https://github.com/LaughingLeader/BG3ModManager][b]LaughingLeader 的 BG3 Mod Manager[/b][/url]，并保留了大量的上游代码和行为。

[url=https://ko-fi.com/LaughingLeader][b]在 Ko-fi 上支持 LaughingLeader[/b][/url]

Redux 还依赖于 Norbyte 和 LSLib 项目的工作，以及 CrossSpeak、AdonisUI、ReactiveUI、GongSolutions.WPF.DragDrop、SharpCompress、Lucide 和捆绑的开源字体。

[url=https://github.com/circleainn/BG3ModManager-Redux/blob/main/licenses/Third-Party-Notices.md][b]第三方声明[/b][/url]

[heading][color=#B89CFF]支持 Redux[/color][/heading]

Redux 是一个独立开发的项目。

如果你喜欢这个项目并希望支持持续开发：

[url=https://ko-fi.com/circleain][b]在 Ko-fi 上支持 Redux[/b][/url]

[center]
Baldur's Gate 3 由 Larian Studios 开发和发行。

Baldur's Gate 3 Mod Manager Redux 是一个非官方社区分支，与 Larian Studios、Nexus Mods 或 mod.io 无关联，也未获其认可。

[url=https://bg3mm-redux.com/][b]网站[/b][/url] • [url=https://github.com/circleainn/BG3ModManager-Redux][b]GitHub[/b][/url] • [url=https://discord.gg/rJJF89vqFZ][b]Discord[/b][/url] • [url=https://github.com/circleainn/BG3ModManager-Redux/issues][b]问题反馈[/b][/url][/center]