@izhimu/qq 0.3.2 → 0.5.0

package/README.md

@@ -27,7 +27,7 @@
 </p>
 
 ---
-
+![demo.png](docs/demo.png)
 ## 目录
 
 - [功能特性](#功能特性)
@@ -67,6 +67,9 @@
 ```bash
 # 安装插件
 openclaw plugins install @izhimu/qq
+
+# 更新插件
+openclaw plugins update @izhimu/qq
 ```
 
 ### 本地开发安装
@@ -141,6 +144,10 @@ openclaw gateway restart
 | `wsUrl` | `string` | 是 | - | NapCat WebSocket 地址 |
 | `accessToken` | `string` | 否 | `""` | 访问令牌（如配置了认证） |
 | `enabled` | `boolean` | 否 | `true` | 是否启用该账号 |
+| `markdownFormat` | `boolean` | 否 | `true` | 是否启用 Markdown 格式化转换 |
+| `messageDirect` | `object` | 否 | - | 私聊全局配置（策略、黑白名单） |
+| `messageGroup` | `object` | 否 | - | 群组全局配置（@响应、戳一戳、唤醒词等） |
+| `messageGroupsCustom` | `object` | 否 | `{}` | 特定群组的独立配置 |
 
 ### 配置示例
 
@@ -150,7 +157,19 @@ openclaw gateway restart
     "qq": {
       "wsUrl": "ws://127.0.0.1:3001",
       "accessToken": "your-token",
-      "enabled": true
+      "enabled": true,
+      "markdownFormat": true,
+      "messageDirect": {
+        "policy": "allow",
+        "denyFrom": ["12345678"]
+      },
+      "messageGroup": {
+        "requireMention": true,
+        "requirePoke": true,
+        "policy": "allowlist",
+        "allowFrom": ["123456"],
+        "wakeWord": "小艺"
+      }
     }
   }
 }
@@ -259,6 +278,7 @@ openclaw-channel-qq/
 | `reply` | ✓ | ✓ | 消息回复 |
 | `record` | ✓ | ✓ | 语音消息 |
 | `file` | ✓ | ✓ | 文件 |
+| `video` | ✓ | - | 视频消息 |
 | `json` | ✓ | - | JSON 富文本 |
 
 ### OneBot 11 接口
@@ -371,6 +391,35 @@ npm run build
 
 ## 更新日志
 
+### [0.5.0] - 2026-03-11
+
+#### 新增
+- **多媒体支持增强**：新增对视频（`video`）消息类型的入站支持。
+- **细粒度访问控制**：
+    - 新增 `messageDirect` 和 `messageGroup` 配置项，支持私聊和群组的独立策略控制（`allow`, `deny`, `allowlist`）。
+    - 支持基于用户 ID 的黑白名单过滤。
+- **群组触发增强**：
+    - 支持自定义群组唤醒词（`wakeWord`）。
+    - 支持开启/关闭戳一戳（`requirePoke`）响应。
+    - 支持针对特定群组进行独立配置（`messageGroupsCustom`）。
+- **Markdown 优化**：新增 `markdownFormat` 开关，可选择是否将 Markdown 转换为纯文本。
+
+#### 优化
+- **配置结构重构**：重构了配置解析逻辑，提高了配置项的灵活性。
+- **消息文本转换**：优化了多媒体消息（图片、视频、音频、文件等）在日志和历史记录中的纯文本展示效果。
+- **稳定性**：增加了 Gateway Context 的预检，提升了系统的健壮性。
+
+### [0.4.0] - 2026-03-07
+
+#### 新增
+- 群 At 模式（`groupAtMode`）- 开启后只有被 @ 或 @全体成员 时才回复
+- 登录信息存储功能，获取并保存当前登录 QQ 号
+- 消息中断处理机制，新消息到来时正确终止上一条消息的回复
+
+#### 修复
+- 修复 abort 后 deliver 仍然发送已终止消息的问题
+- 修复 abortController 状态检查不准确的问题（使用独立 aborted 标志）
+
 ### [0.3.0] - 2026-02-12
 
 #### 新增

package/dist/src/adapters/message.d.ts

@@ -3,6 +3,6 @@
  *
  * Optimized for maintainability with clear structure and minimal duplication.
  */
-import type { NapCatMessage, OpenClawMessage } from '../types/index.js';
+import type { NapCatMessage, OpenClawMessage } from '../types';
 export declare function openClawToNapCatMessage(content: OpenClawMessage[]): NapCatMessage[];
 export declare function napCatToOpenClawMessage(segments: NapCatMessage[] | string): Promise<OpenClawMessage[]>;

package/dist/src/adapters/message.js

@@ -4,7 +4,7 @@
  * Optimized for maintainability with clear structure and minimal duplication.
  */
 import { Logger as log, extractImageUrl, getEmojiForFaceId } from '../utils/index.js';
-import { CQCodeUtils } from '../utils/cqcode.js';
+import { CQCodeUtils } from '../utils';
 import { getMsg } from "../core/request.js";
 // =============================================================================
 // CQ Code Parsing
@@ -94,6 +94,12 @@ async function napCatToOpenClaw(segment) {
                 senderId: String(response.data.sender.user_id),
                 sender: response.data.sender.nickname
             };
+        case 'video':
+            return {
+                type: 'video',
+                url: String(data.url || ''),
+                fileSize: data.file_size ? parseInt(String(data.file_size), 10) : undefined,
+            };
         case 'face':
             return { type: 'text', text: getEmojiForFaceId(String(data.id || '')) };
         case 'record':

package/dist/src/channel.js

@@ -2,13 +2,13 @@
  * QQ NapCat Plugin for OpenClaw
  * Main plugin entry point
  */
-import { buildChannelConfigSchema, setAccountEnabledInConfigSection, deleteAccountFromConfigSection, DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID, buildChannelConfigSchema, setAccountEnabledInConfigSection, deleteAccountFromConfigSection } from "openclaw/plugin-sdk";
 import { messageIdToString, markdownToText, buildMediaMessage, Logger as log } from "./utils/index.js";
-import { setContext, setContextStatus, clearContext, setConnection, getConnection, clearConnection } from "./core/runtime.js";
+import { setContext, setContextStatus, clearContext, setConnection, getConnection, clearConnection, setLoginInfo, getContext } from "./core/runtime.js";
 import { ConnectionManager } from "./core/connection.js";
 import { openClawToNapCatMessage } from "./adapters/message.js";
 import { listQQAccountIds, resolveQQAccount, QQConfigSchema, CHANNEL_ID } from "./core/config.js";
-import { eventListener, sendMsg, getStatus } from "./core/request.js";
+import { eventListener, sendMsg, getStatus, getLoginInfo, getFriendList, getGroupList } from "./core/request.js";
 import { qqOnboardingAdapter } from "./onboarding.js";
 export const qqPlugin = {
     id: CHANNEL_ID,
@@ -16,7 +16,7 @@ export const qqPlugin = {
         id: CHANNEL_ID,
         label: "QQ",
         selectionLabel: "QQ",
-        docsPath: "/channels/qq",
+        docsPath: "extensions/qq",
         blurb: "通过 NapCat WebSocket 连接 QQ 机器人",
         quickstartAllowFrom: true,
     },
@@ -104,11 +104,14 @@ export const qqPlugin = {
         }),
         probeAccount: async () => {
             const status = await getStatus();
+            const ok = status.status === "ok";
             setContextStatus({
+                linked: ok,
+                running: ok,
                 lastProbeAt: Date.now(),
             });
             return {
-                ok: status.status === "ok",
+                ok: ok,
                 status: status.retcode,
                 error: status.status === "failed" ? status.msg : null,
             };
@@ -176,6 +179,14 @@ export const qqPlugin = {
             try {
                 await connection.start();
                 setConnection(connection);
+                // 获取登录信息
+                const info = await getLoginInfo();
+                if (info.data) {
+                    setLoginInfo({
+                        userId: info.data.user_id.toString(),
+                        nickname: info.data.nickname,
+                    });
+                }
                 // Update start time
                 setContextStatus({
                     running: true,
@@ -210,6 +221,24 @@ export const qqPlugin = {
             });
             clearContext();
         },
+    },
+    directory: {
+        self: async () => {
+            const info = await getLoginInfo();
+            if (!info.data) {
+                return null;
+            }
+            log.debug('directory', `self: ${JSON.stringify(info.data)}`);
+            return {
+                kind: "user",
+                id: info.data.user_id.toString(),
+                name: info.data.nickname,
+            };
+        },
+        listPeers: getFriends,
+        listPeersLive: getFriends,
+        listGroups: getGroups,
+        listGroupsLive: getGroups,
     }
 };
 async function outboundSend(ctx) {
@@ -221,8 +250,18 @@ async function outboundSend(ctx) {
     const chatType = type === "group" ? "group" : "private";
     const chatId = id || to;
     const content = [];
+    const context = getContext();
+    if (!context) {
+        log.warn('dispatch', `No gateway context`);
+        return {
+            channel: CHANNEL_ID,
+            messageId: "",
+            error: new Error(`No gateway context`),
+            deliveredAt: Date.now(),
+        };
+    }
     if (text) {
-        content.push({ type: "text", text: markdownToText(text) });
+        content.push({ type: "text", text: context.account.markdownFormat ? markdownToText(text) : text });
     }
     if (mediaUrl) {
         content.push(buildMediaMessage(mediaUrl));
@@ -265,3 +304,21 @@ async function outboundSend(ctx) {
         };
     }
 }
+async function getFriends() {
+    const friendList = await getFriendList();
+    log.debug('directory', `friendList: ${JSON.stringify(friendList.data)}`);
+    return (friendList.data || []).map((friend) => ({
+        kind: "user",
+        id: friend.user_id.toString(),
+        name: friend.nickname,
+    }));
+}
+async function getGroups() {
+    const groupList = await getGroupList();
+    log.debug('directory', `groupList: ${JSON.stringify(groupList.data)}`);
+    return (groupList.data || []).map((group) => ({
+        kind: "group",
+        id: group.group_id.toString(),
+        name: group.group_name,
+    }));
+}

package/dist/src/core/config.d.ts

@@ -15,8 +15,66 @@ export declare function listQQAccountIds(cfg: OpenClawConfig): string[];
 export declare function resolveQQAccount(params: {
     cfg: OpenClawConfig;
 }): QQConfig;
+export declare const QQDirectConfigSchema: z.ZodObject<{
+    policy: z.ZodDefault<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        allowlist: "allowlist";
+    }>>;
+    allowFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    denyFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+export declare const QQGroupConfigSchema: z.ZodObject<{
+    requireMention: z.ZodDefault<z.ZodBoolean>;
+    requirePoke: z.ZodDefault<z.ZodBoolean>;
+    historyLimit: z.ZodDefault<z.ZodNumber>;
+    policy: z.ZodDefault<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        allowlist: "allowlist";
+    }>>;
+    allowFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    denyFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    wakeWord: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const QQConfigSchema: z.ZodObject<{
     wsUrl: z.ZodDefault<z.ZodString>;
     accessToken: z.ZodDefault<z.ZodString>;
     enable: z.ZodDefault<z.ZodBoolean>;
+    markdownFormat: z.ZodDefault<z.ZodBoolean>;
+    messageDirect: z.ZodObject<{
+        policy: z.ZodDefault<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            allowlist: "allowlist";
+        }>>;
+        allowFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        denyFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>;
+    messageGroup: z.ZodObject<{
+        requireMention: z.ZodDefault<z.ZodBoolean>;
+        requirePoke: z.ZodDefault<z.ZodBoolean>;
+        historyLimit: z.ZodDefault<z.ZodNumber>;
+        policy: z.ZodDefault<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            allowlist: "allowlist";
+        }>>;
+        allowFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        denyFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        wakeWord: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    messageGroupsCustom: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        requireMention: z.ZodDefault<z.ZodBoolean>;
+        requirePoke: z.ZodDefault<z.ZodBoolean>;
+        historyLimit: z.ZodDefault<z.ZodNumber>;
+        policy: z.ZodDefault<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            allowlist: "allowlist";
+        }>>;
+        allowFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        denyFrom: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        wakeWord: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;

package/dist/src/core/config.js

@@ -23,6 +23,22 @@ export function resolveQQAccount(params) {
         enabled: config?.enabled !== false,
         wsUrl: config?.wsUrl ?? "",
         accessToken: config?.accessToken,
+        markdownFormat: config?.markdownFormat ?? true,
+        messageDirect: {
+            policy: config?.messageDirect?.policy ?? "allow",
+            allowFrom: config?.messageDirect?.allowFrom ?? [],
+            denyFrom: config?.messageDirect?.denyFrom ?? [],
+        },
+        messageGroup: {
+            requireMention: config?.messageGroup?.requireMention ?? true,
+            requirePoke: config?.messageGroup?.requirePoke ?? true,
+            policy: config?.messageGroup?.policy ?? "allow",
+            historyLimit: config?.messageGroup?.historyLimit ?? 20,
+            allowFrom: config?.messageGroup?.allowFrom ?? [],
+            denyFrom: config?.messageGroup?.denyFrom ?? [],
+            wakeWord: config?.messageGroup?.wakeWord ?? undefined,
+        },
+        messageGroupsCustom: config?.messageGroupsCustom ?? {},
     };
 }
 /**
@@ -31,9 +47,28 @@ export function resolveQQAccount(params) {
 const wsUrlRegex = /^wss?:\/\/[\w.-]+(:\d+)?(\/[\w./-]*)?$/;
 const wsUrlSchema = z.string()
     .regex(wsUrlRegex, { message: "Invalid WebSocket URL format. Expected: ws://host:port or wss://host:port" })
-    .default("ws://127.0.0.1:3001");
+    .default("ws://127.0.0.1:3001")
+    .describe("NapCat Websocket 连接地址");
+export const QQDirectConfigSchema = z.object({
+    policy: z.enum(["allow", "deny", "allowlist"]).default("allow").describe("私聊策略"),
+    allowFrom: z.array(z.string()).default([]).describe("允许的用户").optional(),
+    denyFrom: z.array(z.string()).default([]).describe("拒绝的用户").optional(),
+}).describe("私聊全局配置");
+export const QQGroupConfigSchema = z.object({
+    requireMention: z.boolean().default(true).describe("群组是否需要@响应"),
+    requirePoke: z.boolean().default(true).describe("群组支持戳一戳响应"),
+    historyLimit: z.number().default(20).describe("群组历史记录信息条数"),
+    policy: z.enum(["allow", "deny", "allowlist"]).default("allow").describe("群组策略"),
+    allowFrom: z.array(z.string()).default([]).describe("群组允许的用户").optional(),
+    denyFrom: z.array(z.string()).default([]).describe("群组拒绝的用户").optional(),
+    wakeWord: z.string().describe("群组唤醒词").optional(),
+}).describe("群组全局配置");
 export const QQConfigSchema = z.object({
     wsUrl: wsUrlSchema,
-    accessToken: z.string().default("access-token"),
-    enable: z.boolean().default(true)
+    accessToken: z.string().default("access-token").describe("NapCat Websocket Token"),
+    enable: z.boolean().default(true).describe("是否启用"),
+    markdownFormat: z.boolean().default(true).describe("是否启动 Markdown 格式化转换"),
+    messageDirect: QQDirectConfigSchema,
+    messageGroup: QQGroupConfigSchema,
+    messageGroupsCustom: z.record(z.string(), QQGroupConfigSchema).default({}).describe("特定群组配置").optional(),
 });

package/dist/src/core/dispatch.js

@@ -2,7 +2,8 @@
  * Message Dispatch Module
  * Handles routing and dispatching incoming messages to the AI
  */
-import { getRuntime, getContext } from './runtime.js';
+import { buildPendingHistoryContextFromMap, clearHistoryEntries, recordPendingHistoryEntry, resolveInboundRouteEnvelopeBuilderWithRuntime } from "openclaw/plugin-sdk";
+import { getRuntime, getContext, getSession, clearSession, updateSession, getLoginInfo, historyCache } from './runtime.js';
 import { getFile, sendMsg, setInputStatus } from './request.js';
 import { napCatToOpenClawMessage, openClawToNapCatMessage } from '../adapters/message.js';
 import { Logger as log, markdownToText, buildMediaMessage } from '../utils/index.js';
@@ -13,26 +14,38 @@ import { CHANNEL_ID } from "./config.js";
  * For replies, includes quoted message content if available
  */
 async function contentToPlainText(content) {
-    return content
-        .filter(c => c.type !== 'image' && c.type !== 'audio' && c.type !== 'file')
-        .map((c) => {
+    const results = await Promise.all(content.map(async (c) => {
         switch (c.type) {
             case 'text':
-                return `${c.text}`;
+                return c.text;
             case 'at':
-                return c.isAll ? '@全体成员' : `@${c.userId}`;
+                const target = c.isAll ? '@全体成员' : `@${c.userId}`;
+                return `[提及]${target}`;
+            case 'image':
+                return `[图片]${c.url}`;
+            case 'audio':
+                return `[音频]${c.path}`;
+            case 'video':
+                return `[视频]${c.url}`;
+            case 'file': {
+                const fileInfo = await getFile({ file_id: c.fileId });
+                if (!fileInfo.data?.file)
+                    return null;
+                return `[文件]${fileInfo.data.file}`;
+            }
             case 'json':
-                return `[JSON]\n\`\`\`json\n${c.data}\n\`\`\``;
-            case 'reply':
-                const senderInfo = c.sender && c.senderId ? `${c.sender}(${c.senderId})` : '未知用户';
-                const replyMsg = c.message ?? '[无法获取原消息]';
-                let replyContent = `${senderInfo}:\n${replyMsg}`;
-                replyContent = replyContent.split('\n').map(line => `> ${line}`).join('\n');
-                return `[回复]\n${replyContent}\n`;
+                return `[JSON]\n\n\`\`\`json\n${c.data}\n\`\`\``;
+            case 'reply': {
+                const senderInfo = c.sender && c.senderId ? `${c.sender}(${c.senderId})` : '(未知用户)';
+                const replyMsg = c.message ?? '(无法获取原消息)';
+                const quotedContent = `${senderInfo}:\n${replyMsg}`.replace(/^/gm, '> ');
+                return `[回复]\n\n${quotedContent}`;
+            }
             default:
-                return '';
+                return null;
         }
-    }).join('\n');
+    }));
+    return results.filter((v) => v !== null).join('\n');
 }
 async function contextToMedia(content) {
     const hasMedia = content.some(c => c.type === 'image' || c.type === 'audio' || c.type === 'file');
@@ -70,8 +83,16 @@ async function contextToMedia(content) {
     return;
 }
 async function sendText(isGroup, chatId, text) {
-    const cleanText = text.replace(/NO_REPLY\s*$/, '');
-    const messageSegments = [{ type: 'text', data: { text: markdownToText(cleanText) } }];
+    const contextText = text.replace(/NO_REPLY\s*$/, '');
+    const context = getContext();
+    if (!context) {
+        log.warn('dispatch', `No gateway context`);
+        return;
+    }
+    const messageSegments = [{
+            type: 'text',
+            data: { text: context.account.markdownFormat ? markdownToText(contextText) : contextText }
+        }];
     try {
         await sendMsg({
             message_type: isGroup ? 'group' : 'private',
@@ -104,7 +125,7 @@ async function sendMedia(isGroup, chatId, mediaUrl) {
  * Dispatch an incoming message to the AI for processing
  */
 export async function dispatchMessage(params) {
-    const { chatType, chatId, senderId, senderName, messageId, content, media, timestamp } = params;
+    let { chatType, chatId, senderId, senderName, messageId, content, media, timestamp, targetId } = params;
     const runtime = getRuntime();
     if (!runtime) {
         log.warn('dispatch', `Plugin runtime not available`);
@@ -116,31 +137,64 @@ export async function dispatchMessage(params) {
         return;
     }
     const isGroup = chatType === 'group';
-    const peerId = isGroup ? `group:${chatId}` : senderId;
-    const route = runtime.channel.routing.resolveAgentRoute({
+    const config = context.account;
+    // At 模式处理
+    if (isGroup) {
+        const isMention = mention(content, chatId, targetId);
+        if (!isMention) {
+            log.debug('dispatch', `Skipping group message (not mentioned)`);
+            const groupConfig = getGroupConfig(chatId, config);
+            recordPendingHistoryEntry({
+                historyMap: historyCache,
+                historyKey: chatId,
+                limit: groupConfig.historyLimit ?? 20,
+                entry: {
+                    sender: `${senderName}(${senderId})`,
+                    body: content,
+                    timestamp: timestamp,
+                    messageId: messageId,
+                },
+            });
+            return;
+        }
+    }
+    const { route, buildEnvelope } = resolveInboundRouteEnvelopeBuilderWithRuntime({
         cfg: context.cfg,
         channel: CHANNEL_ID,
+        accountId: context.accountId,
         peer: {
-            kind: 'group',
-            id: peerId,
+            kind: isGroup ? "group" : "direct",
+            id: chatId,
         },
+        runtime: runtime.channel,
+        sessionStore: context.cfg.session?.store
     });
-    log.debug('dispatch', `Resolved route: ${JSON.stringify(route)}`);
-    const envelopeOptions = runtime.channel.reply.resolveEnvelopeFormatOptions(context.cfg);
-    const body = runtime.channel.reply.formatInboundEnvelope({
+    // 终止信号
+    const session = getSession(route.sessionKey);
+    if (session.abortController) {
+        session.abortController.abort();
+        session.aborted = true;
+        log.info('dispatch', `Aborted previous session`);
+    }
+    if (isGroup) {
+        const groupConfig = getGroupConfig(chatId, config);
+        content = buildPendingHistoryContextFromMap({
+            historyMap: historyCache,
+            historyKey: chatId,
+            limit: groupConfig.historyLimit ?? 20,
+            currentMessage: content,
+            formatEntry: (e) => `${e.sender}: ${e.body}`,
+        });
+    }
+    const fromLabel = isGroup ? `group:${chatId}` : senderName || `user:${senderId}`;
+    const { storePath, body } = buildEnvelope({
         channel: CHANNEL_ID,
-        from: senderName || senderId,
+        from: fromLabel,
         body: content,
         timestamp,
-        chatType: isGroup ? 'group' : 'direct',
-        sender: {
-            id: senderId,
-            name: senderName,
-        },
-        envelope: envelopeOptions,
     });
     log.debug('dispatch', `Inbound envelope: ${body}`);
-    const fromAddress = isGroup ? `qq:group:${chatId}` : `qq:${senderId}`;
+    const fromAddress = `qq:${fromLabel}`;
     const toAddress = `qq:${chatId}`;
     const ctxPayload = runtime.channel.reply.finalizeInboundContext({
         Body: body,
@@ -151,6 +205,7 @@ export async function dispatchMessage(params) {
         SessionKey: route.sessionKey,
         AccountId: route.accountId,
         ChatType: isGroup ? 'group' : 'direct',
+        ConversationLabel: fromLabel,
         SenderId: senderId,
         SenderName: senderName,
         Provider: CHANNEL_ID,
@@ -164,8 +219,18 @@ export async function dispatchMessage(params) {
         OriginatingTo: toAddress,
     });
     log.info('dispatch', `Dispatching to agent ${route.agentId}, session: ${route.sessionKey}`);
+    await runtime.channel.session.recordInboundSession({
+        storePath,
+        sessionKey: route.sessionKey,
+        ctx: ctxPayload,
+        onRecordError(err) {
+            log.error('dispatch', `Failed to record inbound session: ${err}`);
+        },
+    });
     const messagesConfig = runtime.channel.reply.resolveEffectiveMessagesConfig(context.cfg, route.agentId);
     try {
+        session.abortController = new AbortController();
+        updateSession(route.sessionKey, session);
         await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
             ctx: ctxPayload,
             cfg: context.cfg,
@@ -184,6 +249,14 @@ export async function dispatchMessage(params) {
                     }
                 },
                 deliver: async (payload, info) => {
+                    if (session.aborted) {
+                        session.aborted = false;
+                        log.info('dispatch', `aborted skipping`);
+                        return;
+                    }
+                    if (isGroup) {
+                        clearHistoryEntries({ historyMap: historyCache, historyKey: chatId });
+                    }
                     log.info('dispatch', `deliver(${info.kind}): ${JSON.stringify(payload)}`);
                     if (payload.text && !payload.text.startsWith('MEDIA:')) {
                         await sendText(isGroup, chatId, payload.text);
@@ -205,7 +278,9 @@ export async function dispatchMessage(params) {
                     await sendText(isGroup, chatId, `[错误]\n${String(err)}`);
                 },
             },
-            replyOptions: {},
+            replyOptions: {
+                abortSignal: session.abortController?.signal,
+            },
         });
         log.info('dispatch', `Dispatch completed`);
     }
@@ -220,12 +295,17 @@ export async function dispatchMessage(params) {
                 event_type: 2
             });
         }
+        clearSession(route.sessionKey);
     }
 }
 /**
  * Handle group message event
  */
 export async function handleGroupMessage(event) {
+    if (!allow(event.user_id.toString(), event.group_id.toString())) {
+        log.debug('dispatch', `Ignoring group message from ${event.user_id}`);
+        return;
+    }
     const content = await napCatToOpenClawMessage(event.message);
     const plainText = await contentToPlainText(content);
     const media = await contextToMedia(content);
@@ -245,6 +325,10 @@ export async function handleGroupMessage(event) {
  * Handle private message event
  */
 export async function handlePrivateMessage(event) {
+    if (!allow(event.user_id.toString())) {
+        log.debug('dispatch', `Ignoring message from ${event.user_id}`);
+        return;
+    }
     const content = await napCatToOpenClawMessage(event.message);
     const plainText = await contentToPlainText(content);
     const media = await contextToMedia(content);
@@ -270,6 +354,10 @@ function extractPokeActionText(rawInfo) {
     return actionItem?.txt || '戳了戳';
 }
 export async function handlePokeEvent(event) {
+    if (!allow(event.user_id.toString(), event.group_id?.toString())) {
+        log.debug('dispatch', `Poke from ${event.user_id} is not allowed`);
+        return;
+    }
     const actionText = extractPokeActionText(event.raw_info);
     log.info('dispatch', `Poke from ${event.user_id}: ${actionText}`);
     const pokeMessage = actionText || '戳了戳';
@@ -281,7 +369,77 @@ export async function handlePokeEvent(event) {
         senderId: String(event.user_id),
         senderName: String(event.user_id),
         messageId: `poke_${event.user_id}_${Date.now()}`,
-        content: `[动作]\n${pokeMessage}`,
+        content: `[动作]${pokeMessage}`,
         timestamp: Date.now(),
+        targetId: String(event.target_id),
     });
 }
+function getGroupConfig(groupId, config) {
+    log.debug('dispatch', `All Custom config: ${JSON.stringify(config.messageGroupsCustom)}`);
+    let groupConfig = config.messageGroupsCustom[groupId];
+    if (!groupConfig) {
+        groupConfig = config.messageGroup;
+        log.debug('dispatch', `Use global config: ${JSON.stringify(groupConfig)}`);
+    }
+    else {
+        groupConfig = {
+            ...config.messageGroup,
+            ...groupConfig,
+        };
+    }
+    log.debug('dispatch', `Final config: ${JSON.stringify(groupConfig)}`);
+    return groupConfig;
+}
+function allow(userId, groupId) {
+    const context = getContext();
+    if (!context) {
+        log.warn('dispatch', `No gateway context`);
+        return false;
+    }
+    let config = groupId ? getGroupConfig(groupId, context.account) : context.account.messageDirect;
+    return allowJudgment(config, userId);
+}
+function allowJudgment(config, userId) {
+    if (config.denyFrom?.includes(userId)) {
+        log.debug('dispatch', `User ${userId} is denied`);
+        return false;
+    }
+    if (config.policy === 'allow') {
+        log.debug('dispatch', `User ${userId} is allowed`);
+        return true;
+    }
+    if (config.policy === 'deny') {
+        log.debug('dispatch', `User ${userId} is denied`);
+        return false;
+    }
+    if (config.allowFrom?.includes(userId)) {
+        log.debug('dispatch', `User ${userId} is allowed`);
+        return true;
+    }
+    return false;
+}
+function mention(content, groupId, targetId) {
+    const context = getContext();
+    if (!context) {
+        log.warn('dispatch', `No gateway context`);
+        return false;
+    }
+    let config = getGroupConfig(groupId, context.account);
+    const loginInfo = getLoginInfo();
+    const isMentionEnabled = !!config?.requireMention;
+    const isPokeEnabled = !!config?.requirePoke;
+    const isWakeEnabled = !!config?.wakeWord?.trim();
+    if (!isMentionEnabled && !isPokeEnabled && !isWakeEnabled) {
+        log.debug('dispatch', 'All requires are disabled, returning true by default.');
+        return true;
+    }
+    const requireMention = isMentionEnabled &&
+        (content.includes('[提及]@全体成员') ||
+            (!!loginInfo?.userId && content.includes(`[提及]@${loginInfo.userId}`)));
+    const requirePoke = isPokeEnabled &&
+        (content.includes('[动作]') && targetId === loginInfo?.userId);
+    const requireWake = isWakeEnabled &&
+        content.includes(config.wakeWord ?? "");
+    log.debug('dispatch', `Require mention: ${requireMention}, require poke: ${requirePoke}, require wake: ${requireWake}`);
+    return requireMention || requirePoke || requireWake;
+}

package/dist/src/core/request.d.ts

@@ -1,4 +1,4 @@
-import type { GetFileReq, GetFileResp, GetMsgReq, GetMsgResp, GetStatusResp, NapCatResp, SendMsgReq, SendMsgResp, SetInputStatusReq } from "../types";
+import type { GetFileReq, GetFileResp, GetMsgReq, GetMsgResp, GetStatusResp, GetLoginInfoResp, NapCatResp, SendMsgReq, SendMsgResp, SetInputStatusReq, GetFriendListResp, GetGroupListResp } from "../types";
 /**
  * 事件监听
  * @param event
@@ -28,3 +28,15 @@ export declare function setInputStatus(params: SetInputStatusReq): Promise<NapCa
  * 获取状态
  */
 export declare function getStatus(): Promise<NapCatResp<GetStatusResp>>;
+/**
+ * 获取登录信息
+ */
+export declare function getLoginInfo(): Promise<NapCatResp<GetLoginInfoResp>>;
+/**
+ * 获取好友列表
+ */
+export declare function getFriendList(): Promise<NapCatResp<GetFriendListResp[]>>;
+/**
+ * 获取群列表
+ */
+export declare function getGroupList(): Promise<NapCatResp<GetGroupListResp[]>>;

package/dist/src/core/request.js

@@ -136,3 +136,36 @@ export async function getStatus() {
     }
     return connection.sendRequest("get_status");
 }
+/**
+ * 获取登录信息
+ */
+export async function getLoginInfo() {
+    const connection = getConnection();
+    if (!connection) {
+        log.warn("request", `No connection available`);
+        return failResp();
+    }
+    return connection.sendRequest("get_login_info");
+}
+/**
+ * 获取好友列表
+ */
+export async function getFriendList() {
+    const connection = getConnection();
+    if (!connection) {
+        log.warn("request", `No connection available`);
+        return failResp();
+    }
+    return connection.sendRequest("get_friend_list");
+}
+/**
+ * 获取群列表
+ */
+export async function getGroupList() {
+    const connection = getConnection();
+    if (!connection) {
+        log.warn("request", `No connection available`);
+        return failResp();
+    }
+    return connection.sendRequest("get_group_list");
+}

package/dist/src/core/runtime.d.ts

@@ -2,8 +2,8 @@
  * Plugin Runtime Storage
  * Stores the PluginRuntime for access in gateway handlers
  */
-import type { ChannelAccountSnapshot, ChannelGatewayContext, PluginRuntime } from "openclaw/plugin-sdk";
-import type { QQConfig } from "../types";
+import type { ChannelAccountSnapshot, ChannelGatewayContext, HistoryEntry, PluginRuntime } from "openclaw/plugin-sdk";
+import { QQConfig, QQLoginInfo, QQSession } from "../types";
 import { ConnectionManager } from "./connection.js";
 export declare function setRuntime(next: PluginRuntime): void;
 export declare function getRuntime(): PluginRuntime | null;
@@ -14,3 +14,9 @@ export declare function setContextStatus(next: Omit<ChannelAccountSnapshot, 'acc
 export declare function setConnection(next: ConnectionManager): void;
 export declare function getConnection(): ConnectionManager | null;
 export declare function clearConnection(): void;
+export declare function getSession(sessionKey: string): QQSession;
+export declare function updateSession(sessionKey: string, session: QQSession): void;
+export declare function clearSession(sessionKey: string): void;
+export declare function setLoginInfo(next: QQLoginInfo): void;
+export declare function getLoginInfo(): QQLoginInfo;
+export declare const historyCache: Map<string, HistoryEntry[]>;

package/dist/src/core/runtime.js

@@ -46,3 +46,39 @@ export function getConnection() {
 export function clearConnection() {
     connection = null;
 }
+// =============================================================================
+// Session
+// =============================================================================
+const sessionMap = new Map();
+export function getSession(sessionKey) {
+    let session = sessionMap.get(sessionKey);
+    if (session) {
+        return session;
+    }
+    session = {};
+    sessionMap.set(sessionKey, session);
+    return session;
+}
+export function updateSession(sessionKey, session) {
+    sessionMap.set(sessionKey, session);
+}
+export function clearSession(sessionKey) {
+    sessionMap.delete(sessionKey);
+}
+// =============================================================================
+// LoginInfo
+// =============================================================================
+const loginInfo = {
+    userId: '',
+    nickname: '',
+};
+export function setLoginInfo(next) {
+    Object.assign(loginInfo, next);
+}
+export function getLoginInfo() {
+    return loginInfo;
+}
+// =============================================================================
+// History
+// =============================================================================
+export const historyCache = new Map();

package/dist/src/types/index.d.ts

@@ -14,7 +14,7 @@ export interface NapCatResp<T = unknown> {
     data?: T;
     echo?: string;
 }
-export type NapCatAction = 'send_msg' | 'get_msg' | 'get_status' | 'get_file' | 'set_input_status';
+export type NapCatAction = 'send_msg' | 'get_msg' | 'get_status' | 'get_file' | 'get_login_info' | 'get_friend_list' | 'get_group_list' | 'set_input_status';
 export interface NapCatEvent {
     time: number;
     self_id: number;
@@ -26,7 +26,7 @@ export interface NapCatMetaEvent extends NapCatEvent {
     meta_event_type: 'lifecycle' | 'heartbeat';
     sub_type?: 'connect' | 'disconnect' | 'enable' | 'disable';
 }
-export type NapCatMessage = NapCatTextSegment | NapCatAtSegment | NapCatImageSegment | NapCatReplySegment | NapCatFaceSegment | NapCatRecordSegment | NapCatFileSegment | NapCatJsonSegment | NapCatUnknownSegment;
+export type NapCatMessage = NapCatTextSegment | NapCatAtSegment | NapCatImageSegment | NapCatReplySegment | NapCatFaceSegment | NapCatRecordSegment | NapCatFileSegment | NapCatJsonSegment | NapCatUnknownSegment | NapCatVideoSegment;
 export interface NapCatTextSegment {
     type: 'text';
     data: {
@@ -85,15 +85,17 @@ export interface NapCatJsonSegment {
         data: string;
     };
 }
+export interface NapCatVideoSegment {
+    type: 'video';
+    data: {
+        url: string;
+        file_size?: string;
+    };
+}
 export interface NapCatUnknownSegment {
     type: string;
     data: Record<string, unknown>;
 }
-export interface QQConfig {
-    wsUrl: string;
-    accessToken?: string;
-    enabled: boolean;
-}
 export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'failed';
 export interface ConnectionStatus {
     state: ConnectionState;
@@ -102,6 +104,7 @@ export interface ConnectionStatus {
     error?: string;
     reconnectAttempts?: number;
 }
+export type OpenClawMessage = OpenClawTextContent | OpenClawAtContent | OpenClawImageContent | OpenClawReplyContent | OpenClawAudioContent | OpenClawJsonContent | OpenClawFileContent | OpenClawVideoContent;
 export interface OpenClawTextContent {
     type: 'text';
     text: string;
@@ -114,7 +117,6 @@ export interface OpenClawAtContent {
 export interface OpenClawImageContent {
     type: 'image';
     url: string;
-    /** Optional summary/description (e.g., "[动画表情]" for animated stickers) */
     summary?: string;
 }
 export interface OpenClawReplyContent {
@@ -126,20 +128,14 @@ export interface OpenClawReplyContent {
 }
 export interface OpenClawAudioContent {
     type: 'audio';
-    /** Local file path to the audio file */
     path: string;
-    /** Optional URL for downloading the audio */
     url?: string;
-    /** File name */
     file: string;
-    /** File size in bytes */
     fileSize?: number;
 }
 export interface OpenClawJsonContent {
     type: 'json';
-    /** Raw JSON data string */
     data: string;
-    /** Optional display text/prompt from the JSON */
     prompt?: string;
 }
 export interface OpenClawFileContent {
@@ -149,7 +145,11 @@ export interface OpenClawFileContent {
     url?: string;
     fileSize?: number;
 }
-export type OpenClawMessage = OpenClawTextContent | OpenClawAtContent | OpenClawImageContent | OpenClawReplyContent | OpenClawAudioContent | OpenClawJsonContent | OpenClawFileContent;
+export interface OpenClawVideoContent {
+    type: 'video';
+    url?: string;
+    fileSize?: number;
+}
 export interface PendingRequest {
     resolve: (response: NapCatResp) => void;
     reject: (error: Error) => void;
@@ -248,6 +248,18 @@ export interface GetStatusResp {
     good: boolean;
     stat: Record<any, any>;
 }
+export interface GetLoginInfoResp {
+    user_id: number;
+    nickname: string;
+}
+export interface GetFriendListResp {
+    user_id: number;
+    nickname: string;
+}
+export interface GetGroupListResp {
+    group_id: number;
+    group_name: string;
+}
 export interface DispatchMessageMedia {
     type?: string;
     path?: string;
@@ -262,9 +274,38 @@ export interface DispatchMessageParams {
     content: string;
     media?: DispatchMessageMedia;
     timestamp: number;
+    targetId?: string;
+}
+export interface QQConfig {
+    wsUrl: string;
+    accessToken?: string;
+    enabled: boolean;
+    markdownFormat: boolean;
+    messageDirect: QQAllowConfig;
+    messageGroup: QQGroupConfig;
+    messageGroupsCustom: Record<string, QQGroupConfig>;
+}
+export interface QQGroupConfig extends QQAllowConfig {
+    requireMention: boolean;
+    requirePoke: boolean;
+    historyLimit: number;
+    wakeWord?: string;
+}
+export interface QQAllowConfig {
+    policy: "allow" | "deny" | "allowlist";
+    allowFrom: string[];
+    denyFrom: string[];
 }
 export type QQProbe = {
     ok: boolean;
     status?: number | null;
     error?: string | null;
 };
+export type QQSession = {
+    abortController?: AbortController;
+    aborted?: boolean;
+};
+export type QQLoginInfo = {
+    userId: string;
+    nickname: string;
+};

package/dist/src/utils/markdown.js

@@ -48,9 +48,8 @@ export class MarkdownToText {
         // 逻辑：匹配 < 后紧跟字母的模式，保留 "a < b" 或 "1 < 5" 这种数学公式
         text = text.replace(/<\/?([a-z][a-z0-9]*)\b[^>]*>/gi, '');
         // 3.3 标题 (Headers) -> 视觉醒目文本
-        text = text.replace(/^#\s+(.*)$/gm, '\n$1\n══════════\n');
-        text = text.replace(/^##\s+(.*)$/gm, '\n$1\n──────────\n');
-        text = text.replace(/^(#{3,6})\s+(.*)$/gm, '\n【 $2 】\n');
+        text = text.replace(/^#\s+(.*)$/gm, '\n$1\n\n\n');
+        text = text.replace(/^(#{2,6})\s+(.*)$/gm, '\n$2\n\n');
         // 3.4 Markdown 分割线 (---, ***)
         text = text.replace(/^(-\s*?|\*\s*?|_\s*?){3,}\s*$/gm, '──────────');
         // 3.5 引用 (Blockquotes)
@@ -94,7 +93,7 @@ export class MarkdownToText {
         return text.replace(codeBlockRegex, (_match, _fence, lang, code) => {
             const key = `${this.maskPrefix}BLOCK-${this.maskCounter++}`;
             const langTag = lang ? ` [${lang}]` : '';
-            const formatted = `\n───code───${langTag}\n${code.replace(/^\n+|\n+$/g, '')}\n──────────\n`;
+            const formatted = `\n──────────${langTag}\n${code.replace(/^\n+|\n+$/g, '')}\n──────────\n`;
             this.codeBlockStore.set(key, formatted);
             return key;
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izhimu/qq",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "A QQ channel plugin for OpenClaw using NapCat WebSocket",
   "type": "module",
   "main": "dist/index.js",
@@ -41,7 +41,7 @@
     }
   },
   "peerDependencies": {
-    "openclaw": "^2026.2.1"
+    "openclaw": "^2026.3.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.0",
-    "openclaw": "^2026.2.1",
+    "openclaw": "^2026.3.1",
     "typescript": "^5.0.0"
   }
 }