Merge pull request #5 from simple-robot/dev/main

Release: v0.0.3

.changelog/v0.0.3.md

@@ -0,0 +1,7 @@
+> 对应核心版本: [**v4.0.0-RC2**](https://github.com/simple-robot/simpler-robot/releases/tag/v4.0.0-RC2)
+
+
+我们欢迎并期望着您的的[反馈](https://github.com/simple-robot/simbot-component-onebot/issues)或[协助](https://github.com/simple-robot/simbot-component-onebot/pulls)，
+感谢您的贡献与支持！
+
+也欢迎您为我们献上一颗 `star`，这是对我们最大的鼓励与认可！

.gitignore

@@ -41,3 +41,5 @@ bin/
 
 ### Mac OS ###
 .DS_Store
+
+.kotlin

CONTRIBUTING.md

@@ -9,6 +9,11 @@
 你可以通过创建 [拉取请求(pull request)][OB-PR] 的方式提供代码方面的贡献（例如某些功能的实现或问题的修复、某些错误文档注释的修正等），
 或者通过 [议题反馈(issues)][OB-IS] 的方式以问题反馈的方式做出贡献。
 
+### 开发分支
+
+请将您的修改提交、合并到 **`dev/main`** 分支。
+`master` 分支是作为最后一次版本发布的内容分支，而不是开发分支。
+
 ### 拉取请求
 
 **议题讨论**
@@ -24,9 +29,6 @@
 如果是首次贡献，你需要将[OB组件][OB-GH]fork至你的账户中，然后克隆你fork后的项目并在其中做出更改。
 否则，你需要查看并确保你要进行开发的内容主分支是最新的。
 
-> 最终合并的目标分支可以在前文所述的议题中讨论，但是一般来讲它是项目的默认分支。
-> 早期开发阶段，它可能是最原始的 `master` 或 `main`；在早期开发阶段结束后，它通常是 `dev/main` 等开发分支。（以实际情况为准）
-
 如果是首次拉取项目，你可以参考下文 [构建并校验项目](#构建并校验项目) 中的内容来了解如何构建项目。
 
 **编写代码**

README.md

@@ -288,16 +288,25 @@ public class MyApp {
 
 目前可监听到的**组件事件**：
 
-- `OneBotMessageEvent`
-    - `OneBotGroupMessageEvent`
-        - `OneBotNormalGroupMessageEvent`
-        - `OneBotAnonymousGroupMessageEvent`
-        - `OneBotNoticeGroupMessageEvent`
-    - `OneBotPrivateMessageEvent`
-        - `OneBotFriendMessageEvent`
-        - `OneBotGroupPrivateMessageEvent`
-- `OneBotUnknownEvent`
-- `OneBotUnsupportedEvent`
+- `OneBotMessageEvent` 消息事件
+    - `OneBotGroupMessageEvent` 群消息事件
+        - `OneBotNormalGroupMessageEvent` 普通群消息事件
+        - `OneBotAnonymousGroupMessageEvent` 匿名群消息事件
+        - `OneBotNoticeGroupMessageEvent` 群系统通知消息事件
+    - `OneBotPrivateMessageEvent` 私聊消息事件
+        - `OneBotFriendMessageEvent` 好友私聊消息事件
+        - `OneBotGroupPrivateMessageEvent` 群成员临时会话私聊事件
+- `OneBotMetaEvent` 元事件
+    - `OneBotLifecycleEvent` 生命周期事件
+    - `OneBotHeartbeatEvent` 心跳事件
+- `OneBotRequestEvent` 请求事件
+  - `OneBotFriendRequestEvent` 好友添加请求事件
+  - `OneBotGroupRequestEvent` 群添加请求事件
+- `OneBotUnknownEvent` 未知事件
+- `OneBotUnsupportedEvent` 未支持事件
+- `OneBotBotStageEvent` 组件内Bot阶段事件
+  - `OneBotBotRegisteredEvent` Bot被注册了事件
+  - `OneBotBotStartedEvent` Bot被(首次)启动了事件
 
 其中，可以通过 `OneBotUnsupportedEvent` 和 `OneBotUnknownEvent`
 来间接地监听那些尚未提供组件事件类型的原始事件。

Writerside/topics/Event.md

@@ -91,9 +91,43 @@
 </def>
 </deflist>
 
+</def>
+<def id="OneBotMetaEvent" title="OneBotMetaEvent">
+元数据相关的事件
+<deflist>
+<def id="OneBotLifecycleEvent" title="OneBotLifecycleEvent">
+生命周期事件
+</def>
+<def id="OneBotHeartbeatEvent" title="OneBotHeartbeatEvent">
+心跳事件
+</def>
+</deflist>
+</def>
+<def id="OneBotRequestEvent" title="OneBotRequestEvent">
+请求相关的事件
+<deflist>
+<def id="OneBotFriendRequestEvent" title="OneBotFriendRequestEvent">
+好友添加申请
+</def>
+<def id="OneBotGroupRequestEvent" title="OneBotGroupRequestEvent">
+群添加申请
 </def>
 </deflist>
+</def>
+
 
+<def id="OneBotBotStageEvent" title="OneBotBotStageEvent">
+与OneBot协议本身无关的Bot的阶段事件。
+<deflist>
+<def id="OneBotBotRegisteredEvent" title="OneBotBotRegisteredEvent">
+一个 `OneBotBot` 被注册了的事件
+</def>
+<def id="OneBotBotStartedEvent" title="OneBotBotStartedEvent">
+一个 `OneBotBot` 被(首次)启动了的事件
+</def>
+</deflist>
+</def>
+</deflist>
 
 
 ### 未知事件

Writerside/v.list

@@ -5,6 +5,6 @@
     <var name="api-doc" value="https://docs.simbot.forte.love"/>
     <var name="jb" value="阻塞"/>
     <var name="ja" value="异步"/>
-    <var name="version" value="0.0.2"/>
+    <var name="version" value="0.0.3"/>
     <var name="minimum-core-version" value="4.0.0-RC2"/>
 </vars>

buildSrc/src/main/kotlin/P.kt

@@ -41,7 +41,7 @@ object P {
         override val homepage: String get() = HOMEPAGE
 
 
-        private val baseVersion = v(0, 0, 2)
+        private val baseVersion = v(0, 0, 3)
 
         val snapshotVersion = baseVersion - Version.SNAPSHOT
         override val version = if (isSnapshot()) snapshotVersion else baseVersion