@aipack-ai/eval 1.1.6 → 1.1.7

package/dist/index.d.ts

@@ -20,5 +20,10 @@ export type { CaseScore } from './src/core/scorer';
 export { validateEvalCase } from './src/core/validate';
 export { loadCases, defaultCasesDir, packageRoot, } from './src/core/loader';
 export type { LoadCasesResult } from './src/core/loader';
-export { runEval } from './src/core/runner';
+export { runEval, skipReason } from './src/core/runner';
 export { renderMarkdown, writeReport, writeBaseline, readBaseline, reportToBaseline, compareBaseline, finalizeReport, } from './src/core/report';
+export type { RenderOptions } from './src/core/report';
+export { LIVE_ENV_KEYS, parseModelSpec, resolveLiveSpec, createLiveLlm, resolveLiveLlm, describeLiveLlm, assertLiveReady, } from './src/core/live';
+export type { LiveLlmSpec, LiveLlm, ResolveLiveOptions } from './src/core/live';
+export { appendHistory, readHistory, renderHistoryTrend, reportToHistoryEntry, sparkline, } from './src/core/history';
+export type { HistoryEntry } from './src/core/history';

package/dist/index.js

@@ -21,6 +21,10 @@ export { expectedToScorers, resolveScorers, scoreTrace, RULE_SCORER_TYPES, runRu
 export { validateEvalCase } from './src/core/validate.js';
 export { loadCases, defaultCasesDir, packageRoot, } from './src/core/loader.js';
 // ─── Runner 与报告 ────────────────────────────────────────────────
-export { runEval } from './src/core/runner.js';
+export { runEval, skipReason } from './src/core/runner.js';
 export { renderMarkdown, writeReport, writeBaseline, readBaseline, reportToBaseline, compareBaseline, finalizeReport, } from './src/core/report.js';
+// ─── live 模式（真实 LLM，M3）─────────────────────────────────────
+export { LIVE_ENV_KEYS, parseModelSpec, resolveLiveSpec, createLiveLlm, resolveLiveLlm, describeLiveLlm, assertLiveReady, } from './src/core/live.js';
+// ─── 历史趋势（日环比可视化，M3）───────────────────────────────────
+export { appendHistory, readHistory, renderHistoryTrend, reportToHistoryEntry, sparkline, } from './src/core/history.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA0BH,kEAAkE;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,iEAAiE;AACjE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEtE,kEAAkE;AAClE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA0BH,kEAAkE;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,iEAAiE;AACjE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEtE,kEAAkE;AAClE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,8DAA8D;AAC9D,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,yDAAyD;AACzD,OAAO,EACL,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/src/cli.d.ts

@@ -3,9 +3,11 @@
  * packages/eval/src/cli.ts - aipack-eval 命令行入口
  *
  * 用法：
- *   aipack-eval run [--suite <name>]... [--cases-dir <dir>] [--repeats <n>]
- *                   [--report-dir <dir>] [--baseline <path>]
- *                   [--update-baseline] [--threshold <0.02>]
+ *   aipack-eval run [--suite <name>]... [--mode mock|live] [--model provider/id]
+ *                   [--api-key <key>] [--base-url <url>] [--temperature <0>]
+ *                   [--repeats <n>] [--cases-dir <dir>] [--report-dir <dir>]
+ *                   [--history <path>] [--baseline <path>] [--update-baseline]
+ *   aipack-eval history [--path <file>] [--limit <n>] [--json]
  *
  * 退出码：0 = 全过且无回归；1 = 有失败或回归；2 = 用法错误。
  */

package/dist/src/cli.js

@@ -3,29 +3,55 @@
  * packages/eval/src/cli.ts - aipack-eval 命令行入口
  *
  * 用法：
- *   aipack-eval run [--suite <name>]... [--cases-dir <dir>] [--repeats <n>]
- *                   [--report-dir <dir>] [--baseline <path>]
- *                   [--update-baseline] [--threshold <0.02>]
+ *   aipack-eval run [--suite <name>]... [--mode mock|live] [--model provider/id]
+ *                   [--api-key <key>] [--base-url <url>] [--temperature <0>]
+ *                   [--repeats <n>] [--cases-dir <dir>] [--report-dir <dir>]
+ *                   [--history <path>] [--baseline <path>] [--update-baseline]
+ *   aipack-eval history [--path <file>] [--limit <n>] [--json]
  *
  * 退出码：0 = 全过且无回归；1 = 有失败或回归；2 = 用法错误。
  */
 import { loadCases } from './core/loader.js';
 import { runEval } from './core/runner.js';
 import { finalizeReport, renderMarkdown } from './core/report.js';
-const USAGE = `用法: aipack-eval run [options]
+import { readHistory, renderHistoryTrend } from './core/history.js';
+const USAGE = `用法: aipack-eval <run|history> [options]
 
-选项:
+run 选项:
   --suite <name>         只跑指定套件（可多次）
+  --mode <mock|live>     运行模式（缺省 mock；live = 真实 LLM）
+  --model <provider/id>  live 模型，如 deepseek/deepseek-chat（或 AIPACK_EVAL_MODEL）
+  --api-key <key>        live API Key（或 <PROVIDER>_API_KEY）
+  --base-url <url>       live 端点覆盖（代理 / 兼容网关）
+  --temperature <x>      live 采样温度（缺省 0）
+  --repeats <n>          每用例重复次数（live 缺省 3，pass@k 判定）
+  --concurrency <n>      并发用例数（缺省 8）
+  --timeout <ms>         单用例墙钟超时（缺省 30000）
+  --max-tokens <n>       全局 token 预算，超限熔断剩余用例
   --cases-dir <dir>      用例目录（缺省 <包根>/eval/cases）
-  --report-dir <dir>     报告输出目录（缺省 ./eval-results；'none' 不写盘）
+  --report-dir <dir>     报告输出目录（缺省不写盘；'none' 不写盘）
+  --history <path>       历史趋势 JSONL（缺省 <report-dir>/history.jsonl）
   --baseline <path>      baseline 文件（门禁对比）
   --update-baseline      用本次结果更新 baseline
   --threshold <x>        通过率回归阈值（缺省 0.02）
-  --repeats <n>          每用例重复次数（缺省 1）
+
+history 选项:
+  --path <file>          历史文件（缺省 ./eval-results/history.jsonl）
+  --limit <n>            展示最近 N 次（缺省 15）
+  --json                 输出原始 JSONL 条目
+
+公共:
   -h, --help             显示帮助`;
-function parseArgs(argv) {
+function num(raw, label) {
+    const v = Number(raw);
+    if (!Number.isFinite(v))
+        throw new Error(`${label} 必须为数字`);
+    return v;
+}
+function parseRunArgs(argv) {
     const args = {
         suites: [],
+        mode: 'mock',
         updateBaseline: false,
         threshold: 0.02,
     };
@@ -40,18 +66,65 @@ function parseArgs(argv) {
         };
         try {
             switch (a) {
-                case 'run':
-                    args.command = 'run';
-                    break;
                 case '--suite':
                     args.suites.push(next());
                     break;
+                case '--mode': {
+                    const v = next();
+                    if (v !== 'mock' && v !== 'live')
+                        throw new Error('--mode 只能为 mock 或 live');
+                    args.mode = v;
+                    break;
+                }
+                case '--model':
+                    args.model = next();
+                    break;
+                case '--api-key':
+                    args.apiKey = next();
+                    break;
+                case '--base-url':
+                    args.baseUrl = next();
+                    break;
+                case '--temperature':
+                    args.temperature = num(next(), '--temperature');
+                    break;
+                case '--repeats': {
+                    const v = Number(next());
+                    if (!Number.isInteger(v) || v < 1)
+                        throw new Error('repeats 须为正整数');
+                    args.repeats = v;
+                    break;
+                }
+                case '--concurrency': {
+                    const v = Number(next());
+                    if (!Number.isInteger(v) || v < 1)
+                        throw new Error('concurrency 须为正整数');
+                    args.concurrency = v;
+                    break;
+                }
+                case '--timeout': {
+                    const v = Number(next());
+                    if (!Number.isFinite(v) || v <= 0)
+                        throw new Error('timeout 须为正数(ms)');
+                    args.timeoutMs = v;
+                    break;
+                }
+                case '--max-tokens': {
+                    const v = Number(next());
+                    if (!Number.isFinite(v) || v <= 0)
+                        throw new Error('max-tokens 须为正数');
+                    args.maxTotalTokens = v;
+                    break;
+                }
                 case '--cases-dir':
                     args.casesDir = next();
                     break;
                 case '--report-dir':
                     args.reportDir = next();
                     break;
+                case '--history':
+                    args.historyPath = next();
+                    break;
                 case '--baseline':
                     args.baselinePath = next();
                     break;
@@ -65,13 +138,6 @@ function parseArgs(argv) {
                     args.threshold = v;
                     break;
                 }
-                case '--repeats': {
-                    const v = Number(next());
-                    if (!Number.isInteger(v) || v < 1)
-                        throw new Error('repeats 须为正整数');
-                    args.repeats = v;
-                    break;
-                }
                 case '-h':
                 case '--help':
                     return { error: 'HELP' };
@@ -84,12 +150,10 @@ function parseArgs(argv) {
         }
         i += 1;
     }
-    if (args.command !== 'run')
-        return { error: `缺少子命令 'run'\n${USAGE}` };
     return args;
 }
-async function main() {
-    const parsed = parseArgs(process.argv.slice(2));
+async function cmdRun(argv) {
+    const parsed = parseRunArgs(argv);
     if ('error' in parsed) {
         if (parsed.error === 'HELP') {
             console.log(USAGE);
@@ -109,22 +173,45 @@ async function main() {
         console.error('没有可运行的用例');
         return 1;
     }
+    const reportDir = parsed.reportDir === 'none' ? undefined : parsed.reportDir;
+    const historyPath = parsed.historyPath ?? (reportDir ? `${reportDir.replace(/\/$/, '')}/history.jsonl` : undefined);
     const config = {
-        mode: 'mock',
+        mode: parsed.mode,
+        model: parsed.model,
+        apiKey: parsed.apiKey,
+        baseUrl: parsed.baseUrl,
+        temperature: parsed.temperature,
         suites: parsed.suites,
         repeats: parsed.repeats,
+        concurrency: parsed.concurrency,
+        timeoutMs: parsed.timeoutMs,
+        maxTotalTokens: parsed.maxTotalTokens,
         casesDir: parsed.casesDir,
-        reportDir: parsed.reportDir === 'none' ? undefined : parsed.reportDir,
+        reportDir,
+        historyPath,
         baselinePath: parsed.baselinePath,
         updateBaseline: parsed.updateBaseline,
         regressionThreshold: parsed.threshold,
     };
-    console.error(`加载 ${cases.length} 个用例${parsed.suites.length ? `（套件: ${parsed.suites.join(', ')}）` : ''}，mode=mock`);
-    const report = await runEval(cases, config);
+    console.error(`加载 ${cases.length} 个用例${parsed.suites.length ? `（套件: ${parsed.suites.join(', ')}）` : ''}，mode=${parsed.mode}`);
+    let report;
+    try {
+        report = await runEval(cases, config);
+    }
+    catch (e) {
+        // live 装配失败（缺模型 / 缺 Key）属于使用错误
+        console.error(`live 模式配置错误: ${e.message}`);
+        return 2;
+    }
     const finalized = await finalizeReport(report, config);
-    console.log(renderMarkdown(report));
+    console.log(renderMarkdown(report, { history: finalized.history }));
+    if (report.totals.cases === 0) {
+        console.error(`\n⚠️  当前 mode=${parsed.mode} 下没有可运行的用例（${report.totals.skipped} 个被跳过），检查 --suite 与 --mode 是否匹配`);
+    }
     if (finalized.jsonPath)
         console.error(`\n报告已写入: ${finalized.jsonPath}`);
+    if (finalized.historyPath)
+        console.error(`历史已追加: ${finalized.historyPath}`);
     if (config.updateBaseline && finalized.baseline === undefined) {
         console.error(`baseline 已更新: ${config.baselinePath}`);
     }
@@ -142,6 +229,55 @@ async function main() {
     }
     return exitCode;
 }
+async function cmdHistory(argv) {
+    let path = 'eval-results/history.jsonl';
+    let limit = 15;
+    let asJson = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--json') {
+            asJson = true;
+        }
+        else if (a === '--path') {
+            path = argv[++i] ?? path;
+        }
+        else if (a === '--limit') {
+            limit = Number(argv[++i] ?? limit);
+        }
+        else if (a === '-h' || a === '--help') {
+            console.log(USAGE);
+            return 0;
+        }
+        else {
+            console.error(`未知参数: ${a}\n${USAGE}`);
+            return 2;
+        }
+    }
+    const entries = await readHistory(path, limit);
+    if (entries.length === 0) {
+        console.error(`历史文件为空或不存在: ${path}`);
+        return 1;
+    }
+    if (asJson) {
+        console.log(entries.map((e) => JSON.stringify(e)).join('\n'));
+        return 0;
+    }
+    console.log(renderHistoryTrend(entries, limit));
+    return 0;
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    if (command === undefined || command === '-h' || command === '--help') {
+        console.log(USAGE);
+        return command === undefined ? 2 : 0;
+    }
+    if (command === 'run')
+        return cmdRun(rest);
+    if (command === 'history')
+        return cmdHistory(rest);
+    console.error(`未知子命令: ${command}\n${USAGE}`);
+    return 2;
+}
 main().then((code) => process.exit(code), (e) => {
     console.error(e);
     process.exit(1);

package/dist/src/cli.js.map

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

package/dist/src/core/history.d.ts

@@ -0,0 +1,39 @@
+/**
+ * packages/eval/src/core/history.ts - 历史趋势（日环比可视化）
+ *
+ * 每次运行向 JSONL 追加一行（append-only，天然按时间序），
+ * 读回后渲染 Markdown：趋势 sparkline + 逐次通过率 + 环比 Δ。
+ *
+ * 为什么用 JSONL 而不是单文件 JSON：cron 场景下并发/追加写更安全，
+ * 且 diff 友好（一行一次运行）。
+ */
+import type { EvalReport, SuiteSummary } from './types';
+/** 每次运行落一行（JSONL） */
+export interface HistoryEntry {
+    runId: string;
+    /** ISO 时间 */
+    at: string;
+    mode: 'mock' | 'live';
+    model?: string;
+    cases: number;
+    passed: number;
+    skipped: number;
+    passRate: number;
+    avgScore: number;
+    durationMs: number;
+    usageTotal: number;
+    bySuite: Record<string, Pick<SuiteSummary, 'total' | 'passed' | 'passRate'>>;
+}
+/** 报告 → 历史条目 */
+export declare function reportToHistoryEntry(report: EvalReport): HistoryEntry;
+/** 追加一次运行记录（JSONL，一行一条） */
+export declare function appendHistory(report: EvalReport, historyPath: string): Promise<string>;
+/** 读取历史（最新在最后）；文件不存在返回空数组 */
+export declare function readHistory(historyPath: string, limit?: number): Promise<HistoryEntry[]>;
+/** 0~1 序列 → sparkline 字符串 */
+export declare function sparkline(values: number[], width?: number): string;
+/**
+ * 渲染通过率趋势（Markdown）。
+ * 环比定义：与上一次运行对比（cron 每日跑 → 即日环比）。
+ */
+export declare function renderHistoryTrend(entries: HistoryEntry[], limit?: number): string;

package/dist/src/core/history.js

@@ -0,0 +1,134 @@
+/**
+ * packages/eval/src/core/history.ts - 历史趋势（日环比可视化）
+ *
+ * 每次运行向 JSONL 追加一行（append-only，天然按时间序），
+ * 读回后渲染 Markdown：趋势 sparkline + 逐次通过率 + 环比 Δ。
+ *
+ * 为什么用 JSONL 而不是单文件 JSON：cron 场景下并发/追加写更安全，
+ * 且 diff 友好（一行一次运行）。
+ */
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+/** 报告 → 历史条目 */
+export function reportToHistoryEntry(report) {
+    return {
+        runId: report.runId,
+        at: report.startedAt,
+        mode: report.mode,
+        model: report.model,
+        cases: report.totals.cases,
+        passed: report.totals.passed,
+        skipped: report.totals.skipped,
+        passRate: report.totals.passRate,
+        avgScore: report.totals.avgScore,
+        durationMs: report.durationMs,
+        usageTotal: report.totals.usageTotal,
+        bySuite: Object.fromEntries(Object.entries(report.bySuite).map(([k, s]) => [
+            k,
+            { total: s.total, passed: s.passed, passRate: s.passRate },
+        ])),
+    };
+}
+/** 追加一次运行记录（JSONL，一行一条） */
+export async function appendHistory(report, historyPath) {
+    const path = resolve(historyPath);
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, `${JSON.stringify(reportToHistoryEntry(report))}\n`, 'utf-8');
+    return path;
+}
+/** 读取历史（最新在最后）；文件不存在返回空数组 */
+export async function readHistory(historyPath, limit = 30) {
+    const path = resolve(historyPath);
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const line of raw.split('\n')) {
+        const s = line.trim();
+        if (!s)
+            continue;
+        try {
+            entries.push(JSON.parse(s));
+        }
+        catch {
+            // 坏行跳过（不因一行损坏丢掉整份历史）
+        }
+    }
+    return limit > 0 ? entries.slice(-limit) : entries;
+}
+// ─── 可视化 ───────────────────────────────────────────────────────
+const SPARK_CHARS = '▁▂▃▄▅▆▇█';
+/** 0~1 序列 → sparkline 字符串 */
+export function sparkline(values, width = 20) {
+    if (values.length === 0)
+        return '';
+    const seq = values.slice(-width);
+    return seq
+        .map((v) => {
+        const clamped = Math.min(1, Math.max(0, Number.isFinite(v) ? v : 0));
+        const idx = Math.round(clamped * (SPARK_CHARS.length - 1));
+        return SPARK_CHARS[idx];
+    })
+        .join('');
+}
+function pct(x) {
+    return `${(x * 100).toFixed(1)}%`;
+}
+function deltaCell(cur, prev) {
+    if (prev === undefined)
+        return '—';
+    const d = (cur - prev) * 100;
+    if (Math.abs(d) < 0.05)
+        return '±0.0%';
+    const sign = d > 0 ? '+' : '';
+    const icon = d < 0 ? '🔻' : '🔺';
+    return `${icon}${sign}${d.toFixed(1)}%`;
+}
+function shortAt(iso) {
+    // 2026-09-29T03:12:44.123Z → 09-29 03:12
+    return `${iso.slice(5, 10)} ${iso.slice(11, 16)}`;
+}
+/**
+ * 渲染通过率趋势（Markdown）。
+ * 环比定义：与上一次运行对比（cron 每日跑 → 即日环比）。
+ */
+export function renderHistoryTrend(entries, limit = 15) {
+    if (entries.length === 0)
+        return '（暂无历史记录）';
+    const rows = entries.slice(-limit);
+    const lines = [];
+    const rates = rows.map((e) => e.passRate);
+    const latest = rows[rows.length - 1];
+    const prev = rows.length > 1 ? rows[rows.length - 2] : undefined;
+    lines.push(`\`${sparkline(rates)}\`  最近 ${rows.length} 次：${pct(latest.passRate)}（环比 ${deltaCell(latest.passRate, prev?.passRate)}）`);
+    lines.push('');
+    lines.push(`| 时间(UTC) | 模式 | 模型 | 通过 | 通过率 | 环比 Δ | 平均分 | 耗时 |`);
+    lines.push(`|---|---|---|---|---|---|---|---|`);
+    rows.forEach((e, i) => {
+        lines.push(`| ${shortAt(e.at)} | ${e.mode} | ${e.model ?? '—'} | ${e.passed}/${e.cases} | ${pct(e.passRate)} | ${deltaCell(e.passRate, i > 0 ? rows[i - 1].passRate : undefined)} | ${e.avgScore.toFixed(2)} | ${(e.durationMs / 1000).toFixed(1)}s |`);
+    });
+    // 分套件环比：定位是哪一组掉了
+    const suiteDeltas = [];
+    if (prev) {
+        for (const [suite, cur] of Object.entries(latest.bySuite)) {
+            const before = prev.bySuite[suite];
+            if (!before)
+                continue;
+            const d = (cur.passRate - before.passRate) * 100;
+            if (Math.abs(d) >= 0.05) {
+                suiteDeltas.push(`  - ${suite}: ${pct(before.passRate)} → ${pct(cur.passRate)}（${d > 0 ? '+' : ''}${d.toFixed(1)}%）`);
+            }
+        }
+    }
+    if (suiteDeltas.length > 0) {
+        lines.push('');
+        lines.push(`分套件环比:`);
+        lines.push(...suiteDeltas);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=history.js.map

package/dist/src/core/history.js.map

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

package/dist/src/core/live.d.ts

@@ -0,0 +1,77 @@
+/**
+ * packages/eval/src/core/live.ts - live 模式（真实 LLM）装配
+ *
+ * 职责：把「provider/modelId + apiKey + baseUrl」装配成 Runtime 可直接消费的
+ * `{ model, streamFn }`，与 mock 模式的 fixture replay 对称。
+ *
+ * 消随机性（EVAL_PLAN.md 4.3）：
+ *   - temperature 缺省 0（provider 支持即生效）
+ *   - 本仓库适配层不支持 seed → 靠 repeats + pass@k 消噪，见 runner.ts
+ *
+ * 装配路径：getBuiltinModel（内置目录）→ 兜底构造 custom model（代理 / 兼容网关）
+ *   → adaptAiModel（框架 Model）+ createStreamFnFromAi（StreamFn）
+ */
+import type { Model as AiModel } from '@aipack-ai/agent/ai';
+import type { Model, StreamFn } from '@aipack-ai/agent';
+export interface LiveLlmSpec {
+    /** 提供商 id：deepseek / openai / anthropic / ... */
+    provider: string;
+    /** 模型 id：deepseek-chat / gpt-4o-mini / ...（不在内置目录时按 custom 兜底） */
+    modelId: string;
+    /** API Key；缺省取 <PROVIDER>_API_KEY 环境变量 */
+    apiKey?: string;
+    /** 覆盖内置端点（代理 / 兼容网关） */
+    baseUrl?: string;
+    /** 缺省 0（消随机性） */
+    temperature?: number;
+    /** 单次请求超时 ms */
+    timeoutMs?: number;
+}
+export interface LiveLlm {
+    spec: LiveLlmSpec;
+    /** AI 层模型（含 api / baseUrl） */
+    aiModel: AiModel;
+    /** 框架层 Model，放进 RuntimeOptions.model */
+    model: Model;
+    /** 真实流式函数，放进 RuntimeOptions.streamFn */
+    streamFn: StreamFn;
+}
+/** env 覆盖键（优先级低于显式参数，便于 CI 用 secrets 注入） */
+export declare const LIVE_ENV_KEYS: {
+    readonly model: "AIPACK_EVAL_MODEL";
+    readonly provider: "AIPACK_EVAL_PROVIDER";
+    readonly apiKey: "AIPACK_EVAL_API_KEY";
+    readonly baseUrl: "AIPACK_EVAL_BASE_URL";
+    readonly temperature: "AIPACK_EVAL_TEMPERATURE";
+};
+/**
+ * 解析 'provider/modelId' 或 'modelId'。
+ * 仅给 modelId 时：优先 AIPACK_EVAL_PROVIDER，否则探测第一个已配置 Key 的 provider。
+ */
+export declare function parseModelSpec(spec: string): {
+    provider: string;
+    modelId: string;
+};
+export interface ResolveLiveOptions {
+    /** 'provider/modelId' 或 'modelId'；缺省读 AIPACK_EVAL_MODEL */
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    temperature?: number;
+    timeoutMs?: number;
+}
+/** 合并显式参数与环境变量，得到最终生效的 LiveLlmSpec */
+export declare function resolveLiveSpec(opts?: ResolveLiveOptions): LiveLlmSpec;
+/**
+ * 装配真实 LLM。不发起任何网络请求（只是闭包），可安全单测。
+ *
+ * 注意：createStreamFnFromAi 优先使用 runtime 传入的 model，
+ * 因此必须把返回的 model 一起交给 createRuntime，否则 api 分派会不一致。
+ */
+export declare function createLiveLlm(spec: LiveLlmSpec): LiveLlm;
+/** 从 CLI/库参数一步到位：解析 spec → 装配 LLM */
+export declare function resolveLiveLlm(opts?: ResolveLiveOptions): LiveLlm;
+/** 报告 / 日志用的模型标识（'deepseek/deepseek-chat'） */
+export declare function describeLiveLlm(spec: LiveLlmSpec): string;
+/** live 模式前置检查：缺 Key 时给出可操作的错误信息 */
+export declare function assertLiveReady(spec: LiveLlmSpec): void;