@lancecheney/dsh-deepseek-balance 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# dsh-deepseek-balance
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) client plugin that renders a compact billing badge to the **left of the "Session log" button** in the web UI:
+
+```
+Spent ¥0.12 | Balance ¥47.17 | Peak | ¥27.0⁺/M output
+```
+
+## Features
+
+- **Balance** — live DeepSeek API balance from `GET /user/balance`, proxied server-side so your API key never reaches the browser.
+- **Spent** — estimated cost of the *current conversation window*, computed from the session's `tokenUsage` projection × the current-period price. Each conversation window shows its own spend.
+- **Peak / Off-peak / Flat** — Beijing-time pricing period (peak: 09:00–12:00 and 14:00–18:00; everything else is off-peak). Before the peak/off-peak scheme takes effect, it shows **Flat** with the pre-change price.
+- **Price** — current-period output price (per 1M tokens) for the selected model, with a small superscript `+` (high) / `++` (max) marker when thinking mode adds extra output.
+- **Model-aware** — switches between DeepSeek-V4-Pro and V4-Flash pricing to match the current conversation's selected model.
+- **Currency-aware** — reads the account currency from the balance (`CNY` / `USD`) and shows `¥` or `$` with the matching price table.
+- **Self-updating** — the host fetches the official pricing docs daily at 01:00 Beijing time (plus once at startup), with a built-in fallback table.
+
+## How pricing is obtained
+
+DeepSeek does not expose a pricing API, so the host half scrapes the official docs page — both the Chinese page for CNY and the English page for USD (`https://api-docs.deepseek.com/quick_start/pricing/`), parses the price tables and the effective date, and serves them to the browser at `/api/deepseek-pricing`. Prices are cached in memory and refreshed daily; on any failure the last-known-good built-in table is used.
+
+## Structure
+
+- `lib/index.js` — host half. Registers `/api/deepseek-balance` (balance proxy) and `/api/deepseek-pricing` (price table).
+- `lib/client.js` — browser half. Renders the badge into the `conversation.session.header.utilities` slot.
+- `cordis.patch.yml` — bundle patch that inserts the plugin row into the host composition.
+- `package.json` — declares `dsh.bundle` + `dsh.client` (web platform) and the `./client` export.
+
+## Install
+
+Via `dsh plugin`:
+
+```sh
+dsh plugin --profile web add @lancecheney/dsh-deepseek-balance
+```
+
+then restart `dsh web` and refresh the page.
+
+Requires a `DEEPSEEK_API_KEY` configured through the harness credential store (or the `DEEPSEEK_API_KEY` environment variable).
+
+## Notes
+
+- The **Spent** figure is an estimate: all tokens in a session are priced at the current period's rate. Real billing is computed by DeepSeek.
+- Reasoning tokens are billed as output tokens; the `+` / `++` marker signals that high/max effort increases output volume, not the unit price.
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,49 @@
+# dsh-deepseek-balance
+
+一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 客户端插件，在网页界面 **「Session log」按钮左侧** 渲染一个紧凑的计费徽章：
+
+```
+消耗 ¥0.12 | 余额 ¥47.17 | 高峰 | ¥27.0⁺/M 输出
+```
+
+## 功能
+
+- **余额** — 实时 DeepSeek API 余额（`GET /user/balance`），由服务端代理请求，浏览器不会接触你的 API Key。
+- **消耗** — 当前对话窗口的估算花费，由会话的 `tokenUsage` 投影 × 当前时段价格计算。每个对话窗口显示各自的消耗。
+- **高峰 / 空闲 / 平价** — 按北京时间判断计费时段（高峰：09:00–12:00、14:00–18:00，其余空闲）。在峰谷定价生效前显示 **平价**（调价前价格）。
+- **价格** — 当前时段的输出单价（每百万 tokens），思考强度为 high/max 时价格数字后带小上标 `+` / `++`。
+- **按模型切换** — 自动在 DeepSeek-V4-Pro 与 V4-Flash 价格间切换，跟随当前会话选中的模型。
+- **按货币切换** — 从余额接口读取账号货币（`CNY` / `USD`），自动显示 `¥` 或 `$` 及对应价格表。
+- **自动更新** — 服务端每天北京时间 01:00（外加启动时一次）抓取官方定价页，失败时回退到内置价格表。
+
+## 价格如何获取
+
+DeepSeek 没有公开的定价 API，因此 host 半区抓取官方文档页（中文页取人民币、英文页取美元，`https://api-docs.deepseek.com/quick_start/pricing/`），解析价格表和生效日期，并通过 `/api/deepseek-pricing` 下发给浏览器。价格缓存在内存中、每天刷新一次；任何失败都会回退到最后一次成功/内置的价格表。
+
+## 结构
+
+- `lib/index.js` — host 半区。注册 `/api/deepseek-balance`（余额代理）与 `/api/deepseek-pricing`（价格表）。
+- `lib/client.js` — 浏览器半区。把徽章渲染进 `conversation.session.header.utilities` 槽位。
+- `cordis.patch.yml` — bundle 补丁，把插件行插入 host 组合。
+- `package.json` — 声明 `dsh.bundle` + `dsh.client`（web 平台）以及 `./client` 导出。
+
+## 安装
+
+通过 `dsh plugin`：
+
+```sh
+dsh plugin --profile web add @lancecheney/dsh-deepseek-balance
+```
+
+然后重启 `dsh web` 并刷新页面。
+
+需要已在 harness 凭据存储中配置 `DEEPSEEK_API_KEY`（或设置 `DEEPSEEK_API_KEY` 环境变量）。
+
+## 说明
+
+- **消耗** 是估算值：会话内所有 token 都按当前时段价格计算，实际扣费以 DeepSeek 服务端为准。
+- 思考链按输出 token 计费；`+` / `++` 只是标记 high/max 思考会增加输出量，并不改变单价。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-deepseek-balance bundle patch: inserts this plugin row into the host composition.
+- insert:
+    - id: deepseek-balance
+      name: '@lancecheney/dsh-deepseek-balance'

package/lib/client.js

@@ -0,0 +1,338 @@
+window.__ModuleLoader__.load({
+	id: "@lancecheney/dsh-deepseek-balance",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+
+		const css = ".Dbg1_root{display:inline-flex;align-items:center;gap:6px;height:32px;border:1px solid var(--dsw-alias-border-l2);border-radius:18px;padding:0 12px;font-family:var(--dsw-font-family);font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);background:0 0;white-space:nowrap;text-decoration:none;cursor:pointer}.Dbg1_root:hover{background:var(--dsw-alias-interactive-bg-hover)}.Dbg1_num{color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums;font-weight:500}.Dbg1_sep{color:var(--dsw-alias-label-dimmed)}.Dbg1_chip{border-radius:9px;padding:0 8px;font-size:11px;line-height:18px;font-weight:600}.Dbg1_peak{color:var(--dsw-alias-state-warn-primary)}.Dbg1_offPeak{color:var(--dsw-alias-state-success-primary)}.Dbg1_legacy{color:var(--dsw-alias-label-tertiary)}.Dbg1_dimmed{color:var(--dsw-alias-label-dimmed)}.Dbg1_plus{font-size:9px;line-height:1;vertical-align:super;color:var(--dsw-alias-state-warn-primary);font-weight:700}.Dbg1_unit{font-size:10px}";
+		const tagId = "@lancecheney/dsh-deepseek-balance/BillingBadge.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@lancecheney/dsh-deepseek-balance";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		const cssModule = { root: "Dbg1_root", num: "Dbg1_num", sep: "Dbg1_sep", chip: "Dbg1_chip", peak: "Dbg1_peak", offPeak: "Dbg1_offPeak", legacy: "Dbg1_legacy", dimmed: "Dbg1_dimmed", plus: "Dbg1_plus", unit: "Dbg1_unit" };
+
+		const MODEL_META = {
+			"deepseek-v4-pro": { label: "DeepSeek-V4-Pro" },
+			"deepseek-v4-flash": { label: "DeepSeek-V4-Flash" }
+		};
+
+		const FALLBACK_PRICING = {
+			effectiveFrom: "2026-08-17T00:00:00+08:00",
+			currencies: {
+				CNY: {
+					symbol: "¥",
+					models: {
+						"deepseek-v4-pro": {
+							legacy: { hit: 0.025, miss: 3.0, output: 6.0 },
+							peak: { hit: 0.30, miss: 9.0, output: 27.0 },
+							offPeak: { hit: 0.15, miss: 4.5, output: 13.5 }
+						},
+						"deepseek-v4-flash": {
+							legacy: { hit: 0.02, miss: 1.0, output: 2.0 },
+							peak: { hit: 0.10, miss: 3.0, output: 9.0 },
+							offPeak: { hit: 0.05, miss: 1.5, output: 4.5 }
+						}
+					}
+				},
+				USD: {
+					symbol: "$",
+					models: {
+						"deepseek-v4-pro": {
+							legacy: { hit: 0.003625, miss: 0.435, output: 0.87 },
+							peak: { hit: 0.044, miss: 1.32, output: 3.96 },
+							offPeak: { hit: 0.022, miss: 0.66, output: 1.98 }
+						},
+						"deepseek-v4-flash": {
+							legacy: { hit: 0.0028, miss: 0.14, output: 0.28 },
+							peak: { hit: 0.014, miss: 0.44, output: 1.32 },
+							offPeak: { hit: 0.007, miss: 0.22, output: 0.66 }
+						}
+					}
+				}
+			}
+		};
+		const DEFAULT_MODEL = "deepseek-v4-pro";
+
+		function beijingDecimalHour(now) {
+			let hour = 0;
+			let minute = 0;
+			try {
+				const parts = new Intl.DateTimeFormat("en-GB", {
+					timeZone: "Asia/Shanghai",
+					hour12: false,
+					hour: "2-digit",
+					minute: "2-digit"
+				}).formatToParts(now);
+				for (const part of parts) {
+					if (part.type === "hour") hour = Number(part.value);
+					if (part.type === "minute") minute = Number(part.value);
+				}
+			} catch {
+				hour = now.getHours();
+				minute = now.getMinutes();
+			}
+			return hour + minute / 60;
+		}
+
+		function periodFor(now, effectiveFrom) {
+			const eff = Date.parse(effectiveFrom);
+			if (Number.isFinite(eff) && now.getTime() < eff) return "legacy";
+			const h = beijingDecimalHour(now);
+			return (h >= 9 && h < 12) || (h >= 14 && h < 18) ? "peak" : "offPeak";
+		}
+
+		function firstBalance(data) {
+			const infos = data && data.balance_infos;
+			if (!Array.isArray(infos) || infos.length === 0) return null;
+			return infos.find((row) => row.currency === "CNY") || infos[0];
+		}
+
+		function fmtPrice(value) {
+			const n = Number(value);
+			return Number.isFinite(n) ? String(n) : String(value);
+		}
+
+		function fmtMoney(value) {
+			const n = Number(value);
+			if (!Number.isFinite(n)) return "—";
+			if (n <= 0) return "0.00";
+			if (n < 0.01) return n.toFixed(4);
+			if (n < 1) return n.toFixed(3);
+			return n.toFixed(2);
+		}
+
+		function costOf(usage, p) {
+			const miss = (usage.uncachedInputTokens ?? 0) + (usage.cacheWriteTokens ?? 0);
+			const hit = usage.cacheReadTokens ?? 0;
+			const output = usage.outputTokens ?? 0;
+			return (miss * p.miss + hit * p.hit + output * p.output) / 1e6;
+		}
+
+		function sumBuckets(a, b) {
+			return {
+				uncachedInputTokens: (a.uncachedInputTokens ?? 0) + (b.uncachedInputTokens ?? 0),
+				outputTokens: (a.outputTokens ?? 0) + (b.outputTokens ?? 0),
+				cacheReadTokens: (a.cacheReadTokens ?? 0) + (b.cacheReadTokens ?? 0),
+				cacheWriteTokens: (a.cacheWriteTokens ?? 0) + (b.cacheWriteTokens ?? 0)
+			};
+		}
+
+		function translate(dict, key, params) {
+			let s = dict[key];
+			if (s === void 0) return key;
+			if (params) {
+				for (const [k, v] of Object.entries(params)) s = s.split(`{${k}}`).join(String(v));
+			}
+			return s;
+		}
+
+		const noopSubscribe = () => () => {};
+
+		function BillingBadge(props) {
+			const useProjection = props.useProjection;
+			const directory = props.directory;
+			const usage = useProjection("tokenUsage");
+			const byPeriod = useProjection("tokenUsageByPeriod");
+			const [state, setState] = react.useState({ phase: "loading" });
+
+			react.useEffect(() => {
+				let alive = true;
+				let timer;
+				const load = async () => {
+					try {
+						const [balanceRes, pricingRes] = await Promise.all([
+							fetch("/api/deepseek-balance", { headers: { accept: "application/json" }, cache: "no-store" }),
+							fetch("/api/deepseek-pricing", { headers: { accept: "application/json" }, cache: "no-store" })
+						]);
+						const balanceData = await balanceRes.json().catch(() => ({}));
+						const pricingData = await pricingRes.json().catch(() => null);
+						if (!alive) return;
+						setState({
+							phase: "ok",
+							balance: balanceRes.ok ? balanceData : null,
+							balanceError: balanceRes.ok ? null : (balanceData.error || `HTTP ${balanceRes.status}`),
+							pricing: pricingData && pricingRes.ok && pricingData.currencies ? pricingData : FALLBACK_PRICING
+						});
+					} catch (error) {
+						if (alive) setState({ phase: "error", message: error instanceof Error ? error.message : String(error) });
+					}
+				};
+				load();
+				timer = setInterval(load, 60000);
+				return () => {
+					alive = false;
+					clearInterval(timer);
+				};
+			}, []);
+
+			const pricing = state.pricing || FALLBACK_PRICING;
+			const effectiveFrom = pricing.effectiveFrom || FALLBACK_PRICING.effectiveFrom;
+			const balanceRow = state.phase === "ok" && state.balance ? firstBalance(state.balance) : null;
+			const currency = balanceRow && balanceRow.currency ? balanceRow.currency : "CNY";
+			const dict = currency === "USD" ? en : zh;
+			const tr = (key, params) => translate(dict, key, params);
+			const pricingSet = (pricing.currencies && pricing.currencies[currency]) || pricing.currencies.CNY || FALLBACK_PRICING.currencies.CNY;
+			const symbol = pricingSet.symbol || "¥";
+			const models = pricingSet.models || FALLBACK_PRICING.currencies.CNY.models;
+
+			const modelState = react.useSyncExternalStore(
+				directory ? (fn) => directory.subscribe(fn) : noopSubscribe,
+				() => (directory ? directory.getSnapshot() : null)
+			);
+			const currentSelection = modelState && modelState.current ? modelState.current : null;
+			const modelId = currentSelection && currentSelection.model ? currentSelection.model : DEFAULT_MODEL;
+			const reasoningEffort = currentSelection ? currentSelection.reasoningEffort : void 0;
+
+			const period = periodFor(new Date(), effectiveFrom);
+			const isPeak = period === "peak";
+			const isLegacy = period === "legacy";
+			const model = models[modelId] || models[DEFAULT_MODEL] || FALLBACK_PRICING.currencies.CNY.models[DEFAULT_MODEL];
+			const p = (period === "peak" ? model.peak : period === "offPeak" ? model.offPeak : model.legacy) || model.peak;
+			const outputPrice = fmtPrice(p.output);
+			const cost = (() => {
+				if (byPeriod && byPeriod.peak && byPeriod.offPeak) {
+					if (isLegacy) {
+						return model.legacy ? costOf(sumBuckets(byPeriod.peak, byPeriod.offPeak), model.legacy) : null;
+					}
+					return costOf(byPeriod.peak, model.peak) + costOf(byPeriod.offPeak, model.offPeak);
+				}
+				return usage !== undefined && usage !== null ? costOf(usage, p) : null;
+			})();
+
+			// off -> base price; high (default) -> one +; max -> two +.
+			const plus = reasoningEffort === "max" ? "++" : reasoningEffort === "off" ? "" : "+";
+
+			const periodClass = isLegacy ? cssModule.legacy : isPeak ? cssModule.peak : cssModule.offPeak;
+			const periodLabel = isLegacy ? tr("period.legacy") : isPeak ? tr("period.peak") : tr("period.offPeak");
+
+			const tooltipParts = [
+				isLegacy ? tr("period.legacyNote") : tr("period.peakHours"),
+				isLegacy ? "" : tr("period.offPeakNote"),
+				"",
+				`${tr("label.model")}: ${(MODEL_META[modelId] || {}).label || modelId}${reasoningEffort ? ` · ${reasoningEffort}` : ""}`,
+				tr("reasoning.note")
+			].filter((line) => line !== "");
+			if (cost !== null && usage) {
+				tooltipParts.push(
+					"",
+					`${tr("label.spent")}: ${symbol}${fmtMoney(cost)} (${tr("cost.estimate")})`,
+					tr("cost.breakdown", {
+						miss: (usage.uncachedInputTokens ?? 0) + (usage.cacheWriteTokens ?? 0),
+						hit: usage.cacheReadTokens ?? 0,
+						output: usage.outputTokens ?? 0
+					})
+				);
+			}
+			tooltipParts.push("");
+			for (const [id, info] of Object.entries(models)) {
+				const meta = MODEL_META[id] || {};
+				const row = tr("price.row", { sym: symbol, hit: fmtPrice(info.peak.hit), miss: fmtPrice(info.peak.miss), output: fmtPrice(info.peak.output) });
+				const off = tr("price.row", { sym: symbol, hit: fmtPrice(info.offPeak.hit), miss: fmtPrice(info.offPeak.miss), output: fmtPrice(info.offPeak.output) });
+				const legacy = info.legacy ? tr("price.row", { sym: symbol, hit: fmtPrice(info.legacy.hit), miss: fmtPrice(info.legacy.miss), output: fmtPrice(info.legacy.output) }) : null;
+				tooltipParts.push(
+					`${meta.label || id} — ${tr("period.peak")}: ${row} / ${tr("period.offPeak")}: ${off}${legacy ? ` / ${tr("period.legacy")}: ${legacy}` : ""}`
+				);
+			}
+			const tooltip = tooltipParts.join("\n");
+
+			const sep = (key) => react.createElement("span", { key, className: cssModule.sep, "aria-hidden": true }, "|");
+
+			const segs = [];
+			segs.push(react.createElement("span", { key: "spent" },
+				tr("label.spent"), " ",
+				cost === null
+					? react.createElement("span", { className: cssModule.num }, "—")
+					: react.createElement("span", { className: cssModule.num },
+						react.createElement("span", { className: cssModule.unit }, symbol),
+						fmtMoney(cost))));
+			segs.push(sep("sep1"));
+			segs.push(react.createElement("span", { key: "balance" },
+				tr("label.balance"), " ",
+				balanceRow === null
+					? react.createElement("span", { className: cssModule.num }, state.phase === "loading" ? "…" : tr("balance.unavailable"))
+					: react.createElement("span", { className: cssModule.num },
+						react.createElement("span", { className: cssModule.unit }, symbol),
+						fmtMoney(Number(balanceRow.total_balance)))));
+			segs.push(sep("sep2"));
+			segs.push(react.createElement("span", { key: "period", className: `${cssModule.chip} ${periodClass}` }, periodLabel));
+			segs.push(sep("sep3"));
+			segs.push(react.createElement("span", { key: "price" },
+				react.createElement("span", { className: cssModule.unit }, symbol),
+				outputPrice,
+				react.createElement("span", { className: cssModule.unit }, tr("price.perM")),
+				plus !== "" ? react.createElement("span", { className: cssModule.plus }, plus) : null));
+
+			return react.createElement("a", { className: cssModule.root, title: tooltip, href: "https://platform.deepseek.com/usage", target: "_blank", rel: "noreferrer noopener" }, segs);
+		}
+
+		const NS = "deepseek-balance";
+		const zh = {
+			"label.spent": "消耗",
+			"label.balance": "余额",
+			"label.model": "模型",
+			"period.peak": "高峰",
+			"period.offPeak": "空闲",
+			"period.legacy": "平价",
+			"period.legacyNote": "当前为调价前平价（8/17 前）",
+			"period.peakHours": "高峰：09:00–12:00、14:00–18:00（北京时间）",
+			"period.offPeakNote": "空闲：其余时段",
+			"balance.unavailable": "余额不可用",
+			"price.perM": "/M",
+			"price.unit": "输出",
+			"price.row": "命中{sym}{hit}/未命中{sym}{miss}/输出{sym}{output}",
+			"cost.estimate": "按当前时段价格估算",
+			"cost.breakdown": "输入(未命中) {miss} · 输入(命中) {hit} · 输出 {output} tokens",
+			"reasoning.note": "思考链按输出 token 计费；+ / ++ 表示 high / max 思考会额外增加输出量"
+		};
+		const en = {
+			"label.spent": "Spent",
+			"label.balance": "Balance",
+			"label.model": "Model",
+			"period.peak": "Peak",
+			"period.offPeak": "Off-peak",
+			"period.legacy": "Flat",
+			"period.legacyNote": "Pre-change flat pricing (before Aug 17)",
+			"period.peakHours": "Peak: 01:00–04:00, 06:00–10:00 UTC",
+			"period.offPeakNote": "Off-peak: all other hours",
+			"balance.unavailable": "balance unavailable",
+			"price.perM": "/M",
+			"price.unit": "output",
+			"price.row": "hit {sym}{hit}/miss {sym}{miss}/output {sym}{output}",
+			"cost.estimate": "estimated at the current period's price",
+			"cost.breakdown": "input(miss) {miss} · input(hit) {hit} · output {output} tokens",
+			"reasoning.note": "Reasoning tokens are billed as output; + / ++ mark high / max effort which adds extra output"
+		};
+
+		const inject = ["slots", "locale"];
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, { zh, en }), "deepseek-balance: dictionaries");
+			ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+				name: "conversation.session.header.utilities",
+				id: "deepseek-balance",
+				order: -100,
+				inject: (sessionId) => {
+					const models = ctx.get("modelDirectories");
+					let directory;
+					if (models && typeof models.directoryFor === "function") {
+						try {
+							directory = models.directoryFor(sessionId);
+						} catch {}
+					}
+					return { directory: directory ? directory.store : void 0 };
+				}
+			}, BillingBadge));
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,431 @@
+import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { z } from "zod";
+
+/**
+ * @lancecheney/dsh-deepseek-balance — host half.
+ * - `/api/deepseek-balance` proxies DeepSeek `GET /user/balance` (carries the account currency).
+ * - `/api/deepseek-pricing` serves CNY + USD price tables, refreshed daily at
+ *   01:00 Beijing time from the official docs, with a hardcoded fallback.
+ */
+
+const name = "deepseek-balance";
+const inject = ["webServer", "credentials", "settings"];
+
+const DEFAULT_BASE_URL = "https://api.deepseek.com";
+const DEFAULT_KEY_ENV = "DEEPSEEK_API_KEY";
+const UPSTREAM_TIMEOUT_MS = 8000;
+const PRICING_CN_URL = "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/";
+const PRICING_US_URL = "https://api-docs.deepseek.com/quick_start/pricing/";
+const PRICING_FETCH_TIMEOUT_MS = 15000;
+
+/** Last-known-good prices: legacy + the 2026-08-17 peak/off-peak table, per currency. */
+const FALLBACK_PRICING = {
+	effectiveFrom: "2026-08-17T00:00:00+08:00",
+	currencies: {
+		CNY: {
+			symbol: "¥",
+			models: {
+				"deepseek-v4-flash": {
+					legacy: { hit: 0.02, miss: 1.0, output: 2.0 },
+					peak: { hit: 0.10, miss: 3.0, output: 9.0 },
+					offPeak: { hit: 0.05, miss: 1.5, output: 4.5 }
+				},
+				"deepseek-v4-pro": {
+					legacy: { hit: 0.025, miss: 3.0, output: 6.0 },
+					peak: { hit: 0.30, miss: 9.0, output: 27.0 },
+					offPeak: { hit: 0.15, miss: 4.5, output: 13.5 }
+				}
+			}
+		},
+		USD: {
+			symbol: "$",
+			models: {
+				"deepseek-v4-flash": {
+					legacy: { hit: 0.0028, miss: 0.14, output: 0.28 },
+					peak: { hit: 0.014, miss: 0.44, output: 1.32 },
+					offPeak: { hit: 0.007, miss: 0.22, output: 0.66 }
+				},
+				"deepseek-v4-pro": {
+					legacy: { hit: 0.003625, miss: 0.435, output: 0.87 },
+					peak: { hit: 0.044, miss: 1.32, output: 3.96 },
+					offPeak: { hit: 0.022, miss: 0.66, output: 1.98 }
+				}
+			}
+		}
+	}
+};
+
+function json(res, status, body) {
+	const payload = JSON.stringify(body);
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store"
+	});
+	res.end(payload);
+}
+
+function resolveSettingsSection(ctx) {
+	try {
+		const settings = ctx.get("settings");
+		if (settings && typeof settings.get === "function") {
+			return settings.get(settingsNamespace("llm-deepseek"));
+		}
+	} catch {}
+	return void 0;
+}
+
+async function resolveDeepSeekFacts(ctx) {
+	const section = resolveSettingsSection(ctx);
+	const apiKeyEnv =
+		section && typeof section === "object" && typeof section.apiKeyEnv === "string" && section.apiKeyEnv.length > 0
+			? section.apiKeyEnv
+			: DEFAULT_KEY_ENV;
+	const baseURL =
+		(section && typeof section === "object" && typeof section.baseURL === "string" && section.baseURL.length > 0
+			? section.baseURL
+			: process.env.DEEPSEEK_BASE_URL) || DEFAULT_BASE_URL;
+
+	let apiKey;
+	const credentials = ctx.get("credentials");
+	if (credentials && typeof credentials.resolve === "function") {
+		try {
+			const hit = await credentials.resolve(credentialRef(apiKeyEnv));
+			if (hit && hit.value) apiKey = hit.value;
+		} catch {}
+	}
+	if (!apiKey) apiKey = process.env[apiKeyEnv];
+	if (!apiKey) throw new Error(`no DeepSeek API key (resolve ${apiKeyEnv} through credentials or env)`);
+
+	return { apiKey, baseURL: String(baseURL).replace(/\/+$/, "") };
+}
+
+function isTrustedRead(req) {
+	if (req.headers["sec-fetch-site"] === "cross-site") return false;
+	const origin = req.headers.origin;
+	if (origin === void 0) return true;
+	try {
+		const originHost = new URL(origin).host;
+		const host = req.headers.host ?? "";
+		const hostWithoutPort = host.replace(/:\d+$/, "");
+		return originHost === hostWithoutPort || originHost.replace(/:\d+$/, "") === hostWithoutPort;
+	} catch {
+		return false;
+	}
+}
+
+function stripTags(html) {
+	return html
+		.replace(/<script[\s\S]*?<\/script>/gi, " ")
+		.replace(/<style[\s\S]*?<\/style>/gi, " ")
+		.replace(/<[^>]+>/g, " ")
+		.replace(/&nbsp;/g, " ")
+		.replace(/&amp;/g, "&")
+		.replace(/\s+/g, " ");
+}
+
+const number = (match, index) => {
+	const value = Number(match[index]);
+	return Number.isFinite(value) ? value : void 0;
+};
+
+/** Parse the zh-CN docs page: CNY prices + the effective date. */
+function parseCnPricing(html) {
+	const text = stripTags(html);
+	const parseModel = (id) => {
+		const re = new RegExp(id + "\\s+空闲时段\\s+([\\d.]+)元\\s+([\\d.]+)元\\s+([\\d.]+)元\\s+高峰时段\\s+([\\d.]+)元\\s+([\\d.]+)元\\s+([\\d.]+)元");
+		const m = text.match(re);
+		if (!m) return void 0;
+		return {
+			offPeak: { hit: number(m, 1), miss: number(m, 2), output: number(m, 3) },
+			peak: { hit: number(m, 4), miss: number(m, 5), output: number(m, 6) }
+		};
+	};
+	const flash = parseModel("deepseek-v4-flash");
+	const pro = parseModel("deepseek-v4-pro");
+	if (!flash || !pro) throw new Error("CNY peak/off-peak table not found");
+
+	let effectiveFrom = FALLBACK_PRICING.effectiveFrom;
+	const dm = text.match(/北京时间\s*(\d{4})\s*年\s*(\d{1,2})\s*月\s*(\d{1,2})\s*日\s*(\d{1,2}):(\d{2})/);
+	if (dm) {
+		const [y, mo, d, h, mi] = [1, 2, 3, 4, 5].map((i) => Number(dm[i]));
+		effectiveFrom = `${y}-${String(mo).padStart(2, "0")}-${String(d).padStart(2, "0")}T${String(h).padStart(2, "0")}:${String(mi).padStart(2, "0")}:00+08:00`;
+	}
+
+	let legacy;
+	const lm = text.match(/百万tokens输入（缓存命中）\s*([\d.]+)元\s*([\d.]+)元\s*百万tokens输入（缓存未命中）\s*([\d.]+)元\s*([\d.]+)元\s*百万tokens输出\s*([\d.]+)元\s*([\d.]+)元/);
+	if (lm) {
+		legacy = {
+			flash: { hit: number(lm, 1), miss: number(lm, 3), output: number(lm, 5) },
+			pro: { hit: number(lm, 2), miss: number(lm, 4), output: number(lm, 6) }
+		};
+	}
+
+	return {
+		effectiveFrom,
+		models: {
+			"deepseek-v4-flash": { ...(legacy?.flash ? { legacy: legacy.flash } : {}), peak: flash.peak, offPeak: flash.offPeak },
+			"deepseek-v4-pro": { ...(legacy?.pro ? { legacy: legacy.pro } : {}), peak: pro.peak, offPeak: pro.offPeak }
+		}
+	};
+}
+
+/** Parse the English docs page: USD prices. */
+function parseUsModels(html) {
+	const text = stripTags(html);
+	const parseModel = (id) => {
+		const re = new RegExp(id + "\\s+OFF-PEAK\\s+\\$([\\d.]+)\\s+\\$([\\d.]+)\\s+\\$([\\d.]+)\\s+PEAK\\s+\\$([\\d.]+)\\s+\\$([\\d.]+)\\s+\\$([\\d.]+)", "i");
+		const m = text.match(re);
+		if (!m) return void 0;
+		return {
+			offPeak: { hit: number(m, 1), miss: number(m, 2), output: number(m, 3) },
+			peak: { hit: number(m, 4), miss: number(m, 5), output: number(m, 6) }
+		};
+	};
+	const flash = parseModel("deepseek-v4-flash");
+	const pro = parseModel("deepseek-v4-pro");
+	if (!flash || !pro) throw new Error("USD peak/off-peak table not found");
+
+	let legacy;
+	const lm = text.match(/1M INPUT TOKENS \(CACHE HIT\)\s+\$([\d.]+)\s+\$([\d.]+)\s+1M INPUT TOKENS \(CACHE MISS\)\s+\$([\d.]+)\s+\$([\d.]+)\s+1M OUTPUT TOKENS\s+\$([\d.]+)\s+\$([\d.]+)/i);
+	if (lm) {
+		legacy = {
+			flash: { hit: number(lm, 1), miss: number(lm, 3), output: number(lm, 5) },
+			pro: { hit: number(lm, 2), miss: number(lm, 4), output: number(lm, 6) }
+		};
+	}
+
+	return {
+		"deepseek-v4-flash": { ...(legacy?.flash ? { legacy: legacy.flash } : {}), peak: flash.peak, offPeak: flash.offPeak },
+		"deepseek-v4-pro": { ...(legacy?.pro ? { legacy: legacy.pro } : {}), peak: pro.peak, offPeak: pro.offPeak }
+	};
+}
+
+const pricing = { data: FALLBACK_PRICING, fetchedAt: 0, source: "fallback" };
+let pricingRefresh = null;
+
+async function refreshPricing(ctx) {
+	if (pricingRefresh) return pricingRefresh;
+	pricingRefresh = (async () => {
+		const warn = (message) => {
+			if (ctx?.logger?.warn) ctx.logger.warn(`deepseek-balance: ${message}`);
+		};
+		let effectiveFrom = FALLBACK_PRICING.effectiveFrom;
+		let cnModels = FALLBACK_PRICING.currencies.CNY.models;
+		let usModels = FALLBACK_PRICING.currencies.USD.models;
+		try {
+			const [cnRes, usRes] = await Promise.all([
+				fetch(PRICING_CN_URL, { signal: AbortSignal.timeout(PRICING_FETCH_TIMEOUT_MS), headers: { accept: "text/html" } }),
+				fetch(PRICING_US_URL, { signal: AbortSignal.timeout(PRICING_FETCH_TIMEOUT_MS), headers: { accept: "text/html" } })
+			]);
+			if (cnRes.ok) {
+				try {
+					const parsed = parseCnPricing(await cnRes.text());
+					effectiveFrom = parsed.effectiveFrom;
+					cnModels = parsed.models;
+				} catch (error) {
+					warn(`CNY pricing parse failed: ${error instanceof Error ? error.message : String(error)}`);
+				}
+			} else {
+				warn(`CNY pricing docs HTTP ${cnRes.status}`);
+			}
+			if (usRes.ok) {
+				try {
+					usModels = parseUsModels(await usRes.text());
+				} catch (error) {
+					warn(`USD pricing parse failed: ${error instanceof Error ? error.message : String(error)}`);
+				}
+			} else {
+				warn(`USD pricing docs HTTP ${usRes.status}`);
+			}
+			pricing.data = {
+				effectiveFrom,
+				currencies: {
+					CNY: { symbol: "¥", models: cnModels },
+					USD: { symbol: "$", models: usModels }
+				}
+			};
+			pricing.fetchedAt = Date.now();
+			pricing.source = "docs";
+		} catch (error) {
+			warn(`pricing refresh failed (keeping fallback): ${error instanceof Error ? error.message : String(error)}`);
+		} finally {
+			pricingRefresh = null;
+		}
+	})();
+	return pricingRefresh;
+}
+
+function msUntilNextHourBeijing(hour) {
+	const now = new Date();
+	const beijing = new Date(now.getTime() + 8 * 3600 * 1000);
+	const bHour = beijing.getUTCHours();
+	const bMinute = beijing.getUTCMinutes();
+	const bSecond = beijing.getUTCSeconds();
+	const bMs = beijing.getUTCMilliseconds();
+	let deltaHours = hour - bHour;
+	if (deltaHours < 0 || (deltaHours === 0 && (bMinute > 0 || bSecond > 0 || bMs > 0))) deltaHours += 24;
+	return deltaHours * 3600 * 1000 - bMinute * 60 * 1000 - bSecond * 1000 - bMs;
+}
+
+/** Beijing hour of a timestamp (UTC+8, no DST). */
+function beijingHourOf(time) {
+	return new Date(time + 8 * 3600 * 1000).getUTCHours();
+}
+
+function isPeakHour(hour) {
+	return (hour >= 9 && hour < 12) || (hour >= 14 && hour < 18);
+}
+
+const bucketSchema = z.object({
+	uncachedInputTokens: z.number().int().nonnegative(),
+	outputTokens: z.number().int().nonnegative(),
+	cacheReadTokens: z.number().int().nonnegative(),
+	cacheWriteTokens: z.number().int().nonnegative()
+});
+
+const tokenUsageByPeriodSchema = z.object({
+	peak: bucketSchema,
+	offPeak: bucketSchema
+});
+
+const zeroBucket = () => ({ uncachedInputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 });
+
+const bucketsFrom = (usage) => ({
+	uncachedInputTokens: usage.inputTokens,
+	outputTokens: usage.outputTokens,
+	cacheReadTokens: usage.cacheReadTokens ?? 0,
+	cacheWriteTokens: usage.cacheWriteTokens ?? 0
+});
+
+const bucketsEqual = (a, b) =>
+	a.uncachedInputTokens === b.uncachedInputTokens &&
+	a.outputTokens === b.outputTokens &&
+	a.cacheReadTokens === b.cacheReadTokens &&
+	a.cacheWriteTokens === b.cacheWriteTokens;
+
+const addBucket = (total, delta) => ({
+	uncachedInputTokens: total.uncachedInputTokens + delta.uncachedInputTokens,
+	outputTokens: total.outputTokens + delta.outputTokens,
+	cacheReadTokens: total.cacheReadTokens + delta.cacheReadTokens,
+	cacheWriteTokens: total.cacheWriteTokens + delta.cacheWriteTokens
+});
+
+const subtractBucket = (total, delta) => ({
+	uncachedInputTokens: total.uncachedInputTokens - delta.uncachedInputTokens,
+	outputTokens: total.outputTokens - delta.outputTokens,
+	cacheReadTokens: total.cacheReadTokens - delta.cacheReadTokens,
+	cacheWriteTokens: total.cacheWriteTokens - delta.cacheWriteTokens
+});
+
+/**
+ * Whole-log token usage bucketed by Beijing-time peak/off-peak hour, so the
+ * client can price each hour at its own rate. Replacement semantics mirror the
+ * token-meter `tokenUsage` projection: an assistant/message finalizes the usage
+ * for its turn/step, replacing an earlier usage chunk instead of double counting.
+ */
+const tokenUsageByPeriodProjection = {
+	key: "tokenUsageByPeriod",
+	schema: tokenUsageByPeriodSchema,
+	init: () => ({ totals: { peak: zeroBucket(), offPeak: zeroBucket() }, last: null }),
+	apply: (state, event) => {
+		let turn;
+		let step;
+		let usage;
+		if (event.type === "assistant/chunk" && event.data.chunk.type === "usage") {
+			({ turn, step } = event.data);
+			usage = event.data.chunk.usage;
+		} else if (event.type === "assistant/message" && event.data.usage !== void 0) {
+			({ turn, step, usage } = event.data);
+		} else {
+			return state;
+		}
+		const period = isPeakHour(beijingHourOf(event.time)) ? "peak" : "offPeak";
+		const buckets = bucketsFrom(usage);
+		const previous = state.last !== null && state.last.turn === turn && state.last.step === step ? state.last : void 0;
+		if (previous !== void 0 && previous.period === period && bucketsEqual(previous.buckets, buckets)) return state;
+		const totals = { peak: state.totals.peak, offPeak: state.totals.offPeak };
+		if (previous !== void 0) totals[previous.period] = subtractBucket(totals[previous.period], previous.buckets);
+		totals[period] = addBucket(totals[period], buckets);
+		return { totals, last: { turn, step, period, buckets } };
+	},
+	view: (state) => state.totals,
+	stateVersion: 1
+};
+
+function apply(ctx) {
+	ctx.inject(["sessionProjections"], (projectionCtx) => {
+		projectionCtx.sessionProjections.register(tokenUsageByPeriodProjection);
+	});
+
+	const balanceHandler = async (req, res) => {
+		if (req.method !== "GET" && req.method !== "HEAD") {
+			json(res, 405, { error: "method not allowed" });
+			return;
+		}
+		if (!isTrustedRead(req)) {
+			json(res, 403, { error: "forbidden" });
+			return;
+		}
+		try {
+			const { apiKey, baseURL } = await resolveDeepSeekFacts(ctx);
+			const upstream = await fetch(`${baseURL}/user/balance`, {
+				method: "GET",
+				headers: {
+					authorization: `Bearer ${apiKey}`,
+					accept: "application/json"
+				},
+				signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+			});
+			const body = await upstream.json().catch(() => ({}));
+			if (!upstream.ok) {
+				const message = body?.error?.message || `DeepSeek balance API HTTP ${upstream.status}`;
+				json(res, upstream.status === 401 || upstream.status === 403 ? 401 : 502, { error: message });
+				return;
+			}
+			json(res, 200, body);
+		} catch (error) {
+			json(res, 502, { error: error instanceof Error ? error.message : String(error) });
+		}
+	};
+
+	const pricingHandler = async (req, res) => {
+		if (req.method !== "GET" && req.method !== "HEAD") {
+			json(res, 405, { error: "method not allowed" });
+			return;
+		}
+		if (!isTrustedRead(req)) {
+			json(res, 403, { error: "forbidden" });
+			return;
+		}
+		if (pricing.fetchedAt === 0) {
+			try {
+				await refreshPricing(ctx);
+			} catch {}
+		}
+		json(res, 200, {
+			...pricing.data,
+			fetchedAt: pricing.fetchedAt,
+			source: pricing.source
+		});
+	};
+
+	ctx.effect(() => ctx.webServer.register({ kind: "exact", path: "/api/deepseek-balance", handler: balanceHandler }), "deepseek-balance: /api/deepseek-balance route");
+	ctx.effect(() => ctx.webServer.register({ kind: "exact", path: "/api/deepseek-pricing", handler: pricingHandler }), "deepseek-balance: /api/deepseek-pricing route");
+
+	ctx.effect(() => {
+		refreshPricing(ctx).catch(() => {});
+		let timer;
+		const schedule = () => {
+			const delay = msUntilNextHourBeijing(1);
+			timer = setTimeout(async () => {
+				await refreshPricing(ctx).catch(() => {});
+				schedule();
+			}, delay);
+		};
+		schedule();
+		return () => clearTimeout(timer);
+	}, "deepseek-balance: daily 01:00 Beijing pricing refresh");
+}
+
+export { apply, inject, name };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@lancecheney/dsh-deepseek-balance",
+  "description": "Session-header DeepSeek API balance, per-conversation spend, and peak/off-peak pricing indicator",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": ["lib", "cordis.patch.yml", "README.md", "README.zh.md"],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  }
+}