特性速览

Kotlin 多平台

早在 simbot2 时代就已经开始畅想的，现在终于实现了。 simbot4 现已基于 KMP 全面支持 Kotlin 多平台。

Java友好

贯彻一直以来的特点，simbot4也同样是Java友好的，包括对所有挂起函数API的非挂起桥接、Spring Boot支持等。

更多内容参考 Java友好 ♥。

Kotlin 2.0 与 K2 编译器

simbot4 的目标是构建在 Kotlin 2.0 (与K2 编译器) 之上的。

Java最低版本

JVM 平台中，Java最低要求为 Java11，并且所有模块都提供相应的模块化信息支持。

JVM 平台中，Spring Boot starter 的实现最低要求使用 Spring Boot 3，也因此在使用 starter 的时候 Java 需要确保版本为 Java17+。

过滤器的概念

移除 “过滤器(Filter)” 概念，加强 “拦截器(Interceptor)” 能力。 (在注解API中依旧保有 @Filter 注解。)

过滤器与拦截器的概念有些重复了，在 simbot3 中的监听函数类型的实现也因为了实现 “过滤器”概念而变得有些抽象且难以扩展。

大幅简化API

与 simbot3 相比，API大幅简化。并得益于此，组件开发成本和核心库的维护成本都大大下降。

部分细节

移除了 Event.Key 与 Message.Element.Key 的机制。这两个机制是增加开发繁琐度最主要的原因之一，而且可以说几乎没有什么实用性。
优化、并大幅简化 "行为对象" (例如 Guild、 Channel) 的 API 与相互关系。相互关系方案变更为单向由上到下传递。
举个例子，在 simbot3 中， Guild.channel(...) 可以获取到频道服务器内某个子频道，而 Channel.guild() 则可以反向获取自己所属的 Guild。
val guild = ... val channel = guild.channel(1.ID) // 正向获取 Channel val guildAgain = channel.guild() // 反向获取 Guild
放在 Guild <-> Channel <-> Member 上同理，它们之间总是双向关联的。但是这样实际上没有太大的易用性收益: 你既然能够获取到 Channel ，那么 Guild 便是已知的。而这种设计代来的最大的负面影响就是极大的增加了开发的工作量和复杂度。
因此，simbot4 将它们的关系重新设计为单向关联、由上至下，即 Guild 可以得到 Channel，而 Channel 不能回头获取 Guild 。对于某种类型实现，让它专注于自身。
事件定义优化、简化。除了上面提到的移除了 Event.Key 机制以外，事件内的属性信息也得到了简化。
举个例子，在 simbot3 中，有两个事件： OrganizationEvent、 GuildEvent，它们分别对外提供 organization 和 guild 属性。而又因为 Guild 继承 Organization ，所以实际上这两个属性是同一回事儿。
interface GuildEvent : OrganizationEvent { suspend fun guild(): Guild // 样板式的“重定向”代码 suspend fun organization(): Guild = guild() }
重点就在这里，这里只列举了两个具有关系的事件，但是实际上这种同义不同名的属性非常之多。
interface GuildEvent : OrganizationEvent, ChangedEvent, ContentEvent { suspend fun guild(): Guild // 样板式的“重定向”代码 suspend fun organization(): Guild = guild() suspend fun after(): Guild = guild() suspend fun content(): Guild = guild() }
这就导致当需要重写覆盖返回值类型为一个新的类型时，会产生非常多的样板代码。
在 simbot4 中，我们简化并尽力去避免出现同义不同名的事件属性，以 ContentEvent 和 SourceEvent 为主要原点，使用同义同名的属性来层层融合。
interface OrganizationEvent : ContentEvent { override suspend fun content(): Organization } interface GuildEvent : OrganizationEvent { override suspend fun content(): Guild // 同义同名, 直接重写覆盖 }

Simple Robot v4.7.0 Help