@kenz1117/dsh-ui-usage-billing 1.0.18 → 1.0.20

package/lib/index.js

@@ -210,6 +210,44 @@ function currentRate() {
 /** Default share of traffic assumed to fall in the peak band (0..1). */
 const DEFAULT_PEAK_SHARE = .5;
 /**
+* 峰谷计价时代分界（UTC 2026-08-16T16:00:00Z，即北京时间 2026-08-17 00:00）：
+* DeepSeek V4 自此起按峰/谷两档计价。此前官方只有基础价一档——历史事件若
+* 套现行峰/谷档价会把成本高估约 50%（谷价 = 基础价 × 1.5）。半开区间：该
+* 时刻及之后按峰谷档计。
+*/
+const PEAK_ERA_START_MS = Date.parse("2026-08-16T16:00:00Z");
+/**
+* 周末全谷规则分界（UTC 2026-08-22T16:00:00Z，即北京时间 2026-08-23 00:00）：
+* 官方自此刻起周六/周日全天不区分峰谷（高峰时段收窄为工作日）；生效前的
+* 周末仍按 v1 峰谷规则（周六日 9-12 / 14-18 同样是高峰时段）。历史事件的
+* 档位判定按事件所在时段适用各自的规则，不得统一套现行规则重算历史。
+*/
+const WEEKEND_OFFPEAK_START_MS = Date.parse("2026-08-22T16:00:00Z");
+/**
+* DeepSeek V4 峰谷时代之前的官方基础价（CNY / 1M tokens）：官方中文定价页
+* 峰谷改版前的基础价档（缓存写沿用历史规则按命中价计）。键为内置目录键，
+* flash-vision-exp 与 flash 同价。仅当事件时刻早于 {@link PEAK_ERA_START_MS}
+* 且条目未被用户价覆盖（用户价是实付价，优先于一切内置口径）时启用；
+* 币种固定 CNY——内置 DeepSeek 目录即人民币刊例，不随 live 覆盖漂移。
+*/
+const LEGACY_DEEPSEEK_BANDS = {
+	flash: {
+		input: 1,
+		cacheHit: .02,
+		output: 2
+	},
+	"flash-vision-exp": {
+		input: 1,
+		cacheHit: .02,
+		output: 2
+	},
+	pro: {
+		input: 3,
+		cacheHit: .025,
+		output: 6
+	}
+};
+/**
 * 工作日高峰时段判定（北京时间，UTC+8，无夏令时）：09:00–12:00、14:00–18:00。
 * 周末（周六/周日）北京全天为低谷，不调用本函数判定峰/平。
 * @param beijingHour - 北京时间的小时数（0–23）。
@@ -1597,10 +1635,25 @@ function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE, nowMs = Dat
 	return peak * peakShare + off * (1 - peakShare);
 }
 /**
+* v1 峰谷档判定（峰谷开闸起、周末全谷分界止）：不豁免周末——该时段官方
+* 高峰时段为每天 9-12 / 14-18（周六日同样计峰）。仅用于历史事件计费；
+* 「当前时刻」的档位（提醒/时段条/费率展示）一律走 {@link tierAt} 现行规则。
+*/
+function tariffV1At(timeMs) {
+	return isPeakHour((new Date(timeMs).getUTCHours() + 8) % 24) ? "peak" : "offPeak";
+}
+/**
 * 按调用时刻精确判定高峰/空闲档并计价（P0-1：替代固定比例混合）。时刻未知
 * （null/NaN，理论不发生在真实事件流）时回退 {@link DEFAULT_PEAK_SHARE} 混合，
 * 保持旧语义不低估。平档模型（无 offPeak）两个时段同价。限时促销与峰谷档
 * 同口径：按事件时刻判定该笔流量当时享受的单价。
+*
+* 历史正确性（按变更节点分段适用规则，不统一套现行价重算历史）：
+* - 早于 {@link PEAK_ERA_START_MS} 的事件按当时官方基础价
+*   （{@link LEGACY_DEEPSEEK_BANDS}）计费；
+* - 峰谷开闸至 {@link WEEKEND_OFFPEAK_START_MS} 之间按 v1 规则（周末不豁免，
+*   周六日 9-12 / 14-18 计峰）；
+* - 周末全谷分界起按现行规则（{@link tierAt}，周六日全天低谷）。
 * @param entry - the catalog entry whose prices apply.
 * @param buckets - token usage counts.
 * @param timeMs - the call's wall-clock time (epoch ms); null falls back to the peak-share mix.
@@ -1610,8 +1663,10 @@ function computeCost(entry, buckets, peakShare = DEFAULT_PEAK_SHARE, nowMs = Dat
 function computeCostAt(entry, buckets, timeMs, peakShare = DEFAULT_PEAK_SHARE) {
 	if (timeMs === null || timeMs === void 0 || !Number.isFinite(timeMs)) return computeCost(entry, buckets, peakShare);
 	const priced = applyPromo(entry, timeMs);
+	const legacy = timeMs < PEAK_ERA_START_MS && entry.userPriced !== true ? LEGACY_DEEPSEEK_BANDS[entry.key] : void 0;
+	if (legacy !== void 0) return priceBandCost(legacy, buckets, "CNY");
 	if (priced.price.offPeak === void 0) return priceBandCost(priced.price, buckets, priced.price.currency);
-	return priceBandCost(tierAt(timeMs) === "peak" ? priced.price : priced.price.offPeak, buckets, priced.price.currency);
+	return priceBandCost((timeMs < WEEKEND_OFFPEAK_START_MS ? tariffV1At(timeMs) : tierAt(timeMs)) === "peak" ? priced.price : priced.price.offPeak, buckets, priced.price.currency);
 }
 /**
 * Format an amount with adaptive precision and the given currency symbol.
@@ -2342,7 +2397,7 @@ function createUsageAggregator(persistence, options = {}) {
 						id,
 						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
 						...stamp === null ? {} : { stamp },
-						foldVersion: 4,
+						foldVersion: 6,
 						fold: serializeFold(fold)
 					};
 					const previous = ledger.get(id);
@@ -2366,7 +2421,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 4;
+					const stale = (entry.foldVersion ?? 1) < 6;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -2412,7 +2467,7 @@ function createUsageAggregator(persistence, options = {}) {
 			outputCost: 0
 		};
 		const perfModel = /* @__PURE__ */ new Map();
-		const perfHour = /* @__PURE__ */ new Map();
+		const perfHourModel = /* @__PURE__ */ new Map();
 		for (const { id: sessionId, cwd, fold, staleLedger } of folds) {
 			mergeUsageInto(total, fold.total);
 			roles.userChars += fold.roles.userChars;
@@ -2443,13 +2498,18 @@ function createUsageAggregator(persistence, options = {}) {
 				if (sample.tps !== void 0) modelAccum.tps.push(sample.tps);
 				if (sample.latencyMs !== void 0) modelAccum.latencies.push(sample.latencyMs);
 				if (sample.estimated) modelAccum.estimated += 1;
-				let hourAccum = perfHour.get(sample.hour);
+				let hourModels = perfHourModel.get(sample.hour);
+				if (hourModels === void 0) {
+					hourModels = /* @__PURE__ */ new Map();
+					perfHourModel.set(sample.hour, hourModels);
+				}
+				let hourAccum = hourModels.get(sample.model);
 				if (hourAccum === void 0) {
 					hourAccum = {
 						ttfts: [],
 						tps: []
 					};
-					perfHour.set(sample.hour, hourAccum);
+					hourModels.set(sample.model, hourAccum);
 				}
 				hourAccum.ttfts.push(sample.ttftMs);
 				if (sample.tps !== void 0) hourAccum.tps.push(sample.tps);
@@ -2509,14 +2569,14 @@ function createUsageAggregator(persistence, options = {}) {
 				latencyAvg: acc.latencies.length === 0 ? 0 : mean(acc.latencies),
 				estimatedSamples: acc.estimated
 			}])),
-			byHour: Object.fromEntries([...perfHour].map(([hour, acc]) => [hour, {
+			byHourModel: Object.fromEntries([...perfHourModel].map(([hour, models]) => [hour, Object.fromEntries([...models].map(([model, acc]) => [model, {
 				samples: acc.ttfts.length,
 				ttftAvg: mean(acc.ttfts),
 				...acc.tps.length === 0 ? {} : { tpsAvg: mean(acc.tps) }
-			}]))
+			}]))]))
 		};
 		lastDoc = {
-			version: 3,
+			version: 4,
 			updatedAt: now,
 			source: "session-logs",
 			timezone: hostTimeZone(),
@@ -3198,18 +3258,28 @@ function evalExtract(rule, data) {
 	}
 	return base;
 }
-/** 请求头占位符解析：`{{ENV_NAME}}` 经凭据 seam 替换；解析失败返回 null。 */
+/**
+* 请求头占位符解析：值中任意位置的 `{{ENV_NAME}}` 经凭据 seam 替换（如
+* `Bearer {{KEY}}`、`token={{KEY}}`、一处多占位符）；被引用的任一凭据缺失
+* 或为空 → 返回 null（fail-closed，与完整占位符形态的历史语义一致）。
+*/
 async function resolveHeaders(ctx, headers) {
 	const resolved = {};
 	for (const [key, value] of Object.entries(headers)) {
-		const match = /^\{\{([A-Z0-9_]+)\}\}$/i.exec(value.trim());
-		if (match === null) {
+		const matches = [...value.matchAll(/\{\{([A-Z0-9_]+)\}\}/gi)];
+		if (matches.length === 0) {
 			resolved[key] = value;
 			continue;
 		}
-		const hit = await ctx.credentials.resolve(credentialRef(match[1] ?? ""));
-		if (hit === void 0 || hit.value === "") return null;
-		resolved[key] = value.replace(match[0], hit.value);
+		const hits = /* @__PURE__ */ new Map();
+		for (const m of matches) {
+			const name = m[1] ?? "";
+			if (hits.has(name)) continue;
+			const hit = await ctx.credentials.resolve(credentialRef(name));
+			if (hit === void 0 || hit.value === "") return null;
+			hits.set(name, hit.value);
+		}
+		resolved[key] = value.replace(/\{\{([A-Z0-9_]+)\}\}/gi, (raw, name) => hits.get(name) ?? raw);
 	}
 	return resolved;
 }

package/lib/types/aggregate.d.ts

@@ -236,8 +236,8 @@ export interface RoleCost {
 export interface PerfStats {
     /** 按模型聚合（键 = 计费目录键；未收录模型原样保留）。 */
     byModel: Record<string, ModelPerf>;
-    /** 按小时聚合（键 = {@link hourStamp}，北京时间）。 */
-    byHour: Record<string, HourPerf>;
+    /** 按小时×模型聚合（外键 = {@link hourStamp}，内键 = 模型目录键；北京时间）。 */
+    byHourModel: Record<string, Record<string, HourModelPerf>>;
 }
 /** 一个模型的性能统计：首字延时均值 / P50 / P90、生成速度均值、总延迟均值。 */
 export interface ModelPerf {
@@ -260,11 +260,11 @@ export interface ModelPerf {
     /** 以 step/start 估算的样本数（工具续写步骤无独立 request/header）。 */
     estimatedSamples: number;
 }
-/** 一个小时的性能统计（键 = {@link hourStamp}）。 */
-export interface HourPerf {
+/** 一个小时单模型的性能统计（外键 = {@link hourStamp}，内键 = 模型目录键）。 */
+export interface HourModelPerf {
     samples: number;
     ttftAvg: number;
-    /** 平均生成速度（tokens/s）；该小时无可测生成窗口时缺失。 */
+    /** 平均生成速度（tokens/s）；该小时该模型无可测生成窗口时缺失。 */
     tpsAvg?: number;
 }
 /** 会话明细行：仪表盘「会话明细」面板的数据源。 */
@@ -420,10 +420,13 @@ export interface UsageLedgerDocument {
  * 两次 header 之间的用量串到上一个模型，订阅模型首当其冲，issue #14）；v2 =
  * `assistant/message` 自带 source 归账（1.0.7 起）；v3 = 联网搜索请求按次估算
  * 计费（issue #15，1.0.9 起）；v4 = 模型×日期×站点三维桶（issue #16，按 origin
- * 绑定自定义价的显示层重估）——旧行缺该维度，按无 origin 价处理。
+ * 绑定自定义价的显示层重估）——旧行缺该维度，按无 origin 价处理；v5 = 峰谷
+ * 时代之前（2026-08-16T16:00Z）的 DeepSeek 事件按当时基础价计费（v4 把全部
+ * 历史套现行峰/谷档价，高估约 50%）；v6 = v1 峰谷窗口（至 2026-08-22T16:00Z）
+ * 的周末不豁免峰时（v5 错套现行周末全谷规则，低估该窗口周六日的峰时费用）。
  * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 4;
+export declare const FOLD_VERSION = 6;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并

package/lib/types/balance.d.ts

@@ -52,6 +52,12 @@ export declare function pickRemainingQuota(source: unknown): number | undefined;
  * @returns 数值；取不到或结果非有限数返回 undefined。
  */
 export declare function evalExtract(rule: CustomBalanceExtract, data: unknown): number | undefined;
+/**
+ * 请求头占位符解析：值中任意位置的 `{{ENV_NAME}}` 经凭据 seam 替换（如
+ * `Bearer {{KEY}}`、`token={{KEY}}`、一处多占位符）；被引用的任一凭据缺失
+ * 或为空 → 返回 null（fail-closed，与完整占位符形态的历史语义一致）。
+ */
+export declare function resolveHeaders(ctx: Context, headers: Record<string, string>): Promise<Record<string, string> | null>;
 /**
  * 查询自定义 Provider 余额（插件 config 的 `customBalances`）。每个条目独立
  * 成败：占位符凭据缺失 → unconfigured；401/403 → unauthorized；网络或提取

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

@@ -1,12 +1,13 @@
 /**
- * PerfPanel: per-model latency/perf table + per-hour TTFT/generation-speed curve.
+ * PerfPanel: per-model latency/perf table + per-hour per-model comparison curve.
  *
  * Reads the optional `perf` field of the usage-stats document (aggregated by
  * the host from session logs). Renders a per-model table of TTFT mean/P50/P90,
  * generation speed, total latency and estimated-step count, plus a small
- * dependency-free SVG twin-series hourly curve (TTFT in ms on the left axis,
- * tokens/s on the right). Absent `perf` (older snapshot or stream-less logs)
- * renders an empty state; the panel never fabricates samples.
+ * dependency-free SVG hourly curve: one colored polyline per lit model with a
+ * metric tab (TTFT ms / tok/s) and clickable model chips; hovering snaps to the
+ * nearest hour and shows a crosshair + tooltip listing every lit model's value.
+ * Absent `perf` renders an empty state; the panel never fabricates samples.
  */
 import type { TrendSeriesModel } from './TrendChart.tsx';
 import type { UsageBillingKey } from './locales.ts';
@@ -24,8 +25,8 @@ export interface PerfModelData {
     latencyAvg: number;
     estimatedSamples: number;
 }
-/** 每小时性能统计（与服务端 `HourPerf` 同形）。 */
-export interface PerfHourData {
+/** 小时×模型性能统计（与服务端 `HourModelPerf` 同形）。 */
+export interface PerfHourModelData {
     samples: number;
     ttftAvg: number;
     tpsAvg?: number;
@@ -33,12 +34,13 @@ export interface PerfHourData {
 /** 性能指标文档（服务端可选 `perf` 字段；旧快照缺失）。 */
 export interface ClientPerf {
     byModel: Record<string, PerfModelData>;
-    byHour: Record<string, PerfHourData>;
+    /** 小时 → 模型 → 小时统计；旧 host 文档缺失时图表区按空态兜底。 */
+    byHourModel: Record<string, Record<string, PerfHourModelData>>;
 }
 /**
  * Render the performance panel.
  * @param props.perf - the optional perf doc; `undefined`/empty renders an empty state.
- * @param props.models - model legend (key/name/color) for the table swatches and curve legend.
+ * @param props.models - model legend (key/name/color) for the table swatches and curve chips.
  * @param props.t - locale function.
  */
 export declare function PerfPanel({ perf, models, t, }: {

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

@@ -32,6 +32,6 @@ export declare function UsageHeatmap({ days, currency, now, t, range }: {
     currency: CostCurrency;
     now?: Date;
     range?: 'month' | 'year';
-    t: (key: 'billing.costAbbr' | 'billing.noData' | 'billing.heatmapLess' | 'billing.heatmapMore') => string;
+    t: (key: 'costAbbr' | 'noData' | 'heatmapLess' | 'heatmapMore') => string;
 }): React.ReactNode;
 //# sourceMappingURL=heatmap.d.ts.map

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

@@ -1,5 +1,5 @@
 /** Locale dictionaries for the usage billing surface. */
-export type UsageBillingKey = 'billing.title' | 'billing.subtitle' | 'billing.cost' | 'billing.todayCost' | 'billing.monthCost' | 'billing.yearCost' | 'billing.monthProjected' | 'billing.liveTurn' | 'billing.liveSession' | 'billing.totalCost' | 'billing.calls' | 'billing.cacheHitRate' | 'billing.tokens' | 'billing.inputTokens' | 'billing.outputTokens' | 'billing.avgCost' | 'billing.trend' | 'billing.trend7d' | 'billing.trend30d' | 'billing.trendMetric' | 'billing.trendMetricCost' | 'billing.trendMetricTokens' | 'billing.trendEmpty' | 'billing.budget' | 'billing.budgetAmount' | 'billing.budgetSummary' | 'billing.sessions' | 'billing.sessionTitle' | 'billing.project' | 'billing.lastActive' | 'billing.sessionOverflow' | 'billing.budgetTierBody' | 'billing.models' | 'billing.providerBilling' | 'billing.estimated' | 'billing.actual' | 'billing.pricing' | 'billing.showPricing' | 'billing.hidePricing' | 'billing.pricePerM' | 'billing.input' | 'billing.output' | 'billing.cacheHit' | 'billing.peak' | 'billing.offPeak' | 'billing.flat' | 'billing.peakHours' | 'billing.band' | 'billing.openDashboard' | 'billing.close' | 'billing.footer' | 'billing.footerCredit' | 'billing.lastUpdated' | 'billing.noData' | 'billing.todayRate' | 'billing.rateLive' | 'billing.rateBuiltin' | 'billing.promoBadge' | 'billing.promoUntil' | 'billing.promoOpenEnded' | 'billing.pricingTip' | 'billing.pricingUnit' | 'billing.pricingNotes' | 'billing.ubPeak' | 'billing.ubOff' | 'billing.ubStd' | 'billing.peakBand' | 'billing.pricingSource' | 'billing.noteCache' | 'billing.noteBand' | 'billing.noteSource' | 'billing.balance' | 'billing.balanceUnconfigured' | 'billing.balanceUnauthorized' | 'billing.balanceUnreachable' | 'billing.uncatalogued' | 'billing.estimatedPricing' | 'billing.balanceDays' | 'billing.balanceLowBody' | 'billing.reconcileDrift' | 'billing.reconcileDismiss' | 'billing.subscriptions' | 'billing.subscriptionNotConfigured' | 'billing.subscriptionUnauthorized' | 'billing.subscriptionUnavailable' | 'billing.subscriptionInvalid' | 'billing.subscriptionRateLimited' | 'billing.subscriptionSession' | 'billing.subscriptionWeekly' | 'billing.subscriptionMonthly' | 'billing.subscriptionBilling' | 'billing.subscriptionRemaining' | 'billing.subscriptionExhausted' | 'billing.subscriptionReset' | 'billing.subscriptionNoApi' | 'billing.floatWindow' | 'billing.floatModeCombined' | 'billing.floatModeSubscription' | 'billing.floatMode' | 'billing.floatTargets' | 'billing.floatWindowHint' | 'billing.floatNoTargets' | 'billing.floatNoTargetsHint' | 'billing.cardDisplay' | 'billing.cardDisplayHint' | 'billing.cardMetric' | 'billing.cardMetricMoney' | 'billing.cardMetricTokens' | 'billing.triggerMonthTokens' | 'billing.floatPrev' | 'billing.floatNext' | 'billing.subscriptionsStale' | 'billing.staleLedgerNotice' | 'billing.tokenCacheWrite' | 'billing.toolRank' | 'billing.toolName' | 'billing.userPrices' | 'billing.userPricesHint' | 'billing.userPriceSave' | 'billing.userPriceModel' | 'billing.userPriceSource' | 'billing.userPriceSourceHint' | 'billing.userPriceOffPeak' | 'billing.userPriceCurrency' | 'billing.userPriceAdd' | 'billing.userPriceRemove' | 'billing.sessionStaleBadge' | 'billing.heatmapLess' | 'billing.heatmapMore' | 'billing.currency' | 'billing.currencyCny' | 'billing.currencyUsd' | 'billing.heatmap' | 'billing.rounds' | 'billing.roundsHint' | 'billing.anomaly' | 'billing.workspaces' | 'billing.workspacesHint' | 'billing.plan' | 'billing.remaining' | 'billing.unknownModel' | 'billing.model' | 'billing.thModel' | 'billing.thInputMiss' | 'billing.thInputHit' | 'billing.currentRound' | 'billing.costAbbr' | 'billing.tabOverview' | 'billing.tabTrends' | 'billing.tabProviders' | 'billing.tabDetails' | 'billing.tabPricing' | 'billing.tabSettings' | 'billing.settingsHead' | 'billing.settingsHint' | 'billing.budgetHint' | 'billing.peakAlertHint' | 'billing.peakAlertDescPeak' | 'billing.peakAlertDescOff' | 'billing.export' | 'billing.exportCsvDay' | 'billing.exportCsvSession' | 'billing.exportJson' | 'billing.peakShare' | 'billing.peakSharePerCall' | 'billing.offPeakSavings' | 'billing.perfMax' | 'billing.weekCost' | 'billing.roleCost' | 'billing.roleUser' | 'billing.roleAssistant' | 'billing.roleTool' | 'billing.roleHint' | 'billing.tierPeak' | 'billing.tierOff' | 'billing.tierToPeak' | 'billing.tierToOff' | 'billing.tierAlertEnterPeak' | 'billing.tierAlertEnterOff' | 'billing.peakAlertTitlePeak' | 'billing.peakAlertTitleOff' | 'billing.peakAlert' | 'billing.peakAlertLeadMin' | 'billing.peakAlertPos' | 'billing.peakAlertMode' | 'billing.peakAlertPosCorner' | 'billing.peakAlertPosCenter' | 'billing.peakAlertModePeak' | 'billing.peakAlertModeOff' | 'billing.peakAlertModeBoth' | 'billing.peakAlertWebNotify' | 'billing.peakAlertPreview' | 'billing.planTypeCode' | 'billing.planTypeToken' | 'billing.subscriptionFeePerMonth' | 'billing.triggerToday' | 'billing.triggerMonth' | 'billing.subscriptionIncluded' | 'billing.free' | 'billing.official' | 'billing.thirdParty' | 'billing.officialCost' | 'billing.thirdPartyCost' | 'billing.perfSamples' | 'billing.perfTtft' | 'billing.perfP50' | 'billing.perfP90' | 'billing.perfTps' | 'billing.perfLatency' | 'billing.perfEstimated' | 'billing.perfEmpty' | 'billing.perfTpsUnit' | 'billing.perfTitle' | 'billing.perfHint' | 'billing.heatmapYear' | 'billing.heatmapMonth' | 'billing.activeDays' | 'billing.streakDays' | 'billing.subscriptionAutoDetect' | 'billing.pluginInfo' | 'billing.pluginName' | 'billing.pluginDescription' | 'billing.pluginVersion' | 'billing.pluginAuthor' | 'billing.pluginRepository' | 'billing.pluginNpm' | 'billing.pluginLicense' | 'billing.tabToken' | 'billing.tokenExport' | 'billing.tokenExportCsv' | 'billing.tokenCacheHitRate' | 'billing.tokenReasoningShare' | 'billing.tokenReasoningShort' | 'billing.tokenIo' | 'billing.tokenPeak' | 'billing.tokenDaily' | 'billing.tokenByModel' | 'billing.tokenMiss' | 'billing.tokenHit' | 'billing.tokenOutput' | 'billing.tokenViewStructure' | 'billing.tokenViewModel' | 'billing.tokenHitShort' | 'billing.tokenMissShort' | 'billing.tokenTotal' | 'billing.tokenShare' | 'billing.usageStatsTool' | 'billing.usageStatsToolHint' | 'billing.balanceGranted' | 'billing.balanceTopped' | 'billing.balanceDaily' | 'billing.balanceDaysLong' | 'billing.balanceDaysUnit' | 'billing.popTodayModel' | 'billing.popNoConsumption' | 'billing.popQuotaAlert' | 'billing.popRiskNone' | 'billing.popTitle' | 'billing.popDirectLead' | 'billing.popSubLead' | 'billing.popBalanceNormal' | 'billing.popBalanceLow' | 'billing.popQuotaNormal' | 'billing.popQuotaLow' | 'billing.alertBalanceLow' | 'billing.alertQuotaLow' | 'billing.unpricedHint' | 'billing.searchEstimateHint' | 'billing.siteListDisplay' | 'billing.siteListDisplayHint' | 'billing.liveCostBar' | 'billing.liveCostBarHint' | 'billing.exportCsvSite' | 'billing.panelRelayQuota' | 'billing.relayBalance' | 'billing.relayNoQuota' | 'billing.relayWindowUsed' | 'billing.relayKindNewApi' | 'billing.relayKindSub2Api' | 'billing.relayKindUnknown';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'trendEmpty' | 'budget' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'project' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'balanceUnconfigured' | 'balanceUnauthorized' | 'balanceUnreachable' | 'uncatalogued' | 'estimatedPricing' | 'balanceDays' | 'balanceLowBody' | 'reconcileDrift' | 'reconcileDismiss' | 'subscriptionNotConfigured' | 'subscriptionUnauthorized' | 'subscriptionUnavailable' | 'subscriptionInvalid' | 'subscriptionRateLimited' | 'subscriptionSession' | 'subscriptionWeekly' | 'subscriptionMonthly' | 'subscriptionBilling' | 'subscriptionRemaining' | 'subscriptionExhausted' | 'subscriptionReset' | 'subscriptionNoApi' | 'floatWindow' | 'floatModeCombined' | 'floatModeSubscription' | 'floatMode' | 'floatTargets' | 'floatWindowHint' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'triggerMonthTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemove' | 'sessionStaleBadge' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'workspaces' | 'workspacesHint' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionIncluded' | 'free' | 'official' | 'thirdParty' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapMonth' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginVersion' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenCacheHitRate' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'tokenDaily' | 'tokenByModel' | 'tokenMiss' | 'tokenHit' | 'tokenOutput' | 'tokenViewStructure' | 'tokenViewModel' | 'tokenHitShort' | 'tokenMissShort' | 'tokenTotal' | 'tokenShare' | 'usageStatsTool' | 'usageStatsToolHint' | 'balanceGranted' | 'balanceTopped' | 'balanceDaily' | 'balanceDaysLong' | 'balanceDaysUnit' | 'popTodayModel' | 'popNoConsumption' | 'popTitle' | 'popDirectLead' | 'popSubLead' | 'unpricedHint' | 'searchEstimateHint' | 'siteListDisplay' | 'siteListDisplayHint' | 'liveCostBar' | 'liveCostBarHint' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

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

@@ -133,6 +133,20 @@ export declare function getRateInfo(): {
 };
 /** Default share of traffic assumed to fall in the peak band (0..1). */
 export declare const DEFAULT_PEAK_SHARE = 0.5;
+/**
+ * 峰谷计价时代分界（UTC 2026-08-16T16:00:00Z，即北京时间 2026-08-17 00:00）：
+ * DeepSeek V4 自此起按峰/谷两档计价。此前官方只有基础价一档——历史事件若
+ * 套现行峰/谷档价会把成本高估约 50%（谷价 = 基础价 × 1.5）。半开区间：该
+ * 时刻及之后按峰谷档计。
+ */
+export declare const PEAK_ERA_START_MS: number;
+/**
+ * 周末全谷规则分界（UTC 2026-08-22T16:00:00Z，即北京时间 2026-08-23 00:00）：
+ * 官方自此刻起周六/周日全天不区分峰谷（高峰时段收窄为工作日）；生效前的
+ * 周末仍按 v1 峰谷规则（周六日 9-12 / 14-18 同样是高峰时段）。历史事件的
+ * 档位判定按事件所在时段适用各自的规则，不得统一套现行规则重算历史。
+ */
+export declare const WEEKEND_OFFPEAK_START_MS: number;
 /** 计费时段档位：高峰 / 空闲（官方 DeepSeek 刊例价：高峰 = 空闲 × 2）。 */
 export type PriceTierId = 'peak' | 'offPeak';
 /** 成本显示币种：人民币（国内模型直价）/ 美元（国外模型直价或换算显示）。 */
@@ -369,6 +383,13 @@ export declare function computeCost(entry: ModelEntry, buckets: TokenUsageBucket
  * （null/NaN，理论不发生在真实事件流）时回退 {@link DEFAULT_PEAK_SHARE} 混合，
  * 保持旧语义不低估。平档模型（无 offPeak）两个时段同价。限时促销与峰谷档
  * 同口径：按事件时刻判定该笔流量当时享受的单价。
+ *
+ * 历史正确性（按变更节点分段适用规则，不统一套现行价重算历史）：
+ * - 早于 {@link PEAK_ERA_START_MS} 的事件按当时官方基础价
+ *   （{@link LEGACY_DEEPSEEK_BANDS}）计费；
+ * - 峰谷开闸至 {@link WEEKEND_OFFPEAK_START_MS} 之间按 v1 规则（周末不豁免，
+ *   周六日 9-12 / 14-18 计峰）；
+ * - 周末全谷分界起按现行规则（{@link tierAt}，周六日全天低谷）。
  * @param entry - the catalog entry whose prices apply.
  * @param buckets - token usage counts.
  * @param timeMs - the call's wall-clock time (epoch ms); null falls back to the peak-share mix.

package/lib/types/client/round-chart.d.ts

@@ -32,6 +32,6 @@ export declare function RoundCostChart({ rounds, flags, currency, t }: {
     rounds: readonly RoundChartRow[];
     flags: readonly AnomalyFlag[];
     currency: CostCurrency;
-    t: (key: 'billing.model' | 'billing.costAbbr') => string;
+    t: (key: 'model' | 'costAbbr') => string;
 }): React.ReactNode;
 //# sourceMappingURL=round-chart.d.ts.map

package/lib/types/client/usage-billing-settings.d.ts

@@ -107,4 +107,24 @@ export declare const USER_PRICES_STORAGE_KEY = "dsh.ui-usage-billing.prices";
 export declare function loadUserPrices(): UserPriceMap;
 /** 写入用户自定义价。失败静默（展示偏好非关键）。 */
 export declare function saveUserPrices(prices: UserPriceMap): void;
+/** 性能曲线的指标视角。 */
+export type PerfMetric = 'ttft' | 'tps';
+/**
+ * 性能面板的视图偏好：当前指标 tab 与点亮的模型曲线集合。
+ * 纯 client 偏好，存 localStorage（不依赖 node 半区接口/设置 schema）。
+ */
+export interface PerfViewPrefs {
+    /** 当前指标：首字延时（ms）/ 生成速度（tok/s）。 */
+    metric: PerfMetric;
+    /** 点亮的模型键列表；缺省 = 按样本数前 5（用户未碰过图例时跟随默认）。 */
+    models?: string[];
+}
+/** 默认性能视图偏好：首字延时 tab；模型集合跟随默认（前 5）。 */
+export declare const DEFAULT_PERF_VIEW_PREFS: PerfViewPrefs;
+/** localStorage key（与其他 `dsh.ui-usage-billing.*` 偏好同命名空间）。 */
+export declare const PERF_VIEW_STORAGE_KEY = "dsh.ui-usage-billing.perf";
+/** 读取性能视图偏好（含损坏/缺失回退到默认）。仅在浏览器半区调用。 */
+export declare function loadPerfViewPrefs(): PerfViewPrefs;
+/** 写入性能视图偏好。失败静默（展示偏好非关键）。 */
+export declare function savePerfViewPrefs(prefs: PerfViewPrefs): void;
 //# sourceMappingURL=usage-billing-settings.d.ts.map

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.0.18",
+  "version": "1.0.20",
   "publishConfig": {
     "access": "public"
   },