@kenz1117/dsh-ui-usage-billing 1.8.0 → 1.8.1-alpha.2

package/lib/index.js

@@ -9482,7 +9482,7 @@ var TaskQueueEngine = class {
 		this.heartbeat = void 0;
 		this.taskAbort?.abort();
 	}
-	async snapshot() {
+	async snapshot(refreshModels = false) {
 		const countdown = channelCountdown(this.now(), "deepseek-metered");
 		const controller = usableController(this.options.getController());
 		const base = {
@@ -9499,7 +9499,7 @@ var TaskQueueEngine = class {
 		try {
 			return {
 				...base,
-				models: await this.modelOptions(controller)
+				...await this.modelOptions(controller, refreshModels)
 			};
 		} catch (error) {
 			return {
@@ -9529,7 +9529,7 @@ var TaskQueueEngine = class {
 		if (!Array.isArray(inputs) || inputs.length === 0) throw new TaskQueueError("at least one task is required");
 		if (inputs.length > MAX_QUEUED) throw new TaskQueueError("too many active queue items", 409);
 		const workspaces = this.options.getWorkspaces();
-		const models = await this.modelOptions(controller, true);
+		const { models } = await this.modelOptions(controller, true);
 		const validated = inputs.map((input, index) => {
 			try {
 				if (input === null || typeof input !== "object" || Array.isArray(input)) throw new TaskQueueError("task must be a JSON object");
@@ -9578,7 +9578,7 @@ var TaskQueueEngine = class {
 		});
 	}
 	async modelOptions(controller, refresh = false) {
-		if (!refresh && this.modelCache !== void 0 && this.now() - this.modelCache.at < OPTIONS_CACHE_MS) return this.modelCache.models;
+		if (!refresh && this.modelCache !== void 0 && this.now() - this.modelCache.at < OPTIONS_CACHE_MS) return this.modelCache;
 		const catalog = await controller.modelCatalog();
 		const models = [];
 		for (const group of catalog.groups) {
@@ -9593,11 +9593,20 @@ var TaskQueueEngine = class {
 				});
 			}
 		}
+		const candidate = catalog.default;
+		const defaultModel = candidate === void 0 ? void 0 : {
+			provider: candidate.provider,
+			model: candidate.model
+		};
 		this.modelCache = {
 			at: this.now(),
-			models
+			models,
+			defaultModel
+		};
+		return {
+			models,
+			defaultModel
 		};
-		return models;
 	}
 	async pump() {
 		if (this.stopped || this.pumping) return;
@@ -9670,7 +9679,8 @@ var TaskQueueEngine = class {
 				await this.requeue(claimed.id);
 				return;
 			}
-			if (!(await this.modelOptions(controller, true)).some((model) => model.provider === claimed.provider && model.id === claimed.model)) throw new TaskQueueError("the selected official DeepSeek model is no longer available", 409);
+			const { models: availableModels } = await this.modelOptions(controller, true);
+			if (!availableModels.some((model) => model.provider === claimed.provider && model.id === claimed.model)) throw new TaskQueueError("the selected official DeepSeek model is no longer available", 409);
 			const { sessionId } = await controller.create({ cwd: claimed.cwd });
 			if (!await this.patch(claimed.id, { sessionId })) return;
 			await controller.selectModel({
@@ -9866,7 +9876,8 @@ function registerTaskQueueRoute(ctx, deps) {
 			}
 			try {
 				if (req.method === "GET") {
-					send(res, 200, await deps.engine.snapshot());
+					const refresh = new URL(req.url ?? "", "http://127.0.0.1").searchParams.get("refresh") === "1";
+					send(res, 200, await deps.engine.snapshot(refresh));
 					return;
 				}
 				const chunks = [];

package/lib/types/client/api/task-queue.d.ts

@@ -1,6 +1,6 @@
 /** API client for the new-host off-peak task queue preview (issue #106). */
 import type { TaskQueueInput, TaskQueueSnapshot, TaskQueueSummary } from '../../task-queue-shared.ts';
-export declare function loadTaskQueue(): Promise<TaskQueueSnapshot>;
+export declare function loadTaskQueue(refreshModels?: boolean): Promise<TaskQueueSnapshot>;
 export declare function loadTaskQueueSummary(): Promise<TaskQueueSummary>;
 export type TaskQueueAction = {
     action: 'enqueue';

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

@@ -38,8 +38,8 @@ export declare const DASHBOARD_TABS: readonly {
     id: DashboardTab;
     labelKey: UsageBillingKey;
 }[];
-/** 平均成本的统计范围（issue #47）；`all` = 全量累计，不进逐日求和。 */
-export type AvgCostRange = 'today' | '7d' | 'week' | 'month' | 'all';
+/** Hero + KPI 统计范围；`all` 用总量，`custom` 用持久化的本地起止日期。 */
+export type AvgCostRange = 'today' | '7d' | 'week' | 'month' | 'all' | 'custom';
 /** 全局 KPI 按日聚合行的最小字段（byDay 行 = ModelUsage，结构兼容）。 */
 export interface KpiDayRow {
     cost: number;
@@ -48,6 +48,7 @@ export interface KpiDayRow {
     output: number;
     cacheHit: number;
     cacheMiss: number;
+    cacheWrite?: number;
     reasoning?: number;
 }
 /** 全局 KPI 聚合结果：KPI 七卡按所选范围重算所需的全部字段。 */
@@ -58,6 +59,7 @@ export interface KpiAgg {
     output: number;
     cacheHit: number;
     cacheMiss: number;
+    cacheWrite: number;
     reasoning: number;
     /** 范围内总处理 Token（缓存读+缓存写+输出）最大的日期戳；窗口无数据时 undefined。 */
     peakDay: string | undefined;

package/lib/types/client/domain/week.d.ts

@@ -31,5 +31,7 @@ export declare function sinceMondayOf<T>(byDay: Record<string, T>, today: string
  * 本月。日期戳字典序即时间序（与 dailyBurnRate 同口径）；累计口径由调用方
  * 直接取 total（含搜索估值兜底），不走此函数。
  */
-export declare function sumByDayRange(byDay: Record<string, KpiDayRow>, today: string, range: Exclude<AvgCostRange, 'all'>): KpiAgg;
+export declare function sumByDayRange(byDay: Record<string, KpiDayRow>, today: string, range: Exclude<AvgCostRange, 'all' | 'custom'>): KpiAgg;
+/** 自定义本地日期范围：起止日均完整包含，字典序边界与 byDay 键一致。 */
+export declare function sumByDayCustomRange(byDay: Record<string, KpiDayRow>, start: string, end: string): KpiAgg;
 //# sourceMappingURL=week.d.ts.map

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' | 'monthProjectedHint' | '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' | 'balanceStaleNotice' | 'staleLedgerNotice' | 'staleSnapshotNotice' | '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' | 'peakAlertQueuePeak' | 'peakAlertQueueOff' | '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' | 'settingsNavDisplayPref' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSearchPlaceholder' | 'settingsSearchEmpty' | 'sessionsViewAll' | 'sessionViewerSearch' | 'modelBudgetTitle' | 'modelBudgetHint' | 'modelBudgetBody' | 'modelBudgetPlaceholder' | 'moreWorksTitle' | 'adEngramName' | 'adEngramDesc' | 'adRainbowName' | 'adRainbowDesc' | 'kpiDescCacheHit' | 'kpiDescTokens' | 'kpiDescAvgCost' | 'kpiDescCalls' | 'kpiDescReasoning' | 'kpiDescIo' | 'kpiDescPeak' | 'healthDotLive' | 'healthDotFailed' | 'healthDotUnknown' | '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' | 'commandUsageLabel' | 'commandUsageDescription' | 'sessionOpen' | 'sessionOpenFailed' | 'sessionOpenUnavailable' | 'tabAgents' | 'tabQueue' | 'queueSubtitle' | 'queueUntilPeak' | 'queueUntilOffPeak' | 'queueUnsupportedTitle' | 'queueUnsupportedBody' | 'queueSafety' | 'queueWorkspace' | 'queueModel' | 'queueNoOptions' | 'queuePromptLabel' | 'queuePromptPlaceholder' | 'queuePrivacy' | 'queueEnqueue' | 'queueImport' | 'queueImportHint' | 'queueImported' | 'queueImportFormat' | 'queueImportTooLarge' | 'queueActive' | 'queueClearFinished' | 'queueEmpty' | 'queueLoading' | 'queueOpenSession' | 'queueRemoveQueued' | 'queueRemoveHistory' | 'queueStatusQueued' | 'queueStatusStarting' | 'queueStatusRunning' | 'queueStatusCompleted' | 'queueStatusFailed' | 'agentsSummary' | 'agentsCount' | 'agentsDelegations' | 'agentsRoots' | 'agentsMostExpensive' | 'agentsChainTotal' | 'agentsNoData' | 'agentsSubagent' | 'agentsRoot';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'monthProjectedHint' | 'liveTurn' | 'liveSession' | 'liveSessionSub' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'avgRangeCustom' | 'customRangeStart' | 'customRangeEnd' | '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' | 'balanceStaleNotice' | 'staleLedgerNotice' | 'staleSnapshotNotice' | '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' | 'peakAlertQueuePeak' | 'peakAlertQueueOff' | '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' | 'settingsNavDisplayPref' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSearchPlaceholder' | 'settingsSearchEmpty' | 'sessionsViewAll' | 'sessionViewerSearch' | 'modelBudgetTitle' | 'modelBudgetHint' | 'modelBudgetBody' | 'modelBudgetPlaceholder' | 'moreWorksTitle' | 'adEngramName' | 'adEngramDesc' | 'adRainbowName' | 'adRainbowDesc' | 'kpiDescCacheHit' | 'kpiDescTokens' | 'kpiDescAvgCost' | 'kpiDescCalls' | 'kpiDescReasoning' | 'kpiDescIo' | 'kpiDescPeak' | 'healthDotLive' | 'healthDotFailed' | 'healthDotUnknown' | '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' | 'commandUsageLabel' | 'commandUsageDescription' | 'sessionOpen' | 'sessionOpenFailed' | 'sessionOpenUnavailable' | 'tabAgents' | 'tabQueue' | 'queueSubtitle' | 'queueUntilPeak' | 'queueUntilOffPeak' | 'queueUnsupportedTitle' | 'queueUnsupportedBody' | 'queueSafety' | 'queueWorkspace' | 'queueModel' | 'queueNoOptions' | 'queuePromptLabel' | 'queuePromptPlaceholder' | 'queuePrivacy' | 'queueEnqueue' | 'queueImport' | 'queueImportHint' | 'queueImported' | 'queueImportFormat' | 'queueImportTooLarge' | 'queueActive' | 'queueClearFinished' | 'queueEmpty' | 'queueLoading' | 'queueOpenSession' | 'queueRemoveQueued' | 'queueRemoveHistory' | 'queueStatusQueued' | 'queueStatusStarting' | 'queueStatusRunning' | 'queueStatusCompleted' | 'queueStatusFailed' | 'quickQueueToggle' | 'quickQueueEnqueue' | 'quickQueueEnqueueing' | 'quickQueueWaiting' | 'quickQueueClear' | 'quickQueueEnqueued' | 'quickQueueEmpty' | 'quickQueueBusy' | 'quickQueueAttachments' | 'quickQueueContext' | 'quickQueueRoute' | 'quickQueueDraftChanged' | 'quickQueueUnsupported' | 'quickQueueFailed' | 'agentsSummary' | 'agentsCount' | 'agentsDelegations' | 'agentsRoots' | 'agentsMostExpensive' | 'agentsChainTotal' | 'agentsNoData' | 'agentsSubagent' | 'agentsRoot';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

package/lib/types/client/task-queue-quick.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Composer shortcut for the existing off-peak task queue.
+ *
+ * This component only snapshots the current draft, working directory and next
+ * model route into the queue API. It never submits to the current Session and
+ * never starts a task. Optional draft clearing is revision-checked after the
+ * mutation succeeds so late responses cannot erase subsequent user input.
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { InputActions, InputState } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { SessionProjectionMap } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { UsageBillingKey } from './locales.ts';
+type Translate = (key: UsageBillingKey) => string;
+type ProjectionKey = Extract<keyof SessionProjectionMap, string>;
+/** Optional selector shape: old hosts may omit the standard input kit. */
+type ReadInput = <S>(selector: (state: InputState) => S, eq?: (a: S, b: S) => boolean) => S | undefined;
+/**
+ * Projection cells come from the current Session's public `projections.faceOf`.
+ * The composer standard kit guarantees `useInput`; projection access remains an
+ * optional capability so older hosts degrade instead of blocking web startup.
+ */
+export type ProjectionFaceOf = (key: ProjectionKey) => ObservableSnapshot<unknown> | undefined;
+export interface QuickQueueToggleProps {
+    readonly t: Translate;
+}
+export interface QuickQueueEnqueueProps {
+    readonly sessionId: SessionId;
+    readonly t: Translate;
+    readonly useInput?: ReadInput | undefined;
+    readonly inputActions?: InputActions | undefined;
+    readonly projectionFaceOf?: ProjectionFaceOf | undefined;
+}
+/** Persistent, opt-in composer switch. It performs no queue or network writes. */
+export declare function QuickQueueToggle({ t }: QuickQueueToggleProps): React.ReactNode;
+/** Enqueue the captured draft for a later off-peak window; never prompt the current Session. */
+export declare function QuickQueueEnqueue({ sessionId, t, useInput, inputActions, projectionFaceOf, }: QuickQueueEnqueueProps): React.ReactNode;
+export {};
+//# sourceMappingURL=task-queue-quick.d.ts.map

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

@@ -65,14 +65,24 @@ export declare const BILLING_CARD_STORAGE_KEY = "dsh.ui-usage-billing.card";
 export declare function loadBillingCardPrefs(): BillingCardPrefs;
 /** 写入计费卡偏好。失败静默（展示偏好非关键）。 */
 export declare function saveBillingCardPrefs(prefs: BillingCardPrefs): void;
-/** 概览 KPI 全局统计范围（今日/近7天/本周/本月/累计），与组件内 AvgCostRange 同构。 */
-export type KpiRangePref = 'today' | '7d' | 'week' | 'month' | 'all';
+/** 概览 Hero + KPI 全局统计范围（预设或自定义起止日期），与组件内 AvgCostRange 同构。 */
+export type KpiRangePref = 'today' | '7d' | 'week' | 'month' | 'all' | 'custom';
+/** 自定义日期范围：本地日历日，起止均包含；不伪装成分钟级切片。 */
+export interface KpiCustomRange {
+    start: string;
+    end: string;
+}
 /** localStorage key（与其他 `dsh.ui-usage-billing.*` 偏好同命名空间）。 */
 export declare const KPI_RANGE_STORAGE_KEY = "dsh.ui-usage-billing.kpi-range";
+export declare const KPI_CUSTOM_RANGE_STORAGE_KEY = "dsh.ui-usage-billing.kpi-custom-range";
 /** 读取 KPI 全局范围偏好（损坏/越界回退「累计」）。仅在浏览器半区调用。 */
 export declare function loadKpiRange(): KpiRangePref;
 /** 写入 KPI 全局范围偏好。失败静默（展示偏好非关键）。 */
 export declare function saveKpiRange(range: KpiRangePref): void;
+/** 自定义范围缺省为昨天；损坏、非法日期或起止倒置一律回退，避免意外全量。 */
+export declare function loadKpiCustomRange(): KpiCustomRange;
+/** 自定义起止日期与范围种类分开保存，切走再切回仍保留上次选择。 */
+export declare function saveKpiCustomRange(range: KpiCustomRange): void;
 /**
  * 中转站列表（中转站分布 / 中转站额度）的展示偏好（issue #17）。
  * 纯 client 偏好，存 localStorage（不依赖 node 半区接口/设置 schema）。
@@ -245,4 +255,18 @@ export declare const DEFAULT_MOTION: MotionPref;
 export declare function loadMotion(): MotionPref;
 /** 写入动效偏好并同步派发事件。失败静默。 */
 export declare function saveMotion(motion: MotionPref): void;
+/** Composer shortcut preferences; both actions are opt-in and default off. */
+export interface QuickQueuePrefs {
+    /** Show the draft enqueue controls beside the composer. */
+    enabled: boolean;
+    /** Clear only the exact enqueued draft revision after a successful mutation. */
+    clearAfterEnqueue: boolean;
+}
+export declare const DEFAULT_QUICK_QUEUE_PREFS: QuickQueuePrefs;
+export declare const QUICK_QUEUE_STORAGE_KEY = "dsh.ui-usage-billing.quick-queue";
+export declare const QUICK_QUEUE_PREF_EVENT = "dsh.ui-usage-billing.quick-queue-pref";
+/** Read composer queue preferences, failing closed on missing or malformed values. */
+export declare function loadQuickQueuePrefs(): QuickQueuePrefs;
+/** Persist and broadcast to the independent left/right composer React trees. */
+export declare function saveQuickQueuePrefs(prefs: QuickQueuePrefs): void;
 //# sourceMappingURL=usage-billing-settings.d.ts.map

package/lib/types/config.d.ts

@@ -28,11 +28,11 @@ export interface VolatileToggle {
  * object 透传未声明键，其余 config 字段不受影响；未导出 Config 的旧宿主直接
  * 把原始 config 交给 apply，普通布尔形态由读取端兼容。
  */
-export declare const Config: z<Schemastery.ObjectS<NoInfer<{
-    enableUsageStatsTool: z<boolean, boolean, "volatile-defined">;
-}>>, Schemastery.ObjectT<NoInfer<{
-    enableUsageStatsTool: z<boolean, boolean, "volatile-defined">;
-}>>, "plain">;
+export declare const Config: z<{
+    enableUsageStatsTool?: boolean | null;
+}, {
+    enableUsageStatsTool: VolatileToggle;
+}>;
 /** Plugin configuration. */
 export interface UsageBillingConfig {
     /** Absolute path to a `.dsh-usage-stats.json` fallback file. */

package/lib/types/task-queue-shared.d.ts

@@ -30,6 +30,10 @@ export interface TaskQueueModel {
     readonly id: string;
     readonly name: string;
 }
+export interface TaskQueueModelSelection {
+    readonly provider: string;
+    readonly model: string;
+}
 export interface TaskQueueSnapshot {
     /** All required host Session-control methods are available. */
     readonly supported: boolean;
@@ -38,6 +42,8 @@ export interface TaskQueueSnapshot {
     readonly tasks: readonly TaskQueueTask[];
     readonly workspaces: readonly TaskQueueWorkspace[];
     readonly models: readonly TaskQueueModel[];
+    /** Host default route for an unconfigured Session; eligibility is checked separately. */
+    readonly defaultModel?: TaskQueueModelSelection | undefined;
     readonly optionsError?: string;
 }
 /** Lightweight alert polling shape: never transports Prompt or Session content. */

package/lib/types/task-queue.d.ts

@@ -38,7 +38,7 @@ export declare class TaskQueueEngine {
     constructor(options: TaskQueueEngineOptions);
     start(): void;
     stop(): void;
-    snapshot(): Promise<TaskQueueSnapshot>;
+    snapshot(refreshModels?: boolean): Promise<TaskQueueSnapshot>;
     summary(): Promise<TaskQueueSummary>;
     enqueue(input: TaskQueueInput): Promise<void>;
     /** Validate the whole batch before one locked append: no partially admitted import. */

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.8.0",
+  "version": "1.8.1-alpha.2",
   "keywords": [
     "deepseek-harness",
     "deepseek",