dsh-cost-meter 1.5.15 → 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.15-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)
@@ -40,6 +40,7 @@ English | [中文](README.md)
 | 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.15`** — 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.15/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.15
+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.15.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.15-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)
@@ -41,6 +41,7 @@
 | 预算设置 | 设置页顶部 | 额度、周期(今日/本月/累计/自定义日期区间)、已用% |
 | 价格表 | 设置页 | 每模型 谷时/峰时 两档价格(支持 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.15`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.16`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.15/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.15
+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.15.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: '常规',
@@ -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',
@@ -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/store.js

@@ -38,6 +38,9 @@ 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(经典分段/胶囊芯片)
@@ -221,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',
@@ -282,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',
@@ -405,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'))
@@ -589,6 +603,11 @@ 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

package/lib/typert.host.js

@@ -103,6 +103,10 @@ 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(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.15",
+  "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",