@izhimu/qq 0.3.2 → 0.4.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
 ```
 
 ### 本地开发安装
@@ -371,6 +374,17 @@ npm run build
 
 ## 更新日志
 
+### [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 } 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) {
@@ -265,3 +294,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

@@ -19,4 +19,6 @@ export declare const QQConfigSchema: z.ZodObject<{
     wsUrl: z.ZodDefault<z.ZodString>;
     accessToken: z.ZodDefault<z.ZodString>;
     enable: z.ZodDefault<z.ZodBoolean>;
+    groupAtMode: z.ZodDefault<z.ZodBoolean>;
+    groupHistoryLimit: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;

package/dist/src/core/config.js

@@ -23,6 +23,8 @@ export function resolveQQAccount(params) {
         enabled: config?.enabled !== false,
         wsUrl: config?.wsUrl ?? "",
         accessToken: config?.accessToken,
+        groupAtMode: config?.groupAtMode ?? true,
+        groupHistoryLimit: config?.groupHistoryLimit ?? 20,
     };
 }
 /**
@@ -31,9 +33,12 @@ 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 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("是否启用"),
+    groupAtMode: z.boolean().default(true).describe("群组响应模式：默认启用，只有在被@时才会响应"),
+    groupHistoryLimit: z.number().default(20).describe("群组历史记录信息条数限制"),
 });

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 `[AT]${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');
@@ -104,7 +117,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 +129,65 @@ 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 && config.groupAtMode) {
+        const loginInfo = getLoginInfo();
+        const hasAtAll = content.includes('[AT]@全体成员');
+        const hasAtMe = loginInfo.userId && content.includes(`[AT]@${loginInfo.userId}`);
+        const hasPoke = content.includes('[动作]') && targetId === loginInfo.userId;
+        if (!hasAtAll && !hasAtMe && !hasPoke) {
+            log.debug('dispatch', `Skipping group message (not mentioned)`);
+            recordPendingHistoryEntry({
+                historyMap: historyCache,
+                historyKey: chatId,
+                limit: config.groupHistoryLimit,
+                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) {
+        content = buildPendingHistoryContextFromMap({
+            historyMap: historyCache,
+            historyKey: chatId,
+            limit: config.groupHistoryLimit,
+            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 +198,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 +212,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 +242,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 +271,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,6 +288,7 @@ export async function dispatchMessage(params) {
                 event_type: 2
             });
         }
+        clearSession(route.sessionKey);
     }
 }
 /**
@@ -281,7 +350,8 @@ 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),
     });
 }

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,25 @@ export interface DispatchMessageParams {
     content: string;
     media?: DispatchMessageMedia;
     timestamp: number;
+    targetId?: string;
+}
+export interface QQConfig {
+    wsUrl: string;
+    accessToken?: string;
+    enabled: boolean;
+    groupAtMode: boolean;
+    groupHistoryLimit: number;
 }
 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.4.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"
   }
 }