@wannanbigpig/dsh-usage-stats 0.1.1 → 0.1.3

package/README.md

@@ -24,6 +24,16 @@ DeepSeek official balance, token usage, a contribution heatmap, and per-hour sta
 
 界面支持中文和英文。Token 数据来自会话事件中的 provider-reported `usage`（`assistant/chunk` 或 `assistant/message`），不是本地估算；「消费金额」是根据模型单价 × Token 数计算的**估算值**，请以 DeepSeek 官方账单为准。统计、限额判定与「今日」口径均按**北京时间**（服务端下发 `today` 字段，客户端优先使用），机器或浏览器时区不是 UTC+8 也保持一致。
 
+## 界面预览 / Screenshots
+
+「用量/余额」查询中心（概览标签）：DeepSeek 官方余额卡、用量预警、Token 汇总、年度贡献热图与按小时统计。
+
+![用量/余额查询中心（概览）](assets/screenshots/usage-panel.png)
+
+「设置 → 用量与计费」：按 API Key（或全局）配置每日消费限额、余额提醒线与预警比例，硬停止默认关闭。
+
+![设置 → 用量与计费（限额配置）](assets/screenshots/limits-settings.png)
+
 ## 快速安装 / Quick start
 
 需要 DeepSeek Harness `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.7`，`dsh plugin` 子命令自该版本引入）与 [pnpm](https://pnpm.io/installation)（`dsh plugin` 会把参数转发给 profile 目录里的 pnpm，因此所有 pnpm 子命令都可用）。
@@ -123,7 +133,7 @@ DEEPSEEK_API_KEY: sk-your-key-here
 
 ### 用量提醒与限额（设置 → 用量与计费）
 
-「设置 → 用量与计费」页面承载限额配置（已从查询弹窗迁出，弹窗保持只读）。可**按 Key（或全局）**配置：
+「设置 → 用量与计费」页面承载限额配置（已从查询弹窗迁出，弹窗保持只读）。可**按 Key（或全局）**配置；**仅配置一个 API Key 时，「目标 API Key」选择器自动隐藏**，直接配置全局规则即可（单 Key 下全局规则就是生效规则）：
 
 - **启用限额**：开关。
 - **每日消费限额**（CNY）：今日估算消费达到限额 × `alertPercent`（默认 80%）→ 黄色预警；达到限额 × `criticalPercent`（默认 90%）→ 红色已超限（仅提醒与告警，不拦截）；两个比例都可在设置页调整。

package/lib/client.js

@@ -1095,7 +1095,9 @@ window.__ModuleLoader__.load({
 			const [limits, setLimits] = react.useState(null);
 			const limitsRef = react.useRef(null);
 			const [statusMap, setStatusMap] = react.useState({});
+			const isSingleKey = (keys || []).length <= 1;
 			const [activeKey, setActiveKey] = react.useState(() => {
+				if (isSingleKey) return "__global__";
 				const stored = safeGetStorage("dsh_usage_limits_active_key");
 				if (stored !== null && stored !== "") return stored;
 				return selectedKey ?? "__global__";
@@ -1134,6 +1136,10 @@ window.__ModuleLoader__.load({
 
 			// Sync activeKey when selectedKey becomes available (if not explicitly chosen in storage)
 			react.useEffect(() => {
+				if (isSingleKey) {
+					setActiveKey("__global__");
+					return;
+				}
 				if (selectedKey !== null && selectedKey !== undefined && selectedKey !== "") {
 					const stored = safeGetStorage("dsh_usage_limits_active_key");
 					if (stored) {
@@ -1142,7 +1148,7 @@ window.__ModuleLoader__.load({
 					}
 					setActiveKey(selectedKey);
 				}
-			}, [selectedKey]);
+			}, [selectedKey, isSingleKey]);
 
 			// Update form fields when activeKey or limits payload change
 			react.useEffect(() => {
@@ -1160,6 +1166,7 @@ window.__ModuleLoader__.load({
 			}, [activeKey, limits]);
 
 			const handleKeySelect = (newKey) => {
+				if (isSingleKey) return;
 				// Do not strand an unsaved batch on the previous key's form.
 				if (pendingRef.current !== null && !savingRef.current) flushSave();
 				setActiveKey(newKey);
@@ -1306,8 +1313,8 @@ window.__ModuleLoader__.load({
 					}),
 					react_jsx_runtime.jsx("p", { className: S.note, children: translate("limits.desc") }),
 					error && react_jsx_runtime.jsx("div", { className: S.error, children: error }),
-					// Key selection
-					react_jsx_runtime.jsxs("label", {
+					// Key selection — hidden when only one key is configured (the global rule IS the key rule).
+					keys.length > 1 && react_jsx_runtime.jsxs("label", {
 						className: S.pickerRow,
 						children: [
 							react_jsx_runtime.jsxs("span", {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wannanbigpig/dsh-usage-stats",
   "description": "DeepSeek 官方余额、Token 用量、月历热图与离线 tokenizer，内置在 Harness 侧栏",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wannanbigpig/dsh-usage-stats.git"
@@ -17,6 +17,7 @@
   ],
   "files": [
     "lib/",
+    "assets/",
     "cordis.patch.yml",
     "README.md",
     "LICENSE"