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

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);
@@ -1844,6 +1866,7 @@ function serializeFold(fold) {
 		byModel: Object.fromEntries(fold.byModel),
 		byDay: Object.fromEntries(fold.byDay),
 		byDayModels: Object.fromEntries([...fold.byDayModels].map(([day, models]) => [day, Object.fromEntries(models)])),
+		byDayModelsSite: Object.fromEntries([...fold.byDayModelsSite].map(([day, models]) => [day, Object.fromEntries([...models].map(([model, sites]) => [model, Object.fromEntries(sites)]))])),
 		byTier: Object.fromEntries(fold.byTier),
 		byTool: Object.fromEntries(fold.byTool),
 		bySite: Object.fromEntries(fold.bySite),
@@ -1862,6 +1885,7 @@ function deserializeFold(fold) {
 		byModel: new Map(Object.entries(fold.byModel)),
 		byDay: new Map(Object.entries(fold.byDay)),
 		byDayModels: new Map(Object.entries(fold.byDayModels).map(([day, models]) => [day, new Map(Object.entries(models))])),
+		byDayModelsSite: new Map(Object.entries(fold.byDayModelsSite ?? {}).map(([day, models]) => [day, new Map(Object.entries(models).map(([model, sites]) => [model, new Map(Object.entries(sites))]))])),
 		byTier: new Map(Object.entries(fold.byTier ?? {})),
 		byTool: new Map(Object.entries(fold.byTool ?? {})),
 		bySite: new Map(Object.entries(fold.bySite)),
@@ -1919,6 +1943,20 @@ function modelDayCell(map, day, modelKey) {
 	}
 	return usageCell(models, modelKey);
 }
+/** Get-or-create one day×model×site cell inside the three-dimensional map. */
+function modelDaySiteCell(map, day, modelKey, siteKey) {
+	let models = map.get(day);
+	if (models === void 0) {
+		models = /* @__PURE__ */ new Map();
+		map.set(day, models);
+	}
+	let sites = models.get(modelKey);
+	if (sites === void 0) {
+		sites = /* @__PURE__ */ new Map();
+		models.set(modelKey, sites);
+	}
+	return usageCell(sites, siteKey);
+}
 /** Get-or-create one turn's accumulation state. */
 function turnState(turns, turn) {
 	const existing = turns.get(turn);
@@ -1946,9 +1984,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) {
@@ -1959,6 +1999,7 @@ function foldSession(events, subscriptionProviders, officialProviderIds, routes
 		byModel: /* @__PURE__ */ new Map(),
 		byDay: /* @__PURE__ */ new Map(),
 		byDayModels: /* @__PURE__ */ new Map(),
+		byDayModelsSite: /* @__PURE__ */ new Map(),
 		byTier: /* @__PURE__ */ new Map(),
 		byTool: /* @__PURE__ */ new Map(),
 		bySite: /* @__PURE__ */ new Map(),
@@ -2031,6 +2072,23 @@ 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);
+			const siteKey = siteBucketKey({
+				kind: "direct",
+				provider: "deepseek"
+			});
+			foldSearchCall(fold.total, searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byModel, modelKey), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byDay, day), searchCallEstimateCny);
+			foldSearchCall(modelDayCell(fold.byDayModels, day, modelKey), searchCallEstimateCny);
+			foldSearchCall(modelDaySiteCell(fold.byDayModelsSite, day, modelKey, siteKey), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.bySite, siteKey), searchCallEstimateCny);
+			foldSearchCall(usageCell(fold.byTier, tierAt(event.time)), searchCallEstimateCny);
+			continue;
+		}
 		if (event.type === "assistant/chunk") {
 			const data = event.data;
 			const turn = data.turn;
@@ -2072,6 +2130,7 @@ function foldSession(events, subscriptionProviders, officialProviderIds, routes
 		foldUsage(usageCell(fold.byModel, modelKey), usage, modelKey, subscription, event.time, official);
 		foldUsage(usageCell(fold.byDay, day), usage, modelKey, subscription, event.time, official);
 		foldUsage(modelDayCell(fold.byDayModels, day, modelKey), usage, modelKey, subscription, event.time, official);
+		foldUsage(modelDaySiteCell(fold.byDayModelsSite, day, modelKey, siteBucket), usage, modelKey, subscription, event.time, official);
 		foldUsage(usageCell(fold.bySite, siteBucket), usage, modelKey, subscription, event.time, official);
 		foldUsage(usageCell(fold.byTier, tierAt(event.time)), usage, modelKey, subscription, event.time, official);
 		if (subscription) fold.planCalls.set(modelKey, (fold.planCalls.get(modelKey) ?? 0) + 1);
@@ -2159,6 +2218,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 +2260,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 +2325,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 +2341,7 @@ function createUsageAggregator(persistence, options = {}) {
 						id,
 						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
 						...stamp === null ? {} : { stamp },
-						foldVersion: 2,
+						foldVersion: 4,
 						fold: serializeFold(fold)
 					};
 					const previous = ledger.get(id);
@@ -2304,7 +2365,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) < 4;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -2334,6 +2395,7 @@ function createUsageAggregator(persistence, options = {}) {
 		const byModel = /* @__PURE__ */ new Map();
 		const byDay = /* @__PURE__ */ new Map();
 		const byDayModels = /* @__PURE__ */ new Map();
+		const byDayModelsSite = /* @__PURE__ */ new Map();
 		const byTier = /* @__PURE__ */ new Map();
 		const byTool = /* @__PURE__ */ new Map();
 		const bySite = /* @__PURE__ */ new Map();
@@ -2359,6 +2421,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const [modelKey, cell] of fold.byModel) mergeUsageInto(usageCell(byModel, modelKey), cell);
 			for (const [day, cell] of fold.byDay) mergeUsageInto(usageCell(byDay, day), cell);
 			for (const [day, models] of fold.byDayModels) for (const [modelKey, cell] of models) mergeUsageInto(modelDayCell(byDayModels, day, modelKey), cell);
+			for (const [day, models] of fold.byDayModelsSite) for (const [modelKey, sites] of models) for (const [siteKey, cell] of sites) mergeUsageInto(modelDaySiteCell(byDayModelsSite, day, modelKey, siteKey), cell);
 			for (const [siteKey, cell] of fold.bySite) mergeUsageInto(usageCell(bySite, siteKey), cell);
 			for (const [tierKey, cell] of fold.byTier) mergeUsageInto(usageCell(byTier, tierKey), cell);
 			for (const [toolName, count] of fold.byTool) byTool.set(toolName, (byTool.get(toolName) ?? 0) + count);
@@ -2432,6 +2495,7 @@ function createUsageAggregator(persistence, options = {}) {
 			return record;
 		};
 		const toModelDayRecord = (map) => Object.fromEntries([...map].map(([day, models]) => [day, Object.fromEntries(models)]));
+		const toModelDaySiteRecord = (map) => Object.fromEntries([...map].map(([day, models]) => [day, Object.fromEntries([...models].map(([model, sites]) => [model, Object.fromEntries(sites)]))]));
 		const perf = perfModel.size === 0 ? void 0 : {
 			byModel: Object.fromEntries([...perfModel].map(([model, acc]) => [model, {
 				samples: acc.ttfts.length,
@@ -2459,6 +2523,7 @@ function createUsageAggregator(persistence, options = {}) {
 			byModel: toRecord(byModel),
 			byDay: toRecord(byDay),
 			byDayModels: toModelDayRecord(byDayModels),
+			...byDayModelsSite.size === 0 ? {} : { byDayModelsSite: toModelDaySiteRecord(byDayModelsSite) },
 			bySession: sessionRows.slice(0, 100),
 			byTurn: turnRows.slice(0, 200),
 			byWorkspace: workspaces.slice(0, 100),
@@ -2469,6 +2534,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 +4987,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. */
@@ -152,6 +175,12 @@ export interface UsageStatsDocument {
     byDay: Record<string, ModelUsage>;
     /** 模型 × 日期 二维统计：趋势图按模型堆叠的输入（[date][modelKey]）。 */
     byDayModels: Record<string, Record<string, ModelUsage>>;
+    /**
+     * 模型 × 日期 × 站点 三维统计（[date][modelKey][siteKey]）：供「按 origin 绑定
+     * 自定义价」的显示层重估（issue #16）——只有这个维度能知道「某模型从某中转站
+     * 消耗了多少 token」。旧算法快照缺失。
+     */
+    byDayModelsSite?: Record<string, Record<string, Record<string, ModelUsage>>>;
     /**
      * 峰谷分桶（真实判档）：折叠时逐调用按 `tierAt(event.time)` 归入高峰/低谷桶，
      * 峰谷占比与「挪谷省钱」据此展示，不再按比例估算。旧快照可能缺失。
@@ -182,6 +211,8 @@ export interface UsageStatsDocument {
     byRole?: RoleCost;
     /** 不可计价的模型 id（未收录 / 无价，费用按 0 计）；供面板提示用户自查与反馈。 */
     unpricedModels?: readonly string[];
+    /** 联网搜索请求的单次费用估算（人民币元，配置回显）；0 或缺省 = 未启用估算。 */
+    searchCallEstimateCny?: number;
     /**
      * 性能指标（TTFT / 生成速度 / 总延迟）按模型与按小时聚合；旧快照可能缺失。
      * 口径：TTFT = request/header → 首个内容 chunk；生成速度 = 输出 token ÷ 生成时长；
@@ -310,6 +341,8 @@ export interface SessionFold {
     byModel: Map<string, ModelUsage>;
     byDay: Map<string, ModelUsage>;
     byDayModels: Map<string, Map<string, ModelUsage>>;
+    /** 模型×日期×站点三维（issue #16）：供按 origin 绑定自定义价的显示层重估。 */
+    byDayModelsSite: Map<string, Map<string, Map<string, ModelUsage>>>;
     /** 峰谷分桶：折叠时按调用时刻精确判档（tierAt），键 = 'peak' / 'offPeak'。 */
     byTier: Map<string, ModelUsage>;
     /** 工具调用次数（键 = 工具名；tool-call-delta 首见计数）。 */
@@ -346,6 +379,8 @@ export interface SerializedSessionFold {
     byModel: Record<string, ModelUsage>;
     byDay: Record<string, ModelUsage>;
     byDayModels: Record<string, Record<string, ModelUsage>>;
+    /** 1.0.10（issue #16）新增；模型×日期×站点三维，旧账本行缺失（合并按空处理）。 */
+    byDayModelsSite?: Record<string, Record<string, Record<string, ModelUsage>>>;
     /** 1.0.8 起新增；旧账本行缺失（合并时按空处理，不触发重折算）。 */
     byTier?: Record<string, ModelUsage>;
     byTool?: Record<string, number>;
@@ -381,10 +416,12 @@ 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 起）；v4 = 模型×日期×站点三维桶（issue #16，按 origin
+ * 绑定自定义价的显示层重估）——旧行缺该维度，按无 origin 价处理。
+ * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 2;
+export declare const FOLD_VERSION = 4;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并
@@ -428,6 +465,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 +474,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;
@@ -177,6 +179,16 @@ export interface UsageStats {
         cacheMiss: number;
         cost: number;
     }>>;
+    /** 模型 × 日期 × 站点 三维统计（[date][modelKey][siteKey]）：按 origin 绑定自定义价的
+     *  显示层重估数据源；旧快照可能缺失。 */
+    byDayModelsSite?: Record<string, Record<string, Record<string, {
+        calls: number;
+        input: number;
+        output: number;
+        cacheHit: number;
+        cacheMiss: number;
+        cost: number;
+    }>>>;
     /**
      * 峰谷分桶（全量逐调用真实判档）：1.0.8 起服务端按调用时刻精确归桶，
      * 峰谷占比条优先用它（覆盖全部历史调用）；旧快照缺失时回退逐轮估算。
@@ -227,6 +239,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.userPriceModel' | 'billing.userPriceSource' | 'billing.userPriceSourceHint' | 'billing.userPriceCurrency' | 'billing.userPriceAdd' | 'billing.userPriceRemove' | 'billing.sessionStaleBadge' | 'billing.heatmapLess' | 'billing.heatmapMore' | 'billing.currency' | 'billing.currencyCny' | 'billing.currencyUsd' | 'billing.heatmap' | 'billing.rounds' | 'billing.roundsHint' | 'billing.anomaly' | 'billing.workspaces' | 'billing.workspacesHint' | 'billing.plan' | 'billing.remaining' | 'billing.unknownModel' | 'billing.model' | 'billing.thModel' | 'billing.thInputMiss' | 'billing.thInputHit' | 'billing.currentRound' | 'billing.costAbbr' | 'billing.tabOverview' | 'billing.tabTrends' | 'billing.tabProviders' | 'billing.tabDetails' | 'billing.tabPricing' | 'billing.tabSettings' | 'billing.settingsHead' | 'billing.settingsHint' | 'billing.budgetHint' | 'billing.peakAlertHint' | 'billing.peakAlertDescPeak' | 'billing.peakAlertDescOff' | 'billing.export' | 'billing.exportCsvDay' | 'billing.exportCsvSession' | 'billing.exportJson' | 'billing.peakShare' | 'billing.peakSharePerCall' | 'billing.offPeakSavings' | 'billing.perfMax' | 'billing.weekCost' | 'billing.roleCost' | 'billing.roleUser' | 'billing.roleAssistant' | 'billing.roleTool' | 'billing.roleHint' | 'billing.tierPeak' | 'billing.tierOff' | 'billing.tierToPeak' | 'billing.tierToOff' | 'billing.tierAlertEnterPeak' | 'billing.tierAlertEnterOff' | 'billing.peakAlertTitlePeak' | 'billing.peakAlertTitleOff' | 'billing.peakAlert' | 'billing.peakAlertLeadMin' | 'billing.peakAlertPos' | 'billing.peakAlertMode' | 'billing.peakAlertPosCorner' | 'billing.peakAlertPosCenter' | 'billing.peakAlertModePeak' | 'billing.peakAlertModeOff' | 'billing.peakAlertModeBoth' | 'billing.peakAlertWebNotify' | 'billing.peakAlertPreview' | 'billing.planTypeCode' | 'billing.planTypeToken' | 'billing.subscriptionFeePerMonth' | 'billing.triggerToday' | 'billing.triggerMonth' | 'billing.subscriptionIncluded' | 'billing.free' | 'billing.official' | 'billing.thirdParty' | 'billing.officialCost' | 'billing.thirdPartyCost' | 'billing.perfSamples' | 'billing.perfTtft' | 'billing.perfP50' | 'billing.perfP90' | 'billing.perfTps' | 'billing.perfLatency' | 'billing.perfEstimated' | 'billing.perfEmpty' | 'billing.perfTpsUnit' | 'billing.perfTitle' | 'billing.perfHint' | 'billing.heatmapYear' | 'billing.heatmapMonth' | 'billing.activeDays' | 'billing.streakDays' | 'billing.subscriptionAutoDetect' | 'billing.pluginInfo' | 'billing.pluginName' | 'billing.pluginDescription' | 'billing.pluginVersion' | 'billing.pluginAuthor' | 'billing.pluginRepository' | 'billing.pluginNpm' | 'billing.pluginLicense' | 'billing.tabToken' | 'billing.tokenExport' | 'billing.tokenExportCsv' | 'billing.tokenCacheHitRate' | 'billing.tokenReasoningShare' | 'billing.tokenReasoningShort' | 'billing.tokenIo' | 'billing.tokenPeak' | 'billing.tokenDaily' | 'billing.tokenByModel' | 'billing.tokenMiss' | 'billing.tokenHit' | 'billing.tokenOutput' | 'billing.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/pricing.d.ts

@@ -42,16 +42,29 @@ export interface UserPrice {
     /** 计价币种；缺省 CNY。 */
     currency?: 'CNY' | 'USD';
 }
+/** 一条用户自定义价：绑定「模型（计费目录键）+ 可选来源（中转站 origin）」。
+ *  origin 缺省 = 该模型的默认价；带 origin = 仅该中转站的同名模型用此价。 */
+export interface UserPriceEntry extends UserPrice {
+    /** 计费目录键（如 `flash`、`minimax-m2.7`）。 */
+    key: string;
+    /** 绑定来源（中转站 origin，如 `https://api.my-relay.com`）；缺省 = 默认价。 */
+    origin?: string;
+}
+/**
+ * 注入用户自定义单价列表。每条含模型目录键 + 可选来源（origin）。空数组 = 清除全部
+ * 自定义价，回退内置目录。
+ * @param entries - 用户自定义价条目（列表）。
+ */
+export declare function applyUserPrices(entries: Readonly<UserPriceEntry[]>): void;
+/** 当前生效的用户自定义价条目（设置面板回显用）；未设置时 undefined。 */
+export declare function getUserPrices(): Readonly<UserPriceEntry[]> | undefined;
 /**
- * 注入用户自定义单价。键 = 计费目录键；查询侧用归一化两跳宽松命中。
- * 空对象 = 清除全部自定义价，回退内置目录。
- * @param prices - 目录键 → 自定义单价。
+ * 查一个模型（可选来源）的用户自定义价：优先「模型×来源」精确命中；无来源匹配时
+ * 回落该模型的无来源默认价；再无则 undefined（走内置目录）。
+ * @param key - 计费目录键。
+ * @param origin - 调用来源（中转站 origin）；缺省仅查默认价。
  */
-export declare function applyUserPrices(prices: Readonly<Record<string, UserPrice>>): void;
-/** 当前生效的用户自定义单价（设置面板回显用）；未设置时 undefined。 */
-export declare function getUserPrices(): Readonly<Record<string, UserPrice>> | undefined;
-/** 查一个计费键的用户自定义价（精确键 → 归一化键两跳）。 */
-export declare function userPriceOf(key: string): UserPrice | undefined;
+export declare function userPriceOf(key: string, origin?: string): UserPrice | undefined;
 /**
  * Apply the node half's live pricing snapshot. Absent fields keep the
  * built-in catalog and rate; callers never fabricate values.

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

@@ -6,6 +6,7 @@
  * client 半区在「设置」Tab 渲染开关并写入同一命名空间。缺省的默认行为是关闭——
  * 避免该工具默认占用模型每次请求的上下文（coding 场景通常在仪表盘看用量）。
  */
+import type { UserPriceEntry } from './pricing.ts';
 /** 设置命名空间 id（小写 kebab-case）。 */
 export declare const BILLING_SETTINGS_NAMESPACE = "ui-usage-billing";
 /** 该命名空间下用户可编辑的字段名。 */
@@ -56,22 +57,33 @@ export declare const BILLING_CARD_STORAGE_KEY = "dsh.ui-usage-billing.card";
 export declare function loadBillingCardPrefs(): BillingCardPrefs;
 /** 写入计费卡偏好。失败静默（展示偏好非关键）。 */
 export declare function saveBillingCardPrefs(prefs: BillingCardPrefs): void;
-/** 用户自定义单价（与 client/pricing.ts 的 `UserPrice` 同形；此处不 import 以保持 node 半区无 client 依赖）。 */
-export interface StoredUserPrice {
-    /** 未命中输入单价（元或美元 / 每百万 token）。 */
-    input: number;
-    /** 缓存命中输入单价。 */
-    cacheHit: number;
-    /** 输出单价。 */
-    output: number;
-    /** 计价币种；缺省 CNY。 */
-    currency?: 'CNY' | 'USD';
+/**
+ * 中转站列表（中转站分布 / 中转站额度）的展示偏好（issue #17）。
+ * 纯 client 偏好，存 localStorage（不依赖 node 半区接口/设置 schema）。
+ */
+export interface SiteListPrefs {
+    /** 隐藏「未知路由」（bySite 的 unknown 桶）与「未识别」类型的中转站占位条目；默认隐藏。 */
+    hideUnidentified: boolean;
 }
-/** 自定义价表：计费目录键 → 单价。 */
-export type UserPriceMap = Record<string, StoredUserPrice>;
+/** 默认站点列表偏好：隐藏无参考价值的占位条目，净化账单列表。 */
+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 的 `UserPriceEntry` 同形；type import，无运行时依赖）。 */
+export type StoredUserPrice = UserPriceEntry;
+/** 自定义价表：模型（+可选来源）→ 单价，条目列表（支持同名模型绑定不同中转站 origin）。 */
+export type UserPriceMap = UserPriceEntry[];
 /** localStorage key（与其他 `dsh.ui-usage-billing.*` 偏好同命名空间）。 */
 export declare const USER_PRICES_STORAGE_KEY = "dsh.ui-usage-billing.prices";
-/** 读取用户自定义价（写入侧已校验，这里只挡住手工改坏的非数字行）。仅在浏览器半区调用。 */
+/**
+ * 读取用户自定义价（写入侧已校验，这里挡住手工改坏的非数字行 与 旧版单行对象格式）。
+ * 旧版（1.0.9 及更早）存的是 `Record<目录键, {input,cacheHit,output,currency?}>`，
+ * 迁移为「条目列表」（origin 缺省 = 该模型默认价）。仅在浏览器半区调用。
+ */
 export declare function loadUserPrices(): UserPriceMap;
 /** 写入用户自定义价。失败静默（展示偏好非关键）。 */
 export declare function saveUserPrices(prices: UserPriceMap): void;

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.10",
   "publishConfig": {
     "access": "public"
   },