feat: 增加 CustomOneBotApi 类型，支持动态构建任意自定义API实例 (#249)

* feat(api): implement BasicOneBotApi and CustomOneBotApi with builder support

* feat(api): update .gitignore and add copyright management configuration

close #219

* feat(api): add default empty block parameter to CustomOneBotApiBuilder

* feat(api): refactor CustomOneBotApi and CustomOneBotApiBuilder for improved readability

---------

Co-authored-by: ForteScarlet <[email protected]>

Author: ForliyScarlet

.gitignore

@@ -5,11 +5,13 @@ build/
 !**/src/test/**/build/
 
 ### IntelliJ IDEA ###
-.idea
-.idea/modules.xml
-.idea/jarRepositories.xml
-.idea/compiler.xml
-.idea/libraries/
+.idea/**
+!.idea/scopes/
+!.idea/scopes/*
+!.idea/copyright/
+!.idea/copyright/*
+!.idea/.gitignore
+
 *.iws
 *.iml
 *.ipr

.idea/copyright/profiles_settings.xml

@@ -1,18 +1,24 @@
 /*
- * Copyright (c) 2024. ForteScarlet.
+ *     Copyright (c) 2024-2025. ForteScarlet.
  *
- * This file is part of simbot-component-onebot.
+ *     Project    https://github.com/simple-robot/simbot-component-onebot
+ *     Email      [email protected]
  *
- * simbot-component-onebot is free software: you can redistribute it and/or modify it under the terms
- * of the GNU Lesser General Public License as published by the Free Software Foundation,
- * either version 3 of the License, or (at your option) any later version.
+ *     This project and this file are part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
  *
- * simbot-component-onebot is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
- * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU Lesser General Public License for more details.
+ *     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
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     Lesser GNU General Public License for more details.
+ *
+ *     You should have received a copy of the Lesser GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  *
- * You should have received a copy of the GNU Lesser General Public License along with simbot-component-onebot.
- * If not, see <https://www.gnu.org/licenses/>.
  */
 
 import io.gitlab.arturbosch.detekt.Detekt
@@ -139,7 +145,10 @@ apiValidation {
             "love.forte.simbot.component.onebot.common.annotations.SourceEventConstructor",
 
             // CustomEventResolver
-            "love.forte.simbot.component.onebot.v11.core.event.ExperimentalCustomEventResolverApi"
+            "love.forte.simbot.component.onebot.v11.core.event.ExperimentalCustomEventResolverApi",
+
+            // CustomOneBotApi
+            "love.forte.simbot.component.onebot.v11.core.api.ExperimentalCustomOneBotApi"
         ),
     )
 

.idea/copyright/simbot4_component_onebot.xml

@@ -1,23 +1,26 @@
 /*
- * Copyright (c) 2023-2025. ForteScarlet.
+ *     Copyright (c) 2023-2025. ForteScarlet.
  *
- * This file is part of simbot-component-onebot.
+ *     Project    https://github.com/simple-robot/simbot-component-onebot
+ *     Email      [email protected]
  *
- * simbot-component-onebot is free software: you can redistribute it and/or modify it under the terms
- * of the GNU Lesser General Public License as published by the Free Software Foundation,
- * either version 3 of the License, or (at your option) any later version.
+ *     This project and this file are part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
  *
- * simbot-component-onebot is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
- * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU Lesser General Public License for more details.
+ *     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
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     Lesser GNU General Public License for more details.
+ *
+ *     You should have received a copy of the Lesser GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
  *
- * You should have received a copy of the GNU Lesser General Public License along with simbot-component-onebot.
- * If not, see <https://www.gnu.org/licenses/>.
  */
 
-import P.ComponentOneBot.developers
-import P.ComponentOneBot.licenses
-import P.ComponentOneBot.scm
 import love.forte.gradle.common.core.project.ProjectDetail
 import love.forte.gradle.common.core.property.systemProp
 
@@ -41,7 +44,7 @@ object P {
         override val homepage: String get() = HOMEPAGE
 
         const val VERSION = "1.8.2"
-        const val NEXT_VERSION = "1.8.3"
+        const val NEXT_VERSION = "1.9.0-Beta1"
 
         override val snapshotVersion = "$NEXT_VERSION-SNAPSHOT"
         override val version = if (isSnapshot()) snapshotVersion else VERSION