概况

此页面列出了有关该项目应知的基本信息。

版本类型

Phobos 主要有三种不同类型的版本：

• 稳定版本：采用常规版本号（例如 v1.2.3），并且理论上不包含任何此前已知的 Bug，可以安全地用于 Mod。

• 预发布版本：即之前的 开发版，此类构建标志着新发布分支的开始，用于在新功能最终确定前进行测试。它们的版本号由主版本号加上预发布后缀组成（例如 0.5-beta1、0.5-rc2）。Mod 作者可以在 Mod 中包含这些版本以获取最新功能，但我们无法保证它们没有 Bug。

• 自动构建版本：最前沿版本，可能包含原型机、理论验证、废弃功能等。换而言之我们无法保证这些版本的稳定性，它们仅应当用于协助 Phobos 开发和测试而绝不应该用于 Mod 的发布版本。

除了上述发布的构建版本，你在本地（通过 Visual Studio、VS Code 或构建脚本）生成的任何构建都会标记为 本地构建：与自动构建版本类似，它会标记有构建所基于的 git 提交和引用（例如 v0.5.0.0 @ abc1234-dirty @ refs/heads/develop），并显示一个可隐藏的「please test」警告。

提示

你可以在文档 主页面 找到这些版本的下载。

关闭预发布版本警告

免责声明：我们理解每个人都希望尽快体验新功能的愿望，但我们仅可进行基础的功能验证而无法完成全面的测试。我们要求所有用户在关闭预发布版本警告前务必通过各种方式全面测试变更内容，然后再将预发布版本使用于 Mod 的发布版本中。这将使我们能够专注于实现最复杂的核心功能。测试指南见 此处。

你可以通过在命令行参数 -HideVersionWarning= 后面指定所使用的构建的确切版本号来隐藏该警告（例如 -HideVersionWarning=0.5.0.0-beta1 将隐藏 Phobos v0.5-beta1 预发布版的警告）。该版本号会显示在警告信息以及对应发布的标题中；每个构建只接受其自身的版本号，因此每当更新 Phobos 时都需要同步更新该开关参数。自动构建版完全不支持隐藏警告。

存档过滤

得益于 Ares0.A 公开的源码范例，Phobos 完全支持存读档功能，并且实现了独立的过滤机制，这与 Ares 的存档过滤机制没有冲突。由于 Phobos 扩展类几乎在每个版本都有所变动，所以不同版本间的存档互不兼容。某个版本的预发布版与其所对应的稳定版共享存档 ID，因此它们的存档会被视为同一版本进行过滤。而自动构建版和本地构建版属于前沿快照，会完全跳过这种基于版本的过滤——每个快照都是独一无二的，因此它们的存档永远不会按版本进行过滤。

兼容性

Phobos 需要 SyringeEx（v0.1.0.2 及以上版本）作为启动器——它依赖于旧版 Syringe 所不具备的功能（通过 SyringeEx 特性标志发出信号），如果没有这些功能，它将在启动时显示错误并退出。

Phobos 虽然可以独立运行，但其设计初衷是与 Ares 以及 CnCNet5 Spawner 搭配使用。新增或改进功能时都会考虑与它们的兼容性。

尽管我们也希望支持 HAres，但由于其用户群体及开发者与国际社区分离，所以我们无法保证兼容性。但我们欢迎就此问题提供任何帮助！

API 版本管理

参见 互操作性。