@tencent-connect/openclaw-qqbot 1.7.0 → 1.7.2

package/dist/src/gateway.js

@@ -2,12 +2,14 @@ import WebSocket from "ws";
 import path from "node:path";
 import fs from "node:fs";
 import { MSG_TYPE_QUOTE } from "./types.js";
+import { startWebhookTransport } from "./transport/index.js";
 import { getAccessToken, getGatewayUrl, sendC2CMessage, sendChannelMessage, sendGroupMessage, clearTokenCache, initApiConfig, startBackgroundTokenRefresh, stopBackgroundTokenRefresh, sendC2CInputNotify, onMessageSent, getPluginUserAgent, acknowledgeInteraction, getApiPluginVersion, setApiLogger } from "./api.js";
 import { loadSession, saveSession, clearSession } from "./session-store.js";
 import { recordKnownUser, flushKnownUsers } from "./known-users.js";
 import { getQQBotRuntime } from "./runtime.js";
 import { isGroupAllowed, resolveGroupName, resolveGroupPrompt, resolveHistoryLimit, resolveGroupPolicy, resolveGroupConfig, resolveIgnoreOtherMentions, resolveMentionPatterns } from "./config.js";
 import { qqbotPlugin, stripMentionText, detectWasMentioned } from "./channel.js";
+import { QQBotApprovalHandler, registerApprovalHandler, unregisterApprovalHandler, getApprovalHandler } from "./approval-handler.js";
 import { recordPendingHistoryEntry, buildPendingHistoryContext, buildMergedMessageContext, clearPendingHistory, formatAttachmentTags, formatMessageContent, toAttachmentSummaries, } from "./group-history.js";
 import { setRefIndex, getRefIndex, formatRefEntryForAgent, formatMessageReferenceForAgent, flushRefIndex } from "./ref-index-store.js";
 import { matchSlashCommand, getFrameworkVersion, parseFrameworkDateVersion } from "./slash-commands.js";
@@ -135,9 +137,27 @@ async function handleInteractionCreate(params) {
         log?.info(`[qqbot:${account.accountId}] Interaction ACK (type=${INTERACTION_TYPE_CONFIG_UPDATE}) sent: ${event.id}, claw_cfg=${JSON.stringify(ackClawCfg)}`);
     }
     else {
-        // 其他类型：普通 ACK
+        // 普通按钮交互：先 ACK
         await acknowledgeInteraction(token, event.id);
         log?.debug?.(`[qqbot:${account.accountId}] Interaction ACK sent: ${event.id}`);
+        // Inline Keyboard 审批按钮（type=1 Callback）
+        // button_data 格式：approve:<approvalId>:<decision>
+        // approvalId 可能是 "exec:uuid" / "plugin:uuid"（带前缀）或纯 "uuid"（无前缀）
+        const buttonData = event.data?.resolved?.button_data ?? "";
+        const m = buttonData.match(/^approve:((?:(?:exec|plugin):)?[0-9a-f-]+):(allow-once|allow-always|deny)$/i);
+        if (m) {
+            const approvalId = m[1];
+            const decision = m[2];
+            const userId = event.group_member_openid || event.user_openid || event.data?.resolved?.user_id || "unknown";
+            log?.info(`[qqbot:${account.accountId}] Approval button clicked: approvalId=${approvalId}, decision=${decision}, user=${userId}, buttonData=${buttonData}`);
+            const handler = getApprovalHandler(account.accountId);
+            if (handler) {
+                void handler.resolveApproval(approvalId, decision);
+            }
+            else {
+                log?.error(`[qqbot:${account.accountId}] Approval button: no handler found for accountId=${account.accountId}`);
+            }
+        }
     }
 }
 /** 解析 session store 文件路径 */
@@ -313,6 +333,21 @@ export async function startGateway(ctx) {
     if (!account.appId || !account.clientSecret) {
         throw new Error("QQBot not configured (missing appId or clientSecret)");
     }
+    // 安全网：捕获 approval-handler / SDK 内部 WS 握手异步错误（如 403），避免进程崩溃
+    const wsUncaughtHandler = (err) => {
+        if (err.message?.includes("Unexpected server response")) {
+            log?.error(`[qqbot:${account.accountId}] Caught WS handshake error (non-fatal): ${err.message}`);
+            // 不重新抛出，防止进程退出
+        }
+        else {
+            // 非 WS 握手错误，重新抛出交给上层处理
+            throw err;
+        }
+    };
+    process.on("uncaughtException", wsUncaughtHandler);
+    abortSignal.addEventListener("abort", () => {
+        process.removeListener("uncaughtException", wsUncaughtHandler);
+    }, { once: true });
     // 启动环境诊断（首次连接时执行）
     const diag = await runDiagnostics();
     if (diag.warnings.length > 0) {
@@ -403,6 +438,12 @@ export async function startGateway(ctx) {
     else {
         log?.info(`[qqbot:${account.accountId}] Image server disabled (no imageServerBaseUrl configured)`);
     }
+    // ============ Transport 模式标记 ============
+    const transportMode = account.config.transport ?? "websocket";
+    if (transportMode === "webhook") {
+        log?.info(`[qqbot:${account.accountId}] Using webhook transport mode`);
+    }
+    // ============ WebSocket / Webhook 公共初始化 ============
     let reconnectAttempts = 0;
     let isAborted = false;
     let currentWs = null;
@@ -425,6 +466,18 @@ export async function startGateway(ctx) {
         lastSeq = savedSession.lastSeq;
         log?.info(`[qqbot:${account.accountId}] Restored session from storage: sessionId=${sessionId}, lastSeq=${lastSeq}`);
     }
+    // ============ 审批 Handler ============
+    const approvalHandler = new QQBotApprovalHandler({
+        accountId: account.accountId,
+        appId: account.appId,
+        clientSecret: account.clientSecret,
+        cfg: cfg,
+        log,
+    });
+    registerApprovalHandler(account.accountId, approvalHandler);
+    approvalHandler.start().catch((err) => {
+        log?.error(`[qqbot:${account.accountId}] approval-handler: uncaught start error: ${err}`);
+    });
     // ============ 消息队列（复用 createMessageQueue，内置群消息合并/淘汰策略） ============
     const msgQueue = createMessageQueue({
         accountId: account.accountId,
@@ -433,7 +486,9 @@ export async function startGateway(ctx) {
     });
     // 斜杠指令拦截：在入队前匹配插件级指令，命中则直接回复，不入队
     // 紧急命令列表：这些命令会立即执行，不进入斜杠匹配流程
-    const URGENT_COMMANDS = ["/stop"];
+    // /stop   — 停止当前 agent run，清空队列
+    // /approve — 审批决策，必须在 agent 等待审批时立即执行，否则死锁
+    const URGENT_COMMANDS = ["/stop", "/approve"];
     const trySlashCommandOrEnqueue = async (msg) => {
         const content = (msg.content ?? "").trim();
         if (!content.startsWith("/")) {
@@ -478,6 +533,15 @@ export async function startGateway(ctx) {
                 msgQueue.enqueue(msg);
                 return;
             }
+            // 委托给 AI 模型：用加工后的 prompt 替换原始消息入队
+            const isDelegateResult = typeof reply === "object" && reply !== null && "delegatePrompt" in reply;
+            if (isDelegateResult) {
+                const delegatePrompt = reply.delegatePrompt;
+                log?.info(`[qqbot:${account.accountId}] Slash command delegated to AI: ${content.slice(0, 40)}`);
+                msg.content = delegatePrompt;
+                msgQueue.enqueue(msg);
+                return;
+            }
             // 命中插件级指令，直接回复
             log?.info(`[qqbot:${account.accountId}] Slash command matched: ${content}, replying directly`);
             const token = await getAccessToken(account.appId, account.clientSecret);
@@ -537,6 +601,9 @@ export async function startGateway(ctx) {
         flushKnownUsers();
         // P1-4: 保存引用索引数据
         flushRefIndex();
+        // 停止审批 handler
+        void approvalHandler.stop();
+        unregisterApprovalHandler(account.accountId);
     });
     const cleanup = () => {
         if (heartbeatInterval) {
@@ -587,12 +654,6 @@ export async function startGateway(ctx) {
                 clearTokenCache(account.appId);
                 shouldRefreshToken = false;
             }
-            const accessToken = await getAccessToken(account.appId, account.clientSecret);
-            log?.info(`[qqbot:${account.accountId}] ✅ Access token obtained successfully`);
-            const gatewayUrl = await getGatewayUrl(accessToken);
-            log?.info(`[qqbot:${account.accountId}] Connecting to ${gatewayUrl}`);
-            const ws = new WebSocket(gatewayUrl, { headers: { "User-Agent": getPluginUserAgent() } });
-            currentWs = ws;
             const pluginRuntime = getQQBotRuntime();
             // 群历史消息缓存：非@消息写入此 Map，被@时一次性注入上下文后清空
             const groupHistories = new Map();
@@ -1244,6 +1305,8 @@ export async function startGateway(ctx) {
                                 },
                             });
                         }
+                        // 打印 runId 用于调试
+                        log?.info?.(`[qqbot:${account.accountId}] Dispatching with runId: ${event.messageId}`);
                         const dispatchPromise = pluginRuntime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
                             ctx: ctxPayload,
                             cfg,
@@ -1494,6 +1557,8 @@ export async function startGateway(ctx) {
                                 },
                             },
                             replyOptions: {
+                                // 使用消息ID作为 runId，用于追踪一次完整的 AI 对话运行
+                                runId: event.messageId,
                                 // 流式模式时禁用 block streaming
                                 disableBlockStreaming: !useStreaming,
                                 // 流式模式下注册 onPartialReply 回调，接收流式文本增量
@@ -1593,6 +1658,100 @@ export async function startGateway(ctx) {
                     }
                 }); // end runWithRequestContext
             };
+            // ============ 统一事件分发（WebSocket/Webhook 共用） ============
+            const dispatchInboundEvent = async (t, d) => {
+                if (t === "C2C_MESSAGE_CREATE") {
+                    const ev = d;
+                    recordKnownUser({ openid: ev.author.user_openid, type: "c2c", accountId: account.accountId });
+                    const refs = parseRefIndices(ev.message_scene?.ext, ev.message_type, ev.msg_elements);
+                    await trySlashCommandOrEnqueue({ type: "c2c", senderId: ev.author.user_openid, content: ev.content, messageId: ev.id, timestamp: ev.timestamp, attachments: ev.attachments, refMsgIdx: refs.refMsgIdx, msgIdx: refs.msgIdx, msgElements: ev.msg_elements, msgType: ev.message_type });
+                }
+                else if (t === "AT_MESSAGE_CREATE") {
+                    const ev = d;
+                    recordKnownUser({ openid: ev.author.id, type: "c2c", nickname: ev.author.username, accountId: account.accountId });
+                    const refs = parseRefIndices(ev.message_scene?.ext, ev.message_type, ev.msg_elements);
+                    await trySlashCommandOrEnqueue({ type: "guild", senderId: ev.author.id, senderName: ev.author.username, content: ev.content, messageId: ev.id, timestamp: ev.timestamp, channelId: ev.channel_id, guildId: ev.guild_id, attachments: ev.attachments, refMsgIdx: refs.refMsgIdx, msgIdx: refs.msgIdx, msgType: ev.message_type });
+                }
+                else if (t === "DIRECT_MESSAGE_CREATE") {
+                    const ev = d;
+                    recordKnownUser({ openid: ev.author.id, type: "c2c", nickname: ev.author.username, accountId: account.accountId });
+                    const refs = parseRefIndices(ev.message_scene?.ext, ev.message_type, ev.msg_elements);
+                    await trySlashCommandOrEnqueue({ type: "dm", senderId: ev.author.id, senderName: ev.author.username, content: ev.content, messageId: ev.id, timestamp: ev.timestamp, guildId: ev.guild_id, attachments: ev.attachments, refMsgIdx: refs.refMsgIdx, msgIdx: refs.msgIdx, msgType: ev.message_type });
+                }
+                else if (t === "GROUP_AT_MESSAGE_CREATE" || t === "GROUP_MESSAGE_CREATE") {
+                    const ev = d;
+                    recordKnownUser({ openid: ev.author.member_openid, type: "group", nickname: ev.author.username, groupOpenid: ev.group_openid, accountId: account.accountId });
+                    const refs = parseRefIndices(ev.message_scene?.ext, ev.message_type, ev.msg_elements);
+                    await trySlashCommandOrEnqueue({ type: "group", senderId: ev.author.member_openid, senderName: ev.author.username, senderIsBot: ev.author.bot, content: ev.content, messageId: ev.id, timestamp: ev.timestamp, groupOpenid: ev.group_openid, attachments: ev.attachments, refMsgIdx: refs.refMsgIdx, msgIdx: refs.msgIdx, eventType: t, mentions: ev.mentions, messageScene: ev.message_scene, msgElements: ev.msg_elements, msgType: ev.message_type });
+                }
+                else if (t === "GROUP_ADD_ROBOT") {
+                    const ev = d;
+                    log?.info(`[qqbot:${account.accountId}] Bot added to group: ${ev.group_openid} by ${ev.op_member_openid}`);
+                    recordKnownUser({ openid: ev.op_member_openid, type: "group", groupOpenid: ev.group_openid, accountId: account.accountId });
+                }
+                else if (t === "GROUP_DEL_ROBOT") {
+                    const ev = d;
+                    log?.info(`[qqbot:${account.accountId}] Bot removed from group: ${ev.group_openid} by ${ev.op_member_openid}`);
+                }
+                else if (t === "GROUP_MSG_REJECT") {
+                    const ev = d;
+                    log?.info(`[qqbot:${account.accountId}] Group ${ev.group_openid} rejected bot proactive messages (by ${ev.op_member_openid})`);
+                }
+                else if (t === "GROUP_MSG_RECEIVE") {
+                    const ev = d;
+                    log?.info(`[qqbot:${account.accountId}] Group ${ev.group_openid} accepted bot proactive messages (by ${ev.op_member_openid})`);
+                }
+                else if (t === "INTERACTION_CREATE") {
+                    const ev = d;
+                    const resolved = ev.data?.resolved;
+                    const sceneDesc = ev.scene ?? (ev.chat_type === 0 ? "guild" : ev.chat_type === 1 ? "group" : "c2c");
+                    log?.info(`[qqbot:${account.accountId}] Interaction: scene=${sceneDesc}, type=${ev.data?.type}, button_id=${resolved?.button_id}, button_data=${resolved?.button_data}`);
+                    handleInteractionCreate({ event: ev, account, cfg, log }).catch((err) => {
+                        log?.error(`[qqbot:${account.accountId}] Failed to handle interaction ${ev.id}: ${err}`);
+                    });
+                }
+            };
+            // ============ Webhook 模式：共享 handleMessage，不走 WS ============
+            if (transportMode === "webhook") {
+                isConnecting = false;
+                msgQueue.startProcessor(handleMessage);
+                startBackgroundTokenRefresh(account.appId, account.clientSecret, {
+                    log: log,
+                });
+                await startWebhookTransport({
+                    account,
+                    abortSignal,
+                    onEvent: async (event) => {
+                        const { eventType: t, data: d } = event;
+                        log?.info(`[qqbot:${account.accountId}:webhook] 📩 Dispatch event: t=${t}, d=${JSON.stringify(d)}`);
+                        await dispatchInboundEvent(t, d);
+                    },
+                    onReady: () => {
+                        log?.info(`[qqbot:${account.accountId}:webhook] Transport ready`);
+                        log?.info(`[qqbot:${account.accountId}] ✅ Webhook transport started successfully (path: ${account.config.webhook?.path ?? "/qqbot/webhook"})`);
+                        onReady?.({ transport: "webhook" });
+                        if (_pendingFirstReady.has(account.accountId)) {
+                            _pendingFirstReady.delete(account.accountId);
+                            sendStartupGreetings(adminCtx, "READY");
+                        }
+                    },
+                    onError: (error) => {
+                        log?.error(`[qqbot:${account.accountId}:webhook] Error: ${error.message}`);
+                        onError?.(error);
+                    },
+                    log,
+                });
+                stopBackgroundTokenRefresh();
+                unregisterApprovalHandler(account.accountId);
+                return; // webhook transport 结束，不继续 WS 逻辑
+            }
+            // ============ WebSocket 模式：获取 token 并建立 WS 连接 ============
+            const accessToken = await getAccessToken(account.appId, account.clientSecret);
+            log?.info(`[qqbot:${account.accountId}] ✅ Access token obtained successfully`);
+            const gatewayUrl = await getGatewayUrl(accessToken);
+            log?.info(`[qqbot:${account.accountId}] Connecting to ${gatewayUrl}`);
+            const ws = new WebSocket(gatewayUrl, { headers: { "User-Agent": getPluginUserAgent() } });
+            currentWs = ws;
             ws.on("open", () => {
                 log?.info(`[qqbot:${account.accountId}] WebSocket connected`);
                 isConnecting = false; // 连接完成，释放锁
@@ -1712,166 +1871,10 @@ export async function startGateway(ctx) {
                                     });
                                 }
                             }
-                            else if (t === "C2C_MESSAGE_CREATE") {
-                                const event = d;
-                                // P1-3: 记录已知用户
-                                recordKnownUser({
-                                    openid: event.author.user_openid,
-                                    type: "c2c",
-                                    accountId: account.accountId,
-                                });
-                                // 解析引用索引
-                                const c2cRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
-                                // 斜杠指令拦截 → 不匹配则入队
-                                trySlashCommandOrEnqueue({
-                                    type: "c2c",
-                                    senderId: event.author.user_openid,
-                                    content: event.content,
-                                    messageId: event.id,
-                                    timestamp: event.timestamp,
-                                    attachments: event.attachments,
-                                    refMsgIdx: c2cRefs.refMsgIdx,
-                                    msgIdx: c2cRefs.msgIdx,
-                                    msgElements: event.msg_elements,
-                                    msgType: event.message_type,
-                                });
-                            }
-                            else if (t === "AT_MESSAGE_CREATE") {
-                                const event = d;
-                                // P1-3: 记录已知用户（频道用户）
-                                recordKnownUser({
-                                    openid: event.author.id,
-                                    type: "c2c", // 频道用户按 c2c 类型存储
-                                    nickname: event.author.username,
-                                    accountId: account.accountId,
-                                });
-                                const guildRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
-                                trySlashCommandOrEnqueue({
-                                    type: "guild",
-                                    senderId: event.author.id,
-                                    senderName: event.author.username,
-                                    content: event.content,
-                                    messageId: event.id,
-                                    timestamp: event.timestamp,
-                                    channelId: event.channel_id,
-                                    guildId: event.guild_id,
-                                    attachments: event.attachments,
-                                    refMsgIdx: guildRefs.refMsgIdx,
-                                    msgIdx: guildRefs.msgIdx,
-                                    msgType: event.message_type,
-                                });
-                            }
-                            else if (t === "DIRECT_MESSAGE_CREATE") {
-                                const event = d;
-                                // P1-3: 记录已知用户（频道私信用户）
-                                recordKnownUser({
-                                    openid: event.author.id,
-                                    type: "c2c",
-                                    nickname: event.author.username,
-                                    accountId: account.accountId,
-                                });
-                                const dmRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
-                                trySlashCommandOrEnqueue({
-                                    type: "dm",
-                                    senderId: event.author.id,
-                                    senderName: event.author.username,
-                                    content: event.content,
-                                    messageId: event.id,
-                                    timestamp: event.timestamp,
-                                    guildId: event.guild_id,
-                                    attachments: event.attachments,
-                                    refMsgIdx: dmRefs.refMsgIdx,
-                                    msgIdx: dmRefs.msgIdx,
-                                    msgType: event.message_type,
-                                });
-                            }
-                            else if (t === "GROUP_AT_MESSAGE_CREATE") {
-                                const event = d;
-                                // 被 @ 的消息，直接入队回复
-                                recordKnownUser({
-                                    openid: event.author.member_openid,
-                                    type: "group",
-                                    nickname: event.author.username,
-                                    groupOpenid: event.group_openid,
-                                    accountId: account.accountId,
-                                });
-                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
-                                trySlashCommandOrEnqueue({
-                                    type: "group",
-                                    senderId: event.author.member_openid,
-                                    senderName: event.author.username,
-                                    content: event.content,
-                                    messageId: event.id,
-                                    timestamp: event.timestamp,
-                                    groupOpenid: event.group_openid,
-                                    attachments: event.attachments,
-                                    refMsgIdx: groupRefs.refMsgIdx,
-                                    msgIdx: groupRefs.msgIdx,
-                                    eventType: "GROUP_AT_MESSAGE_CREATE",
-                                    mentions: event.mentions,
-                                    messageScene: event.message_scene,
-                                    msgElements: event.msg_elements,
-                                    msgType: event.message_type,
-                                });
-                            }
-                            else if (t === "GROUP_MESSAGE_CREATE") {
-                                const event = d;
-                                recordKnownUser({
-                                    openid: event.author.member_openid,
-                                    type: "group",
-                                    nickname: event.author.username,
-                                    groupOpenid: event.group_openid,
-                                    accountId: account.accountId,
-                                });
-                                const groupRefs = parseRefIndices(event.message_scene?.ext, event.message_type, event.msg_elements);
-                                trySlashCommandOrEnqueue({
-                                    type: "group",
-                                    senderId: event.author.member_openid,
-                                    senderName: event.author.username,
-                                    senderIsBot: event.author.bot,
-                                    content: event.content,
-                                    messageId: event.id,
-                                    timestamp: event.timestamp,
-                                    groupOpenid: event.group_openid,
-                                    attachments: event.attachments,
-                                    refMsgIdx: groupRefs.refMsgIdx,
-                                    msgIdx: groupRefs.msgIdx,
-                                    eventType: "GROUP_MESSAGE_CREATE",
-                                    mentions: event.mentions,
-                                    messageScene: event.message_scene,
-                                    msgElements: event.msg_elements,
-                                    msgType: event.message_type,
-                                });
-                            }
-                            else if (t === "GROUP_ADD_ROBOT") {
-                                const event = d;
-                                log?.info(`[qqbot:${account.accountId}] Bot added to group: ${event.group_openid} by ${event.op_member_openid}`);
-                                recordKnownUser({
-                                    openid: event.op_member_openid,
-                                    type: "group",
-                                    groupOpenid: event.group_openid,
-                                    accountId: account.accountId,
-                                });
-                            }
-                            else if (t === "GROUP_DEL_ROBOT") {
-                                const event = d;
-                                log?.info(`[qqbot:${account.accountId}] Bot removed from group: ${event.group_openid} by ${event.op_member_openid}`);
-                            }
-                            else if (t === "GROUP_MSG_REJECT") {
-                                const event = d;
-                                log?.info(`[qqbot:${account.accountId}] Group ${event.group_openid} rejected bot proactive messages (by ${event.op_member_openid})`);
-                            }
-                            else if (t === "GROUP_MSG_RECEIVE") {
-                                const event = d;
-                                log?.info(`[qqbot:${account.accountId}] Group ${event.group_openid} accepted bot proactive messages (by ${event.op_member_openid})`);
-                            }
-                            else if (t === "INTERACTION_CREATE") {
-                                const event = d;
-                                const resolved = event.data?.resolved;
-                                const sceneDesc = event.scene ?? (event.chat_type === 0 ? "guild" : event.chat_type === 1 ? "group" : "c2c");
-                                log?.info(`[qqbot:${account.accountId}] Interaction: scene=${sceneDesc}, type=${event.data?.type}, button_id=${resolved?.button_id}, button_data=${resolved?.button_data}, user=${event.group_member_openid || event.user_openid || resolved?.user_id || "unknown"}`);
-                                handleInteractionCreate({ event, account, cfg, log }).catch((err) => {
-                                    log?.error(`[qqbot:${account.accountId}] Failed to handle interaction ${event.id}: ${err}`);
+                            else {
+                                // 所有其他事件统一分发
+                                dispatchInboundEvent(t, d).catch((err) => {
+                                    log?.error(`[qqbot:${account.accountId}] Event dispatch error (t=${t}): ${err}`);
                                 });
                             }
                             break;
@@ -2013,8 +2016,10 @@ export async function startGateway(ctx) {
     };
     // 开始连接
     await connect();
-    // 等待 abort 信号
+    // 等待 abort 信号（如果 connect() 返回时 signal 已经 aborted，直接 resolve）
+    if (abortSignal.aborted)
+        return;
     return new Promise((resolve) => {
-        abortSignal.addEventListener("abort", () => resolve());
+        abortSignal.addEventListener("abort", () => resolve(), { once: true });
     });
 }

package/dist/src/slash-commands.d.ts

@@ -59,14 +59,19 @@ export interface QueueSnapshot {
     /** 当前发送者在队列中的待处理消息数 */
     senderPending: number;
 }
-/** 斜杠指令返回值：文本、带文件的结果、或 null（不处理） */
-export type SlashCommandResult = string | SlashCommandFileResult | null;
+/** 斜杠指令返回值：文本、带文件的结果、委托给模型、或 null（不处理） */
+export type SlashCommandResult = string | SlashCommandFileResult | SlashCommandDelegateResult | null;
 /** 带文件的指令结果（先回复文本，再发送文件） */
 export interface SlashCommandFileResult {
     text: string;
     /** 要发送的本地文件路径 */
     filePath: string;
 }
+/** 委托给 AI 模型处理：用加工后的 prompt 替换原始消息入队 */
+export interface SlashCommandDelegateResult {
+    /** 替换原始消息内容的 prompt，交给 AI 模型执行 */
+    delegatePrompt: string;
+}
 /**
  * 尝试匹配并执行插件级斜杠指令
  *