@kenz1117/dsh-ui-usage-billing 1.0.8 → 1.0.9

package/lib/index.js

@@ -1761,6 +1761,28 @@ function foldUsage(acc, usage, key, subscription, timeMs, official = false) {
 		if (official) acc.officialCost += thisCost;
 	}
 }
+/**
+* 联网搜索辅助请求的单次费用估算默认值（人民币元）。DeepSeek 官方对搜索请求
+* （web_search 服务端工具注入上下文）照常计费，实测每次约 0.01~0.03 元，取中值；
+* 部署可在插件配置 `searchCallEstimateCny` 覆盖（设 0 关闭估算）。
+*/
+const DEFAULT_SEARCH_CALL_ESTIMATE_CNY = .02;
+/**
+* Fold one auxiliary web-search LLM request (issue #15) into an accumulator.
+* 这类调用绕过对话通道直连官方端点，日志只记请求（无响应/用量事件），token
+* 不可知：按「每次估值」计入费用并单独累计 `searchCalls`，不产生 token 维度。
+* @param acc - the accumulator to mutate.
+* @param estimateCny - per-call cost estimate in CNY; 0 disables the estimate.
+*/
+function foldSearchCall(acc, estimateCny) {
+	acc.calls += 1;
+	acc.searchCalls = (acc.searchCalls ?? 0) + 1;
+	acc.officialCalls += 1;
+	if (estimateCny > 0) {
+		acc.cost += estimateCny;
+		acc.officialCost += estimateCny;
+	}
+}
 /** Local-time date stamp (the host runs in the user's timezone). */
 function dayStamp(time) {
 	const date = new Date(time);
@@ -1946,9 +1968,11 @@ function turnState(turns, turn) {
 * @param subscriptionProviders - provider ids billed through subscription plans.
 * @param officialProviderIds - provider ids treated as the official DeepSeek channel
 *   (default: any `deepseek`-prefixed id). Others count as third-party.
+* @param routes - 当前 provider 路由视图（中转站归组）。
+* @param searchCallEstimateCny - 联网搜索请求的单次费用估算（人民币元；0 关闭估算）。
 * @returns the per-session fold (cached by the incremental aggregator).
 */
-function foldSession(events, subscriptionProviders, officialProviderIds, routes = {}) {
+function foldSession(events, subscriptionProviders, officialProviderIds, routes = {}, searchCallEstimateCny = DEFAULT_SEARCH_CALL_ESTIMATE_CNY) {
 	let seedBoundary = -1;
 	for (const event of events) if (event.type === "session/end-seed" && typeof event.seq === "number" && Number.isFinite(event.seq)) seedBoundary = Math.max(seedBoundary, event.seq);
 	if (seedBoundary >= 0) {
@@ -2031,6 +2055,21 @@ function foldSession(events, subscriptionProviders, officialProviderIds, routes
 			}
 			continue;
 		}
+		if (event.type === "web/deepseek-search-llm-request") {
+			const model = event.data.body?.model;
+			const modelKey = typeof model === "string" && model !== "" ? resolveCatalogKey(model) : "other";
+			const day = dayStamp(event.time);
+			foldSearchCall(fold.total, searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byModel, modelKey), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byDay, day), searchCallEstimateCny);
+			foldSearchCall(modelDayCell(fold.byDayModels, day, modelKey), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.bySite, siteBucketKey({
+				kind: "direct",
+				provider: "deepseek"
+			})), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byTier, tierAt(event.time)), searchCallEstimateCny);
+			continue;
+		}
 		if (event.type === "assistant/chunk") {
 			const data = event.data;
 			const turn = data.turn;
@@ -2159,6 +2198,7 @@ function mergeUsageInto(acc, cell) {
 	acc.cost += cell.cost;
 	acc.officialCalls += cell.officialCalls;
 	acc.officialCost += cell.officialCost;
+	if (cell.searchCalls !== void 0) acc.searchCalls = (acc.searchCalls ?? 0) + cell.searchCalls;
 }
 /** 均值（数组非空时调用；空数组按 0 兜底）。 */
 function mean(values) {
@@ -2200,6 +2240,7 @@ function createUsageAggregator(persistence, options = {}) {
 	let lastAt = 0;
 	/** 每次聚合取最新的 provider 路由视图（中转站零配置发现）；缺省按空处理（全部未知路由）。 */
 	const routesOf = () => options.resolveRoutes?.() ?? {};
+	const searchEstimate = options.searchCallEstimateCny ?? .02;
 	const ensureLedgerLoaded = async () => {
 		if (ledgerLoaded || options.ledger === void 0) return;
 		ledgerLoaded = true;
@@ -2264,7 +2305,7 @@ function createUsageAggregator(persistence, options = {}) {
 				const { events } = await persistence.readFrom(meta.id, 0);
 				const after = await stampOf(meta);
 				if (stamp !== null && after !== stamp) continue;
-				const fold = foldSession(events, subscriptionProviders, officialProviderIds, routesOf());
+				const fold = foldSession(events, subscriptionProviders, officialProviderIds, routesOf(), searchEstimate);
 				cache.set(id, {
 					stamp,
 					fold
@@ -2280,7 +2321,7 @@ function createUsageAggregator(persistence, options = {}) {
 						id,
 						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
 						...stamp === null ? {} : { stamp },
-						foldVersion: 2,
+						foldVersion: 3,
 						fold: serializeFold(fold)
 					};
 					const previous = ledger.get(id);
@@ -2304,7 +2345,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 2;
+					const stale = (entry.foldVersion ?? 1) < 3;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -2469,6 +2510,7 @@ function createUsageAggregator(persistence, options = {}) {
 			...byTool.size === 0 ? {} : { byTool: Object.fromEntries([...byTool].sort((a, b) => b[1] - a[1])) },
 			...bySite.size === 0 ? {} : { bySite: toRecord(bySite) },
 			...unpricedModels.size === 0 ? {} : { unpricedModels: [...unpricedModels].sort() },
+			...searchEstimate > 0 ? { searchCallEstimateCny: searchEstimate } : {},
 			...perf === void 0 ? {} : { perf },
 			...staleLedgerSessions > 0 ? { staleLedgerSessions } : {},
 			byRole: (() => {
@@ -4921,6 +4963,7 @@ function apply(ctx, config = {}) {
 		...config.subscriptionProviders === void 0 ? {} : { subscriptionProviders: config.subscriptionProviders },
 		resolveRoutes: () => readPiAiProviderRoutes(ctx.settings),
 		...workspaceTitleResolver === void 0 ? {} : { resolveWorkspaceTitle: workspaceTitleResolver },
+		...config.searchCallEstimateCny === void 0 ? {} : { searchCallEstimateCny: config.searchCallEstimateCny },
 		ledger: ledgerStore
 	});
 	const candidates = [

package/lib/types/aggregate.d.ts

@@ -74,6 +74,9 @@ export interface AggregateOptions {
     /** 独立的持久用量账本。启用后，已经成功折叠过的会话即使随后从
      *  sessionPersistence 中永久删除，也会继续计入累计用量。 */
     ledger?: UsageLedgerStore;
+    /** 联网搜索请求（`web/deepseek-search-llm-request`，无用量事件）的单次费用
+     *  估算（人民币元）；默认 {@link DEFAULT_SEARCH_CALL_ESTIMATE_CNY}，设 0 关闭。 */
+    searchCallEstimateCny?: number;
 }
 /** 每会话折叠缓存默认上限：超过则按 LRU 淘汰（P1-6 峰值内存治理）。 */
 export declare const DEFAULT_MAX_CACHE_SESSIONS = 400;
@@ -98,6 +101,12 @@ export interface ModelUsage {
     officialCalls: number;
     /** 走官方渠道的费用（CNY）；三方费用 = cost - officialCost。 */
     officialCost: number;
+    /**
+     * 联网搜索辅助请求的估算调用数（`web/deepseek-search-llm-request`，日志只有
+     * 请求无用量事件）；已按每次 `searchCallEstimateCny` 估算计入 `cost`，不计
+     * token。旧快照缺失。
+     */
+    searchCalls?: number;
 }
 /** Zeroed usage accumulator. */
 export declare function emptyUsage(): ModelUsage;
@@ -113,6 +122,20 @@ export declare function emptyUsage(): ModelUsage;
  * @param official - whether the call went through the official DeepSeek channel (vs a third-party relay).
  */
 export declare function foldUsage(acc: ModelUsage, usage: TokenUsage, key: string, subscription: boolean, timeMs: number, official?: boolean): void;
+/**
+ * 联网搜索辅助请求的单次费用估算默认值（人民币元）。DeepSeek 官方对搜索请求
+ * （web_search 服务端工具注入上下文）照常计费，实测每次约 0.01~0.03 元，取中值；
+ * 部署可在插件配置 `searchCallEstimateCny` 覆盖（设 0 关闭估算）。
+ */
+export declare const DEFAULT_SEARCH_CALL_ESTIMATE_CNY = 0.02;
+/**
+ * Fold one auxiliary web-search LLM request (issue #15) into an accumulator.
+ * 这类调用绕过对话通道直连官方端点，日志只记请求（无响应/用量事件），token
+ * 不可知：按「每次估值」计入费用并单独累计 `searchCalls`，不产生 token 维度。
+ * @param acc - the accumulator to mutate.
+ * @param estimateCny - per-call cost estimate in CNY; 0 disables the estimate.
+ */
+export declare function foldSearchCall(acc: ModelUsage, estimateCny: number): void;
 /** Local-time date stamp (the host runs in the user's timezone). */
 export declare function dayStamp(time: number): string;
 /** Local-time hour stamp `YYYY-MM-DDTHH` — the performance series bucket key. */
@@ -182,6 +205,8 @@ export interface UsageStatsDocument {
     byRole?: RoleCost;
     /** 不可计价的模型 id（未收录 / 无价，费用按 0 计）；供面板提示用户自查与反馈。 */
     unpricedModels?: readonly string[];
+    /** 联网搜索请求的单次费用估算（人民币元，配置回显）；0 或缺省 = 未启用估算。 */
+    searchCallEstimateCny?: number;
     /**
      * 性能指标（TTFT / 生成速度 / 总延迟）按模型与按小时聚合；旧快照可能缺失。
      * 口径：TTFT = request/header → 首个内容 chunk；生成速度 = 输出 token ÷ 生成时长；
@@ -381,10 +406,11 @@ export interface UsageLedgerDocument {
 /**
  * 折叠算法版本：归账语义变化时递增。v1 = 按 request/header 归账（稀疏 header 把
  * 两次 header 之间的用量串到上一个模型，订阅模型首当其冲，issue #14）；v2 =
- * `assistant/message` 自带 source 归账（1.0.7 起）。持久账本行据此区分新旧算法：
- * 日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
+ * `assistant/message` 自带 source 归账（1.0.7 起）；v3 = 联网搜索请求按次估算
+ * 计费（issue #15，1.0.9 起）——旧行缺 `searchCalls` 维度与搜索估算费用。
+ * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 2;
+export declare const FOLD_VERSION = 3;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并
@@ -428,6 +454,8 @@ export declare function messageTextLength(message: unknown): number;
  * @param subscriptionProviders - provider ids billed through subscription plans.
  * @param officialProviderIds - provider ids treated as the official DeepSeek channel
  *   (default: any `deepseek`-prefixed id). Others count as third-party.
+ * @param routes - 当前 provider 路由视图（中转站归组）。
+ * @param searchCallEstimateCny - 联网搜索请求的单次费用估算（人民币元；0 关闭估算）。
  * @returns the per-session fold (cached by the incremental aggregator).
  */
 export declare function foldSession(events: readonly {
@@ -435,7 +463,7 @@ export declare function foldSession(events: readonly {
     time: number;
     data: never;
     seq?: number;
-}[], subscriptionProviders: ReadonlySet<string>, officialProviderIds?: ReadonlySet<string>, routes?: Readonly<Record<string, ProviderRouteView>>): SessionFold;
+}[], subscriptionProviders: ReadonlySet<string>, officialProviderIds?: ReadonlySet<string>, routes?: Readonly<Record<string, ProviderRouteView>>, searchCallEstimateCny?: number): SessionFold;
 /**
  * 增量聚合器：按会话缓存折叠结果，用日志文件的 mtime+size 作失效键——
  * 日志没动的会话直接复用，只有写过的会话重新折叠；整份文档另有短 TTL

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

@@ -143,6 +143,8 @@ export interface UsageStats {
         cost: number;
         /** 输出中的 reasoning（思考）token；已含在 output 内。 */
         reasoning: number;
+        /** 联网搜索请求的估算调用数（已按次估值计入 cost）；1.0.9 起新增，旧快照缺失。 */
+        searchCalls?: number;
     };
     byModel: Record<string, {
         calls: number;
@@ -227,6 +229,8 @@ export interface UsageStats {
     }>;
     /** 不可计价模型 id（未收录/无价，费用按 0 计）；旧快照可能缺失。 */
     unpricedModels?: readonly string[];
+    /** 联网搜索请求的单次费用估算（人民币元，配置回显）；0 或缺省 = 未启用估算。 */
+    searchCallEstimateCny?: number;
     /** 按角色费用归因（估算口径：输出实测，输入按消息长度摊分）；旧快照可能缺失。 */
     byRole?: {
         user: number;

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.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.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.exportCsvSite' | 'billing.panelRelay' | 'billing.relaySite' | 'billing.relayDirect' | 'billing.relayUnknown' | 'billing.panelRelayQuota' | 'billing.relayBalance' | 'billing.relayNoQuota' | 'billing.relayWindowUsed' | 'billing.relayKindNewApi' | 'billing.relayKindSub2Api' | 'billing.relayKindUnknown' | 'billing.relayCalls';
+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.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.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.exportCsvSite' | 'billing.panelRelay' | 'billing.relaySite' | 'billing.relayDirect' | 'billing.relayUnknown' | 'billing.panelRelayQuota' | 'billing.relayBalance' | 'billing.relayNoQuota' | 'billing.relayWindowUsed' | 'billing.relayKindNewApi' | 'billing.relayKindSub2Api' | 'billing.relayKindUnknown' | 'billing.relayCalls';
 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

@@ -56,6 +56,22 @@ export declare const BILLING_CARD_STORAGE_KEY = "dsh.ui-usage-billing.card";
 export declare function loadBillingCardPrefs(): BillingCardPrefs;
 /** 写入计费卡偏好。失败静默（展示偏好非关键）。 */
 export declare function saveBillingCardPrefs(prefs: BillingCardPrefs): void;
+/**
+ * 中转站列表（中转站分布 / 中转站额度）的展示偏好（issue #17）。
+ * 纯 client 偏好，存 localStorage（不依赖 node 半区接口/设置 schema）。
+ */
+export interface SiteListPrefs {
+    /** 隐藏「未知路由」（bySite 的 unknown 桶）与「未识别」类型的中转站占位条目；默认隐藏。 */
+    hideUnidentified: boolean;
+}
+/** 默认站点列表偏好：隐藏无参考价值的占位条目，净化账单列表。 */
+export declare const DEFAULT_SITE_LIST_PREFS: SiteListPrefs;
+/** localStorage key（与其他 `dsh.ui-usage-billing.*` 偏好同命名空间）。 */
+export declare const SITE_LIST_STORAGE_KEY = "dsh.ui-usage-billing.sites";
+/** 读取站点列表偏好（含损坏/缺失回退到默认）。仅在浏览器半区调用。 */
+export declare function loadSiteListPrefs(): SiteListPrefs;
+/** 写入站点列表偏好。失败静默（展示偏好非关键）。 */
+export declare function saveSiteListPrefs(prefs: SiteListPrefs): void;
 /** 用户自定义单价（与 client/pricing.ts 的 `UserPrice` 同形；此处不 import 以保持 node 半区无 client 依赖）。 */
 export interface StoredUserPrice {
     /** 未命中输入单价（元或美元 / 每百万 token）。 */

package/lib/types/index.d.ts

@@ -59,6 +59,12 @@ export interface UsageBillingConfig {
     /** `usage_stats` 工具注入的组合 base（默认 false：不注入）；与设置命名空间同字段，
      *  作为用户设置（设置 Tab 开关）的组合兜底。该工具占用每次请求的上下文，coding 场景多在仪表盘查看。 */
     enableUsageStatsTool?: boolean;
+    /**
+     * 联网搜索请求（`web/deepseek-search-llm-request`，日志只有请求、无用量事件）
+     * 的单次费用估算（人民币元）。这类调用直连官方 api.deepseek.com，开放平台照常
+     * 计费但本地日志无 usage，按次估值计入今日/本月费用；默认 0.02 元/次，设 0 关闭。
+     */
+    searchCallEstimateCny?: number;
 }
 /**
  * Create the atomic file-backed durable-ledger store. The previous complete file

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