@tcos/broker-parser 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI 入口 — tcos-parse 命令
+ *
+ * 用法：
+ *   tcos-parse <pdf>              # 解析并输出 JSON 到 stdout
+ *   tcos-parse <pdf> -o out.json  # 输出到文件
+ *   tcos-parse <pdf> --raw        # 只输出 Stage1 原始数据
+ *   tcos-parse <pdf> --no-clean   # 跳过 Stage3 清理
+ *   tcos-parse -b phillip <pdf>   # 指定券商
+ *   tcos-parse --detect <pdf>     # 检测 PDF 所属券商
+ *   tcos-parse --list-parsers     # 列出支持的券商
+ *   tcos-parse -v <pdf>           # 显示各阶段耗时
+ *   tcos-parse -q <pdf>           # 静默模式，只输出 JSON
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const pipeline_1 = require("../core/pipeline");
+const registry_1 = require("../core/registry");
+const phillip_1 = require("../parsers/phillip");
+// 初始化插件注册表
+const registry = new registry_1.PluginRegistry();
+registry.register(new phillip_1.PhillipPlugin());
+const pipeline = new pipeline_1.ParsePipeline(registry);
+const program = new commander_1.Command();
+program
+    .name('tcos-parse')
+    .description('Parse brokerage PDF statements into structured JSON')
+    .version('0.1.0');
+// 主命令：解析 PDF
+program
+    .argument('[pdf]', 'PDF statement file to parse')
+    .option('-o, --output <file>', 'output to file (default: stdout)')
+    .option('-b, --broker <name>', 'specify broker (default: auto-detect)')
+    .option('--raw', 'output Stage1 raw data only')
+    .option('--no-clean', 'skip cleaning step')
+    .option('-v, --verbose', 'show stage timing and details')
+    .option('-q, --quiet', 'silent mode, only output JSON')
+    .option('--detect', 'detect broker instead of parsing')
+    .option('--list-parsers', 'list available broker parsers')
+    .action(async (pdfArg, opts) => {
+    // --list-parsers：列出支持的券商
+    if (opts.listParsers) {
+        const plugins = registry.listPlugins();
+        console.log('Available parsers:');
+        for (const p of plugins) {
+            console.log(`  ${p.name} — ${p.displayName}`);
+        }
+        return;
+    }
+    // 其他操作都需要 PDF 路径
+    if (!pdfArg) {
+        console.error('Error: PDF file path is required. Use --help for usage.');
+        process.exit(1);
+    }
+    const pdfPath = path.resolve(pdfArg);
+    // 检查文件是否存在
+    if (!fs.existsSync(pdfPath)) {
+        console.error(`Error: File not found: ${pdfPath}`);
+        process.exit(1);
+    }
+    // --detect：检测券商模式
+    if (opts.detect) {
+        const plugins = registry.listPlugins();
+        let bestName = 'unknown';
+        let bestScore = 0;
+        for (const p of plugins) {
+            const score = await p.detect(pdfPath);
+            if (score > bestScore) {
+                bestScore = score;
+                bestName = p.name;
+            }
+        }
+        if (!opts.quiet) {
+            console.log(`Detected broker: ${bestName} (confidence: ${bestScore.toFixed(2)})`);
+        }
+        else {
+            console.log(bestName);
+        }
+        return;
+    }
+    // 解析模式
+    try {
+        const result = await pipeline.parse(pdfPath, {
+            broker: opts.broker,
+            raw: opts.raw,
+            noClean: !opts.clean, // commander --no-clean → clean=false → noClean=true
+            verbose: opts.verbose,
+        });
+        // verbose 时把耗时输出到 stderr（不污染 stdout JSON）
+        if (opts.verbose) {
+            const t = result.metadata.timings;
+            process.stderr.write(`[timing] detect=${t.detect}ms stage1=${t.stage1}ms ` +
+                `stage2=${t.stage2}ms clean=${t.clean}ms total=${t.total}ms\n`);
+        }
+        const json = JSON.stringify(result.data, null, 2);
+        if (opts.output) {
+            fs.writeFileSync(path.resolve(opts.output), json, 'utf-8');
+            if (!opts.quiet) {
+                process.stderr.write(`Written to ${opts.output}\n`);
+            }
+        }
+        else {
+            console.log(json);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: ${message}\n`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/cleaning.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 数据清理工具模块
+ *
+ * 提取自 StatementValidator 的公共清理逻辑，不依赖数据库。
+ * 用于 Parser Tuning 的 Stage 3 验证测试。
+ *
+ * 与 StatementValidator 的区别：
+ * - 本模块只做基于规则的清理，不查询数据库去重
+ * - StatementValidator 会查询数据库判断 refNo 是否存在
+ */
+import { TradeData, SnapshotData, IPOData, StatementData } from '../types/statement';
+/**
+ * 清理规则配置接口
+ */
+export interface CleaningConfig {
+    skipZeroAmount: boolean;
+    requireRefNo: boolean;
+    excludeHKDBase: boolean;
+    dedupeByRefNo: boolean;
+    filterInvalidIPO: boolean;
+}
+/**
+ * 默认清理配置
+ */
+export declare const DEFAULT_CLEANING_CONFIG: CleaningConfig;
+/**
+ * 清理结果接口
+ */
+export interface CleaningResult<T> {
+    cleaned: T[];
+    filtered: T[];
+    filterReasons: string[];
+}
+/**
+ * 清理交易记录
+ *
+ * @param transactions - 原始交易记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果，包含清理后的记录和被过滤的记录
+ */
+export declare function cleanTransactions(transactions: TradeData[], config: CleaningConfig): CleaningResult<TradeData>;
+/**
+ * 标准化交易类型
+ * 根据描述自动判断 WITHDRAWAL/DEPOSIT 类型
+ */
+export declare function normalizeTransaction(tx: TradeData): TradeData;
+/**
+ * 清理 IPO 记录
+ *
+ * @param ipoList - 原始 IPO 记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果
+ */
+export declare function cleanIPO(ipoList: IPOData[], config: CleaningConfig): CleaningResult<IPOData>;
+/**
+ * 清理持仓快照记录
+ *
+ * @param snapshots - 原始快照记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果
+ */
+export declare function cleanSnapshots(snapshots: SnapshotData[], config: CleaningConfig): CleaningResult<SnapshotData>;
+/**
+ * 清理整个 StatementData
+ *
+ * @param data - 原始结单数据
+ * @param config - 清理规则配置
+ * @returns 清理后的结单数据和清理详情
+ */
+export declare function cleanStatementData(data: StatementData, config?: Partial<CleaningConfig>): {
+    result: StatementData;
+    details: {
+        transactions: CleaningResult<TradeData>;
+        ipo: CleaningResult<IPOData>;
+        snapshots: CleaningResult<SnapshotData>;
+    };
+};
+//# sourceMappingURL=cleaning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleaning.d.ts","sourceRoot":"","sources":["../../src/core/cleaning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOrF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAMrC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,SAAS,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,cAAc,CAAC,SAAS,CAAC,CAuE3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAe7D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,CA4B5F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,YAAY,EAAE,EACzB,MAAM,EAAE,cAAc,GACrB,cAAc,CAAC,YAAY,CAAC,CA8B9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GACnC;IACD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE;QACP,YAAY,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;QACxC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7B,SAAS,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;KACzC,CAAC;CACH,CAsBA"}

package/dist/core/cleaning.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * 数据清理工具模块
+ *
+ * 提取自 StatementValidator 的公共清理逻辑，不依赖数据库。
+ * 用于 Parser Tuning 的 Stage 3 验证测试。
+ *
+ * 与 StatementValidator 的区别：
+ * - 本模块只做基于规则的清理，不查询数据库去重
+ * - StatementValidator 会查询数据库判断 refNo 是否存在
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CLEANING_CONFIG = void 0;
+exports.cleanTransactions = cleanTransactions;
+exports.normalizeTransaction = normalizeTransaction;
+exports.cleanIPO = cleanIPO;
+exports.cleanSnapshots = cleanSnapshots;
+exports.cleanStatementData = cleanStatementData;
+/**
+ * IPO 识别关键词（与 Stage2 保持一致）
+ */
+const IPO_KEYWORDS = ['IPO', '新股', '认购', '認購', '公开发售', '公開發售', 'PUBLIC OFFER'];
+/**
+ * 默认清理配置
+ */
+exports.DEFAULT_CLEANING_CONFIG = {
+    skipZeroAmount: true,
+    requireRefNo: true,
+    excludeHKDBase: true,
+    dedupeByRefNo: true,
+    filterInvalidIPO: true,
+};
+/**
+ * 清理交易记录
+ *
+ * @param transactions - 原始交易记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果，包含清理后的记录和被过滤的记录
+ */
+function cleanTransactions(transactions, config) {
+    if (!transactions || transactions.length === 0) {
+        return { cleaned: [], filtered: [], filterReasons: [] };
+    }
+    const filtered = [];
+    const filterReasons = [];
+    const uniqueMap = new Map();
+    for (const tx of transactions) {
+        // 规则 1: 过滤零金额
+        if (config.skipZeroAmount) {
+            if (tx.amount === null || tx.amount === undefined || tx.amount === 0) {
+                filtered.push(tx);
+                filterReasons.push(`交易 ${tx.refNo || 'unknown'}: 金额为空或零`);
+                continue;
+            }
+        }
+        // 规则 2: 要求 RefNo
+        if (config.requireRefNo) {
+            if (!tx.refNo) {
+                filtered.push(tx);
+                filterReasons.push(`交易: 缺少参考编号`);
+                continue;
+            }
+        }
+        // 规则 3: RefNo 去重
+        if (config.dedupeByRefNo && tx.refNo) {
+            if (uniqueMap.has(tx.refNo)) {
+                const existing = uniqueMap.get(tx.refNo);
+                // 保留字段更完整的记录
+                if (Object.keys(tx).length > Object.keys(existing).length) {
+                    filtered.push(existing);
+                    filterReasons.push(`交易 ${existing.refNo}: 被更完整的记录替代`);
+                    uniqueMap.set(tx.refNo, tx);
+                }
+                else {
+                    filtered.push(tx);
+                    filterReasons.push(`交易 ${tx.refNo}: 重复记录`);
+                }
+                continue;
+            }
+            uniqueMap.set(tx.refNo, tx);
+        }
+        else if (!config.dedupeByRefNo) {
+            // 不去重时直接添加到 map（使用索引作为 key）
+            uniqueMap.set(`idx_${uniqueMap.size}`, tx);
+        }
+    }
+    // 标准化交易类型
+    let cleaned = Array.from(uniqueMap.values()).map((tx) => normalizeTransaction(tx));
+    // 过滤 IPO 相关的无效记录
+    cleaned = cleaned.filter((tx) => {
+        const upDesc = (tx.description || '').toUpperCase();
+        const isIPO = IPO_KEYWORDS.some((kw) => upDesc.includes(kw.toUpperCase()));
+        if (isIPO) {
+            // 允许通过的 IPO 交易类型
+            const allowedIPOTypes = ['IPO_FEE', 'IPO_INTEREST', 'BUY'];
+            if (allowedIPOTypes.includes(tx.transactionType)) {
+                return true;
+            }
+            filtered.push(tx);
+            filterReasons.push(`交易 ${tx.refNo}: IPO 相关但类型为 ${tx.transactionType}`);
+            return false;
+        }
+        return true;
+    });
+    return { cleaned, filtered, filterReasons };
+}
+/**
+ * 标准化交易类型
+ * 根据描述自动判断 WITHDRAWAL/DEPOSIT 类型
+ */
+function normalizeTransaction(tx) {
+    const desc = (tx.description || '').toUpperCase();
+    if (desc.includes('EPAYMENT') || desc.includes('電子轉帳')) {
+        tx.transactionType = 'WITHDRAWAL';
+    }
+    else if (desc.includes('EDDA') ||
+        desc.includes('DIRECT DEBIT') ||
+        desc.includes('DEP REFE') ||
+        desc.includes('直接轉帳')) {
+        tx.transactionType = 'DEPOSIT';
+    }
+    return tx;
+}
+/**
+ * 清理 IPO 记录
+ *
+ * @param ipoList - 原始 IPO 记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果
+ */
+function cleanIPO(ipoList, config) {
+    if (!ipoList || ipoList.length === 0) {
+        return { cleaned: [], filtered: [], filterReasons: [] };
+    }
+    const cleaned = [];
+    const filtered = [];
+    const filterReasons = [];
+    for (const item of ipoList) {
+        // 规则: 过滤无效 IPO 记录
+        if (config.filterInvalidIPO) {
+            if (!item.stockCode) {
+                filtered.push(item);
+                filterReasons.push(`IPO: 缺少股票代码`);
+                continue;
+            }
+            if (item.amount === undefined || item.amount === null) {
+                filtered.push(item);
+                filterReasons.push(`IPO ${item.stockCode}: 金额为空`);
+                continue;
+            }
+        }
+        cleaned.push(item);
+    }
+    return { cleaned, filtered, filterReasons };
+}
+/**
+ * 清理持仓快照记录
+ *
+ * @param snapshots - 原始快照记录数组
+ * @param config - 清理规则配置
+ * @returns 清理结果
+ */
+function cleanSnapshots(snapshots, config) {
+    if (!snapshots || snapshots.length === 0) {
+        return { cleaned: [], filtered: [], filterReasons: [] };
+    }
+    const cleaned = [];
+    const filtered = [];
+    const filterReasons = [];
+    for (const item of snapshots) {
+        // 规则 1: 排除 HKD(Base)
+        if (config.excludeHKDBase && item.symbol === 'HKD(Base)') {
+            filtered.push(item);
+            filterReasons.push(`快照 ${item.symbol}: HKD(Base) 被排除`);
+            continue;
+        }
+        // 规则 2: 现金类别只保留 HKD/USD
+        if (item.assetCategory === 'Cash') {
+            if (!['HKD', 'USD'].includes(item.symbol.toUpperCase())) {
+                filtered.push(item);
+                filterReasons.push(`快照 ${item.symbol}: 非 HKD/USD 现金被排除`);
+                continue;
+            }
+        }
+        cleaned.push(item);
+    }
+    return { cleaned, filtered, filterReasons };
+}
+/**
+ * 清理整个 StatementData
+ *
+ * @param data - 原始结单数据
+ * @param config - 清理规则配置
+ * @returns 清理后的结单数据和清理详情
+ */
+function cleanStatementData(data, config = {}) {
+    // 合并配置
+    const mergedConfig = { ...exports.DEFAULT_CLEANING_CONFIG, ...config };
+    // 清理各部分
+    const transactionsResult = cleanTransactions(data.transactions || [], mergedConfig);
+    const ipoResult = cleanIPO(data.ipo || [], mergedConfig);
+    const snapshotsResult = cleanSnapshots(data.snapshots || [], mergedConfig);
+    return {
+        result: {
+            ...data,
+            transactions: transactionsResult.cleaned,
+            ipo: ipoResult.cleaned,
+            snapshots: snapshotsResult.cleaned,
+        },
+        details: {
+            transactions: transactionsResult,
+            ipo: ipoResult,
+            snapshots: snapshotsResult,
+        },
+    };
+}
+//# sourceMappingURL=cleaning.js.map

package/dist/core/cleaning.js.map

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

package/dist/core/pipeline.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ParsePipeline — 解析管道编排器
+ *
+ * 编排 Stage1（提取） → Stage2（格式化） → Stage3（清理）流程，
+ * 返回结构化结果和各阶段耗时元数据。
+ *
+ * 支持模式：
+ * - raw: 只执行 Stage1，输出原始表格数据
+ * - noClean: 跳过 Stage3 清理步骤
+ */
+import { StatementData } from '../types/statement';
+import { RawTableData } from '../types/raw';
+import { PluginRegistry } from './registry';
+/** 解析选项 */
+export interface ParseOptions {
+    /** 指定券商名称，默认自动检测 */
+    broker?: string;
+    /** 只输出 Stage1 raw 数据 */
+    raw?: boolean;
+    /** 跳过 Stage3 清理 */
+    noClean?: boolean;
+    /** 输出耗时详情 */
+    verbose?: boolean;
+}
+/** 各阶段耗时（毫秒） */
+export interface ParseTimings {
+    detect: number;
+    stage1: number;
+    stage2: number;
+    clean: number;
+    total: number;
+}
+/** 解析结果 */
+export interface ParseResult {
+    data: StatementData | RawTableData;
+    broker: string;
+    raw: boolean;
+    metadata: {
+        timings: ParseTimings;
+        parserVersion: string;
+    };
+}
+export declare class ParsePipeline {
+    private readonly registry;
+    constructor(registry: PluginRegistry);
+    /** 执行完整解析管道 */
+    parse(pdfPath: string, opts?: ParseOptions): Promise<ParseResult>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE;QACR,OAAO,EAAE,YAAY,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAErD,eAAe;IACT,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAmD5E"}

package/dist/core/pipeline.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * ParsePipeline — 解析管道编排器
+ *
+ * 编排 Stage1（提取） → Stage2（格式化） → Stage3（清理）流程，
+ * 返回结构化结果和各阶段耗时元数据。
+ *
+ * 支持模式：
+ * - raw: 只执行 Stage1，输出原始表格数据
+ * - noClean: 跳过 Stage3 清理步骤
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParsePipeline = void 0;
+const cleaning_1 = require("./cleaning");
+class ParsePipeline {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /** 执行完整解析管道 */
+    async parse(pdfPath, opts = {}) {
+        const overallStart = Date.now();
+        const timings = { detect: 0, stage1: 0, stage2: 0, clean: 0, total: 0 };
+        // Step 1: 获取 plugin（指定券商或自动检测）
+        let t = Date.now();
+        const plugin = opts.broker
+            ? this.registry.getPlugin(opts.broker)
+            : await this.registry.autoDetect(pdfPath);
+        timings.detect = Date.now() - t;
+        // Step 2: Stage1 提取原始数据
+        t = Date.now();
+        const extractor = plugin.createExtractor();
+        const rawData = await extractor.extract(pdfPath);
+        timings.stage1 = Date.now() - t;
+        // raw 模式：只输出 Stage1 数据
+        if (opts.raw) {
+            timings.total = Date.now() - overallStart;
+            return {
+                data: rawData,
+                broker: plugin.name,
+                raw: true,
+                metadata: { timings, parserVersion: '0.1.0' },
+            };
+        }
+        // Step 3: Stage2 格式化
+        t = Date.now();
+        const formatter = plugin.createFormatter();
+        let statementData = await formatter.format(rawData);
+        timings.stage2 = Date.now() - t;
+        // Step 4: Stage3 清理（可选）
+        t = Date.now();
+        if (!opts.noClean) {
+            const { result } = (0, cleaning_1.cleanStatementData)(statementData);
+            statementData = result;
+        }
+        timings.clean = Date.now() - t;
+        timings.total = Date.now() - overallStart;
+        return {
+            data: statementData,
+            broker: plugin.name,
+            raw: false,
+            metadata: { timings, parserVersion: '0.1.0' },
+        };
+    }
+}
+exports.ParsePipeline = ParsePipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAKH,yCAAgD;AAmChD,MAAa,aAAa;IACxB,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD,eAAe;IACf,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,OAAqB,EAAE;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,OAAO,GAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAEtF,+BAA+B;QAC/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEhC,wBAAwB;QACxB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEhC,uBAAuB;QACvB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;YAC1C,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3C,IAAI,aAAa,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEhC,wBAAwB;QACxB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,6BAAkB,EAAC,aAAa,CAAC,CAAC;YACrD,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE/B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;QAE1C,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,GAAG,EAAE,KAAK;YACV,QAAQ,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE;SAC9C,CAAC;IACJ,CAAC;CACF;AAvDD,sCAuDC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PluginRegistry — 券商插件注册表
+ *
+ * 管理所有已注册的 IBrokerPlugin 实例，支持：
+ * - 按名称精确获取
+ * - 列出全部已注册插件
+ * - 自动检测 PDF 所属券商（取置信度最高者）
+ */
+import { IBrokerPlugin } from '../types/plugin';
+export declare class PluginRegistry {
+    private readonly plugins;
+    /** 注册一个券商插件 */
+    register(plugin: IBrokerPlugin): void;
+    /** 按名称获取插件，找不到则抛异常 */
+    getPlugin(name: string): IBrokerPlugin;
+    /** 列出所有已注册插件 */
+    listPlugins(): IBrokerPlugin[];
+    /**
+     * 自动检测 PDF 所属券商
+     * 遍历所有插件调用 detect()，返回置信度最高且 >= 0.5 的插件
+     */
+    autoDetect(filePath: string): Promise<IBrokerPlugin>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D,eAAe;IACf,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAIrC,sBAAsB;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAQtC,gBAAgB;IAChB,WAAW,IAAI,aAAa,EAAE;IAI9B;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAoB3D"}