@virzz/dsh-plugin-deepseek-balance 1.0.1 → 1.2.0

package/README.md

@@ -1,11 +1,12 @@
 # @virzz/dsh-plugin-deepseek-balance
 
 A [DSH](https://github.com/deepseek-ai/deepseek-harness) plugin that shows the DeepSeek
-official account balance as a row in the sidebar footer, above **Settings**.
+official account balance — and the current peak/off-peak tariff — as a row in the sidebar
+footer, above **Settings**.
 
 ```
 ◆  Cordis Plugin                    0 running
-▤  DeepSeek 余额              $1058.69 · ¥-0.01
+▤  DeepSeek 余额  空闲              $1031.31
 ⚙  设置
 ```
 
@@ -34,6 +35,34 @@ Design notes:
   the browser. The read route returns only balance figures.
 - **Two cadences.** The child collects every 60s; the row re-reads the host's cached
   snapshot every 15s, so no polling happens from the browser.
+- **Positive balances only.** A currency whose total is zero or negative says nothing useful
+  in a balance read-out, so it is left out of both the row and its tooltip. The tooltip
+  reports how many entries were hidden, and the row reads `0` when nothing is positive. The
+  host still returns every currency it receives — the rule is presentation, not data.
+- **The tariff is live.** A chip next to the label shows which DeepSeek price window is in
+  force right now, and the tooltip counts down to the next switch. It is derived from the
+  clock on every tick, not from the balance fetch, so it stays right even when the API is
+  unreachable.
+
+### Peak and off-peak windows
+
+Off-peak costs half of peak. In Beijing time (UTC+8), peak is **Mon–Fri 09:00–12:00 and
+14:00–18:00**; everything else is off-peak. DeepSeek's off-peak discount exists so that batch
+work can be shifted out of the busy hours — the row's tooltip says as much in one line:
+*空闲时段随便蹬* vs *高峰时段建议节约蹬*.
+
+```
+▤  DeepSeek 余额  空闲   $1031.31     ← Mon–Fri outside the windows, weekends, nights
+▤  DeepSeek 余额  高峰   $1031.31     ← Mon–Fri 09:00–12:00, 14:00–18:00
+```
+
+The chip carries the window name only; the price ratio and the countdown to the next switch
+live in the tooltip.
+
+The boundaries are half-open — 12:00 and 18:00 are already off-peak — and the calculation
+applies a fixed +8h shift to epoch milliseconds rather than reading the browser's local time,
+so it is correct wherever the page is opened. `test/period.test.mjs` pins the boundaries,
+both weekend days, and the 63-hour Friday-evening-to-Monday-morning gap.
 
 ## Install into DSH
 
@@ -107,7 +136,7 @@ The row appears in the sidebar footer, directly above **Settings**:
 
 ```
 ◆  Cordis Plugin                    0 running
-▤  DeepSeek 余额              $1058.69 · ¥-0.01
+▤  DeepSeek 余额  空闲              $1058.69
 ⚙  设置
 ```
 
@@ -211,3 +240,11 @@ lines, snapshot, and route JSON without a DSH process:
 ```sh
 DEEPSEEK_API_KEY=... node test/host-smoke.mjs
 ```
+
+`test/period.test.mjs` runs without any credential and is part of the publish workflow's
+`check` job. It lifts the tariff helpers out of `lib/client.js` and asserts them, so the
+boundaries cannot drift from the shipped code:
+
+```sh
+node test/period.test.mjs
+```

package/lib/client.js

@@ -27,11 +27,16 @@ window.__ModuleLoader__.load({
 			".dsb-icon{flex:none;place-items:center;width:16px;height:16px;display:inline-flex;color:var(--dsw-alias-label-secondary)}",
 			".dsb-label{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}",
 			".dsb-value{color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:nowrap;flex:none;margin-left:auto;font-size:12px;line-height:16px}",
+			".dsb-period{flex:none;display:inline-flex;align-items:center;height:18px;padding:0 6px;border:.5px solid currentColor;border-radius:6px;font-size:11px;line-height:1;letter-spacing:.02em;opacity:.85}",
+			'.dsb-row[data-period="off"] .dsb-period{color:var(--dsw-alias-state-success-primary)}',
+			'.dsb-row[data-period="peak"] .dsb-period{color:var(--dsw-alias-state-warn-primary)}',
 			'.dsb-row[data-tone="error"] .dsb-value{color:var(--dsw-alias-state-error-primary)}',
 			'.dsb-row[data-busy="true"] .dsb-value{opacity:.7}',
 			".dsb-row.dsb-rail{width:36px;height:36px;margin:0;padding:0;justify-content:center;gap:0;border-radius:50%}",
-			".dsb-row.dsb-rail .dsb-label,.dsb-row.dsb-rail .dsb-value{display:none}",
+			".dsb-row.dsb-rail .dsb-label,.dsb-row.dsb-rail .dsb-value,.dsb-row.dsb-rail .dsb-period{display:none}",
 			".dsb-railGlyph{color:var(--dsw-alias-label-secondary);font-size:13px;line-height:1}",
+			'.dsb-row.dsb-rail[data-period="off"] .dsb-railGlyph{color:var(--dsw-alias-state-success-primary)}',
+			'.dsb-row.dsb-rail[data-period="peak"] .dsb-railGlyph{color:var(--dsw-alias-state-warn-primary)}',
 		].join("");
 
 		function symbolOf(currency) {
@@ -45,13 +50,67 @@ window.__ModuleLoader__.load({
 			return symbolOf(entry.currency) + entry.total;
 		}
 
-		/** The entry whose figure stands for the account: the first non-zero one, else the first. */
-		function primaryOf(balances) {
+		/**
+		 * Peak pricing windows as minutes after midnight, Beijing time. DeepSeek charges half
+		 * price outside them. Beijing is UTC+8 with no daylight saving, so a fixed shift keeps
+		 * this correct no matter which timezone the browser happens to be in.
+		 */
+		const BEIJING_SHIFT_MS = 8 * 60 * 60 * 1000;
+		const DAY_MS = 24 * 60 * 60 * 1000;
+		const PEAK_WINDOWS = [
+			[9 * 60, 12 * 60],
+			[14 * 60, 18 * 60],
+		];
+
+		/**
+		 * Which tariff applies at an instant: "peak" inside a weekday peak window, else "off".
+		 *
+		 * @param ms - epoch milliseconds.
+		 * @returns the tariff key.
+		 */
+		function periodOf(ms) {
+			const shifted = ms + BEIJING_SHIFT_MS;
+			const day = Math.floor(shifted / DAY_MS);
+			const minute = Math.floor((shifted - day * DAY_MS) / 60000);
+			const weekday = (day + 4) % 7; // 1970-01-01 was a Thursday, so 0 = Sunday here
+			if (weekday < 1 || weekday > 5) return "off";
+			for (let index = 0; index < PEAK_WINDOWS.length; index += 1) {
+				if (minute >= PEAK_WINDOWS[index][0] && minute < PEAK_WINDOWS[index][1]) return "peak";
+			}
+			return "off";
+		}
+
+		/** Whole minutes until the tariff flips. The longest gap is Fri 18:00 → Mon 09:00. */
+		function minutesUntilSwitch(ms) {
+			const current = periodOf(ms);
+			const limit = 4 * 24 * 60;
+			for (let step = 1; step <= limit; step += 1) {
+				if (periodOf(ms + step * 60000) !== current) return step;
+			}
+			return 0;
+		}
+
+		function humanMinutes(total) {
+			if (total <= 0) return "";
+			const hours = Math.floor(total / 60);
+			const minutes = total % 60;
+			if (hours === 0) return minutes + " 分钟";
+			if (minutes === 0) return hours + " 小时";
+			return hours + " 小时 " + minutes + " 分";
+		}
+
+		/**
+		 * The balances worth showing. A currency whose total is zero or negative carries no
+		 * information for a balance read-out, so it is left out of both the row and its
+		 * tooltip — and only counted, so the tooltip can say that something was hidden.
+		 */
+		function positiveOf(balances) {
+			const shown = [];
 			for (let index = 0; index < balances.length; index += 1) {
 				const value = Number(balances[index].total);
-				if (Number.isFinite(value) && value !== 0) return balances[index];
+				if (Number.isFinite(value) && value > 0) shown.push(balances[index]);
 			}
-			return balances.length > 0 ? balances[0] : undefined;
+			return shown;
 		}
 
 		function timeText(ms) {
@@ -97,6 +156,7 @@ window.__ModuleLoader__.load({
 				balances: [],
 				fetchedAt: 0,
 			});
+			const [now, setNow] = React.useState(() => Date.now());
 
 			const load = () => {
 				fetch(ROUTE, { headers: { accept: "application/json" } })
@@ -126,11 +186,26 @@ window.__ModuleLoader__.load({
 
 			React.useEffect(() => {
 				load();
-				const id = setInterval(load, REFRESH_MS);
+				setNow(Date.now());
+				// The tariff flips on wall-clock time rather than on a fetch, so the tick drives
+				// both the clock the period is read from and the snapshot re-read.
+				const id = setInterval(() => {
+					setNow(Date.now());
+					load();
+				}, REFRESH_MS);
 				return () => clearInterval(id);
 			}, []);
 
 			const balances = state.balances;
+			const shown = positiveOf(balances);
+			const hidden = balances.length - shown.length;
+			const period = periodOf(now);
+			const periodShort = period === "peak" ? "高峰" : "空闲";
+			const periodPrice = period === "peak" ? "全价" : "½价";
+			const periodAdvice = period === "peak" ? "高峰时段建议节约蹬" : "空闲时段随便蹬";
+			const untilSwitch = minutesUntilSwitch(now);
+			const periodLine = periodShort + "时段 · " + periodPrice + " · " + periodAdvice
+				+ (untilSwitch > 0 ? "（距切换还有 " + humanMinutes(untilSwitch) + "）" : "");
 			let tone = "loading";
 			let label = "DeepSeek 余额";
 			let value = "…";
@@ -138,12 +213,14 @@ window.__ModuleLoader__.load({
 
 			if (state.phase === "ok") {
 				tone = state.available ? "ok" : "error";
-				value = balances.slice(0, 2).map(amountOf).join(" · ");
-				const lines = ["DeepSeek 余额（常驻 node 采集）"];
-				for (let index = 0; index < balances.length; index += 1) {
-					const entry = balances[index];
+				value = shown.length > 0 ? shown.slice(0, 2).map(amountOf).join(" · ") : "0";
+				const lines = ["DeepSeek 余额（常驻 node 采集）", periodLine];
+				for (let index = 0; index < shown.length; index += 1) {
+					const entry = shown[index];
 					lines.push(entry.currency + " " + entry.total + "（赠金 " + entry.granted + " · 充值 " + entry.toppedUp + "）");
 				}
+				if (shown.length === 0) lines.push("所有币种余额均不大于 0")
+				else if (hidden > 0) lines.push("已隐藏 " + hidden + " 项非正余额")
 				if (state.available !== true) lines.push("该账户当前不可调用");
 				const updated = timeText(state.fetchedAt);
 				if (updated !== "") lines.push("采集于 " + updated);
@@ -156,12 +233,15 @@ window.__ModuleLoader__.load({
 			}
 
 			if (wide !== true) {
-				const primary = primaryOf(balances);
-				const glyph = state.phase === "ok" ? symbolOf(primary === undefined ? "" : primary.currency) : state.phase === "error" ? "!" : "…";
+				const primary = shown.length > 0 ? shown[0] : undefined;
+				const glyph = state.phase === "ok"
+					? (primary === undefined ? "0" : symbolOf(primary.currency))
+					: state.phase === "error" ? "!" : "…";
 				return React.createElement("button", {
 					type: "button",
 					className: "dsb-row dsb-rail",
 					"data-tone": tone,
+					"data-period": period,
 					"data-busy": state.phase === "loading" ? "true" : "false",
 					title: detail,
 					"aria-label": label + " " + value,
@@ -173,6 +253,7 @@ window.__ModuleLoader__.load({
 				type: "button",
 				className: "dsb-row",
 				"data-tone": tone,
+				"data-period": period,
 				"data-busy": state.phase === "loading" ? "true" : "false",
 				title: detail,
 				"aria-label": label + " " + value,
@@ -180,6 +261,7 @@ window.__ModuleLoader__.load({
 			}, [
 				React.createElement("span", { key: "icon", className: "dsb-icon" }, walletGlyph()),
 				React.createElement("span", { key: "label", className: "dsb-label" }, label),
+				React.createElement("span", { key: "period", className: "dsb-period" }, periodShort),
 				React.createElement("span", { key: "value", className: "dsb-value" }, value),
 			]);
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@virzz/dsh-plugin-deepseek-balance",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "DeepSeek official account balance as a DSH sidebar status row, collected by one resident node process",
   "type": "module",
   "main": "lib/index.js",