weixin-devtools-mcp 0.0.1 → 0.1.0

package/build/collectors/Collector.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Collector 基类 - 通用数据收集器
+ * 参考 chrome-devtools-mcp 的 PageCollector 设计模式
+ *
+ * 特点：
+ * - 按导航会话分组存储
+ * - Stable ID 标识
+ * - 支持分页和过滤
+ */
+import { type WithStableId } from '../utils/idGenerator.js';
+/**
+ * 导航会话数据结构
+ */
+export interface NavigationSession<T> {
+    /** 会话中的数据项 */
+    items: Array<WithStableId<T>>;
+    /** 会话开始时间 */
+    timestamp: string;
+}
+/**
+ * Collector 配置选项
+ */
+export interface CollectorOptions {
+    /** 最大保留的导航会话数 */
+    maxNavigations?: number;
+    /** 单个会话最大条目数（环形缓冲区），默认 1000 */
+    maxItemsPerSession?: number;
+    /** 是否启用详细日志 */
+    verbose?: boolean;
+}
+/**
+ * 分页和过滤选项
+ */
+export interface QueryOptions<T> {
+    /** 是否包含历史导航会话的数据 */
+    includePreserved?: boolean;
+    /** 过滤函数 */
+    filter?: (item: T) => boolean;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 页码（从 0 开始） */
+    pageIdx?: number;
+}
+/**
+ * 通用数据收集器基类
+ *
+ * @template T 收集的数据类型
+ */
+export declare class Collector<T> {
+    #private;
+    constructor(options?: CollectorOptions);
+    /**
+     * 开始监听
+     */
+    startMonitoring(): void;
+    /**
+     * 停止监听
+     */
+    stopMonitoring(): void;
+    /**
+     * 检查是否正在监听
+     */
+    isMonitoring(): boolean;
+    /**
+     * 获取监听开始时间
+     */
+    getStartTime(): string | null;
+    /**
+     * 添加数据项（自动分配 Stable ID）
+     * 使用环形缓冲区，超出 maxItemsPerSession 时移除最旧的条目
+     * @returns 分配的 ID
+     */
+    collect(item: T): number;
+    /**
+     * 在导航后分割存储（保留历史）
+     */
+    splitAfterNavigation(): void;
+    /**
+     * 获取数据项的 Stable ID
+     */
+    getIdForItem(item: WithStableId<T>): number;
+    /**
+     * 通过 ID 获取数据项
+     */
+    getById(id: number): T | undefined;
+    /**
+     * 获取数据（支持分页和过滤）
+     */
+    getData(options?: QueryOptions<T>): T[];
+    /**
+     * 查找符合条件的数据项
+     */
+    find(predicate: (item: T) => boolean): T | undefined;
+    /**
+     * 查找所有符合条件的数据项
+     */
+    findAll(predicate: (item: T) => boolean): T[];
+    /**
+     * 获取当前会话的数据数量
+     */
+    getCurrentCount(): number;
+    /**
+     * 获取所有会话的数据总数
+     */
+    getTotalCount(): number;
+    /**
+     * 获取导航会话数量
+     */
+    getNavigationCount(): number;
+    /**
+     * 清空所有数据
+     */
+    clear(): void;
+    /**
+     * 清空当前会话的数据
+     */
+    clearCurrentSession(): void;
+    /**
+     * 获取原始导航数据（用于兼容旧接口）
+     */
+    getNavigations(): Array<NavigationSession<T>>;
+    /**
+     * 获取 ID 映射表（用于兼容旧接口）
+     */
+    getIdMap(): Map<number, WithStableId<T>>;
+}
+//# sourceMappingURL=Collector.d.ts.map

package/build/collectors/Collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../src/collectors/Collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,cAAc;IACd,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW;IACX,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC9B,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC;;gBAmBV,OAAO,GAAE,gBAAqB;IAa1C;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IAkCxB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IA4B5B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM;IAI3C;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;OAEG;IACH,OAAO,CAAC,OAAO,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,CAAC,EAAE;IA8B3C;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,SAAS;IAUpD;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAU7C;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAM5B;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAa3B;;OAEG;IACH,cAAc,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAI7C;;OAEG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAGzC"}

package/build/collectors/Collector.js

@@ -0,0 +1,252 @@
+/**
+ * Collector 基类 - 通用数据收集器
+ * 参考 chrome-devtools-mcp 的 PageCollector 设计模式
+ *
+ * 特点：
+ * - 按导航会话分组存储
+ * - Stable ID 标识
+ * - 支持分页和过滤
+ */
+import { createIdGenerator, stableIdSymbol } from '../utils/idGenerator.js';
+/**
+ * 默认配置
+ */
+const DEFAULT_OPTIONS = {
+    maxNavigations: 3,
+    maxItemsPerSession: 1000,
+    verbose: false,
+};
+/**
+ * 通用数据收集器基类
+ *
+ * @template T 收集的数据类型
+ */
+export class Collector {
+    /** 按导航分组的存储 */
+    #navigations = [];
+    /** ID 到数据项的映射（用于快速查找） */
+    #idMap = new Map();
+    /** ID 生成器 */
+    #idGenerator;
+    /** 配置选项 */
+    #options;
+    /** 是否正在监听 */
+    #isMonitoring = false;
+    /** 监听开始时间 */
+    #startTime = null;
+    constructor(options = {}) {
+        this.#options = { ...DEFAULT_OPTIONS, ...options };
+        this.#idGenerator = createIdGenerator();
+        // 初始化第一个导航会话
+        this.#navigations.push({
+            items: [],
+            timestamp: new Date().toISOString(),
+        });
+    }
+    // ============ 监听状态管理 ============
+    /**
+     * 开始监听
+     */
+    startMonitoring() {
+        this.#isMonitoring = true;
+        this.#startTime = new Date().toISOString();
+    }
+    /**
+     * 停止监听
+     */
+    stopMonitoring() {
+        this.#isMonitoring = false;
+    }
+    /**
+     * 检查是否正在监听
+     */
+    isMonitoring() {
+        return this.#isMonitoring;
+    }
+    /**
+     * 获取监听开始时间
+     */
+    getStartTime() {
+        return this.#startTime;
+    }
+    // ============ 数据收集 ============
+    /**
+     * 添加数据项（自动分配 Stable ID）
+     * 使用环形缓冲区，超出 maxItemsPerSession 时移除最旧的条目
+     * @returns 分配的 ID
+     */
+    collect(item) {
+        const id = this.#idGenerator();
+        const withId = item;
+        withId[stableIdSymbol] = id;
+        // 添加到当前导航会话
+        const currentSession = this.#navigations[0];
+        // 环形缓冲区：超出限制时移除最旧的条目
+        if (currentSession.items.length >= this.#options.maxItemsPerSession) {
+            const removed = currentSession.items.shift();
+            if (removed) {
+                const removedId = this.getIdForItem(removed);
+                if (removedId !== -1) {
+                    this.#idMap.delete(removedId);
+                }
+            }
+            if (this.#options.verbose) {
+                console.error(`[Collector] 环形缓冲区已满，移除最旧条目`);
+            }
+        }
+        currentSession.items.push(withId);
+        // 添加到 ID 映射
+        this.#idMap.set(id, withId);
+        if (this.#options.verbose) {
+            console.error(`[Collector] 收集数据项，ID: ${id}，当前会话条目数: ${currentSession.items.length}`);
+        }
+        return id;
+    }
+    /**
+     * 在导航后分割存储（保留历史）
+     */
+    splitAfterNavigation() {
+        // 添加新的导航会话到开头
+        this.#navigations.unshift({
+            items: [],
+            timestamp: new Date().toISOString(),
+        });
+        // 限制保留的导航数量
+        if (this.#navigations.length > this.#options.maxNavigations) {
+            const removed = this.#navigations.splice(this.#options.maxNavigations);
+            // 清理被移除会话中的 ID 映射
+            for (const session of removed) {
+                for (const item of session.items) {
+                    const id = this.getIdForItem(item);
+                    if (id !== -1) {
+                        this.#idMap.delete(id);
+                    }
+                }
+            }
+        }
+        if (this.#options.verbose) {
+            console.error(`[Collector] 导航分割，当前会话数: ${this.#navigations.length}`);
+        }
+    }
+    // ============ 数据查询 ============
+    /**
+     * 获取数据项的 Stable ID
+     */
+    getIdForItem(item) {
+        return item[stableIdSymbol] ?? -1;
+    }
+    /**
+     * 通过 ID 获取数据项
+     */
+    getById(id) {
+        return this.#idMap.get(id);
+    }
+    /**
+     * 获取数据（支持分页和过滤）
+     */
+    getData(options = {}) {
+        const { includePreserved = false, filter, pageSize, pageIdx = 0 } = options;
+        // 收集数据
+        let result = [];
+        if (includePreserved) {
+            // 从旧到新收集所有会话的数据
+            for (let i = this.#navigations.length - 1; i >= 0; i--) {
+                result.push(...this.#navigations[i].items);
+            }
+        }
+        else {
+            // 只收集当前会话的数据
+            result = [...this.#navigations[0].items];
+        }
+        // 应用过滤
+        if (filter) {
+            result = result.filter(filter);
+        }
+        // 应用分页
+        if (pageSize !== undefined && pageSize > 0) {
+            const start = pageIdx * pageSize;
+            result = result.slice(start, start + pageSize);
+        }
+        return result;
+    }
+    /**
+     * 查找符合条件的数据项
+     */
+    find(predicate) {
+        for (const session of this.#navigations) {
+            const found = session.items.find(predicate);
+            if (found) {
+                return found;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * 查找所有符合条件的数据项
+     */
+    findAll(predicate) {
+        const result = [];
+        for (const session of this.#navigations) {
+            result.push(...session.items.filter(predicate));
+        }
+        return result;
+    }
+    // ============ 统计信息 ============
+    /**
+     * 获取当前会话的数据数量
+     */
+    getCurrentCount() {
+        return this.#navigations[0]?.items.length ?? 0;
+    }
+    /**
+     * 获取所有会话的数据总数
+     */
+    getTotalCount() {
+        return this.#idMap.size;
+    }
+    /**
+     * 获取导航会话数量
+     */
+    getNavigationCount() {
+        return this.#navigations.length;
+    }
+    // ============ 清理操作 ============
+    /**
+     * 清空所有数据
+     */
+    clear() {
+        this.#navigations = [{
+                items: [],
+                timestamp: new Date().toISOString(),
+            }];
+        this.#idMap.clear();
+        this.#idGenerator = createIdGenerator();
+    }
+    /**
+     * 清空当前会话的数据
+     */
+    clearCurrentSession() {
+        const currentSession = this.#navigations[0];
+        for (const item of currentSession.items) {
+            const id = this.getIdForItem(item);
+            if (id !== -1) {
+                this.#idMap.delete(id);
+            }
+        }
+        currentSession.items = [];
+    }
+    // ============ 导出/兼容接口 ============
+    /**
+     * 获取原始导航数据（用于兼容旧接口）
+     */
+    getNavigations() {
+        return this.#navigations;
+    }
+    /**
+     * 获取 ID 映射表（用于兼容旧接口）
+     */
+    getIdMap() {
+        return this.#idMap;
+    }
+}
+//# sourceMappingURL=Collector.js.map

package/build/collectors/Collector.js.map

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

package/build/collectors/ConsoleCollector.d.ts

@@ -0,0 +1,104 @@
+/**
+ * ConsoleCollector - Console 消息收集器
+ *
+ * 专门用于收集和管理 Console 消息和异常
+ * 继承自通用 Collector 基类
+ */
+import type { ConsoleMessageType } from '../tools/ToolDefinition.js';
+import { Collector, type CollectorOptions, type QueryOptions } from './Collector.js';
+/**
+ * Console 消息接口
+ */
+export interface ConsoleMessage {
+    /** Stable ID（由 Collector 自动分配） */
+    msgid?: number;
+    /** 消息类型 */
+    type: ConsoleMessageType;
+    /** 格式化的消息文本 */
+    message?: string;
+    /** console 方法的原始参数 */
+    args: unknown[];
+    /** 时间戳 */
+    timestamp: string;
+    /** 来源 */
+    source?: string;
+}
+/**
+ * Exception 异常信息接口
+ */
+export interface ExceptionMessage {
+    /** Stable ID（由 Collector 自动分配） */
+    msgid?: number;
+    /** 异常消息 */
+    message: string;
+    /** 堆栈信息 */
+    stack?: string;
+    /** 时间戳 */
+    timestamp: string;
+    /** 来源 */
+    source?: string;
+}
+/**
+ * Console 消息类型（包含 Console 消息和异常）
+ */
+export type ConsoleEntry = ConsoleMessage | ExceptionMessage;
+/**
+ * Console 查询选项
+ */
+export interface ConsoleQueryOptions extends QueryOptions<ConsoleEntry> {
+    /** 过滤消息类型 */
+    types?: ConsoleMessageType[];
+}
+/**
+ * 检查是否为 ConsoleMessage
+ */
+export declare function isConsoleMessage(entry: ConsoleEntry): entry is ConsoleMessage;
+/**
+ * 检查是否为 ExceptionMessage
+ */
+export declare function isExceptionMessage(entry: ConsoleEntry): entry is ExceptionMessage;
+/**
+ * Console 消息收集器
+ */
+export declare class ConsoleCollector extends Collector<ConsoleEntry> {
+    constructor(options?: CollectorOptions);
+    /**
+     * 添加 Console 消息
+     * @returns 分配的 msgid
+     */
+    addMessage(message: Omit<ConsoleMessage, 'msgid'>): number;
+    /**
+     * 添加异常信息
+     * @returns 分配的 msgid
+     */
+    addException(exception: Omit<ExceptionMessage, 'msgid'>): number;
+    /**
+     * 通过 msgid 获取消息
+     */
+    getMessageById(msgid: number): ConsoleEntry | undefined;
+    /**
+     * 获取 Console 消息（支持类型过滤）
+     */
+    getMessages(options?: ConsoleQueryOptions): ConsoleEntry[];
+    /**
+     * 只获取 Console 消息（不包括异常）
+     */
+    getConsoleMessagesOnly(options?: ConsoleQueryOptions): ConsoleMessage[];
+    /**
+     * 只获取异常信息
+     */
+    getExceptionsOnly(options?: Omit<ConsoleQueryOptions, 'types'>): ExceptionMessage[];
+    /**
+     * 获取错误数量（包括 error 类型消息和异常）
+     */
+    getErrorCount(): number;
+    /**
+     * 获取警告数量
+     */
+    getWarningCount(): number;
+    /**
+     * 格式化消息预览（用于列表显示）
+     */
+    formatPreview(entry: ConsoleEntry, maxLength?: number): string;
+}
+//# sourceMappingURL=ConsoleCollector.d.ts.map

package/build/collectors/ConsoleCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleCollector.d.ts","sourceRoot":"","sources":["../../src/collectors/ConsoleCollector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY,CAAC,YAAY,CAAC;IACrE,aAAa;IACb,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,cAAc,CAE7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,gBAAgB,CAEjF;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,YAAY,CAAC;gBAC/C,OAAO,CAAC,EAAE,gBAAgB;IAItC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,MAAM;IAU1D;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,MAAM;IAUhE;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,WAAW,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,EAAE;IAyB9D;;OAEG;IACH,sBAAsB,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,EAAE;IAK3E;;OAEG;IACH,iBAAiB,CAAC,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAM,GAAG,gBAAgB,EAAE;IAKvF;;OAEG;IACH,aAAa,IAAI,MAAM;IAWvB;;OAEG;IACH,eAAe,IAAI,MAAM;IAWzB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,SAAM,GAAG,MAAM;CA2B5D"}

package/build/collectors/ConsoleCollector.js

@@ -0,0 +1,157 @@
+/**
+ * ConsoleCollector - Console 消息收集器
+ *
+ * 专门用于收集和管理 Console 消息和异常
+ * 继承自通用 Collector 基类
+ */
+import { Collector } from './Collector.js';
+/**
+ * 检查是否为 ConsoleMessage
+ */
+export function isConsoleMessage(entry) {
+    return 'type' in entry;
+}
+/**
+ * 检查是否为 ExceptionMessage
+ */
+export function isExceptionMessage(entry) {
+    return !('type' in entry) && 'message' in entry;
+}
+/**
+ * Console 消息收集器
+ */
+export class ConsoleCollector extends Collector {
+    constructor(options) {
+        super(options);
+    }
+    /**
+     * 添加 Console 消息
+     * @returns 分配的 msgid
+     */
+    addMessage(message) {
+        const id = this.collect(message);
+        // 同步 msgid 到消息对象
+        const storedMessage = this.getById(id);
+        if (storedMessage) {
+            storedMessage.msgid = id;
+        }
+        return id;
+    }
+    /**
+     * 添加异常信息
+     * @returns 分配的 msgid
+     */
+    addException(exception) {
+        const id = this.collect(exception);
+        // 同步 msgid 到异常对象
+        const storedException = this.getById(id);
+        if (storedException) {
+            storedException.msgid = id;
+        }
+        return id;
+    }
+    /**
+     * 通过 msgid 获取消息
+     */
+    getMessageById(msgid) {
+        return this.getById(msgid);
+    }
+    /**
+     * 获取 Console 消息（支持类型过滤）
+     */
+    getMessages(options = {}) {
+        const { types, ...baseOptions } = options;
+        // 构建过滤函数
+        let filter = baseOptions.filter;
+        if (types && types.length > 0) {
+            const typeSet = new Set(types);
+            const originalFilter = filter;
+            filter = (entry) => {
+                // 类型过滤
+                const typeMatch = isConsoleMessage(entry)
+                    ? typeSet.has(entry.type)
+                    : typeSet.has('error'); // ExceptionMessage 视为 error 类型
+                // 如果有原始过滤器，还需要满足原始过滤条件
+                if (originalFilter) {
+                    return typeMatch && originalFilter(entry);
+                }
+                return typeMatch;
+            };
+        }
+        return this.getData({ ...baseOptions, filter });
+    }
+    /**
+     * 只获取 Console 消息（不包括异常）
+     */
+    getConsoleMessagesOnly(options = {}) {
+        const entries = this.getMessages(options);
+        return entries.filter(isConsoleMessage);
+    }
+    /**
+     * 只获取异常信息
+     */
+    getExceptionsOnly(options = {}) {
+        const entries = this.getData(options);
+        return entries.filter(isExceptionMessage);
+    }
+    /**
+     * 获取错误数量（包括 error 类型消息和异常）
+     */
+    getErrorCount() {
+        let count = 0;
+        const entries = this.getData({ includePreserved: false });
+        for (const entry of entries) {
+            if (isExceptionMessage(entry) || (isConsoleMessage(entry) && entry.type === 'error')) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 获取警告数量
+     */
+    getWarningCount() {
+        let count = 0;
+        const entries = this.getData({ includePreserved: false });
+        for (const entry of entries) {
+            if (isConsoleMessage(entry) && entry.type === 'warn') {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 格式化消息预览（用于列表显示）
+     */
+    formatPreview(entry, maxLength = 100) {
+        let text;
+        if (isConsoleMessage(entry)) {
+            if (entry.message) {
+                text = entry.message;
+            }
+            else if (entry.args.length > 0) {
+                text = entry.args
+                    .map(arg => {
+                    if (typeof arg === 'string')
+                        return arg;
+                    if (typeof arg === 'object')
+                        return JSON.stringify(arg);
+                    return String(arg);
+                })
+                    .join(' ');
+            }
+            else {
+                text = '';
+            }
+        }
+        else {
+            text = entry.message;
+        }
+        // 截断长文本
+        if (text.length > maxLength) {
+            return text.slice(0, maxLength) + '...';
+        }
+        return text;
+    }
+}
+//# sourceMappingURL=ConsoleCollector.js.map

package/build/collectors/ConsoleCollector.js.map

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