@lingxiao-office/sdk 1.0.0

package/dist/core/LocalLlmGatewayServer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LocalLlmGatewayServer —— 本地 LLM 网关的进程绑定式随机端口监听器。
+ *
+ * 设计目标（v2 重构）：
+ * - **进程绑定**：每个 lingxiao 进程启动自己的网关监听器，随进程生灭。
+ *   不再共享复用——消除了"旧进程事件循环已死但进程 sleeping 不退出，
+ *   新进程复用死网关导致全部请求超时"的僵尸问题。
+ * - **随机端口**：port=0 让 OS 分配可用端口，避免固定端口的 EADDRINUSE 漂移问题。
+ *   与 Web UI 端口随机化一致。
+ * - **运行时端点注入**：绑定后通过 setRuntimeGatewayEndpoint() 把实际 host:port
+ *   写入 LocalLlmGateway 模块，resolveLocalLlmGateway() 优先读取运行时端点，
+ *   确保 env 注入和 prompt 生成都用正确的地址。
+ * - 不再写 gateway.json 归属文件——无共享即无竞态。
+ *
+ * 路由处理器（callLocalGateway）用网关配置模型、不绑定会话，故复用 deps 即可，无需 IPC。
+ */
+import { type GatewayDeps } from '../web-server/LocalLlmGatewayRoutes.js';
+export interface LocalLlmGatewayEndpoint {
+    host: string;
+    port: number;
+    origin: string;
+    openaiBaseUrl: string;
+    anthropicBaseUrl: string;
+}
+export interface LocalLlmGatewayHandle extends LocalLlmGatewayEndpoint {
+    /**
+     * 关闭本进程绑定的监听器（幂等）。
+     * 进程退出由 cleanup 自动调用；测试可显式调用释放端口。
+     */
+    close(): Promise<void>;
+}
+/**
+ * 启动本地 LLM 网关的进程绑定式随机端口监听器。
+ *
+ * @returns 监听句柄（含 close()）；网关未启用时返回 null（无监听/路由）。
+ */
+export declare function startLocalLlmGatewayServer(deps: GatewayDeps): Promise<LocalLlmGatewayHandle | null>;
+//# sourceMappingURL=LocalLlmGatewayServer.d.ts.map

package/dist/core/LocalLlmGatewayServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLlmGatewayServer.d.ts","sourceRoot":"","sources":["../../src/core/LocalLlmGatewayServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAIzG,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAaD;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAgDzG"}

package/dist/core/LocalLlmGatewayServer.js

@@ -0,0 +1,85 @@
+/**
+ * LocalLlmGatewayServer —— 本地 LLM 网关的进程绑定式随机端口监听器。
+ *
+ * 设计目标（v2 重构）：
+ * - **进程绑定**：每个 lingxiao 进程启动自己的网关监听器，随进程生灭。
+ *   不再共享复用——消除了"旧进程事件循环已死但进程 sleeping 不退出，
+ *   新进程复用死网关导致全部请求超时"的僵尸问题。
+ * - **随机端口**：port=0 让 OS 分配可用端口，避免固定端口的 EADDRINUSE 漂移问题。
+ *   与 Web UI 端口随机化一致。
+ * - **运行时端点注入**：绑定后通过 setRuntimeGatewayEndpoint() 把实际 host:port
+ *   写入 LocalLlmGateway 模块，resolveLocalLlmGateway() 优先读取运行时端点，
+ *   确保 env 注入和 prompt 生成都用正确的地址。
+ * - 不再写 gateway.json 归属文件——无共享即无竞态。
+ *
+ * 路由处理器（callLocalGateway）用网关配置模型、不绑定会话，故复用 deps 即可，无需 IPC。
+ */
+import Fastify from 'fastify';
+import { getConfigValue } from '../config.js';
+import { registerCleanup } from './CleanupRegistry.js';
+import { registerLocalLlmGatewayRoutes } from '../web-server/LocalLlmGatewayRoutes.js';
+import { normalizeHost, readPositiveInt, setRuntimeGatewayEndpoint, clearRuntimeGatewayEndpoint } from './LocalLlmGateway.js';
+import { coreLogger } from './Log.js';
+function endpointOf(host, port) {
+    const origin = `http://${host}:${port}`;
+    return {
+        host,
+        port,
+        origin,
+        openaiBaseUrl: `${origin}/llm/openai/v1`,
+        anthropicBaseUrl: `${origin}/llm/anthropic`,
+    };
+}
+/**
+ * 启动本地 LLM 网关的进程绑定式随机端口监听器。
+ *
+ * @returns 监听句柄（含 close()）；网关未启用时返回 null（无监听/路由）。
+ */
+export async function startLocalLlmGatewayServer(deps) {
+    if (getConfigValue('llm_gateway.enabled') !== true)
+        return null;
+    const host = normalizeHost(String(getConfigValue('llm_gateway.host') || '127.0.0.1'));
+    // port=0：让 OS 分配随机可用端口，与 Web UI 端口随机化一致。
+    // 配置的 llm_gateway.port 仅作"首选端口"尝试，失败则随机回退。
+    const preferredPort = readPositiveInt('llm_gateway.port', 62000);
+    const gateway = Fastify({ logger: false });
+    registerLocalLlmGatewayRoutes(gateway, deps);
+    let actualPort;
+    try {
+        // 先尝试配置的首选端口，EADDRINUSE 则回退到随机端口（port=0）
+        await gateway.listen({ host, port: preferredPort });
+        actualPort = preferredPort;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'EADDRINUSE') {
+            // 首选端口被占用（可能是上一个进程还没完全释放，或被其他程序占用）
+            // → 回退到随机端口，绝不 fail-loud
+            await gateway.listen({ host, port: 0 });
+            actualPort = gateway.server.address().port;
+        }
+        else {
+            throw err;
+        }
+    }
+    // 注入运行时端点：resolveLocalLlmGateway() 和 MemoryEmbedding 会读取
+    setRuntimeGatewayEndpoint(host, actualPort);
+    let closed = false;
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        clearRuntimeGatewayEndpoint();
+        try {
+            await gateway.close();
+        }
+        catch {
+            /* 关闭中，忽略 */
+        }
+    };
+    registerCleanup(close, 3.5);
+    const model = String(getConfigValue('llm_gateway.model') || '').trim();
+    coreLogger.info(`[LocalLlmGateway] 网关监听已启动: ${host}:${actualPort} (model: ${model || '<未配置>'}${actualPort !== preferredPort ? `, 首选端口 ${preferredPort} 被占用, 随机回退` : ''})`);
+    return { ...endpointOf(host, actualPort), close };
+}
+//# sourceMappingURL=LocalLlmGatewayServer.js.map

package/dist/core/LocalLlmGatewayServer.js.map

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

package/dist/core/Log.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Structured Logging System
+ *
+ * Features:
+ * - JSON lines file output (~/.lingxiao/logs/lingxiao.log)
+ * - Optional per-session log file (~/.lingxiao/logs/sessions/<sessionId>.log)
+ * - Human-readable console output (stderr)
+ * - Simple file rotation (10MB max, 2 backups) + optional daily-named files
+ * - In-memory ring buffer of recent entries (for crash report context)
+ * - Structured context fields
+ * - Environment variable override: LINGXIAO_LOG_LEVEL
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    setLevel(level: LogLevel): void;
+}
+/**
+ * 单条结构化日志记录。JSON lines 写入文件，同时进入内存环形缓冲。
+ * 导出供 CrashReporter / Diagnostics 等模块复用。
+ */
+export interface LogEntry {
+    ts: string;
+    level: LogLevel;
+    logger: string;
+    msg: string;
+    [key: string]: unknown;
+}
+/**
+ * 返回凌霄日志根目录绝对路径：~/.lingxiao/logs。
+ * 其他模块（CrashReporter / Diagnostics / LogMaintenance）统一以此为基准。
+ */
+export declare function getLogDir(): string;
+/** 主日志文件默认绝对路径：~/.lingxiao/logs/lingxiao.log */
+export declare function getMainLogFilePath(): string;
+/** session 日志文件绝对路径：~/.lingxiao/logs/sessions/<sessionId>.log */
+export declare function getSessionLogFilePath(sessionId: string): string;
+/**
+ * 返回内存中最近的日志条目（最旧→最新）。供崩溃报告采集上下文。
+ * @param n 返回最近 n 条；省略时返回缓冲区全部（最多 capacity 条）。
+ */
+export declare function getRecentLogEntries(n?: number): LogEntry[];
+/** 配置环形缓冲容量（默认 200）。<=0 时禁用缓冲。 */
+export declare function setRecentLogCapacity(capacity: number): void;
+declare class StructuredLogger implements Logger {
+    private name;
+    private level;
+    constructor(name: string);
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private emit;
+    debug(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+}
+export declare const leaderLogger: StructuredLogger;
+export declare const agentLogger: StructuredLogger;
+export declare const sessionLogger: StructuredLogger;
+export declare const coreLogger: StructuredLogger;
+export declare const serverLogger: StructuredLogger;
+export declare const configLogger: StructuredLogger;
+export declare const llmLogger: StructuredLogger;
+export declare function createLogger(name: string, level?: LogLevel): Logger;
+export interface LogConfig {
+    level?: LogLevel;
+    file?: string | boolean;
+    /**
+     * 是否启用 ConsoleSink（直接写 process.stderr）。默认 true。
+     * TUI 模式必须传 false：ConsoleSink 绕过 console.* 直写 stderr，会污染 Ink
+     * 的渲染区、打乱 log-update 的光标行数计算，导致状态行无法原地更新而反复刷屏。
+     */
+    console?: boolean;
+    /**
+     * 可选 session ID。提供时额外写一份 session 日志到
+     * ~/.lingxiao/logs/sessions/<sessionId>.log（主日志仍写 lingxiao.log）。
+     */
+    sessionId?: string;
+    /**
+     * 主日志是否按天命名（lingxiao-YYYY-MM-DD.log）。默认 false。
+     * 仅当 file 为 true（使用默认路径）时生效。
+     */
+    daily?: boolean;
+    /** 内存环形缓冲容量（最近 N 条），默认 200。 */
+    recentCapacity?: number;
+}
+export declare function configureLogging(config: LogConfig): void;
+export {};
+//# sourceMappingURL=Log.d.ts.map

package/dist/core/Log.d.ts.map

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

package/dist/core/Log.js

@@ -0,0 +1,249 @@
+/**
+ * Structured Logging System
+ *
+ * Features:
+ * - JSON lines file output (~/.lingxiao/logs/lingxiao.log)
+ * - Optional per-session log file (~/.lingxiao/logs/sessions/<sessionId>.log)
+ * - Human-readable console output (stderr)
+ * - Simple file rotation (10MB max, 2 backups) + optional daily-named files
+ * - In-memory ring buffer of recent entries (for crash report context)
+ * - Structured context fields
+ * - Environment variable override: LINGXIAO_LOG_LEVEL
+ */
+import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+const LEVEL_ORDER = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];
+// ─── Paths ───
+/**
+ * 返回凌霄日志根目录绝对路径：~/.lingxiao/logs。
+ * 其他模块（CrashReporter / Diagnostics / LogMaintenance）统一以此为基准。
+ */
+export function getLogDir() {
+    return join(homedir(), '.lingxiao', 'logs');
+}
+/** 主日志文件默认绝对路径：~/.lingxiao/logs/lingxiao.log */
+export function getMainLogFilePath() {
+    return join(getLogDir(), 'lingxiao.log');
+}
+/** session 日志文件绝对路径：~/.lingxiao/logs/sessions/<sessionId>.log */
+export function getSessionLogFilePath(sessionId) {
+    return join(getLogDir(), 'sessions', sanitizeSessionId(sessionId));
+}
+/** 防止 sessionId 含路径分隔符导致越界写入。 */
+function sanitizeSessionId(sessionId) {
+    const safe = sessionId.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 200) || 'unknown';
+    return `${safe}.log`;
+}
+// ─── Sinks ───
+class ConsoleSink {
+    write(entry) {
+        const { ts, level, logger, msg, ...rest } = entry;
+        const ctxStr = Object.keys(rest).length > 0 ? ` ${JSON.stringify(rest)}` : '';
+        const line = `[${ts}] [${logger}] ${level.toUpperCase()}: ${msg}${ctxStr}\n`;
+        process.stderr.write(line);
+    }
+}
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+const MAX_ROTATED_FILES = 2; // .1, .2
+class FileSink {
+    basePath;
+    daily;
+    writeCount = 0;
+    currentDay = '';
+    resolvedPath;
+    constructor(filePath, options = {}) {
+        this.basePath = filePath;
+        this.daily = options.daily === true;
+        this.resolvedPath = this.computePath();
+        const dir = dirname(this.resolvedPath);
+        if (dir && !existsSync(dir)) {
+            try {
+                mkdirSync(dir, { recursive: true });
+            }
+            catch {
+                // Best-effort directory creation
+            }
+        }
+    }
+    computePath() {
+        if (!this.daily)
+            return this.basePath;
+        const day = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+        this.currentDay = day;
+        const dot = this.basePath.lastIndexOf('.');
+        const slash = Math.max(this.basePath.lastIndexOf('/'), this.basePath.lastIndexOf('\\'));
+        if (dot > slash) {
+            return `${this.basePath.slice(0, dot)}-${day}${this.basePath.slice(dot)}`;
+        }
+        return `${this.basePath}-${day}`;
+    }
+    write(entry) {
+        try {
+            if (this.daily) {
+                const day = new Date().toISOString().slice(0, 10);
+                if (day !== this.currentDay) {
+                    this.resolvedPath = this.computePath();
+                    const dir = dirname(this.resolvedPath);
+                    if (dir && !existsSync(dir))
+                        mkdirSync(dir, { recursive: true });
+                }
+            }
+            appendFileSync(this.resolvedPath, JSON.stringify(entry) + '\n', 'utf-8');
+            this.writeCount++;
+            if (this.writeCount % 100 === 0)
+                this.maybeRotate();
+        }
+        catch {
+            // Best-effort file logging
+        }
+    }
+    maybeRotate() {
+        // daily 模式靠日期切文件，不做大小轮转
+        if (this.daily)
+            return;
+        try {
+            const stat = statSync(this.resolvedPath);
+            if (stat.size < MAX_FILE_SIZE)
+                return;
+            for (let i = MAX_ROTATED_FILES; i >= 1; i--) {
+                const from = i === 1 ? this.resolvedPath : `${this.resolvedPath}.${i - 1}`;
+                const to = `${this.resolvedPath}.${i}`;
+                if (existsSync(from))
+                    renameSync(from, to);
+            }
+        }
+        catch {
+            // Rotation failure is non-fatal
+        }
+    }
+}
+// ─── Ring buffer (recent entries) ───
+const DEFAULT_RECENT_CAPACITY = 200;
+let _recentCapacity = DEFAULT_RECENT_CAPACITY;
+let _recentEntries = [];
+function pushRecent(entry) {
+    _recentEntries.push(entry);
+    const overflow = _recentEntries.length - _recentCapacity;
+    if (overflow > 0) {
+        _recentEntries.splice(0, overflow);
+    }
+}
+/**
+ * 返回内存中最近的日志条目（最旧→最新）。供崩溃报告采集上下文。
+ * @param n 返回最近 n 条；省略时返回缓冲区全部（最多 capacity 条）。
+ */
+export function getRecentLogEntries(n) {
+    if (n === undefined || n >= _recentEntries.length) {
+        return _recentEntries.slice();
+    }
+    if (n <= 0)
+        return [];
+    return _recentEntries.slice(_recentEntries.length - n);
+}
+/** 配置环形缓冲容量（默认 200）。<=0 时禁用缓冲。 */
+export function setRecentLogCapacity(capacity) {
+    _recentCapacity = Number.isFinite(capacity) && capacity > 0 ? Math.floor(capacity) : 0;
+    if (_recentEntries.length > _recentCapacity) {
+        _recentEntries.splice(0, _recentEntries.length - _recentCapacity);
+    }
+}
+// ─── Logger Implementation ───
+class StructuredLogger {
+    name;
+    level = LogLevel.WARN;
+    constructor(name) {
+        this.name = name;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    shouldLog(level) {
+        return LEVEL_ORDER.indexOf(level) >= LEVEL_ORDER.indexOf(this.level);
+    }
+    emit(level, msg, args) {
+        if (!this.shouldLog(level))
+            return;
+        let ctxObj;
+        if (args.length === 1 && args[0] && typeof args[0] === 'object' && !Array.isArray(args[0])) {
+            ctxObj = args[0];
+        }
+        else if (args.length > 0) {
+            ctxObj = { args };
+        }
+        const entry = {
+            ts: new Date().toISOString(),
+            level,
+            logger: this.name,
+            msg,
+            ...ctxObj,
+        };
+        // 进入内存环形缓冲（不受 sink 配置影响，崩溃报告始终可采集）
+        if (_recentCapacity > 0)
+            pushRecent(entry);
+        for (const sink of _sinks) {
+            sink.write(entry);
+        }
+    }
+    debug(msg, ...args) { this.emit(LogLevel.DEBUG, msg, args); }
+    info(msg, ...args) { this.emit(LogLevel.INFO, msg, args); }
+    warn(msg, ...args) { this.emit(LogLevel.WARN, msg, args); }
+    error(msg, ...args) { this.emit(LogLevel.ERROR, msg, args); }
+}
+// ─── Global State ───
+let _sinks = [new ConsoleSink()];
+const _allLoggers = [];
+// ─── Public API ───
+export const leaderLogger = _createAndTrack('lingxiao.leader');
+export const agentLogger = _createAndTrack('lingxiao.agent');
+export const sessionLogger = _createAndTrack('lingxiao.session');
+export const coreLogger = _createAndTrack('lingxiao.core');
+export const serverLogger = _createAndTrack('lingxiao.server');
+export const configLogger = _createAndTrack('lingxiao.config');
+const wikiLogger = _createAndTrack('lingxiao.wiki');
+export const llmLogger = _createAndTrack('lingxiao.llm');
+function _createAndTrack(name) {
+    const logger = new StructuredLogger(name);
+    _allLoggers.push(logger);
+    return logger;
+}
+export function createLogger(name, level = LogLevel.WARN) {
+    const logger = new StructuredLogger(name);
+    logger.setLevel(level);
+    _allLoggers.push(logger);
+    return logger;
+}
+function setGlobalLogLevel(level) {
+    for (const logger of _allLoggers) {
+        logger.setLevel(level);
+    }
+}
+export function configureLogging(config) {
+    const level = config.level
+        ?? process.env.LINGXIAO_LOG_LEVEL
+        ?? LogLevel.WARN;
+    setGlobalLogLevel(level);
+    if (config.recentCapacity !== undefined) {
+        setRecentLogCapacity(config.recentCapacity);
+    }
+    _sinks = config.console === false ? [] : [new ConsoleSink()];
+    if (config.file) {
+        const usingDefaultPath = typeof config.file !== 'string';
+        const filePath = typeof config.file === 'string'
+            ? config.file
+            : getMainLogFilePath();
+        // daily 仅在使用默认主日志路径时生效，避免破坏调用方显式指定的文件名
+        _sinks.push(new FileSink(filePath, { daily: usingDefaultPath && config.daily === true }));
+    }
+    if (config.sessionId) {
+        _sinks.push(new FileSink(getSessionLogFilePath(config.sessionId)));
+    }
+}
+//# sourceMappingURL=Log.js.map

package/dist/core/Log.js.map

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

package/dist/core/LogMaintenance.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Log Maintenance
+ *
+ * 定期清理 ~/.lingxiao/logs 下的历史文件以控制磁盘占用：
+ * - crash-*.json / diagnostics-*.zip / diagnostics-*.md
+ * - 轮转日志（lingxiao.log.1 / lingxiao.log.2 等）
+ * - session 日志（sessions/*.log）
+ *
+ * 清理策略：
+ * 1. 删除超过 maxAgeDays 的上述文件
+ * 2. 若日志目录总占用仍超过 maxTotalBytes，按 mtime 从旧到新删到阈值内
+ *
+ * 安全约束：绝不删当前活跃主日志 lingxiao.log。
+ * best-effort：所有 fs 操作 try-catch，单点失败不影响整体。
+ */
+export interface LogMaintenanceConfig {
+    /** 文件最大保留天数，超过则删除。默认 14。 */
+    maxAgeDays?: number;
+    /** 日志目录总占用上限（字节），超过则按最旧优先删除。默认 200MB。 */
+    maxTotalBytes?: number;
+    /** 定时清理间隔（毫秒）。默认 6 小时。 */
+    intervalMs?: number;
+}
+export interface LogMaintenanceResult {
+    deletedFiles: string[];
+    freedBytes: number;
+}
+/**
+ * 执行一次日志清理。绝不抛异常，返回本次删除的文件与释放字节数。
+ */
+export declare function runLogMaintenanceOnce(cfg?: LogMaintenanceConfig): LogMaintenanceResult;
+/**
+ * 启动定时清理。启动时先执行一次 runLogMaintenanceOnce，随后按 intervalMs 周期执行。
+ * 定时器 unref 不阻塞进程退出，并注册到 cleanupRegistry 以便退出时停止。
+ * 返回 stop 函数（幂等），调用后停止定时器并从 cleanupRegistry 注销。
+ */
+export declare function startLogMaintenance(cfg?: LogMaintenanceConfig): () => void;
+//# sourceMappingURL=LogMaintenance.d.ts.map

package/dist/core/LogMaintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogMaintenance.d.ts","sourceRoot":"","sources":["../../src/core/LogMaintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AA8FD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,oBAAyB,GAAG,oBAAoB,CA2D1F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,oBAAyB,GAAG,MAAM,IAAI,CA6D9E"}