@dougen/dsh-deepseek-usage 0.1.2

package/README.md

@@ -0,0 +1,99 @@
+# dsh-deepseek-usage
+
+一个给 DeepSeek Harness（DSH）**网页界面**用的插件：在**侧边栏底部**常驻显示你的 **DeepSeek 账号用量**卡片 —— 余额、今日花费、今日 Token、今日 API 请求次数与高峰/空闲计费时段指示灯。
+
+与动态插件不同，它是**正式的可安装 cordis 插件**：随 profile 组合启动，**刷新页面 / 重启服务后依然存在**。
+
+## 功能
+
+- 第一行：`余额 ¥110.00`
+- 第二行：`今日 ¥2.94 · 36.9M · 170`（今日花费 / 今日 Token / 今日 API 请求次数，带图标）
+- 第三行：`↑1.5 · 💾0.05 · ↓4.5`（输入 / 缓存命中 / 输出 单价，按当前启用模型与峰谷时段自动切换）+ 右下角时间（刷新时显示旋转 ⟳ 图标，仅作刷新中的状态指示）
+- 右上角：高峰/空闲状态指示灯（9:00–14:00 为高峰，橙色；其余空闲，绿色；悬停提示时段）
+- 每 60 秒自动刷新；点击卡片任意位置也可刷新
+- 折叠 rail 态显示紧凑余额 + 状态灯
+- 跟随应用明暗主题（`--dsw-*` 变量，含兜底值）
+- 错误状态明确（未配置 Key / 网络失败 / 接口报错）
+
+## 安装
+
+需要 DSH CLI 与 [pnpm](https://pnpm.io/installation)。
+
+```sh
+# 1) 打包（把包真实安装进 profile 的 node_modules，保证 ESM 依赖解析正确）
+cd dsh-deepseek-usage
+pnpm pack                       # 生成 dsh-deepseek-usage-<version>.tgz
+
+# 2) 安装
+dsh plugin --profile web add D:\path\to\dsh-deepseek-usage-0.1.2.tgz
+#    或直接从 npm 安装（发布到 npm 后）：
+#    dsh plugin --profile web add @dougen/dsh-deepseek-usage
+```
+
+> 注意：不要用目录路径 `dsh plugin add <目录>`——pnpm 会以 link 方式安装，包的真实路径在工作区外，ESM 无法解析到 peer 依赖（`@deepseek-ai/dsh-*`）。务必安装 tarball 或 npm 包（真实拷贝进 profile 的 node_modules）。
+
+包声明了 `dsh.bundle`，`dsh plugin` 会自动把它加入 profile 的 bundle 层。之后：
+
+1. 重启网页应用：`dsh web`（bundle 层在启动时读取）。
+2. 打开 http://127.0.0.1:3080 。
+3. 侧边栏底部（Cordis 面板按钮下方）即出现用量卡片，刷新页面也不会消失。
+
+> 手动方式：把包放进 profile 的 `node_modules`，并在 `~/.dsh/profiles/web/cordis.patch.yml` 追加：
+>
+> ```yaml
+> - insert:
+>     - id: deepseek-usage
+>       name: dsh-deepseek-usage
+> ```
+
+## 数据来源
+
+| 数据 | 来源 |
+|---|---|
+| 余额 | DeepSeek 官方 `GET /user/balance`（API Key 经凭证服务 `DEEPSEEK_API_KEY` 解析，不出本机） |
+| 今日花费 | ① 官方（优先）：配置 `DEEPSEEK_PLATFORM_TOKEN` 后走平台用量接口；② 估算（兜底）：本地会话日志 token × 官方峰谷价格表（估算值以 `≈` 前缀标识） |
+| 今日 Token / API 次数 | 本地会话日志统计（官方 API 无用量查询接口），覆盖全部会话，含重启前历史 |
+
+### 可选：官方今日消费（`DEEPSEEK_PLATFORM_TOKEN`）
+
+DeepSeek 官方 API 不提供用量查询接口，但平台控制台的用量页有同源接口。登录 https://platform.deepseek.com ，打开 DevTools → Console 执行：
+
+```js
+JSON.parse(localStorage.getItem('userToken')).value
+```
+
+把返回值存为凭证（例如追加到 `~/.dsh/.credentials.yaml`）：
+
+```yaml
+DEEPSEEK_PLATFORM_TOKEN: <令牌>
+```
+
+配置后卡片显示官方今日消费；令牌过期（或未配置）时自动回退为本地日志估算（带 `≈`）。
+
+## 工作原理
+
+| 部分 | 文件 | 作用 |
+|---|---|---|
+| Host 半 | `lib/index.js` | Cordis 插件（`inject: credentials, webServer`），注册 `GET /api/deepseek-usage`；解析余额、平台今日消费、本地日志用量统计（按 `message.source.model` + 事件时刻峰谷单价计价，20s 缓存） |
+| 定价 | `lib/pricing.js` | 官方价格表（2026-08-17 峰谷价），调整价格只改此文件 |
+| 浏览器半 | `lib/client.js` | `dsh.client` web 包，注册 `sidebar.footer.action` 槽位卡片，60s 轮询 |
+| 组合层 | `cordis.patch.yml` | `dsh.bundle` 补丁层，插入加载项 |
+
+## 开发
+
+```sh
+# 修改 lib/index.js / lib/client.js / lib/pricing.js 后重新打包安装：
+pnpm pack
+dsh plugin --profile web add <生成的 .tgz>
+# 重启 dsh web，硬刷新页面
+```
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove dsh-deepseek-usage
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-deepseek-usage — DeepSeek 用量侧边栏插件。
+# Host 半注册 GET /api/deepseek-usage；包声明 dsh.client 提供浏览器侧边栏卡片。
+- insert:
+    - id: deepseek-usage
+      name: dsh-deepseek-usage

package/lib/client.js

@@ -0,0 +1,273 @@
+// dsh-deepseek-usage — browser half.
+//
+// 侧边栏底部用量卡片（注册进 `sidebar.footer.action` 槽位，独占一行，位于
+// Cordis 面板按钮下方）。轮询宿主路由 `/api/deepseek-usage`（见 lib/index.js）
+// 每 60 秒一次，点击卡片任意位置可立即刷新；时间旁的 ⟳ 图标仅作刷新中的状态显示。
+// 样式仅使用 `--dsw-*` 主题变量（含兜底值），跟随明暗主题。
+window.__ModuleLoader__.load({
+	id: "dsh-deepseek-usage",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		const { useState, useEffect, useCallback, useRef } = react;
+		const h = react.createElement;
+
+		// ---- constants -------------------------------------------------
+		const POLL_MS = 60 * 1000;
+		const USAGE_PATH = "/api/deepseek-usage";
+
+		// ---- helpers ---------------------------------------------------
+		function money(value, currency) {
+			const n = Number(value);
+			if (!Number.isFinite(n)) return "—";
+			const symbol = currency === "USD" ? "$" : "¥";
+			return `${symbol}${n.toFixed(2)}`;
+		}
+
+		function fmtTokens(value) {
+			const n = Number(value);
+			if (!Number.isFinite(n)) return "—";
+			if (n >= 1e6) return (n / 1e6).toFixed(1) + "M";
+			if (n >= 1e3) return (n / 1e3).toFixed(1) + "k";
+			return String(n);
+		}
+
+		function fmtPrice(value) {
+			const n = Number(value);
+			if (!Number.isFinite(n)) return "—";
+			return String(parseFloat(n.toFixed(2)));
+		}
+
+		function fmtTime(ms) {
+			const d = new Date(ms);
+			const p = (x) => String(x).padStart(2, "0");
+			return `${p(d.getHours())}:${p(d.getMinutes())}`;
+		}
+
+		// 主题变量（带兜底值）
+		const C = {
+			bg: "var(--dsw-alias-bg-layer-1, rgba(127,127,127,.12))",
+			border: "var(--dsw-alias-border-l1, rgba(127,127,127,.35))",
+			label: "var(--dsw-alias-label-primary, #111)",
+			sub: "var(--dsw-alias-label-secondary, rgba(0,0,0,.55))",
+			err: "var(--dsw-alias-state-error-primary, rgb(200,40,40))",
+			peak: "var(--dsw-alias-state-warn-primary, rgb(230,120,0))",
+			idle: "var(--dsw-alias-state-success-primary, rgb(34,160,80))",
+		};
+
+		const svgBase = {
+			width: 11,
+			height: 11,
+			viewBox: "0 0 24 24",
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: 2.2,
+			strokeLinecap: "round",
+			strokeLinejoin: "round",
+			style: { flex: "none", color: C.sub },
+		};
+		const IconMoney = () => h("svg", svgBase,
+			h("circle", { cx: 12, cy: 12, r: 9 }),
+			h("path", { d: "M12 6.5v11" }),
+			h("path", { d: "M9 9.5h6" }),
+			h("path", { d: "M9 14.5h6" }));
+		const IconToken = () => h("svg", svgBase,
+			h("rect", { x: 6.5, y: 6.5, width: 11, height: 11, rx: 2 }),
+			h("path", { d: "M9 2.5v4M15 2.5v4M9 17.5v4M15 17.5v4" }),
+			h("path", { d: "M2.5 9h4M2.5 15h4M17.5 9h4M17.5 15h4" }));
+		const IconApi = () => h("svg", svgBase, h("path", { d: "M13 2 3 14h7l-1 8 10-12h-7l1-8z" }));
+		const IconIn = () => h("svg", svgBase,
+			h("path", { d: "M12 19V5" }),
+			h("path", { d: "M5 12l7-7 7 7" }));
+		const IconOut = () => h("svg", svgBase,
+			h("path", { d: "M12 5v14" }),
+			h("path", { d: "M19 12l-7 7-7-7" }));
+		const IconCache = () => h("svg", svgBase,
+			h("ellipse", { cx: 12, cy: 5, rx: 8, ry: 3 }),
+			h("path", { d: "M4 5v14c0 1.7 3.6 3 8 3s8-1.3 8-3V5" }),
+			h("path", { d: "M4 12c0 1.7 3.6 3 8 3s8-1.3 8-3" }));
+
+		// ---- the widget -------------------------------------------------
+		function UsageCell(props) {
+			const wide = !!props.wide;
+			const [data, setData] = useState(null);
+			const [error, setError] = useState("");
+			const [spinning, setSpinning] = useState(false);
+			const mounted = useRef(true);
+
+			const load = useCallback(async () => {
+				setSpinning(true);
+				try {
+					const res = await fetch(USAGE_PATH, { cache: "no-store" });
+					let body = null;
+					try {
+						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}）`);
+					}
+					if (!mounted.current) return;
+					setData(body);
+					setError("");
+				} catch (e) {
+					if (!mounted.current) return;
+					setError(e instanceof Error ? e.message : String(e));
+				} finally {
+					if (mounted.current) setSpinning(false);
+				}
+			}, []);
+
+			useEffect(() => {
+				mounted.current = true;
+				load();
+				const timer = setInterval(load, POLL_MS);
+				return () => {
+					mounted.current = false;
+					clearInterval(timer);
+				};
+			}, [load]);
+
+			const balance = data && data.balance ? data.balance : null;
+			const today = data && data.today ? data.today : null;
+			const tier = data && data.tier ? data.tier : null;
+			const currency = balance && balance.currency ? balance.currency : "CNY";
+			const errs = (Array.isArray(data && data.errors) ? data.errors : []).concat(error ? [error] : []);
+			const tok = today && today.tokens ? today.tokens : null;
+			const dot = {
+				width: 8,
+				height: 8,
+				borderRadius: "50%",
+				flex: "none",
+				background: data && data.peak ? C.peak : C.idle,
+				boxShadow: "0 0 4px rgba(0,0,0,.3)",
+			};
+			const title = "DeepSeek 用量 · 点击刷新" + (errs.length ? " · " + errs.join("; ") : "");
+
+			if (!wide) {
+				return h("div", {
+					style: {
+						boxSizing: "border-box",
+						flex: "none",
+						padding: "4px 8px",
+						borderRadius: 8,
+						border: "1px solid " + C.border,
+						background: C.bg,
+						color: C.label,
+						cursor: "pointer",
+						display: "flex",
+						flexDirection: "row",
+						alignItems: "center",
+						gap: 5,
+						userSelect: "none",
+					},
+					title,
+					onClick: load,
+				},
+					h("span", { style: { fontWeight: 700, fontSize: 12, color: C.label } }, money(balance && balance.total, currency)),
+					h("span", { style: dot, title: data && data.peak ? "高峰时段" : "空闲时段" }));
+			}
+
+			const grp = (label, icon, value) =>
+				h("span", { style: { display: "inline-flex", gap: 2, alignItems: "center", minWidth: 0 } },
+					label ? h("span", { style: { color: C.sub, fontSize: 11, marginRight: 5 } }, label) : null,
+					h("span", { style: { display: "inline-flex", alignItems: "center" } }, icon),
+					h("span", { style: { fontWeight: 600, whiteSpace: "nowrap" } }, value));
+			const pr = (icon, value) =>
+				h("span", { style: { display: "inline-flex", gap: 2, alignItems: "center" } },
+					h("span", { style: { display: "inline-flex", alignItems: "center" } }, icon),
+					h("span", { style: { fontWeight: 600, whiteSpace: "nowrap" } }, value));
+			const Sep = () => h("span", { style: { color: C.sub, margin: "0 1px", fontSize: 10 } }, "·");
+
+			const costText = money(today && today.cost, currency);
+			const costShown = costText;
+
+			return h("div", {
+				style: {
+					boxSizing: "border-box",
+					flex: "1 1 100%",
+					minWidth: 0,
+					padding: "8px 10px",
+					borderRadius: 10,
+					border: "1px solid " + C.border,
+					background: C.bg,
+					color: C.label,
+					cursor: "pointer",
+					userSelect: "none",
+					display: "flex",
+					flexDirection: "column",
+					gap: 4,
+					marginTop: 4,
+					position: "relative",
+					fontSize: "12px",
+					lineHeight: "15px",
+				},
+				title,
+				onClick: load,
+			},
+				h("div", { style: { display: "flex", alignItems: "baseline", minWidth: 0, paddingRight: 12 } },
+					grp("余额", h(IconMoney, null), money(balance && balance.total, currency))),
+				h("div", { style: { display: "flex", gap: 4, alignItems: "center", minWidth: 0, flexWrap: "nowrap" } },
+					grp("今日", h(IconMoney, null), costShown),
+					Sep(),
+					grp(null, h(IconToken, null), fmtTokens(tok && tok.total)),
+					Sep(),
+					grp(null, h(IconApi, null), today && today.calls !== null && today.calls !== undefined ? String(today.calls) : "—")),
+				h("span", {
+					style: { position: "absolute", top: 8, right: 9, ...dot },
+					title: data && data.peak ? "高峰时段 " + (data.peakHours || "") : "空闲时段",
+				}),
+				h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, minWidth: 0 } },
+					tier
+						? h("span", { style: { display: "inline-flex", gap: 4, alignItems: "center", color: C.sub, fontSize: 10, whiteSpace: "nowrap", overflow: "hidden" } },
+							pr(h(IconIn, null), fmtPrice(tier.input)),
+							Sep(),
+							pr(h(IconCache, null), fmtPrice(tier.cacheRead)),
+							Sep(),
+							pr(h(IconOut, null), fmtPrice(tier.output)))
+						: null,
+					h("span", {
+						className: "dsw-usage-time",
+						style: { display: "inline-flex", alignItems: "center", gap: 4, color: C.sub, fontSize: 10, flex: "none" },
+					},
+						spinning
+							? h("span", {
+								className: "dsw-usage-refresh",
+								style: { color: C.label, display: "inline-flex", alignItems: "center" },
+								title: "刷新中",
+							}, h("svg", { width: 11, height: 11, viewBox: "0 0 16 16", fill: "none", style: { animation: "dsh-usage-spin .8s linear infinite" } },
+								h("path", { d: "M13.5 8a5.5 5.5 0 1 1-1.6-3.9M13.5 1.5v3h-3", stroke: "currentColor", strokeWidth: 1.6, strokeLinecap: "round", strokeLinejoin: "round" })))
+							: null,
+						h("span", null, fmtTime(data ? data.updatedAt : Date.now())))),
+				errs.length
+					? h("div", { style: { color: C.err, fontSize: 10, whiteSpace: "pre-wrap" } }, errs.join(" | "))
+					: null);
+		}
+
+		// ---- client plugin body -----------------------------------------
+		const inject = ["slots"];
+
+		function apply(ctx) {
+			// 注入本包样式：footerActions 换行（卡片独占一行）＋ 刷新旋转动画。
+			const tagId = "dsh-deepseek-usage";
+			if (typeof document !== "undefined" && document.querySelector(`style[data-plugin-css="${tagId}"]`) === null) {
+				const style = document.createElement("style");
+				style.dataset.plugin = "dsh-deepseek-usage";
+				style.dataset.pluginCss = tagId;
+				style.textContent =
+					'div[class*="footerActions"]{flex-wrap:wrap}' +
+					"@keyframes dsh-usage-spin{to{transform:rotate(360deg)}}";
+				document.head.appendChild(style);
+			}
+			ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register(
+				{ name: "sidebar.footer.action", id: "dsh-usage", order: 100, label: "DeepSeek 用量" },
+				(props) => h(UsageCell, { wide: props.wide }),
+			));
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,300 @@
+/**
+ * dsh-deepseek-usage — host half.
+ *
+ * 注册一个 HTTP 路由：
+ *
+ *   GET /api/deepseek-usage
+ *
+ * 返回（JSON）：
+ *   {
+ *     ok: true,
+ *     balance: { available, total, currency, granted, toppedUp },   // 官方余额接口
+ *     today: {
+ *       cost,         // 今日花费：官方平台数据（配置 DEEPSEEK_PLATFORM_TOKEN 时），否则本地日志估算
+ *       costSource: 'official' | 'estimate' | null,
+ *       tokens: { input, output, cacheRead, cacheWrite, total },   // 今日 token 数（本地日志）
+ *       calls,        // 今日 API 请求数（本地日志）
+ *       sessions      // 今日有活动的会话数
+ *     },
+ *     peak, peakHours,                                              // 峰谷时段
+ *     tier: { input, cacheRead, cacheWrite, output },               // 当前模型当前档单价
+ *     updatedAt, errors
+ *   }
+ *
+ * 余额来自 DeepSeek 官方 GET /user/balance（API Key 经凭证服务解析，与
+ * llm-deepseek 同一引用，不出本机）。今日 Token / API 次数只能从本地会话
+ * 日志统计（官方无用量查询接口）；今日花费优先用官方平台 usage API
+ * （需可选的 DEEPSEEK_PLATFORM_TOKEN），否则按日志 token × 官方价格表估算。
+ */
+import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { DEFAULT_MODEL, PEAK_HOURS_TEXT, costOf, isPeak, unitAt } from "./pricing.js";
+
+const name = "dsh-deepseek-usage";
+const inject = ["credentials", "webServer"];
+
+const PUBLIC_BASE_URL = "https://api.deepseek.com";
+/** 与 llm-deepseek 适配器对齐的环境变量覆盖。 */
+const BASE_URL_ENV = "DEEPSEEK_BASE_URL";
+const API_KEY_REF = credentialRef("DEEPSEEK_API_KEY");
+/** 可选：平台会话令牌（platform.deepseek.com 的 userToken），解锁官方今日消费数据。 */
+const PLATFORM_TOKEN_REF = credentialRef("DEEPSEEK_PLATFORM_TOKEN");
+const BALANCE_PATH = "/user/balance";
+const ROUTE_PATH = "/api/deepseek-usage";
+const TIMEOUT_MS = 15000;
+/** 平台用量接口（控制台同源，可按月按日筛选）。 */
+const PLATFORM_USAGE_URL = "https://platform.deepseek.com/api/v0/usage/cost";
+/** 本地用量扫描的短缓存，避免多标签页/轮询反复解码全部日志。 */
+const USAGE_CACHE_MS = 20000;
+
+const JSON_HEADERS = {
+  "content-type": "application/json; charset=utf-8",
+  "cache-control": "no-store",
+};
+
+function sendJson(res, status, body) {
+  res.writeHead(status, JSON_HEADERS);
+  res.end(JSON.stringify(body));
+}
+
+function balanceUrl() {
+  const base = process.env[BASE_URL_ENV] ?? PUBLIC_BASE_URL;
+  return `${base.replace(/\/+$/, "")}${BALANCE_PATH}`;
+}
+
+/** 本地日历日 `YYYY-MM-DD`（平台用量行按日期键控）。 */
+function localDate(d = new Date()) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+
+/** 容忍字符串/数字，返回有限数或 NaN。 */
+function toFinite(value) {
+  if (typeof value === "number") return Number.isFinite(value) ? value : NaN;
+  if (typeof value === "string" && value.trim() !== "") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : NaN;
+  }
+  return NaN;
+}
+
+/** 取平台用量接口"今天"行的花费（官方），找不到返回 null。 */
+async function fetchPlatformTodayCost(token) {
+  const now = new Date();
+  const url = `${PLATFORM_USAGE_URL}?month=${now.getMonth() + 1}&year=${now.getFullYear()}`;
+  const response = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/json",
+      "x-app-version": "1.0.0",
+      Origin: "https://platform.deepseek.com",
+      Referer: "https://platform.deepseek.com/usage",
+    },
+    signal: AbortSignal.timeout(TIMEOUT_MS),
+  });
+  if (!response.ok) throw new Error(`DeepSeek 平台用量接口返回 HTTP ${response.status}`);
+  const body = await response.json();
+  const biz = body && typeof body === "object" ? body.data : void 0;
+  if (body?.code !== 0 || biz === void 0 || biz.biz_code !== 0) {
+    const code = body?.code ?? biz?.biz_code;
+    if (code === 40002 || code === 40003) {
+      throw new Error("DEEPSEEK_PLATFORM_TOKEN 已过期：请重新登录 platform.deepseek.com 并更新 userToken");
+    }
+    throw new Error(`DeepSeek 平台用量接口错误 (code ${code ?? "unknown"})`);
+  }
+  const bizData = biz.biz_data;
+  const container = Array.isArray(bizData) ? bizData[0] : bizData;
+  const days = container && typeof container === "object" ? container.days : void 0;
+  if (!Array.isArray(days)) return null;
+  const today = localDate();
+  const entry = days.find((d) => d && d.date === today);
+  if (!entry || !Array.isArray(entry.data)) return null;
+  let total = 0;
+  for (const modelEntry of entry.data) {
+    if (!modelEntry || typeof modelEntry !== "object" || !Array.isArray(modelEntry.usage)) continue;
+    for (const u of modelEntry.usage) {
+      if (!u || typeof u !== "object") continue;
+      const value = toFinite(u.cost ?? u.amount);
+      if (Number.isFinite(value)) total += value;
+    }
+  }
+  return Math.round(total * 100) / 100;
+}
+
+/** 本地今日零点（unix ms）。 */
+function startOfTodayMs() {
+  const d = new Date();
+  d.setHours(0, 0, 0, 0);
+  return d.getTime();
+}
+
+let usageCache = null;
+let usageCacheAt = 0;
+
+/**
+ * 扫描全部会话日志，统计今日（本地时区）token 用量 / API 请求数 / 花费估算。
+ * 每条 `assistant/message` 按消息自带的 model（data.message.source.model）
+ * 与事件时刻的峰谷单价计价。
+ */
+async function scanTodayUsage(ctx) {
+  const persistence = ctx.get("sessionPersistence");
+  if (persistence === void 0 || typeof persistence.list !== "function" || typeof persistence.readRaw !== "function") {
+    return { usable: false, error: "sessionPersistence 不可用" };
+  }
+  const now = Date.now();
+  if (usageCache !== null && now - usageCacheAt < USAGE_CACHE_MS) return usageCache;
+  const dayStart = startOfTodayMs();
+  const acc = { usable: true, calls: 0, sessions: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, skipped: 0 };
+  try {
+    const headers = await persistence.list();
+    for (const header of headers) {
+      let raw;
+      try {
+        raw = await persistence.readRaw(header.id);
+      } catch {
+        acc.skipped += 1;
+        continue;
+      }
+      if (raw === void 0 || raw === null || typeof raw.content !== "string") continue;
+      let hit = false;
+      for (const line of raw.content.split("\n")) {
+        if (line === "") continue;
+        let event;
+        try {
+          event = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        if (event === null || typeof event !== "object" || event.type !== "assistant/message") continue;
+        const usage = event.data && event.data.usage;
+        if (usage === void 0 || usage === null || typeof event.time !== "number" || event.time < dayStart) continue;
+        hit = true;
+        const source = event.data.message && event.data.message.source;
+        const model = source && typeof source.model === "string" ? source.model : void 0;
+        const unit = unitAt(model, event.time);
+        acc.calls += 1;
+        acc.input += usage.inputTokens || 0;
+        acc.output += usage.outputTokens || 0;
+        acc.cacheRead += usage.cacheReadTokens || 0;
+        acc.cacheWrite += usage.cacheWriteTokens || 0;
+        acc.cost += costOf(usage, unit);
+      }
+      if (hit) acc.sessions += 1;
+    }
+  } catch (error) {
+    acc.usable = false;
+    acc.error = error instanceof Error ? error.message : String(error);
+  }
+  acc.cost = Math.round(acc.cost * 1e6) / 1e6;
+  usageCache = acc;
+  usageCacheAt = now;
+  return acc;
+}
+
+function apply(ctx) {
+  ctx.effect(
+    () => ctx.webServer.register({
+      kind: "exact",
+      path: ROUTE_PATH,
+      handler: async (req, res) => {
+        try {
+          const errors = [];
+
+          // ---- 余额（官方接口）----
+          const balance = { available: null, total: null, currency: null, granted: null, toppedUp: null };
+          try {
+            const hit = await ctx.credentials.resolve(API_KEY_REF);
+            if (hit === void 0) {
+              errors.push("未配置 DEEPSEEK_API_KEY");
+            } else {
+              const response = await fetch(balanceUrl(), {
+                headers: { Authorization: `Bearer ${hit.value}`, Accept: "application/json" },
+                signal: AbortSignal.timeout(TIMEOUT_MS),
+              });
+              const text = await response.text();
+              if (!response.ok) {
+                errors.push(`余额接口 HTTP ${response.status}`);
+              } else {
+                const body = JSON.parse(text);
+                const infos = body && Array.isArray(body.balance_infos) ? body.balance_infos : [];
+                const first = infos[0] || {};
+                balance.available = body?.is_available !== false;
+                balance.total = toFinite(first.total_balance);
+                balance.currency = typeof first.currency === "string" ? first.currency : null;
+                balance.granted = toFinite(first.granted_balance);
+                balance.toppedUp = toFinite(first.topped_up_balance);
+              }
+            }
+          } catch (error) {
+            errors.push(`余额获取失败: ${error instanceof Error ? error.message : String(error)}`);
+          }
+
+          // ---- 今日花费：官方平台数据（可选令牌）----
+          let costOfficial = null;
+          try {
+            const platformHit = await ctx.credentials.resolve(PLATFORM_TOKEN_REF);
+            if (platformHit !== void 0) {
+              costOfficial = await fetchPlatformTodayCost(platformHit.value);
+            }
+          } catch (error) {
+            errors.push(`官方今日消费获取失败: ${error instanceof Error ? error.message : String(error)}`);
+          }
+
+          // ---- 今日 token / API 次数 / 花费估算（本地日志）----
+          const usage = await scanTodayUsage(ctx);
+          if (!usage.usable) errors.push(usage.error ?? "今日用量统计不可用");
+
+          const now = Date.now();
+          let model = DEFAULT_MODEL;
+          try {
+            const adm = ctx.get("agentDefaultModel");
+            const selection = adm && typeof adm.currentSelection === "function" ? adm.currentSelection() : void 0;
+            if (selection && typeof selection.model === "string") model = selection.model;
+          } catch {}
+          const unit = unitAt(model, now);
+
+          const cost = costOfficial !== null ? costOfficial : (usage.usable ? usage.cost : null);
+          const costSource = costOfficial !== null ? "official" : (usage.usable ? "estimate" : null);
+
+          sendJson(res, 200, {
+            ok: true,
+            balance,
+            today: {
+              cost,
+              costSource,
+              tokens: usage.usable
+                ? {
+                    input: usage.input,
+                    output: usage.output,
+                    cacheRead: usage.cacheRead,
+                    cacheWrite: usage.cacheWrite,
+                    total: usage.input + usage.output + usage.cacheRead + usage.cacheWrite,
+                  }
+                : null,
+              calls: usage.usable ? usage.calls : null,
+              sessions: usage.usable ? usage.sessions : null,
+              skipped: usage.usable ? usage.skipped : null,
+            },
+            peak: isPeak(now),
+            peakHours: PEAK_HOURS_TEXT,
+            tier: { input: unit.input, cacheRead: unit.cacheRead, cacheWrite: unit.cacheWrite, output: unit.output },
+            updatedAt: now,
+            errors,
+          });
+        } catch (error) {
+          ctx.logger.warn("dsh-deepseek-usage: request failed");
+          ctx.logger.warn(error);
+          sendJson(res, 502, {
+            ok: false,
+            error: "internal",
+            message: error instanceof Error ? error.message : String(error),
+          });
+        }
+      },
+    }),
+    "dsh-deepseek-usage: route",
+  );
+}
+
+export { name, inject, apply };

package/lib/pricing.js

@@ -0,0 +1,53 @@
+/**
+ * dsh-deepseek-usage — 定价引擎（元 / 百万 tokens）。
+ *
+ * DeepSeek 官方价格快照（2026-08-17 起 V4 系列峰谷定价，北京时间）：
+ * 高峰时段 9:00–12:00 与 14:00–18:00，其余为空闲时段（空闲=高峰半价）。
+ * 缓存写暂不计费（cacheWrite = 0）；未知模型回退 chat 档。
+ * 价格调整时只需改 PRICE_TABLE 与 PEAK_WINDOWS。
+ */
+
+/** 每模型价格：input/cacheRead/output 均为 [高峰, 空闲] 二元组；cacheWrite 为常量 0。 */
+const PRICE_TABLE = {
+  'deepseek-v4-flash': { input: [3.0, 1.5], cacheRead: [0.1, 0.05], cacheWrite: 0, output: [9.0, 4.5] },
+  'deepseek-v4-pro': { input: [9.0, 4.5], cacheRead: [0.3, 0.15], cacheWrite: 0, output: [27.0, 13.5] },
+  'deepseek-chat': { input: [2, 2], cacheRead: [0.5, 0.5], cacheWrite: 0, output: [8, 8] },
+  'deepseek-reasoner': { input: [4, 4], cacheRead: [1, 1], cacheWrite: 0, output: [16, 16] },
+};
+
+/** 默认模型（当 agentDefaultModel 不可用时）。 */
+export const DEFAULT_MODEL = 'deepseek-v4-flash';
+
+/** 高峰时段窗口（本地/北京时间，含起点不含终点）。 */
+export const PEAK_WINDOWS = [[9, 12], [14, 18]];
+/** 高峰时段展示文案。 */
+export const PEAK_HOURS_TEXT = '9:00–12:00、14:00–18:00';
+
+/** 某时刻是否为高峰时段。 */
+export function isPeak(ms) {
+  const h = new Date(ms).getHours();
+  return PEAK_WINDOWS.some(([start, end]) => h >= start && h < end);
+}
+
+/** 某模型在某一时刻的单位价格（元/百万 tokens）。 */
+export function unitAt(model, ms) {
+  const p = PRICE_TABLE[model] || PRICE_TABLE['deepseek-chat'];
+  const tier = isPeak(ms) ? 0 : 1;
+  return {
+    input: p.input[tier],
+    cacheRead: p.cacheRead[tier],
+    cacheWrite: p.cacheWrite,
+    output: p.output[tier],
+  };
+}
+
+/** 按单位价格计算一次 usage 的估算成本（元）。 */
+export function costOf(usage, unit) {
+  return (
+    (usage.inputTokens * unit.input +
+      (usage.cacheReadTokens || 0) * unit.cacheRead +
+      (usage.cacheWriteTokens || 0) * unit.cacheWrite +
+      usage.outputTokens * unit.output) /
+    1e6
+  );
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dougen/dsh-deepseek-usage",
+  "version": "0.1.2",
+  "description": "DeepSeek 用量侧边栏插件：余额（官方 API）、今日花费（官方平台数据或本地日志估算）、今日 Token 与 API 次数（本地日志）、高峰/空闲时段指示灯。",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "slots"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek",
+    "deepseek-harness",
+    "plugin",
+    "usage",
+    "balance",
+    "tokens",
+    "web"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}