flashclaw 1.0.0

package/dist/task-scheduler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * FlashClaw 任务调度器
+ *
+ * 功能特性：
+ * 1. 精确定时器 - 按需唤醒，而不是固定轮询
+ * 2. 并发控制 - 限制同时执行的任务数
+ * 3. 超时保护 - 防止任务卡死阻塞调度
+ * 4. 重试机制 - 失败任务自动重试（指数退避）
+ */
+import { RegisteredGroup } from './types.js';
+export interface SchedulerDependencies {
+    sendMessage: (jid: string, text: string) => Promise<void>;
+    registeredGroups: () => Record<string, RegisteredGroup>;
+    getSessions: () => Record<string, string>;
+}
+interface SchedulerState {
+    timer: NodeJS.Timeout | null;
+    running: boolean;
+    deps: SchedulerDependencies | null;
+}
+declare global {
+    var __flashclaw_scheduler_state: SchedulerState | undefined;
+}
+/**
+ * 启动调度器
+ */
+export declare function startScheduler(deps: SchedulerDependencies): void;
+/**
+ * 停止调度器
+ */
+export declare function stopScheduler(): void;
+/**
+ * 立即唤醒调度器
+ * 用于创建新任务后立即检查是否需要执行
+ */
+export declare function wake(): void;
+/**
+ * 获取调度器状态
+ */
+export declare function getSchedulerStatus(): {
+    running: boolean;
+    nextWakeTime: number | null;
+    activeTasks: number;
+};
+export declare function startSchedulerLoop(deps: SchedulerDependencies): void;
+export {};
+//# sourceMappingURL=task-scheduler.d.ts.map

package/dist/task-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scheduler.d.ts","sourceRoot":"","sources":["../src/task-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,OAAO,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AA0B5D,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,gBAAgB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACpC;AAYD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,2BAA2B,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7D;AAuTD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAIhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAQpC;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB,CASA;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAEpE"}

package/dist/task-scheduler.js

@@ -0,0 +1,331 @@
+/**
+ * FlashClaw 任务调度器
+ *
+ * 功能特性：
+ * 1. 精确定时器 - 按需唤醒，而不是固定轮询
+ * 2. 并发控制 - 限制同时执行的任务数
+ * 3. 超时保护 - 防止任务卡死阻塞调度
+ * 4. 重试机制 - 失败任务自动重试（指数退避）
+ */
+import fs from 'fs';
+import path from 'path';
+import pLimit from 'p-limit';
+import { CronExpressionParser } from 'cron-parser';
+import { getDueTasks, updateTaskAfterRun, logTaskRun, getTaskById, getAllTasks, getNextWakeTime, updateTaskRetry, resetTaskRetry, updateTask } from './db.js';
+import { GROUPS_DIR, MAIN_GROUP_FOLDER, TIMEZONE } from './config.js';
+import { runAgent, writeTasksSnapshot } from './agent-runner.js';
+import { createLogger } from './logger.js';
+const logger = createLogger('TaskScheduler');
+// ==================== 配置常量 ====================
+/** 最大并发任务数 */
+const MAX_CONCURRENT_TASKS = 3;
+/** 默认任务超时时间（5 分钟） */
+const DEFAULT_TASK_TIMEOUT_MS = 5 * 60 * 1000;
+/** 最大定时器延迟（避免 Node.js 的 32 位整数溢出） */
+const MAX_TIMEOUT_MS = 2 ** 31 - 1;
+/** 重试基础延迟（1 分钟） */
+const RETRY_BASE_DELAY_MS = 60 * 1000;
+/** 最大重试延迟（1 小时） */
+const MAX_RETRY_DELAY_MS = 60 * 60 * 1000;
+function getState() {
+    if (!global.__flashclaw_scheduler_state) {
+        global.__flashclaw_scheduler_state = {
+            timer: null,
+            running: false,
+            deps: null
+        };
+    }
+    return global.__flashclaw_scheduler_state;
+}
+// 注意：所有对 state 的访问都应该使用 getState() 函数，
+// 以确保 jiti 动态加载的模块也能访问到正确的状态
+// 并发限制器
+const taskLimit = pLimit(MAX_CONCURRENT_TASKS);
+// ==================== 精确定时器 ====================
+/**
+ * 设置精确定时器
+ * 计算下一个任务的执行时间，并设置 setTimeout
+ */
+function armTimer() {
+    // 清除旧定时器
+    const state = getState();
+    if (state.timer) {
+        clearTimeout(state.timer);
+        state.timer = null;
+    }
+    // 获取下一个唤醒时间
+    const nextAt = getNextWakeTime();
+    if (!nextAt) {
+        logger.debug('没有待执行的任务，定时器空闲');
+        return;
+    }
+    // 计算延迟时间
+    const now = Date.now();
+    const delay = Math.max(nextAt - now, 0);
+    // 限制最大延迟，避免 32 位整数溢出
+    const clampedDelay = Math.min(delay, MAX_TIMEOUT_MS);
+    logger.debug({
+        nextAt: new Date(nextAt).toISOString(),
+        delayMs: clampedDelay
+    }, '设置定时器');
+    const currentState = getState();
+    currentState.timer = setTimeout(() => {
+        void onTimer().catch((err) => {
+            logger.error({ err: String(err) }, '定时器触发失败');
+        });
+    }, clampedDelay);
+    // 允许进程在没有其他活动时退出
+    currentState.timer.unref?.();
+}
+/**
+ * 定时器触发时的处理函数
+ */
+async function onTimer() {
+    if (getState().running) {
+        logger.debug('调度器正在运行，跳过本次触发');
+        return;
+    }
+    getState().running = true;
+    try {
+        await runDueTasks();
+    }
+    finally {
+        getState().running = false;
+        armTimer();
+    }
+}
+/**
+ * 执行所有到期任务
+ */
+async function runDueTasks() {
+    if (!getState().deps) {
+        logger.error('调度器依赖未初始化');
+        return;
+    }
+    const dueTasks = getDueTasks();
+    if (dueTasks.length === 0) {
+        return;
+    }
+    logger.info({ count: dueTasks.length }, '⚡ 发现到期任务');
+    // 使用并发限制器执行任务
+    const promises = dueTasks.map(task => taskLimit(async () => {
+        // 双重检查任务状态
+        const currentTask = getTaskById(task.id);
+        if (!currentTask || currentTask.status !== 'active') {
+            logger.debug({ taskId: task.id }, '任务状态已变更，跳过执行');
+            return;
+        }
+        await executeTask(currentTask);
+    }));
+    await Promise.all(promises);
+}
+// ==================== 任务执行 ====================
+/**
+ * 执行单个任务（带超时和重试）
+ */
+async function executeTask(task) {
+    const startTime = Date.now();
+    const deps = getState().deps;
+    logger.info({ taskId: task.id, group: task.group_folder }, '⚡ 开始执行任务');
+    // 执行任务
+    const result = await runTaskWithTimeout(task, deps);
+    // 记录运行日志
+    logTaskRun({
+        task_id: task.id,
+        run_at: new Date().toISOString(),
+        duration_ms: result.durationMs,
+        status: result.success ? 'success' : 'error',
+        result: result.result,
+        error: result.error
+    });
+    if (result.success) {
+        // 成功：重置重试计数，计算下次运行时间
+        resetTaskRetry(task.id);
+        const nextRun = calculateNextRun(task);
+        const resultSummary = result.result ? result.result.slice(0, 200) : 'Completed';
+        updateTaskAfterRun(task.id, nextRun, resultSummary);
+        logger.info({ taskId: task.id, durationMs: result.durationMs }, '⚡ 任务执行成功');
+    }
+    else {
+        // 失败：处理重试逻辑
+        await handleTaskFailure(task, result.error || 'Unknown error');
+    }
+}
+/**
+ * 带超时保护的任务执行
+ */
+async function runTaskWithTimeout(task, deps) {
+    const startTime = Date.now();
+    const timeoutMs = task.timeout_ms || DEFAULT_TASK_TIMEOUT_MS;
+    // 创建超时 Promise
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new Error(`任务执行超时 (${timeoutMs}ms)`));
+        }, timeoutMs);
+    });
+    try {
+        // 实际执行任务
+        const resultPromise = runTaskCore(task, deps);
+        const result = await Promise.race([resultPromise, timeoutPromise]);
+        return {
+            success: true,
+            result: result,
+            error: null,
+            durationMs: Date.now() - startTime
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            result: null,
+            error: err instanceof Error ? err.message : String(err),
+            durationMs: Date.now() - startTime
+        };
+    }
+}
+/**
+ * 任务执行核心逻辑
+ */
+async function runTaskCore(task, deps) {
+    const groupDir = path.join(GROUPS_DIR, task.group_folder);
+    fs.mkdirSync(groupDir, { recursive: true });
+    const groups = deps.registeredGroups();
+    const group = Object.values(groups).find(g => g.folder === task.group_folder);
+    if (!group) {
+        throw new Error(`Group not found: ${task.group_folder}`);
+    }
+    // 更新任务快照供 Agent 读取
+    const isMain = task.group_folder === MAIN_GROUP_FOLDER;
+    const tasks = getAllTasks();
+    writeTasksSnapshot(task.group_folder, isMain, tasks.map(t => ({
+        id: t.id,
+        groupFolder: t.group_folder,
+        prompt: t.prompt,
+        schedule_type: t.schedule_type,
+        schedule_value: t.schedule_value,
+        status: t.status,
+        next_run: t.next_run
+    })));
+    // 获取会话 ID
+    const sessions = deps.getSessions();
+    const sessionId = task.context_mode === 'group' ? sessions[task.group_folder] : undefined;
+    // 执行 Agent
+    const output = await runAgent(group, {
+        prompt: task.prompt,
+        sessionId,
+        groupFolder: task.group_folder,
+        chatJid: task.chat_jid,
+        isMain,
+        isScheduledTask: true
+    });
+    if (output.status === 'error') {
+        throw new Error(output.error || 'Agent execution failed');
+    }
+    return output.result || 'Completed';
+}
+// ==================== 重试机制 ====================
+/**
+ * 处理任务失败（重试逻辑）
+ */
+async function handleTaskFailure(task, error) {
+    const maxRetries = task.max_retries ?? 3;
+    const currentRetry = (task.retry_count ?? 0) + 1;
+    logger.warn({
+        taskId: task.id,
+        error,
+        retryCount: currentRetry,
+        maxRetries
+    }, '任务执行失败');
+    if (currentRetry >= maxRetries) {
+        // 达到最大重试次数
+        logger.error({ taskId: task.id, retryCount: currentRetry }, '任务达到最大重试次数，标记为失败');
+        // 对于 once 类型任务，标记为 completed（已完成但失败）
+        if (task.schedule_type === 'once') {
+            updateTask(task.id, { status: 'completed' });
+            updateTaskAfterRun(task.id, null, `Error after ${currentRetry} retries: ${error}`);
+        }
+        else {
+            // 对于重复任务，重置重试计数并调度下一次正常执行
+            resetTaskRetry(task.id);
+            const nextRun = calculateNextRun(task);
+            updateTaskAfterRun(task.id, nextRun, `Error: ${error}`);
+        }
+        return;
+    }
+    // 计算重试延迟（指数退避）
+    const retryDelay = Math.min(RETRY_BASE_DELAY_MS * Math.pow(2, currentRetry - 1), MAX_RETRY_DELAY_MS);
+    const nextRetryTime = new Date(Date.now() + retryDelay).toISOString();
+    logger.info({
+        taskId: task.id,
+        retryIn: retryDelay / 1000 + 's',
+        nextRetry: nextRetryTime
+    }, '安排任务重试');
+    // 更新任务重试信息
+    updateTaskRetry(task.id, currentRetry, nextRetryTime);
+}
+/**
+ * 计算下次运行时间
+ */
+function calculateNextRun(task) {
+    switch (task.schedule_type) {
+        case 'cron': {
+            const interval = CronExpressionParser.parse(task.schedule_value, { tz: TIMEZONE });
+            return interval.next().toISOString();
+        }
+        case 'interval': {
+            const ms = parseInt(task.schedule_value, 10);
+            return new Date(Date.now() + ms).toISOString();
+        }
+        case 'once':
+            // 一次性任务执行后没有下次
+            return null;
+        default:
+            return null;
+    }
+}
+// ==================== 公开 API ====================
+/**
+ * 启动调度器
+ */
+export function startScheduler(deps) {
+    getState().deps = deps;
+    logger.info('⚡ 任务调度器已启动');
+    armTimer();
+}
+/**
+ * 停止调度器
+ */
+export function stopScheduler() {
+    const state = getState();
+    if (state.timer) {
+        clearTimeout(state.timer);
+        state.timer = null;
+    }
+    state.deps = null;
+    logger.info('⚡ 任务调度器已停止');
+}
+/**
+ * 立即唤醒调度器
+ * 用于创建新任务后立即检查是否需要执行
+ */
+export function wake() {
+    logger.debug('收到唤醒信号，重新计算定时器');
+    armTimer();
+}
+/**
+ * 获取调度器状态
+ */
+export function getSchedulerStatus() {
+    const nextWakeTime = getNextWakeTime();
+    const dueTasks = getDueTasks();
+    return {
+        running: getState().running,
+        nextWakeTime,
+        activeTasks: dueTasks.length
+    };
+}
+// 兼容旧 API
+export function startSchedulerLoop(deps) {
+    startScheduler(deps);
+}
+//# sourceMappingURL=task-scheduler.js.map

package/dist/task-scheduler.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent 配置
+ */
+export interface AgentConfig {
+    timeout?: number;
+    env?: Record<string, string>;
+}
+/**
+ * 注册的群组
+ */
+export interface RegisteredGroup {
+    name: string;
+    folder: string;
+    trigger: string;
+    added_at: string;
+    agentConfig?: AgentConfig;
+}
+export interface Session {
+    [folder: string]: string;
+}
+export interface NewMessage {
+    id: string;
+    chat_jid: string;
+    sender: string;
+    sender_name: string;
+    content: string;
+    timestamp: string;
+}
+export interface ScheduledTask {
+    id: string;
+    group_folder: string;
+    chat_jid: string;
+    prompt: string;
+    schedule_type: 'cron' | 'interval' | 'once';
+    schedule_value: string;
+    context_mode: 'group' | 'isolated';
+    next_run: string | null;
+    last_run: string | null;
+    last_result: string | null;
+    status: 'active' | 'paused' | 'completed';
+    created_at: string;
+    /** 当前重试次数 */
+    retry_count: number;
+    /** 最大重试次数（默认 3） */
+    max_retries: number;
+    /** 任务执行超时时间（毫秒，默认 300000） */
+    timeout_ms?: number;
+}
+export interface TaskRunLog {
+    task_id: string;
+    run_at: string;
+    duration_ms: number;
+    status: 'success' | 'error';
+    result: string | null;
+    error: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,GAAG,UAAU,CAAC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/env-substitute.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 环境变量替换工具
+ *
+ * 支持语法:
+ * - ${VAR} - 从环境变量获取值
+ * - ${VAR:-default} - 有默认值的环境变量
+ *
+ * 递归处理对象和数组中的字符串值
+ */
+/**
+ * 替换字符串中的环境变量引用
+ *
+ * @param str - 包含环境变量引用的字符串
+ * @param env - 环境变量对象 (默认使用 process.env)
+ * @returns 替换后的字符串
+ *
+ * @example
+ * substituteEnvVars('${HOME}/config') // '/home/user/config'
+ * substituteEnvVars('${PORT:-3000}')  // '3000' (如果 PORT 未定义)
+ * substituteEnvVars('${API_KEY}')     // '' (如果未定义且无默认值)
+ */
+export declare function substituteEnvVars(str: string, env?: Record<string, string | undefined>): string;
+/**
+ * 检查字符串是否包含环境变量引用
+ *
+ * @param str - 要检查的字符串
+ * @returns 是否包含环境变量引用
+ */
+export declare function hasEnvVars(str: string): boolean;
+/**
+ * 递归替换对象/数组中所有字符串的环境变量
+ *
+ * @param value - 要处理的值 (任意类型)
+ * @param env - 环境变量对象 (默认使用 process.env)
+ * @returns 处理后的新值 (不修改原对象)
+ *
+ * @example
+ * substituteEnvVarsDeep({
+ *   apiUrl: '${API_URL:-http://localhost:3000}',
+ *   keys: ['${KEY1}', '${KEY2}'],
+ *   nested: { secret: '${SECRET}' }
+ * })
+ */
+export declare function substituteEnvVarsDeep<T>(value: T, env?: Record<string, string | undefined>): T;
+/**
+ * 提取字符串中引用的所有环境变量名称
+ *
+ * @param str - 要分析的字符串
+ * @returns 环境变量名称数组 (去重)
+ *
+ * @example
+ * extractEnvVarNames('${API_URL} and ${API_KEY:-default}')
+ * // ['API_URL', 'API_KEY']
+ */
+export declare function extractEnvVarNames(str: string): string[];
+/**
+ * 递归提取对象/数组中所有引用的环境变量名称
+ *
+ * @param value - 要分析的值
+ * @returns 环境变量名称数组 (去重)
+ */
+export declare function extractEnvVarNamesDeep(value: unknown): string[];
+//# sourceMappingURL=env-substitute.d.ts.map

package/dist/utils/env-substitute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-substitute.d.ts","sourceRoot":"","sources":["../../src/utils/env-substitute.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EACR,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,CAAC,CA2BH;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAmB/D"}

package/dist/utils/env-substitute.js

@@ -0,0 +1,133 @@
+/**
+ * 环境变量替换工具
+ *
+ * 支持语法:
+ * - ${VAR} - 从环境变量获取值
+ * - ${VAR:-default} - 有默认值的环境变量
+ *
+ * 递归处理对象和数组中的字符串值
+ */
+/**
+ * 环境变量替换的正则表达式
+ * 匹配 ${VAR} 或 ${VAR:-default} 格式
+ */
+const ENV_VAR_PATTERN = /\$\{([^}:]+)(?::-([^}]*))?\}/g;
+/**
+ * 替换字符串中的环境变量引用
+ *
+ * @param str - 包含环境变量引用的字符串
+ * @param env - 环境变量对象 (默认使用 process.env)
+ * @returns 替换后的字符串
+ *
+ * @example
+ * substituteEnvVars('${HOME}/config') // '/home/user/config'
+ * substituteEnvVars('${PORT:-3000}')  // '3000' (如果 PORT 未定义)
+ * substituteEnvVars('${API_KEY}')     // '' (如果未定义且无默认值)
+ */
+export function substituteEnvVars(str, env = process.env) {
+    return str.replace(ENV_VAR_PATTERN, (match, varName, defaultValue) => {
+        const value = env[varName];
+        // 如果环境变量存在且不为空字符串，使用它
+        if (value !== undefined && value !== '') {
+            return value;
+        }
+        // 否则使用默认值，如果没有默认值则返回空字符串
+        return defaultValue !== undefined ? defaultValue : '';
+    });
+}
+/**
+ * 检查字符串是否包含环境变量引用
+ *
+ * @param str - 要检查的字符串
+ * @returns 是否包含环境变量引用
+ */
+export function hasEnvVars(str) {
+    ENV_VAR_PATTERN.lastIndex = 0; // 重置正则状态
+    return ENV_VAR_PATTERN.test(str);
+}
+/**
+ * 递归替换对象/数组中所有字符串的环境变量
+ *
+ * @param value - 要处理的值 (任意类型)
+ * @param env - 环境变量对象 (默认使用 process.env)
+ * @returns 处理后的新值 (不修改原对象)
+ *
+ * @example
+ * substituteEnvVarsDeep({
+ *   apiUrl: '${API_URL:-http://localhost:3000}',
+ *   keys: ['${KEY1}', '${KEY2}'],
+ *   nested: { secret: '${SECRET}' }
+ * })
+ */
+export function substituteEnvVarsDeep(value, env = process.env) {
+    // 处理 null 和 undefined
+    if (value === null || value === undefined) {
+        return value;
+    }
+    // 处理字符串
+    if (typeof value === 'string') {
+        return substituteEnvVars(value, env);
+    }
+    // 处理数组
+    if (Array.isArray(value)) {
+        return value.map((item) => substituteEnvVarsDeep(item, env));
+    }
+    // 处理普通对象
+    if (typeof value === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = substituteEnvVarsDeep(val, env);
+        }
+        return result;
+    }
+    // 其他类型 (number, boolean, etc.) 直接返回
+    return value;
+}
+/**
+ * 提取字符串中引用的所有环境变量名称
+ *
+ * @param str - 要分析的字符串
+ * @returns 环境变量名称数组 (去重)
+ *
+ * @example
+ * extractEnvVarNames('${API_URL} and ${API_KEY:-default}')
+ * // ['API_URL', 'API_KEY']
+ */
+export function extractEnvVarNames(str) {
+    const names = [];
+    const regex = new RegExp(ENV_VAR_PATTERN);
+    let match;
+    while ((match = regex.exec(str)) !== null) {
+        if (!names.includes(match[1])) {
+            names.push(match[1]);
+        }
+    }
+    return names;
+}
+/**
+ * 递归提取对象/数组中所有引用的环境变量名称
+ *
+ * @param value - 要分析的值
+ * @returns 环境变量名称数组 (去重)
+ */
+export function extractEnvVarNamesDeep(value) {
+    const names = [];
+    function collect(val) {
+        if (typeof val === 'string') {
+            for (const name of extractEnvVarNames(val)) {
+                if (!names.includes(name)) {
+                    names.push(name);
+                }
+            }
+        }
+        else if (Array.isArray(val)) {
+            val.forEach(collect);
+        }
+        else if (val !== null && typeof val === 'object') {
+            Object.values(val).forEach(collect);
+        }
+    }
+    collect(value);
+    return names;
+}
+//# sourceMappingURL=env-substitute.js.map

package/dist/utils/env-substitute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-substitute.js","sourceRoot":"","sources":["../../src/utils/env-substitute.ts"],"names":[],"mappings":"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"}