Discourse 主题中的版本列表无效

不完全是,但也许可以这么说。

出现该错误的原因有很多。最常见的原因可能是 .discourse-compatibility 文件为空 [1][2][3]。(开头的 # 是注释行)

实际上,该警告意味着 Discourse 无法确定当前组件/插件的“最新”版本是否与当前的 Discourse 版本兼容,或者是否需要检出该组件/插件的旧版本。

组件/插件的 .discourse-compatibility 文件可以包含 Discourse 版本范围与组件/插件特定修订版之间的映射。如果 Discourse 找到映射,它将使用该修订版而不是最新版本。这就要求开发者在做出与先前 Discourse 版本不兼容的更改时更新该文件。只要您没有做出破坏性更改,该文件就会保持为空,从而产生该警告消息。

组件/插件是否与 Discourse 的最新版本兼容始终只是一个猜测。

我开始为 2026.1 开发一个插件,因此这将是 Discourse 的最低版本。它仍在针对该版本(以及当前最新版本)进行开发和测试。由于没有较旧的支持版 Discourse 版本,.discourse-compatibility 文件为空;因此产生了此警告消息。一旦 2026.1 停止支持,我将转向新的 ESR(扩展支持版本)。到那时,我将不再针对 2026.1 进行测试,因此我会更新 .discourse-compatibility 文件,使其最终非空。只有那时,我的插件才会不再显示此警告。

有关此 .discourse-compatibility 文件的更多信息:Introducing .discourse-compatibility: pinned plugin/theme versions for older Discourse versions