@dougen/dsh-deepseek-usage 0.7.0 → 0.9.0

package/README.md

@@ -1,8 +1,8 @@
 # @dougen/dsh-deepseek-usage
 
-A sidebar plugin for **DeepSeek Harness Web UI** that shows your **DeepSeek account balance** (large display) and the **current model's unit pricing**, with a peak/off-peak billing indicator. UI language follows the DSH locale (Chinese UI shows Chinese, other languages show English).
+A sidebar plugin for **DeepSeek Harness Web UI** that shows your **DeepSeek account balance** (large display), the **current model's unit pricing**, and the **time left until the next peak/off-peak switch** — with a peak/off-peak billing indicator. UI language follows the DSH locale (Chinese UI shows Chinese, other languages show English).
 
-DeepSeek **余额侧边栏插件**（DeepSeek Harness Web UI）：在 DSH **网页界面**的侧边栏底部常驻显示你的 **DeepSeek 账号余额**（放大显示）与**当前模型档单价**，并提供高峰/空闲计费时段指示灯。界面语言跟随 DSH 语言设置（中文界面显示中文，其他语言显示英文）。
+DeepSeek **余额侧边栏插件**（DeepSeek Harness Web UI）：在 DSH **网页界面**的侧边栏底部常驻显示你的 **DeepSeek 账号余额**（放大显示）、**当前模型档单价**，以及**距下次峰谷切换的倒计时**，并提供高峰/空闲计费时段指示灯。界面语言跟随 DSH 语言设置（中文界面显示中文，其他语言显示英文）。
 
 ![DeepSeek usage card / 用量卡片](https://cdn.jsdelivr.net/npm/@dougen/dsh-deepseek-usage/screenshot.png)
 
@@ -12,10 +12,9 @@ DeepSeek **余额侧边栏插件**（DeepSeek Harness Web UI）：在 DSH **网
 - **Unit pricing**: `→|1.5 ⚡0.05 |→4.5` (input / input cache / output, bottom-right of the card; switches with the active model and peak/off-peak window — **updates instantly when you switch models**)
 - **Editable price table**: prices live in a JSON file (`<DSH_HOME>/dsh-deepseek-usage/pricing.json`), not in code. The plugin reads it at startup, so the card prices correctly **immediately after a restart**, and a successful official sync is written back into it. Hand-edit it for a gateway/manual pricing; changes apply without restarting (`autoUpdate: false` also turns the automatic sync off completely)
 - **Auto price sync**: prices are re-fetched from the official DeepSeek pricing page on first use each day and when you click the card; the result is merged back into the price table (official entries overwrite same-named ones, your own entries are kept). The page is parsed **structurally (HTML table cells)**, not by matching surrounding text, so official layout/rewording changes no longer break it; a plain-text strategy remains as a fallback
-- **Rename-proof model mapping**: when DeepSeek renames a model (e.g. `deepseek-v4-flash` → `deepseek-flash`) the old id is charged at the current model's price, and the card notes `Priced as deepseek-flash` instead of silently showing an outdated price
-- **Visible sync state**: if the official page cannot be fetched/parsed, the card is blanked and says which prices it is using (hover for the error and the last sync time) instead of quietly showing stale numbers
-- **Peak indicator**: top-right dot, orange during peak hours (Mon–Fri 9:00–12:00, 14:00–18:00 Beijing Time), green otherwise
-- **Auto refresh**: every 5 minutes; click the card to refresh instantly — plus a few quick retries while the host is still syncing, so the card converges within seconds
+- **Rename-proof model mapping**: when DeepSeek renames a model (e.g. `deepseek-v4-flash` → `deepseek-flash`) the old id is charged at the current model's price instead of silently showing an outdated price. (The card stays quiet about this — see *FAQ* below.)
+- **Peak indicator & countdown**: top-right dot — orange during peak hours (Mon–Fri 9:00–12:00, 14:00–18:00 Beijing Time), green otherwise. Beside the dot a countdown shows the time left until the next peak/off-peak switch, in English units (`2d 15h`, `5h 47m`, `23m`).
+- **Auto refresh**: every 5 minutes; click the card to refresh instantly.
 - **i18n**: UI copy follows the DSH locale (Chinese / English)
 - Follows the app light/dark theme
 
@@ -23,10 +22,9 @@ DeepSeek **余额侧边栏插件**（DeepSeek Harness Web UI）：在 DSH **网
 - **档单价**：`→|1.5 ⚡0.05 |→4.5`（输入 / 输入缓存 / 输出，位于卡片右下角；随当前启用模型与峰谷时段自动切换，**切换模型时立即同步**）
 - **可编辑的价格表**：价格不再写在代码里，而是存在 JSON 文件 `<DSH_HOME>/dsh-deepseek-usage/pricing.json`。插件启动时先读它，所以**重启后卡片立刻就是正确价格**；官方同步成功后会自动回写到这份表里。手改该文件即可用于中转/手动计价，改完**无需重启**（`autoUpdate: false` 还能彻底关掉自动同步）
 - **单价自动同步**：每日首次使用或点击卡片时，自动从官方价格页拉取最新档单价，并把结果**合并回写**到价格表（官方条目覆盖同名项，你自己加的条目保留）。页面解析采用**结构化表格解析**（直接读 HTML 表格单元格），不再依赖"正文里某段文字长什么样"，官方改版/改文案不会失效；另保留纯文本兜底策略
-- **抗改名映射**：官方给模型改名（如 `deepseek-v4-flash` → `deepseek-flash`）时，旧名按现名价格计费，卡片会注明 `按 deepseek-flash 计价`，不会静默显示旧价
-- **同步状态可见**：官方页抓取/解析失败时，卡片会置空并说明当前用的是哪份价（悬停可看具体错误与上次同步时间），而不是悄悄显示旧价
-- **峰谷指示灯**：卡片右上角，高峰（周一至周五 9:00–12:00、14:00–18:00 北京时间）橙色，空闲绿色
-- **自动刷新**：每 5 分钟一次；点击卡片任意位置立即刷新；宿主正在后台同步时还会在几秒内快速补几次请求，卡片很快收敛到最新官方价
+- **抗改名映射**：官方给模型改名（如 `deepseek-v4-flash` → `deepseek-flash`）时，旧名按现名价格计费，不会静默显示旧价（卡片不为此弹提示，见下方 FAQ）
+- **峰谷指示灯与倒计时**：卡片右上角圆点，高峰（周一至周五 9:00–12:00、14:00–18:00 北京时间）橙色，空闲绿色；圆点旁显示距下次峰谷切换的倒计时，统一英文单位（`2d 15h`、`5h 47m`、`23m`）
+- **自动刷新**：每 5 分钟一次；点击卡片任意位置立即刷新
 - **多语言**：界面文案跟随 DSH 语言（中文 / English）
 - 跟随应用明暗主题
 
@@ -56,13 +54,13 @@ Restart the web app (`dsh web`), open http://127.0.0.1:3080 , and the usage card
 |---|---|
 | Balance | Official DeepSeek API `GET /user/balance` (uses `DEEPSEEK_API_KEY` configured in DSH) |
 | Unit pricing | Local price table `<DSH_HOME>/dsh-deepseek-usage/pricing.json` (read at startup; editable). Refreshed from the official page ([api-docs.deepseek.com/zh-cn/quick_start/pricing](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)) on first daily use or on card click, then written back. Parsed from the HTML **table cells** (text fallback available); the built-in snapshot in code is only the seed for the very first run |
-| Peak window | Built-in official rule: Mon–Fri 9:00–12:00, 14:00–18:00 Beijing Time (weekends are always off-peak) |
+| Peak window | Built-in official rule: Mon–Fri 9:00–12:00, 14:00–18:00 Beijing Time (weekends are always off-peak). The card shows it as a coloured dot plus a countdown to the next switch |
 
 | 数据 | 来源 |
 |---|---|
 | 余额 | DeepSeek 官方 API `GET /user/balance`（使用 DSH 中已配置的 `DEEPSEEK_API_KEY`） |
 | 档单价 | 本地价格表 `<DSH_HOME>/dsh-deepseek-usage/pricing.json`（启动即读取，可手动编辑）；每日首次使用或点击卡片时从官方价格页 [api-docs.deepseek.com/zh-cn/quick_start/pricing](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/) 同步并**回写**该表。官方页解析**读取 HTML 表格单元格**（另有纯文本兜底策略）；代码里的内置快照只在首次运行时用于生成价格表 |
-| 峰谷时段 | 内置官方口径：周一至周五 9:00–12:00、14:00–18:00（北京时间），周末恒为空闲 |
+| 峰谷时段 | 内置官方口径：周一至周五 9:00–12:00、14:00–18:00（北京时间），周末恒为空闲；界面以「指示灯 + 距下次切换倒计时」呈现 |
 
 Make sure `DEEPSEEK_API_KEY` is configured in DSH (Model settings page) before use.
 
@@ -90,7 +88,7 @@ Make sure `DEEPSEEK_API_KEY` is configured in DSH (Model settings page) before u
 - Every successful official sync **merges** into this file: official entries overwrite same-named ones, your own entries stay.
 - Edits are picked up without restarting the plugin (the file's mtime is checked per request).
 - If the file is corrupt, the plugin keeps the last good prices and **never overwrites** it — fix it and it reloads.
-- The card's peak-dot tooltip shows the file path and the time the displayed prices came from.
+  (The card itself never shows this path — it only shows your balance, the unit prices, the peak dot and the countdown.)
 
 价格表文件位于 `<DSH_HOME>/dsh-deepseek-usage/pricing.json`（默认 `~/.dsh/dsh-deepseek-usage/pricing.json`，可用 `DEEPSEEK_USAGE_PRICE_FILE` 覆盖）。首次运行由内置快照生成，之后由插件维护：
 
@@ -98,7 +96,7 @@ Make sure `DEEPSEEK_API_KEY` is configured in DSH (Model settings page) before u
 - 每次官方同步成功都会**合并回写**本文件：官方页列出的模型覆盖同名条目，你自己加的条目保留。
 - 手改后无需重启（每次请求会比对文件 mtime），改完点一下卡片即生效。
 - 文件损坏时不会覆盖你的内容，会继续用上一次的价格并写日志；修好后自动重载。
-- 卡片峰谷灯的悬停提示里会显示该文件路径，以及当前这份价是什么时候同步的。
+  （卡片上不会显示该路径——卡片只显示余额、档单价、峰谷圆点与切换倒计时。）
 
 ## FAQ / 常见问题
 
@@ -113,19 +111,13 @@ Make sure `DEEPSEEK_API_KEY` is configured in DSH (Model settings page) before u
 **Price differs from the official one? / 单价与官方价格不一致？**
 
 - The unit price switches with the **active model** and the **peak/off-peak window**. Prices come from the local price table (last successful official sync, or your own edits); the plugin re-syncs the official page on first daily use or on card click and writes the result back into that table.
-- If a notice or an error appears, the card is blanked: balance, unit prices and the peak dot are hidden and only the notice text is shown (hover it for the exact error / last sync time). Purely informational notices (priced as a renamed model) are dismissable: **click the card to flip back to the normal balance/price card** — the notice stays reachable from the peak dot's tooltip. Sync failures and API errors always keep the card blanked; there, clicking only refreshes. The text tells you where the number comes from:
-  - *Prices not synced (built-in table)* — no usable price table **and** the official page could not be fetched/parsed; click the card to retry (hover for the error).
-  - *Sync failed; using last prices (09-11 09:36)* — the price table has the last good official prices; only the refresh failed.
-  - *Priced as `deepseek-flash`* — the active model id was renamed by DeepSeek; the current model's price is used.
-  - *Priced as built-in `…`* — the model is neither in the official page nor in the price table; the built-in entry is used.
+- **The card deliberately shows no plugin internals**: no sync state, no pricing source, no price-table path. It shows your balance, the current unit prices, the peak dot and the countdown; **click it to refresh**.
+- Want to know where a price comes from? Open `<DSH_HOME>/dsh-deepseek-usage/pricing.json` (see *Price table* above) — official entries are merged there on every successful sync.
 - **After every `dsh` restart the card used to say "prices not synced (built-in table)"** — that was a race: sync state only lived in memory, so the first request after a restart was always answered from the built-in table. Since 0.7.0 the price table is persisted and read at startup, so restarts show real prices right away.
 
 - 单价按**当前启用模型**与**峰谷时段**自动切换；价格取自本地价格表（上次成功同步到的官方价，或你自己改的价）。插件在每日首次使用或点击卡片时重新同步官方页，并把结果回写到该表。
-- 一旦出现提示或错误，卡片会**置空**：不显示余额、档单价与峰谷灯，只显示提示文字（悬停看具体错误与上次同步时间）。其中纯说明性的良性提示（按现名计价）可以**点击卡片切回普通状态**（余额 + 档单价 + 峰谷灯），提示此时保留在峰谷灯的 hover 里。同步失败与接口错误属于异常，卡片始终置空（此时点击只刷新）。文字说明数字来自哪里：
-  - *价格未同步（用内置表）*：既没有可用价格表，官方页也抓不到；点击卡片可重试（悬停看具体错误）。
-  - *同步失败，仍用上次价格（09-11 09:36）*：价格表里是上次同步到的官方价，只是这次刷新失败了。
-  - *按 `deepseek-flash` 计价*：官方给该模型改名了，已按现名价格计费。
-  - *按内置 `…` 档计价*：该模型既不在官方价格页，也不在价格表里，用了内置条目。
+- **卡片刻意不显示任何插件内部信息**：不显示同步状态、计价来源、价格表路径。卡片上只有余额、当前档单价、峰谷圆点与切换倒计时；**点击卡片即刷新**。
+- 想知道某个价从哪来？打开 `<DSH_HOME>/dsh-deepseek-usage/pricing.json`（见上文「价格表」）——每次成功同步都会把官方价合并写进去。
 - **以前每次 `dsh` 重启后卡片都会提示"价格未同步（用内置表）"**：那是竞态——同步状态只存在内存里，重启后的第一次请求只能用内置表回答。0.7.0 起价格表落盘并在启动时读取，重启后立即显示真实价格。
 
 ## Development / 开发与自检
@@ -162,6 +154,15 @@ node lib/pricing-remote.js --check --html page.html --json
 > `node --test --test-isolation=none "test/*.test.mjs"`（Node ≥ 22.8），或逐个跑
 > `node test/parse.test.mjs`、`node test/pricing.test.mjs`、`node test/pricing-store.test.mjs`、
 > `node test/client-layout.test.mjs`、`node test/host-route.test.mjs`。
+>
+> 两种偶发失败都属于环境限制，不是插件行为，逐文件运行可稳定复现通过：
+> - `host-route` 的"合并写回"用例依赖点击时的 `FORCED_GAP_MS`（30s）节流门；多个测试文件
+>   共用同一进程（`--test-isolation=none`）时那条"强制同步"可能被门挡掉。
+> - Windows 上原子写（写 `.tmp` 后 `rename`）可能被安全软件短暂占用而报
+>   `EPERM ... rename`；重跑即过。
+>
+> 另：`test/host-route.test.mjs` 与 `test/pricing-store.test.mjs` 都只需要一个可写的临时目录
+> （`os.tmpdir()`），若该目录不可写（`mkdtemp ... EPERM`），把 `TEMP`/`TMP` 指到任意可写目录即可。
 
 ## Uninstall / 卸载
 

package/lib/client.js

@@ -2,13 +2,17 @@
 //
 // 侧边栏底部用量卡片（注册进 `sidebar.footer.action` 槽位，独占一行，位于
 // Cordis 面板按钮下方）。轮询宿主路由 `/api/deepseek-usage`（见 lib/index.js）
-// 每 5 分钟一次，点击卡片任意位置可立即刷新；宿主还在后台同步官方价
-// （pricing.syncing）时按 QUICK_RETRY_MS 阶梯快速补几次请求，卡片几秒内收敛。
+// 每 5 分钟一次，点击卡片任意位置可立即刷新；还没拿到余额（宿主刚重启/接口刚起来）
+// 时按 QUICK_RETRY_MS 阶梯快速补几次请求，卡片几秒内收敛。
 // 卡片显示：余额（放大显示，符号随币种 ¥/$）+ 当前模型档单价（输入/输入缓存/
-// 输出，图标 + 数字，位于卡片右下角）+ 峰谷指示灯（右上角）。
-// 价格来源（宿主 pricing.source）：remote=本次官方同步 / file=本地价格表
-// （重启后即用它，属正常态）/ seed=内置兜底；峰谷灯 hover 里可看到来源、
-// 上次同步时间与价格表文件路径。
+// 输出，图标 + 数字，位于卡片右下角）+ 峰谷指示灯（右上角，只有颜色）+ 距下次
+// 峰谷切换的倒计时（`2d 15h` / `5h 47m` / `23m`，与指示灯同行、位于其左侧）。
+//
+// 设计约束（用户只关心"我还能花多少、这会儿什么价"）：
+//   · 插件的内部信息——计价来源、同步状态、价格表文件名与路径、模型改名——一律
+//     不出现在 UI 上（历史上圆点的 title 里塞过这些，已删除）。
+//   · 唯一的交互是「点击卡片刷新」；没有可切换的提示态。
+//   · 只有余额类错误（未配置 Key / 余额接口或网络失败）才置空卡片说明原因。
 // 样式仅使用 `--dsw-*` 主题变量（含兜底值），跟随明暗主题。
 window.__ModuleLoader__.load({
 	id: "@dougen/dsh-deepseek-usage",
@@ -23,45 +27,99 @@ window.__ModuleLoader__.load({
 		// ---- constants -------------------------------------------------
 		const POLL_MS = 5 * 60 * 1000;
 		const USAGE_PATH = "/api/deepseek-usage";
-		// 常态卡片高度：上下 padding 8+8 + 余额行 lineHeight 28 + 边框 2 = 46。
-		// 异常态把卡片置空时用它兜住高度，侧边栏高度不跳动。
-		const CARD_MIN_HEIGHT = 46;
-		// 宿主正在后台同步官方价格（pricing.syncing）或本地接口刚重启时的快速重试节奏：
-		// 否则卡片要等满 5 分钟轮询才会从"本地价格表"变成最新官方价。
+		// 常态卡片高度：上下 padding 8+16 + 金额行 minHeight 28 + 边框 2 = 54。
+		// 底部多留的 8px 是为了让倒计时那一行与下方单价行之间有呼吸感。
+		// 倒计时与圆点都在金额行内定位，不额外增高（无头 Chromium 实测 cardH=54）。
+		// 异常态把卡片置空时用它兜住同一个高度，侧边栏高度不跳动。
+		const CARD_MIN_HEIGHT = 54;
+		// 卡片还没拿到余额时的快速重试节奏（宿主刚重启、接口刚起来、或本次请求失败）：
+		// 否则要等满 5 分钟轮询才会从空卡片变成真实数字。
 		const QUICK_RETRY_MS = [4000, 8000, 15000, 30000];
 
 		// ---- i18n（DSH locale 服务；zh 为兜底）----
+		// 注意：卡片上只出现「输入 / 输入缓存 / 输出」这三个标签。峰谷灯没有文字、
+		// 没有 hover；倒计时统一用英文单位（d/h/m）且不带前缀，中英界面完全一致——
+		// 插件内部的同步状态、计价来源、价格表位置等一概不进 UI。
 		const NS = "dsh-deepseek-usage";
 		const ZH = {
 			"price.input": "输入",
 			"price.cache": "输入缓存",
 			"price.output": "输出",
-			"peak.peak": "高峰时段",
-			"peak.off": "空闲时段",
-			"price.stale": "价格未同步（用内置表）",
-			"price.lastGood": "同步失败，仍用上次价格（{at}）",
-			"price.alias": "按 {model} 计价",
-			"price.builtin": "按内置 {model} 档计价",
-			"price.file": "本地价格表（{at} 同步）",
-			"price.manual": "本地价格表（自动同步已关闭）",
-			"price.filePath": "价格表：{path}",
 		};
 		const EN = {
 			"price.input": "Input",
 			"price.cache": "Input cache",
 			"price.output": "Output",
-			"peak.peak": "Peak hours",
-			"peak.off": "Off-peak hours",
-			"price.stale": "Prices not synced (built-in table)",
-			"price.lastGood": "Sync failed; using last prices ({at})",
-			"price.alias": "Priced as {model}",
-			"price.builtin": "Priced as built-in {model}",
-			"price.file": "Local price table (synced {at})",
-			"price.manual": "Local price table (auto-sync off)",
-			"price.filePath": "Price table: {path}",
 		};
 
-		// ---- helpers ---------------------------------------------------
+		// ---- 倒计时文案（语言无关，故不进词典）----
+		/** 峰谷灯 hover：切换时刻 / 即将切换。 */
+		const SWITCH_AT = "{at} switch";
+		const SWITCHING = "switching";
+
+		// ---- 峰谷规则（必须与 lib/pricing.js 的 isPeak / PEAK_WINDOWS /
+		// PEAK_WEEKDAYS_ONLY 保持一致；浏览器侧无法 import 宿主模块，只能镜像）----
+		const SHANGHAI_OFFSET_MS = 8 * 60 * 60 * 1000;
+		const PEAK_WINDOWS = [[9, 12], [14, 18]];
+		const PEAK_WEEKDAYS_ONLY = true;
+
+		/** 某时刻的北京时间小时（0–23）。 */
+		function shanghaiHour(ms) {
+			return new Date(ms + SHANGHAI_OFFSET_MS).getUTCHours();
+		}
+
+		/** 某时刻是否为高峰时段（按北京时间；周末恒为空闲）。与 lib/pricing.js 的 isPeak 等价。 */
+		function isPeak(ms) {
+			const d = new Date(ms + SHANGHAI_OFFSET_MS);
+			if (PEAK_WEEKDAYS_ONLY) {
+				const dow = d.getUTCDay();
+				if (dow === 0 || dow === 6) return false;
+			}
+			const h = d.getUTCHours();
+			return PEAK_WINDOWS.some(([start, end]) => h >= start && h < end);
+		}
+
+		/**
+		 * 距下一个计费时段边界的剩余时间；与 lib/pricing.js 的 nextChange 等价。
+		 * 逐分钟向前探测（上限 8 天，覆盖"周五晚 → 下周一早"）。
+		 */
+		function nextChange(ms) {
+			const now = Number.isFinite(ms) ? ms : Date.now();
+			const current = isPeak(now);
+			for (let step = 1; step <= 8 * 24 * 60; step += 1) {
+				const at = now + step * 60 * 1000;
+				const peak = isPeak(at);
+				if (peak !== current) return { peak, at, ms: Math.max(0, at - now) };
+			}
+			return { peak: !current, at: now, ms: 0 };
+		}
+
+		/** m/h/d 三档短标签（语言无关）。 */
+		const _u = (v, u) => `${v}${u}`;
+
+		/**
+		 * 剩余毫秒 → 英文单位时长，最多两级：`2d 15h` / `5h 47m` / `23m` / `switching`。
+		 * 不足 1 分钟显示 `switching`。向下取整，避免"还剩 59 秒却显示 1m"的反向偏差。
+		 */
+		function fmtCountdown(ms) {
+			const total = Math.max(0, Math.floor((Number.isFinite(ms) ? ms : 0) / 60000));
+			const days = Math.floor(total / 1440);
+			const hours = Math.floor((total % 1440) / 60);
+			const minutes = total % 60;
+			if (days > 0) return _u(days, "d") + " " + _u(hours, "h");
+			if (hours > 0) return _u(hours, "h") + " " + _u(minutes, "m");
+			return minutes > 0 ? _u(minutes, "m") : SWITCHING;
+		}
+
+		/** 时间戳（ms）→ `HH:mm`（本地时区）；无效值返回空串。 */
+		function fmtClock(value) {
+			const n = Number(value);
+			if (!Number.isFinite(n) || n <= 0) return "";
+			const d = new Date(n);
+			const p = (v) => String(v).padStart(2, "0");
+			return `${p(d.getHours())}:${p(d.getMinutes())}`;
+		}
+
 		function money(value) {
 			const n = Number(value);
 			if (!Number.isFinite(n)) return "—";
@@ -74,15 +132,6 @@ window.__ModuleLoader__.load({
 			return String(parseFloat(n.toFixed(2)));
 		}
 
-		/** 时间戳（ms）→ `MM-DD HH:mm`（本地时区）；无效值返回空串。 */
-		function fmtWhen(value) {
-			const n = Number(value);
-			if (!Number.isFinite(n) || n <= 0) return "";
-			const d = new Date(n);
-			const p = (v) => String(v).padStart(2, "0");
-			return `${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
-		}
-
 		// 主题变量（带兜底值）
 		const C = {
 			bg: "var(--dsw-alias-bg-layer-1, rgba(127,127,127,.12))",
@@ -125,9 +174,8 @@ window.__ModuleLoader__.load({
 			const wide = !!props.wide;
 			const [data, setData] = useState(null);
 			const [error, setError] = useState("");
-			// 纯良性提示（模型改名 / 官方页没列该模型）时卡片默认显示提示，点击可切回普通
-			// 状态（余额 + 单价 + 峰谷灯），再点切回提示。异常不受它影响，始终置空。
-			const [showNormal, setShowNormal] = useState(false);
+			// 倒计时走字用的心跳：每 30 秒 bump 一次，渲染时按当前时刻重算剩余时间。
+			const [tick, setTick] = useState(0);
 			const mounted = useRef(true);
 			// 快速重试：阶梯下标 + 定时器（宿主正在后台同步时，几秒后自己再看一眼）。
 			const retryStep = useRef(0);
@@ -152,20 +200,9 @@ window.__ModuleLoader__.load({
 				return ZH[key] || key;
 			};
 
-			// 价格还没到位时按 QUICK_RETRY_MS 阶梯补一次请求（封顶后回到 5 分钟轮询）：
-			// 覆盖两种情况——宿主正在后台同步官方价（pricing.syncing）、本地接口刚重启/报错。
-			const scheduleRetry = () => {
-				if (!mounted.current) return;
-				const delay = QUICK_RETRY_MS[retryStep.current];
-				if (delay === undefined) return;
-				retryStep.current += 1;
-				if (retryTimer.current !== null) clearTimeout(retryTimer.current);
-				retryTimer.current = setTimeout(() => {
-					retryTimer.current = null;
-					load();
-				}, delay);
-			};
-
+			// 宿主还在后台忙（重启后首次余额、接口刚起来）时按 QUICK_RETRY_MS 阶梯补几次请求，
+			// 让卡片几秒内收敛；封顶后回到 5 分钟轮询。失败同样按此节奏重试。
+			// 判断依据只看"有没有拿到余额"，不再依赖宿主内部的同步状态字段。
 			const load = useCallback(async (force) => {
 				try {
 					const res = await fetch(USAGE_PATH + "?lang=" + lang + (force ? "&refresh=1" : ""), { cache: "no-store" });
@@ -174,15 +211,15 @@ window.__ModuleLoader__.load({
 						body = await res.json();
 					} catch {}
 					if (!res.ok || body === null || typeof body !== "object" || body.ok !== true) {
-						throw new Error(body && typeof body.message === "string" ? body.message : `请求失败（HTTP ${res.status}）`);
+						// 失败原因优先用宿主给的文案（未配置 Key / 余额接口异常，用户看得懂）；
+						// 拿不到就用一句人话兜底——不把 HTTP 状态码这类传输细节摆到卡片上。
+						throw new Error(body && typeof body.message === "string" && body.message !== "" ? body.message : "刷新失败，请稍后重试");
 					}
 					if (!mounted.current) return;
 					setData(body);
 					setError("");
-					// 宿主还在拉官方价 → 价格只是"本地价格表"的历史值，几秒后再确认一次；
-					// 已经拿到官方价（或手动模式/同步失败）就不再补请求。
-					const pricing = body.pricing && typeof body.pricing === "object" ? body.pricing : null;
-					if (pricing && pricing.mode !== "manual" && pricing.syncing === true) scheduleRetry();
+					const total = body.balance && body.balance.total;
+					if (!Number.isFinite(Number(total))) scheduleRetry();
 					else retryStep.current = 0;
 				} catch (e) {
 					if (!mounted.current) return;
@@ -191,6 +228,19 @@ window.__ModuleLoader__.load({
 				}
 			}, [lang]);
 
+			/** 按 QUICK_RETRY_MS 阶梯安排一次补请求（用 ref 记录进度；卸载时清理）。 */
+			const scheduleRetry = () => {
+				if (!mounted.current) return;
+				const delay = QUICK_RETRY_MS[retryStep.current];
+				if (delay === undefined) return;
+				retryStep.current += 1;
+				if (retryTimer.current !== null) clearTimeout(retryTimer.current);
+				retryTimer.current = setTimeout(() => {
+					retryTimer.current = null;
+					load();
+				}, delay);
+			};
+
 			useEffect(() => {
 				mounted.current = true;
 				load();
@@ -219,55 +269,35 @@ window.__ModuleLoader__.load({
 				};
 			}, [load, ctx]);
 
+			// 倒计时走字：每 30 秒重算一次渲染（跨过切换瞬间时，不依赖下一次 5 分钟轮询）。
+			// 30s 而非 60s 是为了保证"剩余不足 1 分钟"的窗口不会被整分钟跳过。
+			useEffect(() => {
+				const timer = setInterval(() => setTick((v) => v + 1), 30 * 1000);
+				return () => clearInterval(timer);
+			}, []);
+
 			const balance = data && data.balance ? data.balance : null;
 			const tier = data && data.tier ? data.tier : null;
-			const pricing = data && data.pricing ? data.pricing : null;
 			const symbol = balance && balance.currency === "USD" ? "$" : "¥";
+			// 卡片只显示"用户要的数字"：余额、当前档单价、状态圆点、距下次切换的倒计时。
+			// 插件的内部信息（计价来源、同步状态、价格表文件名/路径、模型改名）一律不进 UI，
+			// 唯一的交互是点击卡片刷新。只有"余额类错误"（未配置 Key / 接口或网络失败）才
+			// 把卡片置空并说明原因——否则余额是空的，用户无从判断。
 			const errs = (Array.isArray(data && data.errors) ? data.errors : []).concat(error ? [error] : []);
-			// 价格来源提示：模型改名按现名计价 / 价格来自本地价格表或内置表时明示，避免
-			// "官方已调价但卡片静静显示旧价"。
-			// friendly=true 表示只是"价格从哪来"的良性说明（可点击切回普通状态）；
-			// friendly=false 表示同步失败/旧价兜底，属于异常，必须一直可见。
-			//
-			// 0.7.0 起价格有三层（宿主 pricing.source）：
-			//   remote = 本次已从官方页同步到；
-			//   file   = 本地价格表（上次同步到的官方价 / 用户手改价）→ 属于正常态，不置空卡片，
-			//            只有"这次同步确实失败"才提示，并写明这份价是什么时候的；
-			//   seed   = 内置兜底（本地价格表缺失/损坏且官方页也拿不到）。
-			// 另外宿主正在后台同步（syncing）时不提示：这是正常过程，不是"未同步"。
-			const hints = [];
-			const addHint = (text, friendly) => hints.push({ text, friendly });
-			const at = fmtWhen(pricing && (pricing.layerAt || pricing.syncedAt));
-			const withAt = (key) => t(key).replace("{at}", at || "—");
-			if (pricing && typeof pricing === "object") {
-				const used = pricing.used ? String(pricing.used) : "";
-				const via = String(pricing.via || "");
-				if (via === "remote-alias" || via === "remote-family" || via === "file-alias" || via === "file-family") {
-					addHint(t("price.alias").replace("{model}", used), true);
-				} else if (pricing.syncing === true) {
-					// 后台正在拉官方页：此刻显示的是本地价格表里的价，属于正常过程，不提示。
-				} else if (pricing.source === "file") {
-					if (pricing.mode !== "manual" && pricing.syncOk === false) addHint(withAt("price.lastGood"), false);
-				} else if (pricing.source === "seed" && via !== "fallback") {
-					if (pricing.mode === "manual") {
-						// 手动模式下不联网，模型不在表里只是"用了内置条目"，不是同步失败
-						addHint(t("price.builtin").replace("{model}", used), true);
-					} else if (pricing.syncOk === false) {
-						addHint(t("price.stale"), false);
-					} else {
-						addHint(t("price.builtin").replace("{model}", used), true);
-					}
-				} else if (pricing.syncOk === false && pricing.syncedAt) {
-					// 本次刷新失败，但仍在用上次成功同步到的官方价格
-					addHint(withAt("price.lastGood"), false);
-				}
-			}
-			const hintText = hints.map((x) => x.text).join(" · ");
-			// blocking：同步失败/接口错误这类异常，卡片始终置空、点击只刷新；
-			// blanked：异常，或"纯良性提示且用户还没点开普通状态"。
-			const blocking = errs.length > 0 || hints.some((x) => !x.friendly);
-			const blanked = blocking || (hints.length > 0 && !showNormal);
-			const hintTitle = pricing && typeof pricing.syncError === "string" ? pricing.syncError : "";
+			const blanked = errs.length > 0;
+			// 每次渲染都以"当前时刻"求剩余时间；tick 每 30 秒 bump 一次触发这次重算，
+			// 所以跨过切换瞬间时不需要等下一次 5 分钟轮询。
+			// nextAt 优先用宿主给的 next.at（避免宿主与浏览器时钟不一致导致数字跳变），
+			// 宿主没给（旧版本 / 字段缺失）时用同一套规则在本地推算。
+			const nowMs = Date.now();
+			const nextAt = (() => {
+				const raw = data && data.next && Number(data.next.at);
+				if (Number.isFinite(raw) && raw > 0) return raw;
+				const age = data && Number(data.updatedAt) > 0 ? Math.max(0, nowMs - Number(data.updatedAt)) : 0;
+				return nextChange(nowMs - age).at;
+			})();
+			void tick; // tick 只用来触发重渲染，值本身不参与计算
+			const countdown = fmtCountdown(nextAt - nowMs);
 			const dot = {
 				width: 8,
 				height: 8,
@@ -276,29 +306,11 @@ window.__ModuleLoader__.load({
 				background: data && data.peak ? C.peak : C.idle,
 				boxShadow: "0 0 4px rgba(0,0,0,.3)",
 			};
-			// 指示灯 hover 提示只显示当前处于高峰/空闲时段，不拼时段明细（太长）；
-			// 价格来源提示、价格表位置附在末尾——普通状态（良性提示被点开后）它是提示
-			// 唯一可见处，也是用户想知道"价从哪来、去哪儿改价"时的入口。
-			const fileInfo = pricing && pricing.file && typeof pricing.file === "object" ? pricing.file : null;
-			const sourceNote = !pricing
-				? ""
-				: pricing.mode === "manual"
-					? t("price.manual")
-					: pricing.source === "file"
-						? t("price.file").replace("{at}", at || "—")
-						: "";
-			const pathNote = fileInfo && typeof fileInfo.path === "string" && fileInfo.path !== ""
-				? t("price.filePath").replace("{path}", fileInfo.path)
-				: "";
-			const peakTitle = [
-				data && data.peak ? t("peak.peak") : t("peak.off"),
-				hintText,
-				sourceNote,
-				pathNote,
-			].filter((x) => x !== "").join(" · ");
-			// 点击卡片：刷新数据；若是纯良性提示，再在「提示态 / 普通态」之间切换。
+			// 圆点自身没有任何 hover（历史上的 title 里塞了同步时间、价格表路径等内部信息，
+			// 对用户毫无意义，已删除）；它只表达"现在是高峰还是空闲"，切换时刻由旁边的
+			// 倒计时承担。
+			// 点击卡片：唯一动作 = 刷新。
 			const onCardClick = () => {
-				if (hints.length > 0 && !blocking) setShowNormal((v) => !v);
 				load(true);
 			};
 
@@ -324,16 +336,15 @@ window.__ModuleLoader__.load({
 					h("span", { style: { display: "inline-flex", alignItems: "baseline", gap: 3 } },
 						h("span", { style: { fontWeight: 700, fontSize: 13, color: C.label } }, symbol),
 						h("span", { style: { fontWeight: 700, fontSize: 13, color: C.label } }, money(balance && balance.total))),
-					h("span", { style: dot, title: peakTitle }));
+					h("span", { style: dot }));
 			}
 
-			// A2/A3（价格来源提示 / 错误）出现时，卡片直接置空：不画余额、档单价与峰谷灯，
-			// 只在空白卡片上显示提示文字——提示不再和余额数字、单价行抢同一块版面，从根本
-			// 上消除遮挡。minHeight 兜住常态卡片高度（CARD_MIN_HEIGHT），侧边栏不跳动；
-			// 文字多行时卡片自然变高。提示/错误字号取 12px（与卡片正文同级；原来 10px 可读性
-			// 差），字号变大后靠换行留在卡片内，不再用 nowrap + 省略号截断。纯良性提示可由
-			// 点击切回普通状态（见 blanked）。
-			// 窄卡片（!wide）没有文字空间，维持原样（提示在峰谷灯 hover 里）。
+			// 只有"余额类错误"（未配置 Key / 余额接口或网络失败）才走到这里：卡片置空、
+			// 只显示原因文字，不画余额/单价/圆点/倒计时。minHeight 兜住常态卡片高度
+			// （CARD_MIN_HEIGHT），侧边栏不跳动；文字多行时卡片自然变高。
+			// 注意：这里不显示任何插件内部信息（来源、同步时间、价格表路径），历史上那批
+			// 良性提示已随"去技术化"一起删除。
+			// 窄卡片（!wide）没有文字空间：仍显示余额与圆点，错误只写进日志。
 			if (blanked) {
 				return h("div", {
 					style: {
@@ -358,17 +369,9 @@ window.__ModuleLoader__.load({
 					},
 					onClick: onCardClick,
 				},
-					hints.length
-						? h("div", {
-							style: { color: C.sub, fontSize: 12, lineHeight: "16px", whiteSpace: "pre-wrap", overflowWrap: "anywhere" },
-							title: hintTitle || hintText,
-						}, hintText)
-						: null,
-					errs.length
-						? h("div", {
-							style: { color: C.err, fontSize: 12, lineHeight: "16px", whiteSpace: "pre-wrap", overflowWrap: "anywhere" },
-						}, errs.join(" | "))
-						: null);
+					h("div", {
+						style: { color: C.err, fontSize: 12, lineHeight: "16px", whiteSpace: "pre-wrap", overflowWrap: "anywhere" },
+					}, errs.join(" | ")));
 			}
 
 			const Price = (icon, label, value) =>
@@ -381,7 +384,9 @@ window.__ModuleLoader__.load({
 					boxSizing: "border-box",
 					flex: "1 1 100%",
 					minWidth: 0,
-					padding: "8px 10px",
+					// 上 8 下 10（配合单价行 bottom:2，这组是用户看过后选定的观感）。
+					// 顶部保持 8px 不动，圆点才能继续紧贴右上角。
+					padding: "8px 10px 12px",
 					borderRadius: 10,
 					border: "1px solid " + C.border,
 					background: C.bg,
@@ -398,20 +403,44 @@ window.__ModuleLoader__.load({
 				},
 				onClick: onCardClick,
 			},
-				// 第一行：余额（24px，符号与数字 3px 间距）
-				h("div", { style: { display: "flex", alignItems: "baseline", minWidth: 0, paddingRight: 14, gap: 6 } },
+				// 金额行：余额 + 右侧「倒计时 + 峰谷圆点」。
+				// 倒计时与圆点放在同一个 flex 行里、alignItems:center，两者圆心必然重合；
+				// 整组 alignSelf:flex-start + 负 margin，让圆点距卡片顶/右各 8px。
+				// 两个反面做法都试过并实测过：
+				//   · alignSelf:center → 圆点被压到卡片中线，不再是"右上角"；
+				//   · paddingTop:6    → 金额行被撑高，卡片被撑大，圆点反而更靠下。
+				// 倒计时 minWidth:0 + overflow:hidden：窄侧边栏下先省略号截断，不挤压余额
+				// （实测 "2d 23h" 在 170px 宽的卡片里仍放得下）。
+				h("div", { style: { display: "flex", alignItems: "baseline", minHeight: 28, minWidth: 0, gap: 6 } },
 					h("span", { style: { fontWeight: 700, fontSize: 24, color: C.label, lineHeight: "28px", marginRight: 3 } }, symbol),
-					h("span", { style: { fontWeight: 700, fontSize: 24, color: C.label, lineHeight: "28px" } }, money(balance && balance.total))),
-				h("span", {
-					style: { position: "absolute", top: 8, right: 9, ...dot },
-					title: peakTitle,
-				}),
+					h("span", { style: { fontWeight: 700, fontSize: 24, color: C.label, lineHeight: "28px" } }, money(balance && balance.total)),
+					// 负 margin 只挪动整组，不改变金额行高度（卡片高度由内边距决定）。
+					// 实测：marginTop -4 与 marginRight -3 时，圆点距卡片顶、右各 8px
+					// （右侧不能按"内边距 10 − 8"去推，内边距本就含在行宽里）。
+					h("span", { style: { display: "flex", alignItems: "center", gap: 6, minWidth: 0, marginLeft: "auto", flex: "0 1 auto", alignSelf: "flex-start", marginTop: -4, marginRight: -3 } },
+						// 倒计时：距下次峰谷切换的剩余时间（`2d 15h` / `5h 47m` / `23m` / `switching`）。
+						// 纯英文单位、无前缀，中英界面一致。
+						// 字号/字重刻意与右下角单价数字对齐（继承卡片正文 12px、fontWeight 600），
+						// 让右上角这行和右下角单价行是同一套文字样式。
+						h("span", {
+							style: {
+								fontWeight: 600,
+								color: C.sub,
+								minWidth: 0,
+								overflow: "hidden",
+								textOverflow: "ellipsis",
+								whiteSpace: "nowrap",
+							},
+						}, countdown),
+						// 峰谷指示灯：只有颜色（橙=高峰 / 绿=空闲），没有 title、没有其他文字。
+						h("span", { style: dot }))),
 				// 底部行：只剩当前档单价，恒靠右下角。
+				// 这组 bottom:2 + 卡片下内边距 10 是用户看过多组对比后选定的观感（价格略微下移、
+				// 下方不再空一大块）。注意绝对定位的行不参与卡片高度计算，改内边距时两者要一起看。
 				// 用 flex-end 而不是 space-between：容器只有一个子元素时 space-between 会把它
-				// 推到最左侧（0.6.0 的回归点）。提示文字不在这张卡片上重复显示：异常态由空白
-				// 卡片承担，普通态只剩峰谷灯 hover（peakTitle）。
+				// 推到最左侧（0.6.0 的回归点）。
 				h("span", {
-					style: { position: "absolute", left: 9, right: 9, bottom: 4, display: "flex", alignItems: "center", justifyContent: "flex-end", gap: 6 },
+					style: { position: "absolute", left: 9, right: 9, bottom: 2, display: "flex", alignItems: "center", justifyContent: "flex-end", gap: 6 },
 				},
 					h("span", { style: { display: "inline-flex", alignItems: "center", gap: 5, flex: "none" } },
 						Price(h(IconIn, null), t("price.input"), tier && tier.input),
@@ -446,6 +475,8 @@ window.__ModuleLoader__.load({
 
 		exports.apply = apply;
 		exports.inject = inject;
+		// 纯函数透出（供 test/client-layout.test.mjs 直接做确定性断言，不必模拟计时器）。
+		exports.__internals = { nextChange, isPeak, fmtCountdown };
 		return module.exports;
 	}
 });

package/lib/index.js

@@ -10,12 +10,17 @@
  *     ok: true,
  *     balance: { isAvailable, total, currency, granted, toppedUp },  // 官方余额接口（API Key）
  *     tier: { input, cacheRead, cacheWrite, output, model, known },  // 当前模型当前档单价
- *     pricing: { source, via, requested, used, syncOk, syncing, syncedAt, layerAt,
- *                mode, file: { path, updatedAt, ... } },             // 价格来源/同步状态
+ *     next: { peak, at, ms },                                        // 距下次峰谷切换（界面倒计时）
  *     peak, peakHours,                                               // 峰谷时段（北京时间）
- *     updatedAt, errors
+ *     updatedAt, errors,
+ *     pricing: { source, via, requested, used, syncOk, syncing, syncedAt, layerAt,
+ *                mode, file: { path, updatedAt, ... } },             // 【内部诊断】界面不再消费
  *   }
  *
+ * 界面只使用 balance / tier / next / peak / errors：插件内部的计价来源、同步状态、
+ * 价格表位置属于诊断信息，保留在响应里供排查与测试，但不出现在 UI 上。
+ * errors 只放"用户能理解且需要行动"的余额类失败，不再包含"模型不在价格表"这类内部细节。
+ *
  * `lang` 参数（zh 默认）控制错误消息与峰谷文案的语言；UI 其余文案由
  * client 端（DSH locale 服务）本地化。
  *
@@ -51,6 +56,7 @@ import {
   PEAK_HOURS_TEXT_EN,
   filePriceMeta,
   isPeak,
+  nextChange,
   remotePriceMeta,
   seedAliases,
   seedPrices,
@@ -84,19 +90,18 @@ const JSON_HEADERS = {
   "cache-control": "no-store",
 };
 
-/** 错误消息字典（zh/en）。 */
+/** 错误消息字典（zh/en）。只保留"余额为什么拿不到"这类用户能理解、且需要行动的信息；
+ *  插件内部细节（计价来源、同步状态等）不再作为错误推给界面。 */
 const MESSAGES = {
   zh: {
     noKey: "未配置 DEEPSEEK_API_KEY",
     balanceHttp: (status) => `余额接口 HTTP ${status}`,
     balanceFail: (detail) => `余额获取失败: ${detail}`,
-    modelUnknown: (model) => `当前模型 ${model} 不在价格表，档单价按 deepseek-chat 展示`,
   },
   en: {
     noKey: "DEEPSEEK_API_KEY is not configured",
     balanceHttp: (status) => `Balance API HTTP ${status}`,
     balanceFail: (detail) => `Failed to fetch balance: ${detail}`,
-    modelUnknown: (model) => `Model ${model} is not in the price table, showing deepseek-chat pricing`,
   },
 };
 
@@ -415,14 +420,17 @@ function apply(ctx) {
             errors.push(msg.balanceFail(error instanceof Error ? error.message : String(error)));
           }
 
-          // ---- 档单价提示（未知模型回退 chat 档）----
-          if (!unit.known) errors.push(msg.modelUnknown(model));
+          // ---- 档单价：未知模型静默回退 chat 档（属内部兜底，不再作为错误推给界面）----
+          const next = nextChange(now);
 
           sendJson(res, 200, {
             ok: true,
             balance,
             peak: isPeak(now),
             peakHours: lang === "en" ? PEAK_HOURS_TEXT_EN : PEAK_HOURS_TEXT,
+            // 距下一次峰谷切换的剩余时间（界面用它在指示灯旁显示倒计时）：
+            //   peak = 切换后所处的时段，at = 切换时刻，ms = 剩余毫秒
+            next,
             tier: {
               input: unit.input,
               cacheRead: unit.cacheRead,
@@ -431,8 +439,8 @@ function apply(ctx) {
               model: unit.model,
               known: unit.known,
             },
-            // 价格来源与同步状态：让"官方页改版/网络失败 → 正在用旧价"可见，
-            // 而不是静默按过期价格展示。
+            // 【内部诊断】价格来源与同步状态：界面不再展示（卡片去技术化），保留字段
+            // 供排查问题与回归测试使用。
             pricing: {
               source: unit.source,                  // remote=本次官方页同步 / file=本地价格表 / seed=内置兜底
               via: unit.via,                        // remote* | file* | alias | seed | fallback

package/lib/pricing.js

@@ -23,7 +23,8 @@
  * 峰谷（官方口径）：高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，
  * 其余（含整个周末）为空闲时段；缓存写暂不计费（cacheWrite = 0）。
  *
- * 本文件用于卡片"当前档单价"展示与峰谷指示灯。
+ * 本文件用于卡片"当前档单价"展示、峰谷指示灯，以及 nextChange() 给出的
+ * 「距下次峰谷切换倒计时」（卡片上显示为 `2d 15h` / `5h 47m` 这类英文单位时长）。
  *
  * 时区（0.1.7 起）：峰谷判定与"每日"边界均按北京时间（Asia/Shanghai，固定
  * UTC+8，无夏令时）计算，不随服务器本地时区变化——在任何时区部署的 DSH 上
@@ -95,6 +96,36 @@ export function isPeak(ms) {
   return PEAK_WINDOWS.some(([start, end]) => h >= start && h < end);
 }
 
+/**
+ * 距下一个计费时段边界的剩余时间（供卡片显示倒计时）。
+ *
+ * 与 isPeak 同源同口径（北京时间、工作日、PEAK_WINDOWS 半开区间），只是换一个视图：
+ * 返回「下一次 isPeak 结果发生翻转」的时刻。注意空闲时段里的下一次切换**不等于**下一个
+ * 整点：
+ *   · 12:00–14:00 午休 → 下一次切换是 14:00（高峰开始）；
+ *   · 周五 18:00 之后、整个周末 → 下一次切换是下周一 09:00（跨 2 天多）。
+ * 因此倒计时必须能显示「天」。
+ *
+ * 实现：逐分钟向前探测（上限 8 天），纯算术，无时区/日历依赖。
+ * 任何口径变更必须同时改 isPeak / PEAK_WINDOWS / PEAK_WEEKDAYS_ONLY，以及
+ * lib/client.js 里为浏览器侧镜像的同名常量（那边无法 import 本模块）。
+ *
+ * @returns {{ peak: boolean, at: number, ms: number }} peak=切换后所处的时段，
+ *   at=切换发生的时刻（ms 时间戳，新时段在此刻生效），ms=剩余毫秒（不会为负）。
+ */
+export function nextChange(ms) {
+  const now = Number.isFinite(ms) ? ms : Date.now();
+  const current = isPeak(now);
+  // 逐分钟探测（上限 8 天：覆盖"周五晚 → 下周一早"的最长空档）
+  for (let step = 1; step <= 8 * 24 * 60; step += 1) {
+    const at = now + step * 60 * 1000;
+    const peak = isPeak(at);
+    if (peak !== current) return { peak, at, ms: Math.max(0, at - now) };
+  }
+  // 理论上不可达（不变量：一周内必有边界）；兜底给"下一天 09:00"方向的最小值
+  return { peak: !current, at: now, ms: 0 };
+}
+
 /** 清洗一张价格表（形状校验 + 档位回退），供 remote / file 两层共用。 */
 function cleanTable(table) {
   if (!table || typeof table !== 'object') return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dougen/dsh-deepseek-usage",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "DeepSeek 余额侧边栏插件：余额（官方 API）、当前档单价与峰谷时段指示灯，支持中/英文界面。",
   "type": "module",
   "main": "lib/index.js",