@kenz1117/dsh-ui-usage-billing 1.2.5 → 1.2.7

package/lib/types/aggregate.d.ts

@@ -392,6 +392,36 @@ export interface PerfSample {
     /** 无独立 request/header，以 step/start 起算（工具续写步骤）。 */
     estimated: boolean;
 }
+/**
+ * 会话级性能摘要（per model）：账本持久化形态——替代逐样本持久化，体积
+ * O(模型数) 而非 O(样本数)。计数/求和/极值精确合并；分位数（P50/P90）
+ * 在跨会话合并时按样本数加权（展示级近似）。进程内折叠的会话仍保留
+ * 完整样本（doc 生成走精确插值），仅账本恢复行以摘要参与聚合。
+ */
+export interface PerfModelDigest {
+    /** 样本数。 */
+    samples: number;
+    ttftSum: number;
+    ttftMax: number;
+    ttftSpikes: number;
+    ttftP50: number;
+    ttftP90: number;
+    /** 有可测生成速度的样本数。 */
+    tpsCount: number;
+    tpsSum: number;
+    /** 有可测总延迟的样本数。 */
+    latencyCount: number;
+    latencySum: number;
+    /** 以 step/start 估算的样本数。 */
+    estimated: number;
+}
+/** 会话级 小时×模型 性能摘要（只用均值，合并无损）。 */
+export interface PerfHourDigest {
+    samples: number;
+    ttftSum: number;
+    tpsCount: number;
+    tpsSum: number;
+}
 /** One persisted session's folded usage plus drill-down metadata. */
 export interface SessionFold {
     total: ModelUsage;
@@ -412,8 +442,13 @@ export interface SessionFold {
     planCalls: Map<string, number>;
     /** 每轮费用明细（按轮次号升序，不含 sessionId）；sessionId 在合并时补齐。 */
     turns: SessionTurnRow[];
-    /** 性能样本（有可测 TTFT 的调用，按事件次序折叠）。 */
+    /** 性能样本（有可测 TTFT 的调用，按事件次序折叠）；仅进程内折叠产生，
+     *  账本恢复行恒为空（其性能在 {@link SessionFold.perfDigest} 里）。 */
     perf: PerfSample[];
+    /** 账本恢复行的模型级性能摘要；进程内折叠恒为空（序列化时从样本构建）。 */
+    perfDigest: Map<string, PerfModelDigest>;
+    /** 账本恢复行的小时×模型性能摘要；进程内折叠恒为空。 */
+    perfHourDigest: Map<string, Map<string, PerfHourDigest>>;
     /** 角色归因中间量：消息文本长度（user/tool）与输入/输出成本实测拆分。 */
     roles: RoleFold;
     /** 日志里最新的 session/title 文本（无标题事件时 undefined）。 */
@@ -447,7 +482,11 @@ export interface SerializedSessionFold {
     unpricedModels: string[];
     planCalls: Record<string, number>;
     turns: SessionTurnRow[];
-    perf: PerfSample[];
+    /** v16 起以摘要持久化性能（体积 O(模型数) 而非 O(样本数)）；旧行的
+     *  `perf` 逐样本数组由加载边界迁移转换为摘要。 */
+    perfDigest: Record<string, PerfModelDigest>;
+    /** 小时×模型摘要（键 = {@link hourStamp}）；同上由迁移补齐。 */
+    perfHourDigest: Record<string, Record<string, PerfHourDigest>>;
     roles: RoleFold;
     lastActive: number;
 }
@@ -491,7 +530,7 @@ export interface UsageLedgerDocument {
  * 会话费用只剩最近一段，issue #29）。
  * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 14;
+export declare const FOLD_VERSION = 16;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并
@@ -505,7 +544,9 @@ export interface LedgerMigration {
 }
 /**
  * 账本迁移注册表。首条迁移给 1.0.6 及更早的行回填 foldVersion = 1（它们全部出自
- * header 归因算法）；此后新写入的行总带当前 {@link FOLD_VERSION}。
+ * header 归因算法）；perf 摘要化迁移把 v15 及更早行的逐样本 `perf` 数组转换为
+ * `perfDigest`/`perfHourDigest` 摘要（日志已删的行不再被重折，迁移是它们唯一的
+ * 收缩机会）；此后新写入的行总带当前 {@link FOLD_VERSION} 与摘要形态。
  */
 export declare const LEDGER_MIGRATIONS: readonly LedgerMigration[];
 /**
@@ -560,10 +601,25 @@ export interface UsageAggregator {
     /** Aggregate current usage, reusing cached per-session folds when their logs are untouched.
      *  并发调用共享同一次进行中的折叠（in-flight 去重），不会多倍全量重读。 */
     aggregate(): Promise<UsageStatsDocument>;
+    /**
+     * 按会话 id 取该会话的完整累计用量。doc 的 `byTurn` 封顶（最近 200 轮），
+     * 用户回到旧会话续聊时其轮次已被挤出，从 doc 反推会低估——这里直接读该
+     * 会话的缓存/账本折叠，是该会话的精确值（含联网搜索估算，口径与 total 一致）。
+     * @param sessionId - 会话 id（String(SessionId) 形态，与账本键同口径）。
+     * @returns 会话累计；日志与账本均无该会话时 undefined（调用方自行兜底）。
+     */
+    sessionUsageOf(sessionId: string): Promise<SessionUsageSummary | undefined>;
     /** 立刻落盘未保存的账本改动（无视节流），供插件卸载时调用；
      *  进行中的聚合先等完再存，折叠失败仍保存已成功部分。 */
     flush(): Promise<void>;
 }
+/** 单会话累计用量（{@link UsageAggregator.sessionUsageOf} 的返回）。 */
+export interface SessionUsageSummary {
+    calls: number;
+    cost: number;
+    input: number;
+    output: number;
+}
 /**
  * 聚合配置指纹：影响折叠语义的全部配置（订阅豁免、官方名单、路由别名、搜索估值）
  * 的稳定序列化。账本行的复用判定携带该指纹——用户改配置后（如为 grok build 加

package/lib/types/client/pricing.d.ts

@@ -159,17 +159,9 @@ export declare const WEEKEND_OFFPEAK_START_MS: number;
  * 1/0.02/4（峰 = 谷 × 2）。目录条目写现行（新）价；分界前的历史事件由
  * {@link computeCostAt} 按 {@link FLASH_REPRICED_OFFPEAK} 回算旧价，与
  * {@link PEAK_ERA_START_MS} 同一「按事件时刻分段适用规则」口径。
- * pro 例外：V4 Pro 的路由计费分界是 {@link PRO_OFFLINE_MS}（官方把原定
- * 09-10 的路由时点推迟到 09-14 12:00），不在本分界切换。
+ * V4 Pro 不在本分界内：官方取消了 09-14 的路由计划，pro 长期按刊例计费。
  */
 export declare const FLASH_REPRICE_MS: number;
-/**
- * V4 Pro 下线路由分界（UTC 2026-09-14T04:00:00Z，即北京时间 2026-09-14
- * 12:00）：官方价目页注释明确，此后至 V4.1 Pro 上线前，`deepseek-v4-pro`
- * 的请求全部路由至 V4.1 Flash 并按其单价计费——此前的请求仍按 V4 Pro
- * 峰谷刊例计费（官方原定 09-10 路由，后推迟到 09-14）。
- */
-export declare const PRO_OFFLINE_MS: number;
 /** 计费时段档位：高峰 / 空闲（官方 DeepSeek 刊例价：高峰 = 空闲 × 2）。 */
 export type PriceTierId = 'peak' | 'offPeak';
 /** 成本显示币种：人民币（国内模型直价）/ 美元（国外模型直价或换算显示）。 */
@@ -253,6 +245,12 @@ export interface ModelPrice extends PriceBand {
 export interface PricePromo {
     /** 折扣系数（0.5 = 五折）；仅 (0,1) 区间有效，非法值视为无促销。 */
     factor: number;
+    /**
+     * 分档折扣覆盖：厂商对不同档位给不同折扣时逐档指定（如 GPT-5.6 Sol 促销为
+     * 缓存 0.8 / 输入 0.8 / 输出 2/3）。缺省档位沿用 {@link factor}；单档取值
+     * 仅 (0,1) 区间有效，非法值回落 factor。
+     */
+    factors?: Partial<Record<'input' | 'cacheHit' | 'cacheMiss' | 'output', number>>;
     /**
      * 截止时刻（epoch ms）：该时刻及之后恢复刊例价。缺省表示厂商未公布截止日
      * 的长期活动（如「限时 5 折直至另行通知」），持续生效直至收到公告后补填。
@@ -354,8 +352,9 @@ export declare function isPriced(key: string): boolean;
  */
 export declare function isPromoActive(promo: PricePromo, nowMs: number): boolean;
 /**
- * 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 全部乘 factor 的
- * 副本，其余字段原样保留；不在促销期（过期/未开始/factor 非法）原样返回。
+ * 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 逐档乘折扣系数的
+ * 副本（某档在 promo.factors 有合法覆盖时用覆盖值，否则用 promo.factor），
+ * 其余字段原样保留；不在促销期（过期/未开始/factor 非法）原样返回。
  * 幂等由调用方保证——计价与费率表显示各自只折一次，勿对已折价副本重复应用。
  * @param entry - 目录条目（price 保持刊例价口径）。
  * @param nowMs - 判定时刻（epoch ms）。
@@ -368,8 +367,7 @@ export declare function applyPromo(entry: ModelEntry, nowMs: number): ModelEntry
  * {@link modelOf}）。探活模型在此逐个对价：内置已有的跳过去重；目录外但
  * models.dev 有价的按归一化 id 复用其 USD 价；两者皆无的标 `uncatalogued`。
  * 内置条目按 nowMs 折算限时促销（生效中的条目显示折后单价，过期自动恢复刊例价），
- * 应用路由分界期的现行价覆盖（V4 Pro 见 {@link applyRoutingDisplay}），并滤除
- * 已下线条目（retired：官方下线的型号不进面板，目录与历史回算保留）。
+ * 并滤除已下线条目（retired：官方下线的型号不进面板，目录与历史回算保留）。
  * @param nowMs - 促销判定时刻；缺省当前时刻。
  */
 export declare function catalogEntries(nowMs?: number): readonly ModelEntry[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "keywords": [
     "deepseek-harness",
     "deepseek",