dsh-cost-meter 1.7.29 → 1.7.30

package/README.en.md

@@ -6,9 +6,9 @@
 
 Per-conversation cost · daily totals · OpenCode Go subscription quota display · budget with usage percentage · official account balance · custom provider balance · balance progress bar · history · peak/off-peak pricing hours display (peak hours UTC 01:00–04:00, 06:00–10:00; from Aug 23, 2026 weekends are billed at off-peak prices all day, shown as “Weekend — all off-peak”) · pre-switch popup & system-notification alerts for peak/off-peak changes (position / lead time / alert type configurable) · one-click price sync from the official docs · Codex-style token usage heat grid · multi-vendor model pricing (built-in 90+ model price catalog with auto-matching) · mainstream Coding Plan quota queries & display (Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet) plan/API dual-track billing (subscription quota vs pay-as-you-go money separated, per-1% & full-window token/equivalent-cost estimates with daily/weekly/monthly curves) · · quota strip above the input box (budget / Go / coding-plan usage in one row, toggleable)
 
-[![version](https://img.shields.io/badge/version-1.7.29-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.7.30-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 
-**v1.7.29** fixes an unavailable ledger after a marketplace hot install. Initial reads retry automatically; the empty state shows the error and a Refresh button. See the [hot-install guide](docs/market-hot-install.md#english).
+**v1.7.30** adds OpenRouter token reference prices, a four-model offline snapshot and automatic catalog refresh. Scoped backfill preserves existing charges, and automatic updates preserve custom prices. Thanks to @GnaneshKunal for PR #156. See the [pricing guide](docs/openrouter-pricing.md#english).
 
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
@@ -56,6 +56,7 @@ English | [中文](README.md)
 | Model & Plan adaptation guide | [adaptation doc](docs/model-and-plan-adaptation.en.md) | Adaptation matrix for per-model billing and the 8 Coding Plan vendors, the auto-matching mechanism and price sources ([中文](docs/model-and-plan-adaptation.md)) |
 | Peak/off-peak alert guide | [alert doc](docs/peak-alert.en.md) | Fully illustrated guide to the pre-switch popup and system notification: effect screenshots (EN/中文), settings reference and usage tips ([中文](docs/peak-alert.md)) |
 | Token Plan usage stats guide | [panel doc](docs/token-plan-stats.md) | Meaning of the four columns in the per-1% & full-window panel, the end-to-end delta estimation method and precision tags, the scope boundary (dsh-made calls only) and usage curves ([中文](docs/token-plan-stats.md#中文)) |
+| OpenRouter passthrough pricing | [pricing doc](docs/openrouter-pricing.md#english) | Token reference prices: offline snapshot, scoped zero-cost backfill, public-catalog refresh, custom-price preservation and failure fallback ([中文](docs/openrouter-pricing.md)) |
 | Multi-provider billing | Settings / ledger | OpenAI, Anthropic, Google Gemini, Mistral and other providers with input/output, cache and reasoning-token pricing isolated by provider + model |
 | Model-name auto-matching | Settings / ledger | Unknown model ids are matched against the price table: case/spaces/hyphens/dots and bracket annotations (e.g. (go)) are ignored — a normalized-equal or containing name hits (e.g. `gpt5.6 luna(go)`); router providers (opencode/zen etc.) search across all vendors; can be restricted to exact match, and unmatched models can be pinned to a specific entry in Settings |
 | Extended price catalog | Settings → Extended price catalog | Built-in reference catalog grouped by vendor and model family (expandable; vendors collapsed by default); mount entries into billing with one click — mounted third-party models live inside the catalog and stay editable; a per-model “Show directly in Cost settings” toggle chooses which models (DeepSeek included) appear directly in the price table |
@@ -288,22 +289,22 @@ Real captures from an actual DSH sidebar of the period strip and collapsed verti
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.7.29`** — review the script before running):
+**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.7.30`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.7.29/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.7.30/install.ps1 | iex
 ```
 
 **Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.7.29
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.7.30
 ```
 
 Without git, use the GitHub tag archive:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.7.29.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.7.30.tar.gz
 ```
 
 After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):

package/README.md

@@ -6,9 +6,9 @@
 
 本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段;2026-08-23 起周末全天按谷价,显示「周末时段——全谷价」) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet / 火山方舟 九家,含 Volcano Ark AK/SK 签名) · Plan/API 双轨计费(订阅额度与按量金额分离统计,每 1% 额度与满窗的 token/等值金额估算及日/周/月曲线) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)
 
-[![version](https://img.shields.io/badge/version-1.7.29-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.7.30-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 
-**v1.7.29**：修复插件市场热安装后“账本不可用”、必须重启才恢复的问题；首屏读取失败会自动重试，并显示错误与刷新按钮。详见[热安装说明](docs/market-hot-install.md)。
+**v1.7.30**：新增 OpenRouter token 价格目录与自动刷新，内置四模型离线快照；定向修复零费用旧账，保留手改价格和已记费用。感谢 @GnaneshKunal 的 PR #156。详见[定价说明](docs/openrouter-pricing.md)。
 
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
@@ -57,6 +57,7 @@
 | 模型与 Plan 适配说明 | [适配文档](docs/model-and-plan-adaptation.md) | 各厂商模型计费与 8 家 Coding Plan 的适配矩阵、自动匹配机制与价格来源([English](docs/model-and-plan-adaptation.en.md)) |
 | 峰/谷切换提醒图解 | [提醒文档](docs/peak-alert.md) | 峰谷切换前弹窗与系统通知的完整图解:效果截图(中/英)、设置项说明与使用建议([English](docs/peak-alert.en.md)) |
 | Token Plan 用量统计图解 | [面板文档](docs/token-plan-stats.md) | 每 1% 与满窗估算的四列含义、首尾差分估算方法与精度标注、口径边界(只统计 dsh 内调用)与用量曲线说明([English](docs/token-plan-stats.md#english)) |
+| OpenRouter 透传定价 | [定价说明](docs/openrouter-pricing.md) | OpenRouter 原样透传上游价格：内置快照、旧账本自动回填、公开目录(无需认证)定时刷新合并，失败保留本地快照([English](docs/openrouter-pricing.md#english)) |
 | 多 provider 计费 | 设置页 / 账本 | 支持 OpenAI、Anthropic、Google Gemini、Mistral 等 provider 的 input/output、缓存与 reasoning token 价格,按 provider+model 隔离计费 |
 | 模型名自动匹配 | 设置页 / 账本 | 未知模型 id 自动匹配价格表:忽略大小写/空格/横杠/点号与括号附注,归一化等价或请求名包含表内模型名即命中(如 `gpt5.6 luna(go)`);路由 provider(opencode/zen 等)下跨厂商全库查找;可关闭为仅精确;未命中模型可手动指定计费条目 |
 | 拓展价格表 | 设置页 → 拓展价格表 | 内置各厂商、按模型家族分类的参考价格目录(点开展开,厂商默认折叠);一键挂载参与计费,挂载的第三方模型默认收入表内可编辑;逐模型「在费用设置直接显示」开关自选哪些模型(含 DeepSeek)在「价格表」区直接显示 |
@@ -290,22 +291,22 @@ CLIProxyAPI 网关来源卡片可勾选「只显示 Gemini 额度」，仅影响
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.7.29`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.7.30`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.7.29/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.7.30/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.7.29
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.7.30
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.7.29.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.7.30.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/index.js

@@ -28,6 +28,7 @@ import { createUsageDeduper, USAGE_DEDUP_WINDOW_MS, usageFingerprint } from './u
 import { CODING_PLAN_PROVIDERS, CODING_PLAN_PROVIDER_IDS, queryCodingPlan, scnetTokenPlanWindows, qwenTokenPlanWindows, emptyCustomBalance, queryCustomBalance, normalizeVolcengineKey } from './coding-plans.js'
 import { recordSamples, buildPlanStats, canonicalWindowKey, periodStartOf, aggregateUsageSince, enabledPlanSetOf, billingClassOf, pruneHourBuckets, suggestPlanAutoClasses } from './plan-billing.js'
 import { fetchWithRetry } from './net.js'
+import { createOpenRouterPriceRefresh, repairOpenRouterLedger } from './openrouter-pricing.js'
 import { queryGatewayQuota, emptyGatewayQuota, managementKeyVarOf, gatewaySourceFingerprint } from './gateway-quotas.js'
 import { stateSchema, TYPERT } from './typert.host.js'
 import { customBalanceCredentialVars } from './custom-balance.js'
@@ -94,6 +95,8 @@ const SERVER_MESSAGES = {
     pricesSyncedFallback: '所选币种官方页同步失败({error}),已回退另一语言官方页,同步 {ids} 的价格;可稍后重试切换回目标币种',
     pricesRecomputed: '价格币种已切换,历史账目按新价目重算:{days} 天 / {sessions} 个会话(日志覆盖不全的会话保持原口径)',
     priceSyncFailed: '官方价格同步失败:{error}',
+    openrouterRefreshed: 'OpenRouter 模型价格已刷新:{count} 个模型',
+    openrouterRefreshFailed: 'OpenRouter 价格刷新失败(已保留本地快照):{error}',
     codingPlanKeyMissing: '未找到 {provider} 的凭据。请在下方填写 API Key,或配置对应环境变量/CLI 登录态;没有订阅可关闭该家的「启用」开关。',
     codingPlanUnauthorized: '{provider} 凭据无效或没有生效的订阅(接口返回 {code})。没有订阅可关闭该家的「启用」开关。',
     codingPlanHttp: '{provider} 额度接口 HTTP {code}({url})',
@@ -162,6 +165,8 @@ const SERVER_MESSAGES = {
     pricesSyncedFallback: 'Syncing the official page for the selected currency failed ({error}); fell back to the other language page and synced prices for {ids}. You can switch back and retry later.',
     pricesRecomputed: 'Pricing currency switched; history has been re-costed on the new price table: {days} day(s) / {sessions} session(s) (sessions without full log coverage keep their original basis)',
     priceSyncFailed: 'Official price sync failed: {error}',
+    openrouterRefreshed: 'OpenRouter model prices refreshed: {count} models',
+    openrouterRefreshFailed: 'OpenRouter price refresh failed (kept local snapshot): {error}',
     codingPlanKeyMissing: 'No credentials found for {provider}. Enter the API key below, or configure the matching environment variable / CLI login; turn off the Enable switch if you have no subscription.',
     codingPlanUnauthorized: '{provider} credentials are invalid or no active subscription was detected (API returned {code}). Turn off the Enable switch if you have no subscription.',
     codingPlanHttp: '{provider} quota API returned HTTP {code} ({url})',
@@ -1197,6 +1202,20 @@ async function fetchPricingHtml(locale, pricingCurrency) {
   return text
 }
 
+/** fetchPrices 的 OpenRouter 附加腿:成功返回 tmsg 备注,失败返回失败备注,
+ *  永不抛错(不翻转官方同步的 ok 状态)。 */
+async function openRouterRefreshNote(openRouterPrices, locale) {
+  try {
+    const { count } = await openRouterPrices.refresh()
+    return tmsg(locale, 'openrouterRefreshed', { count })
+  } catch (error) {
+    const detail = error?.code === 'ERR_NO_MODELS'
+      ? tmsg(locale, 'noModelsParsed')
+      : (error instanceof Error ? error.message : String(error))
+    return tmsg(locale, 'openrouterRefreshFailed', { error: detail })
+  }
+}
+
 /**
  * 创建 costMeter 服务对象。手写 `typertRemote` 绑定(service/serviceKey/namespace)
  * 满足 Typert 网关的 validateBinding 校验;方法按清单参数顺序位置调用。
@@ -1281,7 +1300,7 @@ async function describeGoKey(ctx, config) {
   return legacy ? { keyConfigured: true, keySource: 'legacy' } : fallback
 }
 
-function createService(ctx, ledger) {
+function createService(ctx, ledger, openRouterPrices) {
   // 余额进程内缓存:display=off 时不清缓存但不下发;按 refreshMinutes 过期。
   let balanceCache = { fetchedAt: 0, value: emptyBalance() }
   // OpenCode Go 订阅额度进程内缓存(同上策略)。
@@ -2180,18 +2199,24 @@ function createService(ctx, ledger) {
         const baseMessage = fallbackError === null
           ? tmsg(locale, 'pricesSynced', { ids: joined })
           : tmsg(locale, 'pricesSyncedFallback', { error: fallbackError instanceof Error ? fallbackError.message : String(fallbackError), ids: joined })
+        // OpenRouter 附加腿(Phase2):官方页不管成败都尝试刷新,不翻转 ok。
+        const orNote = await openRouterRefreshNote(openRouterPrices, locale)
+        const parts = recomputeNote.length > 0 ? [baseMessage, recomputeNote, orNote] : [baseMessage, orNote]
         return {
           ok: true,
-          message: recomputeNote.length > 0 ? `${baseMessage}。${recomputeNote}` : baseMessage,
+          message: parts.join('。'),
           state: await build(false),
         }
       } catch (error) {
         const detail = error?.code === 'ERR_NO_MODELS'
           ? tmsg(locale, 'noModelsParsed')
           : (error instanceof Error ? error.message : String(error))
+        // 官方页失败也不放弃 OpenRouter 腿:两路独立源,备注如实说明。
+        const orNote = await openRouterRefreshNote(openRouterPrices, locale)
         return {
           ok: false,
-          message: tmsg(locale, 'priceSyncFailed', { error: detail }),
+          message: `${tmsg(locale, 'priceSyncFailed', { error: detail })}。${orNote}`,
+          state: await build(false),
         }
       }
     },
@@ -2727,6 +2752,9 @@ export async function runStartupImports(ledger, sessionsRoot) {
     // 新价格可能改变 plan 归类所需的 apiCost 口径，联动重算一次
     if (repaired.recostedBuckets > 0) splitLedgerApiCost(ledger)
   }
+  // 离线时先按快照修复零费用的 OpenRouter 桶；全目录成功后才标记完成。
+  const openRouterRepair = repairOpenRouterLedger(ledger)
+  if (openRouterRepair.recostedBuckets > 0) ledger.scheduleWrite()
   // 计费口径一致性重建(v1.6.0):桶级 apiCost 按分类回写 + 容器 = Σ桶 +
   // 无明细残差归 API;修复桶/容器脱节导致的累计费用失真(用户实测:插件
   // $5.26 vs 桶级分布 $12.41)。幂等,标记防重跑。v4:去掉 modlens-zen
@@ -2858,6 +2886,15 @@ export function apply(ctx) {
 
   // 卸载/退出前最终落盘。
   ctx.effect(() => () => ledger.close(), 'cost-meter: ledger close')
+  const openRouterPrices = createOpenRouterPriceRefresh(ledger)
+  let active = true
+  ctx.effect(() => () => { active = false; openRouterPrices.dispose() }, 'cost-meter: openrouter requests')
+  const refreshOpenRouter = () => {
+    if (!active) return
+    return openRouterPrices.refresh().catch(error => {
+      if (active) console.warn(`[dsh-cost-meter] OpenRouter 价格刷新失败(保留本地价格): ${String(error?.message ?? error)}`)
+    })
+  }
 
   // 历史账本按模型回填 + 首次启动自动导入安装前历史(issue #27):
   // 启动后延迟执行,避免拖慢宿主启动;均幂等,只补缺失,不重复计数。
@@ -2876,13 +2913,18 @@ export function apply(ctx) {
     } catch (error) {
       console.warn(`[dsh-cost-meter] 自定义余额请求头密钥迁移失败: ${String(error?.message ?? error)}`)
     }
-    runStartupImports(ledger, join(resolveDshHome(), 'sessions')).catch(error => {
+    if (!active) return
+    await runStartupImports(ledger, join(resolveDshHome(), 'sessions')).catch(error => {
       console.warn(`[dsh-cost-meter] 启动期历史导入失败: ${String(error?.message ?? error)}`)
     })
+    await refreshOpenRouter()
   }, 3000)
   backfillTimer.unref?.()
   // 卸载/退出时清掉尚未触发的启动回填定时器:dispose 后不再执行导入。
   ctx.effect(() => () => clearTimeout(backfillTimer), 'cost-meter: backfill timer')
+  const openRouterTimer = setInterval(() => { void refreshOpenRouter() }, 3600_000)
+  openRouterTimer.unref?.()
+  ctx.effect(() => () => clearInterval(openRouterTimer), 'cost-meter: openrouter refresh timer')
 
   // 包裹 llm/stream:捕获 usage 块(位于 finish 之前),按官方价格计入账本。
   // 本插件是链尾监听者,next() 即适配器流;仅透传数据块,不改变流协议。
@@ -2924,7 +2966,7 @@ export function apply(ctx) {
   })
 
   // RPC 服务:客户端经 remote.costMeter.* 调用(./typert 清单由 typert-loader 注册)。
-  ctx.provide('costMeter', createService(ctx, ledger))
+  ctx.provide('costMeter', createService(ctx, ledger, openRouterPrices))
 
   // dshmarket 1.47 热安装通过独立 Include 挂载 file:// 入口；它不在根 Loader
   // 的包名扫描树中，typert-loader 因此漏注册 (#154)。正常包名启动仍由宿主注册。

package/lib/openrouter-pricing.js

@@ -0,0 +1,78 @@
+import { createHash } from 'node:crypto'
+import { DEFAULT_PROVIDER_PRICE_TABLE, OPENROUTER_MODELS_URL, normalizePrice, parseOpenRouterModels } from './pricing.js'
+import { applyConfigPatch, repairLedgerPricing } from './store.js'
+import { fetchWithRetry, readJsonBounded } from './net.js'
+
+const MIGRATION = 'pricing-openrouter-v1'
+const fingerprint = raw => {
+  const entry = normalizePrice(raw)
+  if (!entry) return null
+  const { sourceUrl, checkedAt, notes, ...rates } = entry
+  return createHash('sha256').update(JSON.stringify(rates)).digest('hex')
+}
+const baseline = (ledger, id) => ledger.openrouterPriceHashes?.[id]
+  ?? fingerprint(DEFAULT_PROVIDER_PRICE_TABLE.openrouter.models[id])
+const managed = (ledger, id, entry) => baseline(ledger, id) === fingerprint(entry)
+
+/** 只估算 OpenRouter 零费用桶；已记金额、其他厂商和显式映射保持原样。 */
+export function repairOpenRouterLedger(ledger) {
+  if (ledger.migrations.includes(MIGRATION)) return { recostedBuckets: 0 }
+  return repairLedgerPricing(ledger, (key, bucket) => {
+    const sep = key.indexOf(':')
+    if (!['openrouter', 'llm-openrouter'].includes(key.slice(0, sep)) || Number(bucket.cost) !== 0) return false
+    const id = key.slice(sep + 1), entry = ledger.config.prices?.providers?.openrouter?.models?.[id]
+    if (Object.hasOwn(ledger.config.priceOverrides ?? {}, 'openrouter:' + id)) return false
+    return !!entry && managed(ledger, id, entry)
+  })
+}
+
+/** 每个账本共享一次在途请求；总超时覆盖响应体，卸载取消并阻止迟到写入。 */
+export function createOpenRouterPriceRefresh(ledger, { fetchImpl, timeoutMs = 20000 } = {}) {
+  let active = true, pending = null, controller = null
+  const refresh = () => {
+    if (!active || ledger.closed) return Promise.reject(new Error('OpenRouter price refresh disposed'))
+    if (pending) return pending
+    controller = new AbortController()
+    const signal = controller.signal
+    const timer = setTimeout(() => controller?.abort(new Error('OpenRouter price refresh timed out')), timeoutMs)
+    timer.unref?.()
+    pending = (async () => {
+      const response = await fetchWithRetry(OPENROUTER_MODELS_URL, {
+        headers: { 'user-agent': 'dsh-cost-meter (DeepSeek Harness plugin)' }, redirect: 'error', signal,
+      }, { attempts: 2, fetchImpl })
+      if (!response.ok) {
+        try { await response.body?.cancel?.() } catch {}
+        throw new Error(`HTTP ${response.status}`)
+      }
+      const { models } = parseOpenRouterModels(await readJsonBounded(response, 4 * 1024 * 1024))
+      signal.throwIfAborted()
+      if (!active || ledger.closed) throw new Error('OpenRouter price refresh disposed')
+      // 网络等待后读取当前配置，保留期间的其他设置改动；手改价格不被覆盖。
+      const previous = ledger.config.prices?.providers?.openrouter?.models ?? {}
+      const merged = { ...previous }, hashes = { ...ledger.openrouterPriceHashes }
+      let count = 0
+      for (const [id, raw] of Object.entries(models)) {
+        const entry = normalizePrice(raw)
+        if (!entry) continue
+        if (Object.hasOwn(previous, id) ? !managed(ledger, id, previous[id]) : hashes[id] !== undefined) continue
+        merged[id] = { ...entry, ...(previous[id]?.notes ? { notes: previous[id].notes } : {}) }
+        hashes[id] = fingerprint(entry)
+        count++
+      }
+      const { config, errors } = applyConfigPatch(ledger.config, { prices: {
+        ...ledger.config.prices,
+        providers: { ...ledger.config.prices?.providers, openrouter: { models: merged } },
+      } })
+      if (errors.length) throw new Error(errors.join(';'))
+      ledger.config = config
+      ledger.openrouterPriceHashes = hashes
+      // 离线启动只做快照范围的修复；首次目录成功后再完成迁移，避免永久漏掉其余模型。
+      const repaired = repairOpenRouterLedger(ledger)
+      if (!ledger.migrations.includes(MIGRATION)) ledger.migrations.push(MIGRATION)
+      ledger.scheduleWrite()
+      return { count, ...repaired }
+    })().finally(() => { clearTimeout(timer); pending = null; controller = null })
+    return pending
+  }
+  return { refresh, dispose() { active = false; controller?.abort(new Error('OpenRouter price refresh disposed')) } }
+}

package/lib/pricing.js

@@ -280,6 +280,76 @@ export const DEFAULT_PROVIDER_PRICE_TABLE = {
       'muse-spark-1.2-contributor': { input: 0.1, cachedInput: 0.002, output: 0.2, billingMode: 'flat', sourceUrl: 'https://opencode.ai/docs/go', checkedAt: '2026-08-25', notes: '低价换取提示词/补全用于训练 Meta 模型;限地区' },
     },
   },
+  // OpenRouter 公开目录中的 token 参考价(https://openrouter.ai/api/v1/models)。
+  // 键为 OpenRouter 完整模型 id(含厂商前缀,如 'meta/...'),与账本
+  // 'openrouter:<id>' 精确对应;静态快照(2026-09-17),动态刷新见后续。
+  openrouter: {
+    models: {
+      'meta/muse-spark-1.3-contributor': { input: 0.1, cachedInput: 0.002, output: 0.2, billingMode: 'flat', sourceUrl: 'https://openrouter.ai/api/v1/models', checkedAt: '2026-09-17' },
+      'google/gemini-3.8-flash': { input: 0.75, cachedInput: 0.075, cacheWrite: 0.041667, output: 3.75, billingMode: 'flat', sourceUrl: 'https://openrouter.ai/api/v1/models', checkedAt: '2026-09-17' },
+      'qwen/qwen3.8-flash': { input: 0.15, cachedInput: 0.016, cacheWrite: 0.2, output: 0.47, billingMode: 'flat', sourceUrl: 'https://openrouter.ai/api/v1/models', checkedAt: '2026-09-17' },
+      'z-ai/glm-5.3-flash': { input: 0.09, cachedInput: 0.018, output: 0.3, billingMode: 'flat', sourceUrl: 'https://openrouter.ai/api/v1/models', checkedAt: '2026-09-17' },
+    },
+  },
+}
+
+/** OpenRouter 模型目录接口(公开,无需认证;返回 USD/token 字符串)。
+ *  Phase2 实时刷新源:本地 DEFAULT_PROVIDER_PRICE_TABLE 只保留少量快照
+ *  做离线兜底,启动/手动同步/每小时刷新用它补全全量 openrouter 价。 */
+export const OPENROUTER_MODELS_URL = 'https://openrouter.ai/api/v1/models'
+
+/** 解析 OpenRouter /models 载荷为价目原始条目(USD/百万 token,flat 口径)。
+ *  输入:GET OPENROUTER_MODELS_URL 的 JSON({ data: [{ id, pricing }] });
+ *  输出:{ models: { '<vendor>/<model>': { input, output, cachedInput?, cacheWrite?, billingMode: 'flat', sourceUrl, checkedAt } } }。
+ *  跳过:空 id / 无 pricing / prompt 或 completion 缺失或负数/非数字
+ *  (路由聚合模型如 openrouter/auto 用 prompt:"-1" 占位,无真实单价)。
+ *  可选键只在有限非负数时收录;"0"(免费模型)收录为 0。
+ *  纯函数,无网络 IO,方便 verify.mjs 单测。 */
+export function parseOpenRouterModels(json) {
+  const list = Array.isArray(json?.data) ? json.data : null
+  if (list === null) {
+    // code 供上层按语言渲染提示(见 index.js 的 ERR_NO_MODELS 分支)。
+    const error = new Error('ERR_NO_MODELS')
+    error.code = 'ERR_NO_MODELS'
+    throw error
+  }
+  const rate = (value) => {
+    if ((typeof value !== 'string' && typeof value !== 'number')
+      || (typeof value === 'string' && !/^(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(value.trim()))) return undefined
+    const n = Number(value)
+    const scaled = n * 1e6
+    if (!Number.isFinite(scaled) || n < 0) return undefined
+    const rounded = Number(scaled.toFixed(6))
+    return rounded === 0 && scaled > 0 ? Number(scaled.toPrecision(15)) : rounded
+  }
+  const today = new Date().toISOString().slice(0, 10)
+  // USD/token ×1e6 会带浮点尘(如 1e-7*1e6=0.09999999999999999),统一舍到
+  // 6 位小数,与本地快照写法一致,避免价目表出现长尾小数。
+  const models = {}
+  for (const item of list) {
+    if (item === null || typeof item !== 'object') continue
+    const id = typeof item.id === 'string' ? item.id.trim() : ''
+    if (id === '' || id === '__proto__' || id === 'constructor' || id === 'prototype') continue
+    const pricing = item.pricing
+    if (pricing === null || typeof pricing !== 'object' || Array.isArray(pricing)) continue
+    const prompt = rate(pricing.prompt)
+    const completion = rate(pricing.completion)
+    if (prompt === undefined || completion === undefined) continue
+    const raw = {
+      input: prompt,
+      output: completion,
+      billingMode: 'flat',
+      sourceUrl: OPENROUTER_MODELS_URL,
+      checkedAt: today,
+    }
+    const cacheRead = rate(pricing.input_cache_read)
+    if (cacheRead !== undefined) raw.cachedInput = cacheRead
+    const cacheWrite = rate(pricing.input_cache_write)
+    if (cacheWrite !== undefined) raw.cacheWrite = cacheWrite
+    models[id] = raw
+  }
+  if (Object.keys(models).length === 0) throw Object.assign(new Error('ERR_NO_MODELS'), { code: 'ERR_NO_MODELS' })
+  return { models }
 }
 
 /** 拓展价格表目录的模型家族分组(展示用;未列出的模型自成一家)。 */
@@ -322,6 +392,10 @@ export const PROVIDER_MODEL_FAMILIES = {
   mistral: { 'mistral-large-2512': 'Mistral Large', 'mistral-medium-3.5': 'Mistral Medium', 'mistral-small-4.0': 'Mistral Small' },
   meta: { 'muse-spark-1.2': 'Muse Spark' },
   meituan: { 'longcat-2.0': 'LongCat' },
+  openrouter: {
+    'meta/muse-spark-1.3-contributor': 'Muse Spark', 'google/gemini-3.8-flash': 'Gemini 3.8 Flash',
+    'qwen/qwen3.8-flash': 'Qwen3.8 Flash', 'z-ai/glm-5.3-flash': 'GLM-5 Flash',
+  },
   'opencode-go': {
     'gpt-5.6-luna': 'GPT', 'grok-4.5': 'Grok', 'glm-5.3': 'GLM', 'glm-5.3-flash': 'GLM Flash', 'glm-5.2': 'GLM', 'glm-5.1': 'GLM',
     'kimi-k3': 'Kimi', 'kimi-k2.7-code': 'Kimi', 'kimi-k2.6': 'Kimi',
@@ -778,6 +852,13 @@ function providerPriceEntryForNormalized(normalized, modelId, prices, options) {
   if (isLocalOriginProviderOrModel(targetProvider, targetModel)) {
     return { entry: null, billingMode: 'flat', priced: false }
   }
+  // OpenRouter 的 :free / :online 等变体有独立价格；完整 id 精确查价，避免
+  // 新目录加入免费项后，未收录的付费模型或其他变体通过模糊匹配被记作免费。
+  if (targetProvider === 'openrouter') {
+    const models = prices?.providers?.openrouter?.models ?? {}
+    const entry = Object.hasOwn(models, targetModel) ? normalizePrice(models[targetModel]) : null
+    return { entry, billingMode: 'flat', priced: entry !== null && entry.unpriced !== true }
+  }
   if (targetProvider === '' || targetProvider === 'deepseek' || targetProvider.includes('deepseek')) {
     const models = prices?.models ?? {}
     // 仅认自有属性(防原型链键);命中后统一 normalizePrice 补齐两档简写等写法,
@@ -800,6 +881,7 @@ function providerPriceEntryForNormalized(normalized, modelId, prices, options) {
       let bestLen = -1
       let bestMode = 'flat'
       for (const [prov, table] of Object.entries(prices?.providers ?? {})) {
+        if (prov === 'openrouter') continue // 路由目录不作为其他渠道的模糊兜底价。
         const modelsCat = table?.models ?? {}
         const h = matchModelId(targetModel, Object.keys(modelsCat))
         if (h === null) continue
@@ -839,7 +921,7 @@ function providerPriceEntryForNormalized(normalized, modelId, prices, options) {
     let bestLen = -1
     let bestMode = 'flat'
     for (const [prov, table] of Object.entries(prices?.providers ?? {})) {
-      if (prov === targetProvider) continue
+      if (prov === targetProvider || prov === 'openrouter') continue
       const models = table?.models ?? {}
       const h = matchModelId(targetModel, Object.keys(models))
       if (h === null) continue

package/lib/store.js

@@ -382,9 +382,10 @@ export function splitLedgerApiCost(ledger) {
  * 逐 byProviderModel 桶按当前价格表重算(flat 模型与峰谷无关，DeepSeek
  * 档按日中午近似，容差 10% 以内不扰动，避免峰时抖动误伤)。
  * 同时按新 planBilling 重算 apiCost。
+ * @param accepts - 可选桶筛选器；定向迁移只修改命中的 provider:model 与费用。
  * @returns { touchedDays, touchedSessions, recostedBuckets }
  */
-export function repairLedgerPricing(ledger) {
+export function repairLedgerPricing(ledger, accepts = () => true) {
   const enabledPlans = enabledPlanSetOf(ledger.config)
   const planBilling = ledger.config.planBilling
   const prices = ledger.config.prices
@@ -402,6 +403,7 @@ export function repairLedgerPricing(ledger) {
     let dayChanged = false
     for (const [key, bucket] of Object.entries(day.byProviderModel ?? {})) {
       if (bucket === null || typeof bucket !== 'object') continue
+      if (!accepts(key, bucket)) continue
       const sep = key.indexOf(':')
       const provider = sep >= 0 ? key.slice(0, sep) : 'deepseek'
       const model = sep >= 0 ? key.slice(sep + 1) : key
@@ -445,6 +447,7 @@ export function repairLedgerPricing(ledger) {
         let sessApiDelta = 0
         let sessChanged = false
         for (const [key, bucket] of Object.entries(session.byProviderModel ?? {})) {
+          if (bucket === null || typeof bucket !== 'object' || !accepts(key, bucket)) continue
           const sep = key.indexOf(':')
           const provider = sep >= 0 ? key.slice(0, sep) : 'deepseek'
           const model = sep >= 0 ? key.slice(sep + 1) : key
@@ -1933,6 +1936,9 @@ export class Ledger {
     // Plan 百分比采样历史与 provider×小时聚合桶(issue #64;v1.5.52 起小时桶取代环形缓冲)。
     this.planSamples = extras.planSamples ?? {}
     this.planHourBuckets = extras.planHourBuckets ?? {}
+    // 自动目录上次写入的价格指纹：重启后仍能识别用户手改价格，不下发到客户端。
+    this.openrouterPriceHashes = Object.fromEntries(Object.entries(extras.openrouterPriceHashes ?? {})
+      .filter(([key, value]) => !['__proto__', 'constructor', 'prototype'].includes(key) && typeof value === 'string' && /^[a-f0-9]{64}$/.test(value)))
   }
 
   /** 在 $DSH_HOME 下创建/加载账本。 */
@@ -1945,6 +1951,7 @@ export class Ledger {
     let migrations = []
     let planSamples = {}
     let planHourBuckets = {}
+    let openrouterPriceHashes = {}
     try {
       const parsed = JSON.parse(readFileSync(path, 'utf8'))
       if (parsed !== null && typeof parsed === 'object') {
@@ -1964,6 +1971,7 @@ export class Ledger {
           }
           // 新版本新增的配置键用默认值补齐;非法值清洗回落,防止击穿 strict codec。
           config = sanitizeConfig(cfg)
+          if (parsed.openrouterPriceHashes && typeof parsed.openrouterPriceHashes === 'object' && !Array.isArray(parsed.openrouterPriceHashes)) openrouterPriceHashes = parsed.openrouterPriceHashes
           if (parsed.days !== null && typeof parsed.days === 'object' && !Array.isArray(parsed.days)) {
             // 旧账本可能含 reasoning: null 等非法数值:清洗后再入内存,并触发回写覆盖。
             days = sanitizeDays(parsed.days)
@@ -1995,7 +2003,7 @@ export class Ledger {
         console.warn(`[dsh-cost-meter] 账本读取失败,按空账本启动: ${String(error?.message ?? error)}`)
       }
     }
-    const ledger = new Ledger(config, days, path, migrations, { planSamples, planHourBuckets })
+    const ledger = new Ledger(config, days, path, migrations, { planSamples, planHourBuckets, openrouterPriceHashes })
     ledger.balanceRef = balanceRef
     return ledger
   }
@@ -2150,6 +2158,7 @@ export class Ledger {
         migrations: this.migrations,
         planSamples: this.planSamples ?? {},
         planHourBuckets: this.planHourBuckets,
+        openrouterPriceHashes: this.openrouterPriceHashes,
       }), 'utf8')
       renameSync(tmp, this.path)
       this.pendingWrite = false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.7.29",
+  "version": "1.7.30",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(9 家,含 SCNet Token Plan 本地 Credits 计量与火山方舟 Volcano Ark Coding Plan AK/SK 签名查询)、自定义 Provider 余额查询(可配任意 HTTP 端点)与余额进度条、峰谷计价时段显示与切换前弹窗/系统通知提醒(位置/提前量/类型可配),界面中英双语。Session cost tracking plugin for DeepSeek Harness: per-conversation cost, daily totals, history and official price sync, with multi-vendor model pricing (built-in 90+ model catalog with auto-matching), Coding Plan quota queries & display for 9 vendors (incl. local credits metering for the SCNet Token Plan and Volcano Ark Coding Plan via AK/SK signature), plan/API dual-track billing with per-1% & full-window Token Plan usage estimates, custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, plus peak/off-peak pricing display with pre-switch popup & system-notification alerts (position / lead time / type configurable), in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",