@skillfm/local 2.7.3 → 2.7.4

package/dist/reconciliation/l1-reconciler.d.ts

@@ -0,0 +1,29 @@
+import type { Vault } from '../vault/index.js';
+import type { Connector } from '../connectors/types.js';
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { ReconciliationResult, DeviationLevel } from './types.js';
+/**
+ * 偏差分级 (Eric 决策点 #1, 拍板 ACTIVE):
+ *   < 5%: healthy
+ *   5-15%: warning
+ *   15-30%: medium
+ *   > 30%: severe
+ */
+export declare function classifyDeviation(deviation_pct: number): DeviationLevel;
+export interface L1ReconcileDeps {
+    vault: Vault;
+    /** Connector registry: provider → Connector instance */
+    connectors: Record<string, Connector>;
+    store: LocalUsageStore;
+}
+export interface L1ReconcileOptions {
+    provider: string;
+    start: string;
+    end: string;
+}
+/**
+ * L1 对账: 单 provider, 时间窗口
+ * 返 ReconciliationResult, 含 l1_actual_usd / deviation_pct / level / anomalies.
+ */
+export declare function reconcileL1(deps: L1ReconcileDeps, opts: L1ReconcileOptions): Promise<ReconciliationResult>;
+//# sourceMappingURL=l1-reconciler.d.ts.map

package/dist/reconciliation/l1-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1-reconciler.d.ts","sourceRoot":"","sources":["../../src/reconciliation/l1-reconciler.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EAEf,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAKvE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAwG/B"}

package/dist/reconciliation/l1-reconciler.js

@@ -0,0 +1,144 @@
+// sdk/skillfm-local/src/reconciliation/l1-reconciler.ts
+//
+// L1 reconciliation — provider admin API 真账单 vs L0 本地估算.
+// 仅 OpenAI / Anthropic 真支持 admin usage API.
+//
+// 流程:
+//   1. 从 vault 拿 admin key (BYOK)
+//   2. 调 connector.fetchUsage(key, {start, end}) 拿真账单 UsageRecord[]
+//   3. 加总 estimated_usd → 真 cost (provider 自己算的)
+//   4. 跟 L0 store 同窗口聚合的 estimated_cost_usd 对比
+//   5. 偏差 = abs(L0 - L1) / L1, 分级 → ReconciliationResult
+const L1_PROVIDERS = new Set(['openai', 'anthropic']);
+/**
+ * 偏差分级 (Eric 决策点 #1, 拍板 ACTIVE):
+ *   < 5%: healthy
+ *   5-15%: warning
+ *   15-30%: medium
+ *   > 30%: severe
+ */
+export function classifyDeviation(deviation_pct) {
+    if (deviation_pct < 5)
+        return 'healthy';
+    if (deviation_pct < 15)
+        return 'warning';
+    if (deviation_pct < 30)
+        return 'medium';
+    return 'severe';
+}
+/**
+ * L1 对账: 单 provider, 时间窗口
+ * 返 ReconciliationResult, 含 l1_actual_usd / deviation_pct / level / anomalies.
+ */
+export async function reconcileL1(deps, opts) {
+    const provider = opts.provider.toLowerCase();
+    const reconciledAt = new Date().toISOString();
+    // 基础聚合 L0 数字 (无 BYOK key 仍可显示)
+    const l0Agg = deps.store.aggregate({
+        start: opts.start,
+        end: opts.end,
+        providers: [provider],
+    });
+    const l0_estimated_usd = l0Agg.total_cost_usd;
+    if (!L1_PROVIDERS.has(provider)) {
+        // L1 不支持此 provider (可能走 L2 或无任何 reconciliation)
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: [],
+            human_summary: `${provider} 不支持 L1 admin API 对账 (尝试 L2 balance 差量)`,
+        };
+    }
+    const key = await deps.vault.get(provider);
+    if (!key) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: ['no_byok_key'],
+            human_summary: `${provider} 无 BYOK key, 仅显示 L0 估算 ¥${(l0_estimated_usd * 7.3).toFixed(2)}; 添加 admin key 即可对账验真`,
+        };
+    }
+    const connector = deps.connectors[provider];
+    if (!connector) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: [],
+            human_summary: `${provider} connector 未配置`,
+        };
+    }
+    // 调真 admin API
+    let l1_actual_usd;
+    try {
+        const records = await connector.fetchUsage(key, {
+            start_date: new Date(opts.start),
+            end_date: new Date(opts.end),
+        });
+        l1_actual_usd = records.reduce((sum, r) => sum + (r.estimated_usd ?? 0), 0);
+    }
+    catch (e) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: ['l1_api_stale'],
+            human_summary: `${provider} admin API 调用失败 (${e.message.slice(0, 80)}), 仅显示 L0 估算`,
+        };
+    }
+    // 计算偏差
+    const deviation_pct = l1_actual_usd > 0
+        ? Math.abs(l0_estimated_usd - l1_actual_usd) / l1_actual_usd * 100
+        : 0;
+    const level = classifyDeviation(deviation_pct);
+    const anomalies = [];
+    if (level === 'severe')
+        anomalies.push('price_table_outdated');
+    const human_summary = buildL1Summary({
+        provider,
+        l0_estimated_usd,
+        l1_actual_usd,
+        deviation_pct,
+        level,
+    });
+    return {
+        provider,
+        reconciled_at: reconciledAt,
+        window_start: opts.start,
+        window_end: opts.end,
+        l0_estimated_usd,
+        l1_actual_usd,
+        deviation_pct,
+        level,
+        anomalies,
+        human_summary,
+    };
+}
+function buildL1Summary(input) {
+    const cny0 = (input.l0_estimated_usd * 7.3).toFixed(2);
+    const cny1 = (input.l1_actual_usd * 7.3).toFixed(2);
+    const pct = input.deviation_pct.toFixed(1);
+    const emoji = {
+        healthy: '✅',
+        warning: '⚠',
+        medium: '🔴',
+        severe: '🚨',
+        no_data: '❓',
+    }[input.level];
+    return `${input.provider}: 估算 ¥${cny0} vs 真扣 ¥${cny1} 偏差 ${pct}% ${emoji}`;
+}
+//# sourceMappingURL=l1-reconciler.js.map

package/dist/reconciliation/l1-reconciler.js.map

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

package/dist/reconciliation/l2-reconciler.d.ts

@@ -0,0 +1,21 @@
+import type { Vault } from '../vault/index.js';
+import type { Connector } from '../connectors/types.js';
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { ReconciliationResult } from './types.js';
+export interface L2ReconcileDeps {
+    vault: Vault;
+    connectors: Record<string, Connector>;
+    store: LocalUsageStore;
+    /** Override balance history file path (默认 ~/.skillfm/balance-history.jsonl) */
+    historyPath?: string;
+}
+export interface L2ReconcileOptions {
+    provider: string;
+    start: string;
+    end: string;
+}
+/**
+ * L2 对账: 单 provider, 时间窗口
+ */
+export declare function reconcileL2(deps: L2ReconcileDeps, opts: L2ReconcileOptions): Promise<ReconciliationResult>;
+//# sourceMappingURL=l2-reconciler.d.ts.map

package/dist/reconciliation/l2-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2-reconciler.d.ts","sourceRoot":"","sources":["../../src/reconciliation/l2-reconciler.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,KAAK,EAAE,eAAe,CAAC;IACvB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAsED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAiJ/B"}

package/dist/reconciliation/l2-reconciler.js

@@ -0,0 +1,241 @@
+// sdk/skillfm-local/src/reconciliation/l2-reconciler.ts
+//
+// L2 reconciliation — provider balance 差量 vs L0 本地估算.
+// 适用 DeepSeek / Kimi 等只暴露 balance 不暴露 usage 的 provider.
+//
+// 流程:
+//   1. 维护 balance 历史快照 (~/.skillfm/balance-history.jsonl)
+//   2. 每次 reconcile 时, 拉当前 balance + 历史窗口起始点 balance, 算 drop
+//   3. balance_drop = old_balance - new_balance (单位 USD)
+//   4. 跟 L0 同窗口估算对比, 偏差分级
+//   5. 余额耗尽预测: days_to_zero = current_balance / 7天日均 drop
+//   6. 异常: drop 速度 > 用量增长 × 1.5 → balance_drop_too_fast (可能盗用)
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { classifyDeviation } from './l1-reconciler.js';
+const L2_PROVIDERS = new Set(['deepseek', 'kimi']);
+const DEFAULT_HISTORY_PATH = path.join(homedir(), '.skillfm', 'balance-history.jsonl');
+/**
+ * 加载 balance 历史快照 (jsonl)
+ */
+async function loadHistory(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const text = await fs.promises.readFile(filePath, 'utf-8');
+    const out = [];
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('{'))
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip malformed
+        }
+    }
+    return out.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+}
+/**
+ * Append 一个 balance snapshot
+ */
+async function appendSnapshot(filePath, snap) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+    }
+    await fs.promises.appendFile(filePath, JSON.stringify(snap) + '\n', { mode: 0o600 });
+}
+/**
+ * 找窗口起始点附近的 balance snapshot (用于计算 drop)
+ * 策略: 找 windowStart 之前最近的一个 snapshot (上一次 poll 的余额 = 窗口开始时余额)
+ */
+function findWindowStartBalance(history, provider, windowStart) {
+    const ws = Date.parse(windowStart);
+    let best = null;
+    for (const s of history) {
+        if (s.provider !== provider)
+            continue;
+        const ts = Date.parse(s.timestamp);
+        if (ts > ws)
+            break; // history 已 sorted
+        best = s;
+    }
+    return best;
+}
+/**
+ * 计算近 7 天日均消费 (用 history snapshots 算 drop / 天数)
+ */
+function computeAvgDailyDrop(history, provider) {
+    const now = Date.now();
+    const sevenDaysAgo = now - 7 * 24 * 3600 * 1000;
+    const recent = history.filter((s) => s.provider === provider && Date.parse(s.timestamp) >= sevenDaysAgo);
+    if (recent.length < 2)
+        return null;
+    const first = recent[0];
+    const last = recent[recent.length - 1];
+    const days = Math.max(0.5, (Date.parse(last.timestamp) - Date.parse(first.timestamp)) / 86400000);
+    const drop = first.balance_usd - last.balance_usd;
+    if (drop <= 0)
+        return null;
+    return drop / days;
+}
+/**
+ * L2 对账: 单 provider, 时间窗口
+ */
+export async function reconcileL2(deps, opts) {
+    const provider = opts.provider.toLowerCase();
+    const reconciledAt = new Date().toISOString();
+    const historyPath = deps.historyPath ?? DEFAULT_HISTORY_PATH;
+    const l0Agg = deps.store.aggregate({
+        start: opts.start,
+        end: opts.end,
+        providers: [provider],
+    });
+    const l0_estimated_usd = l0Agg.total_cost_usd;
+    if (!L2_PROVIDERS.has(provider)) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: [],
+            human_summary: `${provider} 不支持 L2 balance 对账`,
+        };
+    }
+    const key = await deps.vault.get(provider);
+    if (!key) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: ['no_byok_key'],
+            human_summary: `${provider} 无 BYOK key, 仅显示 L0 估算 ¥${(l0_estimated_usd * 7.3).toFixed(2)}; 添加 key 即可看真余额 + 对账验真`,
+        };
+    }
+    const connector = deps.connectors[provider];
+    if (!connector) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: [],
+            human_summary: `${provider} connector 未配置`,
+        };
+    }
+    // 拉当前 balance (DeepSeek/Kimi connector 返 estimated_usd 字段实际是 balance USD)
+    let current_balance_usd;
+    try {
+        const records = await connector.fetchUsage(key, {
+            start_date: new Date(opts.start),
+            end_date: new Date(opts.end),
+        });
+        current_balance_usd = records[0]?.estimated_usd ?? 0;
+    }
+    catch (e) {
+        return {
+            provider,
+            reconciled_at: reconciledAt,
+            window_start: opts.start,
+            window_end: opts.end,
+            l0_estimated_usd,
+            level: 'no_data',
+            anomalies: ['l1_api_stale'],
+            human_summary: `${provider} balance API 调用失败 (${e.message.slice(0, 80)}), 仅显示 L0 估算`,
+        };
+    }
+    // 持久化新 snapshot (无论后面计算如何, 这次 poll 的 balance 必须存)
+    const newSnapshot = {
+        provider,
+        timestamp: reconciledAt,
+        balance_usd: current_balance_usd,
+    };
+    await appendSnapshot(historyPath, newSnapshot);
+    // 加载历史 (含刚 append 的 newSnapshot 之前的 records)
+    const history = await loadHistory(historyPath);
+    const startSnapshot = findWindowStartBalance(history, provider, opts.start);
+    let l2_balance_drop_usd;
+    let deviation_pct;
+    let level = 'no_data';
+    const anomalies = [];
+    if (startSnapshot) {
+        l2_balance_drop_usd = Math.max(0, startSnapshot.balance_usd - current_balance_usd);
+        if (l2_balance_drop_usd > 0) {
+            deviation_pct = Math.abs(l0_estimated_usd - l2_balance_drop_usd) / l2_balance_drop_usd * 100;
+            level = classifyDeviation(deviation_pct);
+            // 异常: balance drop 速度 > L0 估算 × 1.5 (可能盗用)
+            if (l2_balance_drop_usd > l0_estimated_usd * 1.5 && l0_estimated_usd > 0.01) {
+                anomalies.push('balance_drop_too_fast');
+            }
+        }
+        else {
+            // 余额没掉 (用户充钱了 / 或没消费)
+            level = 'healthy';
+            l2_balance_drop_usd = 0;
+        }
+    }
+    else {
+        // 无历史 snapshot, 这是首次 poll, 无法对账
+        level = 'no_data';
+    }
+    // 余额耗尽预测
+    const avgDailyDrop = computeAvgDailyDrop(history, provider);
+    const days_to_zero = avgDailyDrop && avgDailyDrop > 0
+        ? current_balance_usd / avgDailyDrop
+        : null;
+    if (days_to_zero != null) {
+        if (days_to_zero < 3)
+            anomalies.push('budget_critical');
+        else if (days_to_zero < 7)
+            anomalies.push('budget_exhausting');
+    }
+    const human_summary = buildL2Summary({
+        provider,
+        l0_estimated_usd,
+        l2_balance_drop_usd,
+        current_balance_usd,
+        days_to_zero,
+        deviation_pct,
+        level,
+    });
+    return {
+        provider,
+        reconciled_at: reconciledAt,
+        window_start: opts.start,
+        window_end: opts.end,
+        l0_estimated_usd,
+        l2_balance_drop_usd,
+        deviation_pct,
+        level,
+        anomalies,
+        remaining_balance_usd: current_balance_usd,
+        days_to_zero,
+        human_summary,
+    };
+}
+function buildL2Summary(input) {
+    const balCny = (input.current_balance_usd * 7.3).toFixed(2);
+    const days = input.days_to_zero != null ? input.days_to_zero.toFixed(1) : '?';
+    const dropCny = input.l2_balance_drop_usd != null
+        ? (input.l2_balance_drop_usd * 7.3).toFixed(2)
+        : null;
+    if (input.level === 'no_data' || dropCny == null) {
+        return `${input.provider}: 余额 ¥${balCny}, 收集中 (首次 poll)`;
+    }
+    const cny0 = (input.l0_estimated_usd * 7.3).toFixed(2);
+    const pct = input.deviation_pct?.toFixed(1) ?? '?';
+    const emoji = {
+        healthy: '✅', warning: '⚠', medium: '🔴', severe: '🚨', no_data: '❓',
+    }[input.level];
+    return `${input.provider}: 估算 ¥${cny0} vs 真扣 ¥${dropCny} 偏差 ${pct}% ${emoji} | 余额 ¥${balCny} → ${days} 天耗尽`;
+}
+//# sourceMappingURL=l2-reconciler.js.map

package/dist/reconciliation/l2-reconciler.js.map

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

package/dist/reconciliation/types.d.ts

@@ -0,0 +1,49 @@
+export type DeviationLevel = 'healthy' | 'warning' | 'medium' | 'severe' | 'no_data';
+export type AnomalyKind = 'balance_drop_too_fast' | 'l1_api_stale' | 'no_byok_key' | 'price_table_outdated' | 'budget_exhausting' | 'budget_critical';
+/**
+ * 单 provider 的对账结果 (一个时间窗口内)
+ */
+export interface ReconciliationResult {
+    provider: string;
+    reconciled_at: string;
+    window_start: string;
+    window_end: string;
+    /** L0: 本地 trajectory 估算的成本 USD */
+    l0_estimated_usd: number;
+    /** L1: provider admin API 拉的真账单 USD (仅 OpenAI/Anthropic) */
+    l1_actual_usd?: number;
+    /** L2: provider balance 在窗口内的下跌量 USD (仅 DeepSeek/Kimi 等) */
+    l2_balance_drop_usd?: number;
+    /** 跟"真"对比的偏差百分比 (优先 L1 > L2) */
+    deviation_pct?: number;
+    /** 偏差分级 */
+    level: DeviationLevel;
+    /** 检测到的异常 */
+    anomalies: AnomalyKind[];
+    /** L2 当前余额 USD (仅 DeepSeek/Kimi 等有 balance) */
+    remaining_balance_usd?: number;
+    /** L2 余额耗尽预测 (按当前 7 天日均) */
+    days_to_zero?: number | null;
+    /** 人类可读的解释 (用于 surface 给 agent / 用户) */
+    human_summary: string;
+}
+/**
+ * 对账窗口选项
+ */
+export interface ReconcileOptions {
+    /** ISO 8601 起始 (默认今日 00:00) */
+    start?: string;
+    /** ISO 8601 结束 (默认现在) */
+    end?: string;
+    /** 仅这些 provider (默认所有 vault 里有 key 的) */
+    providers?: string[];
+}
+/**
+ * Balance 历史快照 (持久化在 ~/.skillfm/balance-history.jsonl)
+ */
+export interface BalanceSnapshot {
+    provider: string;
+    timestamp: string;
+    balance_usd: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reconciliation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reconciliation/types.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GACnB,uBAAuB,GACvB,cAAc,GACd,aAAa,GACb,sBAAsB,GACtB,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,WAAW;IACX,KAAK,EAAE,cAAc,CAAC;IAEtB,aAAa;IACb,SAAS,EAAE,WAAW,EAAE,CAAC;IAEzB,+CAA+C;IAC/C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/reconciliation/types.js

@@ -0,0 +1,9 @@
+// sdk/skillfm-local/src/reconciliation/types.ts
+//
+// L0+L1+L2 三口径对账 — 真护城河 (PRD V1.3 §5).
+// 对账 = 把 L0 (本地 trajectory 估算) 跟 L1 (provider admin API) /
+// L2 (provider balance diff) 真账单交叉验证.
+//
+// 输出: ReconciliationResult (per-provider, 跟时间窗口对应).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reconciliation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reconciliation/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uCAAuC;AACvC,2DAA2D;AAC3D,sCAAsC;AACtC,EAAE;AACF,oDAAoD"}

package/dist/save-token/e1-router.d.ts

@@ -0,0 +1,7 @@
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { SaveTokenSuggestion, SaveTokenScanOptions } from './types.js';
+/**
+ * 扫描 + 返建议
+ */
+export declare function scanE1Router(store: LocalUsageStore, opts: SaveTokenScanOptions): Promise<SaveTokenSuggestion[]>;
+//# sourceMappingURL=e1-router.d.ts.map

package/dist/save-token/e1-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e1-router.d.ts","sourceRoot":"","sources":["../../src/save-token/e1-router.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA2C5E;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoEhC"}

package/dist/save-token/e1-router.js

@@ -0,0 +1,112 @@
+// sdk/skillfm-local/src/save-token/e1-router.ts
+//
+// E1 Free 智能 Model Router — cascading 启发式 (PRD §6.2 Phase 1).
+// 扫 trajectory 找 expensive model 调用, 推荐切 cheaper 同档.
+//
+// MVP: 只做规则启发式 (基于价目表 + model family 映射).
+// Pro 升级 (2.7.5): 通过 gateway hook 真自动 cascade + brain LLM 评 quality.
+import { getModelPrice, USD_TO_CNY } from '../usage-local/model-pricing.js';
+import { timeWindow } from '../usage-local/store.js';
+/**
+ * Model family 映射: expensive → cheaper 同档替代
+ * 仅在质量"通常"够 (90%+) 的场景下推荐. 用户决定切不切.
+ */
+const CASCADE_MAP = [
+    {
+        expensive_pattern: /claude.*opus/i,
+        cheaper: { provider: 'anthropic', model_id: 'claude-sonnet-4-6' },
+        description: 'Opus 级任务很多 Sonnet 4.6 能干 (95%+ 质量)',
+    },
+    {
+        expensive_pattern: /claude.*sonnet/i,
+        cheaper: { provider: 'anthropic', model_id: 'claude-haiku-4-5' },
+        description: '日常 Sonnet 调用 80% 任务 Haiku 4.5 同质量, 价格 1/4',
+    },
+    {
+        expensive_pattern: /(gpt-4o|gpt-4-turbo)$/i,
+        cheaper: { provider: 'openai', model_id: 'gpt-4o-mini' },
+        description: 'GPT-4o 很多任务 4o-mini 同质量, 价格 1/17',
+    },
+    {
+        expensive_pattern: /^o1$/i,
+        cheaper: { provider: 'openai', model_id: 'o1-mini' },
+        description: 'o1 reasoning 任务 o1-mini 同等推理能力, 价格 1/5',
+    },
+    {
+        expensive_pattern: /minimax-m2\.7/i,
+        cheaper: { provider: 'minimax-cn', model_id: 'MiniMax-M2.5' },
+        description: 'M2.7 → M2.5 价格 1/2.5, 大部分 routine 任务质量同档',
+    },
+    {
+        expensive_pattern: /deepseek-v4-pro/i,
+        cheaper: { provider: 'deepseek', model_id: 'deepseek-v4-flash' },
+        description: 'V4 Pro → V4 Flash 价格 1/5',
+    },
+];
+/**
+ * 扫描 + 返建议
+ */
+export async function scanE1Router(store, opts) {
+    const window = opts.start && opts.end
+        ? { start: opts.start, end: opts.end }
+        : timeWindow('week'); // 默认近 7 天
+    const records = store.query(window);
+    if (records.length === 0)
+        return [];
+    // 按 (provider, model) 聚合
+    const byModel = new Map();
+    for (const r of records) {
+        const key = `${r.provider}/${r.model_id}`;
+        const cur = byModel.get(key) ?? { count: 0, tokens_in: 0, tokens_out: 0, cost_usd: 0 };
+        cur.count += 1;
+        cur.tokens_in += r.input_tokens;
+        cur.tokens_out += r.output_tokens;
+        cur.cost_usd += r.estimated_cost_usd;
+        byModel.set(key, cur);
+    }
+    const suggestions = [];
+    for (const [key, agg] of byModel) {
+        if (agg.cost_usd < 0.5)
+            continue; // 低于 ¥3.65 不值得 surface
+        for (const rule of CASCADE_MAP) {
+            if (rule.expensive_pattern.test(key)) {
+                // 算切 cheaper 后估省
+                const cheaperPrice = getModelPrice(rule.cheaper.provider, rule.cheaper.model_id);
+                const newCost = (agg.tokens_in / 1_000_000) * cheaperPrice.input_per_1m
+                    + (agg.tokens_out / 1_000_000) * cheaperPrice.output_per_1m;
+                const savings_usd = agg.cost_usd - newCost;
+                if (savings_usd <= 0)
+                    continue;
+                const savings_pct = (savings_usd / agg.cost_usd) * 100;
+                // 月度估算 (从 7 天 → 30 天 × 4.3 比例)
+                const monthly_savings_usd = savings_usd * (30 / 7);
+                const monthly_savings_tokens = (agg.tokens_in + agg.tokens_out) * (30 / 7);
+                const fix_method = opts.is_pro ? 'pro_auto' : 'free_manual';
+                suggestions.push({
+                    engine: 'E1_router',
+                    headline: `${agg.count} 次 ${key} 调用可切 ${rule.cheaper.provider}/${rule.cheaper.model_id} (${rule.description.slice(0, 50)}...)`,
+                    estimated_savings_pct: Math.round(savings_pct),
+                    estimated_savings_tokens: Math.round(monthly_savings_tokens),
+                    estimated_savings_cny: Math.round(monthly_savings_usd * USD_TO_CNY * 100) / 100,
+                    fix_method,
+                    fix_instructions: opts.is_pro
+                        ? undefined
+                        : `在你 IDE 中, 把 model 设置改成 ${rule.cheaper.provider}/${rule.cheaper.model_id}; 或手动针对 routine 任务用 cheaper model`,
+                    pro_unlock_label: opts.is_pro
+                        ? undefined
+                        : `Pro 升级后 SkillFM gateway 自动 cascade routing — 估月省 ¥${Math.round(monthly_savings_usd * USD_TO_CNY)}`,
+                    details: {
+                        from_model: key,
+                        to_model: `${rule.cheaper.provider}/${rule.cheaper.model_id}`,
+                        calls_in_window: agg.count,
+                        cost_usd_window: agg.cost_usd,
+                    },
+                });
+                break; // 一个 expensive model 只推一个 cheaper 候选
+            }
+        }
+    }
+    // 按估省排序, 大头先 surface
+    return suggestions.sort((a, b) => b.estimated_savings_cny - a.estimated_savings_cny);
+}
+//# sourceMappingURL=e1-router.js.map