release: v0.0.2

Author: ForteScarlet

.changelog/v0.0.2.md

@@ -0,0 +1,52 @@
+> 对应核心版本: [**v4.0.0-RC2**](https://github.com/simple-robot/simpler-robot/releases/tag/v4.0.0-RC2)
+
+> [!warning]
+> 当前版本处于 `0.x` 的早期版本，可能存在各种问题。
+
+我们欢迎并期望着您的的[反馈](https://github.com/simple-robot/simbot-component-onebot/issues)或[协助](https://github.com/simple-robot/simbot-component-onebot/pulls)，
+感谢您的贡献与支持！
+
+也欢迎您为我们献上一颗 `star`，这是对我们最大的鼓励与认可！
+
+## 事件监听
+
+目前可监听到的**组件事件**：
+
+- `OneBotMessageEvent`
+    - `OneBotGroupMessageEvent`
+        - `OneBotNormalGroupMessageEvent`
+        - `OneBotAnonymousGroupMessageEvent`
+        - `OneBotNoticeGroupMessageEvent`
+    - `OneBotPrivateMessageEvent`
+        - `OneBotFriendMessageEvent`
+        - `OneBotGroupPrivateMessageEvent`
+- `OneBotUnknownEvent`
+- `OneBotUnsupportedEvent`
+
+其中，可以通过 `OneBotUnsupportedEvent` 和 `OneBotUnknownEvent`
+来间接地监听那些尚未提供组件事件类型的原始事件。
+
+OB11协议中的事件类型均有实现。
+
+## 已知隐患
+
+**1: 根据来源的不同，部分 actor 的实现中部分属性或API可能无法获取到值。**
+
+例如在群成员的临时会话私聊事件 `OneBotGroupPrivateMessageEvent` 中，
+无法根据事件信息获取到这个成员所属的群，因此 `event.source()` 会抛出异常。
+
+**2: API的反序列化如果存在缺失字段则可能没有用于填充的默认值**
+
+API的响应结果如果存在部分属性的缺失，可能会出现异常。
+
+**3: 查询相关的API无法明确‘未找到’**
+
+协议中没有约定当一个目标‘未找到’的时候的结果（例如查询id为 `123` 的群成员），
+不明确到底是响应了 404 还是有某个 `retcode`。
+
+因此目前当“未找到”的情况出现时，
+会抛出API的响应异常而不是得到预期的 `null`。
+
+**4: 暂无文档和手册**
+
+字面意思。还没来得及写，但是有[API文档](https://docs.simbot.forte.love)。