balance-dsh 1.2.1 → 1.2.3

package/README.md

@@ -7,9 +7,10 @@ DSH 插件：在 Web UI 中直接显示 DeepSeek 账户余额和当前会话 tok
 - **侧边栏余额行**：侧边栏展开时显示在底部（紧贴"设置"按钮上方），格式：钱包图标 + `余额` + 金额（带货币单位）+ 时段标签（高峰红 / 空闲绿）。金额按余额状态变色：充足绿色、偏低（<10）琥珀黄、为 0 显示红色"去充值"。
 - **收起态 FAB**：侧边栏收起时，余额显示为左下角悬浮胶囊。
 - **自动刷新**：每 60 秒自动刷新一次；每次对话完成（新回复落库）也会立即刷新；右键余额任意区域可手动刷新。
-- **余额与使用统计**：单击余额在余额项旁以轻量动画打开局部快捷菜单，展示账户余额、近 90 天计费 Token、估算费用、扫描会话数和按日使用热力图；点击菜单外区域会播放关闭动画，双击余额打开 DeepSeek 官方 API 用量页。
-- **高峰/空闲计费**：官方高峰窗口为**周一至周五 09:00-12:00、14:00-18:00（北京时间）**，周末全天空闲。消耗金额**跨时段精确计费**：高峰时段的 token 按高峰价 ×2、空闲时段按目录价，按事件时间分桶计算。
+- **余额与使用统计**：单击余额打开**居中弹窗**（带半透明模糊遮罩），展示账户余额、近 90 天计费 Token、估算费用、活跃天数、按模型与高峰/空闲拆分、今日/近 7 天/近 30 天、日均与峰值日，以及按日使用热力图；点遮罩 / 按 `Esc` / 点关闭按钮均可关闭，双击余额在**应用内**打开 DeepSeek 官方用量页（官方版自带内嵌浏览器，不再弹出系统浏览器；旧版环境自动回退到浏览器）。
+- **高峰/空闲计费**：官方高峰窗口为**工作日 09:00-12:00、14:00-18:00（北京时间）**；周末、**中国法定节假日全天**都按空闲计费，**调休上班的周末按工作日**计峰谷。节假日安排会自动从公开数据源补录（内置 2026 年表作离线兜底，无需手动更新）。消耗金额**跨时段精确计费**：高峰时段的 token 按高峰价 ×2、空闲时段按目录价，按事件时间分桶计算。
 - **会话消耗行**：对话框下方实时显示当前会话消耗（新增 tokens + 估算金额），悬停查看完整明细（模型、时段拆分、计费口径）。
+- **应用内查看官方用量**：双击余额、或点统计面板里的「查看官方用量」，都会在应用内嵌浏览器里打开官方用量页（余额、消费金额、请求次数、Tokens）；「去充值」同理。旧版 DSH 缺少内嵌浏览器时自动回退系统浏览器。
 - **`/balance` 命令**：命令行查询余额明细和当前会话消耗。
 
 ### 使用统计口径
@@ -17,7 +18,7 @@ DSH 插件：在 Web UI 中直接显示 DeepSeek 账户余额和当前会话 tok
 - 热力图按北京时间聚合最近 90 天持久化会话中的 `assistant/message` Token usage。
 - 费用按照每条消息的实际模型和峰谷时段估算，最终金额以 DeepSeek 官方账单为准。
 - 为避免历史会话过多拖慢 DSH，最多扫描最近 200 个会话；服务端统计和客户端展示结果均缓存 5 分钟，重复打开菜单不会重复请求。
-- 若未配置 API Key，仍可查看本地 Token 与费用统计，但账户余额会显示为不可用。
+- 账户余额优先读取 **DSH 官方账号**（官方版登录后即可用，无需 API Key）；未登录官方账号时回退到 API Key。两者都不可用时仍可查看本地 Token 与费用统计，只是余额会显示为不可用。
 
 ## 安装
 
@@ -53,7 +54,11 @@ dsh plugin --profile desktop add github:Rannist/balance-dsh
       name: balance-dsh
 ```
 
-### 设置 DeepSeek API Key（三选一）
+### 余额来源
+
+**官方 DeepSeek Harness 桌面版**：在应用内登录 DeepSeek 账号后，插件会**自动读取官方余额，无需任何配置**。
+
+**其他环境**（或不想登录官方账号时）：改用 API Key，三选一——
 
 1. 环境变量 `DEEPSEEK_API_KEY`，或
 2. 在注册项的 `config.apiKey` 中设置，或
@@ -77,10 +82,10 @@ dsh plugin --profile desktop add github:Rannist/balance-dsh
       - {start: 14, end: 18}
     peakWeekdays: [1, 2, 3, 4, 5]          # 可选；1=周一 … 5=周五，0/6=周末
     price:                                 # 可选；逐项覆盖对应模型价格（元/百万 tokens）
-      inputCnyPerMillion: 1.5
-      cacheReadCnyPerMillion: 0.05
+      inputCnyPerMillion: 1
+      cacheReadCnyPerMillion: 0.02
       cacheWriteCnyPerMillion: 0
-      outputCnyPerMillion: 4.5
+      outputCnyPerMillion: 4
 ```
 
 > 注意：插件已自动按高峰/空闲时段计费（高峰价 = 目录价 × 2），**不要再设置 `config.peak: true`**，否则会重复翻倍。
@@ -96,20 +101,21 @@ pnpm remove balance-dsh
 
 ## 权限 / 数据
 
-- 仅在你**主动刷新**或对话完成时，会向 `api.deepseek.com` 的 `/user/balance` 端点发起一次余额查询。
-- 插件需要你的 DeepSeek API Key（仅用于余额查询），不收集、不上传任何会话内容到第三方。
+- 已登录官方账号时，余额通过 **DSH 内置账号服务**读取（登录凭据由应用自身管理，插件不接触、不保存任何 token）。
+- 仅当回退到 API Key 时，才会向 `api.deepseek.com` 的 `/user/balance` 端点查询余额（且只在你**主动刷新**或对话完成时）。
+- 插件不收集、不上传任何会话内容到第三方。
 - 消费统计完全基于本地会话事件（`request/header`、`assistant/message` 的 token usage）计算，不向 DeepSeek 之外的服务发送数据。
 
-## 价格表（2026-08-17 生效的 V4 峰谷定价·空闲时段价，元/百万 tokens）
+## 价格表（空闲时段价，元/百万 tokens）
 
 | 模型 | 输入（缓存未命中） | 输入（缓存命中） | 输出 |
 |---|---|---|---|
-| deepseek-v4-flash | 1.5 | 0.05 | 4.5 |
+| deepseek-flash | 1 | 0.02 | 4 |
 | deepseek-v4-pro | 4.5 | 0.15 | 13.5 |
 | deepseek-chat（旧） | 2 | 0.5 | 3 |
 | deepseek-reasoner（旧） | 4 | 1 | 16 |
 
-未识别模型按 deepseek-v4-flash 兜底；DeepSeek 调价后需同步更新 `lib/index.js` 的 `MODEL_PRICING` 与 `lib/client.js` 的 `DEFAULT_PRICING`。
+价格自 **2026-09-10 12:00（北京时间）** 起生效（flash 系列由 1.5 / 0.05 / 4.5 下调）；**高峰时段 = 空闲价 × 2**。调价前的历史消耗仍按当时的旧价计算，不会被重算。DeepSeek 再次调价时需同步更新 `lib/index.js` 的 `MODEL_PRICING` 与 `lib/client.js` 的 `DEFAULT_PRICING`，并把被替换的旧价移入 `LEGACY_MODEL_PRICING`。
 
 ## License
 

package/lib/client.js

@@ -40,13 +40,34 @@ window.__ModuleLoader__.load({
 .balance-fab:hover{background:var(--dsw-alias-interactive-bg-hover)}
 .balance-fab-dark{color:#fff;background:var(--dsw-alias-state-error-primary,#e5484d);border-color:var(--dsw-alias-state-error-primary,#e5484d)}
 .balance-fab-dark:hover{background:#cf3a3f}
-.balance-usage-line{box-sizing:border-box;display:flex;justify-content:center;align-items:center;gap:10px;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
-.balance-usage-line strong{color:var(--dsw-alias-label-primary);font-weight:600}
+/* ── 消耗行 pill：规格逐条照抄 DSH 原生 StatsPills 的 .pill（_091hzG_pill）── */
+.balance-usage-wrap{min-width:0;display:inline-flex}
+.balance-usage-line{box-sizing:border-box;corner-shape:round;max-width:100%;color:var(--dsw-alias-label-tertiary);font:inherit;font-size:calc(var(--dsh-content-font-size-secondary,13px) - 1px);font-variant-numeric:tabular-nums;line-height:calc(20px + var(--dsh-content-font-delta-secondary,0px));white-space:nowrap;background:0 0;border:none;border-radius:999px;align-items:center;gap:6px;padding:1px 8px;display:inline-flex;cursor:pointer;transition:background .15s var(--ds-ease-in-out,.2s)}
+.balance-usage-line svg{flex:none;width:14px;height:14px}
+.balance-usage-line:hover,.balance-usage-line[aria-expanded="true"]{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12));color:var(--dsw-alias-label-secondary)}
+.balance-usage-label{text-overflow:ellipsis;min-width:0;overflow:hidden}
+/* ── 消耗明细浮层：规格照抄 DSH 原生「会话统计」面板（.HS2XBG_panel/.title/.titleRule/.details）── */
+.balance-usage-panel{box-sizing:border-box;position:fixed;z-index:1100;border:0;border-radius:var(--dsw-radius-lg,12px);background:var(--dsw-specific-menu,var(--dsw-alias-bg-module-platform,#242526));width:max-content;min-width:min(300px,100vw - 24px);max-width:min(440px,100vw - 24px);backdrop-filter:var(--dsw-menu-backdrop-filter,none);--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);box-shadow:var(--dsw-elevation-prominent,0 8px 24px rgba(0,0,0,.32));color:var(--dsw-alias-label-secondary);cursor:default;padding:16px;font-size:12px;line-height:18px;animation:balance-stats-panel-in .12s var(--ds-ease-in-out,ease-out) both}
+.balance-usage-panel__title{display:flex;justify-content:space-between;gap:16px;margin-bottom:8px;color:var(--dsw-alias-label-primary);font-weight:500}
+.balance-usage-panel__title--second{margin-top:16px}
+.balance-usage-panel__rule{border-top:.5px solid var(--dsw-alias-border-l2);margin-bottom:10px}
+.balance-usage-panel__value{font-variant-numeric:tabular-nums}
+.balance-usage-panel__label{display:inline-flex;align-items:center;gap:6px;min-width:0}
+.balance-usage-panel__label svg{flex:none;width:14px;height:14px}
+.balance-usage-panel__details{display:grid;grid-template-columns:minmax(76px,auto) minmax(0,1fr);gap:6px 16px;margin:0;color:var(--dsw-alias-label-tertiary)}
+.balance-usage-panel__details dt,.balance-usage-panel__details dd{min-width:0;margin:0}
+.balance-usage-panel__details dd{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;text-align:right}
 /* ── 跨会话统计浮层（余额元素的子级，向右/向上展开） ── */
 .balance-stats-anchor{position:relative;display:flex;min-width:0;overflow:visible}
 .balance-stats-anchor--wide{width:100%}
 .balance-stats-anchor--compact{position:fixed;left:68px;bottom:12px;z-index:10000}
 .balance-stats-anchor--compact .balance-fab{position:static}
+.balance-platform-layer{box-sizing:border-box;position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;background:var(--dsw-alias-bg-base-platform,var(--dsw-alias-bg-base,#1b1b1c));animation:balance-stats-backdrop-in .16s var(--ds-ease-in-out,ease-out) both}
+.balance-platform-header{flex:none;display:flex;align-items:center;gap:8px;height:44px;padding:0 12px;border-bottom:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.2));-webkit-app-region:drag}
+.balance-platform-back{display:inline-flex;align-items:center;gap:6px;height:28px;padding:0 10px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary,inherit);font:inherit;font-size:13px;cursor:pointer;-webkit-app-region:no-drag;transition:background .15s var(--ds-ease-in-out,.2s)}
+.balance-platform-back svg{flex:none;display:block}
+.balance-platform-back:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12))}
+.balance-platform-viewport{flex:1;min-height:0}
 .balance-stats-layer{box-sizing:border-box;position:fixed;inset:0;z-index:9999;display:flex;align-items:center;justify-content:center;padding:24px;background:var(--dsw-alias-bg-mask-1,rgba(0,0,0,.24));backdrop-filter:var(--dsw-mask-blur,blur(2px));-webkit-backdrop-filter:var(--dsw-mask-blur,blur(2px));animation:balance-stats-backdrop-in .16s var(--ds-ease-in-out,ease-out) both}
 .balance-stats-layer--closing{pointer-events:none;animation:balance-stats-backdrop-out .14s var(--ds-ease-in-out,ease-in) both}
 .balance-stats-panel{box-sizing:border-box;position:relative;z-index:10000;width:min(800px,100%);max-height:100%;overflow-x:hidden;overflow-y:auto;scrollbar-gutter:stable;padding:0 0 24px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-base,#fff));border:0;border-radius:24px;box-shadow:var(--dsw-elevation-prominent,0 14px 36px rgba(0,0,0,.24));transform-origin:center center;will-change:transform,opacity;contain:layout style;animation:balance-stats-panel-in .26s var(--ds-ease-in-out,ease-out) .04s both;--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2,rgba(127,127,127,.35));--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2,rgba(127,127,127,.55))}
@@ -205,6 +226,184 @@ window.__ModuleLoader__.load({
         return String(n);
       }
 
+    // ─── 打开 DeepSeek 平台页面（用量 / 充值） ─────────────────────────────
+    // 三级策略，逐级回退：
+    //  1) DSH 官方版的「原生平台视口」——preload 通过 contextBridge 暴露的 globalThis.dshPlatform
+    //     （接口：open(page, bounds) / setBounds(bounds) / close()，page 取 "usage" | "top-up"）。
+    //     DSH 设置→账号与余额里的「查询用量」按钮就走它（dsh-client-ui-settings-account 的
+    //     PlatformOverlay + dshPlatform.open）。这个原生子窗口自带平台凭据（官方注释：
+    //     "the native child owns remote content and credentials"），所以**不需要网页登录**。
+    //     注意：那个包的 platformPages 是包内私有 store，插件无法触发 DSH 自己的 host，
+    //     因此这里自己画同款覆盖层并把视口坐标喂给 bridge。
+    //  2) 应用内侧栏浏览器（dsh-client-ui-sidebar-browser）——旧版/无原生视口时用，
+    //     按 DSH 自身 openExternalLink 的判定：sidebarRightTabs 注册了 "browser" 才可用。
+    //     该视口**没有**平台凭据，打开 platform.deepseek.com 会要求网页登录。
+    //  3) window.open 交给系统浏览器。
+    // 全程 try/catch：DSH 内部机制无兼容承诺，任一级失败都要继续降级，不能拖垮插件。
+    let pluginCtx = null;
+    const USAGE_URL = "https://platform.deepseek.com/usage";
+    const TOP_UP_URL = "https://platform.deepseek.com/top_up";
+
+    /** 当前原生平台视口的覆盖层；null 表示未打开。 */
+    let platformOverlay = null;
+
+    /** 关闭原生平台视口覆盖层（幂等；bridge.close + 摘除 DOM + 解绑监听）。 */
+    function closePlatformPage() {
+      if (platformOverlay === null) return;
+      const { layer, bridge, observer, onKey } = platformOverlay;
+      platformOverlay = null;
+      try {
+        observer.disconnect();
+      } catch {
+        /* ignore */
+      }
+      try {
+        window.removeEventListener("keydown", onKey, true);
+      } catch {
+        /* ignore */
+      }
+      try {
+        const closing = bridge.close();
+        if (closing && typeof closing.catch === "function") closing.catch(() => {});
+      } catch {
+        /* ignore */
+      }
+      try {
+        layer.remove();
+      } catch {
+        /* ignore */
+      }
+    }
+
+    /**
+     * 用原生平台视口打开官方平台页面。
+     * @param page - "usage"（用量）或 "top-up"（充值）。
+     * @returns 是否成功接管（false 时调用方继续降级）。
+     */
+    function openPlatformPage(page) {
+      const bridge = typeof globalThis === "undefined" ? void 0 : globalThis.dshPlatform;
+      if (!bridge || typeof bridge.open !== "function") return false;
+      try {
+        closePlatformPage();
+        const layer = document.createElement("div");
+        layer.className = "balance-platform-layer";
+        const header = document.createElement("header");
+        header.className = "balance-platform-header";
+        // 与 DSH 的 PlatformOverlay 一致：让标题栏可拖动窗口
+        header.setAttribute("data-window-drag", "");
+        const back = document.createElement("button");
+        back.type = "button";
+        back.className = "balance-platform-back";
+        // 与 DSH 的 PlatformOverlay 一致：chevron 图标 + 文案。DSH 用的是 primitives 的
+        // IconChevronLeftOutlineRegular 组件；这里覆盖层是纯 DOM，自绘同款 SVG，
+        // 免得为了一个图标把 React 渲染引进覆盖层。
+        const chevron = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+        chevron.setAttribute("viewBox", "0 0 16 16");
+        chevron.setAttribute("width", "16");
+        chevron.setAttribute("height", "16");
+        chevron.setAttribute("aria-hidden", "true");
+        const chevronPath = document.createElementNS("http://www.w3.org/2000/svg", "path");
+        chevronPath.setAttribute("d", "M10 3.5 5.5 8 10 12.5");
+        chevronPath.setAttribute("fill", "none");
+        chevronPath.setAttribute("stroke", "currentColor");
+        chevronPath.setAttribute("stroke-width", "1.6");
+        chevronPath.setAttribute("stroke-linecap", "round");
+        chevronPath.setAttribute("stroke-linejoin", "round");
+        chevron.appendChild(chevronPath);
+        back.appendChild(chevron);
+        back.appendChild(document.createTextNode("返回 DeepSeek Harness"));
+        back.addEventListener("click", closePlatformPage);
+        header.appendChild(back);
+        const viewport = document.createElement("div");
+        viewport.className = "balance-platform-viewport";
+        layer.appendChild(header);
+        layer.appendChild(viewport);
+        document.body.appendChild(layer);
+
+        // 原生视口按 CSS 像素贴合这个占位元素（DSH 也是拿 getBoundingClientRect()）
+        const bounds = () => {
+          const rect = viewport.getBoundingClientRect();
+          return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+        };
+        const observer = new ResizeObserver(() => {
+          if (platformOverlay === null) return;
+          try {
+            const moved = bridge.setBounds(bounds());
+            if (moved && typeof moved.catch === "function") moved.catch(() => {});
+          } catch {
+            /* ignore */
+          }
+        });
+        const onKey = (event) => {
+          if (event.key === "Escape") closePlatformPage();
+        };
+        platformOverlay = { layer, bridge, observer, onKey };
+        observer.observe(viewport);
+        window.addEventListener("keydown", onKey, true);
+        const opened = bridge.open(page, bounds());
+        if (opened && typeof opened.catch === "function") opened.catch(() => closePlatformPage());
+        return true;
+      } catch {
+        closePlatformPage();
+        return false;
+      }
+    }
+
+    /** 打开应用内嵌浏览器的标签页（无原生视口时的二级回退）。 */
+    function openSidebarBrowser(url) {
+      try {
+        const get = pluginCtx && typeof pluginCtx.get === "function" ? pluginCtx.get.bind(pluginCtx) : null;
+        if (get === null) return false;
+        const right = get("sidebarRight");
+        const tabs = get("sidebarRightTabs");
+        const hasBrowser = tabs && typeof tabs.get === "function" && tabs.get("browser") !== undefined;
+        if (right && typeof right.openTab === "function" && hasBrowser) {
+          right.openTab("browser", { params: { url } });
+          return true;
+        }
+      } catch {
+        // 侧栏浏览器不可用（旧版 DSH / 服务未就绪）
+      }
+      return false;
+    }
+
+    /** 最终回退：交给系统浏览器。 */
+    function openInSystemBrowser(url) {
+      try {
+        window.open(url, "_blank", "noopener,noreferrer");
+      } catch {
+        /* ignore */
+      }
+    }
+
+    /** 打开平台页面：原生视口 → 侧栏浏览器 → 系统浏览器。 */
+    function openPlatformOrUrl(page, url) {
+      if (openPlatformPage(page)) return;
+      if (openSidebarBrowser(url)) return;
+      openInSystemBrowser(url);
+    }
+
+    /**
+     * 外部链接的通用属性：保留 href（可右键复制），点击时拦截默认跳转、改为应用内打开。
+     * @param url - 平台页面地址（用作 href 与最终回退目标）。
+     * @param page - 原生视口的页面标识；缺省时跳过原生视口（例如非平台链接）。
+     * @param extra - 追加的事件处理器等属性。
+     */
+    function externalLink(url, page, extra) {
+      const options = extra || {};
+      return {
+        href: url,
+        target: "_blank",
+        rel: "noreferrer",
+        ...options,
+        onClick: (event) => {
+          if (event && typeof event.preventDefault === "function") event.preventDefault();
+          if (typeof options.onClick === "function") options.onClick(event);
+          openPlatformOrUrl(page, url);
+        },
+      };
+    }
+
     // ─── 当前会话模型：按模型取价（服务端 /balance-api 按 ?model= 返回对应价格） ───
     let sessionsFace = void 0;
     let currentModel = "";
@@ -797,9 +996,7 @@ window.__ModuleLoader__.load({
                     }),
                     jsx.jsx("a", {
                       className: "balance-stats-link",
-                      href: "https://platform.deepseek.com/usage",
-                      target: "_blank",
-                      rel: "noreferrer",
+                      ...externalLink(USAGE_URL, "usage"),
                       children: "查看官方用量",
                     }),
                   ],
@@ -904,11 +1101,17 @@ window.__ModuleLoader__.load({
         closeTimer.current = null;
         setStatsClosing(false);
         setStatsOpen(false);
-        window.open("https://platform.deepseek.com/usage", "_blank", "noopener");
+        // 双击：在应用内打开官方用量页（官方版自带内嵌浏览器；旧版回退系统浏览器）
+        // 双击：打开官方用量页（官方版用带平台凭据的原生视口，无需网页登录）
+        openPlatformOrUrl("usage", USAGE_URL);
       };
       // 余额元素的交互。悬停提示不用原生 title，统一走主题化浮层（见 withPanel）。
       const interactions = {
-        onClick: openStats,
+        // 单击打开统计面板；顺便阻止 <a href> 的默认跳转（否则会同时弹系统浏览器）
+        onClick: (event) => {
+          if (event && typeof event.preventDefault === "function") event.preventDefault();
+          openStats(event);
+        },
         onDoubleClick: openUsagePage,
         onContextMenu: onBalanceContextMenu,
       };
@@ -946,16 +1149,13 @@ window.__ModuleLoader__.load({
         if (depleted) {
           return jsx.jsx("a", {
             className: "balance-fab balance-fab-dark",
-            href: "https://platform.deepseek.com/top_up",
-            target: "_blank",
-            rel: "noreferrer",
-            onContextMenu: onBalanceContextMenu,
+            ...externalLink(TOP_UP_URL, "top-up", { onContextMenu: onBalanceContextMenu }),
             children: "去充值",
           });
         }
         return withPanel(jsx.jsx("a", {
           className: "balance-fab",
-          href: "https://platform.deepseek.com/usage",
+          ...externalLink(USAGE_URL, "usage"),
           ...interactions,
           children: "¥" + b.total_balance,
         }));
@@ -965,7 +1165,13 @@ window.__ModuleLoader__.load({
         return withPanel(jsx.jsx("div", {
           className: "balance-footer",
           ...interactions,
-          children: jsx.jsx("span", { className: "balance-footer__error", children: "余额查询失败" }),
+          // 失败原因统一走主题化浮层，避免把长错误塞进 42px 的余额行
+          children: jsx.jsx(primitives.Tooltip, {
+            label: state.error || "余额查询失败",
+            side: "top",
+            delayMs: 200,
+            children: jsx.jsx("span", { className: "balance-footer__error", children: "余额读取失败" }),
+          }),
         }));
       }
       if (!state.balance) {
@@ -986,12 +1192,12 @@ window.__ModuleLoader__.load({
             jsx.jsx("span", { className: "balance-footer__label", children: "余额" }),
             jsx.jsx("a", {
               className: "balance-footer__topup",
-              href: "https://platform.deepseek.com/top_up",
-              target: "_blank",
-              rel: "noreferrer",
-              onClick: (event) => event.stopPropagation(),
-              onDoubleClick: (event) => event.stopPropagation(),
-              onContextMenu: onBalanceContextMenu,
+              ...externalLink(TOP_UP_URL, "top-up", {
+                // 阻止冒泡：不要把"去充值"的点击误当成本行余额的单击/双击
+                onClick: (event) => event.stopPropagation(),
+                onDoubleClick: (event) => event.stopPropagation(),
+                onContextMenu: onBalanceContextMenu,
+              }),
               children: "去充值",
             }),
           ],
@@ -1028,6 +1234,35 @@ function UsageCostLine({ useProjection, sessionId }) {
       const [splitUsage, setSplitUsage] = react.useState(null);
       const [subagentUsage, setSubagentUsage] = react.useState(null);
       const [splitReady, setSplitReady] = react.useState(false);
+      // 消耗明细面板：**点击展开**（对齐 DSH 原生「会话统计」的交互——点开切换 + 选中态 + portal 浮层）
+      const [detailsOpen, setDetailsOpen] = react.useState(false);
+      const detailsAnchorRef = react.useRef(null);
+      const detailsPanelRef = react.useRef(null);
+      // 定位与"点外部关闭"复用 DSH primitives 的 hook，行为/视觉都与原生浮层一致。
+      // 运行时探测（DSH 内部 API 无兼容承诺）：hook 不存在时退化为无定位（面板仍渲染），不拖垮消耗行。
+      // 注意这里的条件调用是安全的——primitives 是模块级常量，同一组件生命周期内判定结果恒定。
+      const anchoredPosition =
+        typeof primitives.useAnchoredPosition === "function"
+          ? primitives.useAnchoredPosition({
+              open: detailsOpen,
+              anchorRef: detailsAnchorRef,
+              panelRef: detailsPanelRef,
+              side: "top",
+              gap: 6,
+              margin: 8,
+            })
+          : null;
+      if (typeof primitives.useDismissOnOutsidePointer === "function") {
+        primitives.useDismissOnOutsidePointer(detailsAnchorRef, detailsOpen, setDetailsOpen, detailsPanelRef);
+      }
+      react.useEffect(() => {
+        if (!detailsOpen) return;
+        const onKeyDown = (event) => {
+          if (event.key === "Escape") setDetailsOpen(false);
+        };
+        document.addEventListener("keydown", onKeyDown);
+        return () => document.removeEventListener("keydown", onKeyDown);
+      }, [detailsOpen]);
 
       // 会话 token 总量（未缓存输入 + 缓存读/写 + 输出）；为 0 时代表还没有消耗。
       const usageKey = usage
@@ -1095,46 +1330,120 @@ function UsageCostLine({ useProjection, sessionId }) {
         : 0;
       const subCount = hasSubagent ? (subagentUsage.sessions ?? 0) : 0;
 
-      const detailLines = [
-        "模型：" + (model || "未知（按 deepseek-v4-flash 价估算）"),
-        "新增：" + formatTokens(newTokens) + " tokens（未缓存输入 " + formatTokens(uncachedInput) + " + 输出 " + formatTokens(output) + "）",
-        "计费：" + formatTokens(billedTotal) + " tokens（含缓存重读 " + formatTokens(cacheRead) + "、缓存写入 " + formatTokens(cacheWrite) + "）",
+      // 缓存命中率口径与 DSH 相同：缓存读取 / (缓存读取 + 未缓存输入)
+      const cacheHitBase = cacheRead + uncachedInput;
+      const cacheHitPercent = cacheHitBase > 0 ? Math.round((cacheRead / cacheHitBase) * 100) : 0;
+
+      // pill = 图标 + 文字标签 + 金额：DSH 那颗 pill 已经在显示「{tok} · 缓存命中 {%}」，
+      // 所以这里不再重复那些数字，但**保留文字说明**（用户要求「最早之前的文字」）。
+      // 图标与 DSH 那颗保持一致（都用 IconDatabaseOutlineRegular）——换别的图标会「不搭配」
+      // （2026-09-28 反馈「图标换了 不搭配」，仪表版被否掉）。
+      // 图标缺失（DSH 改 API）时不渲染，文字照常显示，不影响点击。
+      const children = [
+        typeof primitives.IconDatabaseOutlineRegular === "function"
+          ? jsx.jsx(primitives.IconDatabaseOutlineRegular, { key: "icon" })
+          : null,
+        jsx.jsx("span", { key: "label", className: "balance-usage-label", children: "本会话消耗" }),
+        jsx.jsx("span", { key: "cost", className: "balance-usage-label", children: "≈ ¥" + cost.toFixed(4) }),
+      ];
+
+      // ── 点击展开的明细浮层（结构与 DSH 原生「会话统计」一致：标题 + 分隔线 + dl 两列网格）──
+      const usageDetails = [
+        ["缓存命中", cacheHitPercent + "%"],
+        ["未缓存输入", formatTokens(uncachedInput) + " tok"],
+        ["缓存读取", formatTokens(cacheRead) + " tok"],
+      ];
+      if (cacheWrite > 0) usageDetails.push(["缓存写入", formatTokens(cacheWrite) + " tok"]);
+      usageDetails.push(["输出", formatTokens(output) + " tok"]);
+
+      const costDetails = [
+        ["新增 tokens", formatTokens(newTokens) + " tok"],
+        ["计费 tokens", formatTokens(billedTotal) + " tok"],
+        ["模型", model || "未知（按 flash 价估算）"],
       ];
       if (splitUsable) {
-        detailLines.push(
-          "时段拆分：高峰 " + formatTokens(peakTokens) + " tokens + 空闲 " + formatTokens(offpeakTokens) + " tokens",
-          "估算金额：¥" + cost.toFixed(4) + "（高峰桶按目录价×2、空闲桶按目录价）",
+        costDetails.push(
+          ["高峰 tokens", formatTokens(peakTokens) + " tok"],
+          ["空闲 tokens", formatTokens(offpeakTokens) + " tok"],
         );
-      } else {
-        detailLines.push("估算金额：¥" + cost.toFixed(4) + "（按当前时段价估算）");
       }
       if (hasSubagent) {
-        const subPeak = subagentUsage.peak.inputTokens + subagentUsage.peak.cacheReadTokens + subagentUsage.peak.cacheWriteTokens + subagentUsage.peak.outputTokens;
-        const subOff = subagentUsage.offpeak.inputTokens + subagentUsage.offpeak.cacheReadTokens + subagentUsage.offpeak.cacheWriteTokens + subagentUsage.offpeak.outputTokens;
-        detailLines.push(
-          "子代理消耗：新增 " + formatTokens(subNewTokens) + " tokens、计费 " + formatTokens(subagentUsage.totalTokens) + " tokens（" + subCount + " 个子代理）",
-          "子代理金额：¥" + subCost.toFixed(4) + "（高峰桶×2、空闲桶按目录价）",
+        costDetails.push(
+          ["子代理", subCount + " 个"],
+          ["子代理 tokens", "+" + formatTokens(subNewTokens) + " / 计费 " + formatTokens(subagentUsage.totalTokens)],
         );
       }
-      const children = [
-        jsx.jsx("span", { children: "本会话消耗" }),
-        jsx.jsx("span", { children: jsx.jsx("strong", { children: formatTokens(newTokens) + " tokens" }) }),
-      ];
-      if (billedTotal > newTokens) {
-        children.push(jsx.jsx("span", { children: "计费 " + formatTokens(billedTotal) }));
-      }
-      children.push(jsx.jsxs("span", { children: ["≈ ", jsx.jsx("strong", { children: "¥" + cost.toFixed(4) })] }));
-      if (hasSubagent) {
-        children.push(jsx.jsx("span", { children: "子代理 +" + formatTokens(subNewTokens) + " ≈ ¥" + subCost.toFixed(4) }));
-      }
-      return jsx.jsx(primitives.Tooltip, {
-        label: detailLines.join("\n"),
-        side: "top",
-        delayMs: 300,
-        children: jsx.jsxs("div", {
-          className: "balance-usage-line",
-          children,
+
+      const detailRows = (prefix, rows) =>
+        rows.flatMap(([label, value], index) => [
+          jsx.jsx("dt", { key: prefix + index + "t", children: label }),
+          jsx.jsx("dd", { key: prefix + index + "d", children: value }),
+        ]);
+
+      const panelChildren = [
+        jsx.jsxs("div", {
+          className: "balance-usage-panel__title",
+          children: [
+            jsx.jsxs("span", {
+              className: "balance-usage-panel__label",
+              children: [
+                typeof primitives.IconDatabaseOutlineRegular === "function"
+                  ? jsx.jsx(primitives.IconDatabaseOutlineRegular, {})
+                  : null,
+                "Token 用量",
+              ],
+            }),
+            jsx.jsx("span", { className: "balance-usage-panel__value", children: formatTokens(billedTotal) + " tok" }),
+          ],
+        }),
+        jsx.jsx("div", { className: "balance-usage-panel__rule" }),
+        jsx.jsx("dl", { className: "balance-usage-panel__details", children: detailRows("u", usageDetails) }),
+        jsx.jsxs("div", {
+          className: "balance-usage-panel__title balance-usage-panel__title--second",
+          children: [
+            jsx.jsxs("span", {
+              className: "balance-usage-panel__label",
+              children: [
+                typeof primitives.IconGaugeOutlineRegular === "function"
+                  ? jsx.jsx(primitives.IconGaugeOutlineRegular, {})
+                  : null,
+                "本会话金额",
+              ],
+            }),
+            jsx.jsx("span", { className: "balance-usage-panel__value", children: "≈ ¥" + cost.toFixed(4) }),
+          ],
         }),
+        jsx.jsx("div", { className: "balance-usage-panel__rule" }),
+        jsx.jsx("dl", { className: "balance-usage-panel__details", children: detailRows("c", costDetails) }),
+      ];
+
+      return jsx.jsxs("div", {
+        className: "balance-usage-wrap",
+        children: [
+          jsx.jsx("button", {
+            type: "button",
+            ref: detailsAnchorRef,
+            className: "balance-usage-line",
+            "aria-haspopup": "dialog",
+            "aria-expanded": detailsOpen,
+            "aria-label": "本会话 Token 用量与金额明细",
+            onClick: () => setDetailsOpen((value) => !value),
+            children,
+          }),
+          detailsOpen
+            ? reactDom.createPortal(
+                jsx.jsx("div", {
+                  ref: detailsPanelRef,
+                  className: "balance-usage-panel",
+                  role: "dialog",
+                  "aria-label": "本会话 Token 用量",
+                  style: anchoredPosition ?? void 0,
+                  children: panelChildren,
+                }),
+                document.body,
+              )
+            : null,
+        ],
       });
     }
 
@@ -1142,6 +1451,8 @@ function UsageCostLine({ useProjection, sessionId }) {
     const inject = ["slots", "sessions"];
 
     function apply(ctx) {
+      // 保存 ctx：用于探测官方版 DSH 的侧栏内嵌浏览器（ctx.sidebarRight / ctx.sidebarRightTabs）
+      pluginCtx = ctx;
       // 拿到 sessions 服务，用于解析当前会话使用的模型（按模型取价）
       sessionsFace = ctx.sessions;
       // 余额显示：展开态底部胶囊（order 20 排在市场 10 之后、紧挨设置）；收起态悬浮 FAB

package/lib/index.js

@@ -314,6 +314,78 @@ function formatBalance(balance) {
   return `余额（${balance.currency || "CNY"}）：${balance.total_balance}\n  充值余额：${balance.topped_up_balance}\n  赠送余额：${balance.granted_balance}`;
 }
 
+// ── 官方 DeepSeek Harness 账号服务（ctx.deepseekAccount）──────────────────────
+// 官方桌面版内置账号登录（系统浏览器 PKCE），登录后可直接读到官方余额，无需 API Key。
+// 服务由 @deepseek-ai/dsh-deepseek-account-platform 提供，已被 dsh-base 默认依赖，故官方版开箱即有。
+// 接口：getBalance(client) → { status:"ready", value: 充值钱包[], bonusWallets: 赠送钱包[] }
+//                          | null                 （未登录 / 凭据已变更）
+//                          | { status:"failed" }  （网络失败；官方明确“失败绝不变成 0 余额”）
+// client 是 AccountClientMetadata（version / locale / timezoneOffsetSeconds），
+// 缺字段会在平台侧组装请求头时抛错，所以三个字段都要给。
+const PLUGIN_VERSION = "1.2.3";
+
+/**
+ * 读取官方账号余额并归一化成与 normalizeBalance 相同的形状。
+ * 服务不存在、未登录、接口报错一律返回 null，由调用方回退 API Key，绝不因此抛错。
+ */
+async function fetchAccountBalance(ctx) {
+  const account = typeof ctx.get === "function" ? ctx.get("deepseekAccount") : void 0;
+  if (account === void 0 || account === null || typeof account.getBalance !== "function") return null;
+  let result;
+  try {
+    result = await account.getBalance({
+      version: PLUGIN_VERSION,
+      locale: "zh-CN",
+      // 平台要求“东为正”的整秒偏移；JS 的 getTimezoneOffset() 是西为正，故取反。
+      timezoneOffsetSeconds: -new Date().getTimezoneOffset() * 60,
+    });
+  } catch {
+    return null;
+  }
+  if (result === null || result === void 0 || result.status !== "ready") return null;
+  return normalizeAccountBalance(result);
+}
+
+/** 官方钱包结构 → 统一余额形状。value 是充值钱包，bonusWallets 是赠送钱包（官方不计入充值余额）。 */
+function normalizeAccountBalance(result) {
+  const pick = (list) => {
+    const arr = Array.isArray(list) ? list.filter((w) => w && typeof w.balance === "string") : [];
+    return arr.find((w) => w.currency === "CNY") ?? arr[0] ?? null;
+  };
+  const topped = pick(result.value);
+  const granted = pick(result.bonusWallets);
+  // 官方金额字符串遵循 big.js 文法（允许 0E-16 这类写法），Number() 能正确解析。
+  const toppedRaw = Number(topped?.balance ?? 0);
+  const grantedRaw = Number(granted?.balance ?? 0);
+  const toppedUp = Number.isFinite(toppedRaw) ? toppedRaw : 0;
+  const grantedAmount = Number.isFinite(grantedRaw) ? grantedRaw : 0;
+  const total = toppedUp + grantedAmount;
+  return {
+    is_available: total > 0,
+    currency: topped?.currency || granted?.currency || "CNY",
+    total_balance: total.toFixed(2),
+    granted_balance: grantedAmount.toFixed(2),
+    topped_up_balance: toppedUp.toFixed(2),
+    source: "account",
+  };
+}
+
+/** 取余额：官方账号优先，回退 DeepSeek API Key。返回 { balance, error }，二者必有其一。 */
+async function resolveBalance(ctx, config, signal) {
+  const fromAccount = await fetchAccountBalance(ctx);
+  if (fromAccount !== null) return { balance: fromAccount, error: null };
+  const apiKey = await resolveApiKey(ctx, config);
+  if (apiKey === "") {
+    return { balance: null, error: "未登录 DeepSeek 账号，也未设置 DEEPSEEK_API_KEY" };
+  }
+  try {
+    const data = await fetchBalance(apiKey, signal);
+    return { balance: { ...normalizeBalance(data), source: "apikey" }, error: null };
+  } catch (error) {
+    return { balance: null, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 /** 构建模型切换点列表（按时间升序）。request/header、request/context 都在模型或请求设置变化时写入，
  *  故可用它们把会话切成若干"模型段"，每条 assistant/message 归属到"它之前最近一个切换点"的模型。
  *  这样换不同价模型时（如 flash→pro）金额能按各段模型分别计价，而不是整会话用最后一个模型。 */
@@ -811,32 +883,21 @@ export function apply(ctx, config = {}) {
       name: "balance",
       description: "查询 DeepSeek 余额与当前会话消耗",
       handler: async ({ agent, signal }) => {
-        const apiKey = await resolveApiKey(ctx, config);
-        if (apiKey === "") {
-          return {
-            kind: "error",
-            text: "未找到 DeepSeek API Key，请设置环境变量 DEEPSEEK_API_KEY 后重试。",
-          };
-        }
-
         const usage = sumSessionUsage(agent.session, config);
         const model = detectModel(agent.session);
         const pricing = resolvePricing(config, model);
-
-        try {
-          const data = await fetchBalance(apiKey, signal);
-          const balanceText = formatBalance(normalizeBalance(data));
-          return {
-            kind: "success",
-            text: `${balanceText}\n\n${formatUsage(usage, pricing, model)}`,
-          };
-        } catch (error) {
-          const message = error instanceof Error ? error.message : String(error);
+        // 余额来源：官方账号优先（官方版内置登录，无需 API Key），回退 API Key。
+        const { balance, error } = await resolveBalance(ctx, config, signal);
+        if (balance === null) {
           return {
             kind: "error",
-            text: `${message}\n\n${formatUsage(usage, pricing, model)}`,
+            text: `${error}\n\n${formatUsage(usage, pricing, model)}`,
           };
         }
+        return {
+          kind: "success",
+          text: `${formatBalance(balance)}\n\n${formatUsage(usage, pricing, model)}`,
+        };
       },
     });
   });
@@ -885,22 +946,6 @@ export function apply(ctx, config = {}) {
             statsError = error instanceof Error ? error.message : String(error);
           }
         }
-        const apiKey = await resolveApiKey(ctx, config);
-        if (apiKey === "") {
-          if (wantStats) {
-            writeJson(res, 200, {
-              ok: true,
-              balance: null,
-              balanceError: "未设置 DEEPSEEK_API_KEY",
-              pricing: resolvePricing(config, model),
-              stats,
-              statsError,
-            });
-          } else {
-            writeJson(res, 200, { ok: false, error: "未设置 DEEPSEEK_API_KEY" });
-          }
-          return;
-        }
         // 按 session id 取会话并分时段汇总 usage（拿不到则返回 null，客户端回退用本地投影）
         let usage = null;
         // 子代理后代会话的 usage 汇总（与主会话分开）
@@ -953,33 +998,23 @@ export function apply(ctx, config = {}) {
         if (subagentUsage && Array.isArray(subagentUsage.byModel)) {
           subagentUsage.byModel = subagentUsage.byModel.map((b) => ({ ...b, cost: estimateCost(b, resolvePricing(config, b.model, b.era)) }));
         }
-        try {
-          const data = await fetchBalance(apiKey);
-          writeJson(res, 200, {
-            ok: true,
-            balance: normalizeBalance(data),
-            pricing: resolvePricing(config, effectiveModel),
-            model: effectiveModel,
-            usage,
-            subagentUsage,
-            stats,
-            statsError,
-          });
-        } catch (error) {
-          const message = error instanceof Error ? error.message : String(error);
-          if (wantStats) {
-            writeJson(res, 200, {
-              ok: true,
-              balance: null,
-              balanceError: message,
-              pricing: resolvePricing(config, effectiveModel),
-              stats,
-              statsError,
-            });
-          } else {
-            writeJson(res, 200, { ok: false, error: message });
-          }
+        // 余额来源：官方账号优先（官方桌面版内置登录，无需 API Key），回退 DeepSeek API Key。
+        const { balance, error: balanceError } = await resolveBalance(ctx, config);
+        if (balance === null && !wantStats) {
+          writeJson(res, 200, { ok: false, error: balanceError });
+          return;
         }
+        writeJson(res, 200, {
+          ok: true,
+          balance,
+          balanceError: balance === null ? balanceError : null,
+          pricing: resolvePricing(config, effectiveModel),
+          model: effectiveModel,
+          usage,
+          subagentUsage,
+          stats,
+          statsError,
+        });
       },
     });
     if (typeof balanceRouteDisposer === "function") disposers.push(balanceRouteDisposer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balance-dsh",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "查询 DeepSeek 余额并显示当前会话 token 消耗。DeepSeek 账户余额 + 会话 token/费用显示，含高峰/空闲峰谷计费。",
   "author": "Rannist",
   "type": "module",