dsh-cost-meter 1.5.25 → 1.5.26

package/README.en.md

@@ -6,7 +6,7 @@
 
 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) · 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)
 
-[![version](https://img.shields.io/badge/version-1.5.25-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.26-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![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)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -29,7 +29,7 @@ English | [中文](README.md)
 | Official balance | Sidebar top / Settings page (configurable) | Total / granted / topped-up balance, auto-refresh + manual refresh; optional three-segment progress bar (blue/orange/gray) |
 | Custom provider balance | Sidebar / Settings page (configurable) | Configurable HTTP balance lookup (e.g. LiteLLM); bilingual labels, currency, extract rules; collapsible panel alongside Coding Plan quotas |
 | OpenCode Go quota | Sidebar / Settings / bottom-right dock (configurable) | Rolling-5h / weekly / monthly usage percent and reset times, each window toggleable independently, budget used % can show alongside; key auto-discovered (DSH credential store OPENCODE_GO_API_KEY / env / opencode login) or entered manually |
-| Coding plan quotas | Settings page | Multi-vendor coding-plan quota queries (Anthropic Claude Pro/Max, Z.ai / Zhipu GLM Coding Plan, MiniMax Token Plan, Kimi/Moonshot balance, OpenRouter credits, SiliconFlow balance, CommandCode 5h/weekly windows + monthly credits balance); per-vendor enable switch and key, credentials only sent to official endpoints; neutral hints when no credentials/subscription; SCNet Token Plan has no quota API — monthly usage is estimated from the local ledger via the official credits deduction table (no credentials needed) |
+| Coding plan quotas | Sidebar / Settings page (per vendor) | Multi-vendor coding-plan quota queries (Anthropic Claude Pro/Max, Z.ai / Zhipu GLM Coding Plan, MiniMax Token Plan, Kimi/Moonshot balance, OpenRouter credits, SiliconFlow balance, CommandCode 5h/weekly windows + monthly credits balance); per-vendor enable switch, key and display position (sidebar card in the same box style as the Go quota; the collapsed rail shows percentages), credentials only sent to official endpoints; neutral hints when no credentials/subscription; SCNet Token Plan has no quota API — monthly usage is estimated from the local ledger via the official credits deduction table (no credentials needed) |
 | Today's cost | Sidebar bottom (above the settings button) | “Today ¥x”, hover for call count and token details |
 | Budget box | Sidebar bottom (between the balance row and the settings button) | Rounded-square frame: budget, used %, progress bar, today's cost & share of budget, used/limit; ≥80% warning, ≥100% over-budget |
 | Summary cards | Settings page | Today / this month / cumulative cost and call counts |
@@ -194,22 +194,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.5.25`** — 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.5.26`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.25/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.26/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.5.25
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.26
 ```
 
 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.5.25.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.26.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,7 +6,7 @@
 
 本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet 八家)
 
-[![version](https://img.shields.io/badge/version-1.5.25-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.26-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![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)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -29,7 +29,7 @@
 | 官方余额 | 侧边栏顶部 / 设置页(可配) | 总余额 / 赠送 / 充值,自动刷新 + 手动刷新;可选三段进度条(蓝/橙/灰) |
 | 自定义 Provider 余额 | 侧边栏 / 设置页(可配) | 可配置 HTTP 查询任意 Provider 余额(LiteLLM 等);中/英名称、币种、extract 规则;与 Coding Plan 同区可折叠配置 |
 | OpenCode Go 额度 | 侧边栏 / 设置页 / 右下角(dock,可配) | 滚动 5 小时 / 本周 / 本月用量百分比与重置时间,三档可分别开关,可同时显示预算已用%;Key 自动发现(DSH 凭据库 OPENCODE_GO_API_KEY / 环境变量 / opencode 登录态)或手动填写 |
-| Coding Plan 额度 | 设置页 | 多厂商 coding plan 订阅额度查询(Anthropic Claude Pro/Max、Z.ai/智谱 GLM、MiniMax Token Plan、Kimi/Moonshot 余额、OpenRouter credits、SiliconFlow 余额、CommandCode 5h/周窗口与月度 Credits 余额),各家独立启用开关与 Key,凭据只发往官方端点;无凭据/无订阅为中性提示;SCNet 超算互联网 Token Plan 无 API 额度端点,按官方 Credits 抵扣表由本地账本估算月度用量(无需凭据) |
+| Coding Plan 额度 | 侧边栏 / 设置页(每家可配) | 多厂商 coding plan 订阅额度查询(Anthropic Claude Pro/Max、Z.ai/智谱 GLM、MiniMax Token Plan、Kimi/Moonshot 余额、OpenRouter credits、SiliconFlow 余额、CommandCode 5h/周窗口与月度 Credits 余额),各家独立启用开关、Key 与显示位置(侧边栏卡片与 Go 额度同款,收起窄栏显示百分比),凭据只发往官方端点;无凭据/无订阅为中性提示;SCNet 超算互联网 Token Plan 无 API 额度端点,按官方 Credits 抵扣表由本地账本估算月度用量(无需凭据) |
 | 当日费用 | 侧边栏底部(设置按钮上方) | 「今日 ¥x」,悬停见调用次数与 token 明细 |
 | 预算图框 | 侧边栏底部(余额行与设置按钮之间) | 圆角方形图框:预算、已用%、进度条、今日费用与占预算%、已用/额度,≥80% 预警、≥100% 超支 |
 | 汇总卡片 | 设置页 | 今日 / 本月 / 累计费用与调用次数 |
@@ -196,22 +196,22 @@
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.25`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.26`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.25/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.26/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.25
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.26
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.25.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.26.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/client.js

@@ -266,6 +266,8 @@ window.__ModuleLoader__.load({
       '.cm-mm-row.over .cm-bbox-label,.cm-mm-row.over .cm-bbox-pct{color:var(--dsw-alias-state-error-primary)}',
       '.cm-mm-row.warn .cm-bbox-fill{background:var(--dsw-alias-state-warn-primary)}',
       '.cm-mm-row.over .cm-bbox-fill{background:var(--dsw-alias-state-error-primary)}',
+      '.cm-mm-row.wide .cm-bbox-label{width:auto;max-width:64px;flex:0 1 auto;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+      '.cm-mm-row.wide .cm-mm-text{flex:1;min-width:0;font-size:12px;color:var(--dsw-alias-label-secondary);text-align:right;font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
       '.cm-bal-line{font-size:13px;color:var(--dsw-alias-label-secondary)}',
       '.cm-bal-line.warn{color:var(--dsw-alias-state-warning-primary,#b45309)}',
       '.cm-bal-line.err,.cm-bal-err{color:var(--dsw-alias-state-error-primary)}',
@@ -412,6 +414,8 @@ window.__ModuleLoader__.load({
         codingPlanRemain5h: '5h',
         codingPlanRemain7d: '7d',
         enableCodingPlan: '启用额度查询',
+        codingPlanDisplayLabel: '显示位置',
+        codingPlanDisplayNote: '选「主页面侧边栏 / 两者」后,该厂商额度以图框卡片常驻侧边栏(与 Go 额度/余额同款,收起窄栏显示百分比)。',
         codingPlanKeyLabel: 'API Key(可选,留空自动发现)',
         refreshCodingPlan: '刷新',
         codingPlanNotQueried: '未查询额度',
@@ -745,6 +749,8 @@ window.__ModuleLoader__.load({
         codingPlanRemain5h: '5h',
         codingPlanRemain7d: '7d',
         enableCodingPlan: 'Enable quota queries',
+        codingPlanDisplayLabel: 'Display position',
+        codingPlanDisplayNote: 'With "Main sidebar / Both" selected, this vendor\'s quota shows as a card in the sidebar (same box style as the Go quota / balance; the collapsed rail shows percentages).',
         codingPlanKeyLabel: 'API key (optional; empty = auto-detect)',
         refreshCodingPlan: 'Refresh',
         codingPlanNotQueried: 'Quota not queried',
@@ -2417,6 +2423,61 @@ window.__ModuleLoader__.load({
       return el(MiniMaxPlanCard, { five, seven, fetchedAt: live.fetchedAt, t, wide })
     }
 
+    /** 通用 Coding Plan 侧边栏卡片(issue #31):每窗口一行进度条;文本窗口(余额等)整行文本。 */
+    function codingPlanWindowLabel(name, t) {
+      if (name === 'fiveHour' || name === '5h') return '5h'
+      if (name === 'weekly' || name === 'week' || name === '7d') return name === '7d' ? '7d' : t('goShortWeekly')
+      if (name === 'monthly' || name === 'month') return t('goShortMonthly')
+      return String(name).replace(/_/g, ' ')
+    }
+
+    function CodingPlanBox(props) {
+      const { id, state, wide } = props
+      const live = state.codingPlans?.[id]
+      const t = makeT(resolveLocale(state.config?.locale))
+      const rowDef = CODING_PLAN_ROWS.find(r => r.id === id)
+      if (!rowDef || !live || live.status !== 'ok') return null
+      const windows = live.windows !== null && typeof live.windows === 'object' ? live.windows : {}
+      const entries = Object.entries(windows)
+      if (entries.length === 0) return null
+      const pctOf = win => win !== null && typeof win === 'object' && typeof win.percent === 'number'
+        ? Math.max(0, Math.min(100, Math.round(Number(win.percent) || 0))) : null
+      const rows = entries.map(([name, win]) => {
+        const pct = pctOf(win)
+        if (pct === null) {
+          return el('div', { key: name, className: 'cm-mm-row wide' },
+            el('span', { className: 'cm-mm-text' }, typeof win?.text === 'string' ? win.text : '—'))
+        }
+        const level = pct >= 100 ? 'over' : pct >= 80 ? 'warn' : 'ok'
+        return el('div', { key: name, className: 'cm-mm-row wide' + (level === 'ok' ? '' : ' ' + level) },
+          el('span', { className: 'cm-bbox-label' }, codingPlanWindowLabel(name, t)),
+          el('div', { className: 'cm-bbox-bar' },
+            el('div', { className: 'cm-bbox-fill', style: { width: pct + '%' } })),
+          el('span', { className: 'cm-bbox-pct cm-num' }, pct + '%'))
+      })
+      const detailParts = entries.map(([name, win]) => {
+        const pct = pctOf(win)
+        const reset = typeof win?.resetsAt === 'string' && win.resetsAt.length > 0
+          ? ' · ' + t('goResetAt', { time: new Date(win.resetsAt).toLocaleString() }) : ''
+        const value = pct === null ? (typeof win?.text === 'string' ? win.text : '—') : pct + '%'
+        return codingPlanWindowLabel(name, t) + ' ' + value + reset
+      })
+      if (live.fetchedAt > 0) detailParts.push(t('goQuotaFetchedAt', { time: new Date(live.fetchedAt).toLocaleTimeString() }))
+      const detail = [t(rowDef.labelKey), ...detailParts].join('; ')
+      const pcts = entries.map(([, win]) => pctOf(win)).filter(p => p !== null)
+      const level = pcts.some(p => p >= 100) ? 'over' : pcts.some(p => p >= 80) ? 'warn' : 'ok'
+      const railText = pcts.length > 0
+        ? pcts.slice(0, 2).map(p => p + '%').join(' ')
+        : (typeof entries[0][1]?.text === 'string' ? entries[0][1].text : '—')
+      return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
+        el('div', { className: 'cm-bbox cm-mm' + (level === 'ok' ? '' : ' ' + level) + (wide === false ? ' rail' : '') },
+          wide === false
+            ? el('div', { className: 'cm-bbox-rail cm-num' }, railText)
+            : el(Fragment, null,
+              el('div', { className: 'cm-mm-title' }, t(rowDef.labelKey)),
+              ...rows)))
+    }
+
     function BudgetBoxContent(props) {
       const { state, wide } = props
       const today = state.today
@@ -2530,20 +2591,31 @@ window.__ModuleLoader__.load({
       const goOk = (config.goQuota?.enabled !== false)
         && (config.goQuota?.display === 'sidebar' || config.goQuota?.display === 'both')
         && state.goQuota?.status === 'ok' && state.goQuota?.[goMainKey] !== null
-      const mmLive = state.codingPlans?.minimax
-      const mmWins = miniMaxWindowsOf(mmLive?.windows)
-      const mmOk = config.codingPlans?.minimax?.enabled === true
-        && mmLive?.status === 'ok'
-        && (mmWins.five != null || mmWins.seven != null)
+      // Coding Plan 侧边栏卡片(issue #31):每家按 display 门控(侧边栏/两者),启用且查询成功才展示;
+      // MiniMax 沿用专用 5h/7d 余量卡片,其余厂商走通用 CodingPlanBox。
+      const sidebarPlanIds = CODING_PLAN_ROWS
+        .map(r => r.id)
+        .filter(id => {
+          const entry = config.codingPlans?.[id]
+          if (entry?.enabled !== true) return false
+          if (entry.display !== 'sidebar' && entry.display !== 'both') return false
+          const live = state.codingPlans?.[id]
+          if (live?.status !== 'ok') return false
+          const wins = live.windows !== null && typeof live.windows === 'object' ? live.windows : {}
+          return Object.keys(wins).length > 0
+        })
+      const plansOn = sidebarPlanIds.length > 0
       const budgetOn = (config.budget ?? {}).enabled === true
       const showToday = config.sidebar !== false
-      if (!showBalance && !showCustomBalance && !goOk && !mmOk && !budgetOn && !showToday) return null
+      if (!showBalance && !showCustomBalance && !goOk && !plansOn && !budgetOn && !showToday) return null
       const nodes = []
       if (showBalanceBar) nodes.push(el(BalanceBox, { state, wide }))
       else if (showBalance) nodes.push(el(BalanceRowContent, { state, wide }))
       if (showCustomBalanceBar) nodes.push(el(CustomBalanceBox, { state, wide }))
       else if (showCustomBalance) nodes.push(el(CustomBalanceRowContent, { state, wide }))
-      if (mmOk) nodes.push(el(MiniMaxPlanBox, { state, wide }))
+      if (plansOn) nodes.push(...sidebarPlanIds.map(id => id === 'minimax'
+        ? el(MiniMaxPlanBox, { state, wide })
+        : el(CodingPlanBox, { id, state, wide })))
       if (goOk && budgetOn && wide) {
         // 同时出现:合并为一张卡片(Go 在上、预算在下,细分隔线),各自保留预警色与自己的详细信息开关。
         const goView = goBoxBody(state, config, t)
@@ -3779,6 +3851,18 @@ window.__ModuleLoader__.load({
               }),
               el('span', null, t('enableCodingPlan'))),
             el('button', { className: 'cm-btn small', onClick: () => { void doRefresh(id) }, disabled: busyId !== null || enabled === false }, busyId === id ? t('refreshing') : t('refreshCodingPlan'))),
+          enabled ? el('div', { className: 'cm-field' },
+            el('label', null, t('codingPlanDisplayLabel')),
+            el('select', {
+              className: 'cm-input',
+              value: typeof cfgEntry.display === 'string' ? cfgEntry.display : (id === 'minimax' ? 'both' : 'settings'),
+              onChange: event => setPlan(id, 'display', event.target.value),
+            },
+              el('option', { value: 'sidebar' }, t('balanceSidebar')),
+              el('option', { value: 'settings' }, t('balanceSettings')),
+              el('option', { value: 'both' }, t('balanceBoth')),
+              el('option', { value: 'off' }, t('off'))),
+            el('span', { className: 'cm-hint' }, t('codingPlanDisplayNote'))) : null,
           enabled ? (id === 'scnet'
             ? el(Fragment, null,
               el('div', { className: 'cm-field' },

package/lib/store.js

@@ -72,7 +72,9 @@ export function defaultConfig() {
       // 各家 coding plan 额度查询(默认关闭;开启后按 Key 发现链查询并在设置页展示)。
       anthropic: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
       zai: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
-      minimax: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
+      // MiniMax 自引入起即是「启用即在侧边栏展示 5h/7d 卡片」,显示位置配置落地后默认 both 保持该惯例;
+      // 其余厂商默认 settings(仅设置页),按需在设置页切换(issue #31)。
+      minimax: { enabled: false, display: 'both', refreshMinutes: 15, apiKey: '' },
       kimi: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
       openrouter: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
       siliconflow: { enabled: false, display: 'settings', refreshMinutes: 15, apiKey: '' },
@@ -730,6 +732,23 @@ export function sanitizeConfig(raw) {
   return out
 }
 
+/**
+ * 一次性配置迁移(账本根 migrations 标记,已应用过的不再重跑,因此不会覆盖用户后续的显式选择)。
+ * 只处理「旧版本无对应配置项、行为与新版本语义不符」的场景;迁移在 sanitizeConfig 之前对原始配置执行。
+ */
+const CONFIG_MIGRATIONS = [
+  {
+    id: 'v1.5.26-coding-plan-sidebar-display',
+    // v1.5.26 前 coding plan 无显示位置 UI:MiniMax 启用即在侧边栏展示卡片,而 schema 恒把 display
+    // 清洗为默认 'settings'(当时无 UI 可改,存量值必为 schema 默认而非用户选择)。迁移为 'both'
+    // 保持旧版「启用 = 侧边栏 + 设置页」的实际行为;其余厂商旧行为本就是仅设置页,无需迁移。
+    apply(cfg) {
+      const mm = cfg?.codingPlans?.minimax
+      if (mm !== null && typeof mm === 'object' && !Array.isArray(mm) && mm.enabled === true) mm.display = 'both'
+    },
+  },
+]
+
 /**
  * 账本状态容器。所有聚合写内存,持久化走防抖原子写。
  */
@@ -738,8 +757,9 @@ export class Ledger {
    * @param config - 初始配置(默认值或已持久化配置)。
    * @param days - 已持久化的每日记录对象(date → day)。
    * @param path - 账本文件路径。
+   * @param migrations - 已应用的一次性迁移 id 列表(随账本落盘)。
    */
-  constructor(config, days, path) {
+  constructor(config, days, path, migrations = []) {
     this.config = config
     this.days = days
     this.path = path
@@ -748,6 +768,7 @@ export class Ledger {
     this.pendingWrite = false
     // 余额差对账参考点({ date, total, granted, topped, at }),由 open() 载入、flush() 落盘。
     this.balanceRef = null
+    this.migrations = Array.isArray(migrations) ? migrations.filter(m => typeof m === 'string') : []
   }
 
   /** 在 $DSH_HOME 下创建/加载账本。 */
@@ -757,6 +778,7 @@ export class Ledger {
     let config = defaultConfig()
     let days = {}
     let balanceRef = null
+    let migrations = []
     try {
       const parsed = JSON.parse(readFileSync(path, 'utf8'))
       if (parsed !== null && typeof parsed === 'object') {
@@ -764,6 +786,14 @@ export class Ledger {
           console.warn(`[dsh-cost-meter] 账本版本 ${String(parsed.version)} 不受支持,按空账本启动`)
         } else {
           const cfg = typeof parsed.config === 'object' && parsed.config !== null ? parsed.config : {}
+          // 一次性迁移:先于清洗对原始配置执行,已应用过的(账本 migrations 标记)跳过。
+          migrations = Array.isArray(parsed.migrations) ? parsed.migrations.filter(m => typeof m === 'string') : []
+          const applied = new Set(migrations)
+          for (const migration of CONFIG_MIGRATIONS) {
+            if (applied.has(migration.id)) continue
+            migration.apply(cfg)
+            migrations.push(migration.id)
+          }
           // 新版本新增的配置键用默认值补齐;非法值清洗回落,防止击穿 strict codec。
           config = sanitizeConfig(cfg)
           if (parsed.days !== null && typeof parsed.days === 'object' && !Array.isArray(parsed.days)) {
@@ -785,7 +815,7 @@ export class Ledger {
         console.warn(`[dsh-cost-meter] 账本读取失败,按空账本启动: ${String(error?.message ?? error)}`)
       }
     }
-    const ledger = new Ledger(config, days, path)
+    const ledger = new Ledger(config, days, path, migrations)
     ledger.balanceRef = balanceRef
     return ledger
   }
@@ -903,7 +933,7 @@ export class Ledger {
     try {
       mkdirSync(dirname(this.path), { recursive: true })
       const tmp = `${this.path}.tmp`
-      writeFileSync(tmp, JSON.stringify({ version: LEDGER_VERSION, config: this.config, days: this.days, balanceRef: this.balanceRef ?? null }), 'utf8')
+      writeFileSync(tmp, JSON.stringify({ version: LEDGER_VERSION, config: this.config, days: this.days, balanceRef: this.balanceRef ?? null, migrations: this.migrations }), 'utf8')
       renameSync(tmp, this.path)
     } catch (error) {
       console.warn(`[dsh-cost-meter] 账本写入失败: ${String(error?.message ?? error)}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.25",
+  "version": "1.5.26",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(7 家,含 SCNet Token Plan 本地 Credits 计量)、自定义 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 7 vendors (incl. local credits metering for the SCNet Token Plan), 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",