Red Stack - VSCode模组管理器与冲突检查器

Red Stack - VSCode模组管理器与冲突检查器

VS Code 内的模组管理器。你下载的 zip 所在文件夹仍是唯一的库:配置文件、每个模组一个复选框、冲突、加载顺序、来自 Nexus 的更新,以及在写入游戏之前可供你阅读的计划。

[size=4][b]语言[/b][/size]
[list]
[][b]English[/b]:界面和手册为英文。[/]
[][b]Français[/b]:界面和手册为法语(文本的源语言)。[/]
[][b]Deutsch[/b]:界面为德语,手册为英文。[/]
[][b]Español[/b]:界面为西班牙语,手册为英文。[/]
[][b]Português (Brasil)[/b]:界面为葡萄牙语,手册为英文。[/]
[][b]Italiano[/b]:界面为意大利语,手册为英文。[/]
[][b]Polski[/b]:界面为波兰语,手册为英文。[/]
[][b]Русский[/b]:界面为俄语,手册为英文。[/]
[][b]简体中文[/b]:界面为简体中文,手册为英文。[/]
[][b]日本語[/b]:界面为日语,手册为英文。[/]
[][b]한국어[/b]:界面为韩语,手册为英文。[/]
[/list]Red Stack 的全部文本,以其十一种语言呈现,均由 AI 撰写。法语是源语言;其余十种(包括英语)都是它的译文,经过测试台检查,尚未由母语者校对。欢迎指正:在 GitHub 上提交 issue 或在此留言。

[size=5][b]这是什么[/b][/size]

Red Stack 是一个《赛博朋克 2077》的模组管理器,驻留在 Visual Studio Code 的一个标签页中。它为那些已经把下载的模组以 zip 形式保存在自己文件夹中、并且不希望管理器把它们复制到自己的库中的人而构建。

[list]
[][b]你的 zip 留在你归档的地方。[/b] Red Stack 就地读取它们。它不会复制它们,也不会移动它们,除非你要求。[/]
[][b]每个模组一个复选框,每个文件夹一个。[/b] 配置文件记住哪些模组已启用,以及从每个 zip 中取用了什么。[/]
[][b]没有计划就不会向游戏写入任何内容。[/b] 勾选复选框只会更改配置文件。"计划预览"显示将安装、替换和移除的内容;只有你看到的计划才会在确认后被执行。[/]
[][b]硬链接,而非副本。[/b] 每个模组只解压一次并链接到游戏中:一个模组只占用其大小一次,关闭它是即时的。设置文件则被复制,以便在更新后保留。[/]
[][b]它能接管一个已经装过模组的游戏。[/b] 首次读取不会写入任何内容:它将游戏中的内容与你的 zip 匹配,并据此创建配置文件。[/]
[/list]
[size=5][b]日常使用:列表、配置文件、计划[/b][/size]

[list]
[][b]仓库中每个文件夹一张表[/b](一个"栈"),包含版本、状态、内容类型(归档、脚本、调整、CET、RED4ext、REDmod、设置……)、文件数量和每个模组的大小。排序、按名称筛选、折叠栈、一键启用或禁用整个栈。[/]
[][b]配置文件[/b]:想要多少有多少,通过复制创建。切换配置文件不会改变游戏中的任何内容,直到你应用其计划。[/]
[][b]模组详情[/b]:每个文件、它在游戏中的位置、它是被链接、复制、被另一个模组覆盖还是在游戏中被修改。包含多个选项的包可在此处选择,每个文件一个复选框可取用或舍弃单个文件。[/]
[][b]"哪个模组拥有这个文件?"[/b]:输入游戏路径的一部分,得到对应的 zip。[/]
[][b]计划预览[/b]:将安装、替换和移除的内容,按模组和按文件列出,附带需要解决的冲突,以及每个已禁用模组的一行说明(什么离开游戏,什么被另一个模组接管)。[/]
[][b]小心它未安装的内容[/b]:在游戏中被修改的文件会被保留;存在但并非由 Red Stack 安装的文件会被显示并保持原样,或者在你确认后由 zip 中的文件替换,旧文件会被复制到备份中。[/]
[][b]写入操作进行时页面会锁定[/b],并且在游戏运行时拒绝写入。[/]
[][b]列表会自动重新读取[/b],当有 zip 到达、离开或变更时,或当游戏的模组文件夹发生变化时。[/]
[/list]
[size=5][b]冲突与加载顺序[/b][/size]

[list]
[][b]归档之间的冲突[/b],在单独的标签页中:哪个模组赢得每个资源,可按归档、按模组、按模组对或按资源查看。完全相同的副本单独计数(它们不是冲突),替换基础游戏文件的资源会被标记。在列表中,每个模组的徽章显示它是胜是负。[/]
[][b]在此处更改加载顺序[/b],有两种方式:为归档指定另一个游戏内名称(zip 从不被改动,作者名称一键恢复),或由配置文件持有的 modlist.txt。Red Stack 会提议最接近的可用名称,并在你重命名之前说明谁按名称引用了该归档。[/]
[][b]脚本和调整之间的冲突[/b]:两个模组替换相同的 Redscript 方法、一个从不调用 wrappedMethod 的包装器、相同的 TweakXL 属性被设为两个值、添加与移除相对、硬编码的 SetFlat 与另一个模组的调整相对。三个级别(需查看、需审查、无需操作),每行在正确行处打开文件。检测规则取自 Conflict Studio(MIT)。"最终话语权"是根据文件名顺序预测的,而非在游戏中观察到的。[/]
[][b]游戏内名称[/b]:以其他名称安装模组的归档、.xl 文件、脚本和调整文件夹、CET 或 REDmod 文件夹,而不改动 zip。每行说明在你的仓库中谁引用了该名称。[/]
[/list]
[size=5][b]Nexus:更新与下载[/b][/size]

[list]
[][b]更新[/b]:每个保留其 Nexus 文件名的 zip 会与其模组已发布的文件进行比较。新版本取代旧版本的位置,旧版本进入"已退役"文件夹;配置文件随之跟进。可疑情况(已归档的文件、为其他游戏补丁构建的版本)会显示为"待检查",绝不会替你勾选。模组可以被忽略。[/]
[][b]查找更新无需密钥。[/b] 下载使用你的个人 Nexus API 密钥,在 VS Code 中输入,保存在其机密存储中,不写入任何文件。[/]
[][b]高级账户[/b]:一次确认即可直接下载所有已勾选的更新,带进度条和速度显示。[/]
[][b]免费账户[/b]:网站的"Mod manager download"按钮会将文件发送到 Red Stack,后者可自行注册 nxm:// 链接(仅限当前 Windows 用户,可从同一位置撤销)。[/]
[][b]完全无密钥[/b]:手动下载到一个到达文件夹;Red Stack 识别你已有模组的更新并将其归档到正确位置。[/]
[][b]自制或 GitHub 模组[/b]没有 Nexus id 的,按名称和版本识别为更新。[/]
[/list]
[size=5][b]保持仓库整洁[/b][/size]

[list]
[][b]到达[/b]:新下载的文件被赋予 Nexus 站点的文件名,从 .7z 或 .rar 转换为 .zip,然后移入其栈或停放,可逐行或批量操作。[/]
[][b]停放、退役、删除[/b]:你不使用的模组进入其栈的"停放"文件夹,旧版本进入"退役"文件夹;直到你自己删除已退役的 zip(删除到 Windows 回收站)之前,什么都不会被抹去。[/]
[][b]你的文件夹名,不是我们的[/b]:哪些文件夹是栈、停放、新到或退役是一项设置。单一文件夹中的散装 zip 也可以使用。Red Stack 不读取的文件夹会在屏幕上标明,绝不静默跳过。[/]
[][b]重命名 zip 附带的内容[/b]:归档、脚本和调整文件夹,在读取你整个仓库的引用之后进行,以便提议的内容不会破坏硬编码名称或加载顺序。每个路径保持可编辑,一个模组家族可以共享一个脚本或调整文件夹,一键即可将 zip 的脚本和调整归入你选择的文件夹。[/]
[][b]FOMOD 安装器[/b]:页面、分组、描述和图像;你的选择存储在配置文件中,之后可以更改。REDmod 的版本从其 info.json 读取。[/]
[/list]
[size=5][b]了解发生了什么[/b][/size]

[list]
[][b]历史[/b]:每一个写入过内容的操作。每次"应用"按模组展开(已安装、已移除、从哪个版本更新),仓库上的每个操作也都在那里。有助于回答"自游戏上次正常运行以来发生了什么变化?"。[/]
[][b]存储[/b]:真实磁盘大小(Windows 资源管理器会将链接文件计算两次)、链接状态、不再服务于任何已启用模组的解压树、树中被编辑过的文件。[/]
[][b]模组设置备份[/b]:备份、与游戏比较、恢复。[/]
[][b]游戏参考[/b]:不含归档的基础游戏副本,用于在游戏更新后检查或恢复它。[/]
[/list]
[size=5][b]舒适性[/b][/size]

[list]
[][b]十一种界面语言[/b],从设置中切换,无需重启。[/]
[][b]扩展内完整手册[/b],每个视图一节(英文和法文)。[/]
[][b]两套完整的 VS Code 配色主题[/b](红色和黄色);Red Stack 页面跟随你使用的任何主题。[/]
[][b]侧边栏[/b],包含配置文件、上次读取的数据和快捷方式。[/]
[/list]
[size=5][b]致 Claude Code 用户[/b][/size]

扩展附带两个 MCP 服务器;两者都不会替你声明。
[list]
[][b]第一个(26 个工具)[/b]允许会话读取状态、冲突、历史、到达和更新,更改配置文件并准备计划。它从不写入游戏或你的 zip:对于游戏,它会留下一个请求,扩展会连同数据一起显示给你,由你应用或拒绝。[/]
[][b]第二个(11 个工具)[/b]驱动 WolvenKit CLI:在游戏和模组的归档中搜索资源、解压、导出、将 CR2W 文件读取为 JSON、编辑、导入、打包归档、构建项目。它只在你指定的工作坊文件夹内写入。[/]
[/list]
[size=5][b]要求[/b][/size]

[list]
[]Windows、《赛博朋克 2077》(PC)。[/]
[][url=https://code.visualstudio.com/][/url][url=https://code.visualstudio.com/download]Visual Studio Code[/url] 1.90 或更高版本。[/]
[][url=https://www.python.org/downloads/][/url][url=https://www.python.org/downloads/windows/]Python[/url] 3.11 或更高版本。如果缺失,页面会说明并提供下载。[/]
[]可选:7-Zip 或 WinRAR 用于转换 .7z 和 .rar 归档;第二个 MCP 服务器需要 WolvenKit CLI。[/]
[/list]
[size=5][b]安装[/b][/size]

[list=1]
[]使用"Manual download"下载 zip 并解压:其中包含一个文件 red-stack-1.0.0.vsix 和一个简短的 INSTALL.txt。[/]
[]在 VS Code 中:扩展视图,"..."菜单,"Install from VSIX..."。或在终端中:[i]code --install-extension red-stack-1.0.0.vsix[/i][/]
[]点击活动栏中的 Red Stack 图标。页面会要求两个文件夹:你的 zip 和游戏。[/]
[]然后它会提议读取游戏并根据已安装的内容创建第一个配置文件。此读取不会写入任何内容。[/]
[/list][b]不要用 Vortex 或将其安装到游戏文件夹中安装此文件,也不要把该 zip 归入你的模组中[/b]:它是 VS Code 扩展,不是游戏模组。

[size=5][b]须知[/b][/size]

[list]
[][b]你在已装过模组的游戏上的首次"应用"[/b]:与你的 zip 中文件完全相同的文件会被原样接管。存在但并非由 Red Stack 安装的文件会被显示并保持原样,直到你另行指示。[/]
[]Red Stack 期望一个 zip 文件夹,或每个类别一个文件夹。[/]
[]任何写入游戏的操作都必须关闭游戏。[/]
[]它不启动游戏,不管理存档,也不编辑归档的内容。[/]
[]Linux 和 Steam Deck:尚不支持。[/]
[]这是首个公开版本,作者每天在约 800 个模组上使用。尚未尝试的内容列在下方"尚未测试"中。[/]
[]截图使用了 [url=https://marketplace.visualstudio.com/items?itemName=vscode-icons-team.vscode-icons]vscode-icons[/url] 图标包,它与两套主题很搭配。[/]
[/list]
[size=5][b]尚未测试[/b][/size]

Red Stack 通过自动测试台在合成游戏和合成仓库上进行检查,并在一个真实环境上使用:其作者的。以下内容从未真实尝试过。如果你尝试了其中一项,欢迎报告,无论成功与否。
[list]
[][b]完全没有 Python 的机器[/b]:"未找到 Python"屏幕仅被模拟过。[/]
[][b]Python 3.8 至 3.10[/b]:有意拒绝。测试台仅在 3.11 和 3.15 上运行。[/]
[][b]免费 Nexus 账户[/b]:"Mod manager download"路径是根据 Nexus 文档构建的,仅在高级账户上尝试过。[/]
[][b]VSCodium 及其他 VS Code 分支[/b]:从未在那里安装过。[/]
[][b]在游戏中安装的 FOMOD[/b]:安装器被读取、显示和计划;没有在其结果上启动过游戏。[/]
[][b]从 Red Stack 更改加载顺序[/b](归档的游戏内名称、modlist.txt)以及脚本、调整、CET 和 REDmod 文件夹的[b]"游戏内名称"[/b]:在测试台上检查过,从未在游戏中启动过。[/]
[][b]"由 zip 替换"[/b]用于 Red Stack 未安装的文件:仅测试台。[/]
[][b]将已退役的 zip 删除到 Windows 回收站[/b]:测试台使用回收站的替代品。[/]
[][b]第二个 MCP 服务器[/b](WolvenKit CLI):它构建的内容由 CLI 读回,从未由游戏加载过。[/]
[][b]与作者差异很大的仓库[/b]:散装 zip 和自由文件夹名仅在测试台上玩过。[/]
[][b]翻译[/b]:每个文本均由 AI 撰写,包括法语;十种翻译均未由母语者校对。[/]
[/list]
[size=5][b]源码与许可[/b][/size]

MIT。一切均可阅读:引擎是一个仅使用标准库的 Python 文件,扩展是纯 JavaScript 无依赖。源码与 issue:[url=https://github.com/doublescotch/red-stack]github.com/doublescotch/red-stack[/url]

[size=5][b]致谢[/b][/size]

感谢 Conflict Studio 的作者提供代码冲突的检测规则,感谢 WolvenKit 团队,感谢 psiberx、WopsS、jac3km4 和 yamashi 提供此处每个模组所依赖的框架,以及感谢 Nexus Mods 提供其 API。