@izhimu/qq 0.5.0 → 0.5.1

package/README.md

@@ -27,7 +27,7 @@
 </p>
 
 ---
-![demo.png](docs/demo.png)
+![demo.jpg](docs/demo.jpg)
 ## 目录
 
 - [功能特性](#功能特性)
@@ -69,7 +69,7 @@
 openclaw plugins install @izhimu/qq
 
 # 更新插件
-openclaw plugins update @izhimu/qq
+openclaw plugins update qq
 ```
 
 ### 本地开发安装
@@ -175,6 +175,8 @@ openclaw gateway restart
 }
 ```
 
+![config.png](docs/config.png)
+
 ---
 
 ## 使用方法
@@ -391,6 +393,11 @@ npm run build
 
 ## 更新日志
 
+### [0.5.1] - 2026-03-12
+
+#### 修复
+- **连接状态显示**：修复了插件面板中连接状态及错误信息显示不准确的问题。
+
 ### [0.5.0] - 2026-03-11
 
 #### 新增

package/dist/src/channel.js

@@ -2,7 +2,7 @@
  * QQ NapCat Plugin for OpenClaw
  * Main plugin entry point
  */
-import { DEFAULT_ACCOUNT_ID, buildChannelConfigSchema, setAccountEnabledInConfigSection, deleteAccountFromConfigSection } from "openclaw/plugin-sdk";
+import { DEFAULT_ACCOUNT_ID, buildChannelConfigSchema, setAccountEnabledInConfigSection, deleteAccountFromConfigSection, applyAccountNameToChannelSection, migrateBaseNameToDefaultAccount, normalizeAccountId, waitUntilAbort } from "openclaw/plugin-sdk";
 import { messageIdToString, markdownToText, buildMediaMessage, Logger as log } from "./utils/index.js";
 import { setContext, setContextStatus, clearContext, setConnection, getConnection, clearConnection, setLoginInfo, getContext } from "./core/runtime.js";
 import { ConnectionManager } from "./core/connection.js";
@@ -32,8 +32,7 @@ export const qqPlugin = {
     config: {
         listAccountIds: (cfg) => listQQAccountIds(cfg),
         resolveAccount: (cfg) => resolveQQAccount({ cfg }),
-        isEnabled: (account) => Boolean(account?.enabled),
-        isConfigured: (account) => Boolean(account?.wsUrl),
+        isConfigured: (account) => !!account.accessToken?.trim(),
         setAccountEnabled: ({ cfg, accountId, enabled }) => setAccountEnabledInConfigSection({
             cfg,
             sectionKey: "qq",
@@ -46,8 +45,62 @@ export const qqPlugin = {
             sectionKey: "qq",
             accountId,
         }),
+        describeAccount: (account) => ({
+            accountId: DEFAULT_ACCOUNT_ID,
+            tokenSource: account.accessToken ? "config" : "none"
+        }),
     },
     configSchema: buildChannelConfigSchema(QQConfigSchema),
+    setup: {
+        resolveAccountId: ({ accountId }) => normalizeAccountId(accountId),
+        applyAccountName: ({ cfg, accountId, name }) => applyAccountNameToChannelSection({
+            cfg: cfg,
+            channelKey: "qq",
+            accountId,
+            name,
+        }),
+        applyAccountConfig: ({ cfg, accountId, input }) => {
+            const namedConfig = applyAccountNameToChannelSection({
+                cfg,
+                channelKey: "qq",
+                accountId,
+                name: input.name,
+            });
+            const next = accountId !== DEFAULT_ACCOUNT_ID ? migrateBaseNameToDefaultAccount({
+                cfg: namedConfig,
+                channelKey: "qq",
+            }) : namedConfig;
+            if (accountId === DEFAULT_ACCOUNT_ID) {
+                return {
+                    ...next,
+                    channels: {
+                        ...next.channels,
+                        qq: {
+                            ...next.channels?.["qq"],
+                            enabled: true,
+                        },
+                    },
+                };
+            }
+            return {
+                ...next,
+                channels: {
+                    ...next.channels,
+                    qq: {
+                        ...next.channels?.["qq"],
+                        enabled: true,
+                        accounts: {
+                            ...next.channels?.["qq"]?.accounts,
+                            [accountId]: {
+                                ...next.channels?.["qq"]?.accounts?.[accountId],
+                                enabled: true,
+                            },
+                        },
+                    },
+                },
+            };
+        }
+    },
     messaging: {
         normalizeTarget: (target) => {
             return target.replace(/^qq:/i, "");
@@ -73,45 +126,32 @@ export const qqPlugin = {
         defaultRuntime: {
             accountId: DEFAULT_ACCOUNT_ID,
             name: "QQ",
-            enabled: false,
-            configured: false,
-            linked: false,
             running: false,
             connected: false,
             reconnectAttempts: 0,
             lastConnectedAt: null,
+            lastDisconnect: null,
             lastStartAt: null,
             lastStopAt: null,
             lastError: null,
-            lastInboundAt: null,
-            lastOutboundAt: null,
         },
         buildChannelSummary: ({ snapshot }) => ({
-            enabled: snapshot.enabled ?? false,
             configured: snapshot.configured ?? false,
-            linked: snapshot.linked ?? false,
             running: snapshot.running ?? false,
-            connected: snapshot.connected ?? false,
-            reconnectAttempts: snapshot.reconnectAttempts ?? 0,
-            lastConnectedAt: snapshot.lastConnectedAt ?? null,
             lastStartAt: snapshot.lastStartAt ?? null,
             lastStopAt: snapshot.lastStopAt ?? null,
             lastError: snapshot.lastError ?? null,
-            lastInboundAt: snapshot.lastInboundAt ?? null,
-            lastOutboundAt: snapshot.lastOutboundAt ?? null,
             probe: snapshot.probe,
             lastProbeAt: snapshot.lastProbeAt ?? null,
         }),
         probeAccount: async () => {
             const status = await getStatus();
-            const ok = status.status === "ok";
+            log.debug('gateway', `Probe status: ${status.status}`);
             setContextStatus({
-                linked: ok,
-                running: ok,
                 lastProbeAt: Date.now(),
             });
             return {
-                ok: ok,
+                ok: status.status === "ok",
                 status: status.retcode,
                 error: status.status === "failed" ? status.msg : null,
             };
@@ -120,12 +160,11 @@ export const qqPlugin = {
             return {
                 accountId: DEFAULT_ACCOUNT_ID,
                 name: "QQ",
-                enabled: account.enabled ?? false,
+                enabled: account.enabled,
                 configured: Boolean(account.wsUrl?.trim()),
-                linked: runtime?.linked ?? false,
+                linked: Boolean(account.wsUrl?.trim()),
                 running: runtime?.running ?? false,
                 connected: runtime?.connected ?? false,
-                reconnectAttempts: runtime?.reconnectAttempts ?? 0,
                 lastStartAt: runtime?.lastStartAt ?? null,
                 lastStopAt: runtime?.lastStopAt ?? null,
                 lastError: runtime?.lastError ?? null,
@@ -139,69 +178,30 @@ export const qqPlugin = {
     gateway: {
         startAccount: async (ctx) => {
             setContext(ctx);
-            const { account } = ctx;
+            const { account, abortSignal } = ctx;
             log.info('gateway', `Starting gateway`);
+            setContextStatus({
+                running: true,
+                lastStartAt: Date.now(),
+            });
             // 检查是否已存在连接
             const existingConnection = getConnection();
             if (existingConnection) {
-                log.warn('gateway', `A connection is already running`);
-                return;
+                log.debug('gateway', `A connection is already running`);
+                return waitUntilAbort(abortSignal);
             }
-            // Create new connection manager
-            const connection = new ConnectionManager(account);
-            connection.on("event", (event) => eventListener(event));
-            connection.on("state-changed", (status) => {
-                log.info('gateway', `State: ${status.state}`);
-                if (status.state === "connected") {
-                    setContextStatus({
-                        linked: true,
-                        connected: true,
-                        lastConnectedAt: Date.now(),
-                    });
-                }
-                else if (status.state === "disconnected" || status.state === "failed") {
-                    setContextStatus({
-                        linked: false,
-                        connected: false,
-                        lastError: status.error,
-                    });
-                }
-            });
-            connection.on("reconnecting", (info) => {
-                log.info('gateway', `Reconnecting: ${info.reason}, attempt ${info.totalAttempts}`);
-                setContextStatus({
-                    linked: false,
-                    connected: false,
-                    lastError: `Reconnecting (${info.reason})`,
-                    reconnectAttempts: info.totalAttempts,
-                });
-            });
             try {
+                const connection = new ConnectionManager(account);
+                onEvent(connection);
                 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,
-                    linked: true,
-                    connected: true,
-                    lastStartAt: Date.now(),
-                });
+                await loadLoginInfo();
                 log.info('gateway', `Started gateway`);
+                return waitUntilAbort(abortSignal);
             }
             catch (error) {
                 log.error('gateway', `Failed to start gateway:`, error);
                 setContextStatus({
-                    running: false,
-                    linked: false,
-                    connected: false,
                     lastError: error instanceof Error ? error.message : 'Failed to start gateway',
                 });
                 throw error;
@@ -215,8 +215,6 @@ export const qqPlugin = {
             }
             setContextStatus({
                 running: false,
-                linked: false,
-                connected: false,
                 lastStopAt: Date.now(),
             });
             clearContext();
@@ -239,7 +237,20 @@ export const qqPlugin = {
         listPeersLive: getFriends,
         listGroups: getGroups,
         listGroupsLive: getGroups,
-    }
+    },
+    heartbeat: {
+        checkReady: async ({ cfg }) => {
+            const account = resolveQQAccount({ cfg });
+            if (!account.wsUrl) {
+                return { ok: false, reason: "not-configured" };
+            }
+            const connection = getConnection();
+            if (!connection?.isConnected) {
+                return { ok: false, reason: "not-connected" };
+            }
+            return { ok: true, reason: "ok" };
+        },
+    },
 };
 async function outboundSend(ctx) {
     const { to, text, mediaUrl, accountId, replyToId } = ctx;
@@ -322,3 +333,42 @@ async function getGroups() {
         name: group.group_name,
     }));
 }
+function onEvent(connection) {
+    connection.on("event", (event) => eventListener(event));
+    connection.on("state-changed", (status) => {
+        log.info('gateway', `Connection state: ${status.state}`);
+        if (status.state === "connected") {
+            setContextStatus({
+                connected: true,
+                lastConnectedAt: Date.now(),
+            });
+        }
+        else if (status.state === "disconnected" || status.state === "failed") {
+            setContextStatus({
+                connected: false,
+                lastError: status.error,
+                lastDisconnect: {
+                    at: Date.now(),
+                    error: status.error,
+                },
+            });
+        }
+    });
+    connection.on("reconnecting", (info) => {
+        log.info('gateway', `Reconnecting: ${info.reason}, attempt ${info.totalAttempts}`);
+        setContextStatus({
+            lastError: `Reconnecting (${info.reason})`,
+            reconnectAttempts: info.totalAttempts,
+        });
+    });
+}
+async function loadLoginInfo() {
+    // 获取登录信息
+    const info = await getLoginInfo();
+    if (info.data) {
+        setLoginInfo({
+            userId: info.data.user_id.toString(),
+            nickname: info.data.nickname,
+        });
+    }
+}

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

@@ -5,6 +5,7 @@ import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import type { QQConfig } from "../types";
 import { z } from "zod";
 export declare const CHANNEL_ID = "qq";
+export declare const DEBUG_MODE = false;
 /**
  * 列出所有 QQ 账户ID
  */
@@ -40,7 +41,7 @@ export declare const QQGroupConfigSchema: z.ZodObject<{
 export declare const QQConfigSchema: z.ZodObject<{
     wsUrl: z.ZodDefault<z.ZodString>;
     accessToken: z.ZodDefault<z.ZodString>;
-    enable: z.ZodDefault<z.ZodBoolean>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
     markdownFormat: z.ZodDefault<z.ZodBoolean>;
     messageDirect: z.ZodObject<{
         policy: z.ZodDefault<z.ZodEnum<{

package/dist/src/core/config.js

@@ -4,6 +4,7 @@
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk";
 import { z } from "zod";
 export const CHANNEL_ID = "qq";
+export const DEBUG_MODE = false;
 /**
  * 列出所有 QQ 账户ID
  */
@@ -22,6 +23,7 @@ export function resolveQQAccount(params) {
     return {
         enabled: config?.enabled !== false,
         wsUrl: config?.wsUrl ?? "",
+        token: config?.accessToken ?? "",
         accessToken: config?.accessToken,
         markdownFormat: config?.markdownFormat ?? true,
         messageDirect: {
@@ -66,7 +68,7 @@ export const QQGroupConfigSchema = z.object({
 export const QQConfigSchema = z.object({
     wsUrl: wsUrlSchema,
     accessToken: z.string().default("access-token").describe("NapCat Websocket Token"),
-    enable: z.boolean().default(true).describe("是否启用"),
+    enabled: z.boolean().default(true).describe("是否启用"),
     markdownFormat: z.boolean().default(true).describe("是否启动 Markdown 格式化转换"),
     messageDirect: QQDirectConfigSchema,
     messageGroup: QQGroupConfigSchema,

package/dist/src/core/runtime.js

@@ -27,10 +27,7 @@ export function clearContext() {
 }
 export function setContextStatus(next) {
     if (context) {
-        context.setStatus({
-            ...context.getStatus(),
-            ...next,
-        });
+        context.setStatus(next);
     }
 }
 // =============================================================================

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

@@ -278,6 +278,7 @@ export interface DispatchMessageParams {
 }
 export interface QQConfig {
     wsUrl: string;
+    token?: string;
     accessToken?: string;
     enabled: boolean;
     markdownFormat: boolean;

package/dist/src/utils/log.js

@@ -1,3 +1,4 @@
+import { DEBUG_MODE } from "../core/config";
 import { getRuntime } from "../core/runtime.js";
 function log() {
     return getRuntime()?.logging.getChildLogger({ module: 'channel/qq' }) ?? console;
@@ -9,7 +10,9 @@ function param(args) {
 }
 export class Logger {
     static debug(category, message, ...args) {
-        log().debug?.(`[${category}] ${message}${param(args)}`);
+        if (DEBUG_MODE) {
+            log().debug?.(`[${category}] ${message}${param(args)}`);
+        }
     }
     static info(category, message, ...args) {
         log().info?.(`[${category}] ${message}${param(args)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izhimu/qq",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "A QQ channel plugin for OpenClaw using NapCat WebSocket",
   "type": "module",
   "main": "dist/index.js",