qqbot-elysia 0.1.0

package/src/logger.ts

@@ -0,0 +1,197 @@
+// ============================================================
+// QQ Bot SDK — 日志系统
+// ============================================================
+
+import log4js from "log4js";
+
+// ─── ANSI 颜色码 ─────────────────────────────────────────────
+
+const COLORS = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+
+    // 前景色
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    magenta: "\x1b[35m",
+    blue: "\x1b[34m",
+    white: "\x1b[37m",
+    gray: "\x1b[90m",
+
+    // 背景色
+    bgCyan: "\x1b[46m",
+    bgGreen: "\x1b[42m",
+    bgYellow: "\x1b[43m",
+    bgRed: "\x1b[41m",
+    bgMagenta: "\x1b[45m",
+    bgBlue: "\x1b[44m",
+    bgWhite: "\x1b[47m",
+} as const;
+
+// ─── 模块标签颜色映射 ────────────────────────────────────────
+
+const MODULE_COLORS: Record<string, string> = {
+    Bot: `${COLORS.bold}${COLORS.bgMagenta}${COLORS.white}`,
+    Auth: `${COLORS.bold}${COLORS.bgBlue}${COLORS.white}`,
+    QQAPI: `${COLORS.bold}${COLORS.bgCyan}${COLORS.white}`,
+    Webhook: `${COLORS.bold}${COLORS.bgGreen}${COLORS.white}`,
+    Event: `${COLORS.bold}${COLORS.bgYellow}${COLORS.white}`,
+    Matcher: `${COLORS.bold}${COLORS.bgWhite}${COLORS.magenta}`,
+};
+
+// ─── 自定义 Layout ───────────────────────────────────────────
+
+log4js.addLayout("qqbot", () => {
+    return (logEvent) => {
+        const { level, categoryName, data } = logEvent;
+        const time = new Date(logEvent.startTime);
+
+        // 格式化时间 HH:mm:ss.SSS
+        const timeStr =
+            `${COLORS.gray}${String(time.getHours()).padStart(2, "0")}:` +
+            `${String(time.getMinutes()).padStart(2, "0")}:` +
+            `${String(time.getSeconds()).padStart(2, "0")}.` +
+            `${String(time.getMilliseconds()).padStart(3, "0")}${COLORS.reset}`;
+
+        // 等级颜色
+        let levelColor: string;
+        let levelIcon: string;
+        switch (level.levelStr) {
+            case "TRACE":
+                levelColor = COLORS.gray;
+                levelIcon = "🔍";
+                break;
+            case "DEBUG":
+                levelColor = COLORS.cyan;
+                levelIcon = "🐛";
+                break;
+            case "INFO":
+                levelColor = COLORS.green;
+                levelIcon = "✨";
+                break;
+            case "WARN":
+                levelColor = COLORS.yellow;
+                levelIcon = "⚠️";
+                break;
+            case "ERROR":
+                levelColor = COLORS.red;
+                levelIcon = "❌";
+                break;
+            case "FATAL":
+                levelColor = `${COLORS.bold}${COLORS.red}`;
+                levelIcon = "💀";
+                break;
+            default:
+                levelColor = COLORS.white;
+                levelIcon = "📝";
+        }
+
+        const levelStr = `${levelColor}${level.levelStr.padEnd(5)}${COLORS.reset}`;
+
+        // 模块标签
+        const modColor = MODULE_COLORS[categoryName] ?? `${COLORS.bold}${COLORS.bgBlue}${COLORS.white}`;
+        const modTag = `${modColor} ${categoryName} ${COLORS.reset}`;
+
+        // 消息内容
+        const msg = data
+            .map((d: any) => (typeof d === "object" ? JSON.stringify(d, null, 2) : String(d)))
+            .join(" ");
+
+        return `${timeStr} ${levelIcon} ${levelStr} ${modTag} ${msg}`;
+    };
+});
+
+// ─── log4js 配置 ─────────────────────────────────────────────
+
+log4js.configure({
+    appenders: {
+        console: {
+            type: "stdout",
+            layout: { type: "qqbot" },
+        },
+        file: {
+            type: "file",
+            filename: "logs/qqbot.log",
+            maxLogSize: 10485760, // 10MB
+            backups: 3,
+            layout: { type: "pattern", pattern: "%d{ISO8601} [%p] [%c] %m" },
+        },
+    },
+    categories: {
+        default: { appenders: ["console", "file"], level: "trace" },
+    },
+});
+
+// ─── 导出 Logger 工厂 ────────────────────────────────────────
+
+export function getLogger(category: string): log4js.Logger {
+    return log4js.getLogger(category);
+}
+
+// ─── 预定义模块 Logger ───────────────────────────────────────
+
+export const botLogger = getLogger("Bot");
+export const authLogger = getLogger("Auth");
+export const apiLogger = getLogger("QQAPI");
+export const webhookLogger = getLogger("Webhook");
+export const eventLogger = getLogger("Event");
+export const matcherLogger = getLogger("Matcher");
+
+// ─── 启动 Banner ─────────────────────────────────────────────
+
+export function printBanner(): void {
+    const banner = `
+${COLORS.bold}${COLORS.magenta}  ╔══════════════════════════════════════╗
+  ║                                      ║
+  ║     🦊  QQ Bot SDK (Elysia)  🦊      ║
+  ║                                      ║
+  ╚══════════════════════════════════════╝${COLORS.reset}
+`;
+    console.log(banner);
+}
+
+// ─── 事件流日志美化 ──────────────────────────────────────────
+
+export function logEventFlow(
+    eventType: string,
+    source: string,
+    detail: string
+): void {
+    const arrow = `${COLORS.cyan}━━▶${COLORS.reset}`;
+    const eventColor = `${COLORS.bold}${COLORS.yellow}`;
+    eventLogger.info(
+        `${arrow} ${eventColor}${eventType}${COLORS.reset} ${COLORS.gray}│${COLORS.reset} ${COLORS.blue}${source}${COLORS.reset} ${arrow} ${detail}`
+    );
+}
+
+export function logMessageSend(
+    targetType: string,
+    targetId: string,
+    messageId: string
+): void {
+    const arrow = `${COLORS.green}◀━━${COLORS.reset}`;
+    apiLogger.info(
+        `${arrow} ${COLORS.bold}消息发送${COLORS.reset} ${COLORS.gray}│${COLORS.reset} ` +
+        `类型: ${COLORS.cyan}${targetType}${COLORS.reset} ` +
+        `目标: ${COLORS.yellow}${targetId}${COLORS.reset} ` +
+        `ID: ${COLORS.magenta}${messageId}${COLORS.reset}`
+    );
+}
+
+export function logRecall(
+    targetType: string,
+    targetId: string,
+    messageId: string,
+    success: boolean
+): void {
+    const icon = success ? `${COLORS.green}✔${COLORS.reset}` : `${COLORS.red}✘${COLORS.reset}`;
+    apiLogger.info(
+        `${icon} ${COLORS.bold}消息撤回${COLORS.reset} ${COLORS.gray}│${COLORS.reset} ` +
+        `类型: ${COLORS.cyan}${targetType}${COLORS.reset} ` +
+        `目标: ${COLORS.yellow}${targetId}${COLORS.reset} ` +
+        `消息: ${COLORS.magenta}${messageId}${COLORS.reset}`
+    );
+}

package/src/matchers.ts

@@ -0,0 +1,77 @@
+// ============================================================
+// QQ Bot SDK — 消息匹配器
+// ============================================================
+
+export interface MatchResult {
+    matched: boolean;
+    /** 匹配后剩余的内容 */
+    rest: string;
+}
+
+/**
+ * 命令匹配器 — 匹配 /cmd 或 cmd 开头的消息
+ * 对应 Cocotst 的 QCommandMatcher
+ */
+export function matchCommand(content: string, command: string): MatchResult {
+    const prefixes = [` /${command}`, `/${command}`, ` ${command}`, command];
+
+    for (const prefix of prefixes) {
+        if (content.startsWith(prefix)) {
+            const rest = content.slice(prefix.length).replace(/^ /, "");
+            return { matched: true, rest };
+        }
+    }
+
+    return { matched: false, rest: content };
+}
+
+/**
+ * 前缀匹配器 — 匹配消息开头
+ * 对应 Cocotst 的 DetectPrefix
+ */
+export function matchPrefix(
+    content: string,
+    prefixes: string | string[]
+): MatchResult {
+    const list = Array.isArray(prefixes) ? prefixes : [prefixes];
+
+    for (const prefix of list) {
+        if (content.startsWith(prefix)) {
+            const rest = content.slice(prefix.length).replace(/^ /, "");
+            return { matched: true, rest };
+        }
+    }
+
+    return { matched: false, rest: content };
+}
+
+/**
+ * 后缀匹配器 — 匹配消息结尾
+ * 对应 Cocotst 的 DetectSuffix
+ */
+export function matchSuffix(
+    content: string,
+    suffixes: string | string[]
+): MatchResult {
+    const list = Array.isArray(suffixes) ? suffixes : [suffixes];
+
+    for (const suffix of list) {
+        if (content.endsWith(suffix)) {
+            const rest = content.slice(0, -suffix.length).replace(/ $/, "");
+            return { matched: true, rest };
+        }
+    }
+
+    return { matched: false, rest: content };
+}
+
+/**
+ * 关键词匹配器 — 匹配消息中是否包含关键词
+ * 对应 Cocotst 的 ContainKeyword
+ */
+export function matchKeyword(content: string, keyword: string): MatchResult {
+    if (content.includes(keyword)) {
+        return { matched: true, rest: content };
+    }
+    return { matched: false, rest: content };
+}

package/src/module.ts

@@ -0,0 +1,58 @@
+// ============================================================
+// QQ Bot SDK — BotModule 基类
+// ============================================================
+
+import { getHandlerMetas } from "./decorators";
+import type { HandlerMeta } from "./types/types";
+import { botLogger } from "./logger";
+
+export interface CollectedHandler {
+    meta: HandlerMeta;
+    handler: (...args: any[]) => any;
+    moduleName: string;
+}
+
+/**
+ * BotModule — 模块化开发基类
+ *
+ * 用法:
+ * ```ts
+ * class MyPlugin extends BotModule {
+ *   @OnCommand("ping")
+ *   async onPing(ctx: GroupMessageContext) {
+ *     await ctx.reply("pong!");
+ *   }
+ * }
+ *
+ * bot.use(new MyPlugin());
+ * ```
+ */
+export abstract class BotModule {
+    /** 模块加载时的钩子 */
+    async onLoad(): Promise<void> { }
+
+    /** 模块卸载时的钩子 */
+    async onUnload(): Promise<void> { }
+
+    /**
+     * 收集当前模块上所有通过装饰器注册的处理器
+     */
+    collectHandlers(): CollectedHandler[] {
+        const metas = getHandlerMetas(Object.getPrototypeOf(this));
+        const handlers: CollectedHandler[] = [];
+        const moduleName = this.constructor.name;
+
+        for (const meta of metas) {
+            const method = (this as any)[meta.propertyKey];
+            if (typeof method === "function") {
+                handlers.push({
+                    meta,
+                    handler: method.bind(this),
+                    moduleName,
+                });
+            }
+        }
+
+        return handlers;
+    }
+}

package/src/sign.ts

@@ -0,0 +1,32 @@
+// ============================================================
+// QQ Bot SDK — Ed25519 签名模块
+// ============================================================
+
+import * as ed from "@noble/ed25519";
+
+/**
+ * QQ 开放平台签名算法
+ * 使用 Ed25519 私钥对数据进行签名
+ */
+export function sign(secret: string, data: string): string {
+    const secretBytes = new TextEncoder().encode(secret);
+    // Ed25519 私钥为 32 字节 seed
+    const privateKey = secretBytes.slice(0, 32);
+    // 同步签名
+    const dataBytes = new TextEncoder().encode(data);
+    // @noble/ed25519 v2+ 使用 sync 方式时需配置 sha512
+    const signature = ed.sign(dataBytes, privateKey);
+    return Buffer.from(signature).toString("hex");
+}
+
+/**
+ * 处理 QQ Webhook 签名验证请求
+ */
+export async function handleSignatureVerify(
+    secret: string,
+    plainToken: string,
+    eventTs: string
+): Promise<{ plain_token: string; signature: string }> {
+    const signature = sign(secret, eventTs + plainToken);
+    return { plain_token: plainToken, signature };
+}