补充部分注释

Author: ForteScarlet

simbot-api/src/commonMain/kotlin/love/forte/simbot/ability/ReplySupport.kt

@@ -1,10 +1,10 @@
 /*
- *     Copyright (c) 2024. ForteScarlet.
+ *     Copyright (c) 2024-2025. ForteScarlet.
  *
  *     Project    https://github.com/simple-robot/simpler-robot
  *     Email      [email protected]
  *
- *     This file is part of the Simple Robot Library.
+ *     This file is part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
  *
  *     This program is free software: you can redistribute it and/or modify
  *     it under the terms of the GNU Lesser General Public License as published by
@@ -23,6 +23,7 @@
 
 package love.forte.simbot.ability
 
+import love.forte.simbot.event.InternalInterceptionException
 import love.forte.simbot.event.MessageEvent
 import love.forte.simbot.message.Message
 import love.forte.simbot.message.MessageContent
@@ -45,6 +46,8 @@ public interface ReplySupport {
      * 发送一段纯文本消息。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun reply(text: String): MessageReceipt
@@ -53,6 +56,8 @@ public interface ReplySupport {
      * 发送一个消息 [Message]。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun reply(message: Message): MessageReceipt
@@ -63,6 +68,8 @@ public interface ReplySupport {
      * 并在不支持的情况下降级为使用 [MessageContent.messages]。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun reply(messageContent: MessageContent): MessageReceipt

simbot-api/src/commonMain/kotlin/love/forte/simbot/ability/SendSupport.kt

@@ -1,10 +1,10 @@
 /*
- *     Copyright (c) 2024. ForteScarlet.
+ *     Copyright (c) 2024-2025. ForteScarlet.
  *
  *     Project    https://github.com/simple-robot/simpler-robot
  *     Email      [email protected]
  *
- *     This file is part of the Simple Robot Library.
+ *     This file is part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
  *
  *     This program is free software: you can redistribute it and/or modify
  *     it under the terms of the GNU Lesser General Public License as published by
@@ -25,6 +25,7 @@ package love.forte.simbot.ability
 
 import love.forte.simbot.definition.Actor
 import love.forte.simbot.definition.Contact
+import love.forte.simbot.event.InternalInterceptionException
 import love.forte.simbot.message.Message
 import love.forte.simbot.message.MessageContent
 import love.forte.simbot.message.MessageReceipt
@@ -42,6 +43,8 @@ public interface SendSupport {
      * 发送一段纯文本消息。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun send(text: String): MessageReceipt
@@ -50,6 +53,8 @@ public interface SendSupport {
      * 发送一个消息 [Message]。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun send(message: Message): MessageReceipt
@@ -60,6 +65,8 @@ public interface SendSupport {
      * 并在不支持的情况下降级为使用 [MessageContent.messages]。
      *
      * @return 消息发送成功后的回执
+     * @throws InternalInterceptionException 在拦截事件处理过程中产生的异常，
+     * 每一个具体的异常都会被收集在 [InternalInterceptionException.suppressedExceptions] 中。
      * @throws Exception 可能产生任何异常
      */
     public suspend fun send(messageContent: MessageContent): MessageReceipt

simbot-api/src/commonMain/kotlin/love/forte/simbot/event/InternalEvent.kt

@@ -56,15 +56,23 @@ public interface InternalNotificationEvent : InternalEvent
  * 例如针对 [SendSupport.send][love.forte.simbot.ability.SendSupport.send]
  * 进行拦截，并改变其入参。
  *
- * 在拦截过程中产生的异常应当最终在内部被包装为 [InternalInterceptionException] 再抛出。
+ * ## 异常处理
+ *
+ * 在拦截过程中，如果产生了异常，它们不会影响后续事件的继续调度，
+ * 而所有产生的异常都会被收集到 [InternalInterceptionException.suppressedExceptions] 中，
+ * 并在最终抛出并影响原函数的执行。
  *
  * @since 4.11.0
  *
  */
 public interface InternalInterceptionEvent : InternalEvent
 
 /**
- * [InternalInterceptionEvent] 中产生的异常的包装。
+ * [InternalInterceptionEvent] 中产生的异常的收集与包装。
+ * 更多参考 [InternalInterceptionEvent] 中有关异常的说明。
+ *
+ * @see InternalInterceptionEvent
+ * @since 4.11.0
  */
 public open class InternalInterceptionException : RuntimeException {
     public constructor() : super()