@kenz1117/dsh-ui-usage-billing 1.4.3 → 1.4.5

package/lib/types/aggregate.d.ts

@@ -13,8 +13,9 @@
 import { SessionLogOffset } from '@deepseek-ai/dsh-session/types';
 import type { SessionEvent, SessionHeader, SessionId } from '@deepseek-ai/dsh-session/types';
 import type { TokenUsage } from '@deepseek-ai/dsh-llm';
-import { MODEL_KEY_ALIASES, resolveCatalogKey } from './client/pricing.ts';
-export { MODEL_KEY_ALIASES, resolveCatalogKey };
+import { resolveCatalogKey } from './client/pricing.ts';
+import { BUILTIN_MODEL_KEY_ALIASES } from './builtin-catalog.ts';
+export { BUILTIN_MODEL_KEY_ALIASES, resolveCatalogKey };
 /**
  * 走订阅套餐（coding / token plan / opencode 订阅）的 provider id：这些通道的
  * 调用按套餐计费，不再按 token 计费，因此即使模型 id 与计费表撞名也一律豁免。

package/lib/types/builtin-catalog.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 内置价格目录与别名表的纯数据模块：只随 node 半构建发布（宿主聚合计价使用），
+ * 并经 /api/billing/pricing 下发给客户端注入——client bundle 不携带这份数据
+ * （瘦身：lib/client.js 约 -30 KiB）。条目结构与消费逻辑见 ./client/pricing.ts。
+ */
+import type { ModelEntry } from './client/pricing.ts';
+export declare const BUILTIN_MODEL_CATALOG: readonly ModelEntry[];
+/**
+ * 真实 provider model id → 计费目录键（`MODEL_CATALOG[].key`）的映射。未知 id
+ * 原样保留并落回 `other`（未知模型不估算费用）。聚合层（aggregate.ts）在折叠时
+ * 用同一张表把日志里的 model id 归并为目录键，客户端渲染（`modelOf`）也按它
+ * 解析，两侧共用一份映射，避免同一模型两侧不一致导致「未收录」。
+ */
+export declare const BUILTIN_MODEL_KEY_ALIASES: Readonly<Record<string, string>>;
+//# sourceMappingURL=builtin-catalog.d.ts.map

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

@@ -40,10 +40,11 @@ export type TrendMetric = 'cost' | 'tokens';
  * @param props.currency - display currency for the cost labels.
  * @param props.metric - `cost` (stacked per-model CNY, default) or `tokens` (single-color total tokens).
  */
-export declare function TrendChart({ data, models, currency, metric }: {
+export declare function TrendChart({ data, models, currency, metric, t }: {
     data: readonly TrendPoint[];
     models?: readonly TrendSeriesModel[];
     currency?: CostCurrency;
     metric?: TrendMetric;
+    t?: (key: 'trendEmpty' | 'trendTotal' | 'calls') => string;
 }): React.ReactNode;
 //# sourceMappingURL=TrendChart.d.ts.map

package/lib/types/client/band-dot.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 峰谷指示点状态（issue #65 / dots）：把 `channelCountdown` 的结果映射成三种
+ * 展示状态。纯函数，便于无 DOM 单测；无峰谷的模型返回 null —— 不渲染任何东西，
+ * 绝不为「没有档位」的模型臆造一个状态。
+ */
+import type { PriceTierId } from './pricing.ts';
+/** 指示点状态：低谷 / 即将切换 / 高峰。 */
+export type BandState = 'offPeak' | 'soon' | 'peak';
+/**
+ * 由倒计时推导指示点状态。
+ * @param band - `channelCountdown` 的返回值；null/undefined = 该模型无峰谷。
+ * @param leadMs - 「即将切换」的提前量（复用峰谷提醒的 `leadMin`）。
+ * @returns 展示状态；无峰谷时为 null。
+ */
+export declare function bandStateOf(band: {
+    tier: PriceTierId;
+    nextSwitchInMs: number;
+} | null | undefined, leadMs: number): BandState | null;
+//# sourceMappingURL=band-dot.d.ts.map

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

@@ -20,18 +20,24 @@ export interface HeatmapDay {
     value: number;
 }
 /**
- * Render the month or year heatmap.
- * @param props.days - daily cost rows (keys are `YYYY-MM-DD`).
- * @param props.currency - display currency for the hover amount.
+ * Render the month or week-column heatmap.
+ * @param props.days - daily value rows (keys are `YYYY-MM-DD`); the value's
+ *   meaning follows `props.unit` (CNY cost or raw token count).
+ * @param props.currency - display currency for the hover amount (cost unit).
  * @param props.now - anchor date (defaults to today); injectable for tests.
  * @param props.t - locale function (used for the legend labels).
- * @param props.range - `month` (calendar month) or `year` (last 52 weeks, GitHub style).
+ * @param props.range - `month` (calendar month), `half` (last 26 weeks, large
+ *   cells — the screenshot-friendly Codex-style view) or `year` (last 52
+ *   weeks, GitHub style).
+ * @param props.unit - value metric: `cost` (default, money formatting) or
+ *   `tokens` (compact token formatting).
  */
-export declare function UsageHeatmap({ days, currency, now, t, range }: {
+export declare function UsageHeatmap({ days, currency, now, t, range, unit }: {
     days: readonly HeatmapDay[];
     currency: CostCurrency;
     now?: Date;
-    range?: 'month' | 'year';
+    range?: 'month' | 'half' | 'year';
+    unit?: 'cost' | 'tokens';
     t: (key: 'costAbbr' | 'noData' | 'heatmapLess' | 'heatmapMore') => string;
 }): React.ReactNode;
 //# sourceMappingURL=heatmap.d.ts.map

package/lib/types/client/label-display.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 费率表附加行文案本地化：目录条目里的 `extraRows` `label`/`note`（`显式缓存创建`、
+ * `长期半价` 等）是数据层的中文字面量，同时充当渲染 key。与 provider-display.ts
+ * 同样的做法：不改动数据层形态，只在渲染层提供一张「中文文案 → 英文文案」映射，
+ * 未收录的字符串原样返回。集中一处便于统一管理与将来扩展第三语言。
+ */
+type LabelLang = 'zh' | 'en';
+/**
+ * 把费率表附加行的 label/note 按界面语言本地化：中文映射成英文，其余原样返回。
+ * 仅在渲染层调用，不影响数据层的中文字面量与 key 匹配。
+ * @param text - 数据层原始文案（可能为 undefined，例如没有 note 的行）。
+ * @param lang - 当前界面语言。
+ * @returns 本地化后的文案；`undefined` 原样传回。
+ */
+export declare function localizeRowLabel(text: string, lang: LabelLang): string;
+export declare function localizeRowLabel(text: undefined, lang: LabelLang): undefined;
+export declare function localizeRowLabel(text: string | undefined, lang: LabelLang): string | undefined;
+export {};
+//# sourceMappingURL=label-display.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' | 'liveTurn' | 'liveSession' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'trendEmpty' | 'budget' | 'budgetRemain' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'directTag' | 'relayTag' | 'unknownTag' | 'planCountUnit' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | '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' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'peakAlertDescPeakZhipu' | 'peakAlertDescOffZhipu' | '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' | 'free' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapMonth' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | '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';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'liveTurn' | 'liveSession' | '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' | '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' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'staleLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | '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' | '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' | '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' | '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';
 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

@@ -26,6 +26,8 @@ import type { LivePricing } from '../pricing-shared.ts';
  * live rate arrives the built-in value stays in force.
  */
 export declare const USD_TO_CNY = 6.79;
+/** 内置 EUR→CNY 汇率（实时汇率不可用时的兑底，与 USD_TO_CNY 同口径）。 */
+export declare const EUR_TO_CNY = 7.71;
 /**
  * 注入用户自定义模型别名（node 半区在插件启动时调用一次）。纯内存状态：
  * 聚合折叠与客户端渲染共用同一份（两侧一致性由同一注入点保证）。
@@ -137,6 +139,11 @@ export declare function getRateInfo(): {
     rate: number;
     live: boolean;
 };
+/** 欧元汇率与其是否为实时值（与 {@link getRateInfo} 同形）。 */
+export declare function getEurRateInfo(): {
+    rate: number;
+    live: boolean;
+};
 /** Default share of traffic assumed to fall in the peak band (0..1). */
 export declare const DEFAULT_PEAK_SHARE = 0.5;
 /**
@@ -165,7 +172,7 @@ export declare const FLASH_REPRICE_MS: number;
 /** 计费时段档位：高峰 / 空闲（官方 DeepSeek 刊例价：高峰 = 空闲 × 2）。 */
 export type PriceTierId = 'peak' | 'offPeak';
 /** 成本显示币种：人民币（国内模型直价）/ 美元（国外模型直价或换算显示）。 */
-export type CostCurrency = 'cny' | 'usd';
+export type CostCurrency = 'cny' | 'usd' | 'eur';
 /**
  * 工作日高峰时段判定（北京时间，UTC+8，无夏令时）：09:00–12:00、14:00–18:00。
  * 周末（周六/周日）北京全天为低谷，不调用本函数判定峰/平。
@@ -341,14 +348,17 @@ export interface ModelEntry {
      */
     retired?: boolean;
 }
-export declare const MODEL_CATALOG: readonly ModelEntry[];
 /**
- * 真实 provider model id → 计费目录键（`MODEL_CATALOG[].key`）的映射。未知 id
- * 原样保留并落回 `other`（未知模型不估算费用）。聚合层（aggregate.ts）在折叠时
- * 用同一张表把日志里的 model id 归并为目录键，客户端渲染（`modelOf`）也按它
- * 解析，两侧共用一份映射，避免同一模型两侧不一致导致「未收录」。
+ * 注入内置目录与别名表（两侧各调用一次：宿主 activate、客户端首个 pricing 响应）。
+ * 重复注入整体替换并重建归一化索引。
+ * @param catalog - 内置目录条目（BUILTIN_MODEL_CATALOG 全量）。
+ * @param aliases - 内置别名表（BUILTIN_MODEL_KEY_ALIASES 全量）。
  */
-export declare const MODEL_KEY_ALIASES: Readonly<Record<string, string>>;
+export declare function applyBuiltinCatalog(catalog: readonly ModelEntry[], aliases: Readonly<Record<string, string>>): void;
+/** 内置目录当前快照：未注入为空数组（client 首帧前渲染加载态）。 */
+export declare function modelCatalog(): readonly ModelEntry[];
+/** 内置别名表当前快照：未注入为空对象。 */
+export declare function modelKeyAliases(): Readonly<Record<string, string>>;
 /**
  * 模型 id 归一化：小写、去括号附注（如 `gpt5.6 luna(go)` 只看主体）、再去所有
  * 非字母数字分隔符（空格 / 横杠 / 点 / 下划线）。用于日志里的模型 id 与计费
@@ -433,6 +443,14 @@ export declare function computeCostAt(entry: ModelEntry, buckets: TokenUsageBuck
 /** 人民币 → 美元（显示换算用）：用当前生效汇率（实时优先，缺失回退内置），
  *  与计价链路的 `currentRate()` 同口径，避免实时汇率生效时 USD 显示与计价不一致。 */
 export declare function cnyToUsd(cny: number): number;
+/**
+ * 人民币金额换算到展示币种。目录以 CNY/USD 为原生币种，费用统一以
+ * 人民币累计，展示层再按所选币种换算——EUR 与 USD 同一口径，不改变存储与聚合。
+ * @param cny - 人民币金额。
+ * @param currency - 目标展示币种。
+ * @returns 换算后的金额（汇率不可用时原值返回）。
+ */
+export declare function convertFromCny(cny: number, currency: CostCurrency): number;
 /**
  * Format an amount with adaptive precision and the given currency symbol.
  * @param amount - the amount (CNY by default; pass `usd` for dollar display).
@@ -443,7 +461,7 @@ export declare function formatMoney(amount: number, currency?: CostCurrency): st
  * Format a per-1M-token price in its native currency (free when the rate is
  * zero): CNY for domestic models, USD for overseas ones.
  */
-export declare function formatUnitPrice(price: number, currency?: 'CNY' | 'USD'): string;
+export declare function formatUnitPrice(price: number, currency?: 'CNY' | 'USD' | 'EUR'): string;
 /**
  * 把一条「每百万 token」单价从原生币种换算到目标展示币种（按 USD→CNY 汇率）。
  * 汇率缺失/非法时回退原值，避免 0 汇率把价格算没。

package/lib/types/client/rate-search.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 费率表搜索：目录 + models.dev 补充条目约 3000 行，无过滤时只能靠滚动定位
+ * 单个模型（issue #66）。判定抽成纯函数，便于无 DOM 单测；匹配目录键、显示名
+ * 与厂商三个字段，大小写不敏感，空查询原样返回（默认视图与现状一致）。
+ */
+/** 搜索可匹配的最小条目形状（ModelEntry 的子集，便于测试构造）。 */
+export interface SearchableEntry {
+    key: string;
+    name?: string;
+    provider?: string;
+}
+/**
+ * 按查询过滤费率表行。
+ * @param entries - 待过滤的目录条目。
+ * @param query - 用户输入（首尾空白忽略）。
+ * @returns 命中的条目；查询为空/全空白时原样返回入参引用。
+ */
+export declare function filterRateRows<T extends SearchableEntry>(entries: readonly T[], query: string): readonly T[];
+//# sourceMappingURL=rate-search.d.ts.map

package/lib/types/client/round-chart.d.ts

@@ -32,6 +32,6 @@ export declare function RoundCostChart({ rounds, flags, currency, t }: {
     rounds: readonly RoundChartRow[];
     flags: readonly AnomalyFlag[];
     currency: CostCurrency;
-    t: (key: 'model' | 'costAbbr') => string;
+    t: (key: 'model' | 'costAbbr' | 'roundsUnit') => string;
 }): React.ReactNode;
 //# sourceMappingURL=round-chart.d.ts.map

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

@@ -121,6 +121,38 @@ export declare const DEFAULT_CURRENCY: CostCurrency;
 export declare function loadCurrency(): CostCurrency;
 /** 写入显示币种。失败静默（展示偏好非关键）。 */
 export declare function saveCurrency(currency: CostCurrency): void;
+/**
+ * 被固定的模型（峰谷指示点）：费率表里点击圆点固定，固定后在输入框旁常驻显示。
+ * 与币种偏好同一套做法：localStorage + CustomEvent，因为胶囊与弹窗分属两棵 React 树。
+ */
+export declare const PINNED_MODELS_STORAGE_KEY = "dsh.ui-usage-billing.pinned";
+/** 固定列表变更后派发的 CustomEvent 名。 */
+export declare const PINNED_MODELS_EVENT = "dsh.ui-usage-billing.pinned-pref";
+/** 读取固定模型列表（损坏/非数组/非字符串项一律丢弃）。 */
+export declare function loadPinnedModels(): string[];
+/** 写入固定模型列表。失败静默（展示偏好非关键）。 */
+export declare function savePinnedModels(keys: readonly string[]): void;
+/** 界面语言（与币种解耦后独立持久化）。 */
+export type BillingLanguage = 'zh' | 'en';
+/** localStorage key（与其他 `dsh.ui-usage-billing.*` 偏好同命名空间）。 */
+export declare const LANGUAGE_STORAGE_KEY = "dsh.ui-usage-billing.language";
+/** 语言切换后派发的 CustomEvent 名（另一棵树监听它即时重读）。 */
+export declare const LANGUAGE_PREF_EVENT = "dsh.ui-usage-billing.language-pref";
+/**
+ * 读取界面语言。**迁移关键**：历史版本的语言是从币种推导的（选 $ 就是英文），
+ * 因此当尚无语言偏好时，**从已存的币种播种一次**并写回；升级后没有任何人
+ * 的界面语言会静默改变，且播种只发生一次。
+ * @returns 界面语言。
+ */
+export declare function loadLanguage(): BillingLanguage;
+/** 写入界面语言。失败静默（展示偏好非关键）。 */
+export declare function saveLanguage(language: BillingLanguage): void;
+/**
+ * 切换某个模型的固定状态。
+ * @param key - 目录键。
+ * @returns 切换后的列表（已写入）。
+ */
+export declare function togglePinnedModel(key: string): string[];
 /** 用户自定义单价（与 client/pricing.ts 的 `UserPriceEntry` 同形；type import，无运行时依赖）。 */
 export type StoredUserPrice = UserPriceEntry;
 /** 自定义价表：模型（+可选来源）→ 单价，条目列表（支持同名模型绑定不同中转站 origin）。 */

package/lib/types/pricing-shared.d.ts

@@ -19,6 +19,8 @@ export interface LivePricing {
     source: 'live' | 'builtin';
     /** USD → CNY mid rate (present when the rate fetch succeeded). */
     rate?: number;
+    /** EUR → CNY mid rate (present when the euro rate fetch succeeded). */
+    rateEur?: number;
     /** Overrides keyed by built-in catalog key (present when router matches succeeded). */
     prices?: Record<string, LivePrice>;
     /**

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

package/lib/types/client/vendor-logos.d.ts

@@ -1,12 +0,0 @@
-/**
- * Vendor logos: inlined data URIs fetched from models.dev /logos/{id}.svg.
- * Kept to the highest-traffic providers only to hold the client bundle under the
- * DSH Store 256 KiB single-file cap. Every other provider falls back to a
- * brand-color letter badge in the UI (see VendorLogo in UsageBilling.tsx), so no
- * external asset or copyright risk is introduced for unlisted vendors. 月之暗面 is
- * a hand-redrawn minimal crescent — its official SVG is a multi-thousand-node path
- * that alone cost ~6.8 KiB.
- */
-export declare const VENDOR_LOGOS: Readonly<Record<string, string>>;
-export declare function vendorLogoOf(provider: string): string | undefined;
-//# sourceMappingURL=vendor-logos.d.ts.map