@kenz1117/dsh-ui-usage-billing 1.4.30 → 1.4.32

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

@@ -3410,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）：日志完好，仅本构建读不了。
@@ -3446,10 +3453,21 @@ 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;
 	/** 惰性失效（价目表时序）：账本/缓存行若以「当时不可计价」的模型落盘，
 	*  而价目表现在能计价了，该行必须重折——否则显示层按实时价算出的
@@ -3467,7 +3485,7 @@ function createUsageAggregator(persistence, options = {}) {
 			id,
 			...cwd === void 0 ? {} : { cwd },
 			...stamp === null ? {} : { stamp },
-			foldVersion: 21,
+			foldVersion: 22,
 			fingerprint: foldFingerprint,
 			fold: serializeFold(fold)
 		};
@@ -3531,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();
@@ -3562,7 +3581,7 @@ function createUsageAggregator(persistence, options = {}) {
 			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) === 21 && ledgerRow.fingerprint === foldFingerprint && !foldNeedsReprice(ledgerRow.fold)) {
+				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,
@@ -3573,7 +3592,7 @@ function createUsageAggregator(persistence, options = {}) {
 					continue;
 				}
 				const hit = cache.get(id);
-				if (hit !== void 0 && stamp !== null && hit.stamp === stamp && ![...hit.fold.unpricedModels].some((key) => isPriced(key))) {
+				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({
@@ -3585,7 +3604,7 @@ function createUsageAggregator(persistence, options = {}) {
 					continue;
 				}
 				const previous = cache.get(id);
-				if (previous?.machine !== void 0 && previous.lastSeq !== void 0 && ![...previous.fold.unpricedModels].some((key) => isPriced(key))) {
+				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);
@@ -3630,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,
@@ -3662,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) < 21 || entry.fingerprint !== foldFingerprint;
+					const stale = (entry.foldVersion ?? 1) < 22 || entry.fingerprint !== foldFingerprint;
 					folds.push({
 						id: entry.id,
 						...entry.cwd === void 0 ? {} : { cwd: entry.cwd },
@@ -7218,10 +7238,26 @@ function apply(ctx, config = {}) {
 	const workspaceTitleResolver = buildWorkspaceTitleResolver(ctx);
 	applyBuiltinCatalog(BUILTIN_MODEL_CATALOG, BUILTIN_MODEL_KEY_ALIASES);
 	applyUserModelAliases(config.modelKeyAliases);
+	let llmRegistryWarned = false;
+	const registeredProvidersOf = () => {
+		try {
+			const providers = (ctx.get?.("llm"))?.listProviders() ?? [];
+			llmRegistryWarned = false;
+			return new Set(providers.map((provider) => provider.id));
+		} catch (error) {
+			if (!llmRegistryWarned) {
+				llmRegistryWarned = true;
+				console.warn("[usage-billing] llm registry unavailable; plugin-registered adapter channels stay unknown (issue #91):", error);
+			}
+			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

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