balance-dsh 1.2.0 → 1.2.2

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

@@ -47,6 +47,12 @@ window.__ModuleLoader__.load({
 .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 +211,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 = "";
@@ -294,19 +478,76 @@ window.__ModuleLoader__.load({
 
     // ─── 高峰/空闲时段（纯客户端判断，无需服务端） ────────────────────────
     // V4 峰谷定价（2026-08-17 生效）：高峰价 = 空闲价 × 2。
-    // 官方高峰窗口（北京时间）为 周一至周五 09:00-12:00、14:00-18:00；周末全天空闲。
+    // 官方高峰窗口（北京时间）为 工作日 09:00-12:00、14:00-18:00；
+    // 周末与法定节假日全天空闲，但「调休上班的周末」按工作日算（2026-09-20 DeepSeek 明确）。
     const PEAK_WINDOWS = [
       { start: 9, end: 12 },
       { start: 14, end: 18 },
     ];
     const PEAK_WEEKDAYS = [1, 2, 3, 4, 5]; // 1=周一 … 5=周五，0/6=周末
-    function currentPeriod() {
-      const d = new Date(Date.now() + 8 * 60 * 60 * 1000); // 北京时间
+    // 中国大陆法定节假日与调休（北京时区）。**必须与 lib/index.js 的 CN_CALENDAR 完全一致**
+    // （服务端负责算钱、客户端只负责显示时段标签）。来源：国办发明电〔2025〕7号，每年需补录。
+    const CN_CALENDAR = {
+      // 元旦：1/1-1/3 放假，1/4(周日) 上班
+      "2026-01-01": "holiday", "2026-01-02": "holiday", "2026-01-03": "holiday", "2026-01-04": "workday",
+      // 春节：2/15-2/23 放假，2/14(周六)、2/28(周六) 上班
+      "2026-02-14": "workday",
+      "2026-02-15": "holiday", "2026-02-16": "holiday", "2026-02-17": "holiday", "2026-02-18": "holiday",
+      "2026-02-19": "holiday", "2026-02-20": "holiday", "2026-02-21": "holiday", "2026-02-22": "holiday",
+      "2026-02-23": "holiday", "2026-02-28": "workday",
+      // 清明节：4/4-4/6 放假（无调休）
+      "2026-04-04": "holiday", "2026-04-05": "holiday", "2026-04-06": "holiday",
+      // 劳动节：5/1-5/5 放假，5/9(周六) 上班
+      "2026-05-01": "holiday", "2026-05-02": "holiday", "2026-05-03": "holiday", "2026-05-04": "holiday",
+      "2026-05-05": "holiday", "2026-05-09": "workday",
+      // 端午节：6/19-6/21 放假（无调休）
+      "2026-06-19": "holiday", "2026-06-20": "holiday", "2026-06-21": "holiday",
+      // 国庆节调休：9/20(周日) 上班
+      "2026-09-20": "workday",
+      // 中秋节：9/25-9/27 放假（无调休）
+      "2026-09-25": "holiday", "2026-09-26": "holiday", "2026-09-27": "holiday",
+      // 国庆节：10/1-10/7 放假，10/10(周六) 上班
+      "2026-10-01": "holiday", "2026-10-02": "holiday", "2026-10-03": "holiday", "2026-10-04": "holiday",
+      "2026-10-05": "holiday", "2026-10-06": "holiday", "2026-10-07": "holiday", "2026-10-10": "workday",
+    };
+
+    // 节假日自动补录：与 lib/index.js 同源、同逻辑（客户端只用来显示时段标签）。
+    // 拉取失败静默 —— 拿不到就继续用上面的内置表。
+    const CN_CALENDAR_SOURCE = "https://cdn.jsdelivr.net/gh/NateScarlet/holiday-cn@master";
+    const cnCalendarYears = new Set();
+    async function ensureCnCalendar(year) {
+      if (cnCalendarYears.has(year)) return;
+      cnCalendarYears.add(year); // 先占位，避免并发重复请求
+      try {
+        const res = await fetch(CN_CALENDAR_SOURCE + "/" + year + ".json", { signal: AbortSignal.timeout(8000) });
+        if (!res.ok) return;
+        const data = await res.json();
+        if (!Array.isArray(data?.days)) return;
+        for (const item of data.days) {
+          if (item && typeof item.date === "string" && typeof item.isOffDay === "boolean") {
+            CN_CALENDAR[item.date] = item.isOffDay ? "holiday" : "workday";
+          }
+        }
+      } catch {
+        // 网络不可用：保留内置表
+      }
+    }
+    {
+      const y = new Date(Date.now() + 8 * 60 * 60 * 1000).getUTCFullYear();
+      void ensureCnCalendar(y - 1);
+      void ensureCnCalendar(y);
+      void ensureCnCalendar(y + 1);
+    }
+    function currentPeriod(atMs) {
+      const d = new Date((atMs === undefined ? Date.now() : atMs) + 8 * 60 * 60 * 1000); // 北京时间
+      const kind = CN_CALENDAR[
+        d.getUTCFullYear() + "-" + String(d.getUTCMonth() + 1).padStart(2, "0") + "-" + String(d.getUTCDate()).padStart(2, "0")
+      ];
+      if (kind === "holiday") return "offpeak"; // 法定节假日：全天按空闲
       const hour = d.getUTCHours();
       const weekday = d.getUTCDay(); // 0=周日 … 6=周六
-      return PEAK_WEEKDAYS.includes(weekday) && PEAK_WINDOWS.some((w) => hour >= w.start && hour < w.end)
-        ? "peak"
-        : "offpeak";
+      const onDuty = PEAK_WEEKDAYS.includes(weekday) || kind === "workday"; // 调休上班的周末按工作日算
+      return onDuty && PEAK_WINDOWS.some((w) => hour >= w.start && hour < w.end) ? "peak" : "offpeak";
     }
     /** 按当前时段调整价格：高峰 ×2、空闲原价。注意：若服务端已配 config.peak:true
      *  （强制高峰价翻倍），此处会再乘一次，两种方式不要同时使用。 */
@@ -740,9 +981,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: "查看官方用量",
                     }),
                   ],
@@ -847,11 +1086,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,
       };
@@ -889,16 +1134,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,
         }));
@@ -908,7 +1150,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) {
@@ -929,12 +1177,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: "去充值",
             }),
           ],
@@ -1085,6 +1333,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

@@ -79,7 +79,8 @@ function pricingEraAt(time) {
 }
 
 // 高峰/空闲时段（V4 峰谷定价，2026-08-17 生效）：高峰价 = 空闲价 × 2。
-// 官方高峰窗口（北京时间）为 周一至周五 09:00-12:00、14:00-18:00；周末全天空闲。
+// 官方高峰窗口（北京时间）为 工作日 09:00-12:00、14:00-18:00；
+// 周末与法定节假日全天空闲，但**调休上班的周末**按工作日算（2026-09-20 DeepSeek 明确此规则）。
 // 可用 config.peakWindows 覆盖小时窗口（如 [{start:9,end:12},{start:14,end:18}]），
 // 可用 config.peakWeekdays 覆盖周几（1=周一 … 5=周五，默认 [1,2,3,4,5]，0/6=周末）。
 const DEFAULT_PEAK_WINDOWS = [
@@ -88,7 +89,63 @@ const DEFAULT_PEAK_WINDOWS = [
 ];
 const DEFAULT_PEAK_WEEKDAYS = [1, 2, 3, 4, 5];
 
-/** 判断某时间戳（毫秒）是否处于高峰时段（按北京时间 UTC+8 计算，含周几判断）。 */
+// 中国大陆法定节假日与调休（日期为北京时区）。来源：国务院办公厅《关于2026年部分节假日安排的通知》
+// （国办发明电〔2025〕7号）。holiday = 法定节假日（全天按空闲计费）；workday = 调休上班的周末（按工作日峰谷计费）。
+// ⚠️ 国务院每年 11 月前后公布次年安排，届时需补录。lib/client.js 有一份同样的表（用于时段标签），两处必须同步。
+const CN_CALENDAR = {
+  // 元旦：1/1-1/3 放假，1/4(周日) 上班
+  "2026-01-01": "holiday", "2026-01-02": "holiday", "2026-01-03": "holiday", "2026-01-04": "workday",
+  // 春节：2/15-2/23 放假，2/14(周六)、2/28(周六) 上班
+  "2026-02-14": "workday",
+  "2026-02-15": "holiday", "2026-02-16": "holiday", "2026-02-17": "holiday", "2026-02-18": "holiday",
+  "2026-02-19": "holiday", "2026-02-20": "holiday", "2026-02-21": "holiday", "2026-02-22": "holiday",
+  "2026-02-23": "holiday", "2026-02-28": "workday",
+  // 清明节：4/4-4/6 放假（无调休）
+  "2026-04-04": "holiday", "2026-04-05": "holiday", "2026-04-06": "holiday",
+  // 劳动节：5/1-5/5 放假，5/9(周六) 上班
+  "2026-05-01": "holiday", "2026-05-02": "holiday", "2026-05-03": "holiday", "2026-05-04": "holiday",
+  "2026-05-05": "holiday", "2026-05-09": "workday",
+  // 端午节：6/19-6/21 放假（无调休）
+  "2026-06-19": "holiday", "2026-06-20": "holiday", "2026-06-21": "holiday",
+  // 国庆节调休：9/20(周日) 上班
+  "2026-09-20": "workday",
+  // 中秋节：9/25-9/27 放假（无调休）
+  "2026-09-25": "holiday", "2026-09-26": "holiday", "2026-09-27": "holiday",
+  // 国庆节：10/1-10/7 放假，10/10(周六) 上班
+  "2026-10-01": "holiday", "2026-10-02": "holiday", "2026-10-03": "holiday", "2026-10-04": "holiday",
+  "2026-10-05": "holiday", "2026-10-06": "holiday", "2026-10-07": "holiday", "2026-10-10": "workday",
+};
+
+// 节假日自动补录：内置表仅作**离线兜底**，运行时从社区维护的源拉取（其 papers 字段直接引用国务院公告）。
+// 源不可用/无网络/被 CSP 拦截时静默失败，继续用内置表；拉取结果按日期覆盖同键条目。
+const CN_CALENDAR_SOURCE = "https://cdn.jsdelivr.net/gh/NateScarlet/holiday-cn@master";
+const cnCalendarYears = new Set();
+
+/** 拉取指定年份的节假日安排并合并进 CN_CALENDAR（幂等；失败静默，不阻塞调用方）。 */
+async function ensureCnCalendar(year) {
+  if (cnCalendarYears.has(year)) return;
+  cnCalendarYears.add(year); // 先占位，避免并发重复请求
+  try {
+    const res = await fetch(CN_CALENDAR_SOURCE + "/" + year + ".json", { signal: AbortSignal.timeout(8000) });
+    if (!res.ok) return;
+    const data = await res.json();
+    if (!Array.isArray(data?.days)) return;
+    for (const item of data.days) {
+      if (item && typeof item.date === "string" && typeof item.isOffDay === "boolean") {
+        CN_CALENDAR[item.date] = item.isOffDay ? "holiday" : "workday";
+      }
+    }
+  } catch {
+    // 网络不可用：保留内置表（该年调休会退化为「周末全天空闲」）
+  }
+}
+
+/** 北京时区日期键 YYYY-MM-DD（传入已 +8h 偏移的 Date）。 */
+function cnDateKey(d) {
+  return d.getUTCFullYear() + "-" + String(d.getUTCMonth() + 1).padStart(2, "0") + "-" + String(d.getUTCDate()).padStart(2, "0");
+}
+
+/** 判断某时间戳（毫秒）是否处于高峰时段（北京时间；含周末、法定节假日与调休上班判断）。 */
 function isPeakAt(timeMs, config) {
   const windows = (Array.isArray(config?.peakWindows) && config.peakWindows.length > 0
     ? config.peakWindows
@@ -98,9 +155,12 @@ function isPeakAt(timeMs, config) {
     ? config.peakWeekdays.map(Number)
     : DEFAULT_PEAK_WEEKDAYS;
   const d = new Date(Number(timeMs) + 8 * 60 * 60 * 1000); // 北京时间
+  const kind = CN_CALENDAR[cnDateKey(d)];
+  if (kind === "holiday") return false; // 法定节假日：全天按空闲计费
   const hour = d.getUTCHours();
   const weekday = d.getUTCDay(); // 0=周日 … 6=周六
-  return weekdays.includes(weekday) && windows.some((w) => hour >= w.start && hour < w.end);
+  const onDuty = weekdays.includes(weekday) || kind === "workday"; // 调休上班的周末按工作日算
+  return onDuty && windows.some((w) => hour >= w.start && hour < w.end);
 }
 
 /** 把模型字符串规整到定价表键；未识别返回 ""（用 Flash 价兜底）。
@@ -254,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.2";
+
+/**
+ * 读取官方账号余额并归一化成与 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）金额能按各段模型分别计价，而不是整会话用最后一个模型。 */
@@ -736,38 +868,36 @@ export function apply(ctx, config = {}) {
   // 时统一清理，保证重复 apply 不冲突。
   const disposers = [];
 
+  // 后台补录节假日数据（当年 ±1 年，覆盖 90 天统计窗口与跨年场景）。
+  // 故意不 await：拉取失败不能影响插件启动；isPeakAt 保持同步，未拉到时继续用内置表。
+  {
+    const y = new Date(Date.now() + 8 * 60 * 60 * 1000).getUTCFullYear();
+    void ensureCnCalendar(y - 1);
+    void ensureCnCalendar(y);
+    void ensureCnCalendar(y + 1);
+  }
+
   // 1) /balance 命令：保留命令行查询入口
   ctx.inject(["commands"], (commandCtx) => {
     commandCtx.commands.register({
       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)}`,
+        };
       },
     });
   });
@@ -816,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 汇总（与主会话分开）
@@ -884,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.0",
+  "version": "1.2.2",
   "description": "查询 DeepSeek 余额并显示当前会话 token 消耗。DeepSeek 账户余额 + 会话 token/费用显示，含高峰/空闲峰谷计费。",
   "author": "Rannist",
   "type": "module",