@kenz1117/dsh-ui-usage-billing 1.4.21 → 1.4.23

package/lib/index.js

@@ -2,12 +2,12 @@ import { createRequire } from "node:module";
 import { lstat, mkdir, readFile, rm, stat } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { SessionLogOffset } from "@deepseek-ai/dsh-session/types";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import z from "@deepseek-ai/schemastery";
+import * as sessionTypes from "@deepseek-ai/dsh-session/types";
 import { createHash, createHmac } from "node:crypto";
 //#region lib/types/client/plan-knowledge.js
 /**
@@ -585,15 +585,15 @@ function isPriced(key) {
 	return FALLBACK_RATES.some((rate) => rate.key.toLowerCase() === resolved.toLowerCase());
 }
 /**
-* 促销在 nowMs 是否生效：factor 必须落在 (0,1) 区间，截止时刻及之后视为过期；
-* endsAtMs 缺省表示长期活动，在 factor 合法期间持续生效。
+* 促销在 nowMs 是否生效：factor 必须落在 [0,1) 区间（0 = 活动期免费，issue #86），
+* 截止时刻及之后视为过期；endsAtMs 缺省表示长期活动，在 factor 合法期间持续生效。
 * 导出供测试：纯函数。
 * @param promo - 待判定的促销窗口。
 * @param nowMs - 判定时刻（epoch ms）。
 */
 function isPromoActive(promo, nowMs) {
 	const expired = promo.endsAtMs !== void 0 && nowMs >= promo.endsAtMs;
-	return Number.isFinite(nowMs) && !expired && promo.factor > 0 && promo.factor < 1;
+	return Number.isFinite(nowMs) && !expired && promo.factor >= 0 && promo.factor < 1;
 }
 /**
 * 把限时促销折入条目单价：生效期内返回 price 主档与 offPeak 逐档乘折扣系数的
@@ -606,7 +606,10 @@ function isPromoActive(promo, nowMs) {
 function applyPromo(entry, nowMs) {
 	const { promo } = entry;
 	if (promo === void 0 || !isPromoActive(promo, nowMs)) return entry;
-	const factorOf = (field) => promo.factors?.[field] ?? promo.factor;
+	const factorOf = (field) => {
+		const perBand = promo.factors?.[field];
+		return perBand !== void 0 && perBand >= 0 && perBand < 1 ? perBand : promo.factor;
+	};
 	const scaled = (band) => ({
 		input: band.input * factorOf("input"),
 		cacheHit: band.cacheHit * factorOf("cacheHit"),
@@ -1308,6 +1311,59 @@ const BUILTIN_MODEL_CATALOG = [
 			output: 16.8
 		}
 	},
+	{
+		key: "minimax-m3.1-flash-preview",
+		name: "MiniMax M3.1 Flash Preview",
+		provider: "MiniMax",
+		colorVar: "ds-amber",
+		price: {
+			currency: "CNY",
+			input: 2.1,
+			cacheHit: .42,
+			output: 8.4
+		}
+	},
+	{
+		key: "u2-flash",
+		name: "U2 Flash",
+		provider: "云知声",
+		colorVar: "dsw-static-violet-400",
+		price: {
+			currency: "CNY",
+			input: 1,
+			cacheHit: .2,
+			output: 2
+		},
+		promo: {
+			factor: 0,
+			endsAtMs: Date.UTC(2026, 9, 31, 16, 0, 0),
+			note: "限时免费至 2026-10-31"
+		}
+	},
+	{
+		key: "u2",
+		name: "Unisound U2",
+		provider: "云知声",
+		colorVar: "dsw-static-violet-400",
+		price: {
+			currency: "CNY",
+			input: 1,
+			cacheHit: .2,
+			output: 2
+		}
+	},
+	{
+		key: "u2-med",
+		name: "U2-Med",
+		provider: "云知声",
+		colorVar: "dsw-static-violet-400",
+		price: {
+			currency: "CNY",
+			input: 8,
+			cacheHit: 2,
+			output: 28
+		}
+	},
 	{
 		key: "ernie",
 		name: "ERNIE-5.1",
@@ -2244,6 +2300,11 @@ const BUILTIN_MODEL_KEY_ALIASES = {
 	"minimax-m2-7": "minimax-m2.7",
 	"minimax-m2-7-highspeed": "minimax-m2.7-highspeed",
 	"minimax-m2-7-high-speed": "minimax-m2.7-highspeed",
+	"minimax-m3.1-flash-preview": "minimax-m3.1-flash-preview",
+	"minimax-m3-1-flash-preview": "minimax-m3.1-flash-preview",
+	"u2-flash": "u2-flash",
+	"u2": "u2",
+	"u2-med": "u2-med",
 	"gpt-6": "gpt-6-astra",
 	"gpt-6-astra": "gpt-6-astra",
 	"gpt-6-sol": "gpt-6-sol",
@@ -2269,6 +2330,11 @@ const BUILTIN_MODEL_KEY_ALIASES = {
 * zero while their tokens still count. Pure functions only: the persistence
 * handle is injected, so the fold is unit-testable without a host.
 */
+/** 会话日志偏移：宿主 0.1.2-alpha.4 前的 dsh-session/types 不导出 SessionLogOffset
+* 值，具名导入让这些宿主装载即崩（v1.4.19~v1.4.22 实测，alpha.3 真机复现）；
+* namespace 导入不做具名导出校验，缺导出时退化为恒等——偏移类型是
+* BrandedNumber，值域与 number 同构，老宿主的 readFrom 原样收数字。 */
+const sessionLogOffsetOf = sessionTypes.SessionLogOffset ?? ((value) => value);
 /**
 * 走订阅套餐（coding / token plan / opencode 订阅）的 provider id：这些通道的
 * 调用按套餐计费，不再按 token 计费，因此即使模型 id 与计费表撞名也一律豁免。
@@ -3192,6 +3258,13 @@ function configFingerprint(subscriptionMatcher, officialProviderIds, routeAliase
 		String(searchEstimate)
 	].join("|");
 }
+/** 会话格式拒读（宿主 SessionFormatUnsupportedError）：日志完好，仅本构建读不了。
+* 宿主错误类显式落 error.name；经包装/重建的路径只在 message 里保留类名，两处都认。
+* 据此把「格式不受支持」与「损坏/其他读取失败」分开计数，供面板按原因归因（issue #84）。 */
+function isFormatUnsupportedError(error) {
+	if (!(error instanceof Error)) return false;
+	return error.name === "SessionFormatUnsupportedError" || error.message.includes("SessionFormatUnsupportedError");
+}
 /**
 * Create the incremental usage aggregator.
 * @param persistence - the session persistence service.
@@ -3301,12 +3374,22 @@ function createUsageAggregator(persistence, options = {}) {
 		const included = /* @__PURE__ */ new Set();
 		const folds = [];
 		const skipped = [];
+		let carriedUnreadable = 0;
+		let carriedFormatUnreadable = 0;
+		let formatUnreadable = 0;
+		let noLedgerUnreadable = 0;
 		let staleLedgerSessions = 0;
 		for (const meta of metas) {
 			const id = String(meta.id);
 			seen.add(id);
 			const stamp = await stampOf(meta);
-			if (stamp !== null && unreadable.get(id) === stamp) continue;
+			const mark = unreadable.get(id);
+			if (stamp !== null && mark !== void 0 && mark.stamp === stamp) {
+				carriedUnreadable += 1;
+				if (mark.format) carriedFormatUnreadable += 1;
+				if (!ledger.has(id)) noLedgerUnreadable += 1;
+				continue;
+			}
 			const hit = cache.get(id);
 			if (hit !== void 0 && stamp !== null && hit.stamp === stamp) {
 				cache.delete(id);
@@ -3335,7 +3418,7 @@ function createUsageAggregator(persistence, options = {}) {
 				const previous = cache.get(id);
 				if (previous?.machine !== void 0 && previous.lastSeq !== void 0) {
 					const from = previous.lastSeq + 1;
-					const { events, inheritedEventCount } = await persistence.readFrom(meta.id, SessionLogOffset(from));
+					const { events, inheritedEventCount } = await persistence.readFrom(meta.id, sessionLogOffsetOf(from));
 					const after = await stampOf(meta);
 					if (stamp !== null && after !== stamp) {
 						cache.delete(id);
@@ -3361,7 +3444,7 @@ function createUsageAggregator(persistence, options = {}) {
 					recordLedger(id, cwd, stamp, previous.fold);
 					continue;
 				}
-				const { events, inheritedEventCount } = await persistence.readFrom(meta.id, SessionLogOffset(0));
+				const { events, inheritedEventCount } = await persistence.readFrom(meta.id, sessionLogOffsetOf(0));
 				const after = await stampOf(meta);
 				if (stamp !== null && after !== stamp) continue;
 				const fold = freshFold();
@@ -3389,7 +3472,13 @@ function createUsageAggregator(persistence, options = {}) {
 				recordLedger(id, cwd, stamp, fold);
 			} catch (error) {
 				skipped.push(id);
-				if (stamp !== null) unreadable.set(id, stamp);
+				const format = isFormatUnsupportedError(error);
+				if (format) formatUnreadable += 1;
+				if (!ledger.has(id)) noLedgerUnreadable += 1;
+				if (stamp !== null) unreadable.set(id, {
+					stamp,
+					format
+				});
 				console.warn("[usage-billing] skip unreadable session", id, error);
 			}
 		}
@@ -3569,6 +3658,8 @@ function createUsageAggregator(persistence, options = {}) {
 				}).filter((entry) => entry !== null))];
 			}))
 		};
+		const unreadableTotal = skipped.length + carriedUnreadable;
+		const formatUnreadableTotal = formatUnreadable + carriedFormatUnreadable;
 		lastDoc = {
 			version: 4,
 			updatedAt: now,
@@ -3592,7 +3683,9 @@ function createUsageAggregator(persistence, options = {}) {
 			...searchEstimate > 0 ? { searchCallEstimateCny: searchEstimate } : {},
 			...perf === void 0 ? {} : { perf },
 			...staleLedgerSessions > 0 ? { staleLedgerSessions } : {},
-			...skipped.length > 0 ? { unreadableSessions: skipped.length } : {},
+			...unreadableTotal > 0 ? { unreadableSessions: unreadableTotal } : {},
+			...formatUnreadableTotal > 0 ? { unreadableFormatSessions: formatUnreadableTotal } : {},
+			...noLedgerUnreadable > 0 ? { unreadableNoLedgerSessions: noLedgerUnreadable } : {},
 			byRole: (() => {
 				const chars = roles.userChars + roles.toolChars;
 				const userShare = chars > 0 ? roles.userChars / chars : .5;
@@ -6894,8 +6987,8 @@ function adaptSessionPersistence(raw) {
 				const events = Array.isArray(slice) ? slice : slice.events;
 				return {
 					meta: handle.header,
-					fromSeq: SessionLogOffset(fromSeq),
-					inheritedEventCount: SessionLogOffset(handle.inheritedEventCount),
+					fromSeq: sessionLogOffsetOf(fromSeq),
+					inheritedEventCount: sessionLogOffsetOf(handle.inheritedEventCount),
 					events
 				};
 			} finally {

package/lib/types/aggregate.d.ts

@@ -10,11 +10,15 @@
  * zero while their tokens still count. Pure functions only: the persistence
  * handle is injected, so the fold is unit-testable without a host.
  */
-import { SessionLogOffset } from '@deepseek-ai/dsh-session/types';
-import type { SessionEvent, SessionHeader, SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SessionEvent, SessionHeader, SessionId, SessionLogOffset as SessionLogOffsetT } from '@deepseek-ai/dsh-session/types';
 import type { TokenUsage } from '@deepseek-ai/dsh-llm';
 import { resolveCatalogKey } from './client/pricing.ts';
 import { BUILTIN_MODEL_KEY_ALIASES } from './builtin-catalog.ts';
+/** 会话日志偏移：宿主 0.1.2-alpha.4 前的 dsh-session/types 不导出 SessionLogOffset
+ * 值，具名导入让这些宿主装载即崩（v1.4.19~v1.4.22 实测，alpha.3 真机复现）；
+ * namespace 导入不做具名导出校验，缺导出时退化为恒等——偏移类型是
+ * BrandedNumber，值域与 number 同构，老宿主的 readFrom 原样收数字。 */
+export declare const sessionLogOffsetOf: (value: number) => SessionLogOffsetT;
 export { BUILTIN_MODEL_KEY_ALIASES, resolveCatalogKey };
 /**
  * 走订阅套餐（coding / token plan / opencode 订阅）的 provider id：这些通道的
@@ -212,8 +216,8 @@ export declare function workspaceNameOf(cwd: string | undefined): string;
 /** readFrom 返回的后缀切片：与宿主 0.1.2 的 SessionEventSuffix 同构，本地结构声明。 */
 export interface UsageEventSuffix {
     readonly meta: SessionHeader;
-    readonly inheritedEventCount: SessionLogOffset;
-    readonly fromSeq: SessionLogOffset;
+    readonly inheritedEventCount: SessionLogOffsetT;
+    readonly fromSeq: SessionLogOffsetT;
     readonly events: readonly SessionEvent[];
 }
 /**
@@ -227,7 +231,7 @@ export interface UsageEventSuffix {
  */
 export interface UsagePersistence {
     list(): Promise<readonly SessionHeader[]>;
-    readFrom(id: SessionId, fromSeq: SessionLogOffset): Promise<UsageEventSuffix>;
+    readFrom(id: SessionId, fromSeq: SessionLogOffsetT): Promise<UsageEventSuffix>;
     locate?(meta: SessionHeader): {
         path: string;
     } | undefined;
@@ -295,8 +299,12 @@ export interface UsageStatsDocument {
     perf?: PerfStats;
     /** 只存在于账本、且缺 foldVersion 的旧会话数；无旧行时省略。 */
     staleLedgerSessions?: number;
-    /** 读时迁移拒读而未统计的会话数（原始日志未动，上游修复后自动恢复）；无拒读时省略。 */
+    /** 本轮未完整计入的会话数（新失败 + 负缓存命中，跨轮次稳定；有账本旧行的按存档计入最近可用点）；无失败时省略。 */
     unreadableSessions?: number;
+    /** 未统计中因会话格式拒读（SessionFormatUnsupportedError）的子集；无格式拒读时省略。 */
+    unreadableFormatSessions?: number;
+    /** 未统计中无任何账本存档、完全未计入的子集（区别于有存档按最近可用点计入的）；无存档缺失时省略。 */
+    unreadableNoLedgerSessions?: number;
 }
 /** 按角色费用归因：user / tool 为输入成本的启发式摊分，assistant 为输出成本实测。 */
 export interface RoleCost {

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

@@ -26,7 +26,7 @@ export interface TrendPoint {
     cost: number;
     /** API calls that day (total across models). */
     calls: number;
-    /** Total tokens that day (input+output+cache); used by the `tokens` metric. */
+    /** Total tokens that day (input+output — stats.input already includes cache hit/miss); used by the `tokens` metric. */
     tokens?: number;
     /** Per-model cost that day (stats key → CNY); absent entries plot zero. */
     byModel?: Readonly<Record<string, number>>;

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

@@ -110,6 +110,15 @@ export declare function activeDaysOf(byDay: Record<string, {
 export declare function streakDaysOf(byDay: Record<string, {
     cost: number;
 }>, now?: number): number;
+/** 按日 Token 口径：输入 + 输出。stats.input 本身已含缓存命中与未命中
+ * （aggregate foldUsage：input = cacheHit + cacheMiss），再叠加缓存字段即重复
+ * 计数——趋势图/热力图/触发卡/峰值日的按日 Token 一律走本函数（issue #85）；
+ * 跨日合计在各行之上累加（KPI 见 kpiAgg，触发卡见 month/weekTokens）。
+ * 导出供测试：纯函数。 */
+export declare function dayTokensOf(day: {
+    input: number;
+    output: number;
+}): number;
 /**
  * 近 7 天费用序列（含今天，缺日补 0）：触发卡 hover 速览的迷你柱数据源。
  * 导出供测试：纯函数（日期取本地时区）。
@@ -315,8 +324,12 @@ export interface UsageStats {
     perf?: ClientPerf;
     /** 旧版算法账本行兜底的会话数（模型归属可能失真）；0 或缺省 = 全部数据可信。 */
     staleLedgerSessions?: number;
-    /** 读时迁移拒读而未统计的会话数；0 或缺省 = 全部会话已统计。 */
+    /** 本轮未完整计入的会话数（跨轮次稳定）；0 或缺省 = 全部会话已统计。 */
     unreadableSessions?: number;
+    /** 未统计中因会话格式拒读的子集（过新待宿主升级、过旧需迁移）；0 或缺省 = 无格式拒读。 */
+    unreadableFormatSessions?: number;
+    /** 未统计中无账本存档、完全未计入的子集；0 或缺省 = 拒读会话均有存档兜底。 */
+    unreadableNoLedgerSessions?: number;
     /** 插件版本号（服务端读自包 package.json；旧快照缺失）。 */
     pluginVersion?: string;
 }

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' | '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' | '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' | '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' | '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/pricing.d.ts

@@ -278,12 +278,12 @@ export interface ModelPrice extends PriceBand {
  * （主档与 offPeak）单价按 factor 折扣计价与显示，截止时刻起自动恢复刊例价。
  */
 export interface PricePromo {
-    /** 折扣系数（0.5 = 五折）；仅 (0,1) 区间有效，非法值视为无促销。 */
+    /** 折扣系数（0.5 = 五折，0 = 活动期免费）；仅 [0,1) 区间有效，非法值视为无促销。 */
     factor: number;
     /**
      * 分档折扣覆盖：厂商对不同档位给不同折扣时逐档指定（如 GPT-5.6 Sol 促销为
      * 缓存 0.8 / 输入 0.8 / 输出 2/3）。缺省档位沿用 {@link factor}；单档取值
-     * 仅 (0,1) 区间有效，非法值回落 factor。
+     * 仅 [0,1) 区间有效（0 = 该档活动期免费），非法值回落 factor。
      */
     factors?: Partial<Record<'input' | 'cacheHit' | 'cacheMiss' | 'output', number>>;
     /**
@@ -382,8 +382,8 @@ export declare function modelOf(key: string): ModelEntry;
  */
 export declare function isPriced(key: string): boolean;
 /**
- * 促销在 nowMs 是否生效：factor 必须落在 (0,1) 区间，截止时刻及之后视为过期；
- * endsAtMs 缺省表示长期活动，在 factor 合法期间持续生效。
+ * 促销在 nowMs 是否生效：factor 必须落在 [0,1) 区间（0 = 活动期免费，issue #86），
+ * 截止时刻及之后视为过期；endsAtMs 缺省表示长期活动，在 factor 合法期间持续生效。
  * 导出供测试：纯函数。
  * @param promo - 待判定的促销窗口。
  * @param nowMs - 判定时刻（epoch ms）。

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.4.21",
+  "version": "1.4.23",
   "keywords": [
     "deepseek-harness",
     "deepseek",