@zaofan/dsh-qqbot 1.0.1 → 1.1.2

package/dist/channel-tools.js

@@ -8,13 +8,16 @@
  * 复制进共享 node_modules，也不得在 dependencies 里自带 dsh-tools(避免双包)。
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
-import { appendFileSync, existsSync, statSync } from 'node:fs';
+import { appendFileSync, existsSync, readFileSync, statSync } from 'node:fs';
 import { getStickerStore } from './features/sticker-store.js';
 import { autoTagImage } from './features/sticker-tagger.js';
 import { isStickerGateDenied } from './features/sticker-gate.js';
 import { getScheduleStore } from './features/schedule-store.js';
 import { switchOutboundMode } from './features/outbound-mode-switch.js';
 import { loadExtensionTools } from './features/extension-store.js';
+import { verifyHuman, groupRegistryPath } from './api/group-admin.js';
+import { wakeSessionAgent, safeAppendUserMessage } from './features/group-hub.js';
+import { managersOf, findManagerByPeer, findManagerBySessionId } from './features/session-registry.js';
 /** 诊断日志路径: 默认关闭; 需要排查时设环境变量 QQBOT_DIAG_FILE 指向日志文件 */
 const DIAG_FILE = process.env.QQBOT_DIAG_FILE || '';
 /** 大文件异步发送阈值: 本地文件 >= 5MB 时走后台任务(SDK 分片上传耗时, 避免阻塞 LLM 回合) */
@@ -23,6 +26,22 @@ const FILE_ASYNC_MIN = 5 * 1024 * 1024;
 const TURN_WAIT_MS = 60_000;
 let bgSeq = 0;
 function fmtMB(n) { return (n / 1048576).toFixed(1) + 'MB'; }
+/** 从 exec 取 logger(ctx.logger), 拿不到用 console 兜底(类型兼容 Logger) */
+function loggerLike(exec) {
+    try {
+        const a = exec.agent;
+        if (a?.ctx?.logger)
+            return a.ctx.logger;
+    }
+    catch { /* 忽略 */ }
+    const c = console;
+    return {
+        info: (m, ...args) => c.info(m, ...args),
+        warn: (m, ...args) => c.warn(m, ...args),
+        error: (m, ...args) => c.error(m, ...args),
+        debug: (m, ...args) => c.debug(m, ...args),
+    };
+}
 /**
  * 把后台任务结果作为 user/message 写回会话(不唤醒, 与入群申请通知同款; 失败静默)。
  * 🔒 回合安全(主人硬约束 2026-09-09): LLM 回合进行中严禁 session.append(拆散 tool_calls 坏记录),
@@ -848,8 +867,10 @@ export async function apply(ctx) {
     }
     const listJoinRequestsTool = defineTool({
         name: 'group_join_requests',
-        description: '群管理(读): 查看当前群待审批的入群申请列表(申请人/验证消息/来源/风险提示)。仅主人要求时调用。需在设置开启"QQ群管理"且机器人为群管理员。',
-        parameters: {},
+        description: '群管理(读): 查看待审批的入群申请列表(申请人/验证消息/来源/风险提示)。默认查当前会话所在群/manageGroup; 也可传 gid 查指定群。仅主人要求时调用。需在设置开启"QQ群管理"且机器人为群管理员。⚠️群组管理器(收到【群管·入群申请】注入)的正确姿势: ①先用 session_list 找到【申请所在群】的会话; ②用 session_wake(session_id=该会话, mode=append, send_qq=true) 把申请转达过去; ③让【那个群的 bot 会话】用本工具核对名单、并用 group_approve_join 执行放行/拒绝 —— 每个群的审批交给该群自己的会话办(群成员表/权限/上下文都在那边); 只有在对方会话不可用时, 才由本会话显式带 gid 跨群代批。',
+        parameters: {
+            gid: { type: 'string', description: '目标群 openid(可选)。不填=当前会话群或 manageGroup; 填了则查指定群的待审批列表' },
+        },
         output: {
             schema: {
                 type: 'object', additionalProperties: false,
@@ -857,27 +878,38 @@ export async function apply(ctx) {
             },
             render: (_a, v) => [{ type: 'text', text: v.ok ? v.msg : `失败: ${v.msg}` }],
         },
-        async execute(_args, exec) {
+        async execute(args, exec) {
             const ga = groupAdminOf(exec);
             if (!ga)
                 return { ok: false, msg: '群管理未开启(设置→QQ群管理)或非群会话' };
-            if (!ga.gid)
-                return { ok: false, msg: '当前不是群会话, 无法确定目标群' };
-            const r = await ga.client.listJoinRequests(ga.gid);
+            const gid = args.gid || ga.gid;
+            if (!gid)
+                return { ok: false, msg: '当前不是群会话且未指定 gid, 无法确定目标群' };
+            const r = await ga.client.listJoinRequests(gid);
             if (!r.ok)
                 return { ok: false, msg: r.err.human };
+            // 补群名(官方 info 接口, 失败不阻断)
+            let gname = '';
+            try {
+                const gi = await ga.client.getGroupInfo(gid);
+                if (gi.ok && gi.data?.group_name)
+                    gname = gi.data.group_name;
+            }
+            catch { /* 群名失败不影响 */ }
             const list = r.data.list;
             if (list.length === 0)
-                return { ok: true, msg: '当前没有待审批的入群申请 ✓' };
-            const lines = list.map((j, i) => `${i + 1}. ${j.username ?? '?'} (${String(j.member_openid).slice(0, 10)}…) 来源:${j.apply_source ?? '?'} 验证:${j.verify_info?.verify_message ?? j.verify_info?.method ?? '-'}${j.risk_tips ? ` ⚠️${j.risk_tips}` : ''}`);
-            return { ok: true, msg: `入群申请 ${list.length} 条:\n${lines.join('\n')}` };
+                return { ok: true, msg: `当前没有待审批的入群申请 ✓(群 ${gname ? `「${gname}」` : ''}${gid})` };
+            const lines = list.map((j, i) => `${i + 1}. ${j.username ?? '?'} (${j.member_openid}) 来源:${j.apply_source ?? '?'} 验证:${verifyHuman(j.verify_info) || '-'}${j.risk_tips ? ` ⚠️${j.risk_tips}` : ''}`);
+            return { ok: true, msg: `入群申请 ${list.length} 条(群 ${gname ? `「${gname}」` : ''}${gid}):\n${lines.join('\n')}` };
         },
     });
     const approveJoinTool = defineTool({
         name: 'group_approve_join',
-        description: '群管理(写,危险): 审批入群申请。approve=放行 / decline=拒绝(可带理由)。仅主人明确要求时调用; 调用前建议先 group_join_requests 核对申请人。',
+        description: '群管理(写,危险): 审批入群申请。approve=放行 / decline=拒绝(可带理由)。支持批量: member_openids 数组一次批多人(优先); 也兼容单数 member_openid。仅主人明确要求时调用; 调用前建议先 group_join_requests 核对申请人。⚠️跨群审批务必显式传 gid(不传=当前会话所在群, 会批错群)。由群组管理器(hub)代批时的顺序: 优先用 session_wake 唤醒【申请所在群的会话】, 让那边的 bot 调本工具执行审批; 该会话不可用(无会话/append 失败)时才在本会话带 gid 直批。',
         parameters: {
-            member_openid: { type: 'string', required: true, description: '申请人 member_openid(来自 group_join_requests)' },
+            gid: { type: 'string', description: '目标群 openid(可选)。不填=当前会话群或 manageGroup; 填了则审批指定群的申请' },
+            member_openids: { type: 'array', description: '批量审批: 申请人 member_openid 数组(来自 group_join_requests), 一次批多人' },
+            member_openid: { type: 'string', description: '单个申请人 member_openid(批量时可不填)' },
             op: { type: 'string', required: true, enum: ['approve', 'decline'], description: 'approve 放行 / decline 拒绝' },
             reason: { type: 'string', required: true, description: '拒绝理由(decline 时填; approve 或不需要可填 "-")' },
         },
@@ -892,22 +924,336 @@ export async function apply(ctx) {
             const ga = groupAdminOf(exec);
             if (!ga)
                 return { ok: false, msg: '群管理未开启或非群会话' };
-            if (!ga.gid)
-                return { ok: false, msg: '当前不是群会话' };
+            const gid = args.gid || ga.gid;
+            if (!gid)
+                return { ok: false, msg: '当前不是群会话且未指定 gid' };
+            const targets = Array.isArray(args.member_openids) && args.member_openids.length
+                ? args.member_openids
+                : (args.member_openid ? [args.member_openid] : []);
+            if (targets.length === 0)
+                return { ok: false, msg: '请提供要审批的 member_openid(可多个)' };
             // join_request_id 官方审批必填(缺省报 40103007): 先拉列表按 member_openid 匹配自动补上
-            const listR = await ga.client.listJoinRequests(ga.gid);
+            const listR = await ga.client.listJoinRequests(gid);
             if (!listR.ok)
                 return { ok: false, msg: listR.err.human };
-            const found = (listR.data.list ?? []).find((j) => j.member_openid === args.member_openid);
-            const r = await ga.client.approveJoinRequest(ga.gid, args.member_openid, args.op, {
-                ...(found ? { join_request_id: found.join_request_id } : {}),
-                ...(args.op === 'decline' && String(args.reason ?? '') && String(args.reason) !== '-'
-                    ? { reject_reason: String(args.reason) }
-                    : {}),
-            });
-            if (!r.ok)
-                return { ok: false, msg: r.err.human };
-            return { ok: true, msg: args.op === 'approve' ? '✅ 已放行该入群申请' : '已拒绝该入群申请' };
+            const list = listR.data.list ?? [];
+            const results = [];
+            let failed = 0;
+            for (const midRaw of targets) {
+                const mid = String(midRaw);
+                const found = list.find((j) => j.member_openid === mid);
+                const r = await ga.client.approveJoinRequest(gid, mid, args.op, {
+                    ...(found ? { join_request_id: String(found.join_request_id ?? '') } : {}),
+                    ...(args.op === 'decline' && String(args.reason ?? '') && String(args.reason) !== '-'
+                        ? { reject_reason: String(args.reason) }
+                        : {}),
+                });
+                if (r.ok) {
+                    results.push(`${String(mid).slice(0, 10)}… ${args.op === 'approve' ? '✅放行' : '已拒绝'}${found ? `(${String(found.username ?? '')})` : ''}`);
+                }
+                else {
+                    failed++;
+                    results.push(`${String(mid).slice(0, 10)}… ❌ ${r.err.human}`);
+                }
+            }
+            if (failed === 0) {
+                return { ok: true, msg: `${args.op === 'approve' ? '✅ 已全部放行' : '已全部拒绝'} ${targets.length} 人:\n${results.join('\n')}` };
+            }
+            return { ok: failed === targets.length ? false : true, msg: `${targets.length - failed}/${targets.length} 成功:\n${results.join('\n')}` };
+        },
+    });
+    const sessionListTool = defineTool({
+        name: 'session_list',
+        description: '会话(读): 列出本 bot 全部活跃会话(sessionId/范围/peer/最近活跃/预设), 用于跨会话寻址(找 session_wake 的目标 id)。',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'object', additionalProperties: false,
+                properties: { ok: { type: 'boolean', required: true }, msg: { type: 'string', required: true } },
+            },
+            render: (_a, v) => [{ type: 'text', text: v.ok ? v.msg : `失败: ${v.msg}` }],
+        },
+        async execute(_args, exec) {
+            const tail = (s, n = 10) => (s && s.length > n ? '…' + s.slice(-n) : (s ?? ''));
+            const lines = [];
+            // 遍历全部已注册实例(module 级注册表, 重启后仍可枚举; 不依赖 channelBridges)
+            const managers = managersOf();
+            if (managers.length === 0) {
+                const ch = channelOf(exec);
+                const manager = ch?.manager;
+                if (manager)
+                    managers.push(manager);
+            }
+            if (managers.length === 0)
+                return { ok: false, msg: '找不到会话管理器实例(无已注册实例)' };
+            let n = 0;
+            for (const manager of managers) {
+                const list = manager.listSessions();
+                const ns = manager.settingsNs;
+                for (const s of list) {
+                    n++;
+                    lines.push(`${n}. [${s.scope}]${ns !== 'im-qqbot' ? `(${ns})` : ''} peer=${tail(s.peerId)} sender=${tail(s.senderId, 8)} id=${s.sessionId}${s.agentPreset ? ` (${s.agentPreset})` : ''} 活跃=${new Date(s.lastActivity).toLocaleTimeString()}`);
+                }
+                // 潜在会话: 群注册表里的群可能还没 getOrCreate(无活跃记录), 但 sessionId 可确定性算出
+                try {
+                    const raw = readFileSync(groupRegistryPath(manager.cwd), 'utf8');
+                    const reg = JSON.parse(raw);
+                    const ids = new Set(list.map((s) => s.sessionId));
+                    for (const gid of Object.keys(reg ?? {})) {
+                        const sid = manager.sessionIdFor('group', gid);
+                        if (!ids.has(sid))
+                            lines.push(`[潜在群] ${reg[gid]?.name ?? ''}(${tail(gid)}) id=${sid} 活跃=未创建`);
+                    }
+                }
+                catch { /* 无注册表/读失败则跳过 */ }
+            }
+            if (lines.length === 0)
+                return { ok: true, msg: '当前无活跃会话, 也无已注册群' };
+            return { ok: true, msg: `会话 ${lines.length} 个:\n${lines.join('\n')}` };
+        },
+    });
+    /** 发到目标 QQ 群/私聊: 若给了 media 先发图(用目标 manager 归属的 sender), 再发带来源文本; 无 sender 则 groupAdmin 文本兜底 */
+    async function sendQQWithMedia(manager, scope, peer, body, media, exec) {
+        const ch = channelBridges.find((b) => b.manager === manager);
+        const sent = [];
+        if (media) {
+            if (ch?.sender) {
+                try {
+                    const src = /^https?:\/\//i.test(media) ? { url: media } : { localPath: media };
+                    await ch.sender.sendMedia({ scope, targetId: peer }, 'image', src);
+                    sent.push('🖼️图');
+                }
+                catch {
+                    sent.push('⚠️发图失败');
+                }
+            }
+            else {
+                sent.push('⚠️无发送通道');
+            }
+        }
+        const ga = groupAdminOf(exec);
+        if (ga) {
+            if (scope === 'c2c') {
+                // c2c 主动推送必须走官方 is_wakeup 召回通道(30天窗), 自建 REST sendC2cText 无 is_wakeup
+                // → 被动回复窗口外不投递(web LLM 已唤醒但 QQ 收不到, 2026-09-10 主人实测 bug)。
+                // 优先 ch.sender.sendC2cWakeup(SDK sendWakeup); 无 sender 才退自建 REST。
+                if (ch?.sender && typeof ch.sender.sendC2cWakeup === 'function') {
+                    try {
+                        await ch.sender.sendC2cWakeup({ scope, targetId: peer }, body);
+                        sent.push('📨已发到QQ 私聊');
+                    }
+                    catch (err) {
+                        sent.push(`⚠️QQ私聊发送失败: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+                else {
+                    const sr = await ga.client.sendC2cText(peer, body);
+                    sent.push(sr.ok ? '📨已发到QQ 私聊(降级)' : `⚠️QQ发送失败: ${sr.err.human}`);
+                }
+            }
+            else {
+                const sr = await ga.client.sendGroupText(peer, body);
+                sent.push(sr.ok ? '📨已发到QQ 群' : `⚠️QQ发送失败: ${sr.err.human}`);
+            }
+        }
+        else {
+            sent.push('⚠️群管理未开启');
+        }
+        return `；${sent.join(' ')}`;
+    }
+    const sessionWakeTool = defineTool({
+        name: 'session_wake',
+        description: '跨会话(写,需谨慎): 向指定会话发送一条消息; mode=wake(默认)唤醒该会话的 LLM(给 AI 看), mode=append 只把消息写进该会话上下文不唤醒(省 token, 喇叭模式, AI 下次回合自然看到)。同时把带来源标注的消息通过 QQBot 通道发到该会话绑定的群/私聊(给人看)。可用 session_list 查目标 id; 也支持按 peerId(群/私聊) 寻址。支持 batch 批量: 一次向多个会话各发不同文本(每项带自己的 session_id/peer_id/text/mode/send_qq/media)。仅主人明确要求时调用。', parameters: {
+            session_id: { type: 'string', description: '目标会话 id(完整 sessionId, 来自 session_list)' },
+            peer_id: { type: 'string', description: '或按 peer 寻址: 群 openid/私聊 openid(需带 scope)' },
+            scope: { type: 'string', enum: ['group', 'c2c'], description: 'peer_id 寻址时的范围(group=群 / c2c=私聊)' },
+            text: { type: 'string', required: true, description: '要发送的消息内容(唤醒模式会作为用户消息喂给 AI)' },
+            mode: { type: 'string', enum: ['wake', 'append'], description: 'wake=唤醒 LLM 开回合(默认); append=只追加上下文不唤醒(省 token, 喇叭模式)' },
+            send_qq: { type: 'boolean', description: '是否同时发到绑定的 QQ 群/私聊(给人看, 默认 true)。false=只处理 LLM 侧不走 QQ 通道' },
+            media: { type: 'string', description: '跨群发图: 图片本地路径或 http(s) URL, 随消息发到目标群(需 send_qq=true)' },
+            batch: { type: 'array', description: '批量模式(2026-09-10): 一次向多个会话各发不同文本。每项: {session_id 或 peer_id+scope, text, mode?, send_qq?, media?}。单发参数与 batch 二选一, batch 优先。', items: {
+                    type: 'object', additionalProperties: false, properties: {
+                        session_id: { type: 'string', description: '目标会话 id' },
+                        peer_id: { type: 'string', description: '或 peer 寻址: 群/私聊 openid' },
+                        scope: { type: 'string', enum: ['group', 'c2c'], description: 'peer 寻址范围' },
+                        text: { type: 'string', required: true, description: '该会话要发的消息内容' },
+                        mode: { type: 'string', enum: ['wake', 'append'], description: '默认 wake' },
+                        send_qq: { type: 'boolean', description: '默认 true' },
+                        media: { type: 'string', description: '该会话随消息发的图片' },
+                    },
+                } },
+        },
+        output: {
+            schema: {
+                type: 'object', additionalProperties: false,
+                properties: { ok: { type: 'boolean', required: true }, msg: { type: 'string', required: true } },
+            },
+            render: (_a, v) => [{ type: 'text', text: v.ok ? v.msg : `失败: ${v.msg}` }],
+        },
+        async execute(args, exec) {
+            // 来源标注(便于对方直接会话): 优先当前执行 agent 的 id(=会话 id); 再取当前会话记录;
+            // 再回退 groupAdmin 的 hub 会话; 最后 'web'
+            const from = (() => {
+                try {
+                    const aid = exec.agent?.id;
+                    if (typeof aid === 'string' && aid.length >= 8)
+                        return aid.slice(0, 8) + '…';
+                    const ch0 = channelOf(exec);
+                    const src = findSessionRec(ch0, exec);
+                    if (src?.rec?.sessionId)
+                        return src.rec.sessionId.slice(0, 8) + '…';
+                }
+                catch { /* 忽略 */ }
+                return 'web';
+            })();
+            const map = {
+                ok: '✅ 已发送并唤醒',
+                'no-session': `❌ 会话不存在: 目标会话不在任何已注册实例中(或已重建/换绑)`,
+                'no-followup': '❌ 该会话 agent 不支持 followup 唤醒',
+                'no-append': '❌ 该会话 agent 不支持上下文追加',
+                'no-agent': '❌ 找不到目标会话 agent',
+                busy: '⏳ 目标会话正忙(回合进行中且无安全注入通道)',
+                fail: '❌ 处理异常',
+            };
+            /** 单条发送(单发与 batch 共用): one={session_id?|peer_id?+scope?, text, mode?, send_qq?, media?} */
+            const sendOne = async (one) => {
+                const text = String(one.text || '');
+                if (!text)
+                    return '❌ 缺少 text';
+                const body = `【来自会话 ${from}】\n${text}${one.media ? `\n[附带图片: ${one.media}]` : ''}`;
+                const sid = String(one.session_id || '');
+                if (sid) {
+                    // ① session_id 寻址: module 级注册表跨全部实例精确命中(重启后仍可查)
+                    const manager = findManagerBySessionId(sid);
+                    if (!manager)
+                        return `❌ 会话不存在: ${sid.slice(0, 8)}…(不在任何已注册实例)`;
+                    const mode = String(one.mode || 'wake');
+                    let r;
+                    if (mode === 'append') {
+                        const rec0 = manager.findBySessionId(sid);
+                        const targetAgent = rec0?.agent
+                            ?? manager.findHostAgent(sid)?.agent
+                            ?? (await manager.resumeHostAgent(sid).catch(() => undefined))?.agent;
+                        if (!targetAgent)
+                            r = 'no-session';
+                        else
+                            r = await safeAppendUserMessage(targetAgent, body, loggerLike(exec));
+                    }
+                    else {
+                        r = await wakeSessionAgent(manager, sid, loggerLike(exec), body);
+                    }
+                    let extra = '';
+                    if (one.send_qq !== false) {
+                        // 目标 peer: ⚠️ 不能只问 findManagerBySessionId 返回的 manager——它可能经 findHostAgent 命中
+                        // 错误实例(宿主 registry 全局), 导致 rec=undefined → 静默不发(2026-09-10 04:35 实测)。
+                        let qScope;
+                        let qPeer = '';
+                        let ownerManager;
+                        for (const m of managersOf()) {
+                            try {
+                                const r2 = m.findBySessionId(sid);
+                                if (r2) {
+                                    ownerManager = m;
+                                    qScope = r2.scope;
+                                    qPeer = r2.peerId;
+                                    break;
+                                }
+                            }
+                            catch { /* 单实例异常跳过 */ }
+                        }
+                        if (!ownerManager) {
+                            for (const m of managersOf()) {
+                                try {
+                                    const raw = readFileSync(groupRegistryPath(m.cwd), 'utf8');
+                                    const reg = JSON.parse(raw);
+                                    for (const gid of Object.keys(reg ?? {})) {
+                                        if (m.sessionIdFor('group', gid) === sid) {
+                                            ownerManager = m;
+                                            qScope = 'group';
+                                            qPeer = gid;
+                                            break;
+                                        }
+                                    }
+                                    if (ownerManager)
+                                        break;
+                                }
+                                catch { /* 无注册表则跳过 */ }
+                            }
+                        }
+                        if (ownerManager && qScope && qPeer) {
+                            extra = await sendQQWithMedia(ownerManager, qScope, qPeer, body, String(one.media || ''), exec);
+                        }
+                        else {
+                            const diag = `未找到目标会话的 QQ peer(findBySessionId 与群注册表均 miss, sid=${sid.slice(0, 8)}…)`;
+                            try {
+                                loggerLike(exec).warn(`[session_wake] ${diag}`);
+                            }
+                            catch { /* */ }
+                            extra = `；⚠️${diag}`;
+                        }
+                    }
+                    return `${map[r] ?? r} (${sid.slice(0, 8)}…)${extra}`;
+                }
+                // ② peer 寻址
+                const peer = String(one.peer_id || '');
+                const sc = String(one.scope || '');
+                if (!peer || !sc)
+                    return '请给 session_id, 或 scope+peer_id';
+                let manager = findManagerByPeer(sc, peer);
+                if (!manager) {
+                    const curCh = channelOf(exec);
+                    if (curCh?.manager && curCh.manager.findByPeer(sc, peer))
+                        manager = curCh.manager;
+                    else if (curCh?.manager)
+                        manager = curCh.manager;
+                }
+                if (!manager)
+                    return '找不到会话管理器实例(无已注册实例)';
+                let rec = manager.findByPeer(sc, peer);
+                if (!rec) {
+                    if (sc === 'c2c') {
+                        return `❌ 未找到该私聊对象的真实会话(${peer.slice(0, 8)}…): 请先让对方主动私聊本 bot 一次(dock「💬聊天」里能直接发), 或用 session_id 寻址。原因: openid 按 bot 应用隔离, 乱建会话会发到错误实例`;
+                    }
+                    rec = await manager.getOrCreate(sc, peer, 'master', { scope: sc, targetId: peer });
+                    if (!rec)
+                        return `会话创建失败: ${sc} ${peer.slice(0, 8)}…`;
+                }
+                const sid2 = rec.sessionId;
+                const mode2 = String(one.mode || 'wake');
+                let r;
+                if (mode2 === 'append') {
+                    r = rec.agent
+                        ? await safeAppendUserMessage(rec.agent, body, loggerLike(exec))
+                        : 'no-session';
+                }
+                else {
+                    r = await wakeSessionAgent(manager, sid2, loggerLike(exec), body);
+                }
+                let extra = '';
+                if (one.send_qq !== false) {
+                    extra = await sendQQWithMedia(manager, sc, peer, body, String(one.media || ''), exec);
+                }
+                return `${map[r] ?? r} (${sid2.slice(0, 8)}…)${extra}`;
+            };
+            // batch 优先(2026-09-10 主人: 多参数=一次多个会话各发不同文本)
+            if (Array.isArray(args.batch) && args.batch.length > 0) {
+                const results = [];
+                for (const item of args.batch) {
+                    if (!item || typeof item !== 'object') {
+                        results.push('❌ batch 项无效');
+                        continue;
+                    }
+                    try {
+                        results.push(await sendOne(item));
+                    }
+                    catch (e) {
+                        results.push(`❌ 发送异常: ${String(e?.message || e)}`);
+                    }
+                }
+                return { ok: results.every((x) => x.startsWith('✅')), msg: `批量 ${results.length} 条:\n` + results.map((x, i) => `${i + 1}. ${x}`).join('\n') };
+            }
+            const oneR = await sendOne(args);
+            return { ok: oneR.startsWith('✅'), msg: oneR };
         },
     });
     const muteStateTool = defineTool({
@@ -1007,6 +1353,8 @@ export async function apply(ctx) {
         { name: 'group_approve_join', tool: approveJoinTool },
         { name: 'group_mute_state', tool: muteStateTool },
         { name: 'group_mute_member', tool: muteMemberTool },
+        { name: 'session_list', tool: sessionListTool },
+        { name: 'session_wake', tool: sessionWakeTool },
         { name: 'list_stickers', tool: listStickersTool },
         { name: 'sticker_tag', tool: tagStickerTool },
         { name: 'sticker_delete', tool: deleteStickerTool },