@kenz1117/dsh-ui-usage-billing 1.5.0 → 1.5.1

package/lib/index.js

@@ -2301,7 +2301,9 @@ const BUILTIN_MODEL_KEY_ALIASES = {
 	"deepseek-v4.1-flash": "flash",
 	"deepseek-v4.1-flash-expires-on-0910": "flash",
 	"deepseek-flash": "flash",
+	"deepseek-v4.1-flash-1017": "flash",
 	"deepseek/deepseek-v4.1-flash": "flash",
+	"deepseek/deepseek-v4.1-flash-1017": "flash",
 	"deepseek/deepseek-flash": "flash",
 	"deepseek/deepseek-v4-pro": "pro",
 	"deepseek-v4-pro": "pro",
@@ -2733,6 +2735,57 @@ function workspaceNameOf(cwd) {
 	if (cwd === void 0 || cwd === "") return "—";
 	return cwd.split(/[\\/]/).filter(Boolean).at(-1) ?? "—";
 }
+/**
+* 从会话 header 提取子智能体归并标记（直接父会话 id）：`origin: "subagent"`
+* （宿主的产品分类）或 `delegationDepth > 0`（持久化委派深度）任一命中即视为
+* 子会话。子会话但 header 无 parentSession（异常数据）返回 undefined——无法
+* 归位就按顶层会话处理，保守不标。导出供测试。
+*/
+function subParentOf(meta) {
+	if (meta.origin !== "subagent" && !((meta.delegationDepth ?? 0) > 0)) return void 0;
+	const parent = meta.parentSession;
+	return typeof parent === "string" && parent !== "" ? parent : void 0;
+}
+/**
+* 给会话行补后代合计（subCost/subCalls）：按 parentId 建子索引，对每行递归
+* 汇总全部后代子会话（多级委派整链计入根对话）。纯展示层归因——不改任何
+* 总额桶（子会话费用本就在 total/byDay/byModel 里，行级只是拆出来给人看）。
+* 环引用（异常数据）按 visited 跳过，不死循环。原地修改传入行。导出供测试。
+*/
+function foldSubagentFamilies(rows) {
+	const subsOf = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const parent = row.parentId;
+		if (parent === void 0) continue;
+		const list = subsOf.get(parent);
+		if (list !== void 0) list.push(row);
+		else subsOf.set(parent, [row]);
+	}
+	const familyOf = (id, visited) => {
+		let cost = 0;
+		let calls = 0;
+		for (const child of subsOf.get(id) ?? []) {
+			if (visited.has(child.id)) continue;
+			visited.add(child.id);
+			cost += child.cost;
+			calls += child.calls;
+			const nested = familyOf(child.id, visited);
+			cost += nested.cost;
+			calls += nested.calls;
+		}
+		return {
+			cost,
+			calls
+		};
+	};
+	for (const row of rows) {
+		const family = familyOf(row.id, /* @__PURE__ */ new Set([row.id]));
+		if (family.calls > 0) {
+			row.subCalls = family.calls;
+			if (family.cost > 0) row.subCost = family.cost;
+		}
+	}
+}
 /** TTFT 尖峰阈值（毫秒）：超过计为一次尖峰样本，用于定位服务端抖动。 */
 const PERF_SPIKE_MS = 1e4;
 /** 全零摘要（合并的恒等元）。 */
@@ -3533,11 +3586,12 @@ function createUsageAggregator(persistence, options = {}) {
 	*  价目表变化后未受影响行（无 unpriced 模型）依旧零读取复用。 */
 	const foldNeedsReprice = (fold) => fold.unpricedModels.some((key) => isPriced(key));
 	/** 把一份（全量或增量）折叠结果登记进 durable ledger；内容无变化时不落盘。 */
-	const recordLedger = (id, cwd, stamp, fold) => {
+	const recordLedger = (id, cwd, stamp, fold, subOf) => {
 		if (options.ledger === void 0) return;
 		const entry = {
 			id,
 			...cwd === void 0 ? {} : { cwd },
+			...subOf === void 0 ? {} : { subOf },
 			...stamp === null ? {} : { stamp },
 			foldVersion: 23,
 			fingerprint: foldFingerprint,
@@ -3545,7 +3599,7 @@ function createUsageAggregator(persistence, options = {}) {
 			fold: serializeFold(fold)
 		};
 		const row = ledger.get(id);
-		if (row === void 0 || row.stamp !== entry.stamp || row.cwd !== entry.cwd || row.foldVersion !== entry.foldVersion || row.fingerprint !== entry.fingerprint || stamp === null && JSON.stringify(row.fold) !== JSON.stringify(entry.fold) || stamp !== null && foldNeedsReprice(row.fold)) {
+		if (row === void 0 || row.stamp !== entry.stamp || row.cwd !== entry.cwd || row.subOf !== entry.subOf || row.foldVersion !== entry.foldVersion || row.fingerprint !== entry.fingerprint || stamp === null && JSON.stringify(row.fold) !== JSON.stringify(entry.fold) || stamp !== null && foldNeedsReprice(row.fold)) {
 			ledger.set(id, entry);
 			ledgerNeedsSave = true;
 		}
@@ -3637,12 +3691,14 @@ function createUsageAggregator(persistence, options = {}) {
 			}
 			try {
 				const cwd = meta.cwd;
+				const subOf = subParentOf(meta);
 				const ledgerRow = ledger.get(id);
 				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 23 && ledgerRow.fingerprint === foldFingerprint && !foldNeedsReprice(ledgerRow.fold)) {
 					const fold = deserializedFoldOf(ledgerRow.fold);
 					folds.push({
 						id,
 						...cwd === void 0 ? {} : { cwd },
+						...subOf === void 0 ? {} : { subOf },
 						fold
 					});
 					included.add(id);
@@ -3655,6 +3711,7 @@ function createUsageAggregator(persistence, options = {}) {
 					folds.push({
 						id,
 						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
+						...subOf === void 0 ? {} : { subOf },
 						fold: hit.fold
 					});
 					included.add(id);
@@ -3683,10 +3740,11 @@ function createUsageAggregator(persistence, options = {}) {
 					folds.push({
 						id,
 						...cwd === void 0 ? {} : { cwd },
+						...subOf === void 0 ? {} : { subOf },
 						fold: previous.fold
 					});
 					included.add(id);
-					recordLedger(id, cwd, stamp, previous.fold);
+					recordLedger(id, cwd, stamp, previous.fold, subOf);
 					continue;
 				}
 				const { events, inheritedEventCount } = await persistence.readFrom(meta.id, sessionLogOffsetOf(0));
@@ -3712,10 +3770,11 @@ function createUsageAggregator(persistence, options = {}) {
 				folds.push({
 					id,
 					...cwd === void 0 ? {} : { cwd },
+					...subOf === void 0 ? {} : { subOf },
 					fold
 				});
 				included.add(id);
-				recordLedger(id, cwd, stamp, fold);
+				recordLedger(id, cwd, stamp, fold, subOf);
 			} catch (error) {
 				skipped.push(id);
 				const format = isFormatUnsupportedError(error);
@@ -3743,6 +3802,7 @@ function createUsageAggregator(persistence, options = {}) {
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
+						...entry.subOf === void 0 ? {} : { subOf: entry.subOf },
 						...stale ? { staleLedger: true } : {},
 						fold: deserializedFoldOf(entry.fold)
 					});
@@ -3779,7 +3839,7 @@ function createUsageAggregator(persistence, options = {}) {
 		const perfHourModel = /* @__PURE__ */ new Map();
 		const perfModelDigest = /* @__PURE__ */ new Map();
 		const perfHourDigest = /* @__PURE__ */ new Map();
-		for (const { id: sessionId, cwd, fold, staleLedger } of folds) {
+		for (const { id: sessionId, cwd, subOf, fold, staleLedger } of folds) {
 			mergeUsageInto(total, fold.total);
 			roles.userChars += fold.roles.userChars;
 			roles.toolChars += fold.roles.toolChars;
@@ -3858,12 +3918,14 @@ function createUsageAggregator(persistence, options = {}) {
 				id: sessionId,
 				...fold.title !== void 0 ? { title: fold.title } : {},
 				...cwd !== void 0 ? { cwd } : {},
+				...subOf !== void 0 ? { parentId: subOf } : {},
 				...staleLedger === true ? { stale: true } : {},
 				calls: fold.total.calls,
 				cost: fold.total.cost,
 				lastActive: fold.lastActive
 			});
 		}
+		foldSubagentFamilies(sessionRows);
 		sessionRows.sort((a, b) => b.cost - a.cost || b.lastActive - a.lastActive);
 		turnRows.sort((a, b) => b.startedAt - a.startedAt);
 		const workspaces = [...workspaceMap.values()].sort((a, b) => b.cost - a.cost || b.lastActive - a.lastActive);

package/lib/types/aggregate.d.ts

@@ -389,6 +389,17 @@ export interface SessionUsageRow {
     title?: string;
     /** 会话创建时的工作目录（项目路径）；未知时缺失。 */
     cwd?: string;
+    /**
+     * 直接父会话 id（仅子智能体会话携带）：宿主 header 的 `origin: "subagent"`
+     * 会话经 parentSession 指向委派它的对话。fork/resume 的种子血缘
+     * （isSeeded）不满足子智能体门，不带本字段。旧宿主 header 无标记，
+     * 按顶层会话处理。
+     */
+    parentId?: string;
+    /** 全部后代子会话的费用合计（人民币元，多级委派整链递归）；无后代或后代全免费时缺失。 */
+    subCost?: number;
+    /** 全部后代子会话的调用数；无后代时缺失。 */
+    subCalls?: number;
     calls: number;
     cost: number;
     /** 最后一个事件的时间戳（毫秒）。 */
@@ -396,6 +407,20 @@ export interface SessionUsageRow {
     /** 数据来自旧算法折叠的持久账本行（日志已删/不可读，无法重算）；UI 据此标注置信度。 */
     stale?: boolean;
 }
+/**
+ * 从会话 header 提取子智能体归并标记（直接父会话 id）：`origin: "subagent"`
+ * （宿主的产品分类）或 `delegationDepth > 0`（持久化委派深度）任一命中即视为
+ * 子会话。子会话但 header 无 parentSession（异常数据）返回 undefined——无法
+ * 归位就按顶层会话处理，保守不标。导出供测试。
+ */
+export declare function subParentOf(meta: SessionHeader): string | undefined;
+/**
+ * 给会话行补后代合计（subCost/subCalls）：按 parentId 建子索引，对每行递归
+ * 汇总全部后代子会话（多级委派整链计入根对话）。纯展示层归因——不改任何
+ * 总额桶（子会话费用本就在 total/byDay/byModel 里，行级只是拆出来给人看）。
+ * 环引用（异常数据）按 visited 跳过，不死循环。原地修改传入行。导出供测试。
+ */
+export declare function foldSubagentFamilies(rows: SessionUsageRow[]): void;
 /** 每轮费用明细行：仪表盘「每轮费用」图的数据源。 */
 export interface TurnUsageRow {
     /** 会话 id（字符串形式）：不同会话的轮次号相互独立，展示时需区分。 */
@@ -563,6 +588,12 @@ export interface SerializedSessionFold {
 export interface UsageLedgerSession {
     id: string;
     cwd?: string;
+    /**
+     * 子智能体归并标记（直接父会话 id）：仅宿主 header 带 `origin: "subagent"`
+     * 的会话行携带。日志已删、只剩账本行时仍能归位到父对话；缺失 = 顶层会话
+     * （含 fork/resume 血缘）。可选字段，旧账本行缺失按顶层处理，无需迁移。
+     */
+    subOf?: string;
     /** Stable log stamp (mtime + size) when the persistence backend exposes it. */
     stamp?: string;
     /**

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

@@ -178,6 +178,15 @@ interface SessionBillingRow {
     id: string;
     title?: string;
     cwd?: string;
+    /**
+     * 直接父会话 id（仅子智能体会话携带）：宿主把子智能体落成独立会话，
+     * header 的 origin: subagent + parentSession 指向委派它的对话。
+     */
+    parentId?: string;
+    /** 全部后代子会话费用合计（服务端递归算好）；无后代时缺失。 */
+    subCost?: number;
+    /** 全部后代子会话调用数；无后代时缺失。 */
+    subCalls?: number;
     /** 数据来自旧算法折叠的持久账本行（原始日志已删，无法重算）。 */
     stale?: boolean;
     calls: number;
@@ -187,6 +196,8 @@ interface SessionBillingRow {
     mergedCount?: number;
     /** 合并组的段明细（展示层专用）：一级行默认收起，展开后逐段显示。合并函数需 push，故非 readonly。 */
     children?: SessionBillingRow[];
+    /** 挂到本组下的子智能体行（展示层专用）：与段明细并列展开，带子智能体徽标。 */
+    subs?: SessionBillingRow[];
 }
 /** Usage stats structure from `.dsh-usage-stats.json`. */
 export interface UsageStats {

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

@@ -18,6 +18,12 @@ export interface SessionExportRow {
     id: string;
     title?: string;
     cwd?: string;
+    /** 直接父会话 id（仅子智能体会话携带）；顶层会话缺失。 */
+    parentId?: string;
+    /** 后代子会话费用合计（人民币元）；无后代时缺失。 */
+    subCost?: number;
+    /** 后代子会话调用数；无后代时缺失。 */
+    subCalls?: number;
     calls: number;
     cost: number;
     lastActive: number;
@@ -26,7 +32,7 @@ export interface SessionExportRow {
 export declare function dayRowsCsv(byDay: Record<string, DayExportRow>): string;
 /** 按站点（中转站/直连/未知路由）CSV：站点,类别,调用,费用(元)。 */
 export declare function siteRowsCsv(bySite: Record<string, DayExportRow>): string;
-/** 按会话 CSV：会话 id,标题,项目,调用,费用(元),最后活跃(ISO)。 */
+/** 按会话 CSV：会话 id,标题,项目,调用,费用(元),最后活跃(ISO),父会话,子会话调用,子会话费用(元)。 */
 export declare function sessionRowsCsv(rows: readonly SessionExportRow[]): string;
 /** 导出文件名：带日期范围（usage-2026-08-01_2026-08-22.csv）；无日期时只带前缀。 */
 export declare function exportFileName(prefix: string, ext: 'csv' | 'json', dates: readonly string[]): string;

package/lib/types/client/live-cost.d.ts

@@ -22,6 +22,7 @@ export interface LiveStats {
     bySession?: readonly {
         id: string;
         cost: number;
+        subCost?: number;
     }[];
     byTurn?: readonly {
         sessionId: string;
@@ -40,13 +41,22 @@ export interface QuotaSlice {
     }[];
 }
 /**
- * 当前会话累计费用：bySession 里会话 id 匹配的那行；缺省为 0。
- * 导出供测试：纯函数。
+ * 当前会话累计费用：bySession 里会话 id 匹配的那行（含后代子智能体费用
+ * subCost——子智能体是宿主的独立会话，其消耗按父链并入本对话的口径）；
+ * 缺省为 0。导出供测试：纯函数。
  * @param stats - 薄统计切片。
  * @param sessionId - 当前会话 id。
- * @returns 该会话累计费用（人民币元）。
+ * @returns 该会话累计费用（人民币元，含子智能体）。
  */
 export declare function sessionCostOf(stats: LiveStats | null, sessionId: string | undefined): number;
+/**
+ * 当前会话的后代子智能体费用（bySession 行的 subCost）：供「含子」拆分展示，
+ * 让胶囊上的总额与本体会话费用对得上账。导出供测试：纯函数。
+ * @param stats - 薄统计切片。
+ * @param sessionId - 当前会话 id。
+ * @returns 后代子会话费用合计（人民币元）；无则 0。
+ */
+export declare function sessionSubCostOf(stats: LiveStats | null, sessionId: string | undefined): number;
 /**
  * 当前轮费用：byTurn 里该会话最新一轮的 cost；缺省为 0。
  * byTurn 服务端按起始时间倒序下发，但求 max(turn) 更稳健（不依赖顺序）。

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

@@ -1,5 +1,5 @@
 /** Locale dictionaries for the usage billing surface. */
-export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'pricingSearch' | 'bandPinHint' | 'trendEmpty' | 'trendTotal' | 'roundsUnit' | 'healthModelsLive' | 'healthVendorsDown' | 'healthVendorsUnavailable' | 'budget' | 'budgetRemain' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'directTag' | 'relayTag' | 'unknownTag' | 'unknownChannelHint' | 'planCountUnit' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'pricingSyncedAt' | 'pricingSyncNow' | 'pricingSyncing' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'recharge' | 'rechargeHint' | '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' | 'floatPrimaryToday' | 'floatPrimaryWeek' | 'floatPrimaryMonth' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'cardSpan' | 'cardSpanDay' | 'cardSpanWeek' | 'cardSpanMonth' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'unreadableNotice' | 'unreadableFormatNotice' | 'unreadableNoLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'currencyEur' | 'language' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'peakAlertDescPeakZhipu' | 'peakAlertDescOffZhipu' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'tierAlertEnterPeakZhipu' | 'tierAlertEnterOffZhipu' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionTag' | 'cellEstimateHint' | 'free' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapHalf' | 'heatmapMonth' | 'metricCost' | 'metricTokens' | 'heatmapTotal' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'densityLabel' | 'densityHint' | 'densityCompact' | 'densityDefault' | 'densityComfortable' | 'motionLabel' | 'motionHint' | 'motionOff' | 'motionSubtle' | 'motionRich' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSectionDisplay' | 'emptyHint' | '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' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown' | 'expandAll' | 'collapseAll' | 'todayOnly' | 'todayNoConsumption';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | 'liveSessionSub' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'pricingSearch' | 'bandPinHint' | 'trendEmpty' | 'trendTotal' | 'roundsUnit' | 'healthModelsLive' | 'healthVendorsDown' | 'healthVendorsUnavailable' | 'budget' | 'budgetRemain' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'directTag' | 'relayTag' | 'unknownTag' | 'unknownChannelHint' | 'planCountUnit' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'pricingSyncedAt' | 'pricingSyncNow' | 'pricingSyncing' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'recharge' | 'rechargeHint' | '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' | 'floatPrimaryToday' | 'floatPrimaryWeek' | 'floatPrimaryMonth' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'cardSpan' | 'cardSpanDay' | 'cardSpanWeek' | 'cardSpanMonth' | 'cardDeltaBadge' | 'cardDeltaShow' | 'cardDeltaHide' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'unreadableNotice' | 'unreadableFormatNotice' | 'unreadableNoLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'sessionSubCost' | 'sessionSubCalls' | 'sessionSubRow' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'currencyEur' | 'language' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'peakAlertDescPeakZhipu' | 'peakAlertDescOffZhipu' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'tierAlertEnterPeakZhipu' | 'tierAlertEnterOffZhipu' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionTag' | 'cellEstimateHint' | 'free' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapHalf' | 'heatmapMonth' | 'metricCost' | 'metricTokens' | 'heatmapTotal' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'densityLabel' | 'densityHint' | 'densityCompact' | 'densityDefault' | 'densityComfortable' | 'motionLabel' | 'motionHint' | 'motionOff' | 'motionSubtle' | 'motionRich' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSectionDisplay' | 'emptyHint' | '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' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown' | 'expandAll' | 'collapseAll' | 'todayOnly' | 'todayNoConsumption';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

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

@@ -54,8 +54,10 @@ export interface BillingCardPrefs {
     metric: BillingCardMetric;
     /** 主数字统计范围：今日 / 本周 / 本月（默认今日）。 */
     span: BillingCardSpan;
+    /** 是否显示「今日环比」涨跌徽章（默认显示；issue #93：部分用户觉得红色横条太醒目）。 */
+    showDelta: boolean;
 }
-/** 默认计费卡偏好：花费金额 + 今日口径。 */
+/** 默认计费卡偏好：花费金额 + 今日口径 + 显示环比徽章（保持 v1.5.0 行为）。 */
 export declare const DEFAULT_BILLING_CARD_PREFS: BillingCardPrefs;
 /** localStorage key（与 budget store 的 `dsh.ui-usage-billing.*` 命名空间一致）。 */
 export declare const BILLING_CARD_STORAGE_KEY = "dsh.ui-usage-billing.card";

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.5.0",
+  "version": "1.5.1",
   "keywords": [
     "deepseek-harness",
     "deepseek",
@@ -77,7 +77,8 @@
         "0.2.0-rc.2": "compatible",
         "0.2.1-alpha.1": "compatible",
         "0.2.1-alpha.2": "compatible",
-        "0.2.1-alpha.3": "compatible"
+        "0.2.1-alpha.3": "compatible",
+        "0.2.1-rc.2": "compatible"
       }
     }
   },
@@ -122,35 +123,36 @@
     "@deepseek-ai/cordis": "*",
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-atomic-write": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-home-paths": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-scope": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-session-persistence": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-user-approval": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-atomic-write": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4",
     "@shikijs/langs": "^4.3.1",
     "@testing-library/dom": "^10.4.1",