工作区

上次更新

适合谁？

工作区专为整合包开发者打造——即创建和维护整合包的人。

如果你导入的是别人的整合包，则不需要此功能。你的 import/ 文件夹是只读的，游戏从 live/ 正常运行。你唯一可能打开工作区的情况是——当某个文件损坏时，从 import/ 恢复原始文件到 live/——但这种情况很少发生。

问题所在

当你开发整合包时，你在游戏内进行配置：视频设置、模组配置、世界生成选项。这些修改保存在 live/ 中。但 import/——你的整合包可分发的源文件——始终保持不变。你修改了配置，却不知道哪些文件发生了变化，也不知道如何将它们提升回整合包。这就是工作区要解决的问题。

打开工作区

1. 选择你的实例。
2. 切换到 Workspace 标签页。

工作区会显示 import/ 与 live/ 的并排比较。

理解差异

工作区检测三种类型的变化：

示例：配置调整

你启动了游戏并为整合包调整了性能设置。修改保存在 live/config/ 中，而原始文件位于 import/config/。工作区会精确显示哪些文件发生了变化以及它们之间的差异。

同步修改

同步有两个方向，各有不同的用途。

提升：live → import（主要方向）

这是主要的工作流程。当你在 live/ 中看到想要保留到整合包中的修改时：

1. 在工作区中选择该文件。
2. 点击 Sync to Import。
3. 文件从 live/ 复制到 import/。

该修改现在成为了整合包源的一部分。在你导出或更新整合包时，它将被包含在内。

你可以选择多个文件并一次性同步——这在你调整了许多配置文件之后非常有用。

恢复：import → live（辅助方向）

如果游戏内的修改出了问题，你想恢复原始文件：

1. 在工作区中选择该文件。
2. 点击 Sync to Live。
3. 文件从 import/ 复制到 live/，覆盖你的本地修改。

这将恢复该文件的整合包原始版本。

整合包作者工作流

这是工作区的主要使用场景：

1. 构建整合包并将初始配置添加到 import/。
2. 启动游戏并在游戏内完成所有配置（修改保存到 live/）。
3. 打开工作区，查看哪些内容发生了变化。
4. 将确认的修改从 live/ 提升到 import/。
5. 导出或提交到 Git。

在迭代整合包的过程中重复此循环。

与 Git 的关系

如果你使用 Git 管理整合包（参见 整合包开发），工作区可以自然地融入版本控制：

1. import/ 由 Git 跟踪。
2. live/ 在 .gitignore 中。
3. 从 live/ 同步到 import/ → 然后 git commit。

可以将 live/ 视为你的工作树，import/ 视为暂存区，git commit 视为最终步骤。