变更日志和向后兼容性¶

版本¶

由于该库的功能具有研究性质，因此可能会出现向后不兼容的更改。但我们会通过以下方式尽量减少对用户的干扰。

列在 API 文档中的 API，包括函数/类名称、参数以及已记录的类属性，除非文档中另有说明，否则被认为是稳定的。它们不太可能被破坏，但如果需要，将在被破坏之前发出弃用警告，并在版本日志中记录。
其他函数/类/属性被视为内部函数，更可能发生变化。然而，我们意识到其中一些可能已经被其他项目使用，特别是我们可能在 detectron2/projects 下的项目之间为了方便而使用它们。对于这样的 API，我们可能会将其视为稳定 API 并同样应用上述策略。当我们准备好时，它们可能会被提升为稳定 API。
“detectron2/projects” 下的项目或使用“detectron2.projects” 导入的项目是研究项目，都被认为是实验性的。
包含“default”一词的类/函数或明确记录为生成“默认行为”的类/函数可能会在添加新功能时改变其行为。

尽管可能会出现破坏，但如果第三方项目希望跟上 detectron2 中的最新更新，将其用作库仍然比派生更少破坏性，因为 API 更改的频率和范围远小于代码更改。

要查看这些更改，请在版本日志中搜索“不兼容更改”。

自开源以来，Detectron2 的配置版本一直没有更改。开源用户无需担心这个问题。

我们列出了几个静默回归，因为它们可能会静默地生成错误的结果，并且难以调试。