@kenz1117/dsh-ui-usage-billing 1.4.29 → 1.4.31

package/README.md

@@ -264,7 +264,7 @@ npm publish --access public
 ## ⚠️ Known Limitations and Deferred Work
 
 - **余额查询已接入 DeepSeek / 月之暗面（Kimi）/ 阶跃星辰（StepFun）/ 硅基流动 / xAI / 智谱 GLM（Z.ai 国内域）/ 腾讯云 TokenHub（Token Plan 余量）**：前六家用标准 Bearer API key，腾讯云用云 API 密钥对（TC3 签名）。其余厂商因无公开余额接口或需非 Bearer 鉴权（小米 MiMo 走控制台 Cookie、商汤走 AccessKey 签名、MiniMax/字节豆包走额度制或 AK/SK），暂显示「未配置」；扩展点在 `src/balance.ts`（按厂商余额 API 增加查询器）。
-- **中转站额度依赖上游私有 schema**：New API / Sub2API 的接口字段未公开，读不出时标「未读出额度」而非臆造金额；若某中转站响应字段不同，需按 `src/relay.ts` 的解析器扩展。未知路由表示该路由在当前 provider 配置里已不存在（改过名 / 删除过），历史调用数据未丢，重新配置同名路由即可自动归位。未知路由桶的费用一律记 0（issue #82）：支出主体无法核实，与未收录模型、订阅通道同姿态——token 照常统计，面板组头费用显示「—」并附说明。
+- **中转站额度依赖上游私有 schema**：New API / Sub2API 的接口字段未公开，读不出时标「未读出额度」而非臆造金额；若某中转站响应字段不同，需按 `src/relay.ts` 的解析器扩展。未知路由表示该路由在当前 provider 配置与宿主 llm 注册表里都不存在（配置已删、日志比安装更早等），历史调用数据未丢，重新配置同名路由即可自动归位。未知路由桶的费用一律记 0（issue #82）：支出主体无法核实，与未收录模型、订阅通道同姿态——token 照常统计，面板组头费用显示「—」并附说明。由独立插件经 `ctx.llm.registerAdapter` 注册的通道（如 CommandCode）不属于未知路由：插件从宿主 llm 注册表发现它们，按 `direct:<provider>` 桶以模型官方目录价计费（issue #91）。
 - **超支通知依赖浏览器 Notification**：权限被拒绝或平台不支持时只有界面红色脉冲兜底，没有宿主级通知通道；通知上限为每天一次。
 - **会话明细不可跳转**：点击会话行不会打开对应会话（跨插件导航需要宿主会话选择通道）；会话数封顶 100 行、面板只显示前 20 行。
 - **费用为目录价估算**：讯飞 / 商汤 / 小米等未公布按量单价的模型使用估算价（特性表脚注 ¹），正式定价以厂商账单为准。

package/lib/index.js

@@ -2301,6 +2301,9 @@ const BUILTIN_MODEL_KEY_ALIASES = {
 	"deepseek-v4.1-flash": "flash",
 	"deepseek-v4.1-flash-expires-on-0910": "flash",
 	"deepseek-flash": "flash",
+	"deepseek/deepseek-v4.1-flash": "flash",
+	"deepseek/deepseek-flash": "flash",
+	"deepseek/deepseek-v4-pro": "pro",
 	"deepseek-v4-pro": "pro",
 	"glm-5.2": "glm",
 	"glm-4.5-air": "glm-4.5-air",
@@ -2491,6 +2494,29 @@ const DEFAULT_SUBSCRIPTION_PROVIDERS = [
 function isOfficialProvider(provider) {
 	return /^deepseek(?:-[a-z0-9-]+)?$/i.test(provider.trim());
 }
+/**
+* 已知的「第三方插件注册 adapter」通道名单：这些 provider 由别的插件经
+* `ctx.llm.registerAdapter` 注册，**不经 llm-pi-ai 路由表**，因此
+* {@link siteRefOf} 的路由查询必然 miss。与订阅豁免（issue #37 的 grok
+* build）同构：显式列出、不做「猜通道」的通用发现——猜错会把来源不明的
+* 路由也归位成可计价通道，违背 issue #82「支出主体无法核实不计价」的初衷。
+*
+* 收录语义：这些通道的支出主体是可核实的（WorkBuddy = 腾讯 WorkBuddy
+* 桌面 App 账号），计费用模型官方目录价折算 Token 成本，与积分制解耦。
+* 它们**不是** DeepSeek 官方渠道——{@link isOfficialProvider} 与
+* {@link officialChannelOf} 都不会因本名单把调用算进官方口径。
+*/
+const KNOWN_ADAPTER_PROVIDERS = /* @__PURE__ */ new Set(["workbuddy", "workbuddy-ai"]);
+/**
+* 一个 provider 是否命中已知 adapter 通道名单。判定与 {@link isOfficialProvider}
+* 同姿态：trim + 大小写不敏感——dsh-workbuddy-connect 注册的是小写 id
+*（`workbuddy` / `workbuddy-ai`），宿主不强制 route 小写，按大小写归一化可避免
+* 日志里出现大小写变体时静默落回 unknown 桶。路由表命中仍优先于本名单
+*（见 {@link siteRefOf}），用户自配的大小写变体走配置路径。
+*/
+function isKnownAdapterProvider(provider) {
+	return KNOWN_ADAPTER_PROVIDERS.has(provider.trim().toLowerCase());
+}
 /** DeepSeek 官方直连端点的归一化 origin（`siteOriginOf` 口径）：有 baseURL 的路由只有它算官方。 */
 const OFFICIAL_DEEPSEEK_ORIGIN = "https://api.deepseek.com";
 /**
@@ -2527,8 +2553,10 @@ function siteOriginOf(baseURL) {
 *   网关）按 `direct` 归位——unknown 一刀切会把官方直连的费用堆进「未知路由」组、
 *   且不算官方渠道（回归修复）；订阅豁免命中的通道（显式 `subscriptionProviders`
 *   配置或判定函数）同样按 `direct` 归位——订阅管理类插件注册的通道不经路由表，
-*   unknown 桶既掩盖归属又按 token 误计费（issue #37 的 grok build）；其余配置外
-*   名称保留 unknown（无法核实通道）。
+*   unknown 桶既掩盖归属又按 token 误计费（issue #37 的 grok build）；已知的第三方
+*   插件注册 adapter 通道（{@link KNOWN_ADAPTER_PROVIDERS}，如 workbuddy）同样按
+*   `direct` 归位——支出主体可核实、按模型官方目录价计 Token 成本，unknown 桶会让
+*   费用恒为 0；其余配置外名称保留 unknown（无法核实通道）。
 * @param provider - 会话日志里的 provider 路由名（request/header 的 `config.provider`）。
 * @param routes - 当前 provider 路由视图（来自 llm-pi-ai providers）。
 * @param opts - `subscription`：该调用是否已被订阅豁免判定命中。
@@ -2554,6 +2582,10 @@ function siteRefOf(provider, routes, opts = {}) {
 		kind: "direct",
 		provider
 	};
+	if (isKnownAdapterProvider(provider)) return {
+		kind: "direct",
+		provider
+	};
 	return {
 		kind: "unknown",
 		provider
@@ -3378,12 +3410,19 @@ function hourPerfOf(digest) {
 * 订阅豁免），历史账本行立即失效并全量重折，配置变更即时生效（issue #37）。
 * 判定函数无法序列化，统一记为 `fn`（任何函数形态互视为同一指纹）。
 */
-function configFingerprint(subscriptionMatcher, officialProviderIds, routeAliases, searchEstimate) {
+function configFingerprint(subscriptionMatcher, officialProviderIds, routeAliases, searchEstimate, modelKeyAliases = {}, registeredProviders = /* @__PURE__ */ new Set()) {
+	const subs = typeof subscriptionMatcher === "function" ? "fn" : [...subscriptionMatcher].sort().join(",");
+	const officials = officialProviderIds === void 0 ? "" : [...officialProviderIds].sort().join(",");
+	const aliases = Object.keys(routeAliases).sort().map((key) => `${key}=${routeAliases[key]}`).join(",");
+	const modelKeys = Object.keys(modelKeyAliases).sort().map((key) => `${key}=${modelKeyAliases[key]}`).join(",");
+	const registered = [...registeredProviders].sort().join(",");
 	return [
-		typeof subscriptionMatcher === "function" ? "fn" : [...subscriptionMatcher].sort().join(","),
-		officialProviderIds === void 0 ? "" : [...officialProviderIds].sort().join(","),
-		Object.keys(routeAliases).sort().map((key) => `${key}=${routeAliases[key]}`).join(","),
-		String(searchEstimate)
+		subs,
+		officials,
+		aliases,
+		String(searchEstimate),
+		modelKeys,
+		registered
 	].join("|");
 }
 /** 会话格式拒读（宿主 SessionFormatUnsupportedError）：日志完好，仅本构建读不了。
@@ -3414,11 +3453,31 @@ function createUsageAggregator(persistence, options = {}) {
 	let ledgerAppliedMigrations;
 	let lastDoc;
 	let lastAt = 0;
-	/** 每次聚合取最新的 provider 路由视图（中转站零配置发现）；缺省按空处理（全部未知路由）。 */
-	const routesOf = () => options.resolveRoutes?.() ?? {};
+	/** 每次聚合取最新的 provider 路由视图（中转站零配置发现）；缺省按空处理（全部未知路由）。
+	*  叠加已注册 adapter 的通道（issue #91）：宿主 llm 注册表里的 provider 合成无 baseURL
+	*  的空路由视图——siteRefOf 的路由命中分支正是「无 origin 直连」的语义，归位
+	*  `direct:<provider>` 按官方目录价计费；llm-pi-ai 已有配置的路由优先（其 origin 可还原）。 */
+	const routesOf = () => {
+		const routes = { ...options.resolveRoutes?.() };
+		const registered = options.resolveRegisteredProviders?.();
+		if (registered !== void 0) {
+			for (const provider of registered) if (routes[provider] === void 0) routes[provider] = {};
+		}
+		return routes;
+	};
 	const searchEstimate = options.searchCallEstimateCny ?? .02;
-	const foldFingerprint = configFingerprint(subscriptionMatcher, officialProviderIds, routeAliases, searchEstimate);
+	const foldFingerprintOf = () => configFingerprint(subscriptionMatcher, officialProviderIds, routeAliases, searchEstimate, options.modelKeyAliases, options.resolveRegisteredProviders?.() ?? /* @__PURE__ */ new Set());
+	let foldFingerprint = foldFingerprintOf();
 	const FOLD_CHUNK_EVENTS = 8e3;
+	/** 惰性失效（价目表时序）：账本/缓存行若以「当时不可计价」的模型落盘，
+	*  而价目表现在能计价了，该行必须重折——否则显示层按实时价算出的
+	*  「目录价预估」与服务端 cost=0 并存，出现「明细比总额高」的双口径
+	*  （真机复现：预热折叠早于 models.dev 价目表注入，step-5-preview
+	*  折叠时刻 cost=0、渲染时刻 ≈¥38）。复用判定据此刻检查：不走配置指纹
+	*  （价目表不进指纹，否则 6h 一次的价格刷新会让全部历史行全量重折），
+	*  也不 bump FOLD_VERSION（那是归账语义版本，价目表时序不是语义变更）。
+	*  价目表变化后未受影响行（无 unpriced 模型）依旧零读取复用。 */
+	const foldNeedsReprice = (fold) => fold.unpricedModels.some((key) => isPriced(key));
 	/** 把一份（全量或增量）折叠结果登记进 durable ledger；内容无变化时不落盘。 */
 	const recordLedger = (id, cwd, stamp, fold) => {
 		if (options.ledger === void 0) return;
@@ -3426,12 +3485,12 @@ function createUsageAggregator(persistence, options = {}) {
 			id,
 			...cwd === void 0 ? {} : { cwd },
 			...stamp === null ? {} : { stamp },
-			foldVersion: 20,
+			foldVersion: 22,
 			fingerprint: foldFingerprint,
 			fold: serializeFold(fold)
 		};
 		const row = ledger.get(id);
-		if (row === void 0 || row.stamp !== entry.stamp || row.cwd !== entry.cwd || row.foldVersion !== entry.foldVersion || row.fingerprint !== entry.fingerprint || stamp === null && JSON.stringify(row.fold) !== JSON.stringify(entry.fold)) {
+		if (row === void 0 || row.stamp !== entry.stamp || row.cwd !== entry.cwd || row.foldVersion !== entry.foldVersion || row.fingerprint !== entry.fingerprint || stamp === null && JSON.stringify(row.fold) !== JSON.stringify(entry.fold) || stamp !== null && foldNeedsReprice(row.fold)) {
 			ledger.set(id, entry);
 			ledgerNeedsSave = true;
 		}
@@ -3490,6 +3549,7 @@ function createUsageAggregator(persistence, options = {}) {
 	const aggregateOnce = async () => {
 		const now = Date.now();
 		await ensureLedgerLoaded();
+		foldFingerprint = foldFingerprintOf();
 		let metas;
 		try {
 			metas = await persistence.list();
@@ -3518,22 +3578,10 @@ function createUsageAggregator(persistence, options = {}) {
 				if (!ledger.has(id)) noLedgerUnreadable += 1;
 				continue;
 			}
-			const hit = cache.get(id);
-			if (hit !== void 0 && stamp !== null && hit.stamp === stamp) {
-				cache.delete(id);
-				cache.set(id, hit);
-				folds.push({
-					id,
-					...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
-					fold: hit.fold
-				});
-				included.add(id);
-				continue;
-			}
 			try {
 				const cwd = meta.cwd;
 				const ledgerRow = ledger.get(id);
-				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 20 && ledgerRow.fingerprint === foldFingerprint) {
+				if (ledgerRow !== void 0 && ledgerRow.stamp !== void 0 && stamp !== null && ledgerRow.stamp === stamp && (ledgerRow.foldVersion ?? 1) === 22 && ledgerRow.fingerprint === foldFingerprint && !foldNeedsReprice(ledgerRow.fold)) {
 					const fold = deserializeFold(ledgerRow.fold);
 					folds.push({
 						id,
@@ -3543,8 +3591,20 @@ function createUsageAggregator(persistence, options = {}) {
 					included.add(id);
 					continue;
 				}
+				const hit = cache.get(id);
+				if (hit !== void 0 && stamp !== null && hit.stamp === stamp && hit.fingerprint === foldFingerprint && ![...hit.fold.unpricedModels].some((key) => isPriced(key))) {
+					cache.delete(id);
+					cache.set(id, hit);
+					folds.push({
+						id,
+						...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
+						fold: hit.fold
+					});
+					included.add(id);
+					continue;
+				}
 				const previous = cache.get(id);
-				if (previous?.machine !== void 0 && previous.lastSeq !== void 0) {
+				if (previous?.machine !== void 0 && previous.lastSeq !== void 0 && previous.fingerprint === foldFingerprint && ![...previous.fold.unpricedModels].some((key) => isPriced(key))) {
 					const from = previous.lastSeq + 1;
 					const { events, inheritedEventCount } = await persistence.readFrom(meta.id, sessionLogOffsetOf(from));
 					const after = await stampOf(meta);
@@ -3589,7 +3649,8 @@ function createUsageAggregator(persistence, options = {}) {
 					stamp,
 					fold,
 					machine,
-					...last !== void 0 && typeof last.seq === "number" ? { lastSeq: last.seq } : {}
+					...last !== void 0 && typeof last.seq === "number" ? { lastSeq: last.seq } : {},
+					fingerprint: foldFingerprint
 				});
 				folds.push({
 					id,
@@ -3621,7 +3682,7 @@ function createUsageAggregator(persistence, options = {}) {
 			for (const entry of ledger.values()) {
 				if (included.has(entry.id)) continue;
 				try {
-					const stale = (entry.foldVersion ?? 1) < 20 || entry.fingerprint !== foldFingerprint;
+					const stale = (entry.foldVersion ?? 1) < 22 || entry.fingerprint !== foldFingerprint;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -7177,10 +7238,19 @@ function apply(ctx, config = {}) {
 	const workspaceTitleResolver = buildWorkspaceTitleResolver(ctx);
 	applyBuiltinCatalog(BUILTIN_MODEL_CATALOG, BUILTIN_MODEL_KEY_ALIASES);
 	applyUserModelAliases(config.modelKeyAliases);
+	const registeredProvidersOf = () => {
+		try {
+			return new Set(ctx.llm.listProviders().map((provider) => provider.id));
+		} catch {
+			return /* @__PURE__ */ new Set();
+		}
+	};
 	const aggregator = createUsageAggregator(adaptSessionPersistence(ctx.sessionPersistence), {
 		...config.subscriptionProviders === void 0 ? {} : { subscriptionProviders: config.subscriptionProviders },
 		...config.routeAliases === void 0 ? {} : { routeAliases: config.routeAliases },
 		resolveRoutes: () => readPiAiProviderRoutes(ctx.settings),
+		resolveRegisteredProviders: registeredProvidersOf,
+		...config.modelKeyAliases === void 0 ? {} : { modelKeyAliases: config.modelKeyAliases },
 		...workspaceTitleResolver === void 0 ? {} : { resolveWorkspaceTitle: workspaceTitleResolver },
 		...config.searchCallEstimateCny === void 0 ? {} : { searchCallEstimateCny: config.searchCallEstimateCny },
 		ledger: ledgerStore
@@ -7456,11 +7526,25 @@ function apply(ctx, config = {}) {
 	});
 	let live = { source: "builtin" };
 	let pricingSyncedAt = 0;
+	/** 价目表代际：extraModels 的 key 集合稳定序列化。fetchLivePricing 每次都重建
+	*  数组（引用必不同），引用比较恒真会退化成「每次刷新都跑一轮 reprice」；
+	*  key 集合变化才代表真的出现了「此前未收录、现在可计价」的模型。 */
+	const priceGenerationOf = (snapshot) => (snapshot.extraModels ?? []).map((model) => model.key).sort().join(",");
+	let priceGeneration = priceGenerationOf(live);
 	const refreshPricing = async () => {
 		live = await fetchLivePricing();
 		pricingSyncedAt = Date.now();
 		applyLivePricing(live);
 		pricingBodyCache = void 0;
+		const nextGeneration = priceGenerationOf(live);
+		if (nextGeneration !== priceGeneration) {
+			priceGeneration = nextGeneration;
+			aggregator.aggregate().then(() => {
+				console.info("[usage-billing] repriced folds after pricing refresh; ledger aligned with live catalog");
+			}).catch((error) => {
+				console.warn("[usage-billing] reprice fold after pricing refresh failed; next aggregate retries:", error);
+			});
+		}
 	};
 	let pricingBodyCache;
 	const pricingBody = () => {

package/lib/types/aggregate.d.ts

@@ -140,12 +140,20 @@ export interface AggregateOptions {
      * 官方判定都用别名后的路由名）。
      */
     routeAliases?: Readonly<Record<string, string>>;
+    /** 折叠时模型 id → 目录键的用户自定义别名（与 pricing 模块注入的同源）：仅用于
+     *  折叠指纹——别名改动必须让历史行失效重折，否则 byModel 新旧 key 并存（issue #91 P2）。 */
+    modelKeyAliases?: Readonly<Record<string, string>>;
     /** 每会话折叠缓存的上限（默认 {@link DEFAULT_MAX_CACHE_SESSIONS}）；
      *  超限时按最近使用先后淘汰最久未用的会话，防长期运行内存膨胀。 */
     maxCacheSessions?: number;
     /** 中转站归组来源：返回当前 provider 路由视图（llm-pi-ai providers 的 baseURL）。
      *  每次聚合时调用取最新值；缺省时全部路由按「未知路由」处理（无配置发现）。 */
     resolveRoutes?: () => Readonly<Record<string, ProviderRouteView>>;
+    /** 已注册 adapter 的 provider 集合（宿主 llm 注册表，llm-pi-ai 之外的插件路由，
+     *  issue #91）：每次聚合时调用取最新值。这些通道宿主只会把请求发给已注册的
+     *  adapter，身份可核实——合成无 baseURL 的路由视图归位 `direct:<provider>` 按
+     *  官方目录价计费，不再落「未知路由」记 0；缺省时保持 unknown 口径。 */
+    resolveRegisteredProviders?: () => ReadonlySet<string>;
     /** 工作区标题解析：给定会话 cwd 返回项目显示标题；undefined = 回退到 cwd 末级目录名
      *  （host 的 workspaceRegistry 为可选依赖，缺失时不注入，行为保持不变）。 */
     resolveWorkspaceTitle?: (cwd: string) => string | undefined;
@@ -591,7 +599,7 @@ export interface UsageLedgerDocument {
  * 会话费用只剩最近一段，issue #29）。
  * 持久账本行据此区分新旧算法：日志已删/不可读而只能沿用旧行时，UI 标注置信度提示。
  */
-export declare const FOLD_VERSION = 21;
+export declare const FOLD_VERSION = 22;
 /**
  * 一次性账本迁移：id 唯一，apply 在加载边界对原始文档执行，已应用过的跳过。
  * 未来账本/schema 字段变更（重命名、拆桶、语义调整）时，在此追加一条迁移并
@@ -687,7 +695,7 @@ export interface SessionUsageSummary {
  * 订阅豁免），历史账本行立即失效并全量重折，配置变更即时生效（issue #37）。
  * 判定函数无法序列化，统一记为 `fn`（任何函数形态互视为同一指纹）。
  */
-export declare function configFingerprint(subscriptionMatcher: SubscriptionMatcher, officialProviderIds: ReadonlySet<string> | undefined, routeAliases: Readonly<Record<string, string>>, searchEstimate: number): string;
+export declare function configFingerprint(subscriptionMatcher: SubscriptionMatcher, officialProviderIds: ReadonlySet<string> | undefined, routeAliases: Readonly<Record<string, string>>, searchEstimate: number, modelKeyAliases?: Readonly<Record<string, string>>, registeredProviders?: ReadonlySet<string>): string;
 /**
  * Create the incremental usage aggregator.
  * @param persistence - the session persistence service.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.4.29",
+  "version": "1.4.31",
   "keywords": [
     "deepseek-harness",
     "deepseek",