initial: 基本完成的首个版本, 还需要调整一下.

暂时按照当初的计划实现了一个可用版本出来, 发布与否晚些再确定.

scalabot-extension/build.gradle.kts

@@ -0,0 +1,20 @@
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
+
+plugins {
+    kotlin("jvm") version "1.6.10"
+    java
+}
+
+dependencies {
+    api("org.telegram:telegrambots-abilities:5.6.0")
+    api("org.slf4j:slf4j-api:1.7.32")
+    testImplementation(kotlin("test"))
+}
+
+tasks.test {
+    useJUnitPlatform()
+}
+
+tasks.withType<KotlinCompile> {
+    kotlinOptions.jvmTarget = "11"
+}

scalabot-extension/src/main/java/net/lamgc/scalabot/extension/BotExtensionFactory.java

@@ -0,0 +1,31 @@
+package net.lamgc.scalabot.extension;
+
+import org.telegram.abilitybots.api.bot.BaseAbilityBot;
+import org.telegram.abilitybots.api.util.AbilityExtension;
+
+import java.io.File;
+
+/**
+ * 该接口用于为指定的 {@link BaseAbilityBot} 创建扩展.
+ *
+ * <p> 由于 AbilityExtension 无法直接获取 {@link BaseAbilityBot} 所属的 {@link org.telegram.abilitybots.api.db.DBContext} 对象,
+ * 所以将通过该接口工厂来创建扩展对象.
+ *
+ * @author LamGC
+ */
+public interface BotExtensionFactory {
+
+    /**
+     * 为给定的 {@link BaseAbilityBot} 对象创建扩展.
+     *
+     * <p> 如扩展无使用 {@link org.telegram.abilitybots.api.db.DBContext} 的话,
+     * 也可以返回扩展单例, 因为 AbilityBot 本身并不禁止多个机器人共用一个扩展对象
+     * (因为 AbilityBot 只是调用了扩展中的方法来创建了功能对象).
+     *
+     * @param bot             机器人对象.
+     * @param shareDataFolder ScalaBot App 为扩展提供的数据目录, 建议存储在数据目录中, 便于数据的存储管理.
+     * @return 返回为该 Bot 对象创建的扩展对象.
+     */
+    AbilityExtension createExtensionInstance(BaseAbilityBot bot, File shareDataFolder);
+
+}

scalabot-extension/src/main/java/net/lamgc/scalabot/extension/ScalaBotExtension.java

@@ -0,0 +1,32 @@
+package net.lamgc.scalabot.extension;
+
+import org.telegram.abilitybots.api.bot.BaseAbilityBot;
+import org.telegram.abilitybots.api.db.DBContext;
+import org.telegram.abilitybots.api.sender.MessageSender;
+import org.telegram.abilitybots.api.util.AbilityExtension;
+
+/**
+ *
+ */
+public abstract class ScalaBotExtension implements AbilityExtension {
+
+    /**
+     * 扩展所属的机器人对象.
+     *
+     * <p> 不要给该属性添加 Getter, 会被当成 Ability 添加, 导致出现异常.
+     */
+    protected final BaseAbilityBot bot;
+
+    public ScalaBotExtension(BaseAbilityBot bot) {
+        this.bot = bot;
+    }
+
+    protected MessageSender getSender() {
+        return bot.sender();
+    }
+
+    protected DBContext getDBContext() {
+        return bot.db();
+    }
+
+}