flashclaw 1.0.0 → 1.1.0

package/dist/index.js

@@ -7,14 +7,16 @@ import fs from 'fs';
 import path from 'path';
 import { isIP } from 'net';
 import pino from 'pino';
+import { z } from 'zod';
 import { paths, ensureDirectories, getBuiltinPluginsDir } from './paths.js';
 import { pluginManager } from './plugins/manager.js';
 import { loadFromDir, watchPlugins, stopWatching } from './plugins/loader.js';
 import { getApiClient } from './core/api-client.js';
 import { getMemoryManager } from './core/memory.js';
-import { BOT_NAME, DATA_DIR, MAIN_GROUP_FOLDER, IPC_POLL_INTERVAL, TIMEZONE } from './config.js';
+import { BOT_NAME, MAIN_GROUP_FOLDER, IPC_POLL_INTERVAL, TIMEZONE, HISTORY_CONTEXT_LIMIT, THINKING_THRESHOLD_MS, MAX_DIRECT_FETCH_CHARS, MAX_IPC_FILE_BYTES, MAX_IPC_MESSAGE_CHARS, MAX_IPC_CHAT_ID_CHARS, MAX_IMAGE_BYTES, MESSAGE_QUEUE_MAX_SIZE, MESSAGE_QUEUE_MAX_CONCURRENT, MESSAGE_QUEUE_PROCESSING_TIMEOUT_MS, MESSAGE_QUEUE_MAX_RETRIES } from './config.js';
 import { initDatabase, storeMessage, storeChatMetadata, getMessagesSince, getChatHistory, messageExists, getAllTasks, getAllChats } from './db.js';
-import { startSchedulerLoop, stopScheduler } from './task-scheduler.js';
+import { startSchedulerLoop, stopScheduler, wake } from './task-scheduler.js';
+import { startHealthServer, stopHealthServer } from './health.js';
 import { runAgent, writeTasksSnapshot, writeGroupsSnapshot } from './agent-runner.js';
 import { loadJson, saveJson } from './utils.js';
 import { MessageQueue } from './message-queue.js';
@@ -59,7 +61,8 @@ class ChannelManager {
             try {
                 return await channel.sendMessage(chatId, content);
             }
-            catch {
+            catch (err) {
+                logger.debug({ channel: channel.name, chatId, err }, '渠道发送消息失败，尝试下一个');
                 continue;
             }
         }
@@ -81,7 +84,8 @@ class ChannelManager {
                     await channel.updateMessage(messageId, content);
                     return;
                 }
-                catch {
+                catch (err) {
+                    logger.debug({ channel: channel.name, messageId, err }, '渠道更新消息失败，尝试下一个');
                     continue;
                 }
             }
@@ -101,11 +105,39 @@ class ChannelManager {
                     await channel.deleteMessage(messageId);
                     return;
                 }
-                catch {
+                catch (err) {
+                    logger.debug({ channel: channel.name, messageId, err }, '渠道删除消息失败，尝试下一个');
+                    continue;
+                }
+            }
+        }
+    }
+    async sendImage(chatId, imageData, caption, platform) {
+        // 如果指定了平台，使用指定的渠道
+        if (platform) {
+            const channel = this.channels.find(c => c.name === platform);
+            if (channel?.sendImage) {
+                return await channel.sendImage(chatId, imageData, caption);
+            }
+            // 渠道不支持发送图片，降级为发送文本提示
+            logger.warn({ platform, chatId }, '渠道不支持发送图片，已降级');
+            return await this.sendMessage(chatId, caption || '[图片无法显示]', platform);
+        }
+        // 尝试所有支持图片的渠道
+        for (const channel of this.channels) {
+            if (channel.sendImage) {
+                try {
+                    return await channel.sendImage(chatId, imageData, caption);
+                }
+                catch (err) {
+                    logger.debug({ channel: channel.name, chatId, err }, '渠道发送图片失败，尝试下一个');
                     continue;
                 }
             }
         }
+        // 所有渠道都不支持，降级为文本
+        logger.warn({ chatId }, '没有渠道支持发送图片，已降级');
+        return await this.sendMessage(chatId, caption || '[图片无法显示]', platform);
     }
     getEnabledPlatforms() {
         return this.enabledPlatforms;
@@ -132,24 +164,12 @@ let registeredGroups = {};
 let lastAgentTimestamp = {};
 let messageQueue;
 let isShuttingDown = false;
-// 消息历史上下文配置
-// 现在由 MemoryManager 基于 token 自动管理，这里只是一个备用限制
-const HISTORY_CONTEXT_LIMIT = 500;
-// "正在思考..." 提示配置
-// 注意：飞书不支持更新普通文本消息，所以默认禁用此功能
-// 如需启用，设置环境变量 THINKING_THRESHOLD_MS=2500（毫秒）
-const THINKING_THRESHOLD_MS = Number(process.env.THINKING_THRESHOLD_MS ?? 0);
 // 直接网页抓取触发（避免模型不触发工具）
 const WEB_FETCH_TOOL_NAME = 'web_fetch';
 const WEB_FETCH_INTENT_RE = /(抓取|获取|读取|访问|打开|爬取|网页|网站|链接|fetch|web)/i;
 const WEB_FETCH_URL_RE = /https?:\/\/[^\s<>()]+/i;
 const WEB_FETCH_DOMAIN_RE = /(?:^|[^A-Za-z0-9.-])((?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,})(:\d{2,5})?(\/[^\s<>()]*)?/i;
 const TRAILING_PUNCT_RE = /[)\],.。，;；!！?？]+$/;
-const MAX_DIRECT_FETCH_CHARS = 4000;
-const MAX_IPC_FILE_BYTES = 1024 * 1024;
-const MAX_IPC_MESSAGE_CHARS = 10000;
-const MAX_IPC_CHAT_ID_CHARS = 256;
-const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
 // ==================== 状态管理 ====================
 // 默认的 main 群组配置模板（用于自动注册新会话）
 const DEFAULT_MAIN_GROUP = {
@@ -159,11 +179,12 @@ const DEFAULT_MAIN_GROUP = {
     added_at: new Date().toISOString()
 };
 function loadState() {
-    const statePath = path.join(DATA_DIR, 'router_state.json');
+    const dataDir = paths.data();
+    const statePath = path.join(dataDir, 'router_state.json');
     const state = loadJson(statePath, {});
     lastAgentTimestamp = state.last_agent_timestamp || {};
-    sessions = loadJson(path.join(DATA_DIR, 'sessions.json'), {});
-    registeredGroups = loadJson(path.join(DATA_DIR, 'registered_groups.json'), {});
+    sessions = loadJson(path.join(dataDir, 'sessions.json'), {});
+    registeredGroups = loadJson(path.join(dataDir, 'registered_groups.json'), {});
     // 确保有 main 群组配置模板（用于自动注册）
     const hasMainGroup = Object.values(registeredGroups).some(g => g.folder === MAIN_GROUP_FOLDER);
     if (!hasMainGroup) {
@@ -174,12 +195,17 @@ function loadState() {
     logger.info({ groupCount: Object.keys(registeredGroups).length }, '⚡ 状态已加载');
 }
 function saveState() {
-    saveJson(path.join(DATA_DIR, 'router_state.json'), { last_agent_timestamp: lastAgentTimestamp });
-    saveJson(path.join(DATA_DIR, 'sessions.json'), sessions);
+    const dataDir = paths.data();
+    saveJson(path.join(dataDir, 'router_state.json'), { last_agent_timestamp: lastAgentTimestamp });
+    saveJson(path.join(dataDir, 'sessions.json'), sessions);
 }
 function registerGroup(chatId, group) {
     registeredGroups[chatId] = group;
-    saveJson(path.join(DATA_DIR, 'registered_groups.json'), registeredGroups);
+    saveJson(path.join(paths.data(), 'registered_groups.json'), registeredGroups);
+    // 同步更新全局 Map
+    if (global.__flashclaw_registered_groups) {
+        global.__flashclaw_registered_groups.set(chatId, group);
+    }
     // 创建群组文件夹
     const groupDir = path.join(paths.groups(), group.folder);
     fs.mkdirSync(path.join(groupDir, 'logs'), { recursive: true });
@@ -224,7 +250,7 @@ function shouldTriggerAgent(msg, group) {
     }
     return false;
 }
-function extractFirstUrl(text) {
+export function extractFirstUrl(text) {
     const match = text.match(WEB_FETCH_URL_RE);
     if (match) {
         return match[0].replace(TRAILING_PUNCT_RE, '');
@@ -238,7 +264,7 @@ function extractFirstUrl(text) {
     const candidate = `https://${host}${port}${path}`;
     return candidate.replace(TRAILING_PUNCT_RE, '');
 }
-function isPrivateIpv4(ip) {
+export function isPrivateIpv4(ip) {
     const parts = ip.split('.').map((part) => Number(part));
     if (parts.length !== 4 || parts.some((part) => Number.isNaN(part)))
         return false;
@@ -259,7 +285,7 @@ function isPrivateIpv4(ip) {
         return true;
     return false;
 }
-function isPrivateIpv6(ip) {
+export function isPrivateIpv6(ip) {
     const normalized = ip.toLowerCase();
     if (normalized === '::' || normalized === '::1')
         return true;
@@ -276,7 +302,7 @@ function isPrivateIpv6(ip) {
     }
     return false;
 }
-function isPrivateIp(ip) {
+export function isPrivateIp(ip) {
     const family = isIP(ip);
     if (family === 4)
         return isPrivateIpv4(ip);
@@ -284,7 +310,7 @@ function isPrivateIp(ip) {
         return isPrivateIpv6(ip);
     return false;
 }
-function isBlockedHostname(hostname) {
+export function isBlockedHostname(hostname) {
     const normalized = hostname.trim().toLowerCase();
     if (normalized === 'localhost')
         return true;
@@ -292,7 +318,7 @@ function isBlockedHostname(hostname) {
         normalized.endsWith('.local') ||
         normalized.endsWith('.internal'));
 }
-function estimateBase64Bytes(content) {
+export function estimateBase64Bytes(content) {
     if (!content)
         return null;
     const raw = content.startsWith('data:') ? content.split(',')[1] ?? '' : content;
@@ -302,13 +328,13 @@ function estimateBase64Bytes(content) {
     const padding = normalized.endsWith('==') ? 2 : normalized.endsWith('=') ? 1 : 0;
     return Math.max(0, Math.floor((normalized.length * 3) / 4) - padding);
 }
-function truncateText(text, maxLength) {
+export function truncateText(text, maxLength) {
     if (text.length <= maxLength) {
         return { text, truncated: false };
     }
     return { text: `${text.slice(0, maxLength)}\n\n...（内容已截断）`, truncated: true };
 }
-function formatDirectWebFetchResponse(url, result) {
+export function formatDirectWebFetchResponse(url, result) {
     if (!result.success) {
         return `❌ 抓取失败: ${result.error || '未知错误'}`;
     }
@@ -375,6 +401,9 @@ async function tryHandleDirectWebFetch(msg, group) {
         userId: msg.senderId,
         sendMessage: async (text) => {
             await sendMessage(msg.chatId, `${BOT_NAME}: ${text}`, msg.platform);
+        },
+        sendImage: async (imageData, caption) => {
+            await channelManager.sendImage(msg.chatId, imageData, caption, msg.platform);
         }
     };
     const normalizedUrl = urlObj.toString();
@@ -469,8 +498,8 @@ async function processQueuedMessage(queuedMsg) {
                 logger.debug({ chatId, messageId: placeholderMessageId }, '已发送思考提示');
             }
         }
-        catch {
-            // 忽略错误
+        catch (err) {
+            logger.debug({ chatId, err }, '发送思考提示失败');
         }
     }, THINKING_THRESHOLD_MS) : null;
     try {
@@ -492,12 +521,15 @@ async function processQueuedMessage(queuedMsg) {
                     await channelManager.updateMessage(placeholderMessageId, finalText, msg.platform);
                     logger.info({ chatId, messageId: placeholderMessageId }, '⚡ 消息已更新');
                 }
-                catch {
+                catch (updateErr) {
                     // 更新失败，尝试删除并发送新消息
+                    logger.debug({ chatId, messageId: placeholderMessageId, err: updateErr }, '更新占位消息失败，尝试删除并重发');
                     try {
                         await channelManager.deleteMessage(placeholderMessageId, msg.platform);
                     }
-                    catch { }
+                    catch (deleteErr) {
+                        logger.debug({ chatId, messageId: placeholderMessageId, err: deleteErr }, '删除占位消息失败');
+                    }
                     await sendMessage(chatId, finalText, msg.platform);
                 }
             }
@@ -520,7 +552,9 @@ async function processQueuedMessage(queuedMsg) {
             try {
                 await channelManager.deleteMessage(placeholderMessageId, msg.platform);
             }
-            catch { }
+            catch (deleteErr) {
+                logger.debug({ chatId, messageId: placeholderMessageId, err: deleteErr }, '删除占位消息失败（无响应）');
+            }
         }
     }
     catch (err) {
@@ -533,7 +567,9 @@ async function processQueuedMessage(queuedMsg) {
             try {
                 await channelManager.deleteMessage(placeholderMessageId, msg.platform);
             }
-            catch { }
+            catch (deleteErr) {
+                logger.debug({ chatId, messageId: placeholderMessageId, err: deleteErr }, '删除占位消息失败（错误恢复）');
+            }
         }
         throw err;
     }
@@ -726,7 +762,7 @@ async function executeAgent(group, prompt, chatId, options) {
         });
         if (output.newSessionId) {
             sessions[group.folder] = output.newSessionId;
-            saveJson(path.join(DATA_DIR, 'sessions.json'), sessions);
+            saveJson(path.join(paths.data(), 'sessions.json'), sessions);
         }
         if (output.status === 'error') {
             logger.error({ group: group.name, error: output.error }, 'Agent 错误');
@@ -764,7 +800,7 @@ function quarantineIpcFile(ipcBaseDir, sourceGroup, filePath, reason, err) {
     logger.warn({ file: fileName, sourceGroup, reason, err }, 'IPC 文件已隔离');
 }
 function startIpcWatcher() {
-    const ipcBaseDir = path.join(DATA_DIR, 'ipc');
+    const ipcBaseDir = path.join(paths.data(), 'ipc');
     fs.mkdirSync(ipcBaseDir, { recursive: true });
     const processIpcFiles = async () => {
         let groupFolders;
@@ -816,6 +852,28 @@ function startIpcWatcher() {
                                     logger.warn({ chatId: data.chatJid, sourceGroup }, '未授权的 IPC 消息被阻止');
                                 }
                             }
+                            else if (data.type === 'image' && data.chatJid && data.imageData) {
+                                // 处理图片消息
+                                if (typeof data.chatJid !== 'string' || data.chatJid.length > MAX_IPC_CHAT_ID_CHARS) {
+                                    logger.warn({ sourceGroup }, 'IPC 图片消息 chatJid 格式不合法');
+                                    fs.unlinkSync(filePath);
+                                    continue;
+                                }
+                                if (typeof data.imageData !== 'string') {
+                                    logger.warn({ sourceGroup }, 'IPC 图片消息 imageData 格式不合法');
+                                    fs.unlinkSync(filePath);
+                                    continue;
+                                }
+                                const targetGroup = registeredGroups[data.chatJid];
+                                if (isMain || (targetGroup && targetGroup.folder === sourceGroup)) {
+                                    const caption = data.caption ? `${BOT_NAME}: ${data.caption}` : undefined;
+                                    await channelManager.sendImage(data.chatJid, data.imageData, caption);
+                                    logger.info({ chatId: data.chatJid, sourceGroup }, 'IPC 图片已发送');
+                                }
+                                else {
+                                    logger.warn({ chatId: data.chatJid, sourceGroup }, '未授权的 IPC 图片被阻止');
+                                }
+                            }
                             fs.unlinkSync(filePath);
                         }
                         catch (err) {
@@ -860,128 +918,171 @@ function startIpcWatcher() {
     processIpcFiles();
     logger.info('⚡ IPC 监听已启动');
 }
-async function processTaskIpc(data, sourceGroup, isMain) {
+// ==================== IPC Schema 验证 ====================
+/** 基础 IPC 消息 schema */
+const IpcBaseSchema = z.object({
+    type: z.string().min(1).max(50),
+});
+/** schedule_task IPC schema */
+const IpcScheduleTaskSchema = IpcBaseSchema.extend({
+    type: z.literal('schedule_task'),
+    prompt: z.string().min(1).max(10000),
+    schedule_type: z.enum(['cron', 'interval', 'once']),
+    schedule_value: z.string().min(1).max(200),
+    groupFolder: z.string().min(1).max(100),
+    context_mode: z.enum(['group', 'isolated']).optional(),
+    max_retries: z.number().int().min(0).max(10).optional(),
+    timeout_ms: z.number().int().min(1000).max(3600000).optional(),
+});
+/** pause/resume/cancel task IPC schema */
+const IpcTaskActionSchema = IpcBaseSchema.extend({
+    type: z.enum(['pause_task', 'resume_task', 'cancel_task']),
+    taskId: z.string().min(1).max(100),
+});
+/** register_group IPC schema */
+const IpcRegisterGroupSchema = IpcBaseSchema.extend({
+    type: z.literal('register_group'),
+    jid: z.string().min(1).max(256),
+    name: z.string().min(1).max(200),
+    folder: z.string().min(1).max(100).regex(/^[a-zA-Z0-9_-]+$/),
+    trigger: z.string().min(1).max(50),
+    agentConfig: z.object({
+        timeout: z.number().int().min(1000).max(3600000).optional(),
+        env: z.record(z.string(), z.string()).optional(),
+    }).optional(),
+});
+/** 联合 IPC schema */
+const IpcMessageSchema = z.discriminatedUnion('type', [
+    IpcScheduleTaskSchema,
+    IpcTaskActionSchema.extend({ type: z.literal('pause_task') }),
+    IpcTaskActionSchema.extend({ type: z.literal('resume_task') }),
+    IpcTaskActionSchema.extend({ type: z.literal('cancel_task') }),
+    IpcRegisterGroupSchema,
+]);
+async function processTaskIpc(rawData, sourceGroup, isMain) {
+    // Zod schema 验证
+    const parseResult = IpcMessageSchema.safeParse(rawData);
+    if (!parseResult.success) {
+        logger.warn({
+            sourceGroup,
+            errors: parseResult.error.flatten().fieldErrors
+        }, 'IPC 消息验证失败');
+        return;
+    }
+    const data = parseResult.data;
     const { createTask, updateTask, deleteTask, getTaskById: getTask } = await import('./db.js');
     const { CronExpressionParser } = await import('cron-parser');
     switch (data.type) {
-        case 'schedule_task':
-            if (data.prompt && data.schedule_type && data.schedule_value && data.groupFolder) {
-                const targetGroup = data.groupFolder;
-                if (!isMain && targetGroup !== sourceGroup) {
-                    logger.warn({ sourceGroup, targetGroup }, '未授权的 schedule_task 被阻止');
-                    break;
+        case 'schedule_task': {
+            // Zod 已验证必填字段，直接使用
+            const targetGroup = data.groupFolder;
+            if (!isMain && targetGroup !== sourceGroup) {
+                logger.warn({ sourceGroup, targetGroup }, '未授权的 schedule_task 被阻止');
+                break;
+            }
+            const targetChatId = Object.entries(registeredGroups).find(([, group]) => group.folder === targetGroup)?.[0];
+            if (!targetChatId) {
+                logger.warn({ targetGroup }, '无法创建任务：目标群组未注册');
+                break;
+            }
+            const scheduleType = data.schedule_type;
+            let nextRun = null;
+            if (scheduleType === 'cron') {
+                try {
+                    const interval = CronExpressionParser.parse(data.schedule_value, { tz: TIMEZONE });
+                    nextRun = interval.next().toISOString();
                 }
-                const targetChatId = Object.entries(registeredGroups).find(([, group]) => group.folder === targetGroup)?.[0];
-                if (!targetChatId) {
-                    logger.warn({ targetGroup }, '无法创建任务：目标群组未注册');
+                catch {
+                    logger.warn({ scheduleValue: data.schedule_value }, '无效的 cron 表达式');
                     break;
                 }
-                const scheduleType = data.schedule_type;
-                let nextRun = null;
-                if (scheduleType === 'cron') {
-                    try {
-                        const interval = CronExpressionParser.parse(data.schedule_value, { tz: TIMEZONE });
-                        nextRun = interval.next().toISOString();
-                    }
-                    catch {
-                        logger.warn({ scheduleValue: data.schedule_value }, '无效的 cron 表达式');
-                        break;
-                    }
-                }
-                else if (scheduleType === 'interval') {
-                    const ms = parseInt(data.schedule_value, 10);
-                    if (isNaN(ms) || ms <= 0) {
-                        logger.warn({ scheduleValue: data.schedule_value }, '无效的间隔值');
-                        break;
-                    }
-                    nextRun = new Date(Date.now() + ms).toISOString();
+            }
+            else if (scheduleType === 'interval') {
+                const ms = parseInt(data.schedule_value, 10);
+                if (isNaN(ms) || ms <= 0) {
+                    logger.warn({ scheduleValue: data.schedule_value }, '无效的间隔值');
+                    break;
                 }
-                else if (scheduleType === 'once') {
-                    const scheduled = new Date(data.schedule_value);
-                    if (isNaN(scheduled.getTime())) {
-                        logger.warn({ scheduleValue: data.schedule_value }, '无效的时间戳');
-                        break;
-                    }
-                    nextRun = scheduled.toISOString();
+                nextRun = new Date(Date.now() + ms).toISOString();
+            }
+            else if (scheduleType === 'once') {
+                const scheduled = new Date(data.schedule_value);
+                if (isNaN(scheduled.getTime())) {
+                    logger.warn({ scheduleValue: data.schedule_value }, '无效的时间戳');
+                    break;
                 }
-                const taskId = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-                const contextMode = (data.context_mode === 'group' || data.context_mode === 'isolated')
-                    ? data.context_mode
-                    : 'isolated';
-                createTask({
-                    id: taskId,
-                    group_folder: targetGroup,
-                    chat_jid: targetChatId,
-                    prompt: data.prompt,
-                    schedule_type: scheduleType,
-                    schedule_value: data.schedule_value,
-                    context_mode: contextMode,
-                    next_run: nextRun,
-                    status: 'active',
-                    created_at: new Date().toISOString(),
-                    retry_count: 0,
-                    max_retries: data.max_retries ?? 3,
-                    timeout_ms: data.timeout_ms ?? 300000
-                });
-                logger.info({ taskId, sourceGroup, targetGroup, contextMode }, '⚡ 任务已创建');
+                nextRun = scheduled.toISOString();
             }
+            const taskId = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            const contextMode = data.context_mode ?? 'isolated';
+            createTask({
+                id: taskId,
+                group_folder: targetGroup,
+                chat_jid: targetChatId,
+                prompt: data.prompt,
+                schedule_type: scheduleType,
+                schedule_value: data.schedule_value,
+                context_mode: contextMode,
+                next_run: nextRun,
+                status: 'active',
+                created_at: new Date().toISOString(),
+                retry_count: 0,
+                max_retries: data.max_retries ?? 3,
+                timeout_ms: data.timeout_ms ?? 300000
+            });
+            // 唤醒调度器，确保新任务立即生效
+            wake();
+            logger.info({ taskId, sourceGroup, targetGroup, contextMode }, '⚡ 任务已创建');
             break;
-        case 'pause_task':
-            if (data.taskId) {
-                const task = getTask(data.taskId);
-                if (task && (isMain || task.group_folder === sourceGroup)) {
-                    updateTask(data.taskId, { status: 'paused' });
-                    logger.info({ taskId: data.taskId, sourceGroup }, '任务已暂停');
-                }
-                else {
-                    logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务暂停操作');
-                }
+        }
+        case 'pause_task': {
+            const task = getTask(data.taskId);
+            if (task && (isMain || task.group_folder === sourceGroup)) {
+                updateTask(data.taskId, { status: 'paused' });
+                logger.info({ taskId: data.taskId, sourceGroup }, '任务已暂停');
+            }
+            else {
+                logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务暂停操作');
             }
             break;
-        case 'resume_task':
-            if (data.taskId) {
-                const task = getTask(data.taskId);
-                if (task && (isMain || task.group_folder === sourceGroup)) {
-                    updateTask(data.taskId, { status: 'active' });
-                    logger.info({ taskId: data.taskId, sourceGroup }, '任务已恢复');
-                }
-                else {
-                    logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务恢复操作');
-                }
+        }
+        case 'resume_task': {
+            const task = getTask(data.taskId);
+            if (task && (isMain || task.group_folder === sourceGroup)) {
+                updateTask(data.taskId, { status: 'active' });
+                logger.info({ taskId: data.taskId, sourceGroup }, '任务已恢复');
+            }
+            else {
+                logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务恢复操作');
             }
             break;
-        case 'cancel_task':
-            if (data.taskId) {
-                const task = getTask(data.taskId);
-                if (task && (isMain || task.group_folder === sourceGroup)) {
-                    deleteTask(data.taskId);
-                    logger.info({ taskId: data.taskId, sourceGroup }, '任务已取消');
-                }
-                else {
-                    logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务取消操作');
-                }
+        }
+        case 'cancel_task': {
+            const task = getTask(data.taskId);
+            if (task && (isMain || task.group_folder === sourceGroup)) {
+                deleteTask(data.taskId);
+                logger.info({ taskId: data.taskId, sourceGroup }, '任务已取消');
+            }
+            else {
+                logger.warn({ taskId: data.taskId, sourceGroup }, '未授权的任务取消操作');
             }
             break;
-        case 'register_group':
+        }
+        case 'register_group': {
             if (!isMain) {
                 logger.warn({ sourceGroup }, '未授权的 register_group 被阻止');
                 break;
             }
-            if (data.jid && data.name && data.folder && data.trigger) {
-                registerGroup(data.jid, {
-                    name: data.name,
-                    folder: data.folder,
-                    trigger: data.trigger,
-                    added_at: new Date().toISOString(),
-                    agentConfig: data.agentConfig
-                });
-            }
-            else {
-                logger.warn({ data }, '无效的 register_group 请求');
-            }
+            // Zod 已验证必填字段，直接使用
+            registerGroup(data.jid, {
+                name: data.name,
+                folder: data.folder,
+                trigger: data.trigger,
+                added_at: new Date().toISOString(),
+                agentConfig: data.agentConfig
+            });
             break;
-        default:
-            logger.warn({ type: data.type }, '未知的 IPC 任务类型');
+        }
     }
 }
 // ==================== 启动横幅 ====================
@@ -1074,12 +1175,15 @@ export async function main() {
     logger.info({ platforms: enabledPlatforms }, '⚡ 渠道管理器已初始化');
     // 加载状态
     loadState();
+    // 注入全局变量，供 Web UI 等插件使用
+    global.__flashclaw_run_agent = runAgent;
+    global.__flashclaw_registered_groups = new Map(Object.entries(registeredGroups));
     // 初始化消息队列
     messageQueue = new MessageQueue(processQueuedMessage, {
-        maxQueueSize: 100,
-        maxConcurrent: 3,
-        processingTimeout: 300000,
-        maxRetries: 2
+        maxQueueSize: MESSAGE_QUEUE_MAX_SIZE,
+        maxConcurrent: MESSAGE_QUEUE_MAX_CONCURRENT,
+        processingTimeout: MESSAGE_QUEUE_PROCESSING_TIMEOUT_MS,
+        maxRetries: MESSAGE_QUEUE_MAX_RETRIES
     });
     messageQueue.start();
     logger.info('⚡ 消息队列已初始化');
@@ -1101,6 +1205,11 @@ export async function main() {
         platforms: enabledPlatforms,
         groups: groupCount
     }, '⚡ FlashClaw 已启动');
+    // 启动健康检查服务（可通过 HEALTH_PORT 环境变量配置端口，默认 9090）
+    const healthPort = parseInt(process.env.HEALTH_PORT || '9090', 10);
+    if (healthPort > 0) {
+        startHealthServer(healthPort);
+    }
     // 注册优雅关闭处理
     setupGracefulShutdown();
 }
@@ -1144,7 +1253,10 @@ async function gracefulShutdown(signal) {
         // 7. 卸载插件
         logger.info('⚡ 卸载插件...');
         await pluginManager.clear();
-        // 8. 保存状态
+        // 8. 停止健康检查服务
+        logger.info('⚡ 停止健康检查服务...');
+        stopHealthServer();
+        // 9. 保存状态
         logger.info('⚡ 保存状态...');
         saveState();
         logger.info('⚡ FlashClaw 已安全关闭');
@@ -1173,9 +1285,11 @@ function setupGracefulShutdown() {
         logger.error({ reason }, '未处理的 Promise 拒绝');
     });
 }
-// 直接运行时启动
-main().catch(err => {
-    logger.error({ err }, '⚡ FlashClaw 启动失败');
-    process.exit(1);
-});
+// 直接运行时启动（测试环境可通过 FLASHCLAW_SKIP_MAIN=1 禁用）
+if (process.env.FLASHCLAW_SKIP_MAIN !== '1') {
+    main().catch(err => {
+        logger.error({ err }, '⚡ FlashClaw 启动失败');
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map