balance-dsh 2.0.0 → 2.0.2

package/lib/client.js

@@ -45,7 +45,7 @@ window.__ModuleLoader__.load({
 .balance-footer__din{animation:balance-roll-in .42s cubic-bezier(.33,.66,.24,1) forwards}
 @keyframes balance-roll-out{0%{transform:translateY(0);opacity:1}60%{opacity:0}100%{transform:translateY(-105%);opacity:0}}
 @keyframes balance-roll-in{0%{transform:translateY(105%);opacity:0}40%{opacity:0}100%{transform:translateY(0);opacity:1}}
-@media (prefers-reduced-motion:reduce){.balance-footer__dout,.balance-footer__din{animation:none}.balance-footer__dout{display:none}.balance-footer__din{position:static}}
+/* 逐位滚动不受 prefers-reduced-motion 影响：它是"这轮花掉多少"的即时反馈，是插件特色 */
 .balance-footer__wave{position:absolute;left:0;right:0;top:0;bottom:0;overflow:hidden;border-radius:var(--dsw-radius-lg,14px);corner-shape:round;pointer-events:none;z-index:2}
 /* 前沿白条：纯白，不带品牌色辉光（2026-10-30 反馈「只保留白色光效 不要颜色」）。
    只扫一层白光，**不覆盖扫过区域**——曾经有一个 ::after 暗罩把白条右侧整体压暗，
@@ -54,7 +54,7 @@ window.__ModuleLoader__.load({
 .balance-footer__wave::before{content:"";position:absolute;top:1px;bottom:1px;left:0;width:2.5px;margin-left:-1.25px;border-radius:999px;corner-shape:round;background:#fff;box-shadow:0 0 3px 1px rgba(255,255,255,.95),0 0 8px 3px rgba(255,255,255,.42),0 0 14px 5px rgba(255,255,255,.16);animation:balance-wipe-head .58s cubic-bezier(.34,.7,.26,1) forwards}
 @keyframes balance-wipe-head{0%{left:0;opacity:0}5%{opacity:1}82%{opacity:1}100%{left:100%;opacity:0}}
 /* 尊重系统的「减少动态效果」：不播，只留 --stale 的静态弱化 */
-@media (prefers-reduced-motion:reduce){.balance-footer__wave::before{animation:none;opacity:0}}
+/* 浪潮白条不受 prefers-reduced-motion 影响：它是右键刷新的签名动效，故意保留 */
 /* 旧版余额行用到的图标与「余额」二字（footerStyle === "classic" 时才渲染） */
 .balance-footer__icon{display:inline-flex;flex:none;color:var(--dsw-alias-label-primary)}
 .balance-footer__label{flex:none;color:var(--dsw-alias-label-primary)}
@@ -105,6 +105,9 @@ window.__ModuleLoader__.load({
 .balance-panel-icon--unread{color:var(--dsw-alias-brand-primary,#4d6bfe)}
 /* 红点：贴在图标右上角，深色描边保证在任意底色上都看得清 */
 .balance-panel-icon__dot{position:absolute;top:-2px;right:-3px;box-sizing:border-box;width:7px;height:7px;border-radius:50%;corner-shape:round;background:var(--dsw-alias-state-error-primary,#e5484d);box-shadow:0 0 0 1.5px var(--dsw-alias-bg-module-platform,var(--dsw-alias-base,#1b1b1c)),0 0 5px 1px color-mix(in srgb,var(--dsw-alias-state-error-primary,#e5484d) 65%,transparent);animation:balance-dot-pulse 2.2s ease-in-out infinite}
+/* 有新版本时的文字提示：品牌色实心小胶囊，绝对定位压在图标右上，
+   视觉上落在「余额与用量」几个字的上方。不做脉冲 —— 那是红点的语言，且静止更醒目。 */
+.balance-panel-icon__new{position:absolute;left:10px;top:-10px;box-sizing:border-box;padding:1px 4px;border-radius:999px;corner-shape:round;background:var(--dsw-alias-brand-primary,#4d6bfe);color:var(--dsw-alias-label-primary-foreground,#fff);font-size:8.5px;line-height:11px;font-weight:600;letter-spacing:.1px;white-space:nowrap;pointer-events:none;box-shadow:0 1px 4px color-mix(in srgb,var(--dsw-alias-brand-primary,#4d6bfe) 55%,transparent)}
 @keyframes balance-dot-pulse{0%,100%{transform:scale(1);opacity:1}50%{transform:scale(.82);opacity:.72}}
 @media (prefers-reduced-motion:reduce){.balance-panel-icon__dot{animation:none}}
 /* ── 侧栏面板页（点左侧「余额与用量」后渲染在主区域） ──────────────────── */
@@ -294,6 +297,10 @@ window.__ModuleLoader__.load({
 .balance-settings__input{box-sizing:border-box;width:96px;height:34px;padding:0 10px;text-align:right;font-variant-numeric:tabular-nums;border:.5px solid var(--dsw-alias-border-l4,rgba(127,127,127,.35));border-radius:var(--dsw-radius-md,8px);background:var(--dsw-alias-bg-layer-3,rgba(127,127,127,.1));color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;font-variant-numeric:tabular-nums;outline:none}
 .balance-settings__input:focus-visible{outline:none;border-color:var(--dsw-alias-state-business-primary,#4d6bfe)}
 .balance-settings__input--wide{width:100%;max-width:340px;min-width:0;text-align:left}
+/* 关掉侧边栏入口后的提醒：壳用 DSH 官方 Modal，这里只留正文排版。 */
+.balance-tip-body{margin:0;font-size:13px;line-height:1.7;color:var(--dsw-alias-label-secondary)}
+.balance-tip-ok{padding:5px 14px;border:.5px solid transparent;border-radius:var(--dsw-radius-md,8px);background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3);font:inherit;font-size:13px;line-height:1.5;cursor:pointer}
+.balance-tip-ok:hover{opacity:.88}
 .balance-settings__toggle{position:relative;box-sizing:border-box;flex:none;width:36px;height:20px;padding:2px;border:none;border-radius:999px;corner-shape:round;background:var(--dsw-alias-border-l3,rgba(127,127,127,.35));cursor:pointer;transition:background .12s ease}
 .balance-settings__toggle[aria-checked="true"]{background:var(--dsw-alias-brand-primary,#4d6bfe)}
 .balance-settings__toggle::after{content:"";display:block;width:16px;height:16px;border-radius:50%;corner-shape:round;background:var(--dsw-alias-switch-thumb,#fff);transition:transform .12s ease}
@@ -303,14 +310,33 @@ window.__ModuleLoader__.load({
 .balance-settings__segment{box-sizing:border-box;padding:2px 12px;border:none;border-radius:999px;corner-shape:round;background:0 0;color:var(--dsw-alias-label-secondary);font:inherit;font-size:12px;line-height:18px;font-weight:500;cursor:pointer;white-space:nowrap;transition:background .15s var(--ds-ease-in-out,.2s),color .15s var(--ds-ease-in-out,.2s)}
 .balance-settings__segment:hover{color:var(--dsw-alias-label-primary)}
 .balance-settings__segment--on{background:var(--dsw-alias-bg-module-platform,var(--dsw-alias-bg-base,#2a2a2c));color:var(--dsw-alias-label-primary);box-shadow:0 1px 2px rgba(0,0,0,.2)}
+/* 版本与更新区块：设置页第一块（紧跟计费范围告示条）。
+   默认是中性底色，只在「有新版本」时提亮成品牌色、「刚更新完」时转成功色，
+   失败不染色（网络波动不该看起来像错误告警）。 */
+.balance-settings__update{margin:0 0 16px;padding:11px 13px;border-radius:var(--dsw-radius-md,8px);border:.5px solid var(--dsw-alias-border-l2,rgba(127,127,127,.22));background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.1))}
+.balance-settings__update--newer{border-color:color-mix(in srgb,var(--dsw-alias-brand-primary,#4d6bfe) 34%,transparent);background:color-mix(in srgb,var(--dsw-alias-brand-primary,#4d6bfe) 12%,transparent)}
+.balance-settings__update--done{border-color:color-mix(in srgb,var(--dsw-alias-state-success-primary,#22c55e) 34%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-success-primary,#22c55e) 11%,transparent)}
+.balance-settings__update-head{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}
+.balance-settings__update-title{display:flex;align-items:center;gap:7px;min-width:0;font-size:12.5px;line-height:18px;color:var(--dsw-alias-label-secondary)}
+.balance-settings__update-ver{font-weight:600;color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums}
+/* 新版徽标：实心品牌色胶囊，形状必须是正圆角（DSH 全局把圆角改成 superellipse 了） */
+.balance-settings__update-badge{flex:none;padding:1px 7px;border-radius:999px;corner-shape:round;background:var(--dsw-alias-brand-primary,#4d6bfe);color:#fff;font-size:11px;font-weight:600;line-height:16px;white-space:nowrap}
+.balance-settings__update-btns{display:flex;align-items:center;gap:6px;flex:none}
+/* 查询中的进度文案：跟按钮同一行、排在左边，灰一点，不跟主文案抢注意力。 */
+.balance-settings__update-busy{flex:none;font-size:11.5px;line-height:17px;color:var(--dsw-alias-label-tertiary);white-space:nowrap}
+/* 标题行左侧的状态话（目前只有「已是最新版本。」）—— 成功绿，前面一个细分隔点，
+   与「版本 2.0.2」拉开层次但不抢眼。 */
+.balance-settings__update-inline{flex:none;font-size:11.5px;line-height:17px;color:var(--dsw-alias-state-success-primary,#22c55e);white-space:nowrap}
+.balance-settings__update-inline::before{content:"·";margin:0 2px 0 0;color:var(--dsw-alias-label-tertiary)}
+.balance-settings__update-note{margin:7px 0 0;font-size:11.5px;line-height:17px;color:var(--dsw-alias-label-tertiary)}
 .balance-settings__actions{display:flex;align-items:center;gap:8px;margin:14px 0 0;padding:12px 0 0;border-top:.5px solid var(--dsw-alias-border-l2,rgba(127,127,127,.22))}
 .balance-settings__status{flex:1;min-width:0;font-size:12px;line-height:17px;color:var(--dsw-alias-label-tertiary)}
 .balance-settings__status--error{color:var(--dsw-alias-state-error-primary,#e5484d)}
 .balance-settings__status--ok{color:var(--dsw-alias-state-success-primary,#22c55e)}
-.balance-settings__btn{box-sizing:border-box;flex:none;padding:5px 14px;border:1px solid transparent;border-radius:var(--dsw-radius-md,8px);background:0 0;color:var(--dsw-alias-label-secondary);font:inherit;font-size:13px;line-height:1.5;cursor:pointer;transition:opacity .12s ease,color .12s ease}
-.balance-settings__btn:hover:not(:disabled){color:var(--dsw-alias-label-primary)}
+.balance-settings__btn{box-sizing:border-box;flex:none;padding:5px 14px;border:.5px solid var(--dsw-alias-border-l2,rgba(127,127,127,.28));border-radius:var(--dsw-radius-md,8px);background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.1));color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;line-height:1.5;cursor:pointer;transition:background .12s ease,border-color .12s ease,opacity .12s ease}
+.balance-settings__btn:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-active,rgba(127,127,127,.18))}
 .balance-settings__btn:disabled{opacity:.4;cursor:default}
-.balance-settings__btn--primary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
+.balance-settings__btn--primary{border-color:transparent;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)}
 .balance-settings__btn--primary:hover:not(:disabled){opacity:.88;color:var(--dsw-alias-bg-layer-3)}
 .balance-settings__summary{display:inline-flex;align-items:center;gap:8px;font-size:12px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums}
 `;
@@ -900,6 +926,73 @@ window.__ModuleLoader__.load({
       return settingsCache.value;
     }
 
+    // ─── 检查更新 ─────────────────────────────────────────────────────────────
+    /** 查 npm 上有没有新版本（/balance-api?update=1）。
+     *  返回 { ok, current, latest, newer, error }；有新版时 newer = true。
+     *  只是查版本号，不下载任何东西；失败时 ok = false 且 error 带原因。 */
+    async function fetchUpdateInfo() {
+      const res = await fetch("/balance-api?update=1", { headers: { accept: "application/json" }, cache: "no-store" });
+      if (!res || !res.ok) throw new Error("HTTP " + (res ? res.status : "?"));
+      const data = await res.json();
+      const current =
+        data && typeof data.current === "string" && data.current !== ""
+          ? data.current
+          : String(settingsCache.version || "");
+      if (!data || data.ok !== true) {
+        return {
+          ok: false,
+          current,
+          latest: "",
+          newer: false,
+          error: data && typeof data.error === "string" ? data.error : "未知原因",
+        };
+      }
+      const latest = typeof data.latest === "string" ? data.latest : "";
+      return { ok: true, current, latest, newer: compareVersion(latest, current) > 0, error: "" };
+    }
+
+    // ─── 启动检查更新 → 侧栏入口红点 ────────────────────────────────────────
+    // 每次打开 DeepSeek Harness 查一次 npm，有新版本就在左侧「余额与用量」
+    // 入口上亮一颗红点（用户要求）。只查版本号，不下载、不弹窗、不打扰。
+    let updateNotice = { latest: "", seen: false };
+    const updateNoticeListeners = new Set();
+    function emitUpdateNotice() {
+      for (const listener of updateNoticeListeners) {
+        // 单个订阅者抛错不能影响其它（也别冒泡到渲染阶段）
+        try {
+          listener();
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+
+    /** 订阅「有没有新版本」。与 settingsListeners 分开，避免每次改设置都重查。 */
+    function useUpdateNotice() {
+      const [, force] = react.useState(0);
+      react.useEffect(() => {
+        const listener = () => force((n) => n + 1);
+        updateNoticeListeners.add(listener);
+        return () => updateNoticeListeners.delete(listener);
+      }, []);
+      return updateNotice;
+    }
+
+    /** 启动检查（每次页面加载跑一次，apply 里延迟调度）。失败静默：没有红点而已。 */
+    async function checkUpdateOnStartup() {
+      try {
+        const info = await fetchUpdateInfo();
+        if (!info || info.ok !== true || info.newer !== true) return;
+        // latest 变了才重置 seen —— 用户已经无视过 2.1.0，再出 2.2.0 仍然要提示
+        if (updateNotice.latest !== info.latest) {
+          updateNotice = { latest: info.latest, seen: false };
+          emitUpdateNotice();
+        }
+      } catch {
+        /* 网络/接口不可用：当作没新版，不写日志不打扰 */
+      }
+    }
+
     /** 订阅设置（首次挂载异步拉一次）。 */
     function useSettings() {
       const [, force] = react.useState(0);
@@ -1048,17 +1141,10 @@ window.__ModuleLoader__.load({
     // 也不出现"余额变了但动效没播/播了一半被打断"（2026-10-30 反馈）。
     let manualRefreshLockedUntil = 0;
 
-    function reducedMotion() {
-      try {
-        return typeof window !== "undefined" && typeof window.matchMedia === "function"
-          && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
-      } catch {
-        return false;
-      }
-    }
-    // 系统开了"减少动态效果"时 CSS 那份动画本来就是 none，锁个 580ms 只会像卡住，所以放行。
     function waveLockDuration() {
-      return reducedMotion() ? 0 : WAVE_DURATION_MS;
+      // 恒等于动画时长。刻意**不**跟随 prefers-reduced-motion —— 白条是本插件的
+      // 签名动效，系统开了「减少动态效果」也照播（用户明确要求，别再加回判断）。
+      return WAVE_DURATION_MS;
     }
 
     function onBalanceContextMenu(event) {
@@ -2297,7 +2383,14 @@ function UsageCostLine({ useProjection, sessionId }) {
       //   · 用户从 1.3.0 直接跳到 1.3.5（跳过中间版本）也会看到红点
       //   · 点过之后写回 entrySeen: true，红点永久消失，重启也不回来
       //   · 判定用 !== true 而不是 === false，老设置文件里没有这个键也照样算未读
-      const unread = settings.entrySeen !== true && !active;
+      const notice = useUpdateNotice();
+      // 有新版本、且还没点开过面板 → 在图标右上角挂一个「新版本！」胶囊。
+      // 用户要求：别再让它跟「有新内容」的未读红点用同一个提示（重复且不显眼）。
+      const updateHint = notice.latest !== "" && notice.seen !== true && !active;
+      const unread = settings.entrySeen !== true && !active && !updateHint;
+      // 关掉「侧边栏显示本插件」→ 这一格直接不渲染（图标消失）。
+      // 位置必须在所有 hook 之后，否则不同渲染间 hook 数量不一致，React 会直接报错。
+      if (settings.showSidebarEntry === false) return null;
       const svg = jsx.jsx("svg", {
         width: p,
         height: p,
@@ -2316,26 +2409,44 @@ function UsageCostLine({ useProjection, sessionId }) {
           jsx.jsx("path", { d: "M18 12a2 2 0 0 0 0 4h4v-4Z" }),
         ],
       });
-      if (!unread) return svg;
+      if (!unread && !updateHint) return svg;
       // 点一下图标（红点就在图标右上角，点哪都算）就立刻熄灯：
       // 本地先乐观置 true 并广播，红点在同一帧消失，不等 HTTP 往返；
       // 持久化走 fire-and-forget，失败也只是下次进来再写一次。
       // 用 pointerdown 而不是 click —— panellist 那一行的 click 归 DSH 的 selectPanel 处理，
       // pointerdown 只负责"标记已读"，不抢它的点击行为（事件照常冒泡）。
       const markSeen = () => {
-        if (settingsCache.value.entrySeen === true) return;
-        settingsCache = {
-          ...settingsCache,
-          value: { ...settingsCache.value, entrySeen: true },
-        };
-        emitSettings();
-        void saveSettings({ entrySeen: true }).catch(() => {});
+        // 两个红点原因各自熄各自的：不能因为 entrySeen 已是 true 就整段 early return，
+        // 否则「有新版本」那颗点永远清不掉。
+        if (updateHint) {
+          updateNotice = { ...updateNotice, seen: true };
+          emitUpdateNotice();
+        }
+        if (settingsCache.value.entrySeen !== true) {
+          settingsCache = {
+            ...settingsCache,
+            value: { ...settingsCache.value, entrySeen: true },
+          };
+          emitSettings();
+          void saveSettings({ entrySeen: true }).catch(() => {});
+        }
       };
       // 外层 span 只为了挂定位；DSH 的 panellist 容器不裁子元素
+      // 有新版 → 「新版本！」胶囊（品牌色实心，压在图标右上、落在入口文字上方）；
+      // 否则若没点开过 → 原来那颗未读红点。两者不同时出现。
       return jsx.jsxs("span", {
-        className: "balance-panel-icon balance-panel-icon--unread",
+        className:
+          "balance-panel-icon" + (unread ? " balance-panel-icon--unread" : ""),
         onPointerDown: markSeen,
-        children: [svg, jsx.jsx("span", { className: "balance-panel-icon__dot", "aria-hidden": "true" })],
+        children: [
+          svg,
+          unread
+            ? jsx.jsx("span", { className: "balance-panel-icon__dot", "aria-hidden": "true" })
+            : null,
+          updateHint
+            ? jsx.jsx("span", { className: "balance-panel-icon__new", children: "新版本！" })
+            : null,
+        ],
       });
     }
 
@@ -2350,6 +2461,12 @@ function UsageCostLine({ useProjection, sessionId }) {
         if (settings.entrySeen !== true) {
           void saveSettings({ entrySeen: true }).catch(() => {});
         }
+        // 打开面板就能看到顶部的「版本与更新」区块，所以新版本红点到此为止。
+        // seen 只存在内存里（不写盘）：下次启动重新检查，真有新版会再亮。
+        if (updateNotice.latest !== "" && updateNotice.seen !== true) {
+          updateNotice = { ...updateNotice, seen: true };
+          emitUpdateNotice();
+        }
       }, [settings.entrySeen]);
       return jsx.jsxs("div", {
         className: "balance-panel-page",
@@ -2384,6 +2501,14 @@ function UsageCostLine({ useProjection, sessionId }) {
       const [draft, setDraft] = react.useState(null);
       const [saving, setSaving] = react.useState(false);
       const [status, setStatus] = react.useState({ kind: "", text: "" });
+      // 版本与更新的状态机：
+      //   idle       — 没查过
+      //   checking   — 正在问 npm
+      //   ok         — 查到了；newer 表示有没有新版
+      //   installing — 正在下载并覆盖本机安装
+      //   installed  — 覆盖完成，等重启
+      //   error      — 查询或更新失败
+      const [updateCheck, setUpdateCheck] = react.useState({ kind: "idle" });
 
       // 拿到设置后灌一次草稿；draft 已有内容就不再覆盖，避免打断正在输入的用户
       react.useEffect(() => {
@@ -2423,6 +2548,23 @@ function UsageCostLine({ useProjection, sessionId }) {
           if (payload) commit(payload);
         }, 350);
       };
+      // 关掉侧边栏入口时的提醒弹窗。这一项一关，本设置页就没有常驻入口了，
+      // 所以必须当场告诉用户以后怎么回来（侧边栏 -> 插件 -> balance-dsh）。
+      const [sidebarTip, setSidebarTip] = react.useState(false);
+      // 弹窗用 DSH 官方的 Modal（primitives.Modal）—— Esc / 点遮罩 / 焦点管理都由它负责，
+      // 我们只给标题、正文和底部按钮。取不到时退化成纯文字按钮，绝不自己画遮罩。
+      const tipModal = primitives && typeof primitives.Modal === "function" ? primitives.Modal : null;
+      const tipButton = primitives && typeof primitives.Button === "function" ? primitives.Button : null;
+      const tipClose = () => setSidebarTip(false);
+      const tipFooter = tipButton
+        ? jsx.jsx(tipButton, { variant: "primary", onClick: tipClose, children: "知道了" })
+        : jsx.jsx("button", {
+            type: "button",
+            className: "balance-tip-ok",
+            onClick: tipClose,
+            children: "知道了",
+          });
+
       const patch = (key, next) => {
         const merged = { ...valueRef.current, [key]: next };
         setDraft(merged);
@@ -2433,6 +2575,95 @@ function UsageCostLine({ useProjection, sessionId }) {
         setDraft(next);
         queueSave(next);
       };
+      // 检查更新：只查版本号，不动任何文件。
+      const onCheckUpdate = () => {
+        if (updateCheck.kind === "checking" || updateCheck.kind === "installing") return;
+        setUpdateCheck({ kind: "checking" });
+        void fetchUpdateInfo()
+          .then((info) => {
+            if (info.ok !== true) {
+              setUpdateCheck({ kind: "error", error: info.error });
+              return;
+            }
+            setUpdateCheck({ kind: "ok", newer: info.newer, latest: info.latest, current: info.current });
+          })
+          .catch((error) => {
+            setUpdateCheck({ kind: "error", error: error instanceof Error ? error.message : String(error) });
+          });
+      };
+
+      // 更新入口（用户要求：「检查到新版本时不要直接下载，要提醒用户是否下载」
+      // + 「不是弹窗，是在检查更新那个位置变成『检测到新版本，是否更新』（更新）」）。
+      // 所以只有一层：查到新版后同一块区域直接问「是否更新？」，旁边的按钮就叫「更新」，
+      // 点了才下载。不弹窗、不再多点一次确认。
+      const onDoInstall = () => {
+        if (updateCheck.kind === "checking" || updateCheck.kind === "installing") return;
+        setUpdateCheck({ kind: "installing", latest: updateCheck.latest });
+        void fetch("/balance-api?update=1", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: "{}",
+        })
+          .then((res) => {
+            if (!res || !res.ok) throw new Error("HTTP " + (res ? res.status : "?"));
+            return res.json();
+          })
+          .then((data) => {
+            if (!data || data.ok !== true) {
+              setUpdateCheck({ kind: "error", error: (data && data.error) || "更新失败" });
+              return;
+            }
+            // registry 上刚好被撤掉 / 本地已经是这个版本：服务端会回 installed:false
+            if (data.installed === false) {
+              setUpdateCheck({ kind: "ok", newer: false, latest: data.to || "", current: data.from || "" });
+              return;
+            }
+            setUpdateCheck({
+              kind: "installed",
+              to: data.to || "",
+              failed: Array.isArray(data.failed) ? data.failed : [],
+            });
+          })
+          .catch((error) => {
+            setUpdateCheck({ kind: "error", error: error instanceof Error ? error.message : String(error) });
+          });
+      };
+
+      const updateBusy = updateCheck.kind === "checking" || updateCheck.kind === "installing";
+      // 一行说明文字：四种状态各说一句，idle 也给一句提示（区块默认就可见，不留空白）
+      // 标题行左侧的一句话状态。「已是最新版本」这种短状态放这里（不再单独占一行），
+      // 长文案（有新版本时的覆盖/备份/重启说明）仍走下面的 updateNote。
+      const updateInline = (() => {
+        if (updateCheck.kind === "ok" && !updateCheck.newer) return "已是最新版本。";
+        return "";
+      })();
+
+      // 查询中的进度文案走右侧（按钮左边），不占下面那一行 ——
+      // 用户要求「这个查询也放在右边」。它短，跟按钮排一行正好。
+      const updateBusyNote =
+        updateCheck.kind === "checking" ? "正在查询 npm registry…" : "";
+
+      const updateNote = (() => {
+        if (updateCheck.kind === "installing") return "正在下载并替换本机安装文件，请稍候…";
+        if (updateCheck.kind === "installed") {
+          const failed = updateCheck.failed || [];
+          if (failed.length > 0) {
+            return "已更新到 " + updateCheck.to + "，但有 " + failed.length + " 个文件没覆盖成功（" + failed.join("；") + "）。重启后如仍异常，请先从插件市场重装。";
+          }
+          return "已更新到 " + updateCheck.to + "，重启 DeepSeek Harness 后生效。";
+        }
+        if (updateCheck.kind === "error") return "检查失败：" + updateCheck.error + "（可稍后重试）";
+        if (updateCheck.kind === "ok") {
+          // 「已是最新版本」不在这里出 —— 它走 updateInline，显示在标题行左侧。
+          if (!updateCheck.newer) return "";
+          return "检测到新版本 " + updateCheck.latest
+            + "（当前 " + (updateCheck.current || settingsCache.version || "—") + "），是否更新？"
+            + "更新会覆盖本机插件文件（旧文件先备份到 ~/.dsh/balance-update-backup/），"
+            + "完成后需重启 DeepSeek Harness 生效。";
+        }
+        // 初始态不写任何引导文案（用户要求：这行小字删掉）。
+        return "";
+      })();
 
       // 插件列表里的单行摘要
       if (view === "summary") {
@@ -2536,7 +2767,14 @@ function UsageCostLine({ useProjection, sessionId }) {
           jsx.jsx("span", { className: "balance-settings__unit", children: unit, key: key + "-unit" }),
         ]);
 
-      const toggleRow = (key, label, hint) => row(key, label, hint, toggle(key, label));
+      // onToggle（可选）拿到的是「点完之后的新值」，用来在关掉某项时追加副作用
+      const toggleRow = (key, label, hint, onToggle) =>
+        row(
+          key,
+          label,
+          hint,
+          toggle(key, label, onToggle ? () => onToggle(value[key] !== true) : undefined),
+        );
 
       // 二选一分段控件：用于「余额行外观」这类互斥选项
       const choiceRow = (key, label, hint, options) => row(key, label, hint, jsx.jsx("div", {
@@ -2670,6 +2908,86 @@ function UsageCostLine({ useProjection, sessionId }) {
                   }),
                 ],
               }),
+              // 版本与更新：放在最前面（用户要"往上放一点"）。
+              // 检查、更新、结果说明都在这一块，底部只留保存状态与「恢复默认」。
+              jsx.jsxs("div", {
+                className:
+                  "balance-settings__update" +
+                  (updateCheck.kind === "error"
+                    ? " balance-settings__update--error"
+                    : updateCheck.kind === "installed"
+                      ? " balance-settings__update--done"
+                      : updateCheck.kind === "ok" && updateCheck.newer
+                        ? " balance-settings__update--newer"
+                        : ""),
+                children: [
+                  jsx.jsxs("div", {
+                    className: "balance-settings__update-head",
+                    children: [
+                      jsx.jsxs("div", {
+                        className: "balance-settings__update-title",
+                        children: [
+                          "版本 ",
+                          jsx.jsx("strong", {
+                            className: "balance-settings__update-ver",
+                            children: settingsCache.version || "—",
+                          }),
+                          updateCheck.kind === "ok" && updateCheck.newer
+                            ? jsx.jsx("span", {
+                                className: "balance-settings__update-badge",
+                                children: "新版 " + updateCheck.latest,
+                              })
+                            : null,
+                          updateInline
+                            ? jsx.jsx("span", {
+                                className: "balance-settings__update-inline",
+                                children: updateInline,
+                              })
+                            : null,
+                        ],
+                      }),
+                      jsx.jsxs("div", {
+                        className: "balance-settings__update-btns",
+                        children: [
+                          // 查询中的文案排在按钮左边（用户要求放在右边，别占下面那行）
+                          updateBusyNote
+                            ? jsx.jsx("span", {
+                                className: "balance-settings__update-busy",
+                                children: updateBusyNote,
+                              })
+                            : null,
+                          // 检查更新：进行中禁用并显示进度（checking / installing 共用这个位置）
+                          jsx.jsx("button", {
+                            type: "button",
+                            className: "balance-settings__btn",
+                            onClick: onCheckUpdate,
+                            disabled: updateBusy,
+                            children: updateCheck.kind === "checking"
+                              ? "检查中…"
+                              : updateCheck.kind === "installing"
+                                ? "更新中…"
+                                : "检查更新",
+                          }),
+                          // 「更新」只在检测到新版时出现，点它才真的下载 ——
+                          // 上面的说明文字已经把"是否更新"问出来了，这里就是那个「是」。
+                          updateCheck.kind === "ok" && updateCheck.newer
+                            ? jsx.jsx("button", {
+                                type: "button",
+                                className: "balance-settings__btn balance-settings__btn--primary",
+                                onClick: onDoInstall,
+                                children: "更新",
+                              })
+                            : null,
+                        ],
+                      }),
+                    ],
+                  }),
+                  updateNote
+                    ? jsx.jsx("div", { className: "balance-settings__update-note", children: updateNote })
+                    : null,
+                ],
+              }),
+
               group("balance", "余额", [
             numberRow("refreshIntervalSec", "余额刷新间隔", "轮询间隔；对话产生新消耗时也会顺带刷新。", 5, 3600, "秒"),
             numberRow("lowBalanceThreshold", "低余额警示阈值", "余额低于该值时金额转为琥珀色。", 0, 100000, "元"),
@@ -2691,7 +3009,15 @@ function UsageCostLine({ useProjection, sessionId }) {
               { value: "timeline", label: "新版" },
               { value: "classic", label: "旧版" },
             ]),
-            toggleRow("showSidebarEntry", "左侧导航栏入口", "在左侧导航栏底部（插件 / 自动化任务 那一组）加一个「余额与用量」入口，点开是本页。改这一项需刷新页面。"),
+            toggleRow(
+              "showSidebarEntry",
+              "侧边栏显示本插件",
+              "在左侧导航栏底部（插件 / 自动化任务 那一组）加一个「余额与用量」入口，点开是本页。关掉之后要再打开，走侧边栏「插件」→ balance-dsh。改这一项需刷新页面。",
+              (next) => {
+                patch("showSidebarEntry", next);
+                if (next === false) setSidebarTip(true);
+              },
+            ),
             // 这两项各只属于一种样式，按当前选择出现：
             //   浪潮 = 新版独有（旧版刷新走「刷新中…」文字，没有白条可关）
             //   时段标签 = 新版不可关闭（刻度条是新版的结构主体），只有旧版才允许收成纯金额
@@ -2738,6 +3064,23 @@ function UsageCostLine({ useProjection, sessionId }) {
           }),
             ],
           }) : null,
+
+          // 关掉侧边栏入口后的提醒：直接用 DSH 官方 Modal 渲染。
+          tipModal && sidebarTip
+            ? jsx.jsx(tipModal, {
+                open: true,
+                title: "已关闭侧边栏入口",
+                closeLabel: "关闭",
+                onClose: tipClose,
+                footer: tipFooter,
+                children: jsx.jsx("p", {
+                  className: "balance-tip-body",
+                  children:
+                    "之后想再打开，去侧边栏「插件」→ balance-dsh，就能回到这个设置页，"
+                    + "把「侧边栏显示本插件」重新打开。刷新页面后生效。",
+                }),
+              })
+            : null,
         ],
       });
     }
@@ -2778,19 +3121,62 @@ function UsageCostLine({ useProjection, sessionId }) {
       //                       slot 本体只负责画图标（wide 时尺寸 16，收起态 18）。
       //   点击后 DSH 调 layout.selectPanel(id)，主区域用 keyed slot "main" 按 activePanelId 取内容，
       //   所以再注册一个 key 同名的 main 条目就是点开后的页面。
-      // 关掉「左侧导航栏入口」就不注册；slot 注册无法在运行时撤销，所以这一项改动需刷新页面。
+      // 开关「侧边栏显示本插件」要**立刻**生效，不能等刷新：
+      //   拿到 disposer 就把它注销掉（整行消失），拿不到就退回组件内 return null（图标消失）。
+      //   注意别在 inject 回调里按当时的缓存值提前 return —— 那时 fetchSettingsOnce 还没回来，
+      //   settingsCache 永远是默认值 true，开关会看起来完全没反应。
       ctx.slots.inject("sidebar.panellist", () => {
-        if (settingsCache.value.showSidebarEntry === false) return;
-        return ctx.slots.register(
-          {
-            name: "sidebar.panellist",
-            id: "balance",
-            order: 30,
-            label: "余额与用量",
-          },
-          BalancePanelIcon,
-        );
+        let dispose = null;
+        let registered = false;
+        const syncEntry = () => {
+          const want = settingsCache.value.showSidebarEntry !== false;
+          if (want && !registered) {
+            const result = ctx.slots.register(
+              {
+                name: "sidebar.panellist",
+                id: "balance",
+                order: 30,
+                label: "余额与用量",
+              },
+              BalancePanelIcon,
+            );
+            registered = true;
+            dispose = typeof result === "function" ? result : null;
+            return;
+          }
+          if (!want && registered && dispose) {
+            try {
+              dispose();
+            } catch {
+              return;
+            }
+            registered = false;
+            dispose = null;
+          }
+        };
+        syncEntry();
+        settingsListeners.add(syncEntry);
+        return () => {
+          settingsListeners.delete(syncEntry);
+          if (dispose) {
+            try {
+              dispose();
+            } catch {
+              /* 释放失败不影响卸载 */
+            }
+            dispose = null;
+            registered = false;
+          }
+        };
       });
+      // 启动检查更新：等 UI 先跑起来再查（2.5s），别跟首屏抢网络。
+      // 每次页面加载 = 每次打开 DeepSeek Harness，符合「每次打开都检查一次」。
+      if (typeof window !== "undefined" && typeof window.setTimeout === "function") {
+        window.setTimeout(() => {
+          void checkUpdateOnStartup();
+        }, 2500);
+      }
+
       ctx.slots.inject("main", () =>
         ctx.slots.register(
           {

package/lib/index.js

@@ -345,7 +345,223 @@ function formatBalance(balance) {
 //                          | { status:"failed" }  （网络失败；官方明确“失败绝不变成 0 余额”）
 // client 是 AccountClientMetadata（version / locale / timezoneOffsetSeconds），
 // 缺字段会在平台侧组装请求头时抛错，所以三个字段都要给。
-const PLUGIN_VERSION = "2.0.0";
+const PLUGIN_VERSION = "2.0.2";
+
+// ─── 检查更新 ───────────────────────────────────────────────────────────────
+// 只查 npm registry 的 latest 标签（一个很小的 JSON），不下载任何东西。
+// 结果缓存 10 分钟：设置页的按钮连着点也不会把 registry 打爆。
+const UPDATE_CACHE_MS = 10 * 60 * 1000;
+const UPDATE_REGISTRY_URL = "https://registry.npmjs.org/balance-dsh/latest";
+let updateCache = { at: 0, value: null };
+
+/** 语义化版本比较：a > b 返回正、相等返回 0、a < b 返回负。
+ *  只比三段数字（忽略预发布后缀），够用来判断「npm 上的是不是比本地新」。 */
+function compareVersion(a, b) {
+  const parse = (v) =>
+    String(v ?? "")
+      .trim()
+      .replace(/^v/i, "")
+      .split("-")[0]
+      .split(".")
+      .map((x) => parseInt(x, 10) || 0);
+  const x = parse(a);
+  const y = parse(b);
+  for (let i = 0; i < Math.max(x.length, y.length); i += 1) {
+    const d = (x[i] ?? 0) - (y[i] ?? 0);
+    if (d !== 0) return d;
+  }
+  return 0;
+}
+
+/** 本插件的安装根目录（.../node_modules/balance-dsh），由 import.meta.url 反推。
+ *  定位不到返回空串（调用方报错，不动任何文件）。 */
+async function installedPluginDir() {
+  try {
+    const { fileURLToPath } = await import("node:url");
+    const { dirname } = await import("node:path");
+    // .../node_modules/balance-dsh/lib/index.js → 上两级就是包根
+    return dirname(dirname(fileURLToPath(import.meta.url)));
+  } catch {
+    return "";
+  }
+}
+
+/** 极简 tar.gz 解包：只取普通文件、去掉 npm 固定的 package/ 前缀，返回 [{ rel, data }]。
+ *  不处理符号链接（npm 包是禁掉 symlink 的）与 ustar 长文件名（本包路径都很短）。 */
+async function extractPackageFiles(gz) {
+  const { gunzipSync } = await import("node:zlib");
+  const tar = gunzipSync(gz);
+  const files = [];
+  let off = 0;
+  while (off + 512 <= tar.length) {
+    const header = tar.subarray(off, off + 512);
+    // 尾部是全零块，遇到就结束
+    let allZero = true;
+    for (let i = 0; i < 512; i += 1) {
+      if (header[i] !== 0) {
+        allZero = false;
+        break;
+      }
+    }
+    if (allZero) break;
+    const name = header.toString("utf8", 0, 100).replace(/\0.*$/, "");
+    const size = parseInt(header.toString("utf8", 124, 136).replace(/\0.*$/, "").trim(), 8) || 0;
+    const typeFlag = header.toString("utf8", 156, 157);
+    // "0" / "" / NUL = 普通文件；"5" = 目录，"2" = 符号链接，都跳过
+    const isFile = typeFlag === "0" || typeFlag === "" || typeFlag === "\0";
+    if (isFile && size > 0 && name !== "") {
+      const rel = name.startsWith("package/") ? name.slice("package/".length) : name;
+      if (rel !== "" && !rel.endsWith("/") && !rel.includes("..")) {
+        files.push({ rel, data: tar.subarray(off + 512, off + 512 + size) });
+      }
+    }
+    off += 512 + Math.ceil(size / 512) * 512;
+  }
+  return files;
+}
+
+/** tarball 地址（npm 的固定布局）。 */
+function updateTarballUrl(version) {
+  return "https://registry.npmjs.org/balance-dsh/-/balance-dsh-" + version + ".tgz";
+}
+
+/** 就地更新本插件：下载 npm 上的最新 tarball → 解包 → 逐文件覆盖自己的安装目录。
+ *
+ *  几个刻意的取舍：
+ *  - 只覆盖 tarball 里有的文件，不删任何东西。上游删掉的文件会残留，但残留无害，
+ *    比误删用户目录里的东西安全得多。
+ *  - 覆盖前把旧文件备份到 <dshHome>/balance-update-backup/<from>-<时间戳>/，可手工回滚。
+ *  - 逐个文件写、单个失败只记进 failed 不中断 —— 最典型的是 Windows 上 package.json
+ *    被 DSH 占着（之前同步时就踩过），但 lib/*.js 能写进去，功能不受影响。
+ *  - 覆盖后 lib/index.js 的改动**必须重启 DSH** 才生效：Node 不会热替换已加载的模块。
+ *    返回值里带 restart:true，让界面明确提示。
+ */
+async function installLatestVersion(ctx) {
+  const found = await fetchLatestVersion();
+  if (found.error) return { ok: false, error: found.error };
+  const latest = found.latest;
+  if (compareVersion(latest, PLUGIN_VERSION) <= 0) {
+    return { ok: true, installed: false, from: PLUGIN_VERSION, to: latest, note: "已是最新版本" };
+  }
+
+  const root = await installedPluginDir();
+  if (root === "") return { ok: false, error: "定位不到插件安装目录" };
+
+  let gz;
+  try {
+    const signal =
+      typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function"
+        ? AbortSignal.timeout(20000)
+        : undefined;
+    const res = await fetch(updateTarballUrl(latest), { signal });
+    if (!res || !res.ok) throw new Error("HTTP " + (res ? res.status : "?"));
+    gz = Buffer.from(await res.arrayBuffer());
+  } catch (error) {
+    return { ok: false, error: "下载 " + latest + " 失败：" + (error instanceof Error ? error.message : String(error)) };
+  }
+
+  let files;
+  try {
+    files = await extractPackageFiles(gz);
+  } catch (error) {
+    return { ok: false, error: "解包失败：" + (error instanceof Error ? error.message : String(error)) };
+  }
+  if (files.length === 0) return { ok: false, error: "下载到的包里没有文件" };
+
+  const { mkdir, writeFile, readFile, rename, unlink } = await import("node:fs/promises");
+  const { dirname, join, resolve, sep } = await import("node:path");
+
+  // 备份目录：拿不到 dshHome 就跳过备份（仍继续更新，失败项会体现在 failed 里）
+  const home = dshHomeDir(ctx);
+  const backupRoot =
+    home === "" ? "" : join(home, "balance-update-backup", PLUGIN_VERSION + "-" + Date.now());
+
+  const written = [];
+  const failed = [];
+  const rootAbs = resolve(root);
+  const rootPrefix = rootAbs.endsWith(sep) ? rootAbs : rootAbs + sep;
+
+  for (const file of files) {
+    const dst = resolve(rootAbs, file.rel);
+    // 防路径穿越：解析后必须仍在包目录里
+    if (!dst.startsWith(rootPrefix)) {
+      failed.push(file.rel + "（路径越界，已跳过）");
+      continue;
+    }
+    try {
+      if (backupRoot !== "") {
+        try {
+          const old = await readFile(dst);
+          const bak = join(backupRoot, file.rel);
+          await mkdir(dirname(bak), { recursive: true });
+          await writeFile(bak, old);
+        } catch {
+          // 旧文件不存在（新版本新增的文件）或不可读：没有可备份的，继续
+        }
+      }
+      await mkdir(dirname(dst), { recursive: true });
+      // 先写同目录临时文件再 rename：原子替换 + 断开硬链接（profile 里有些文件是
+      // pnpm 硬链接，直接 writeFile 会写进同一个 inode，可能污染 store / 其它 profile）。
+      const staging = dst + ".new-" + Date.now() + "-" + written.length;
+      try {
+        await writeFile(staging, file.data);
+        await rename(staging, dst);
+      } catch (error) {
+        try {
+          await unlink(staging);
+        } catch {
+          // 临时文件没建起来或已清理，忽略
+        }
+        throw error;
+      }
+      written.push(file.rel);
+    } catch (error) {
+      failed.push(file.rel + "：" + (error instanceof Error ? error.message : String(error)));
+    }
+  }
+
+  if (written.length === 0) {
+    return { ok: false, error: "没有文件写入成功：" + failed.join("；") };
+  }
+
+  // 缓存里的 latest 可能已经过时，更新完作废，下次检查重新问 registry
+  updateCache = { at: 0, value: null };
+
+  return {
+    ok: true,
+    installed: true,
+    from: PLUGIN_VERSION,
+    to: latest,
+    files: written.length,
+    failed,
+    backup: backupRoot,
+    restart: true,
+  };
+}
+
+/** 查 npm 上 balance-dsh 的最新版本。成功返回 { latest }，失败返回 { error }（失败不缓存，下次可重试）。 */
+async function fetchLatestVersion(force) {
+  const now = Date.now();
+  if (!force && updateCache.value && now - updateCache.at < UPDATE_CACHE_MS) return updateCache.value;
+  if (typeof fetch !== "function") return { error: "当前运行环境没有 fetch" };
+  try {
+    let signal;
+    if (typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function") {
+      signal = AbortSignal.timeout(8000);
+    }
+    const res = await fetch(UPDATE_REGISTRY_URL, { headers: { accept: "application/json" }, signal });
+    if (!res || !res.ok) throw new Error("registry 返回 HTTP " + (res ? res.status : "?"));
+    const data = await res.json();
+    const latest = data && typeof data.version === "string" ? data.version.trim() : "";
+    if (latest === "") throw new Error("registry 返回里没有 version 字段");
+    updateCache = { at: now, value: { latest } };
+    return updateCache.value;
+  } catch (error) {
+    // 超时 / 断网 / 被墙都走这里，只影响这个按钮，不影响余额与设置
+    return { error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 
 /**
  * 读取官方账号余额并归一化成与 normalizeBalance 相同的形状。
@@ -760,9 +976,9 @@ function withSettings(config, settings) {
   };
 }
 
-/** 设置文件路径：优先 DSH 自己的 home（dshHomePath 服务），再环境变量，最后 ~/.dsh。
- *  返回空串表示定位不到，此时读写一律静默降级为「用默认值、不落盘」。 */
-function settingsFilePath(ctx) {
+/** DSH 的 home 目录：优先 dshHomePath 服务，再环境变量，最后 ~/.dsh。
+ *  返回空串表示定位不到，此时设置读写与更新备份一律静默降级。 */
+function dshHomeDir(ctx) {
   let home = "";
   try {
     const svc = typeof ctx?.get === "function" ? ctx.get("dshHomePath") : null;
@@ -777,6 +993,12 @@ function settingsFilePath(ctx) {
     const base = process.env.USERPROFILE || process.env.HOME || "";
     if (base !== "") home = `${base}${process.platform === "win32" ? "\\" : "/"}.dsh`;
   }
+  return home;
+}
+
+/** 设置文件路径。返回空串表示定位不到，此时读写一律静默降级为「用默认值、不落盘」。 */
+function settingsFilePath(ctx) {
+  const home = dshHomeDir(ctx);
   if (home === "") return "";
   const sep = home.includes("\\") && !home.includes("/") ? "\\" : "/";
   return `${home.replace(/[\\/]+$/, "")}${sep}${SETTINGS_FILENAME}`;
@@ -1471,6 +1693,44 @@ export function apply(ctx, config = {}) {
           }
           return;
         }
+        // 检查更新 / 就地更新：同一个参数，GET 查询、POST 安装。
+        // 它排在下面那道 405 之前 —— 这是除了设置写入之外唯一放开 POST 的入口，
+        // 且只认 ?update=1（其余非 GET 仍然 405）。
+        let wantUpdate = false;
+        try {
+          wantUpdate = new URL(req.url, "http://localhost").searchParams.get("update") === "1";
+        } catch {
+          wantUpdate = false;
+        }
+        if (wantUpdate) {
+          if (req.method === "POST") {
+            // POST → 下载 npm 上最新 tarball 覆盖本机安装（见 installLatestVersion）。
+            // 下载 + 逐文件写盘期间 await 会让出事件循环，不会卡住余额请求。
+            try {
+              const result = await installLatestVersion(httpCtx);
+              writeJson(res, 200, { current: PLUGIN_VERSION, ...result });
+            } catch (error) {
+              writeJson(res, 200, {
+                ok: false,
+                current: PLUGIN_VERSION,
+                error: error instanceof Error ? error.message : String(error),
+              });
+            }
+            return;
+          }
+          if (req.method !== "GET") {
+            writeJson(res, 405, { ok: false, error: "method not allowed" });
+            return;
+          }
+          // force：用户手动点「检查更新」时不走 10 分钟缓存，否则刚更新过会显示旧结果
+          const found = await fetchLatestVersion(true);
+          if (found && found.error) {
+            writeJson(res, 200, { ok: false, current: PLUGIN_VERSION, error: found.error });
+          } else {
+            writeJson(res, 200, { ok: true, current: PLUGIN_VERSION, latest: found.latest });
+          }
+          return;
+        }
         if (req.method !== "GET") {
           writeJson(res, 405, { ok: false, error: "method not allowed" });
           return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balance-dsh",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "在 DeepSeek Harness 中显示 DeepSeek 账户余额和当前会话 token/费用消耗（含高峰/空闲峰谷计费）。仅支持 DeepSeek 官方模型与账号，暂不支持其他大模型。",
   "author": "Rannist",
   "type": "module",