flashclaw 1.0.0

package/dist/commands.js

@@ -0,0 +1,252 @@
+/**
+ * Chat Commands Module
+ *
+ * 处理用户在聊天中发送的斜杠命令
+ * 如 /status, /new, /help 等
+ */
+import pino from 'pino';
+const logger = pino({
+    level: process.env.LOG_LEVEL || 'info',
+    transport: { target: 'pino-pretty', options: { colorize: true } }
+});
+/**
+ * 检查消息是否是命令
+ */
+export function isCommand(content) {
+    return content.trim().startsWith('/');
+}
+/**
+ * 解析命令
+ */
+function parseCommand(content) {
+    const trimmed = content.trim();
+    const parts = trimmed.slice(1).split(/\s+/);
+    return {
+        command: parts[0]?.toLowerCase() || '',
+        args: parts.slice(1)
+    };
+}
+/**
+ * 处理命令
+ */
+export function handleCommand(content, context) {
+    if (!isCommand(content)) {
+        return { isCommand: false };
+    }
+    const { command, args } = parseCommand(content);
+    logger.info({ command, args, chatId: context.chatId }, '⚡ 收到命令');
+    switch (command) {
+        case 'help':
+        case 'h':
+        case '帮助':
+            return handleHelp();
+        case 'status':
+        case 's':
+        case '状态':
+            return handleStatus(context);
+        case 'new':
+        case 'reset':
+        case '重置':
+            return handleReset(context);
+        case 'tasks':
+        case '任务':
+            return handleTasks(context);
+        case 'ping':
+            return handlePing();
+        case 'compact':
+            return handleCompact(context);
+        default:
+            return {
+                isCommand: true,
+                shouldRespond: true,
+                response: `❌ 未知命令: /${command}\n\n使用 /help 查看可用命令`
+            };
+    }
+}
+/**
+ * /help - 显示帮助
+ */
+function handleHelp() {
+    const helpText = `⚡ **FlashClaw 命令**
+
+📋 **基础命令**
+\`/help\` - 显示此帮助
+\`/status\` - 查看会话状态
+\`/new\` - 重置当前会话
+\`/compact\` - 压缩会话上下文
+\`/tasks\` - 查看定时任务
+\`/ping\` - 测试机器人响应
+
+💡 **提示**
+• 私聊直接发消息即可对话
+• 群聊需要 @机器人 触发响应
+• 使用 "记住..." 保存长期记忆
+• 上下文达到 70% 时会自动提示压缩`;
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: helpText
+    };
+}
+/**
+ * 简单哈希函数，用于脱敏显示
+ */
+function hashId(id) {
+    let hash = 0;
+    for (let i = 0; i < id.length; i++) {
+        const char = id.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(16).slice(0, 8);
+}
+/**
+ * /status - 显示会话状态
+ */
+function handleStatus(context) {
+    const stats = context.getSessionStats?.();
+    // 脱敏处理：用户 ID 和会话 ID 都用哈希显示
+    const maskedChatId = hashId(context.chatId);
+    const maskedUserId = hashId(context.userId);
+    // 如果用户名看起来像 ID（ou_ 开头或很长的字符串），则使用脱敏后的 ID
+    const displayName = (context.userName &&
+        !context.userName.startsWith('ou_') &&
+        context.userName.length < 20)
+        ? context.userName
+        : `用户#${maskedUserId}`;
+    let statusText = `⚡ **会话状态**\n\n`;
+    statusText += `📍 **会话**: \`#${maskedChatId}\`\n`;
+    statusText += `👤 **用户**: ${displayName}\n`;
+    statusText += `📱 **平台**: ${context.platform}\n`;
+    if (stats) {
+        statusText += `\n📊 **统计**\n`;
+        statusText += `• 消息数: ${stats.messageCount}\n`;
+        if (stats.tokenCount !== undefined && stats.tokenCount > 0) {
+            const usagePercent = stats.maxTokens
+                ? Math.round((stats.tokenCount / stats.maxTokens) * 100)
+                : 0;
+            statusText += `• Token: ${stats.tokenCount.toLocaleString()}`;
+            if (stats.maxTokens) {
+                statusText += ` / ${stats.maxTokens.toLocaleString()} (${usagePercent}%)`;
+            }
+            statusText += `\n`;
+        }
+        else {
+            statusText += `• Token: _统计中..._\n`;
+        }
+        if (stats.model) {
+            statusText += `• 模型: ${stats.model}\n`;
+        }
+        if (stats.startedAt) {
+            statusText += `• 开始于: ${new Date(stats.startedAt).toLocaleString('zh-CN')}\n`;
+        }
+    }
+    else {
+        statusText += `\n_会话统计暂不可用_`;
+    }
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: statusText
+    };
+}
+/**
+ * /new - 重置会话
+ */
+function handleReset(context) {
+    if (context.resetSession) {
+        context.resetSession();
+        logger.info({ chatId: context.chatId }, '⚡ 会话已重置');
+        return {
+            isCommand: true,
+            shouldRespond: true,
+            response: `✅ **会话已重置**\n\n新的对话已开始，之前的上下文已清除。`
+        };
+    }
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: `⚠️ 会话重置功能暂不可用`
+    };
+}
+/**
+ * /tasks - 显示定时任务
+ */
+function handleTasks(context) {
+    const tasks = context.getTasks?.() || [];
+    if (tasks.length === 0) {
+        return {
+            isCommand: true,
+            shouldRespond: true,
+            response: `📋 **定时任务**\n\n_当前没有定时任务_\n\n使用自然语言创建任务，如：\n"每天早上9点提醒我喝水"`
+        };
+    }
+    let tasksText = `📋 **定时任务** (${tasks.length}个)\n\n`;
+    for (const task of tasks) {
+        const statusIcon = task.status === 'active' ? '🟢' :
+            task.status === 'paused' ? '⏸️' : '⚪';
+        tasksText += `${statusIcon} **${task.id.slice(-6)}**\n`;
+        tasksText += `   ${task.prompt.slice(0, 50)}${task.prompt.length > 50 ? '...' : ''}\n`;
+        if (task.nextRun) {
+            tasksText += `   ⏰ 下次: ${new Date(task.nextRun).toLocaleString('zh-CN')}\n`;
+        }
+        tasksText += `\n`;
+    }
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: tasksText
+    };
+}
+/**
+ * /ping - 测试响应
+ */
+function handlePing() {
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: `🏓 Pong! FlashClaw 运行正常`
+    };
+}
+/**
+ * /compact - 压缩会话上下文
+ */
+function handleCompact(context) {
+    if (!context.compactSession) {
+        return {
+            isCommand: true,
+            shouldRespond: true,
+            response: `⚠️ 会话压缩功能暂不可用`
+        };
+    }
+    // 返回一个立即响应，实际压缩在后台进行
+    // 压缩完成后会发送另一条消息
+    return {
+        isCommand: true,
+        shouldRespond: true,
+        response: `⏳ **正在压缩会话...**\n\n这可能需要几秒钟，压缩完成后会通知你。`
+    };
+}
+/**
+ * 检查是否需要提示用户压缩会话
+ * @param tokenCount 当前 token 数
+ * @param maxTokens 最大 token 数
+ * @param threshold 阈值（默认 0.7 = 70%）
+ */
+export function shouldSuggestCompact(tokenCount, maxTokens, threshold = 0.7) {
+    if (!tokenCount || !maxTokens)
+        return false;
+    return tokenCount / maxTokens >= threshold;
+}
+/**
+ * 生成压缩提示消息
+ */
+export function getCompactSuggestion(tokenCount, maxTokens) {
+    const percentage = Math.round((tokenCount / maxTokens) * 100);
+    return `⚠️ **上下文使用率 ${percentage}%**\n\n` +
+        `当前会话已使用 ${tokenCount.toLocaleString()} / ${maxTokens.toLocaleString()} tokens。\n\n` +
+        `建议操作：\n` +
+        `• 发送 \`/compact\` 压缩上下文（保留摘要）\n` +
+        `• 发送 \`/new\` 重置会话（清除所有）`;
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;CAClE,CAAC,CAAC;AAgDH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;QACtC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAuB;IACpE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEjE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,GAAG,CAAC;QACT,KAAK,IAAI;YACP,OAAO,UAAU,EAAE,CAAC;QAEtB,KAAK,QAAQ,CAAC;QACd,KAAK,GAAG,CAAC;QACT,KAAK,IAAI;YACP,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAE/B,KAAK,KAAK,CAAC;QACX,KAAK,OAAO,CAAC;QACb,KAAK,IAAI;YACP,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAE9B,KAAK,OAAO,CAAC;QACb,KAAK,IAAI;YACP,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAE9B,KAAK,MAAM;YACT,OAAO,UAAU,EAAE,CAAC;QAEtB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhC;YACE,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,YAAY,OAAO,qBAAqB;aACnD,CAAC;IACN,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;qBAcE,CAAC;IAEpB,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,QAAQ;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,MAAM,CAAC,EAAU;IACxB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACnC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAuB;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;IAE1C,2BAA2B;IAC3B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,yCAAyC;IACzC,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,QAAQ;QACnC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;QAC7B,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,MAAM,YAAY,EAAE,CAAC;IAEzB,IAAI,UAAU,GAAG,gBAAgB,CAAC;IAClC,UAAU,IAAI,iBAAiB,YAAY,MAAM,CAAC;IAClD,UAAU,IAAI,cAAc,WAAW,IAAI,CAAC;IAC5C,UAAU,IAAI,cAAc,OAAO,CAAC,QAAQ,IAAI,CAAC;IAEjD,IAAI,KAAK,EAAE,CAAC;QACV,UAAU,IAAI,eAAe,CAAC;QAC9B,UAAU,IAAI,UAAU,KAAK,CAAC,YAAY,IAAI,CAAC;QAC/C,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS;gBAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;gBACxD,CAAC,CAAC,CAAC,CAAC;YACN,UAAU,IAAI,YAAY,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,UAAU,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,YAAY,IAAI,CAAC;YAC5E,CAAC;YACD,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,UAAU,IAAI,qBAAqB,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,UAAU,IAAI,SAAS,KAAK,CAAC,KAAK,IAAI,CAAC;QACzC,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,UAAU,IAAI,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;QAChF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,UAAU,IAAI,cAAc,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,UAAU;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAuB;IAC1C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,mCAAmC;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,eAAe;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAuB;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAEzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,2DAA2D;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAG,gBAAgB,KAAK,CAAC,MAAM,QAAQ,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,SAAS,IAAI,GAAG,UAAU,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,SAAS,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QACvF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS,IAAI,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9E,CAAC;QACD,SAAS,IAAI,IAAI,CAAC;IACpB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,yBAAyB;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAuB;IAC5C,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,eAAe;SAC1B,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,gBAAgB;IAChB,OAAO;QACL,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,wCAAwC;KACnD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,SAAiB,EACjB,YAAoB,GAAG;IAEvB,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,UAAU,GAAG,SAAS,IAAI,SAAS,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,SAAiB;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9D,OAAO,eAAe,UAAU,SAAS;QACvC,WAAW,UAAU,CAAC,cAAc,EAAE,MAAM,SAAS,CAAC,cAAc,EAAE,cAAc;QACpF,SAAS;QACT,iCAAiC;QACjC,0BAA0B,CAAC;AAC/B,CAAC"}

package/dist/config-schema.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const envSchema: z.ZodObject<{
+    ANTHROPIC_API_KEY: z.ZodOptional<z.ZodString>;
+    ANTHROPIC_BASE_URL: z.ZodOptional<z.ZodString>;
+    ANTHROPIC_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+    AI_MODEL: z.ZodDefault<z.ZodString>;
+    FEISHU_APP_ID: z.ZodOptional<z.ZodString>;
+    FEISHU_APP_SECRET: z.ZodOptional<z.ZodString>;
+    BOT_NAME: z.ZodDefault<z.ZodString>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+        debug: "debug";
+    }>>;
+    TIMEZONE: z.ZodDefault<z.ZodString>;
+    AGENT_TIMEOUT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type EnvConfig = z.infer<typeof envSchema>;
+export declare function validateEnv(env: Record<string, string | undefined>): EnvConfig;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;iBAgBpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAO9E"}

package/dist/config-schema.js

@@ -0,0 +1,26 @@
+// src/config-schema.ts
+import { z } from 'zod';
+export const envSchema = z.object({
+    // AI API 配置
+    ANTHROPIC_API_KEY: z.string().optional(),
+    ANTHROPIC_BASE_URL: z.string().url().optional(),
+    ANTHROPIC_AUTH_TOKEN: z.string().optional(),
+    AI_MODEL: z.string().default('claude-4-5-sonnet-20250929'),
+    // 飞书配置
+    FEISHU_APP_ID: z.string().optional(),
+    FEISHU_APP_SECRET: z.string().optional(),
+    // 其他配置
+    BOT_NAME: z.string().default('FlashClaw'),
+    LOG_LEVEL: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    TIMEZONE: z.string().default('Asia/Shanghai'),
+    AGENT_TIMEOUT: z.coerce.number().default(300000),
+});
+export function validateEnv(env) {
+    const result = envSchema.safeParse(env);
+    if (!result.success) {
+        const errors = result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join('\n');
+        throw new Error(`配置校验失败:\n${errors}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,YAAY;IACZ,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC/C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC;IAE1D,OAAO;IACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAExC,OAAO;IACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,UAAU,WAAW,CAAC,GAAuC;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1G,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export declare const BOT_NAME: string;
+export declare const SCHEDULER_POLL_INTERVAL = 60000;
+export declare const IPC_POLL_INTERVAL = 1000;
+export declare const MOUNT_ALLOWLIST_PATH: string;
+export declare const STORE_DIR: string;
+export declare const GROUPS_DIR: string;
+export declare const DATA_DIR: string;
+export declare const MAIN_GROUP_FOLDER = "main";
+export declare const AGENT_TIMEOUT: number;
+export declare const TIMEZONE: string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,QAAQ,QAAsC,CAAC;AAG5D,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAkBtC,eAAO,MAAM,oBAAoB,QAAoD,CAAC;AACtF,eAAO,MAAM,SAAS,QAAsC,CAAC;AAC7D,eAAO,MAAM,UAAU,QAAuC,CAAC;AAC/D,eAAO,MAAM,QAAQ,QAAqC,CAAC;AAC3D,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAGxC,eAAO,MAAM,aAAa,QAAsD,CAAC;AAKjF,eAAO,MAAM,QAAQ,QAAqE,CAAC"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import path from 'path';
+import os from 'os';
+import dotenv from 'dotenv';
+// Load environment variables from .env file
+dotenv.config();
+// ==================== Bot Configuration ====================
+// Bot name for display in messages (customizable via .env)
+export const BOT_NAME = process.env.BOT_NAME || 'FlashClaw';
+// ==================== Polling Intervals ====================
+export const SCHEDULER_POLL_INTERVAL = 60000;
+export const IPC_POLL_INTERVAL = 1000;
+// ==================== Paths ====================
+const PROJECT_ROOT = process.cwd();
+function getHomeDir() {
+    return process.env.HOME || os.homedir() || '/home/user';
+}
+function getConfigDir() {
+    const IS_WINDOWS = process.platform === 'win32';
+    if (IS_WINDOWS) {
+        return path.join(process.env.APPDATA || path.join(getHomeDir(), 'AppData', 'Roaming'), 'flashclaw');
+    }
+    return path.join(getHomeDir(), '.config', 'flashclaw');
+}
+// Mount security: allowlist stored OUTSIDE project root
+export const MOUNT_ALLOWLIST_PATH = path.join(getConfigDir(), 'mount-allowlist.json');
+export const STORE_DIR = path.resolve(PROJECT_ROOT, 'store');
+export const GROUPS_DIR = path.resolve(PROJECT_ROOT, 'groups');
+export const DATA_DIR = path.resolve(PROJECT_ROOT, 'data');
+export const MAIN_GROUP_FOLDER = 'main';
+// ==================== Agent Configuration ====================
+export const AGENT_TIMEOUT = parseInt(process.env.AGENT_TIMEOUT || '300000', 10); // 5 minutes default
+// ==================== Timezone ====================
+// Timezone for scheduled tasks (cron expressions, etc.)
+// Uses system timezone by default
+export const TIMEZONE = process.env.TZ || Intl.DateTimeFormat().resolvedOptions().timeZone;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,4CAA4C;AAC5C,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,8DAA8D;AAC9D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,WAAW,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,kDAAkD;AAClD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAEnC,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,YAAY,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,sBAAsB,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB;AAEtG,qDAAqD;AACrD,wDAAwD;AACxD,kCAAkC;AAClC,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC"}

package/dist/core/api-client.d.ts

@@ -0,0 +1,236 @@
+/**
+ * FlashClaw API 客户端
+ * 直接调用 Anthropic API，支持 MiniMax 等兼容 API
+ *
+ * 特性：
+ * - 支持多模型提供商
+ * - 工具调用 (Tool Use)
+ * - 流式响应 (Streaming)
+ * - 错误重试
+ */
+import Anthropic from '@anthropic-ai/sdk';
+/**
+ * API 配置
+ */
+export interface ApiConfig {
+    /** API 密钥 */
+    apiKey: string;
+    /** 自定义 API 端点（支持 MiniMax 等兼容 API） */
+    baseURL?: string;
+    /** 模型名称 */
+    model?: string;
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 请求超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 图片内容块
+ */
+export interface ImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+        data: string;
+    };
+}
+/**
+ * 文本内容块
+ */
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+/**
+ * 消息内容类型
+ */
+export type MessageContent = string | (TextBlock | ImageBlock)[];
+/**
+ * 聊天消息
+ */
+export interface ChatMessage {
+    /** 角色：user 或 assistant */
+    role: 'user' | 'assistant';
+    /** 消息内容 - 可以是纯文本或包含图片的数组 */
+    content: MessageContent;
+}
+/**
+ * 工具定义 Schema
+ */
+export interface ToolSchema {
+    /** 工具名称 */
+    name: string;
+    /** 工具描述 */
+    description: string;
+    /** 参数 JSON Schema */
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * 聊天选项
+ */
+export interface ChatOptions {
+    /** 系统提示词 */
+    system?: string;
+    /** 可用工具列表 */
+    tools?: ToolSchema[];
+    /** 最大输出 token 数 */
+    maxTokens?: number;
+    /** 温度参数 (0-1) */
+    temperature?: number;
+    /** 停止序列 */
+    stopSequences?: string[];
+}
+/**
+ * 流式事件类型
+ */
+export type StreamEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'done';
+    message: Anthropic.Message;
+};
+/**
+ * 工具执行器类型
+ */
+export type ToolExecutor = (name: string, params: unknown) => Promise<unknown>;
+/**
+ * FlashClaw API 客户端
+ *
+ * @example
+ * ```typescript
+ * const client = new ApiClient({
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ * });
+ *
+ * const response = await client.chat([
+ *   { role: 'user', content: '你好！' }
+ * ]);
+ *
+ * console.log(response.content[0]);
+ * ```
+ */
+export declare class ApiClient {
+    private client;
+    private model;
+    private maxRetries;
+    private timeout;
+    constructor(config: ApiConfig);
+    /**
+     * 发送消息并获取回复
+     *
+     * @param messages - 聊天消息历史
+     * @param options - 聊天选项
+     * @returns API 响应消息
+     *
+     * @example
+     * ```typescript
+     * const response = await client.chat(
+     *   [{ role: 'user', content: '解释量子计算' }],
+     *   { system: '你是一位物理学教授', maxTokens: 1024 }
+     * );
+     * ```
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<Anthropic.Message>;
+    /**
+     * 流式发送消息
+     *
+     * @param messages - 聊天消息历史
+     * @param options - 聊天选项
+     * @returns 异步迭代器，产生流式事件
+     *
+     * @example
+     * ```typescript
+     * for await (const event of client.chatStream(messages)) {
+     *   if (event.type === 'text') {
+     *     process.stdout.write(event.text);
+     *   }
+     * }
+     * ```
+     */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<StreamEvent>;
+    /**
+     * 处理工具调用
+     * 自动执行工具并获取最终回复
+     *
+     * @param response - 包含工具调用的 API 响应
+     * @param messages - 原始消息历史
+     * @param executeTool - 工具执行函数
+     * @param options - 聊天选项（用于后续请求）
+     * @returns 最终文本回复
+     *
+     * @example
+     * ```typescript
+     * const response = await client.chat(messages, { tools });
+     *
+     * if (response.stop_reason === 'tool_use') {
+     *   const finalText = await client.handleToolUse(
+     *     response,
+     *     messages,
+     *     async (name, params) => {
+     *       // 执行工具逻辑
+     *       return { result: 'done' };
+     *     }
+     *   );
+     * }
+     * ```
+     */
+    handleToolUse(response: Anthropic.Message, messages: ChatMessage[], executeTool: ToolExecutor, options?: ChatOptions): Promise<string>;
+    /**
+     * 从响应中提取文本内容
+     *
+     * @param response - API 响应
+     * @returns 文本内容
+     */
+    extractText(response: Anthropic.Message): string;
+    /**
+     * 获取当前使用的模型
+     */
+    getModel(): string;
+    /**
+     * 设置模型
+     *
+     * @param model - 模型名称
+     */
+    setModel(model: string): void;
+    /**
+     * 判断错误是否可重试
+     */
+    private isRetryableError;
+    /**
+     * 延迟函数
+     */
+    private sleep;
+}
+/**
+ * 创建默认 API 客户端
+ * 从环境变量读取配置
+ *
+ * @returns API 客户端实例，如果配置缺失则返回 null
+ */
+export declare function createApiClient(): ApiClient | null;
+declare global {
+    var __flashclaw_api_client: ApiClient | null | undefined;
+}
+/**
+ * 获取全局 API 客户端单例
+ * 确保 jiti 热加载的插件访问同一实例
+ *
+ * @returns API 客户端实例，如果配置缺失则返回 null
+ */
+export declare function getApiClient(): ApiClient | null;
+/**
+ * 重置 API 客户端（用于配置变更后重新初始化）
+ */
+export declare function resetApiClient(): void;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"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"}