dsh-cost-meter 1.5.14 → 1.5.16

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) · 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)
 
-[![version](https://img.shields.io/badge/version-1.5.14-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.16-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)
@@ -36,10 +36,11 @@ English | [中文](README.md)
 | Token usage stats | Settings page (Cost section) | All-time token totals (input/cache/output/calls) + a Codex-style 26-week daily usage heat grid that fills the settings width; hover a cell for that day's detail |
 | Today's sessions | Settings page | Per-session call count, input/cache/output tokens and cost |
 | History | Settings page | Per-day totals; retention days configurable (default 180) |
-| Pre-install history import | Settings page (Data & sync) | One-click replay of all host session logs to import conversations from before the plugin was installed (missing dates are rebuilt whole; existing dates only gain previously unknown sessions; idempotent and never double-counts live metering; costs priced at per-event historical rates) |
+| Pre-install history import | Automatic on first launch | After install/upgrade, the first launch automatically replays all host session logs to import conversations from before the plugin was installed (missing dates are rebuilt whole; existing dates only gain previously unknown sessions; idempotent and never double-counts live metering; costs priced at per-event historical rates); a manual re-run entry remains in Settings |
 | Budget settings | Settings page, top | Limit, period (today / month / cumulative / custom date range), used % |
 | Price table | Settings page | Per-model off-peak / peak prices (input/output shorthand supported; cache prices derived automatically); fully editable |
 | Peak/off-peak hours display | Settings / budget / today | Shows UTC peak hours 01:00–04:00 and 06:00–10:00 with the current tier; expanded view shows a peak/off-peak period strip (current period + countdown), collapsed (rail) view shows a vertical peak/off-peak progress bar; independently toggleable |
+| Peak/off-peak switch popup alert | Global overlay | A bottom-right popup appears when the next tier switch is within the configured lead time (default 2 minutes, 1–30); alert type selectable (entering peak / entering off-peak / both); one alert per switch point; toggle lives in the peak pricing panel in Settings |
 | Official price sync | Settings page | Fetches and parses the official pricing page, applies with one click |
 | UI language | Settings → Display settings | Simplified Chinese / English / Follow browser (auto); switches instantly and auto-saves |
 | AI price sync | [prompt](docs/AI-PRICE-SYNC-PROMPT.en.md) | DeepSeek official sync; other providers use the verified official price catalog and manual configuration |
@@ -192,22 +193,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.14`** — 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.16`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.14/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.16/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.14
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.16
 ```
 
 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.14.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.16.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 六家)
 
-[![version](https://img.shields.io/badge/version-1.5.14-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.16-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)
@@ -37,10 +37,11 @@
 | 今日会话明细 | 设置页 | 每个会话的调用次数、输入/缓存/输出 token 与费用 |
 | 历史记录 | 设置页 | 按天汇总,保留天数可配(默认 180 天) |
 | 历史按模型统计回填 | 设置页(按模型统计) | 按模型统计上线前的旧账本自动回放宿主会话日志重建逐模型 token/费用拆分(旧调用按当时基础价),日志已清理的部分归入「早期未分模型」残差行 |
-| 导入安装前历史 | 设置页(数据与同步) | 一键回放宿主全部会话日志,把未装插件时期的对话导入账本(缺失日期整日重建,已有日期只补未知会话,幂等不与实时计费重复;金额按事件时刻历史价回推) |
+| 导入安装前历史 | 首次启动自动 | 安装/升级后首次启动自动回放宿主全部会话日志,把未装插件时期的对话导入账本(缺失日期整日重建,已有日期只补未知会话,幂等不与实时计费重复;金额按事件时刻历史价回推);设置页保留手动重跑入口 |
 | 预算设置 | 设置页顶部 | 额度、周期(今日/本月/累计/自定义日期区间)、已用% |
 | 价格表 | 设置页 | 每模型 谷时/峰时 两档价格(支持 input/output 简写,缓存价自动补齐),增删改自由 |
 | 峰谷计价时段显示 | 设置页 / 预算 / 今日费用 | 显示 UTC 峰时段 01:00–04:00、06:00–10:00 与当前档位;展开态显示峰时/平价时段条(当前时段 + 倒计时),收起(rail)态显示竖向峰谷进度条,可单独开关 |
+| 峰/谷切换弹窗提醒 | 全局浮层 | 距进入峰/谷时段不足设定提前量(默认 2 分钟,1-30 可配)时右下角弹窗提醒;提醒类型可选(进入峰 / 进入谷 / 峰和谷),同一切换点只提醒一次,设置页峰谷计价面板内开关 |
 | 官方价格同步 | 设置页 | 抓取解析官方定价页,一键应用 |
 | 界面语言 | 设置页 → 显示设置 | 简体中文 / English / 跟随浏览器(自动);切换即时生效并自动保存 |
 | AI 价格同步 | [提示词](docs/AI-PRICE-SYNC-PROMPT.md) | DeepSeek 官方同步;其他 provider 使用已核对的官方价格目录与手动配置 |
@@ -194,22 +195,22 @@
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.14`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.16`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.14/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.16/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.14
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.16
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.14.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.16.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/client.js

@@ -110,6 +110,13 @@ window.__ModuleLoader__.load({
       '.cm-msg.err{color:var(--dsw-alias-state-error-primary)}',
       '.cm-hint{font-size:12px;color:var(--dsw-alias-label-tertiary)}',
       '.cm-budget{border:1px solid var(--dsw-alias-border-l1);border-radius:12px;padding:14px 16px;background:var(--dsw-alias-bg-layer-1);display:flex;flex-direction:column;gap:10px}',
+      '.cm-peak-alert{position:fixed;right:20px;bottom:20px;z-index:9999;max-width:320px;padding:12px 14px;border-radius:10px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);box-shadow:0 8px 24px rgba(0,0,0,.18);display:flex;flex-direction:column;gap:6px;font-size:12px;animation:cm-peak-alert-in .18s ease-out}',
+      '.cm-peak-alert-peak{border-left:3px solid #f59e0b}',
+      '.cm-peak-alert-offpeak{border-left:3px solid var(--dsw-alias-brand-primary)}',
+      '.cm-peak-alert-title{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary)}',
+      '.cm-peak-alert-body{color:var(--dsw-alias-label-secondary);line-height:1.5}',
+      '.cm-peak-alert-actions{display:flex;justify-content:flex-end}',
+      '@keyframes cm-peak-alert-in{from{opacity:0;transform:translateY(8px)}to{opacity:1;transform:translateY(0)}}',
       '.cm-budget-head{display:flex;align-items:center;justify-content:space-between;gap:8px}',
       '.cm-budget-bar{height:8px;border-radius:999px;background:var(--dsw-alias-bg-layer-3);overflow:hidden}',
       '.cm-budget-fill{height:100%;border-radius:999px;background:var(--dsw-alias-state-business-primary);transition:width .3s ease}',
@@ -422,6 +429,18 @@ window.__ModuleLoader__.load({
         peakStyleLabel: '峰谷时段条样式',
         peakStyleCompact: '简洁(单行紧凑)',
         peakStyleClassic: '经典(分段与胶囊芯片)',
+        peakAlertLabel: '峰/谷切换前弹窗提醒',
+        peakAlertAheadLabel: '提前提醒(分钟,1-30)',
+        peakAlertTargetLabel: '提醒类型',
+        peakAlertTargetPeak: '进入峰时',
+        peakAlertTargetOffPeak: '进入谷时',
+        peakAlertTargetBoth: '峰和谷',
+        peakAlertTitlePeak: '即将进入峰时',
+        peakAlertTitleOffPeak: '即将进入谷时',
+        peakAlertBody: '约 {time} 后计费档位切换为{phase}价,请注意本时段调用成本。',
+        peakAlertPhasePeak: '峰时',
+        peakAlertPhaseOffPeak: '谷时',
+        peakAlertBtn: '知道了',
         peakPanelTitle: '峰谷计价与提示',
         peakNoticeHiddenHint: '提示已隐藏:需启用峰谷计价并开启「峰时高价时段显著提示」。',
         groupGeneral: '常规',
@@ -557,7 +576,7 @@ window.__ModuleLoader__.load({
         importLegacy: '导入安装前历史',
         confirmImportLegacy: '确认导入?将回放全部会话日志,只补账本缺失的日期与会话,不影响已有记录。',
         legacyImportFailed: '导入安装前历史失败:{message}',
-        legacyImportNote: '按当前价目表回推历史费用;已清理的日志无法回放,同一会话跨安装时刻时其安装前用量不计入。',
+        legacyImportNote: '插件首次启动后会自动导入一次安装前历史;此处可手动重跑(如后续拷入了旧日志)。金额按当前价目表回推,已清理的日志无法回放,同一会话跨安装时刻时其安装前用量不计入。',
         confirmClear: '确认清除',
         clearAllHistory: '清除全部历史',
         lastSync: '最近同步:{time}',
@@ -723,6 +742,18 @@ window.__ModuleLoader__.load({
         peakStyleLabel: 'Peak period strip style',
         peakStyleCompact: 'Compact (one-line)',
         peakStyleClassic: 'Classic (segments & chip)',
+        peakAlertLabel: 'Popup alert before peak/off-peak switch',
+        peakAlertAheadLabel: 'Lead time (minutes, 1-30)',
+        peakAlertTargetLabel: 'Alert type',
+        peakAlertTargetPeak: 'Entering peak',
+        peakAlertTargetOffPeak: 'Entering off-peak',
+        peakAlertTargetBoth: 'Both',
+        peakAlertTitlePeak: 'Entering peak hours soon',
+        peakAlertTitleOffPeak: 'Entering off-peak hours soon',
+        peakAlertBody: 'Billing switches to {phase} pricing in about {time}; mind your call costs in this window.',
+        peakAlertPhasePeak: 'peak',
+        peakAlertPhaseOffPeak: 'off-peak',
+        peakAlertBtn: 'Got it',
         peakPanelTitle: 'Peak/off-peak pricing & notice',
         peakNoticeHiddenHint: 'Notice hidden: enable peak/off-peak pricing and the “prominent notice” toggle.',
         groupGeneral: 'General',
@@ -858,7 +889,7 @@ window.__ModuleLoader__.load({
         importLegacy: 'Import pre-install history',
         confirmImportLegacy: 'Confirm import? Replays all session logs and only fills dates/sessions missing from the ledger; existing records are untouched.',
         legacyImportFailed: 'Failed to import pre-install history: {message}',
-        legacyImportNote: 'Historical costs are estimated with the current price catalog; cleaned logs cannot be replayed, and for a session spanning the install moment its pre-install usage is not counted.',
+        legacyImportNote: 'Pre-install history is imported automatically once on first launch; this button re-runs it manually (e.g. after copying in old logs). Costs are estimated with the current price catalog; cleaned logs cannot be replayed, and for a session spanning the install moment its pre-install usage is not counted.',
         confirmClear: 'Confirm clear',
         clearAllHistory: 'Clear all history',
         lastSync: 'Last sync: {time}',
@@ -1024,6 +1055,9 @@ window.__ModuleLoader__.load({
           ? v.peakWindows.map((w, i) => ({ start: needNum(w.start, path + '.peakWindows[' + i + '].start'), end: needNum(w.end, path + '.peakWindows[' + i + '].end') }))
           : [],
         peakNotice: v.peakNotice !== false,
+        peakAlertEnabled: v.peakAlertEnabled !== false,
+        peakAlertAhead: Number.isFinite(v.peakAlertAhead) && v.peakAlertAhead >= 1 && v.peakAlertAhead <= 30 ? v.peakAlertAhead : 2,
+        peakAlertTarget: v.peakAlertTarget === 'peak' || v.peakAlertTarget === 'offpeak' ? v.peakAlertTarget : 'both',
         peakStyle: v.peakStyle === 'classic' ? 'classic' : 'compact',
         priceMatch: v.priceMatch === 'exact' ? 'exact' : 'auto',
         priceOverrides: (() => {
@@ -1954,6 +1988,43 @@ window.__ModuleLoader__.load({
         : t('countdownMinute', { m: minutes })
     }
 
+    /**
+     * 峰/谷切换前弹窗提醒:距下次相位切换不足配置提前量(默认 2 分钟)时,
+     * 右下角弹全局浮层;提醒类型按配置过滤(进入峰/进入谷/峰和谷);
+     * 同一切换点只弹一次(手动关闭即记点),切换完成后浮层自然消失。
+     */
+    function PeakAlert(props) {
+      const costStore = props.useCost ? props.useCost(s => s) : undefined
+      const config = costStore?.state?.config
+      const [now, setNow] = useState(Date.now())
+      const [dismissedAt, setDismissedAt] = useState(null)
+      useEffect(() => {
+        const timer = window.setInterval(() => setNow(Date.now()), 10000)
+        return () => window.clearInterval(timer)
+      }, [])
+      if (!config || config.peakAlertEnabled !== true || config.peakEnabled !== true) return null
+      const effectiveAtMs = Date.parse(config.peakEffectiveAt || '')
+      if (Number.isFinite(effectiveAtMs) && now < effectiveAtMs) return null
+      const view = peakPhaseAt(now, Array.isArray(config.peakWindows) ? config.peakWindows : [])
+      if (view === null) return null
+      const target = config.peakAlertTarget === 'peak' || config.peakAlertTarget === 'offpeak' ? config.peakAlertTarget : 'both'
+      if (target !== 'both' && target !== (view.nextIntoPeak ? 'peak' : 'offpeak')) return null
+      const aheadMinutes = Number(config.peakAlertAhead)
+      const aheadMs = (Number.isFinite(aheadMinutes) && aheadMinutes >= 1 ? aheadMinutes : 2) * 60000
+      if (now < view.nextAtMs - aheadMs || now >= view.nextAtMs) return null
+      if (dismissedAt === view.nextAtMs) return null
+      const t = makeT(resolveLocale(config.locale))
+      const intoPeak = view.nextIntoPeak === true
+      return el('div', { className: 'cm-peak-alert ' + (intoPeak ? 'cm-peak-alert-peak' : 'cm-peak-alert-offpeak'), role: 'alert' },
+        el('div', { className: 'cm-peak-alert-title' }, t(intoPeak ? 'peakAlertTitlePeak' : 'peakAlertTitleOffPeak')),
+        el('div', { className: 'cm-peak-alert-body' }, t('peakAlertBody', {
+          time: countdownText(view, now, t),
+          phase: t(intoPeak ? 'peakAlertPhasePeak' : 'peakAlertPhaseOffPeak'),
+        })),
+        el('div', { className: 'cm-peak-alert-actions' },
+          el('button', { className: 'cm-btn', onClick: () => setDismissedAt(view.nextAtMs) }, t('peakAlertBtn'))))
+    }
+
     /** 展开态简洁样式:单行紧凑时段条——细轨道(左橙右蓝,非当前段淡化)+ 标记线 + 右侧倒计时文本。 */
     function PeakStrip(props) {
       const { config, t } = props
@@ -2718,6 +2789,35 @@ window.__ModuleLoader__.load({
             },
               el('option', { value: 'compact' }, t('peakStyleCompact')),
               el('option', { value: 'classic' }, t('peakStyleClassic'))))),
+        el('div', { className: 'cm-grid' },
+          el('div', { className: 'cm-field' },
+            el('label', { className: 'cm-check' },
+              el('input', {
+                type: 'checkbox',
+                checked: draft?.peakAlertEnabled !== false,
+                onChange: event => setField('peakAlertEnabled', event.target.checked),
+              }),
+              el('span', null, t('peakAlertLabel')))),
+          el('div', { className: 'cm-field' },
+            el('label', null, t('peakAlertAheadLabel')),
+            el('input', {
+              className: 'cm-input narrow', type: 'number', min: '1', max: '30', step: '1',
+              value: String(typeof draft?.peakAlertAhead === 'number' && Number.isFinite(draft.peakAlertAhead) && draft.peakAlertAhead >= 1 && draft.peakAlertAhead <= 30 ? draft.peakAlertAhead : 2),
+              onChange: event => {
+                const parsed = Number(event.target.value)
+                if (Number.isInteger(parsed) && parsed >= 1 && parsed <= 30) setField('peakAlertAhead', parsed)
+              },
+            })),
+          el('div', { className: 'cm-field' },
+            el('label', null, t('peakAlertTargetLabel')),
+            el('select', {
+              className: 'cm-input',
+              value: draft?.peakAlertTarget === 'peak' || draft?.peakAlertTarget === 'offpeak' ? draft.peakAlertTarget : 'both',
+              onChange: event => setField('peakAlertTarget', event.target.value),
+            },
+              el('option', { value: 'both' }, t('peakAlertTargetBoth')),
+              el('option', { value: 'peak' }, t('peakAlertTargetPeak')),
+              el('option', { value: 'offpeak' }, t('peakAlertTargetOffPeak'))))),
         el('div', { className: 'cm-peak-preview' },
           draft?.peakEnabled !== false && draft?.peakNotice !== false
             ? peakNoticeEl(state, previewConfig, t)
@@ -4406,6 +4506,26 @@ window.__ModuleLoader__.load({
         })
       }
 
+      // 峰/谷切换前弹窗提醒:全局 fixed 浮层,挂在 dock 插槽常驻渲染,组件内部
+      // 再按配置门控(peakAlertEnabled + peakEnabled);开关变化时重挂/卸载。
+      const peakAlertActive = { gen: 0, dispose: null }
+      const registerPeakAlert = enabled => {
+        if (peakAlertActive.dispose !== null) { peakAlertActive.dispose(); peakAlertActive.dispose = null }
+        peakAlertActive.gen += 1
+        const gen = peakAlertActive.gen
+        if (!enabled) return
+        slots.inject('conversation.composer.dock', () => {
+          if (peakAlertActive.gen !== gen) return
+          const dispose = slots.register({ name: 'conversation.composer.dock', id: 'cost-meter-peak-alert', order: 8, inject: injected }, PeakAlert)
+          if (peakAlertActive.gen !== gen) { dispose(); return }
+          peakAlertActive.dispose = dispose
+          return () => {
+            if (peakAlertActive.dispose === dispose) peakAlertActive.dispose = null
+            dispose()
+          }
+        })
+      }
+
       // 设置页「费用/Cost」分节:语言变化时撤销旧注册并重建,让侧边栏标签同步。
       const sectionActive = { gen: 0, dispose: null }
       const registerSection = locale => {
@@ -4478,6 +4598,7 @@ window.__ModuleLoader__.load({
       let lastCorner = null
       let lastSectionLocale = null
       let lastUsagePosition = null
+      let lastPeakAlert = null
       const sync = () => {
         const state = store.getSnapshot().state
         const position = state?.config?.position ?? 'dock'
@@ -4500,6 +4621,11 @@ window.__ModuleLoader__.load({
           registerCorner(cornerEnabled)
           lastCorner = cornerEnabled
         }
+        const peakAlertOn = state?.config?.peakAlertEnabled !== false && state?.config?.peakEnabled === true
+        if (peakAlertOn !== lastPeakAlert) {
+          registerPeakAlert(peakAlertOn)
+          lastPeakAlert = peakAlertOn
+        }
         if (sectionLocale !== lastSectionLocale) {
           registerSection(sectionLocale)
           lastSectionLocale = sectionLocale

package/lib/index.js

@@ -1017,6 +1017,34 @@ function createService(ctx, ledger) {
 
 // ── 插件主体 ───────────────────────────────────────────────────────────────
 
+/**
+ * 启动期历史导入(issue #27):先做按模型回填,再在**本插件首次启动**(config
+ * 标记 legacyAutoImportedAt 为 0)时自动导入一次安装前历史——用户无需手动触
+ * 发;之后每次启动只跑回填,自动导入不再重复。导出供测试直接调用。
+ * @param ledger - 已打开的账本。
+ * @param sessionsRoot - 宿主会话根目录($DSH_HOME/sessions)。
+ */
+export async function runStartupImports(ledger, sessionsRoot) {
+  const filled = await backfillLegacyLedger(ledger, sessionsRoot)
+  if (filled.days > 0 || filled.sessions > 0 || filled.titles > 0) {
+    const extras = [
+      filled.days > 0 || filled.sessions > 0 ? `${filled.days} 天 / ${filled.sessions} 个会话` : null,
+      filled.titles > 0 ? `${filled.titles} 个会话标题` : null,
+      filled.recosted > 0 ? `重算 ${filled.recosted} 天金额` : null,
+    ].filter(Boolean).join(',')
+    console.log(`[dsh-cost-meter] 历史按模型统计回填完成:${extras}(扫描 ${filled.scanned} 份会话日志)`)
+  }
+  if (!(Number(ledger.config?.legacyAutoImportedAt) > 0)) {
+    const stats = await importLegacyHistory(ledger, sessionsRoot)
+    if (stats.days > 0 || stats.sessions > 0) {
+      console.log(`[dsh-cost-meter] 安装前历史自动导入完成:${stats.days} 天 / ${stats.sessions} 个会话(扫描 ${stats.scanned} 份会话日志)`)
+    }
+    // 无论是否有可导入内容都打标:空结果同样视为已完成,避免每次启动重扫。
+    ledger.config.legacyAutoImportedAt = Date.now()
+    ledger.scheduleWrite()
+  }
+}
+
 /**
  * 挂载账本、llm/stream 计费包裹、会话投影与 costMeter 服务。
  * @param ctx - 宿主插件上下文。
@@ -1028,20 +1056,11 @@ export function apply(ctx) {
   // 卸载/退出前最终落盘。
   ctx.effect(() => () => ledger.close(), 'cost-meter: ledger close')
 
-  // 历史账本按模型回填:按模型统计上线前的日期只有合计,启动后延迟回放
-  // 宿主会话日志填补空 byProviderModel(幂等,只填空条目,不重复计数)。
+  // 历史账本按模型回填 + 首次启动自动导入安装前历史(issue #27):
+  // 启动后延迟执行,避免拖慢宿主启动;均幂等,只补缺失,不重复计数。
   const backfillTimer = setTimeout(() => {
-    backfillLegacyLedger(ledger, join(resolveDshHome(), 'sessions')).then(filled => {
-      if (filled.days > 0 || filled.sessions > 0 || filled.titles > 0) {
-        const extras = [
-          filled.days > 0 || filled.sessions > 0 ? `${filled.days} 天 / ${filled.sessions} 个会话` : null,
-          filled.titles > 0 ? `${filled.titles} 个会话标题` : null,
-          filled.recosted > 0 ? `重算 ${filled.recosted} 天金额` : null,
-        ].filter(Boolean).join(',')
-        console.log(`[dsh-cost-meter] 历史按模型统计回填完成:${extras}(扫描 ${filled.scanned} 份会话日志)`)
-      }
-    }, error => {
-      console.warn(`[dsh-cost-meter] 历史按模型统计回填失败: ${String(error?.message ?? error)}`)
+    runStartupImports(ledger, join(resolveDshHome(), 'sessions')).catch(error => {
+      console.warn(`[dsh-cost-meter] 启动期历史导入失败: ${String(error?.message ?? error)}`)
     })
   }, 3000)
   backfillTimer.unref?.()

package/lib/store.js

@@ -38,7 +38,11 @@ export function defaultConfig() {
     peakEffectiveAt: DEFAULT_PEAK_EFFECTIVE_AT,
     peakWindows: DEFAULT_PEAK_WINDOWS.map(w => ({ ...w })),
     peakNotice: true, // 峰时高价时段显著提示(侧边栏预算框/今日费用/设置页预算面板)
+    peakAlertEnabled: true, // 峰/谷切换前弹窗提醒(全局浮层)
+    peakAlertAhead: 2, // 提前提醒量(分钟,1-30)
+    peakAlertTarget: 'both', // 提醒类型:peak(进入峰) | offpeak(进入谷) | both(峰和谷)
     showSessionId: false, // 会话列表中附显会话 ID(默认只显示标题,需要时开启)
+    legacyAutoImportedAt: 0, // 安装前历史自动导入标记(issue #27):完成时刻 ms;0 = 尚未跑过
     peakStyle: 'compact', // 峰谷时段条样式:compact(简洁单行/竖向同构) | classic(经典分段/胶囊芯片)
     priceMatch: 'auto', // 未知模型名自动匹配价格表:auto(去后缀/前缀/家族相似) | exact(仅精确)
     priceOverrides: {}, // 手动匹配覆盖:{ 'provider:modelId': '同provider模型 | provider:模型 | deepseek:__default__' }
@@ -220,6 +224,9 @@ const VALIDATION_MESSAGES = {
     peakEffectiveAt: 'peakEffectiveAt 非法',
     peakWindows: 'peakWindows 必须是数组',
     peakNotice: 'peakNotice 必须是布尔值',
+    peakAlertEnabled: 'peakAlertEnabled 必须是布尔值',
+    peakAlertAhead: 'peakAlertAhead 必须是 1-30 的整数',
+    peakAlertTarget: 'peakAlertTarget 必须是 peak / offpeak / both',
     showSessionId: 'showSessionId 必须是布尔值',
     peakStyle: 'peakStyle 必须是 compact / classic',
     priceMatch: 'priceMatch 必须是 auto / exact',
@@ -281,6 +288,9 @@ const VALIDATION_MESSAGES = {
     peakEffectiveAt: 'Invalid peakEffectiveAt',
     peakWindows: 'peakWindows must be an array',
     peakNotice: 'peakNotice must be a boolean',
+    peakAlertEnabled: 'peakAlertEnabled must be a boolean',
+    peakAlertAhead: 'peakAlertAhead must be an integer between 1 and 30',
+    peakAlertTarget: 'peakAlertTarget must be peak / offpeak / both',
     showSessionId: 'showSessionId must be a boolean',
     peakStyle: 'peakStyle must be compact / classic',
     priceMatch: 'priceMatch must be auto / exact',
@@ -404,6 +414,11 @@ export function applyConfigPatch(current, patch) {
   if (typeof candidate.peakEffectiveAt !== 'string') errors.push(vmsg(locale, 'peakEffectiveAt'))
   if (!Array.isArray(candidate.peakWindows)) errors.push(vmsg(locale, 'peakWindows'))
   if (typeof candidate.peakNotice !== 'boolean') errors.push(vmsg(locale, 'peakNotice'))
+  // 峰/谷切换前弹窗提醒:开关可缺省(默认开);提前量 1-30 分钟;类型三选一。
+  if (candidate.peakAlertEnabled !== undefined && typeof candidate.peakAlertEnabled !== 'boolean') errors.push(vmsg(locale, 'peakAlertEnabled'))
+  const alertAhead = Number(candidate.peakAlertAhead)
+  if (!Number.isInteger(alertAhead) || alertAhead < 1 || alertAhead > 30) errors.push(vmsg(locale, 'peakAlertAhead'))
+  if (!['peak', 'offpeak', 'both'].includes(candidate.peakAlertTarget)) errors.push(vmsg(locale, 'peakAlertTarget'))
   if (candidate.showSessionId !== undefined && typeof candidate.showSessionId !== 'boolean') errors.push(vmsg(locale, 'showSessionId'))
   if (candidate.peakStyle !== 'compact' && candidate.peakStyle !== 'classic') errors.push(vmsg(locale, 'peakStyle'))
   if (candidate.priceMatch !== 'auto' && candidate.priceMatch !== 'exact') errors.push(vmsg(locale, 'priceMatch'))
@@ -588,6 +603,13 @@ export function sanitizeConfig(raw) {
   out.decimals = Math.max(0, Math.min(10, Math.floor(Number(out.decimals) || 0)))
   out.historyDays = Math.max(7, Math.min(3650, Math.floor(Number(out.historyDays) || 180)))
   out.showSessionId = out.showSessionId === true
+  // 峰/谷切换弹窗提醒:非法值定向收敛(开关默认开、提前量回 2、类型回 both)。
+  out.peakAlertEnabled = out.peakAlertEnabled !== false
+  const alertAhead = Number(out.peakAlertAhead)
+  out.peakAlertAhead = Number.isInteger(alertAhead) && alertAhead >= 1 && alertAhead <= 30 ? alertAhead : 2
+  out.peakAlertTarget = oneOf(out.peakAlertTarget, ['peak', 'offpeak', 'both'], 'both')
+  // 安装前历史自动导入标记:有限正数保留,否则归零(下次启动重试)。
+  out.legacyAutoImportedAt = isNum(Number(out.legacyAutoImportedAt)) && Number(out.legacyAutoImportedAt) > 0 ? Number(out.legacyAutoImportedAt) : 0
   if (!isNum(out.exchangeRate) || out.exchangeRate <= 0) out.exchangeRate = base.exchangeRate
   if (!Array.isArray(out.peakWindows)) out.peakWindows = base.peakWindows
   else out.peakWindows = out.peakWindows.filter(w => w !== null && typeof w === 'object' && isNum(Number(w.start)) && isNum(Number(w.end)))

package/lib/typert.host.js

@@ -103,7 +103,13 @@ const configSchema = z.object({
   peakEffectiveAt: z.string(),
   peakWindows: z.array(z.object({ start: num, end: num })),
   peakNotice: z.boolean().optional(),
+  // 峰/谷切换前弹窗提醒:开关(默认开)/提前分钟数(1-30)/类型(峰|谷|两者)。
+  peakAlertEnabled: z.boolean().optional(),
+  peakAlertAhead: num.optional(),
+  peakAlertTarget: z.enum(['peak', 'offpeak', 'both']).optional(),
   showSessionId: z.boolean().optional(),
+  // 安装前历史自动导入完成时刻(issue #27,内部标记;0/缺席 = 尚未跑过)。
+  legacyAutoImportedAt: num.optional(),
   peakStyle: z.enum(['compact', 'classic']).optional(),
   priceMatch: z.enum(['auto', 'exact']).optional(),
   priceOverrides: z.record(z.string(), z.string()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.14",
+  "version": "1.5.16",
   "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, in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",