我同意,此时确实应该更新插件文档。“弃用”期的目标是在插件仍可运行但网站会发出即将失效的警告时,为插件作者留出足够的时间进行修复。然而,在这段期间内,即使是一支全职的付费开发团队也无法及时更新核心插件开发文档。在团队都难以在相同时间内完成的情况下,却对个体开发者提出这样的要求,实在有些不合常理。
这在我看来,说明开发速度过快,或者插件作者并非 Discourse 的优先关注对象。就我个人而言,更倾向于后者。我理解某些方面难免需要被搁置,因此这更多是我的观察,而非批评。Discourse 依然可以通过插件实现完全自定义,我也很感激其持续不断的改进。
话虽如此,我认为我们已处于这样一个节点:逐步式的插件构建指南已显得过时。如今,对于业余插件作者而言,只需一份供智能体阅读并生成插件骨架的上下文文档就足够了。事实上,对于像 Discourse 这样的开源代码库,甚至根本不需要文档,因为智能体可以直接从代码库本身获取上下文。在我开发插件的过程中,我看到 Claude 通过阅读现有插件来学习设计模式。我甚至借此在核心代码中发现了一个 bug:Chat Pitchfork timeouts: replies silently create threads and auto-tracking bloats over time
总之,对于任何有志成为业余插件作者的读者来说,尽管文档可能已过时,但如今构建插件的难度比以往任何时候都低了上千倍。