关于 CommentSubject 发现/选择机制问题

[JayFans2000]

前置条件

• 已经在 issues 列表中搜索了相关问题。
• 这是 Halo 项目本身存在的问题，如果是非项目本身的问题（如：安装部署问题），建议在 Discussions 提交。
• 已经尝试过停用所有的插件，排除是插件导致的问题。
• 如果是插件和主题的问题，请在对应的插件和主题仓库提交。

系统信息

• halo版本: 2.22.12
• 已启动插件：plugin-links 及 plugin-comments
• 插件版本：最新版

使用的哪种方式运行？

Docker Compose

发生了什么？

在对plugin-equipments进行前台评论功能适配及后台获取评论来源开发时：

发现当多个插件都实现 CommentSubject<Plugin> 后，Halo 只能使用第一个supports()的实现来处理所有 Plugin 类型的评论。

状态	评论来源显示
只启用 plugin-equipment	✅ 正确显示"装备"
只启用 plugin-links	✅ 正确显示"链接"
两个都启用	❌ 全部显示"链接"（冲突）

希望各方能修复：多个 CommentSubject 能够正确按 supports() 结果选择对应的处理器。

复现步骤

1. 关闭 plugin-links 后，评论来源正确显示为"装备"

说明我插件里 CommentSubject 实现是正确的

2. plugin-links 的评论显示为"未知"

因为我关闭了plugin-links插件，即CommentSubject 被禁用了

3. 通过排查equipment插件的日志输出情况，日志中没有 getSubjectDisplay() 的调用，但评论来源正确显示了

也就说明问题是两个插件的 CommentSubject 实现存在冲突。当两个插件都启用时，Halo 可能只选择其中一个（如plugin-links 的）来处理所有 Plugin 类型的评论。

相关日志输出

附加信息

No response

[chengzhongxue]

plugin-equipment 都没有给评论来源， 你装备设置了评论？还有你是什么主题

[JayFans2000]

plugin-equipment 都没有给评论来源， 你装备设置了评论？还有你是什么主题

哈哈!感谢原鱼佬回复.我对你的插件做了一些修改.用的是Sky Blog Theme

comments评论数据源我测试了是没问题的,但是Halo 只能使用第一个supports()的实现来处理所有 Plugin 类型的评论😵

https://cloudlark.cn/equipments

[chengzhongxue]

plugin-equipment 都没有给评论来源， 你装备设置了评论？还有你是什么主题

哈哈!我对你的插件做了一些修改.用的是Sky Blog Theme

https://cloudlark.cn/equipments

你是自己对插件做了修改？ 还是页面

[JayFans2000]

是对插件做了修改.

[chengzhongxue]

是对插件做了修改.

https://github.com/halo-sigs/plugin-links/pull/112/changes#diff-d9644b1963f71f7604929902301f73d792acbceb9f26277b6500e40b263df420

[chengzhongxue]

那有问题可能是你自己改出问题了

[JayFans2000]

鱼佬qq我扣你,我在鱼圈

[JayFans2000]

@ruibaby

经过讨论（冲突的根源）：

Halo 的 CommentSubject 扩展点是基于 GVK (Group/Version/Kind) 来路由的。如果 plugin-links 和 plugin-equipment 都声称 plugin.halo.run/v1alpha1/Plugin 这个资源类型，那么当系统需要显示评论来源时，它会遍历所有的 CommentSubject 实现。

1. supports() 的竞争：

如果两个插件的 supports() 都返回 true，Halo 通常只会采用加载顺序靠前的那个实现。
即便在 supports() 里通过 name（比如 links 或 equipment）做了区分，但在 UI 前端，很多逻辑是基于 Kind 绑定的。如果 Kind 相同，前端扩展点就会产生覆盖或混淆。

2. 自定义 GVK 的必要性：

通过定义 equipment.kunkunyu.com/EquipmentPage，为装备插件新建了一个独立的命名空间。

这样，EquipmentCommentSubject 就成了这个特定 GVK 的唯一权威处理者。

这样就能解决后端 getSubjectDisplay 的冲突，并且让前端扩展点 comment:subject-ref:create 能够通过唯一的 kind 和 group 精确匹配到对应的跳转链接和提示文字。

参考示例：plugin-equipment

[ruibaby]

原 issue 的意思是你修改 Equipment 插件来支持评论，并参考 https://github.com/halo-sigs/plugin-links/blob/main/src/main/java/run/halo/links/LinkCommentSubject.java 的实现，但是最终只能有一个插件可以正常显示是吗？

[chengzhongxue]

原 issue 的意思是你修改 Equipment 插件来支持评论，并参考 https://github.com/halo-sigs/plugin-links/blob/main/src/main/java/run/halo/links/LinkCommentSubject.java 的实现，但是最终只能有一个插件可以正常显示是吗？

他用了同样的group和kind

[JayFans2000]

是的，就如我上面写的的状态表。最终我只能通过自定义GVK的方式去解决。