@zaofan/dsh-qqbot 0.6.0 → 0.8.1

package/dist/features/qq-user-questions.js

@@ -0,0 +1,256 @@
+const BTN_PREFIX = 'q:';
+/** 选项按钮 keyboard(每行1个=竖排, 字宽不截断; QQ 最多5行 → 最多5个选项可见)
+ *  permission: 群聊限定"发起对话者本人"可点(specify_user_ids=ownerId), 防群里其他人替你选 */
+function optionsKeyboard(qid, token, opts, ownerId) {
+    const maxRows = 5;
+    const shown = opts.slice(0, maxRows);
+    const permission = ownerId
+        ? { type: 0, specify_user_ids: [ownerId] }
+        : { type: 2 };
+    const rows = shown.map((opt, idx) => ({
+        buttons: [{
+                id: `${BTN_PREFIX}${qid}:${token}:${idx}`,
+                render_data: {
+                    label: String(opt.label ?? '').slice(0, 24),
+                    visited_label: String(opt.label ?? '').slice(0, 24),
+                    style: 1,
+                },
+                action: {
+                    type: 1,
+                    permission,
+                    data: `${BTN_PREFIX}${qid}:${token}:${idx}`,
+                    unsupport_tips: '请直接回复选项文字',
+                },
+            }],
+    }));
+    return { content: { rows } };
+}
+/**
+ * 解析"这张提问卡片该谁回答": 扫最近(≤60 条)真人 user/message——
+ *  ① 消息文本里的 <@openid>: 取最后一个(提问目标通常放在句末; 前面常是 @bot 自己)
+ *  ② 无点名: 取消息发送者壳 [昵称 (openid)] 的 openid(谁发的就给谁答)
+ *  ③ 兜底: 会话发起者 record.senderId
+ * plugin 注入(上下文/系统)跳过。
+ */
+function resolveCardOwner(record) {
+    try {
+        const evs = record.agent?.session?.events;
+        if (Array.isArray(evs) && evs.length > 0) {
+            const from = Math.max(0, evs.length - 60);
+            for (let i = evs.length - 1; i >= from; i--) {
+                const ev = evs[i];
+                if (!ev || ev.type !== 'user/message')
+                    continue;
+                const data = ev.data && typeof ev.data === 'object' ? ev.data : ev;
+                const src = data.source;
+                if (src && src.kind === 'plugin')
+                    continue;
+                const content = Array.isArray(data.content) ? data.content : [];
+                const text = content.map((b) => (b?.text ?? '')).join('\n');
+                if (!text)
+                    continue;
+                const ats = [];
+                for (const m of text.matchAll(/<@([A-Za-z0-9]{32})>/g))
+                    ats.push(m[1]);
+                if (ats.length > 0)
+                    return ats[ats.length - 1];
+                const shell = text.match(/\[[^\]\n]*?\s*\(([A-Za-z0-9]{32})\)\]/);
+                if (shell)
+                    return shell[1];
+                return record.senderId;
+            }
+        }
+    }
+    catch { /* 解析失败回落 */ }
+    return record.senderId;
+}
+export class QqUserQuestionsController {
+    manager;
+    sender;
+    logger;
+    timeoutMsProvider;
+    pending = new Map();
+    constructor(manager, sender, logger, timeoutMsProvider) {
+        this.manager = manager;
+        this.sender = sender;
+        this.logger = logger;
+        this.timeoutMsProvider = timeoutMsProvider;
+    }
+    /**
+     * 宿主 user-questions/request 处理器。只 claim"会话可定位 + 第一个问题带选项"的场景;
+     * 其余(无会话/无选项/多问题) → next() 交回宿主(Web UI 或原样)。
+     */
+    async request(req, next) {
+        const record = this.manager.findByAgent(req.agent);
+        if (!record)
+            return next();
+        const questions = Array.isArray(req.questions) ? req.questions : [];
+        if (questions.length === 0)
+            return next();
+        const q = questions[0];
+        const qid = String(q?.id ?? '');
+        const opts = Array.isArray(q?.options) ? q.options : [];
+        if (!qid || opts.length === 0 || opts.length > 25)
+            return next();
+        const timeoutMs = Math.max(5000, this.timeoutMsProvider() || 120000);
+        const token = Math.random().toString(36).slice(2, 8);
+        const key = `${qid}:${token}`;
+        const headerRaw = String(q?.header ?? '');
+        const detailRaw = String(q?.detail ?? '');
+        const questionRaw = String(q?.question ?? '');
+        // 卡片可点人: 从最近真人消息解析——被点名的最后一人(@)优先, 其次消息发送者壳, 回落会话发起者
+        // (修复: 主人让 bot 问群友时, 卡片应绑被问者而不是 bot/主人, 否则被问者点卡片=无权限)
+        const owner = resolveCardOwner(record);
+        // 先注册 pending(防按钮回调先于 Promise 建立到达)
+        let resolver = () => undefined;
+        const answer = new Promise((resolve) => { resolver = resolve; });
+        const item = {
+            qid, question: questionRaw, header: headerRaw, detail: detailRaw,
+            opts: opts.map((o) => ({ label: String(o?.label ?? '') })),
+            ownerId: owner,
+            deadlineAt: Date.now() + timeoutMs,
+            resolve: resolver, timer: setTimeout(() => this.settle(key, true), timeoutMs),
+            signal: req.signal,
+        };
+        if (req.signal) {
+            item.onAbort = () => this.settle(key, true);
+            try {
+                req.signal.addEventListener('abort', item.onAbort, { once: true });
+            }
+            catch { /* ignore */ }
+        }
+        this.pending.set(key, item);
+        const header = headerRaw ? `**${headerRaw}**\n\n` : '';
+        const detail = detailRaw ? `\n\n${detailRaw}` : '';
+        const prompt = `${header}❓ **${questionRaw}**${detail}\n\n⏱ ${Math.ceil(timeoutMs / 1000)} 秒内点下方按钮回答：`;
+        try {
+            await this.sender.sendMarkdownWithKeyboard(record.replyTarget, prompt, optionsKeyboard(qid, token, opts, owner));
+            this.logger.info(`QQ question sent: qid=${qid} opts=${opts.length}`);
+        }
+        catch (err) {
+            this.logger.warn(`QQ question card failed: ${err instanceof Error ? err.message : String(err)}`);
+            // 卡片不可用 → 文本列选项, 不 claim(回复走正常入站, agent 自己取答案)
+            const lines = [`❓ ${questionRaw}`, '', ...opts.map((o, i) => `${i + 1}. ${o?.label ?? ''}`), '', '（直接回复序号或内容）'];
+            try {
+                await this.sender.sendMarkdown(record.replyTarget, lines.join('\n'));
+            }
+            catch (err2) {
+                // QQ 文本降级也失败(限频/网络)≠ 提问结束: 保留 pending 供 Web 浮层兜底,
+                // 不要 settle —— 否则 QQ 没送达时 web 也看不到。
+                this.logger.error(`QQ question fallback text failed: ${err2 instanceof Error ? err2.message : String(err2)} (qid=${qid}, web 浮层可兜底)`);
+                return answer;
+            }
+            this.settle(key, true);
+        }
+        return answer;
+    }
+    /** interaction 回调: data = q:<qid>:<token>:<idx> → 按选项 label 组 answer; 仅发起者本人可答 */
+    async handleInteraction(event, replyTarget) {
+        const e = event;
+        if (e?.data?.type !== 11)
+            return false;
+        const data = e.data.resolved?.button_data;
+        if (!data || !data.startsWith(BTN_PREFIX))
+            return false;
+        const m = /^q:([^:]+):([^:]+):(\d+)$/.exec(data);
+        if (!m)
+            return false;
+        const qid = m[1];
+        const token = m[2];
+        const idx = Number(m[3]);
+        const key = `${qid}:${token}`;
+        const item = this.pending.get(key);
+        if (!item)
+            return false;
+        // 防别人代答: 群聊看 group_member_openid, c2c 看 user_openid, 必须等于发起者
+        const presser = e.group_member_openid ?? e.user_openid ?? '';
+        if (item.ownerId && presser && presser !== item.ownerId) {
+            try {
+                this.sender.sendMarkdown(replyTarget, '这个问题不是问你的哦~').catch(() => undefined);
+            }
+            catch { /* ignore */ }
+            return true;
+        }
+        const label = item.opts[idx]?.label ?? '';
+        if (!label)
+            return false;
+        try {
+            this.sender.sendMarkdown(replyTarget, `已选择：${label}`).catch(() => undefined);
+        }
+        catch { /* ignore */ }
+        this.settle(key, false, { answers: [{ id: item.qid, selected: [label] }] });
+        return true;
+    }
+    /** 结算: timedOut/abort → 空答案(selected:[]); answered → 携带选择 */
+    settle(key, empty, value) {
+        const item = this.pending.get(key);
+        if (!item)
+            return;
+        this.pending.delete(key);
+        clearTimeout(item.timer);
+        if (item.signal && item.onAbort) {
+            try {
+                item.signal.removeEventListener('abort', item.onAbort);
+            }
+            catch { /* ignore */ }
+        }
+        item.resolve(empty ? { answers: [{ id: item.qid, selected: [] }] } : value);
+    }
+    /** Web 浮层拉取待办问题列表 */
+    listPendingForWeb() {
+        const out = [];
+        for (const [key, p] of this.pending) {
+            out.push({
+                key,
+                question: p.question,
+                header: p.header,
+                detail: p.detail,
+                options: p.opts,
+                deadlineAt: p.deadlineAt,
+            });
+        }
+        return out.sort((a, b) => a.deadlineAt - b.deadlineAt);
+    }
+    /** Web 浮层点选项: key + 选项下标 → 与 QQ 按钮同源结算(先到先得) */
+    decideByWeb(key, optIdx) {
+        const item = this.pending.get(key);
+        if (!item)
+            return { ok: false, msg: '该问题不存在或已过期' };
+        const label = item.opts[optIdx]?.label;
+        if (!label)
+            return { ok: false, msg: '无效选项' };
+        this.settle(key, false, { answers: [{ id: item.qid, selected: [label] }] });
+        return { ok: true, msg: `已选择：${label}` };
+    }
+    dispose() {
+        for (const key of [...this.pending.keys()])
+            this.settle(key, true);
+    }
+}
+// ── 按实例(ns)注册的提问控制器注册表 —— Web 提问浮层(settings-host 同源路由)经此读写 ──
+const questionControllers = new Map();
+export function registerQuestionController(ns, c) {
+    if (c)
+        questionControllers.set(ns, c);
+    else
+        questionControllers.delete(ns);
+}
+/** 汇总所有实例的待办提问 */
+export function listAllPendingQuestionsWeb() {
+    const out = [];
+    for (const [ns, c] of questionControllers) {
+        for (const p of c.listPendingForWeb())
+            out.push({ ns, ...p });
+    }
+    return out.sort((a, b) => a.deadlineAt - b.deadlineAt);
+}
+/** 跨实例结算提问 */
+export function decideQuestionByWebAny(key, optIdx) {
+    for (const [ns, c] of questionControllers) {
+        const r = c.decideByWeb(key, optIdx);
+        if (r.ok)
+            return { ok: true, ns, msg: r.msg };
+    }
+    return { ok: false, msg: '该问题不存在或已过期' };
+}
+//# sourceMappingURL=qq-user-questions.js.map

package/dist/features/qq-user-questions.js.map

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

package/dist/features/session-registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * session-registry.ts — 按实例(ns)注册 SessionManager 的模块级注册表
+ *
+ * 与 qq-approval.ts 的 registerApprovalController 同款模式:
+ * qqbot 本体 bootstrap 里 registerSessionManager(ns, manager), effect 清理注销;
+ * settings-host.js 动态 import 本模块后, 可跨"插件模块"拿到各实例的 SessionManager
+ * (同一物理文件同一 ESM 实例, 无 realm 隔离 —— 已被 approval/questions 双通道验证)。
+ *
+ * 用途:
+ *  - 线A(悬浮球自动选中): 按 web sessionId 反查 QQ 会话(精确命中含 fork 后 randomUUID);
+ *  - 线B(用户代发插入上下文): 按 ns+scope+peerId 找会话 record, append user/message(模拟用户消息)。
+ */
+import type { SessionManager } from '../session/index.js';
+import type { ChatScope } from '../types.js';
+export declare function registerSessionManager(ns: string, m: SessionManager | undefined): void;
+/** 遍历所有实例, 按 web sessionId 精确反查会话记录(唯一可靠源: record.sessionId 含 fork 后的 randomUUID) */
+export declare function findSessionBySessionIdWeb(sessionId: string): Array<{
+    ns: string;
+    sessionId: string;
+    scope: ChatScope;
+    peerId: string;
+    senderId: string;
+    agentPreset?: string;
+    lastActivity: number;
+}>;
+/** 按 ns+scope+peerId 找会话记录(线B: 用户代发后把消息 append 进该会话) */
+export declare function findRecordByPeerWeb(ns: string, scope: ChatScope, peerId: string): {
+    ns: string;
+    sessionId: string;
+    scope: ChatScope;
+    peerId: string;
+    senderId: string;
+    agent?: unknown;
+} | undefined;
+/** 活跃表 miss(会话被回收/未建立)时恢复/重建会话 —— 与入群申请通知/定时任务同款 getOrCreate(不开回合, 只保证 log 存在) */
+export declare function getOrCreateByPeerWeb(ns: string, scope: ChatScope, peerId: string, senderId?: string): Promise<{
+    ns: string;
+    sessionId: string;
+    scope: ChatScope;
+    peerId: string;
+    senderId: string;
+    agent?: unknown;
+} | undefined>;
+/** 标记某实例在线状态(bootstrap bot ready/error/resumed 事件驱动) */
+export declare function setBotOnline(ns: string, on: boolean): void;
+/** 某实例是否在线(未注册/未知 = false) */
+export declare function isBotOnline(ns: string): boolean;
+/** 是否已注册某 ns(诊断用) */
+export declare function hasManager(ns: string): boolean;
+export declare function listManagerNs(): string[];
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/features/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../../src/features/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAGtF;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAwBD;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAepH;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,SAAW,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,CAe7H;AAID,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAG1D;AACD,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,qBAAqB;AACrB,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/features/session-registry.js

@@ -0,0 +1,95 @@
+const managers = new Map();
+export function registerSessionManager(ns, m) {
+    if (m)
+        managers.set(ns, m);
+    else
+        managers.delete(ns);
+}
+/** 遍历所有实例, 按 web sessionId 精确反查会话记录(唯一可靠源: record.sessionId 含 fork 后的 randomUUID) */
+export function findSessionBySessionIdWeb(sessionId) {
+    const out = [];
+    for (const [ns, m] of managers) {
+        try {
+            const r = m.findBySessionId(sessionId);
+            if (r) {
+                out.push({
+                    ns,
+                    sessionId: r.sessionId,
+                    scope: r.scope,
+                    peerId: r.peerId,
+                    senderId: r.senderId,
+                    agentPreset: r.agentPreset,
+                    lastActivity: typeof r.lastActivity === 'number'
+                        ? r.lastActivity
+                        : 0,
+                });
+            }
+        }
+        catch { /* 单实例异常跳过 */ }
+    }
+    return out;
+}
+/** 按 ns+scope+peerId 找会话记录(线B: 用户代发后把消息 append 进该会话) */
+export function findRecordByPeerWeb(ns, scope, peerId) {
+    const m = managers.get(ns);
+    if (!m)
+        return undefined;
+    try {
+        const r = m.findByPeer(scope, peerId);
+        if (!r)
+            return undefined;
+        return {
+            ns,
+            sessionId: r.sessionId,
+            scope: r.scope,
+            peerId: r.peerId,
+            senderId: r.senderId,
+            agent: r.agent,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 活跃表 miss(会话被回收/未建立)时恢复/重建会话 —— 与入群申请通知/定时任务同款 getOrCreate(不开回合, 只保证 log 存在) */
+export async function getOrCreateByPeerWeb(ns, scope, peerId, senderId = 'master') {
+    const m = managers.get(ns);
+    if (!m || typeof m.getOrCreate !== 'function')
+        return undefined;
+    try {
+        const r = await m.getOrCreate(scope, peerId, senderId, { scope, targetId: peerId });
+        if (!r)
+            return undefined;
+        return {
+            ns,
+            sessionId: r.sessionId,
+            scope: r.scope,
+            peerId: r.peerId,
+            senderId: r.senderId,
+            agent: r.agent,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+const botOnline = new Map();
+/** 标记某实例在线状态(bootstrap bot ready/error/resumed 事件驱动) */
+export function setBotOnline(ns, on) {
+    if (on)
+        botOnline.set(ns, true);
+    else
+        botOnline.delete(ns);
+}
+/** 某实例是否在线(未注册/未知 = false) */
+export function isBotOnline(ns) {
+    return botOnline.get(ns) === true;
+}
+/** 是否已注册某 ns(诊断用) */
+export function hasManager(ns) {
+    return managers.has(ns);
+}
+export function listManagerNs() {
+    return [...managers.keys()];
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/features/session-registry.js.map

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

package/dist/gateway/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/gateway/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAU1C,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA4Tf"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/gateway/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2B1C,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAsYf"}

package/dist/gateway/bootstrap.js

@@ -10,12 +10,25 @@ import { initStickerGate, bindStickerGates, flushStickerGate, getStickerGate, St
 import { startScheduler } from '../features/scheduler.js';
 import { configureScheduleStore, getScheduleStore } from '../features/schedule-store.js';
 import { setChannelBridge } from '../channel-tools.js';
-import { QqApprovalController, setApprovalDispatch, makeApprovalListener } from '../features/qq-approval.js';
+import { QqApprovalController, setApprovalDispatch, makeApprovalListener, registerApprovalController } from '../features/qq-approval.js';
+import { QqUserQuestionsController, registerQuestionController } from '../features/qq-user-questions.js';
 import { handleGroupJoinRequestEvent } from '../features/group-join-request.js';
+import { registerSessionManager, setBotOnline } from '../features/session-registry.js';
+/** 从 interaction 事件推出"回复目标"(回执发到按钮所在群/私聊)。scope 由事件 chat_type/scene 推断 */
+function replyTargetOfInteraction(event, _ctx, _manager) {
+    const e = event;
+    if (e?.group_openid)
+        return { scope: 'group', targetId: e.group_openid };
+    if (e?.user_openid)
+        return { scope: 'c2c', targetId: e.user_openid };
+    // 兜底: 群聊 member_openid 只能推群, 但没有 group_openid 无法构造 → 空 target(上层会忽略)
+    return { scope: (e?.chat_type === 1 || e?.scene === 'group') ? 'group' : 'c2c', targetId: e?.group_member_openid ?? '' };
+}
 export async function bootstrapGateway(ctx, agents, config, logger) {
     const manager = new SessionManager(ctx, agents, config, logger);
     // QQ 远程审批控制器(enableApprovals 时创建; 定义在 sender 就绪后, 此处先声明供入站回调引用)
     let approvalController;
+    let questionController;
     // ── 表情包图库单例预初始化(防目录分裂) ──
     // ⚠️ 单例时序坑：谁先 getStickerStore 谁定路径。必须在启动早期按 config.cwd
     //    初始化，否则 list_stickers(无参)会以 process.cwd 建错目录(线上踩坑:C盘幽灵库)。
@@ -140,9 +153,16 @@ export async function bootstrapGateway(ctx, agents, config, logger) {
                 // 平台限制: markdown 主动消息常需专门权限; c2c 主动需 48h 互动窗, 窗口外拒收。
                 // 降级顺序: sendMarkdown → sendText(纯文本主动) → c2c sendWakeup(is_wakeup 召回, 30天窗)。
                 if (!target.msgId) {
+                    // ⚠️ 清洗仅针对 markdown 语法字符; QQ at 标签必须原样保留——
+                    // 实测(2026-09-06): 高亮 @ 用 `<@openid>`(无斜杠)或 `<qqbot-at-user id="openid" />`;
+                    // 剥掉 '>' 会把标签弄残 → QQ 不渲染。这里先把两类 at 标签暂存, 清洗完再恢复。
                     const plain = String(content || '')
+                        .replace(/<qqbot-at-user\s+id="([A-Za-z0-9]+)"\s*\/>/g, '\u0001ATQ:$1\u0001')
+                        .replace(/<@([A-Za-z0-9]+)>/g, '\u0001ATA:$1\u0001')
                         .replace(/[#*`_~>]/g, '')
                         .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1')
+                        .replace(/\u0001ATQ:([A-Za-z0-9]+)\u0001/g, '<qqbot-at-user id="$1" />')
+                        .replace(/\u0001ATA:([A-Za-z0-9]+)\u0001/g, '<@$1>')
                         .trim();
                     if (plain) {
                         try {
@@ -172,6 +192,13 @@ export async function bootstrapGateway(ctx, agents, config, logger) {
                 throw err;
             }
         },
+        sendMarkdownWithKeyboard: async (target, content, keyboard) => {
+            // 卡片按钮(审批/提问): bot.send 显式 msg_type=2 + keyboard。
+            // 失败直接抛(不静默降级)——由调用方决定文本兜底, 避免"卡片+文本码"双发。
+            const resp = (await bot.send({ target, msgType: 2, markdown: { content }, keyboard: keyboard }));
+            pushSent(target, resp?.id);
+            return resp;
+        },
         openStream: (target) => bot.openStream({
             target: {
                 scope: target.scope,
@@ -238,6 +265,10 @@ export async function bootstrapGateway(ctx, agents, config, logger) {
     // ①dispatch: ownership(只处理本 bot 的 agent)+ enableApprovals 闸门;
     // ②监听: 注册在插件 apply ctx, 用 {prepend:true} 插到链首(抢在宿主 GUI 转发器 dsh-api-remotes 之前)。
     approvalController = new QqApprovalController(manager, sender, logger, () => config.approvalTimeoutMs);
+    // 注册进 ns 注册表(Web 审批浮层经 settings-host 同源路由读写); ns 取 settingsNs 与 index.ts 一致
+    const myNs = config.settingsNs?.trim() || 'im-qqbot';
+    registerApprovalController(myNs, approvalController);
+    registerSessionManager(myNs, manager);
     setApprovalDispatch(((request, next) => {
         if (!config.enableApprovals)
             return next();
@@ -249,13 +280,65 @@ export async function bootstrapGateway(ctx, agents, config, logger) {
     ctx.on('approval/request', makeApprovalListener(), { prepend: true });
     console.log('[qq-approval] ACP-mode listener registered (apply-ctx + prepend)');
     logger.info(`[im-qqbot] QQ 远程审批接线就绪(${config.enableApprovals ? '已启用' : '默认关闭, Web 设置可热开'})`);
+    // ── QQ 远程提问(按钮卡片版): ask_user_question → QQ 卡片按钮 ──
+    // 宿主 user-questions/request 是 Agent 作用域 waterfall(同 approval), Web UI 答案器
+    // 在宿主引导期注册 → 本监听同样 {prepend:true} 抢链首。enableQuestions 默认开(与审批独立开关)。
+    const enableUserQuestions = config.enableUserQuestions !== false;
+    questionController = new QqUserQuestionsController(manager, sender, logger, () => config.approvalTimeoutMs || 120000);
+    registerQuestionController(myNs, questionController);
+    ctx.on('user-questions/request', (async (request, next) => {
+        if (!enableUserQuestions)
+            return next();
+        const reqAgent = request.agent;
+        if (!reqAgent || !manager.findByAgent(reqAgent))
+            return next(); // 非本 bot agent → GUI 兜底
+        try {
+            return await questionController.request(request, next);
+        }
+        catch (err) {
+            logger.warn(`[qq-questions] request 异常: ${err instanceof Error ? err.message : String(err)}`);
+            return next();
+        }
+    }), { prepend: true });
+    logger.info(`[im-qqbot] QQ 远程提问接线就绪(${enableUserQuestions ? '启用' : '关闭'})`);
+    // ── 按钮回调(INTERACTION_CREATE, type=11): 审批/提问卡片共用分发 ──
+    // SDK 事件: bot.on('interaction', (ctx, event) => …); 需 PUT /interactions/{id} 回应防 loading。
+    if (typeof bot.on === 'function') {
+        bot.on('interaction', (async (ctx, event) => {
+            const ev = event;
+            if (ev?.data?.type !== 11)
+                return; // 只处理消息按钮回调
+            const target = replyTargetOfInteraction(ev, ctx, manager);
+            let consumed = false;
+            try {
+                if (approvalController)
+                    consumed = await approvalController.handleInteraction(ev, target);
+                if (!consumed && questionController)
+                    consumed = await questionController.handleInteraction(ev, target);
+            }
+            catch (err) {
+                logger.warn(`[qq-interaction] 处理异常: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // 回应 loading(无论是否消费都要 ack; 防客户端一直转圈)
+            try {
+                await bot.acknowledgeInteraction(ev.id ?? '');
+            }
+            catch { /* ack 失败不致命 */ }
+        }));
+        logger.info('[im-qqbot] interaction(按钮回调)分发就绪');
+    }
     const outboundHandler = createOutboundHandler(manager, sender, config, logger, toolsRegistry);
     ctx
         .on('session/event', outboundHandler);
     bot.on('error', (err) => {
         logger.error(`bot error: ${err instanceof Error ? err.message : String(err)}`);
+        setBotOnline(myNs, false);
+    });
+    bot.on('resumed', () => {
+        setBotOnline(myNs, true);
     });
     bot.on('ready', () => {
+        setBotOnline(myNs, true);
         console.log(`[im-qqbot] Bot ready! appId=${config.appId}`);
     });
     // ── 生命周期 ──
@@ -331,7 +414,11 @@ export async function bootstrapGateway(ctx, agents, config, logger) {
         logger.info(`[schedule] ticker 启动 (30s, dataDir=${scheduleDataDir})`);
         return async () => {
             logger.info('Shutting down');
+            registerApprovalController(myNs, undefined);
+            registerQuestionController(myNs, undefined);
+            registerSessionManager(myNs, undefined);
             approvalController?.dispose();
+            questionController?.dispose();
             stopScheduler?.();
             if (scheduleTicker) {
                 clearInterval(scheduleTicker);