@downcity/plugins 1.0.4

package/bin/chat/channels/feishu/types/FeishuChannel.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Feishu 渠道共享类型。
+ *
+ * 关键点（中文）
+ * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
+ * - `plugins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ */
+/**
+ * 飞书适配器配置。
+ */
+export interface FeishuConfig {
+    /**
+     * 飞书应用 AppId。
+     */
+    appId: string;
+    /**
+     * 飞书应用 AppSecret。
+     */
+    appSecret: string;
+    /**
+     * 是否启用飞书渠道。
+     */
+    enabled: boolean;
+    /**
+     * 可选的飞书 Open API 域名。
+     */
+    domain?: string;
+}
+/**
+ * 飞书消息事件。
+ */
+export interface FeishuMessageEvent {
+    /**
+     * 发送者信息。
+     */
+    sender?: {
+        /**
+         * 发送者 ID 集合。
+         */
+        sender_id?: {
+            /**
+             * 用户 user_id。
+             */
+            user_id?: string;
+            /**
+             * 用户 open_id。
+             */
+            open_id?: string;
+            /**
+             * 用户 union_id。
+             */
+            union_id?: string;
+            /**
+             * 兼容 chat_id 字段。
+             */
+            chat_id?: string;
+        };
+    };
+    /**
+     * 消息主体。
+     */
+    message?: {
+        /**
+         * 会话 chat_id。
+         */
+        chat_id: string;
+        /**
+         * 原始内容 JSON。
+         */
+        content: string;
+        /**
+         * 消息类型。
+         */
+        message_type: string;
+        /**
+         * 会话类型。
+         */
+        chat_type: string;
+        /**
+         * 消息 ID。
+         */
+        message_id: string;
+        /**
+         * 根消息 ID。
+         */
+        root_id?: string;
+        /**
+         * 父消息 ID。
+         */
+        parent_id?: string;
+    };
+}
+/**
+ * 飞书消息发送类型。
+ */
+export type FeishuMessagePayloadType = "text" | "file" | "image" | "post";
+/**
+ * 飞书发送者归一化结果。
+ */
+export interface FeishuSenderIdentity {
+    /**
+     * 归一化后的发送者 ID。
+     */
+    senderId?: string;
+    /**
+     * 发送者 ID 的类型。
+     */
+    idType?: "open_id" | "user_id" | "union_id";
+}
+/**
+ * 飞书下载后的本地附件结构。
+ */
+export interface FeishuDownloadedAttachment {
+    /**
+     * 统一附件类型。
+     */
+    type: "document" | "photo" | "voice" | "audio" | "video";
+    /**
+     * 本地绝对路径。
+     */
+    path: string;
+    /**
+     * 可选说明文本。
+     */
+    desc?: string;
+}
+//# sourceMappingURL=FeishuChannel.d.ts.map

package/bin/chat/channels/feishu/types/FeishuChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuChannel.d.ts","sourceRoot":"","sources":["../../../../../src/chat/channels/feishu/types/FeishuChannel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,SAAS,CAAC,EAAE;YACV;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAClB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QACnB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACzD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/bin/chat/channels/feishu/types/FeishuChannel.js

@@ -0,0 +1,9 @@
+/**
+ * Feishu 渠道共享类型。
+ *
+ * 关键点（中文）
+ * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
+ * - `plugins/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ */
+export {};
+//# sourceMappingURL=FeishuChannel.js.map

package/bin/chat/channels/feishu/types/FeishuChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuChannel.js","sourceRoot":"","sources":["../../../../../src/chat/channels/feishu/types/FeishuChannel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/chat/channels/qq/BotInfo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * QQ Bot 信息探测实现。
+ *
+ * 关键点（中文）
+ * - 先校验 appId/appSecret 可换取 access token。
+ * - 再验证 gateway 可达，并尝试读取 `users/@me`。
+ */
+import type { ChatBotInfoCredentialInput, ChatBotInfoResult, ChatChannelBotInfoProvider } from "../../../chat/types/BotInfo.js";
+/**
+ * QQ 渠道 Bot 信息探测器。
+ */
+export declare class QqBotInfoProvider implements ChatChannelBotInfoProvider {
+    readonly channel: "qq";
+    /**
+     * 探测 QQ bot 信息。
+     */
+    resolve(credentials: ChatBotInfoCredentialInput): Promise<ChatBotInfoResult>;
+}
+//# sourceMappingURL=BotInfo.d.ts.map

package/bin/chat/channels/qq/BotInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfo.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/BotInfo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,yBAAyB,CAAC;AAUjC;;GAEG;AACH,qBAAa,iBAAkB,YAAW,0BAA0B;IAClE,QAAQ,CAAC,OAAO,EAAG,IAAI,CAAU;IAEjC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAyGnF"}

package/bin/chat/channels/qq/BotInfo.js

@@ -0,0 +1,112 @@
+/**
+ * QQ Bot 信息探测实现。
+ *
+ * 关键点（中文）
+ * - 先校验 appId/appSecret 可换取 access token。
+ * - 再验证 gateway 可达，并尝试读取 `users/@me`。
+ */
+function pickFirstNonEmpty(inputs) {
+    for (const input of inputs) {
+        const text = String(input || "").trim();
+        if (text)
+            return text;
+    }
+    return "";
+}
+/**
+ * QQ 渠道 Bot 信息探测器。
+ */
+export class QqBotInfoProvider {
+    channel = "qq";
+    /**
+     * 探测 QQ bot 信息。
+     */
+    async resolve(credentials) {
+        const appId = String(credentials.appId || "").trim();
+        const appSecret = String(credentials.appSecret || "").trim();
+        const sandbox = credentials.sandbox === true;
+        if (!appId || !appSecret) {
+            throw new Error("Missing appId/appSecret");
+        }
+        const authResponse = await fetch("https://bots.qq.com/app/getAppAccessToken", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                appId,
+                clientSecret: appSecret,
+            }),
+        });
+        const authRaw = await authResponse.text();
+        let authPayload = {};
+        try {
+            authPayload = JSON.parse(authRaw);
+        }
+        catch {
+            authPayload = {};
+        }
+        if (!authResponse.ok ||
+            (typeof authPayload.code === "number" && authPayload.code !== 0) ||
+            !authPayload.access_token) {
+            const details = pickFirstNonEmpty([
+                authPayload.message,
+                authRaw,
+                `HTTP ${authResponse.status}`,
+            ]);
+            throw new Error(`QQ bot info probe failed: ${details}`);
+        }
+        const authHeader = `QQBot ${authPayload.access_token}`;
+        const apiBase = sandbox
+            ? "https://sandbox.api.sgroup.qq.com"
+            : "https://api.sgroup.qq.com";
+        const gatewayResponse = await fetch(`${apiBase}/gateway`, {
+            method: "GET",
+            headers: {
+                Authorization: authHeader,
+            },
+        });
+        const gatewayRaw = await gatewayResponse.text();
+        if (!gatewayResponse.ok) {
+            throw new Error(`QQ bot info probe failed: ${gatewayRaw || `HTTP ${gatewayResponse.status}`}`);
+        }
+        let botName = "";
+        let botUserId = "";
+        try {
+            const meResponse = await fetch(`${apiBase}/users/@me`, {
+                method: "GET",
+                headers: {
+                    Authorization: authHeader,
+                },
+            });
+            const meRaw = await meResponse.text();
+            const mePayload = JSON.parse(meRaw);
+            if (meResponse.ok) {
+                botUserId = pickFirstNonEmpty([mePayload.id, mePayload.user_id]);
+                botName = pickFirstNonEmpty([
+                    mePayload.username,
+                    mePayload.nickname,
+                    mePayload.name,
+                ]);
+            }
+        }
+        catch {
+            // ignore profile lookup error
+        }
+        const name = pickFirstNonEmpty([
+            botName,
+            `QQ Bot ${appId.slice(-6)}`,
+            "QQ Bot",
+        ]);
+        const identity = pickFirstNonEmpty([botUserId, appId]);
+        return {
+            channel: this.channel,
+            name,
+            identity: identity || undefined,
+            botUserId: botUserId || undefined,
+            idSeed: pickFirstNonEmpty([botUserId, appId, "bot"]),
+            message: botName
+                ? "QQ bot profile fetched"
+                : "QQ credentials verified; fallback profile generated",
+        };
+    }
+}
+//# sourceMappingURL=BotInfo.js.map

package/bin/chat/channels/qq/BotInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotInfo.js","sourceRoot":"","sources":["../../../../src/chat/channels/qq/BotInfo.ts"],"names":[],"mappings":"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"}

package/bin/chat/channels/qq/Configuration.d.ts

@@ -0,0 +1,17 @@
+/**
+ * QQ 渠道配置描述。
+ *
+ * 关键点（中文）
+ * - ship 层只保留 `enabled` 与 `channelAccountId`。
+ * - QQ 专属参数（sandbox 等）在 channel account 中维护。
+ */
+import { ChatChannelConfiguration } from "../../../chat/channels/Configuration.js";
+import type { ChatChannelConfigurationDescriptor } from "../../../chat/types/ChannelConfiguration.js";
+/**
+ * QQ 渠道配置描述器。
+ */
+export declare class QqChannelConfiguration extends ChatChannelConfiguration {
+    readonly channel: "qq";
+    describe(): ChatChannelConfigurationDescriptor;
+}
+//# sourceMappingURL=Configuration.d.ts.map

package/bin/chat/channels/qq/Configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAE/F;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,wBAAwB;IAClE,QAAQ,CAAC,OAAO,EAAG,IAAI,CAAU;IAEjC,QAAQ,IAAI,kCAAkC;CA8C/C"}

package/bin/chat/channels/qq/Configuration.js

@@ -0,0 +1,59 @@
+/**
+ * QQ 渠道配置描述。
+ *
+ * 关键点（中文）
+ * - ship 层只保留 `enabled` 与 `channelAccountId`。
+ * - QQ 专属参数（sandbox 等）在 channel account 中维护。
+ */
+import { ChatChannelConfiguration } from "../../../chat/channels/Configuration.js";
+/**
+ * QQ 渠道配置描述器。
+ */
+export class QqChannelConfiguration extends ChatChannelConfiguration {
+    channel = "qq";
+    describe() {
+        return {
+            channel: this.channel,
+            title: "QQ Channel Configuration",
+            description: "Bind a QQ channel account and control runtime enable/disable state.",
+            version: "1.0.0",
+            capabilities: {
+                canToggleEnabled: true,
+                canBindChannelAccount: true,
+                canConfigure: true,
+            },
+            fields: {
+                ship: [
+                    {
+                        key: "enabled",
+                        label: "Enabled",
+                        description: "Whether qq channel should be started by runtime.",
+                        type: "boolean",
+                        source: "ship_json",
+                        required: false,
+                        nullable: false,
+                        writable: true,
+                        restartRequired: true,
+                        defaultValue: false,
+                        example: true,
+                    },
+                    {
+                        key: "channelAccountId",
+                        label: "Channel Account ID",
+                        description: "Bind channel to a channel account row in ~/.downcity/downcity.db channel_accounts.",
+                        type: "string",
+                        source: "ship_json",
+                        required: false,
+                        nullable: true,
+                        writable: true,
+                        restartRequired: true,
+                        example: "qq-main",
+                    },
+                ],
+                channelAccount: [],
+                envFallback: [],
+            },
+        };
+    }
+}
+//# sourceMappingURL=Configuration.js.map

package/bin/chat/channels/qq/Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../src/chat/channels/qq/Configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,wBAAwB;IACzD,OAAO,GAAG,IAAa,CAAC;IAEjC,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,0BAA0B;YACjC,WAAW,EACT,qEAAqE;YACvE,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE;gBACZ,gBAAgB,EAAE,IAAI;gBACtB,qBAAqB,EAAE,IAAI;gBAC3B,YAAY,EAAE,IAAI;aACnB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ;wBACE,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,SAAS;wBAChB,WAAW,EAAE,kDAAkD;wBAC/D,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,IAAI;wBACd,eAAe,EAAE,IAAI;wBACrB,YAAY,EAAE,KAAK;wBACnB,OAAO,EAAE,IAAI;qBACd;oBACD;wBACE,GAAG,EAAE,kBAAkB;wBACvB,KAAK,EAAE,oBAAoB;wBAC3B,WAAW,EACT,oFAAoF;wBACtF,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,KAAK;wBACf,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,IAAI;wBACd,eAAe,EAAE,IAAI;wBACrB,OAAO,EAAE,SAAS;qBACnB;iBACF;gBACD,cAAc,EAAE,EAAE;gBAClB,WAAW,EAAE,EAAE;aAChB;SACF,CAAC;IACJ,CAAC;CACF"}

package/bin/chat/channels/qq/PROMPT.direct.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+declare const TEXT_MODULE_CONTENT = "# QQ Adapter \u4F7F\u7528\u8BF4\u660E\uFF08direct \u6A21\u5F0F\uFF09\n\n## \u80FD\u529B\u8303\u56F4\n- \u8D1F\u8D23 QQ \u5B98\u65B9\u673A\u5668\u4EBA\u7F51\u5173\uFF08WebSocket\uFF09\u6D88\u606F\u63A5\u5165\u4E0E\u53D1\u9001\u3002\n- \u5165\u7AD9\u6D88\u606F\u4F1A\u7531 chat plugin runtime \u6620\u5C04\u5230\u5185\u90E8 `sessionId`\uFF08\u968F\u673A\u5206\u914D\u5E76\u6301\u4E45\u5316\uFF09\u3002\n\n## \u4F7F\u7528\u7EA6\u675F\n- \u5728 direct \u6A21\u5F0F\u4E0B\uFF0C\u4F60\u8F93\u51FA\u7684 assistant \u6587\u672C\u4F1A\u81EA\u52A8\u53D1\u9001\u5230\u5F53\u524D QQ \u4F1A\u8BDD\u3002\n- QQ \u51FA\u7AD9\u56DE\u590D\u4F9D\u8D56\u5165\u7AD9\u6D88\u606F\u4E0A\u4E0B\u6587\uFF08\u5982 `chatType` \u4E0E `messageId`\uFF09\uFF1B\u8DE8\u4F1A\u8BDD\u53D1\u9001\u8BF7\u4F7F\u7528 `city chat send --chat-key ...`\uFF0C\u4E0D\u8981\u5728 direct metadata \u4E2D\u5199 `chatKey`\u3002\n- \u7FA4\u804A\u6D88\u606F\u9ED8\u8BA4\u5168\u91CF\u63A5\u5165\uFF0C\u4E0D\u9700\u8981 `@` \u89E6\u53D1\u3002\n- \u9002\u914D\u5668\u4F1A\u8FC7\u6EE4\u673A\u5668\u4EBA\u81EA\u56DE\u73AF\u6D88\u606F\u5E76\u505A\u5165\u7AD9\u53BB\u91CD\uFF0C\u907F\u514D\u201C\u81EA\u5DF1\u56DE\u590D\u81EA\u5DF1\u201D\u7684\u5FAA\u73AF\u3002\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.direct.d.ts.map

package/bin/chat/channels/qq/PROMPT.direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.direct.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/PROMPT.direct.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,yrCAAqY,CAAC;AAE/Z,eAAe,mBAAmB,CAAC"}

package/bin/chat/channels/qq/PROMPT.direct.js

@@ -0,0 +1,8 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+// Source: src/chat/channels/qq/PROMPT.direct.ts.txt
+const TEXT_MODULE_CONTENT = "# QQ Adapter 使用说明（direct 模式）\n\n## 能力范围\n- 负责 QQ 官方机器人网关（WebSocket）消息接入与发送。\n- 入站消息会由 chat plugin runtime 映射到内部 `sessionId`（随机分配并持久化）。\n\n## 使用约束\n- 在 direct 模式下，你输出的 assistant 文本会自动发送到当前 QQ 会话。\n- QQ 出站回复依赖入站消息上下文（如 `chatType` 与 `messageId`）；跨会话发送请使用 `city chat send --chat-key ...`，不要在 direct metadata 中写 `chatKey`。\n- 群聊消息默认全量接入，不需要 `@` 触发。\n- 适配器会过滤机器人自回环消息并做入站去重，避免“自己回复自己”的循环。\n";
+export default TEXT_MODULE_CONTENT;
+//# sourceMappingURL=PROMPT.direct.js.map

package/bin/chat/channels/qq/PROMPT.direct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PROMPT.direct.js","sourceRoot":"","sources":["../../../../src/chat/channels/qq/PROMPT.direct.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AACpD,MAAM,mBAAmB,GAAG,kYAAkY,CAAC;AAE/Z,eAAe,mBAAmB,CAAC"}

package/bin/chat/channels/qq/QQ.d.ts

@@ -0,0 +1,92 @@
+/**
+ * QQ 渠道门面。
+ *
+ * 关键点（中文）
+ * - `QQBot` 只保留渠道层编排职责：入站授权、命令处理、消息入队、回复调度。
+ * - Gateway 连接、自愈重连、消息回发已经下沉到 `QQGatewayClient`。
+ * - 文本清洗、作者识别、标题解析、附件宽松提取已经下沉到 `QQInbound`。
+ * - READY 身份解析、命令映射、入站增强组装已经下沉到 `QQSupport`。
+ */
+import { BaseChatChannel } from "../../../chat/channels/BaseChatChannel.js";
+import type { ChannelChatKeyParams, ChannelSendTextParams } from "../../../chat/channels/BaseChatChannel.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatChannelTestResult } from "../../../chat/types/ChannelStatus.js";
+import type { QQConfig } from "../../../chat/channels/qq/types/QqChannel.js";
+/**
+ * QQ 平台适配器。
+ */
+export declare class QQBot extends BaseChatChannel {
+    private readonly appId;
+    private readonly appSecret;
+    private readonly useSandbox;
+    private readonly gateway;
+    private readonly inboundDedupeStore;
+    private readonly msgSeqByMessageKey;
+    private botUserId;
+    private botDisplayName;
+    constructor(context: AgentContext, appId: string, appSecret: string, useSandbox?: boolean);
+    protected getChatKey(params: ChannelChatKeyParams): string;
+    protected sendTextToPlatform(params: ChannelSendTextParams): Promise<void>;
+    /**
+     * 读取 QQ 状态快照。
+     */
+    getExecutorStatus(): {
+        running: boolean;
+        linkState: "connected" | "disconnected" | "unknown";
+        statusText: string;
+        detail: Record<string, string | number | boolean | null>;
+    };
+    /**
+     * 执行 QQ 连通性测试。
+     */
+    testConnection(): Promise<ChatChannelTestResult>;
+    /**
+     * 启动机器人。
+     */
+    start(): Promise<void>;
+    /**
+     * 停止机器人。
+     */
+    stop(): Promise<void>;
+    /**
+     * Dispatch 事件总入口。
+     */
+    private handleDispatch;
+    /**
+     * 捕获 READY 事件中的机器人身份信息。
+     */
+    private captureReadyIdentity;
+    /**
+     * 处理群聊消息。
+     */
+    private handleGroupMessage;
+    /**
+     * 处理 C2C 私聊消息。
+     */
+    private handleC2CMessage;
+    /**
+     * 处理频道消息。
+     */
+    private handleChannelMessage;
+    /**
+     * 构造 QQ 入站处理依赖。
+     */
+    private getMessageHandlerOptions;
+    /**
+     * 入站去重检查。
+     */
+    private shouldSkipDuplicatedInboundMessage;
+    /**
+     * 处理命令消息。
+     */
+    private handleCommand;
+    /**
+     * 执行指令并回复。
+     */
+    private executeAndReply;
+}
+/**
+ * 创建 QQ 机器人实例。
+ */
+export declare function createQQBot(config: QQConfig, context: AgentContext): Promise<QQBot | null>;
+//# sourceMappingURL=QQ.d.ts.map

package/bin/chat/channels/qq/QQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QQ.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/qq/QQ.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAgBrE,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,uCAAuC,CAAC;AAGrF;;GAEG;AACH,qBAAa,KAAM,SAAQ,eAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IACrE,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,cAAc,CAAM;gBAG1B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,OAAe;IAuB7B,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM;cAQ1C,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACH,iBAAiB,IAAI;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;KAC1D;IAcD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAgBtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;YACW,cAAc;IAoC5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;YACW,kBAAkB;IAOhC;;OAEG;YACW,gBAAgB;IAI9B;;OAEG;YACW,oBAAoB;IAIlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4ChC;;OAEG;YACW,kCAAkC;IAmBhD;;OAEG;YACW,aAAa;IAiB3B;;OAEG;YACW,eAAe;CA4B9B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAWvB"}