@skillfm/local 2.7.3 → 2.7.5

package/dist/usage-local/openclaw-watcher.js

@@ -0,0 +1,190 @@
+// sdk/skillfm-local/src/usage-local/openclaw-watcher.ts
+//
+// OpenClaw trajectory watcher — 监听 ~/.openclaw/agents/<id>/sessions/*.trajectory.jsonl
+// 提 model.completed events 转 LocalUsageRecord, 调 store.appendBatch().
+//
+// Schema 真验证 (2026-05-03 在赵云 OpenClaw 2026.4.29 上):
+//   model.completed event 自带 {ts, provider, modelId, data: {usage: {input, output, cacheRead, cacheWrite, total}}}
+//
+// 设计: 用 node 内置 fs.watch (不引入 chokidar). 增量读 (记录每个 file 的最后 byte offset).
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { estimateCostUsd, estimateCostCny } from './model-pricing.js';
+const DEFAULT_OPENCLAW_AGENTS_DIR = path.join(homedir(), '.openclaw', 'agents');
+/**
+ * OpenClaw trajectory watcher
+ *
+ * 启动后:
+ *   1. 扫现有 *.trajectory.jsonl, 全量解析 (warm start)
+ *   2. fs.watch 监听新文件 + 现有文件 append
+ *   3. 增量解析 (记录每个 file 的最后 byte offset)
+ *   4. 调 store.appendBatch 持久化
+ */
+export class OpenClawWatcher {
+    offsets = new Map(); // file path → last byte offset
+    watchers = [];
+    agentsDir;
+    agent_harness = 'openclaw';
+    store;
+    verbose;
+    constructor(opts) {
+        this.store = opts.store;
+        this.agentsDir = opts.agentsDir ?? DEFAULT_OPENCLAW_AGENTS_DIR;
+        this.verbose = opts.verbose ?? false;
+    }
+    /** 启动:warm-scan 现有文件 + 注册 fs.watch */
+    async start() {
+        if (!fs.existsSync(this.agentsDir)) {
+            this.log(`OpenClaw agents dir not found: ${this.agentsDir} — skipping watcher`);
+            return;
+        }
+        // Warm scan — 解析所有现有 trajectory.jsonl
+        const files = await this.discoverTrajectoryFiles();
+        this.log(`warm-scanning ${files.length} OpenClaw trajectory files`);
+        for (const file of files) {
+            await this.scanFile(file);
+        }
+        // 注册 fs.watch — 监听 agents/ 目录递归
+        this.registerWatchers();
+        this.log('OpenClaw watcher live');
+    }
+    /** 扫一次现有所有文件 (manual trigger, 用于 cron poll fallback) */
+    async scanAll() {
+        const files = await this.discoverTrajectoryFiles();
+        let total = 0;
+        for (const file of files) {
+            total += await this.scanFile(file);
+        }
+        return total;
+    }
+    /** 关闭 watcher */
+    stop() {
+        for (const w of this.watchers)
+            w.close();
+        this.watchers = [];
+    }
+    // ─────────────────────────────────────────────────────────────────
+    async discoverTrajectoryFiles() {
+        const out = [];
+        const agents = await fs.promises.readdir(this.agentsDir, { withFileTypes: true });
+        for (const agent of agents) {
+            if (!agent.isDirectory())
+                continue;
+            const sessionsDir = path.join(this.agentsDir, agent.name, 'sessions');
+            if (!fs.existsSync(sessionsDir))
+                continue;
+            const sessions = await fs.promises.readdir(sessionsDir);
+            for (const f of sessions) {
+                if (f.endsWith('.trajectory.jsonl')) {
+                    out.push(path.join(sessionsDir, f));
+                }
+            }
+        }
+        return out;
+    }
+    async scanFile(filePath) {
+        const stat = await fs.promises.stat(filePath).catch(() => null);
+        if (!stat || stat.size === 0)
+            return 0;
+        const lastOffset = this.offsets.get(filePath) ?? 0;
+        if (stat.size <= lastOffset)
+            return 0; // no new data
+        // 增量读: 从 lastOffset 到 size
+        const buf = Buffer.alloc(stat.size - lastOffset);
+        const fd = await fs.promises.open(filePath, 'r');
+        try {
+            await fd.read(buf, 0, buf.length, lastOffset);
+        }
+        finally {
+            await fd.close();
+        }
+        const text = buf.toString('utf-8');
+        const records = [];
+        let validLineEnd = 0; // 记录最后一个完整行的位置 (jsonl 可能 truncated)
+        let cursor = 0;
+        while (cursor < text.length) {
+            const newlineIdx = text.indexOf('\n', cursor);
+            if (newlineIdx === -1)
+                break; // 不完整行,等下次 scan
+            const line = text.slice(cursor, newlineIdx).trim();
+            cursor = newlineIdx + 1;
+            validLineEnd = lastOffset + cursor;
+            if (!line || !line.startsWith('{'))
+                continue;
+            try {
+                const event = JSON.parse(line);
+                const record = this.eventToRecord(event, filePath);
+                if (record)
+                    records.push(record);
+            }
+            catch {
+                // 解析失败 (jsonl 偶尔 partial), 跳过
+            }
+        }
+        // 更新 offset (只 update 到最后完整行,partial 行下次再读)
+        this.offsets.set(filePath, validLineEnd);
+        if (records.length > 0) {
+            await this.store.appendBatch(records);
+            this.log(`${path.basename(filePath)}: +${records.length} records`);
+        }
+        return records.length;
+    }
+    eventToRecord(event, filePath) {
+        if (event.type !== 'model.completed')
+            return null;
+        const usage = event.data?.usage;
+        if (!usage)
+            return null;
+        const provider = event.provider ?? 'unknown';
+        const model_id = event.modelId ?? 'unknown';
+        const input_tokens = usage.input ?? 0;
+        const output_tokens = usage.output ?? 0;
+        const cache_read_tokens = usage.cacheRead ?? 0;
+        const cache_write_tokens = usage.cacheWrite ?? 0;
+        const total_tokens = (usage.total ?? input_tokens + output_tokens);
+        const id = `oc:${event.sessionId}:${event.ts}:${event.runId ?? ''}`;
+        return {
+            id,
+            timestamp: event.ts,
+            agent_harness: this.agent_harness,
+            session_id: event.sessionId,
+            provider,
+            model_id,
+            input_tokens,
+            output_tokens,
+            cache_read_tokens,
+            cache_write_tokens,
+            total_tokens,
+            estimated_cost_usd: estimateCostUsd(provider, model_id, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens),
+            estimated_cost_cny: estimateCostCny(provider, model_id, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens),
+            source_file: filePath,
+        };
+    }
+    registerWatchers() {
+        // 单层 watch agents/ + 子目录变化时再 walk
+        try {
+            const w = fs.watch(this.agentsDir, { recursive: true }, (_eventType, filename) => {
+                if (!filename)
+                    return;
+                if (!filename.endsWith('.trajectory.jsonl'))
+                    return;
+                const fullPath = path.join(this.agentsDir, filename);
+                // 异步 scan, 不 block watcher
+                this.scanFile(fullPath).catch((e) => {
+                    this.log(`scan failed ${filename}: ${e.message}`);
+                });
+            });
+            this.watchers.push(w);
+        }
+        catch (e) {
+            // 某些系统不支持 recursive (Linux 部分内核), fallback 不报错
+            this.log(`fs.watch recursive not supported, falling back to cron-only: ${e.message}`);
+        }
+    }
+    log(msg) {
+        if (this.verbose)
+            console.error(`[usage-local/openclaw] ${msg}`);
+    }
+}
+//# sourceMappingURL=openclaw-watcher.js.map

package/dist/usage-local/openclaw-watcher.js.map

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

package/dist/usage-local/plan.d.ts

@@ -0,0 +1,58 @@
+export type PlanType = 'pay-per-token' | 'subscription' | 'mixed';
+export interface ProviderPlan {
+    /** Provider 标识 (e.g. 'minimax-cn', 'openai', 'anthropic') */
+    provider: string;
+    /** Plan 类型 */
+    type: PlanType;
+    /** 订阅相关 (type='subscription' 时必填) */
+    subscription?: {
+        /** 月度 token 额度 (input + output) */
+        tokens_quota_monthly: number;
+        /** 当月起始日期 (ISO date) — 通常是订阅日 */
+        period_start_iso: string;
+        /** Plan 显示名 (e.g. "Claude Pro / Cursor Pro / MiniMax 月度套餐") */
+        display_name: string;
+        /** 月费 (用于"性价比" 对比) */
+        monthly_price_cny?: number;
+    };
+}
+export interface PlanConfig {
+    /** Default plan type (没显式配的 provider 走这个) */
+    default_type: PlanType;
+    /** Per-provider 配置 */
+    providers: Record<string, ProviderPlan>;
+}
+export declare const DEFAULT_PLAN_CONFIG: PlanConfig;
+/**
+ * 加载 plan 配置, 没有则返默认
+ */
+export declare function loadPlanConfig(filePath?: string): Promise<PlanConfig>;
+/**
+ * 保存 plan 配置
+ */
+export declare function savePlanConfig(cfg: PlanConfig, filePath?: string): Promise<void>;
+/**
+ * 查 provider 真 plan (没显式配则返 default 类型 + 空 subscription)
+ */
+export declare function getProviderPlan(cfg: PlanConfig, provider: string): ProviderPlan;
+/**
+ * 渲染 provider 用量行 — 根据 plan 类型自动切换 surface 模式
+ *
+ * 输入: provider name + 用量数字
+ * 输出:
+ *   pay-per-token: "minimax-cn: 今日 ¥6.60"
+ *   subscription:  "minimax-cn: 今日 271K token / 套餐 5.4% (Pro 月度)"
+ */
+export declare function renderProviderUsage(opts: {
+    plan: ProviderPlan;
+    total_tokens: number;
+    cost_cny: number;
+    period: 'today' | 'week' | 'month';
+    /** 距月底剩多少 token (subscription 用, 算 days_to_zero) */
+    remaining_in_period_tokens?: number;
+}): string;
+/**
+ * Token 数格式化 (1234567 → "1.2M", 12345 → "12K")
+ */
+export declare function formatTokens(n: number): string;
+//# sourceMappingURL=plan.d.ts.map

package/dist/usage-local/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/usage-local/plan.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,QAAQ,GAChB,eAAe,GACf,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,qCAAqC;IACrC,YAAY,CAAC,EAAE;QACb,mCAAmC;QACnC,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iCAAiC;QACjC,gBAAgB,EAAE,MAAM,CAAC;QACzB,+DAA+D;QAC/D,YAAY,EAAE,MAAM,CAAC;QACrB,sBAAsB;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,YAAY,EAAE,QAAQ,CAAC;IACvB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,mBAAmB,EAAE,UAGjC,CAAC;AAEF;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,GAAE,MAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAStF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAI/E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,oDAAoD;IACpD,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,GAAG,MAAM,CAgBT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/usage-local/plan.js

@@ -0,0 +1,84 @@
+// sdk/skillfm-local/src/usage-local/plan.ts
+//
+// 订阅 Plan 配置 (V1.4 校准 — Eric Q1: 订阅套餐用户不该 surface "¥X 花了").
+//
+// 真问题: Eric 用 MiniMax 是订阅套餐, 我 surface "今日 ¥6.60" 对他没意义.
+// 真该 surface: "今日 271K token / 套餐月度 5M token, 占 5.4%, 30 天耗尽预测".
+//
+// 持久化: ~/.skillfm/plan.json (用户首次配置后写)
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+const PLAN_FILE = path.join(homedir(), '.skillfm', 'plan.json');
+export const DEFAULT_PLAN_CONFIG = {
+    default_type: 'pay-per-token',
+    providers: {},
+};
+/**
+ * 加载 plan 配置, 没有则返默认
+ */
+export async function loadPlanConfig(filePath = PLAN_FILE) {
+    if (!fs.existsSync(filePath))
+        return DEFAULT_PLAN_CONFIG;
+    try {
+        const text = await fs.promises.readFile(filePath, 'utf-8');
+        const cfg = JSON.parse(text);
+        return { ...DEFAULT_PLAN_CONFIG, ...cfg };
+    }
+    catch {
+        return DEFAULT_PLAN_CONFIG;
+    }
+}
+/**
+ * 保存 plan 配置
+ */
+export async function savePlanConfig(cfg, filePath = PLAN_FILE) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+    }
+    await fs.promises.writeFile(filePath, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+/**
+ * 查 provider 真 plan (没显式配则返 default 类型 + 空 subscription)
+ */
+export function getProviderPlan(cfg, provider) {
+    const exact = cfg.providers[provider.toLowerCase()];
+    if (exact)
+        return exact;
+    return { provider: provider.toLowerCase(), type: cfg.default_type };
+}
+/**
+ * 渲染 provider 用量行 — 根据 plan 类型自动切换 surface 模式
+ *
+ * 输入: provider name + 用量数字
+ * 输出:
+ *   pay-per-token: "minimax-cn: 今日 ¥6.60"
+ *   subscription:  "minimax-cn: 今日 271K token / 套餐 5.4% (Pro 月度)"
+ */
+export function renderProviderUsage(opts) {
+    const { plan, total_tokens, cost_cny, period } = opts;
+    const periodLabel = { today: '今日', week: '本周', month: '本月' }[period];
+    if (plan.type === 'subscription' && plan.subscription) {
+        const quota = plan.subscription.tokens_quota_monthly;
+        const usedPct = quota > 0 ? (total_tokens / quota) * 100 : 0;
+        const tokensStr = formatTokens(total_tokens);
+        const quotaStr = formatTokens(quota);
+        const planName = plan.subscription.display_name;
+        return `${plan.provider}: ${periodLabel} ${tokensStr} / 套餐 ${quotaStr} (${usedPct.toFixed(1)}% 已用, ${planName})`;
+    }
+    // pay-per-token (or unconfigured)
+    const tokensStr = formatTokens(total_tokens);
+    return `${plan.provider}: ${periodLabel} ${tokensStr} (估 ¥${cost_cny.toFixed(2)})`;
+}
+/**
+ * Token 数格式化 (1234567 → "1.2M", 12345 → "12K")
+ */
+export function formatTokens(n) {
+    if (n >= 1_000_000)
+        return (n / 1_000_000).toFixed(1) + 'M';
+    if (n >= 1_000)
+        return (n / 1_000).toFixed(0) + 'K';
+    return String(n);
+}
+//# sourceMappingURL=plan.js.map

package/dist/usage-local/plan.js.map

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

package/dist/usage-local/store.d.ts

@@ -0,0 +1,50 @@
+import type { LocalUsageRecord, AgentHarness, UsageAggregation, UsageByProvider, UsageByAgent, UsageByModel } from './types.js';
+export interface UsageQuery {
+    /** ISO 8601 起始 (含) */
+    start?: string;
+    /** ISO 8601 结束 (不含) */
+    end?: string;
+    /** 仅这些 provider */
+    providers?: string[];
+    /** 仅这些 agent harness */
+    agents?: AgentHarness[];
+}
+/**
+ * Local usage store
+ * - in-memory Map (id → record) for dedup + 快速 query
+ * - jsonl 持久化 (append-only, 每条 record 一行)
+ * - load() 从 jsonl 重建 in-memory state
+ */
+export declare class LocalUsageStore {
+    private records;
+    private filePath;
+    private dirty;
+    constructor(opts?: {
+        filePath?: string;
+    });
+    /** 启动时从文件 load */
+    load(): Promise<void>;
+    /** 批量 append (dedup by id), 写文件 */
+    appendBatch(batch: LocalUsageRecord[]): Promise<number>;
+    /** 当前所有 records 数 */
+    size(): number;
+    /** Query records (基础筛选) */
+    query(q?: UsageQuery): LocalUsageRecord[];
+    /** 时间窗口聚合 (总数) */
+    aggregate(q?: UsageQuery): UsageAggregation;
+    /** 按 provider 聚合 */
+    aggregateByProvider(q?: UsageQuery): UsageByProvider[];
+    /** 按 agent harness 聚合 */
+    aggregateByAgent(q?: UsageQuery): UsageByAgent[];
+    /** 按 (provider, model) 聚合 */
+    aggregateByModel(q?: UsageQuery): UsageByModel[];
+    /** Helper: 聚合 records 列表 */
+    private aggregateRecords;
+    /** 清空 (测试用 / 用户主动清) */
+    clear(): Promise<void>;
+}
+/**
+ * 时间窗口快捷:今日 / 本周 / 本月
+ */
+export declare function timeWindow(period: 'today' | 'week' | 'month' | 'all'): UsageQuery;
+//# sourceMappingURL=store.d.ts.map

package/dist/usage-local/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/usage-local/store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;IAI5C,kBAAkB;IACZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,mCAAmC;IAC7B,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB7D,qBAAqB;IACrB,IAAI,IAAI,MAAM;IAId,2BAA2B;IAC3B,KAAK,CAAC,CAAC,GAAE,UAAe,GAAG,gBAAgB,EAAE;IAiB7C,kBAAkB;IAClB,SAAS,CAAC,CAAC,GAAE,UAAe,GAAG,gBAAgB;IAK/C,oBAAoB;IACpB,mBAAmB,CAAC,CAAC,GAAE,UAAe,GAAG,eAAe,EAAE;IAe1D,yBAAyB;IACzB,gBAAgB,CAAC,CAAC,GAAE,UAAe,GAAG,YAAY,EAAE;IAcpD,6BAA6B;IAC7B,gBAAgB,CAAC,CAAC,GAAE,UAAe,GAAG,YAAY,EAAE;IAoBpD,4BAA4B;IAC5B,OAAO,CAAC,gBAAgB;IAuBxB,uBAAuB;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAejF"}

package/dist/usage-local/store.js

@@ -0,0 +1,201 @@
+// sdk/skillfm-local/src/usage-local/store.ts
+//
+// LocalUsageStore — 持久化 + 时序聚合 query.
+// 第一版用 in-memory + JSON 文件持久化 (~/.skillfm/usage-local.json),
+// 0 新依赖. 后续如果数据量大 (>10k records) 再换 sqlite (better-sqlite3).
+//
+// 文件格式: append-only JSONL (每行一个 LocalUsageRecord), 高效 + 可恢复.
+// dedup 靠 record.id (基于 sessionId+timestamp+runId 的稳定 hash).
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_STORE_PATH = path.join(homedir(), '.skillfm', 'usage-local.jsonl');
+/**
+ * Local usage store
+ * - in-memory Map (id → record) for dedup + 快速 query
+ * - jsonl 持久化 (append-only, 每条 record 一行)
+ * - load() 从 jsonl 重建 in-memory state
+ */
+export class LocalUsageStore {
+    records = new Map();
+    filePath;
+    dirty = false;
+    constructor(opts = {}) {
+        this.filePath = opts.filePath ?? DEFAULT_STORE_PATH;
+    }
+    /** 启动时从文件 load */
+    async load() {
+        if (!fs.existsSync(this.filePath)) {
+            // 确保目录存在
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+            }
+            return;
+        }
+        const text = await fs.promises.readFile(this.filePath, 'utf-8');
+        for (const line of text.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || !trimmed.startsWith('{'))
+                continue;
+            try {
+                const r = JSON.parse(trimmed);
+                if (r.id)
+                    this.records.set(r.id, r);
+            }
+            catch {
+                // skip malformed
+            }
+        }
+    }
+    /** 批量 append (dedup by id), 写文件 */
+    async appendBatch(batch) {
+        if (batch.length === 0)
+            return 0;
+        const newRecords = [];
+        for (const r of batch) {
+            if (!this.records.has(r.id)) {
+                this.records.set(r.id, r);
+                newRecords.push(r);
+            }
+        }
+        if (newRecords.length === 0)
+            return 0;
+        // 确保目录存在 (defensive)
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+        }
+        const lines = newRecords.map((r) => JSON.stringify(r)).join('\n') + '\n';
+        await fs.promises.appendFile(this.filePath, lines, { mode: 0o600 });
+        return newRecords.length;
+    }
+    /** 当前所有 records 数 */
+    size() {
+        return this.records.size;
+    }
+    /** Query records (基础筛选) */
+    query(q = {}) {
+        const startMs = q.start ? Date.parse(q.start) : 0;
+        const endMs = q.end ? Date.parse(q.end) : Number.MAX_SAFE_INTEGER;
+        const providerSet = q.providers ? new Set(q.providers.map((p) => p.toLowerCase())) : null;
+        const agentSet = q.agents ? new Set(q.agents) : null;
+        const out = [];
+        for (const r of this.records.values()) {
+            const ts = Date.parse(r.timestamp);
+            if (ts < startMs || ts >= endMs)
+                continue;
+            if (providerSet && !providerSet.has(r.provider.toLowerCase()))
+                continue;
+            if (agentSet && !agentSet.has(r.agent_harness))
+                continue;
+            out.push(r);
+        }
+        return out.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+    /** 时间窗口聚合 (总数) */
+    aggregate(q = {}) {
+        const records = this.query(q);
+        return this.aggregateRecords(records, q.start ?? '', q.end ?? '');
+    }
+    /** 按 provider 聚合 */
+    aggregateByProvider(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const key = r.provider;
+            const list = groups.get(key) ?? [];
+            list.push(r);
+            groups.set(key, list);
+        }
+        return Array.from(groups.entries()).map(([provider, rs]) => ({
+            provider,
+            ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+        }));
+    }
+    /** 按 agent harness 聚合 */
+    aggregateByAgent(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const list = groups.get(r.agent_harness) ?? [];
+            list.push(r);
+            groups.set(r.agent_harness, list);
+        }
+        return Array.from(groups.entries()).map(([agent_harness, rs]) => ({
+            agent_harness,
+            ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+        }));
+    }
+    /** 按 (provider, model) 聚合 */
+    aggregateByModel(q = {}) {
+        const records = this.query(q);
+        const groups = new Map();
+        for (const r of records) {
+            const key = `${r.provider}/${r.model_id}`;
+            const list = groups.get(key) ?? [];
+            list.push(r);
+            groups.set(key, list);
+        }
+        return Array.from(groups.entries()).map(([key, rs]) => {
+            const [provider, ...rest] = key.split('/');
+            const model_id = rest.join('/');
+            return {
+                provider: provider,
+                model_id,
+                ...this.aggregateRecords(rs, q.start ?? '', q.end ?? ''),
+            };
+        });
+    }
+    /** Helper: 聚合 records 列表 */
+    aggregateRecords(records, start, end) {
+        let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, costUsd = 0, costCny = 0;
+        for (const r of records) {
+            input += r.input_tokens;
+            output += r.output_tokens;
+            cacheRead += r.cache_read_tokens;
+            cacheWrite += r.cache_write_tokens;
+            costUsd += r.estimated_cost_usd;
+            costCny += r.estimated_cost_cny;
+        }
+        return {
+            window_start: start,
+            window_end: end,
+            input_tokens: input,
+            output_tokens: output,
+            cache_read_tokens: cacheRead,
+            cache_write_tokens: cacheWrite,
+            total_cost_usd: costUsd,
+            total_cost_cny: costCny,
+            call_count: records.length,
+        };
+    }
+    /** 清空 (测试用 / 用户主动清) */
+    async clear() {
+        this.records.clear();
+        if (fs.existsSync(this.filePath)) {
+            await fs.promises.unlink(this.filePath);
+        }
+    }
+}
+/**
+ * 时间窗口快捷:今日 / 本周 / 本月
+ */
+export function timeWindow(period) {
+    const now = new Date();
+    if (period === 'all')
+        return {};
+    if (period === 'today') {
+        const start = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        return { start: start.toISOString() };
+    }
+    if (period === 'week') {
+        const start = new Date(now);
+        start.setDate(now.getDate() - 7);
+        return { start: start.toISOString() };
+    }
+    // month
+    const start = new Date(now.getFullYear(), now.getMonth(), 1);
+    return { start: start.toISOString() };
+}
+//# sourceMappingURL=store.js.map

package/dist/usage-local/store.js.map

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