dsh-ds-balance 3.2.1 → 3.2.2

package/README.md

@@ -96,7 +96,7 @@ The ring itself is "what is going on right now", five states you can tell apart
 | Arc length | The balance as a share of that currency's **warning threshold**, capped at a full circle |
 | Colour | State only (normal / low / critical), never the amount; the **critical threshold only sets the colour** and takes no part in drawing the ring |
 | The mark in the middle | **+** means not connected yet; go configure; **cross** means no usable number here — it could not be read, or it was read but the account cannot be used |
-| Hover text | The **amount** when the number is trustworthy, that state's own line otherwise; collapsed and expanded say the same sentence |
+| Hover text | The **amount** when the number is trustworthy, that state's own line otherwise; collapsed and expanded say the same sentence, and anywhere on the button shows it |
 | The source bracket | To the right of the popover title: which credential this number came from — a head-and-tail mask such as `sk-cf08d*****3b84`, or the signed-in account's name |
 | Data freshness | The "how long ago" in the popover, counted from the moment the data arrived |
 | Manual refresh | Cooldown applies; the cooldown restarts when the refresh finishes, and the seconds on the popover are the real ones left |

package/README_zh.md

@@ -96,7 +96,7 @@
 | 弧长 | 余额占该币种**预警线**的比例，满格封顶一整圈 |
 | 颜色 | 只表示状态（正常 / 偏低 / 告急），与金额大小无关；**告急线只决定颜色**，不参与画环 |
 | 中心记号 | **＋** 是还没接入，去配置；**叉**是这里没有可用的数字 —— 读不到，或者读到了但账户不能用 |
-| 悬停提示 | 数字可信时显示**金额**，其余情况显示这个状态自己的话；收起态与展开态说的是同一句 |
+| 悬停提示 | 数字可信时显示**金额**，其余情况显示这个状态自己的话；收起态与展开态说的是同一句，且停在按钮的任意位置都会显示 |
 | 来源括号 | 浮层标题右侧：这份数字用的是**哪一份凭据** —— 首尾片段掩码如 `sk-cf08d*****3b84`，或已登录账号的名字 |
 | 数据新鲜度 | 浮层里的「多久之前」，从收到数据的时刻算起 |
 | 手动刷新 | 带冷却，冷却从刷完那一刻重新计时，浮层上的秒数就是真实剩余 |

package/lib/client.js

@@ -2189,8 +2189,7 @@ function PercentRing({
   state,
   marker = null,
   ratio = 1,
-  size = 18,
-  title
+  size = 18
 }) {
   const clamped = Number.isFinite(ratio) ? Math.min(1, Math.max(0, ratio)) : 1;
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
@@ -2204,7 +2203,6 @@ function PercentRing({
       "aria-hidden": "true",
       focusable: "false",
       children: [
-        title === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("title", { children: title }),
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("circle", { className: PercentRing_default.track, cx: CENTER, cy: CENTER, r: RADIUS }),
         state === "ongoing" ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("g", { className: PercentRing_default.spin, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
           "circle",
@@ -2557,14 +2555,14 @@ function SidebarBalance({
           state: ring.state,
           marker: ring.marker,
           ratio: ringRatio,
-          size: 24,
-          title: hoverText ?? void 0
+          size: 24
         }
       )
     }
   );
+  const hoverableTrigger = hoverText === null ? trigger : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_dsh_client_ui_primitives5.Tooltip, { label: hoverText, side: "right", delayMs: 500, disabled: open, children: trigger });
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { ref: rootRef, className: SidebarBalance_default.root, "data-mode": wide ? "wide" : "rail", tabIndex: -1, children: [
-    wide && hoverText !== null ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_dsh_client_ui_primitives5.Tooltip, { label: hoverText, side: "right", delayMs: 500, disabled: open, children: trigger }) : trigger,
+    hoverableTrigger,
     open ? (0, import_react_dom.createPortal)(
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
         BalancePopover,

package/lib/types/client/sidebar/PercentRing.d.ts

@@ -38,12 +38,14 @@ export interface PercentRingProps {
     ratio?: number;
     /** 渲染边长（px），默认 18。 */
     size?: number;
-    /** 可选的原生悬停提示，由 SVG 的 <title> 子元素承载。 */
-    title?: string;
 }
 /**
  * 渲染状态圆环。
- * @param props - 状态、边长与可选提示。
+ *
+ * **不带悬停提示**：提示挂在外面那条触发按钮上（`SidebarBalance` 的官方 `Tooltip`），
+ * 锚是整条按钮的命中区而不是这个 24px 图形 —— 环若自己挂 SVG 原生 `<title>`，
+ * 按钮边缘那圈有悬浮灰底却没有提示，同一块悬浮区内圈外圈不一致。
+ * @param props - 状态、记号、弧长比例与边长。
  * @returns 圆环 svg；自身 aria-hidden，语义名由调用方的 aria-label 提供。
  */
-export declare function PercentRing({ state, marker, ratio, size, title, }: PercentRingProps): JSX.Element;
+export declare function PercentRing({ state, marker, ratio, size, }: PercentRingProps): JSX.Element;

package/lib/types/client/situation.d.ts

@@ -128,8 +128,10 @@ export declare function familyOf(situation: Situation): SituationFamily;
  * 3. 收起态还多一个「DeepSeek 余额状态 」前缀，同一个处境两态文字不同。
  *
  * 收敛到一个返回值之后，两态**不可能**再分叉 —— 这是结构保证，不是靠两处对齐。
- * 交付通道仍分两条（收起态走 SVG 原生 `<title>`、展开态走官方 `Tooltip` 原语），
- * 但那是「怎么显示」的差别，与「说什么」无关。
+ * 交付通道也只有一条（两态都挂官方 `Tooltip` 原语、锚是整条触发按钮）：
+ * 文案一致还不够，**命中区**也得一致 —— 收起态从前挂 24px 的 SVG 原生 `<title>`，
+ * 而原生 title 的命中面就是那个 `<svg>`，于是按钮边缘那圈有悬浮灰底却不弹。
+ * 见 [决策记录](../../../.agents/notes/2026-11-14-hover-hit-area-is-the-button.md)。
  * @param shown - 实际展示的那条余额；`null` 表示没有数字。
  * @param stateText - 处境的文案；`null` 表示这个处境没什么要说的（数字可信）。
  * @returns 悬停要显示的那一句；`null` 表示两态都不挂悬停。

package/lib/version.d.ts

@@ -8,5 +8,5 @@
 /** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
 export declare const SCHEMA_VERSION = 1;
 /** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
-export declare const PLUGIN_VERSION = "3.2.1";
+export declare const PLUGIN_VERSION = "3.2.2";
 //# sourceMappingURL=version.d.ts.map

package/lib/version.js

@@ -8,5 +8,5 @@
 /** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
 export const SCHEMA_VERSION = 1;
 /** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
-export const PLUGIN_VERSION = '3.2.1';
+export const PLUGIN_VERSION = '3.2.2';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ds-balance",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "icon": "./icon.svg",
   "description": "DSH plugin: shows the DeepSeek account balance at the bottom of the sidebar, with a configuration card on the Plugins page.",
   "keywords": [