@greatlhd/ailo-desktop 1.0.0

package/dist/mouse_keyboard.js

@@ -0,0 +1,516 @@
+import { spawnSync } from "child_process";
+import * as os from "os";
+import { verifyDesktopAction } from "./desktop_verifier.js";
+import { captureDesktopObservation } from "./screenshot.js";
+function ok(data) {
+    return [{ type: "text", text: JSON.stringify({ ok: true, ...data }, null, 2) }];
+}
+function fail(error) {
+    return [{ type: "text", text: JSON.stringify({ ok: false, error }, null, 2) }];
+}
+function runPowerShell(script) {
+    const r = spawnSync("powershell", ["-Command", script], { encoding: "utf-8", timeout: 10000 });
+    return (r.stdout ?? "").trim();
+}
+function runShell(cmd) {
+    const r = spawnSync("/bin/sh", ["-c", cmd], { encoding: "utf-8", timeout: 10000 });
+    return (r.stdout ?? "").trim();
+}
+function getPrimaryScreenSize() {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const ps = `Add-Type -AssemblyName System.Windows.Forms; $s=[System.Windows.Forms.Screen]::PrimaryScreen.Bounds; Write-Output "$($s.Width)x$($s.Height)"`;
+        const out = runPowerShell(ps);
+        const parts = out.split("x").map(Number);
+        const w = parts[0] ?? 1920;
+        const h = parts[1] ?? 1080;
+        return { width: w, height: h };
+    }
+    else if (platform === "darwin") {
+        const out = runShell("system_profiler SPDisplaysDataType | grep Resolution");
+        const m = out.match(/(\d+)\s*x\s*(\d+)/);
+        if (m)
+            return { width: Number(m[1]), height: Number(m[2]) };
+    }
+    else {
+        const out = runShell("xdpyinfo | grep dimensions");
+        const m = out.match(/(\d+)x(\d+)/);
+        if (m)
+            return { width: Number(m[1]), height: Number(m[2]) };
+    }
+    return { width: 1920, height: 1080 };
+}
+// ---------------------------------------------------------------------------
+// 平台操作实现
+// ---------------------------------------------------------------------------
+function mouseMove(x, y) {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${x},${y})`;
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        spawnSync("cliclick", ["m:" + x + "," + y]);
+    }
+    else {
+        spawnSync("xdotool", ["mousemove", String(x), String(y)]);
+    }
+}
+function mouseClick(x, y, button = "left") {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const btnCode = button === "right" ? 2 : 1;
+        const downFlag = btnCode === 2 ? "0x0008" : "0x0002";
+        const upFlag = btnCode === 2 ? "0x0010" : "0x0004";
+        const ps = [
+            "Add-Type -AssemblyName System.Windows.Forms",
+            `[System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${x},${y})`,
+            '$sig = @"',
+            '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int dwData, int dwExtraInfo);',
+            '"@',
+            "$m = Add-Type -MemberDefinition $sig -Name WinMouse -Namespace Win32 -PassThru",
+            `$m::mouse_event(${downFlag},0,0,0,0)`,
+            `$m::mouse_event(${upFlag},0,0,0,0)`,
+        ].join("; ");
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        const clickCmd = button === "right" ? "rc" : "c";
+        spawnSync("cliclick", [clickCmd + ":" + x + "," + y]);
+    }
+    else {
+        mouseMove(x, y);
+        const btn = button === "right" ? "3" : button === "middle" ? "2" : "1";
+        spawnSync("xdotool", ["click", "--button", btn]);
+    }
+}
+function mouseDoubleClick(x, y) {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const ps = [
+            "Add-Type -AssemblyName System.Windows.Forms",
+            `[System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${x},${y})`,
+            '$sig = @"',
+            '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int dwData, int dwExtraInfo);',
+            '"@',
+            "$m = Add-Type -MemberDefinition $sig -Name WinMouse2 -Namespace Win32 -PassThru",
+            "$m::mouse_event(0x0002,0,0,0,0); $m::mouse_event(0x0004,0,0,0,0)",
+            "Start-Sleep -Milliseconds 50",
+            "$m::mouse_event(0x0002,0,0,0,0); $m::mouse_event(0x0004,0,0,0,0)",
+        ].join("; ");
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        spawnSync("cliclick", ["dc:" + x + "," + y]);
+    }
+    else {
+        mouseMove(x, y);
+        spawnSync("xdotool", ["click", "--repeat", "2", "--delay", "50", "1"]);
+    }
+}
+function mouseDrag(sx, sy, ex, ey) {
+    const platform = os.platform();
+    if (platform === "win32") {
+        const ps = [
+            "Add-Type -AssemblyName System.Windows.Forms",
+            `[System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${sx},${sy})`,
+            '$sig = @"',
+            '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int dwData, int dwExtraInfo);',
+            '"@',
+            "$m = Add-Type -MemberDefinition $sig -Name WinMouse3 -Namespace Win32 -PassThru",
+            "$m::mouse_event(0x0002,0,0,0,0)",
+            "Start-Sleep -Milliseconds 50",
+            `[System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${ex},${ey})`,
+            "Start-Sleep -Milliseconds 50",
+            "$m::mouse_event(0x0004,0,0,0,0)",
+        ].join("; ");
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        spawnSync("cliclick", ["dd:" + sx + "," + sy, "dm:" + ex + "," + ey, "du:" + ex + "," + ey]);
+    }
+    else {
+        spawnSync("xdotool", ["mousemove", String(sx), String(sy), "mousedown", "1", "mousemove", String(ex), String(ey), "mouseup", "1"]);
+    }
+}
+function keyboardType(text) {
+    const platform = os.platform();
+    if (platform === "win32") {
+        // 转义单引号（PowerShell 单引号字符串）
+        // 再转义 SendKeys 特殊字符：{} + ^ % ~
+        const escaped = text
+            .replace(/'/g, "''")
+            .replace(/[{}+^%~]/g, (c) => `{${c}}`);
+        const ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${escaped}')`;
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        spawnSync("cliclick", ["t:" + text]);
+    }
+    else {
+        spawnSync("xdotool", ["type", "--clearmodifiers", text]);
+    }
+}
+function keyboardHotkey(keys) {
+    const platform = os.platform();
+    const keyNames = keys.split(/\s+/);
+    if (platform === "win32") {
+        let sendKeysStr = "";
+        for (const k of keyNames) {
+            const lower = k.toLowerCase();
+            const map = {
+                ctrl: "^", control: "^", alt: "%", shift: "+",
+                enter: "{ENTER}", return: "{ENTER}", tab: "{TAB}",
+                escape: "{ESC}", esc: "{ESC}", space: " ",
+                backspace: "{BACKSPACE}", delete: "{DELETE}",
+                up: "{UP}", down: "{DOWN}", left: "{LEFT}", right: "{RIGHT}",
+                home: "{HOME}", end: "{END}", pageup: "{PGUP}", pagedown: "{PGDN}",
+                f1: "{F1}", f2: "{F2}", f3: "{F3}", f4: "{F4}",
+                f5: "{F5}", f6: "{F6}", f7: "{F7}", f8: "{F8}",
+                f9: "{F9}", f10: "{F10}", f11: "{F11}", f12: "{F12}",
+            };
+            sendKeysStr += map[lower] ?? k;
+        }
+        const ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${sendKeysStr}')`;
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        const macKeys = keyNames.map(k => {
+            const map = { ctrl: "cmd", control: "cmd", alt: "alt", shift: "shift", meta: "cmd", cmd: "cmd" };
+            return map[k.toLowerCase()] ?? k;
+        });
+        spawnSync("cliclick", ["kp:" + macKeys.join("+")]);
+    }
+    else {
+        spawnSync("xdotool", ["key", keyNames.join("+")]);
+    }
+}
+function mouseScroll(direction, amount) {
+    if (direction !== "up" && direction !== "down") {
+        throw new Error(`direction 必须是 "up" 或 "down"，收到: "${direction}"`);
+    }
+    const platform = os.platform();
+    if (platform === "win32") {
+        const delta = direction === "up" ? (amount * 120) : -(amount * 120);
+        const ps = [
+            '$sig = @"',
+            '[DllImport("user32.dll")] public static extern void mouse_event(int dwFlags, int dx, int dy, int dwData, int dwExtraInfo);',
+            '"@',
+            "$m = Add-Type -MemberDefinition $sig -Name WinMouse4 -Namespace Win32 -PassThru",
+            `$m::mouse_event(0x0800,0,0,${delta},0)`,
+        ].join("; ");
+        runPowerShell(ps);
+    }
+    else if (platform === "darwin") {
+        const scrollAmount = direction === "up" ? amount : -amount;
+        spawnSync("cliclick", ["w:" + scrollAmount]);
+    }
+    else {
+        const btn = direction === "up" ? "4" : "5";
+        for (let i = 0; i < amount; i++) {
+            spawnSync("xdotool", ["click", btn]);
+        }
+    }
+}
+function normalizeAction(action) {
+    return String(action ?? "").trim().toLowerCase();
+}
+function buildActionResult(result, verdict, afterObservation) {
+    const payload = {
+        ok: result.accepted && result.executed,
+        action_result: {
+            accepted: result.accepted,
+            executed: result.executed,
+            action: result.action,
+            timestamp: result.timestamp,
+            observation_id: result.observationId,
+            error: result.error,
+            details: result.details,
+        },
+    };
+    if (verdict)
+        payload.verdict = verdict;
+    if (afterObservation) {
+        payload.after_observation = {
+            observation_id: afterObservation.id,
+            scope: afterObservation.scope,
+            coordinate_space: afterObservation.coordinateSpace,
+            image_width: afterObservation.imageWidth,
+            image_height: afterObservation.imageHeight,
+            image_path: afterObservation.image.path,
+        };
+    }
+    const parts = [{ type: "text", text: JSON.stringify(payload, null, 2) }];
+    if (afterObservation) {
+        parts.push({
+            type: "image",
+            media: {
+                type: "image",
+                path: afterObservation.image.path,
+                mime: afterObservation.image.mime,
+                name: afterObservation.image.name,
+            },
+        });
+    }
+    return parts;
+}
+function rejectAction(action, error) {
+    return buildActionResult({
+        accepted: false,
+        executed: false,
+        action,
+        timestamp: Date.now(),
+        error,
+    }, { status: "failure", reason: error });
+}
+function resolveObservation(args, deps) {
+    const stateStore = deps.stateStore;
+    if (!stateStore)
+        return null;
+    const observationId = typeof args.observation_id === "string" ? args.observation_id.trim() : "";
+    if (!observationId)
+        return null;
+    const observation = stateStore.getObservation(observationId);
+    if (!observation)
+        throw new Error(`observation_id 无效或已过期: ${observationId}`);
+    if (stateStore.isExpired(observation))
+        throw new Error(`observation 已过期，请重新 screenshot: ${observationId}`);
+    return observation;
+}
+function requireObservation(action, args, deps) {
+    const observation = resolveObservation(args, deps);
+    if (!observation)
+        throw new Error(`${action} 需要 observation_id，请先调用 screenshot 获取 observation`);
+    return observation;
+}
+function resolvePointFromObservation(observation, args, xKey, yKey, normXKey, normYKey) {
+    const { bounds } = observation.scope;
+    const rawX = args[xKey] !== undefined
+        ? bounds.x + Number(args[xKey])
+        : args[normXKey] !== undefined
+            ? bounds.x + bounds.width * Number(args[normXKey]) / 1000
+            : NaN;
+    const rawY = args[yKey] !== undefined
+        ? bounds.y + Number(args[yKey])
+        : args[normYKey] !== undefined
+            ? bounds.y + bounds.height * Number(args[normYKey]) / 1000
+            : NaN;
+    if (isNaN(rawX) || isNaN(rawY)) {
+        throw new Error(`需要提供 ${xKey}/${yKey}（基于observation的局部像素坐标）或 ${normXKey}/${normYKey}（归一化坐标0-1000）`);
+    }
+    // clamp 到 bounds 范围内，防止超出屏幕坐标
+    return [
+        Math.round(Math.max(bounds.x, Math.min(bounds.x + bounds.width, rawX))),
+        Math.round(Math.max(bounds.y, Math.min(bounds.y + bounds.height, rawY))),
+    ];
+}
+async function captureVerificationObservation(observation, deps) {
+    const captureOpts = observation.scope.kind === "screen" && observation.scope.screenIndex !== undefined
+        ? { screen: observation.scope.screenIndex }
+        : false;
+    const result = await captureDesktopObservation(captureOpts);
+    if (!result.observation)
+        return null;
+    deps.stateStore?.saveObservation(result.observation);
+    return result.observation;
+}
+export async function mouseKeyboard(args, deps = {}) {
+    const action = normalizeAction(args.action);
+    if (!action)
+        return fail("action 参数必填");
+    const verifyAfterAction = args.verify_after_action !== false && !!(args.verify_after_action ?? args.screenshot_after);
+    const verificationDelayMs = Math.max(0, Number(args.verification_delay_ms ?? 150));
+    try {
+        switch (action) {
+            case "get_screen_size": {
+                const size = getPrimaryScreenSize();
+                return ok(size);
+            }
+            case "click": {
+                const observation = requireObservation(action, args, deps);
+                const [x, y] = resolvePointFromObservation(observation, args, "x", "y", "norm_x", "norm_y");
+                mouseClick(x, y, args.button ?? "left");
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { x, y, button: args.button ?? "left" },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "double_click": {
+                const observation = requireObservation(action, args, deps);
+                const [x, y] = resolvePointFromObservation(observation, args, "x", "y", "norm_x", "norm_y");
+                mouseDoubleClick(x, y);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { x, y },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "right_click": {
+                const observation = requireObservation(action, args, deps);
+                const [x, y] = resolvePointFromObservation(observation, args, "x", "y", "norm_x", "norm_y");
+                mouseClick(x, y, "right");
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { x, y },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "move": {
+                const observation = requireObservation(action, args, deps);
+                const [x, y] = resolvePointFromObservation(observation, args, "x", "y", "norm_x", "norm_y");
+                mouseMove(x, y);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { x, y },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                return buildActionResult(actionResult);
+            }
+            case "drag": {
+                const observation = requireObservation(action, args, deps);
+                const [sx, sy] = resolvePointFromObservation(observation, args, "start_x", "start_y", "start_norm_x", "start_norm_y");
+                const [ex, ey] = resolvePointFromObservation(observation, args, "end_x", "end_y", "end_norm_x", "end_norm_y");
+                mouseDrag(sx, sy, ex, ey);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { startX: sx, startY: sy, endX: ex, endY: ey },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "type": {
+                const observation = requireObservation(action, args, deps);
+                const text = args.text;
+                if (!text)
+                    return rejectAction(action, "type 操作需要 text 参数");
+                keyboardType(text);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { text },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "hotkey": {
+                const observation = requireObservation(action, args, deps);
+                const keys = args.keys;
+                if (!keys)
+                    return rejectAction(action, "hotkey 操作需要 keys 参数");
+                keyboardHotkey(keys);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { keys },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            case "scroll": {
+                const observation = requireObservation(action, args, deps);
+                const direction = args.direction ?? "down";
+                const amount = args.amount ?? 3;
+                if (args.x !== undefined || args.norm_x !== undefined) {
+                    const [x, y] = resolvePointFromObservation(observation, args, "x", "y", "norm_x", "norm_y");
+                    mouseMove(x, y);
+                }
+                mouseScroll(direction, amount);
+                const actionResult = {
+                    accepted: true,
+                    executed: true,
+                    action,
+                    timestamp: Date.now(),
+                    observationId: observation.id,
+                    details: { direction, amount },
+                };
+                deps.stateStore?.setLastAction(actionResult);
+                if (!verifyAfterAction)
+                    return buildActionResult(actionResult);
+                if (verificationDelayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, verificationDelayMs));
+                const afterObservation = await captureVerificationObservation(observation, deps);
+                const verdict = verifyDesktopAction({ beforeObservation: observation, afterObservation, actionResult });
+                deps.stateStore?.setLastVerdict(verdict);
+                return buildActionResult(actionResult, verdict, afterObservation ?? undefined);
+            }
+            default:
+                return fail(`未知操作: ${action}`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return rejectAction(action, msg);
+    }
+}

package/dist/qq-handler.js

@@ -0,0 +1,153 @@
+import { textPart, } from "@lmcl/ailo-endpoint-sdk";
+import { DEFAULT_API_BASE } from "./qq-types.js";
+import { QQGatewayClient } from "./qq-ws.js";
+import { createChannelLogger } from "./utils.js";
+export class QQHandler {
+    config;
+    ctx = null;
+    gateway = null;
+    lastMsgIdByChatId = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    get apiBase() {
+        return (this.config.apiBase ?? DEFAULT_API_BASE).replace(/\/$/, "");
+    }
+    _log = createChannelLogger("qq", () => this.ctx);
+    acceptMessage(msg) {
+        if (!this.ctx)
+            return;
+        this.ctx.accept(msg).catch((err) => this._log("error", "accept failed", { err: String(err) }));
+    }
+    buildAcceptMessage(opts) {
+        const { chatId, text, chatType, senderId, senderName, msgId } = opts;
+        const tags = [
+            { kind: "channel", value: "QQ", groupWith: true },
+            { kind: "conv_type", value: chatType, groupWith: false },
+            { kind: "chat_id", value: chatId, groupWith: true, passToTool: true },
+        ];
+        if (senderName) {
+            tags.push({ kind: "participant", value: senderName, groupWith: false });
+        }
+        if (senderId) {
+            tags.push({ kind: "sender_id", value: senderId, groupWith: false, passToTool: true });
+        }
+        if (msgId) {
+            tags.push({ kind: "msg_id", value: msgId, groupWith: false, passToTool: true });
+        }
+        return { content: [textPart(text)], contextTags: tags };
+    }
+    stripAtPrefix(content) {
+        return content.replace(/<@!\d+>\s*/g, "").trim();
+    }
+    async start(ctx) {
+        this.ctx = ctx;
+        const gateway = new QQGatewayClient(this.config, (event, data) => this.handleDispatch(event, data), (level, msg, d) => this._log(level, msg, d));
+        this.gateway = gateway;
+        await gateway.connect();
+        this._log("info", "QQ Bot Gateway 已连接");
+        ctx.reportHealth("connected");
+    }
+    handleIncomingMessage(msg, opts) {
+        if ("author" in msg && msg.author?.bot)
+            return;
+        const text = opts.stripAt ? this.stripAtPrefix(msg.content ?? "") : (msg.content ?? "").trim();
+        if (!text)
+            return;
+        const chatId = `${opts.prefix}:${opts.idField}`;
+        if (msg.id)
+            this.lastMsgIdByChatId.set(chatId, msg.id);
+        this.acceptMessage(this.buildAcceptMessage({
+            chatId,
+            text,
+            chatType: opts.chatType,
+            senderId: msg.author?.user_openid ?? msg.author?.id ?? "",
+            senderName: msg.author?.username ?? "",
+            msgId: msg.id,
+        }));
+    }
+    handleDispatch(event, data) {
+        switch (event) {
+            case "AT_MESSAGE_CREATE": {
+                const msg = data;
+                this.handleIncomingMessage(msg, { prefix: "ch", chatType: "频道", idField: msg.channel_id ?? "", stripAt: true });
+                break;
+            }
+            case "DIRECT_MESSAGE_CREATE": {
+                const msg = data;
+                this.handleIncomingMessage(msg, { prefix: "dm", chatType: "私聊", idField: msg.guild_id ?? "", stripAt: true });
+                break;
+            }
+            case "C2C_MESSAGE_CREATE": {
+                const msg = data;
+                const userId = msg.author?.user_openid ?? msg.author?.id ?? "";
+                this.handleIncomingMessage(msg, { prefix: "c2c", chatType: "私聊", idField: userId, stripAt: false });
+                break;
+            }
+            case "GROUP_AT_MESSAGE_CREATE": {
+                const msg = data;
+                this.handleIncomingMessage(msg, { prefix: "grp", chatType: "群聊", idField: msg.group_openid ?? msg.group_id ?? "", stripAt: true });
+                break;
+            }
+            case "PUBLIC_MESSAGES_DELETE":
+                this._log("debug", "ignored message delete event");
+                break;
+            default:
+                this._log("debug", `unhandled event: ${event}`);
+        }
+    }
+    async sendText(chatId, text, msgId) {
+        if (!text?.trim())
+            return;
+        if (!this.gateway)
+            throw new Error("QQ Gateway 未连接");
+        const token = this.gateway.getAccessToken();
+        if (!token)
+            throw new Error("QQ access token 不可用");
+        const [kind, id] = chatId.split(":", 2);
+        if (!kind || !id)
+            throw new Error(`无效的 chat_id 格式: ${chatId}`);
+        const resolvedMsgId = msgId || this.lastMsgIdByChatId.get(chatId);
+        let url;
+        let body;
+        switch (kind) {
+            case "ch":
+                url = `${this.apiBase}/channels/${id}/messages`;
+                body = { content: text, msg_id: resolvedMsgId || undefined };
+                break;
+            case "dm":
+                url = `${this.apiBase}/dms/${id}/messages`;
+                body = { content: text, msg_id: resolvedMsgId || undefined };
+                break;
+            case "c2c":
+                url = `${this.apiBase}/v2/users/${id}/messages`;
+                body = { content: text, msg_type: 0, msg_id: resolvedMsgId || undefined };
+                break;
+            case "grp":
+                url = `${this.apiBase}/v2/groups/${id}/messages`;
+                body = { content: text, msg_type: 0, msg_id: resolvedMsgId || undefined };
+                break;
+            default:
+                throw new Error(`不支持的 chat_id 类型: ${kind}`);
+        }
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `QQBot ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => "");
+            this._log("error", `发送消息失败: HTTP ${res.status}`, { url, detail });
+            throw new Error(`QQ 发送失败: HTTP ${res.status}`);
+        }
+        this._log("debug", `消息已发送到 ${chatId}`);
+    }
+    async stop() {
+        this.gateway?.close();
+        this.gateway = null;
+        this.ctx = null;
+    }
+}

package/dist/qq-types.js

@@ -0,0 +1,15 @@
+export const OP_DISPATCH = 0;
+export const OP_HEARTBEAT = 1;
+export const OP_IDENTIFY = 2;
+export const OP_RESUME = 6;
+export const OP_RECONNECT = 7;
+export const OP_INVALID_SESSION = 9;
+export const OP_HELLO = 10;
+export const OP_HEARTBEAT_ACK = 11;
+export const INTENT_PUBLIC_GUILD_MESSAGES = 1 << 30;
+export const INTENT_DIRECT_MESSAGE = 1 << 12;
+export const INTENT_GROUP_AND_C2C = 1 << 25;
+export const DEFAULT_API_BASE = "https://api.sgroup.qq.com";
+export const TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
+export const RECONNECT_DELAYS = [1, 2, 5, 10, 30, 60];
+export const MAX_RECONNECT_ATTEMPTS = 50;