dsh-desktop-statusbar 2.2.0 → 2.2.2

package/README.en.md

@@ -38,7 +38,7 @@ Replaces the stats line under the message input in the DSH desktop app with a co
   | Session cost | Cumulative token breakdown for this session |
   | Balance | Top-up balance / granted balance / quota left |
 
-- **Session data drill-down**: context compactions mark the node they happened at, skills injected counts the skills injected in this session, and tool calls list every tool the session used by count; click the title to go back up
+- **Session data drill-down**: context compactions mark the node they happened at, skills injected counts the skills injected in this session, and tool calls list every tool the session used with its call count; click the title to go back up
 - **Version check and update**: DSH checks for the latest version on startup, shows a hint next to the "Status bar" nav item when one is available, and offers a one-click update button in settings
 - **GitHub support**: your support is the biggest motivation for the developer to keep going! Click the button to open the GitHub project page and help with a star — thanks, everyone!
 - **Cost estimation**: priced with the official peak/off-peak rules; each call is computed from the moment it happened and the model it used
@@ -73,6 +73,18 @@ Both ways above install from the npm registry; the package name is `dsh-desktop-
 npm view dsh-desktop-statusbar version
 ```
 
+### When the built-in updater fails
+
+The one-click update button inside the plugin can fail on some desktop builds — it either does nothing or reports a failure. Do not keep clicking it. Use the official install entry instead and **append `@version` to the package name** to pin the exact version:
+
+```powershell
+dsh plugin --profile desktop add dsh-desktop-statusbar@2.2.2
+```
+
+The same string works in the plugin panel — type `dsh-desktop-statusbar@2.2.2` into the **Add plugin** field.
+
+Use whatever version you see (the version on the release page, or the output of the `npm view` command above). Pinning the version has a second benefit: **you get exactly the build you asked for**, with no chance of a stale cached package.
+
 Also listed on [dshmarket](https://awesome-dsh-plugin.com/p/raphael-y7/dsh-desktop-statusbar/), [dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) and [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar).
 
 ## Usage
@@ -98,6 +110,7 @@ Peak hours are **09:00–12:00 and 14:00–18:00 Beijing time, Monday to Friday*
 
 - Fastest / slowest TTFT and speed come from a new host-side projection: **you must fully quit and restart DSH** before it starts collecting
 - A model with no price is not billed; adding the price back-fills its earlier calls
+- One-click update relies on `pnpm`: the desktop app uses the copy bundled with the host, while CLI / web usage needs `pnpm` on the system. If neither is found, the update says so explicitly **and logs every location it tried**; you can also point it at a specific command with the `DSH_DESKTOP_STATUSBAR_PNPM` environment variable
 
 ## Development
 

package/README.md

@@ -38,7 +38,7 @@
   | 总计费用 | 当前会话的累计 token 明细 |
   | 余额 | 充值余额 / 赠金余额 / 剩余配额 |
 
-- **会话数据下钻**：上下文压缩逐次标注发生节点，技能注入统计当前会话注入的技能，工具调用按次数列出会话使用的所有工具；点击标题返回上一层
+- **会话数据下钻**：上下文压缩逐次标注发生节点，技能注入统计当前会话注入的技能，工具调用列出会话使用的所有工具与各自次数；点击标题返回上一层
 - **版本自检与更新**：DSH 启动时自动检测最新版本，发现新版时在「状态栏」导航项旁显示提示，并在设置页提供一键更新按钮
 - **费用估算**：按官方峰谷口径计价，每条调用按其发生时刻与所用模型分别计算
 - **价格库**：自定义单价、峰谷分档、CNY / USD 计价单位
@@ -73,6 +73,18 @@ dsh plugin --profile desktop add dsh-desktop-statusbar
 npm view dsh-desktop-statusbar version
 ```
 
+### 插件自带的更新失效时
+
+插件里那个一键更新按钮，在某些桌面端版本上会失败（点了没反应、或者直接显示失败）。这时不要反复点，改用官方安装入口、**在包名后面加上 `@版本号`** 指定到具体版本，就能精确装上：
+
+```powershell
+dsh plugin --profile desktop add dsh-desktop-statusbar@2.2.2
+```
+
+插件面板里同样可以这样填 —— 在「添加插件」的输入框里写 `dsh-desktop-statusbar@2.2.2`。
+
+版本号填你看到的最新版本即可（发布页右侧的版本号，或上面那条 `npm view` 命令的输出）。带上版本号还有一个好处：**装上的就是你想要的那一版**，不会因为缓存拿到旧包。
+
 本插件亦收录于 [dshmarket](https://awesome-dsh-plugin.com/p/raphael-y7/dsh-desktop-statusbar/)、[dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) 与 [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar)。
 
 ## 使用
@@ -98,7 +110,7 @@ npm view dsh-desktop-statusbar version
 
 - 最快 / 最慢首字与速度来自 host 新增的投影，**升级后需完全退出并重启 DSH** 才开始统计
 - 价格库中缺少单价的模型不计费，补充单价后自动补算
-- 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端用 PATH 上的 pnpm。两者都找不到时会明确提示「找不到 pnpm」，而不是静默失败
+- 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端需要系统里有 `pnpm`。都找不到时会明确提示「找不到 pnpm」，并把**尝试过的每个位置**一并写进日志；也可以用环境变量 `DSH_DESKTOP_STATUSBAR_PNPM` 直接指定要用的命令
 
 ## 开发
 

package/lib/balance-api.js

@@ -11,6 +11,26 @@
  *   { currency: 'CNY' | 'USD' | ..., total: '12.34', parts: [{ label, amount }] }
  * currency 缺失时由调用方按站点/域名推断；parts 用来填气泡里的构成行（充值 / 赠金等）。 */
 
+/* 积分套餐的上游数据上限（见下面 workbuddy 的 parse）。
+ * 名字长度限制的是下游 creditDisplayName 的前缀剥离开销（O(n²)）：实测 500KB 名字
+ * 会让浏览器主线程卡 18 秒。200 字符远大于任何真实包名（最长的也只有 16 字）。
+ * 条数限制的是渲染开销：这个列表在底栏的每秒重渲染路径上，没有 memo。 */
+const CREDITS_NAME_MAX = 200;
+const CREDITS_MAX_PACKAGES = 256;
+
+/**
+ * 字符串的短哈希（base36，约 6~7 位），O(n)、无依赖。
+ * 只用于给截断后的超长包名加一个「不同原名不会碰撞」的标记 —— 不是密码学哈希，
+ * 也不需要抗碰撞攻击：这里要防的是「两个正常上游数据被截成同名」，不是恶意构造。
+ */
+function nameHash(text) {
+  let hash = 5381;
+  for (let i = 0; i < text.length; i += 1) {
+    hash = ((hash * 33) ^ text.charCodeAt(i)) >>> 0;
+  }
+  return hash.toString(36);
+}
+
 const adapters = [
   {
     id: 'deepseek',
@@ -27,6 +47,9 @@ const adapters = [
       const infos = Array.isArray(data && data.balance_infos) ? data.balance_infos : [];
       if (infos.length === 0) return null;
       const one = infos[0];
+      /* 数组元素可能是 null（上游坏数据）：直接读 total_balance 会抛 TypeError，
+         整条余额就永久变横杠，所以先挡一道。 */
+      if (one === null || one === undefined || typeof one !== 'object') return null;
       const total = typeof one.total_balance === 'string' ? one.total_balance : null;
       if (total === null || total.length === 0) return null;
       const parts = [];
@@ -194,6 +217,9 @@ const adapters = [
       let percent = null;
       for (let i = 0; i < limits.length; i += 1) {
         const one = limits[i];
+        /* 数组里可能是 null（上游坏数据）：直接读 one.type 会抛 TypeError，
+           整条余额就永久变横杠了，所以先挡一道。 */
+        if (one === null || one === undefined || typeof one !== 'object') continue;
         const kind = typeof one.type === 'string' ? one.type.toUpperCase() : '';
         if (kind !== 'TOKENS_LIMIT' && kind !== 'CREDIT_LIMIT') continue;
         const value = Number(one.percentage);
@@ -249,7 +275,11 @@ const adapters = [
       const packages = Array.isArray(credits.packages) ? credits.packages : null;
       if (packages === null) return out;
       const rewards = [];
-      for (let i = 0; i < packages.length; i += 1) {
+      /* 条数上限：上游返回多少条不由我们决定，而列表渲染在底栏的每秒重渲染路径上
+         （无 memo），几万条会把界面拖死（实测 10 万条 ≈ 0.7 秒/帧）。
+         真实账号最多二三十个包，256 足够宽松，超出的直接忽略。 */
+      const count = Math.min(packages.length, CREDITS_MAX_PACKAGES);
+      for (let i = 0; i < count; i += 1) {
         const one = packages[i];
         if (one === null || one === undefined || typeof one !== 'object') continue;
         const size = Number(one.size);
@@ -257,8 +287,20 @@ const adapters = [
         /* size/remain 缺一个就没法算「已用/总量」：跳过这个包，
            不让一条坏数据把整条气泡弄崩（旧插件/上游漂移都可能缺字段）。 */
         if (Number.isFinite(size) !== true || Number.isFinite(remain) !== true || size < 0) continue;
-        const name = typeof one.packageName === 'string' ? one.packageName : '';
-        if (name.length === 0) continue;
+        const rawName = typeof one.packageName === 'string' ? one.packageName : '';
+        if (rawName.length === 0) continue;
+        /* 包名长度上限：上游是一条外部 API 响应，名字多长不由我们决定。
+           下游 creditDisplayName 要按前缀反复剥，超长名字是 O(n²)（实测 500KB 名字
+           能让浏览器主线程卡 18 秒）；标签行也放不下。200 字符足够覆盖任何真实包名
+           （最长的「CodeBuddy个人版国内运营裂变包」也只有 16 字）。
+           **截断必须保证不同原名不碰撞 + 保持截断开销 O(n)**：客户端会把「显示名相邻
+           且相同」的包合并成 ×N 一行，若两个前缀相同、后缀不同的超长包被截成同名，
+           就会被误合并、显示伪造的合计（防御代码自己制造错误数据）。
+           只用「原始长度」不够 —— 长度相同的两个不同名字照样碰撞，所以带上一段
+           由全文算出的短哈希。 */
+        const name = rawName.length > CREDITS_NAME_MAX
+          ? rawName.slice(0, CREDITS_NAME_MAX) + '…(' + rawName.length + ':' + nameHash(rawName) + ')'
+          : rawName;
         const monthly = one.monthly === true;
         rewards.push({
           name,

package/lib/client.js

@@ -74,7 +74,7 @@ window.__ModuleLoader__.load({
 		 */
 		const CONFIG_VERSION = 6;
 		/** 插件版本：显示在设置页底部，用来确认页面加载的是哪一版客户端代码。 */
-		const VERSION = "2.2.0";
+		const VERSION = "2.2.2";
 		/** 官方参考价的版本：官方调价时改这个数字，老价格库会自动并入新参考价。 */
 		const PRICE_VERSION = 2;
 		/** 项目主页：设置页那个「去 GitHub 点 star」按钮跳这里（与 package.json 的 repository 同址）。 */
@@ -2388,13 +2388,19 @@ window.__ModuleLoader__.load({
 		}
 
 		/**
-		 * 纯文字提示在「可用区间比文字还窄」时的缩放比例（用户拍板：**特例才缩，一般情况不缩**）。
+		 * 纯文字提示能不能完整放进「可用区间」（用户拍板：**放不下就不显示，绝不缩小**）。
+		 *
+		 * 历史：以前放不下时会等比缩小到放得下（下限 0.5）。后来用户明确要求
+		 * 「工具名很长而气泡不够长时，所有悬停提示一律不出现」，缩小这条路就没意义了 ——
+		 * 缩到 5.5px 的文字本来就是不可读的，不如整组不显示。所以这里只回答「放得下吗」，
+		 * 不再算缩放比例。
+		 *
 		 * 可用区间 = plainBoundsOf 给的 min~max（再与视口夹）；没有 bounds 就退回视口两侧各留 8px。
-		 * 返回 1 = 不缩放；< 1 = 需要等比缩小。
-		 * 下限 0.5：11px 缩到 5.5px 已经是能辨认的极限，再小不如不显示。
+		 * 拿不到可用宽度（无 bounds 且无视口 / 区间为负）时返回 true：
+		 * 量不出来就别关，宁可显示也不误伤。
 		 */
-		function plainFitScale(textWidth, bounds, viewportWidth) {
-			if (typeof textWidth !== "number" || Number.isFinite(textWidth) !== true || textWidth <= 0) return 1;
+		function plainFits(textWidth, bounds, viewportWidth) {
+			if (typeof textWidth !== "number" || Number.isFinite(textWidth) !== true || textWidth <= 0) return true;
 			const viewport = typeof viewportWidth === "number" && viewportWidth > 0 ? viewportWidth : 0;
 			let min = 8;
 			let max = viewport > 0 ? viewport - 8 : null;
@@ -2402,12 +2408,11 @@ window.__ModuleLoader__.load({
 				min = Math.max(min, bounds.min);
 				if (max === null || bounds.max < max) max = bounds.max;
 			}
-			if (max === null) return 1;
+			if (max === null) return true;
 			const available = max - min;
-			/* 区间本身就是负的（标题右边界已经越过色条右边）：没有可用的横向空间，不缩也无处可放 */
-			if (available <= 0) return 1;
-			if (textWidth <= available) return 1;
-			return Math.max(0.5, available / textWidth);
+			/* 区间本身就是负的（标题右边界已经越过色条右边）：没有可用的横向空间，量不出结论 */
+			if (available <= 0) return true;
+			return textWidth <= available;
 		}
 
 		/**
@@ -2844,7 +2849,7 @@ window.__ModuleLoader__.load({
 							style: { width: one.width + "%", backgroundColor: one.color }
 						};
 						if (opened !== null && sub !== undefined && sub !== null && typeof sub.hover === "function"
-							&& one.name !== undefined) {
+							&& one.name !== undefined && sub.hoverSuppressed !== true) {
 							/* 用户拍板：不要气泡，只显示一行文字（工具名 + 占比），贴在鼠标上方最近处 */
 							segProps.onMouseEnter = (event) => sub.hover(event, {
 								plain: one.name + " " + one.percentText,
@@ -3232,6 +3237,46 @@ window.__ModuleLoader__.load({
 			return out.length === 0 ? name : out;
 		}
 
+		/* 裂变包的名字特征：同名包会聚合成「×N」一行、动辄十几条，排在中间会把正经套餐挤下去。
+		   只按名字里有没有这两个字判断，不查任何外部清单 —— 上游新增什么裂变包都不用改代码。 */
+		const CREDITS_SPLIT_KEYWORD = "裂变";
+
+		/**
+		 * 积分套餐的显示顺序（用户拍板，三档）：
+		 *   ① **每月固定刷新的套餐永远第一行** —— 月度包是天天要看的那个，位置不能漂；
+		 *   ② **裂变包永远最后** —— 它们会聚合成「×11」这种一行，放在中间太占位；
+		 *   ③ 其余按**过期时间先后**排，最先要过期的排最前 —— 快用完的用户得先看见。
+		 * 每一档内部同样按日期升序；**没有日期的排在同档有日期的之后**（不猜日期，也不让它插到前面）。
+		 * 日期取哪个字段跟着套餐性质走：月度包看「下期刷新」，一次性包看「到期」。
+		 * Array.prototype.sort 稳定，日期相同或都缺日期时保持上游原顺序，不会每次刷新跳来跳去。
+		 */
+		function creditsSortGroup(one) {
+			if (one.monthly === true) return 0;
+			if (String(one.name).indexOf(CREDITS_SPLIT_KEYWORD) !== -1) return 2;
+			return 1;
+		}
+
+		/** 排序用的日期：月度包取刷新日、其余取到期日；都没有给空串（排在有日期的之后）。 */
+		function creditsSortDate(one) {
+			const value = one.monthly === true ? one.refreshAt : one.expireAt;
+			return typeof value === "string" && value.length > 0 ? value : "";
+		}
+
+		function creditsSort(rows) {
+			return rows.slice().sort((a, b) => {
+				const groupA = creditsSortGroup(a);
+				const groupB = creditsSortGroup(b);
+				if (groupA !== groupB) return groupA - groupB;
+				const dateA = creditsSortDate(a);
+				const dateB = creditsSortDate(b);
+				if (dateA === dateB) return 0;
+				/* 空串（没有日期）恒排在最后 */
+				if (dateA.length === 0) return 1;
+				if (dateB.length === 0) return -1;
+				return dateA < dateB ? -1 : 1;
+			});
+		}
+
 		/** 两个 ISO 日期里取更早的那个（null 不参与）；合并相邻同名包时「只显示最近到期日」。 */
 		function earliestDate(a, b) {
 			if (a === null || a === undefined) return b === undefined ? null : b;
@@ -3243,8 +3288,9 @@ window.__ModuleLoader__.load({
 		 * 积分套餐面板数据：`{ title, totalText, rewards[] }`。
 		 * 每个套餐带上显示用字段（label / valueText / percent），渲染函数只负责画。
 		 * **相邻且显示名相同**的套餐合并成一行：used/total 相加、percent 按合计重算、count 记原条数；
-		 * 日期只取最近的一个（monthly 取最早 refreshAt，否则取最早 expireAt），不显示区间；
-		 * 顺序按首次出现位置。字段缺失（name 不是非空字符串）的套餐直接跳过。
+		 * 日期只取最近的一个（monthly 取最早 refreshAt，否则取最早 expireAt），不显示区间。
+		 * 顺序：合并完再交给 `creditsSort` 排三档（月度置顶 / 其余按到期升序 / 裂变包置底）。
+		 * 字段缺失（name 不是非空字符串）的套餐直接跳过。
 		 * percent = clamp(used / total × 100, 0, 100)，total<=0 时给 0（画空轨道）。
 		 */
 		function creditsView(rewards, totalText, t) {
@@ -3287,7 +3333,9 @@ window.__ModuleLoader__.load({
 					expireAt: expireAt, refreshAt: refreshAt, monthly: monthly, items: [item]
 				});
 			});
-			const rows = merged.map((one) => {
+			/* 顺序：**先按原顺序聚合相邻同名包，最后再整体排序** —— 不能先排序，
+			   排序会把这 11 个裂变包按日期打散，聚合就失效了（它们必须相邻才能并成一行）。 */
+			const rows = creditsSort(merged.map((one) => {
 				/* 该组剩余积分 = 总容量 - 已用（不小于 0）；下钻标题右侧显示它，随用量动态变化 */
 				const remaining = Math.max(0, one.total - one.used);
 				return {
@@ -3305,7 +3353,7 @@ window.__ModuleLoader__.load({
 					valueText: t("tipCreditsUsed", { used: formatCredits(one.used), total: formatCredits(one.total) }),
 					percent: one.total > 0 ? Math.max(0, Math.min(100, (one.used / one.total) * 100)) : 0
 				};
-			});
+			}));
 			return { title: t("tipCreditsTitle"), totalText: totalText, rewards: rows };
 		}
 
@@ -4115,7 +4163,14 @@ window.__ModuleLoader__.load({
 			/* box-sizing:border-box 必须留着：内联宽度要含 padding，否则面板右边缘会比对齐点偏出 22px */
 			".dsb-tip{position:fixed;box-sizing:border-box;padding:6px 10px;border-radius:var(--dsw-radius-lg,16px);background:var(--dsw-specific-menu,var(--dsw-alias-bg-layer-1,#1f1f1f));background:rgb(from var(--dsw-specific-menu,var(--dsw-alias-bg-layer-1,#1f1f1f)) r g b / .382);backdrop-filter:var(--dsw-menu-backdrop-filter,blur(40px) saturate(150%));-webkit-backdrop-filter:var(--dsw-menu-backdrop-filter,blur(40px) saturate(150%));box-shadow:0 0 0 .5px var(--dsw-alias-border-l1,rgba(127,127,127,.3));white-space:nowrap;z-index:40;pointer-events:auto}",
 			".dsb-sep{color:var(--dsw-alias-separator-primary);margin:0 6px}",
-			/* 设置页 */
+			/* 整块禁选（用户拍板）：底栏、底栏气泡、设置页按住鼠标拖动会刷出蓝色选中底，
+			   看着像出了 bug。这三处都是插件自己画的纯展示/操作界面，用户没有复制文字的需求；
+			   ::selection 一并写成透明 —— 只写 user-select:none 时，某些内核在
+			   "先按下再拖动"的路径上仍会画一层选中色。 */
+			".dsb-root,.dsb-tip,.dsb-settings,.dsb-hover-plain,.dsb-drag-card{user-select:none;-webkit-user-select:none}",
+			".dsb-root ::selection,.dsb-tip ::selection,.dsb-settings ::selection,.dsb-hover-plain::selection,.dsb-drag-card ::selection{background:transparent;color:inherit}",
+			/* 设置页里的输入框要能选中/编辑（改价格那几个 number 框）：单独放开 */
+			".dsb-settings input,.dsb-settings textarea{user-select:text;-webkit-user-select:text}",
 			/* 这里的 14px 是面板内所有文字的继承来源；挂到 body 的跟手浮层继承不到它，
 			   那边（.dsb-drag-card）自己写死了一份 —— 改这里要同步那边。 */
 			".dsb-settings{display:flex;flex-direction:column;gap:18px;font-size:14px}",
@@ -4761,14 +4816,13 @@ window.__ModuleLoader__.load({
 			const [hoverPos, setHoverPos] = react.useState(null);
 			/* 工具彩条段悬停的「无气泡纯文字」内容（工具名 + 占比）；有值时只渲染一行文字 */
 			const [hoverPlain, setHoverPlain] = react.useState(null);
+			/* 工具名悬停提示**整组开关**（用户拍板）：当前气泡放不下那行小字时置 true，
+			   此后所有工具名的悬停都不再挂 onMouseEnter。由气泡定位 effect 量出实际宽度后判定
+			   （见 plainFits）；换气泡 / 换子视图时由那条 effect 重新得出结论。 */
+			const [hoverPlainOff, setHoverPlainOff] = react.useState(false);
 			/* 纯文字提示的固定垂直位置（与气泡标题行文字居中对齐）：定位 effect 算好后存这里，
 			   段内左右移动时直接复用，保证「只左右移动、不上下移动」且不抖。 */
 			const hoverPlainTopRef = react.useRef(null);
-			/* 纯文字提示的**未缩放原始宽度**（px）：段内移动时按它算缩放比例。
-			   不能拿 getBoundingClientRect().width —— 那个节点此时已经带 `transform: scale(x)`，
-			   量到的是**缩放后**的视觉宽，再乘一次比例就会越缩越小、来回振荡（长 MCP 工具名
-			   + 窄窗时可见）。定位 effect 在还没写 transform 的那一帧量一次存这里。 */
-			const hoverPlainWidthRef = react.useRef(0);
 			/* 纯文字提示的水平夹取范围：左 = 「工具调用」标题右边界 + 1ch，右 = 色条右边界
 			   （再与视口右缘取小）。定位 effect 里算一次存这里，段内移动时复用。 */
 			const hoverPlainBoundsRef = react.useRef(null);
@@ -4833,25 +4887,13 @@ window.__ModuleLoader__.load({
 				if (node.style === undefined || node.style === null) return;
 				const size = node.getBoundingClientRect();
 				if (hoverPlain !== null) {
-					/* 纯文字提示：水平夹在「标题右边界 ~ 色条右边界」之间。
-					   区间放不下这段文字时（长 MCP 工具名 + 窄窗）**等比缩小到放得下**，
-					   一般情况 scale 就是 1、不做任何缩放。
-					   ⚠ 宽度必须用**未缩放**的原始宽，两个来源都行、但都不能含 transform：
-					     ① hoverPlainWidthRef（定位 effect 用 offsetWidth 存好的）；
-					     ② 现场量 node.offsetWidth（同样不含 transform）。
-					   绝不能用 getBoundingClientRect().width —— 此时节点可能已经带着
-					   transform: scale()，量到的是缩放后的视觉宽，再乘一次比例就会越缩越小。 */
+					/* 纯文字提示：水平夹在「标题右边界 ~ 色条右边界」之间（放不放得下已在定位 effect
+					   判过，能走到这里就说明放得下，不做任何缩放）。宽度用 offsetWidth（不含 transform）。 */
 					const layoutWidth = typeof node.offsetWidth === "number" && node.offsetWidth > 0
 						? node.offsetWidth
 						: size.width;
-					const natural = hoverPlainWidthRef.current > 0 ? hoverPlainWidthRef.current : layoutWidth;
-					const scale = plainFitScale(natural, hoverPlainBoundsRef.current, window.innerWidth);
-					const shown = scale === 1 ? natural : Math.round(natural * scale);
-					const left = clampPlainLeft(event.clientX - shown / 2, shown, hoverPlainBoundsRef.current, window.innerWidth);
+					const left = clampPlainLeft(event.clientX - layoutWidth / 2, layoutWidth, hoverPlainBoundsRef.current, window.innerWidth);
 					node.style.left = left + "px";
-					/* 缩放以左端为基准：left 已经按缩小后的宽度算好，transform 原点放左上角才对得上 */
-					node.style.transform = scale === 1 ? "" : "scale(" + scale + ")";
-					node.style.transformOrigin = scale === 1 ? "" : "left center";
 					/* 上下固定：沿用 title 行居中算出的 top */
 					if (hoverPlainTopRef.current !== null) node.style.top = hoverPlainTopRef.current + "px";
 				} else {
@@ -5143,7 +5185,8 @@ window.__ModuleLoader__.load({
 				   只升不降（回退会让行数在两档之间来回跳）；换字段 / 开子视图 / 返回时都重置回 3。
 				   到 12 行仍放不下就停在 12，横向滚动兜底（不再折行）。
 				   量的是 DOM 几何，测试替身里拿不到就一律当放得下（量测函数自己兜住）。 */
-				const nextRows = nextToolRows(toolRows, toolColumnsOverflow(node));
+				const overflow = toolColumnsOverflow(node);
+				const nextRows = nextToolRows(toolRows, overflow);
 				if (nextRows !== toolRows) setToolRows(nextRows);
 				const centered = anchor.left + anchor.width / 2 - width / 2;
 				/* 左右两条硬约束，任何气泡都适用，而且是**对齐**不是仅仅不越界：
@@ -5243,25 +5286,28 @@ window.__ModuleLoader__.load({
 						: panel.getBoundingClientRect();
 					const bounds = plainBoundsOf(titleBox, barBox, window.innerWidth);
 					hoverPlainBoundsRef.current = bounds;
-					/* 记下**未缩放**的原始宽度，段内移动时按它算比例（见 onHoverMove）。
-					   ⚠ 必须用 offsetWidth（布局宽度），**不能**用 getBoundingClientRect().width：
-					   后者含 transform。这条 effect 的依赖里有 hoverMouse（鼠标一动就变），
-					   所以它会重跑；重跑时节点上还留着上一帧写的 transform: scale(x)，
-					   用 getBoundingClientRect 量到的是缩放后的宽 → ref 被写小 → 下次更小
-					   → 悬停文字一路缩到 0.5 下限（实测自然宽 600 被写成 300）。
-					   offsetWidth 不受 transform 影响，重跑多少次都是自然宽。
-					   offsetWidth 是整数且老浏览器/替身里可能没有，取不到就退回 size.width。 */
+					/* 提示文字的自然宽度。用 offsetWidth（布局宽度）而不是
+					   getBoundingClientRect().width：后者含 transform，而这条 effect 的依赖里有
+					   hoverMouse（鼠标一动就重跑），量到缩放后的宽会越缩越小。 */
 					const layoutWidth = typeof node.offsetWidth === "number" && node.offsetWidth > 0
 						? node.offsetWidth
 						: size.width;
-					hoverPlainWidthRef.current = layoutWidth;
-					/* 区间放不下这段文字时缩小到放得下（一般情况 scale=1，不缩） */
-					const scale = plainFitScale(layoutWidth, bounds, window.innerWidth);
-					const shown = scale === 1 ? layoutWidth : Math.round(layoutWidth * scale);
+					/* 放不下就**整组不显示**（用户拍板）：工具名很长、气泡不够长时，
+					   这行小字会压到别的内容上或被裁掉。以前是等比缩小硬塞进去，
+					   现在改成关掉 —— 缩到 5.5px 本来就读不清，不如不显示。
+					   一旦这个气泡放不下，**所有**工具名的悬停提示都关（不是只关超长那个），
+					   否则只有一部分能弹，看起来更像故障。 */
+					if (plainFits(layoutWidth, bounds, window.innerWidth) !== true) {
+						if (hoverPlainOff !== true) setHoverPlainOff(true);
+						/* 内容也当场清掉：不留半行字孤零零挂在屏幕上 */
+						setHoverPlain(null);
+						setHoverPos(null);
+						return;
+					}
+					if (hoverPlainOff === true) setHoverPlainOff(false);
 					setHoverPos({
-						left: clampPlainLeft(one.x - shown / 2, shown, bounds, window.innerWidth),
-						top: Math.max(8, fixedTop),
-						scale: scale
+						left: clampPlainLeft(one.x - layoutWidth / 2, layoutWidth, bounds, window.innerWidth),
+						top: Math.max(8, fixedTop)
 					});
 					return;
 				}
@@ -5273,11 +5319,15 @@ window.__ModuleLoader__.load({
 				});
 			}, [hoverCard, hoverPlain, hoverMouse]);
 
-			/* 主气泡收起时顺手把悬停浮层也收掉，避免它孤零零留在屏幕上 */
+			/* 主气泡收起时顺手把悬停浮层也收掉，避免它孤零零留在屏幕上。
+			   `hoverPlainOff` 也必须在这里复位：它是「本气泡放不下所以整组不显示」的一次性结论，
+			   换气泡 / 关气泡后必须重新评估 —— 不复位的话，用户碰到一次长工具名之后，
+			   此后所有气泡的工具名悬停都会永久失效（2026-10 实测发现）。 */
 			react.useEffect(() => {
 				if (tipId === null) {
 					setHoverCard(null);
 					setHoverPos(null);
+					setHoverPlainOff(false);
 				}
 			}, [tipId]);
 
@@ -5399,6 +5449,11 @@ window.__ModuleLoader__.load({
 				setCreditSub(null);
 				/* 工具调用子视图的行数也回到默认 3：换字段 / 重开都重新量 */
 				setToolRows(LIST_ROWS_PER_COLUMN);
+				/* 悬停整组开关也必须复位（用户拍板的那条「放不下就全不显示」）。
+				   换字段时 tipId 是**直接切换**（"counts" → "cost"）、不经过 null，
+				   只靠 tipId === null 那条 effect 复位不到 —— 结果是：碰到一次长工具名后，
+				   点任何一个字段都会让本次会话的工具名悬停永久失效（2026-10 实测确认的死锁）。 */
+				setHoverPlainOff(false);
 				if (tipId === id) {
 					setTipId(null);
 					setTipPos(null);
@@ -5433,16 +5488,22 @@ window.__ModuleLoader__.load({
 				if (tip.kind === "bars") return weekBarsPanel(tip, t, tipPos, tipRef, onHover, { week: hoverWeek, bar: hoverBar });
 				return rowsPanel(tip, tipPos, tipRef, {
 					id: tipSub,
-					/* 打开 / 返回都把行数重置回 3：另一个子视图不该沿用上一条量出来的行数 */
+					/* 打开 / 返回都把行数重置回 3：另一个子视图不该沿用上一条量出来的行数。
+					   `hoverPlainOff` 同理必须复位：在工具子视图里碰到长工具名被关掉之后，
+					   点标题返回再进别的子视图，如果不复位，新视图的色条段也一律不挂悬停。 */
 					open: (index) => {
 						setToolRows(LIST_ROWS_PER_COLUMN);
+						setHoverPlainOff(false);
 						setTipSub(index);
 					},
 					back: () => {
 						setToolRows(LIST_ROWS_PER_COLUMN);
+						setHoverPlainOff(false);
 						setTipSub(null);
 					},
 					rowsPerColumn: toolRows,
+					/* 工具名悬停提示整组开关：这个气泡放不下那行小字时一律不挂（用户拍板） */
+					hoverSuppressed: hoverPlainOff,
 					/* 工具调用彩条每段的悬停浮层（工具名 + 占比）走同一套 onHover，与柱状图互不干扰；
 					   onHoverMove 只更新鼠标坐标，让浮层在同一个色段里跟着鼠标走而不闪断。 */
 					hover: onHover,
@@ -5483,17 +5544,11 @@ window.__ModuleLoader__.load({
 			});
 			/* 工具彩条悬停：**不要气泡**，只渲染一行文字（工具名 + 占比），贴在鼠标上方。
 			   字号 11px（比悬停浮层的 10px 大、比标题 12px 小），无背景/圆角/描边。
-			   极窄区间放不下时按 plainFitScale 等比缩小（transform 不动布局，left/top 照常）。 */
+			   放不下时整组不显示（见 plainFits），**不做缩放**，所以这里只给 left/top。 */
 			if (hoverPlain !== null) {
 				const hoverStyle = hoverPos === null
 					? undefined
-					: (hoverPos.scale === undefined || hoverPos.scale === 1
-						? { left: hoverPos.left + "px", top: hoverPos.top + "px" }
-						: {
-							left: hoverPos.left + "px", top: hoverPos.top + "px",
-							transform: "scale(" + hoverPos.scale + ")",
-							transformOrigin: "left center"
-						});
+					: { left: hoverPos.left + "px", top: hoverPos.top + "px" };
 				children.push(h("span", {
 					className: "dsb-hover-plain",
 					key: "__hoverplain",

package/lib/holiday.js

@@ -17,15 +17,46 @@ const NOTICE_DATE = /(?:(\d{4})年)?(?:(\d{1,2})月)?(\d{1,2})日/g
 const DAY_MS = 86400000
 /** 一段假期最长不会超过这个天数，防正则意外把超长区间展开 */
 const MAX_RANGE_DAYS = 40
+/** HTML 解析的体积上限（字符）：真实通知页 100~300KB，2MB 已经非常宽松。
+ *  超过就只看前 2MB —— 宁可解析不全，也不能让 host 主线程卡住（见 holidayHtmlToText）。 */
+const HOLIDAY_HTML_MAX = 2 * 1024 * 1024
 
-/** HTML → 纯文本：去脚本、样式与标签，解常见实体。 */
+/**
+ * 线性切掉成对标签里的整段内容（`<script ...>...</script>` 这类）。
+ * 用 indexOf 前进而不是懒惰量词：找不到闭合标签时直接放弃剩余部分，
+ * 复杂度严格 O(n)；`/<script[\s\S]*?<\/script>/gi` 在缺闭合时会从每个 `<` 往后扫到文末，
+ * 实测 40 万个未闭合 `<script>` 要 6 秒（卡死 host 事件循环）。
+ */
+function stripBlocks(text, tag) {
+  const open = '<' + tag
+  const close = '</' + tag
+  const lower = text.toLowerCase()
+  let out = ''
+  let at = 0
+  for (;;) {
+    const start = lower.indexOf(open, at)
+    if (start === -1) return out + text.slice(at)
+    out += text.slice(at, start)
+    const end = lower.indexOf(close, start)
+    if (end === -1) return out   /* 没有闭合：整段丢弃，不再往后扫 */
+    const gt = text.indexOf('>', end)
+    if (gt === -1) return out
+    at = gt + 1
+  }
+}
+
+/** HTML → 纯文本：去脚本、样式与标签，解常见实体。
+ *
+ * 这段处理的是**外部网页**（国务院通知），内容不受我们控制，所以两处做了防御：
+ *   ① 先按长度截断，避免超大文档把主线程占满；
+ *   ② `<[^<>]+>` 而不是 `<[^>]+>` —— 后者不排除 `<`，大量孤立 `<` 时会反复跨越大段文本，
+ *      实测 20 万字符要 12 秒。 */
 export function holidayHtmlToText(html) {
-  return String(html === null || html === undefined ? '' : html)
-    .replace(/<script[\s\S]*?<\/script>/gi, ' ')
-    .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+  const raw = String(html === null || html === undefined ? '' : html).slice(0, HOLIDAY_HTML_MAX)
+  return stripBlocks(stripBlocks(raw, 'script'), 'style')
     .replace(/<br\s*\/?>/gi, '\n')
     .replace(/<\/p>/gi, '\n')
-    .replace(/<[^>]+>/g, '')
+    .replace(/<[^<>]+>/g, '')
     .replace(/&nbsp;/g, ' ')
     .replace(/&amp;/g, '&')
     .replace(/&lt;/g, '<')
@@ -49,7 +80,9 @@ const pad = (n) => (n < 10 ? '0' + String(n) : String(n))
 export function parseHolidayNotice(text, year) {
   const days = new Set()
   const flat = String(text === null || text === undefined ? '' : text)
-    .replace(/<[^>]+>/g, ' ')
+    .slice(0, HOLIDAY_HTML_MAX)
+    /* `[^<>]` 而不是 `[^>]`：理由同 holidayHtmlToText —— 大量孤立 `<` 时会退化 */
+    .replace(/<[^<>]+>/g, ' ')
     .replace(/\s+/g, ' ')
   /* 只认含"放假"的句子；含"上班"的句子是调休上班日，不能算进空闲 */
   flat.split(/[。；;\n]/).forEach((sentence) => {

package/lib/index.js

@@ -1626,7 +1626,9 @@ async function queryBalance(ctx, force, provider, model) {
     }
     const data = await response.json()
     const infos = Array.isArray(data.balance_infos) ? data.balance_infos : []
-    const picked = infos.filter((info) => info.currency === 'CNY')[0] ?? infos[0]
+    /* 元素可能是 null（上游坏数据）：在 filter 回调里直接读 info.currency 会抛 TypeError */
+    const picked = infos.filter((info) => info !== null && typeof info === 'object' && info.currency === 'CNY')[0]
+      ?? infos.filter((info) => info !== null && typeof info === 'object')[0]
     if (picked === undefined) {
       const empty = { ok: false, at: now, reason: 'no-balance-info', source: found.source }
       logHost(ctx, 'balance: 响应里没有 balance_infos')
@@ -4077,6 +4079,9 @@ async function handleApi(req, res, ctx) {
           reason: last.reason === undefined ? null : last.reason,
           from: last.from === undefined ? null : last.from,
           to: last.to === undefined ? null : last.to,
+          /* 找不到 pnpm 时把「试过哪些路径」一并交给界面：排查这类问题时最费时间的就是
+             手工逐条 Test-Path，这里直接摊开。其它失败原因下是空数组。 */
+          tried: Array.isArray(last.tried) === true ? last.tried : [],
         },
       })
       return

package/lib/self-update.js

@@ -89,54 +89,237 @@ export function resolveSelfDir(moduleUrl) {
 }
 
 /**
- * 定位 pnpm 可执行文件。
+ * 取一个「可能是字符串」的注入值：类型不对时退回默认值。
+ * 传 `null` / 数字 / 对象都按「显式给了一个不可用的值」处理，不回退。
  *
- * 顺序：
- *   1. 环境变量 `DSH_DESKTOP_STATUSBAR_PNPM`：完整命令覆盖。可以是 JSON 数组
- *      （`["node","/path/pnpm.mjs"]`，用别的 node 跑打包的 pnpm 或包一层脚本时用），
- *      也可以是单个可执行文件路径。
- *   2. 宿主随包提供的 pnpm：从 `process.execPath` 推出 resources 目录。
- *      DSH 桌面端把 pnpm 放在 `resources/runtime/pnpm/bin/pnpm.mjs`，
- *      用 Electron 可执行文件加 `ELECTRON_RUN_AS_NODE=1` 启动即可当 node 用
- *      （官方插件管理器走的也是这条路）。
- *   3. PATH 上的 `pnpm`（web 端 / CLI 运行时常走这条）。
+ * @param {unknown} value 注入值
+ * @param {unknown} fallback 默认值
+ * @returns {string}
+ */
+function asText(value, fallback) {
+  if (value === undefined) return typeof fallback === 'string' ? fallback : ''
+  return typeof value === 'string' ? value : ''
+}
+
+/**
+ * 判断一段文本看起来是不是绝对路径。
  *
- * @returns {{command: string, args: string[], electron: boolean}|null}
+ * 不用 `node:path` 的 `isAbsolute()`：它按**当前进程**的平台判断，而这里允许测试
+ * 注入 `options.platform`，两者可能对不上。两种平台的写法都认：
+ * `C:\x`（盘符）、`\\server\share`（UNC）、`/x`（POSIX 根）。
+ *
+ * @param {string} text
+ * @returns {boolean}
+ */
+function looksAbsolutePath(text) {
+  return /^[A-Za-z]:[\\/]/.test(text)
+    || text.startsWith('\\\\')
+    || text.startsWith('/')
+}
+
+/**
+ * 去掉路径结尾的分隔符；盘符根（`C:\`）原样保留 —— 去掉会变成 `C:`。
+ *
+ * @param {string} text
+ * @returns {string}
+ */
+function trimTrailingSeparators(text) {
+  let out = text
+  while (out.length > 1 && /[\\/]$/.test(out) === true) {
+    if (/^[A-Za-z]:[\\/]$/.test(out) === true) break
+    out = out.slice(0, -1)
+  }
+  return out
+}
+
+/**
+ * 解析安装根下的 `resources` 目录。
+ *
+ * 优先级（与宿主自己的 `runtimeResources()` 取值顺序一致）：
+ *   1. 显式注入的 `resourcesPath`（测试用，也可以是调用方认定的权威值）；
+ *   2. `process.resourcesPath` —— Electron 打包版给的权威值，比推断更稳；
+ *   3. 由 `execPath` 推断：`dirname(execPath)/resources`（非 Electron 环境兜底）。
+ *
+ * @param {string} resourcesPath 已处理过默认值（可能是空字符串）
+ * @param {string} execPath 已处理过默认值（可能是空字符串）
+ * @returns {string|null} 推断不出来时返回 null
+ */
+function resolveResourcesDir(resourcesPath, execPath) {
+  if (resourcesPath.length > 0 && looksAbsolutePath(resourcesPath) === true) {
+    return trimTrailingSeparators(resourcesPath)
+  }
+  if (execPath.length > 0) return trimTrailingSeparators(join(dirname(execPath), 'resources'))
+  return null
+}
+
+/**
+ * 定位 pnpm，返回**结构化结果**（永不抛异常），把「试过哪些候选」一并带回。
+ *
+ * 只做定位，不执行任何外部命令。
+ *
+ * 候选顺序（命中即返回，逐个记进 `tried`）：
+ *   1. `DSH_DESKTOP_STATUSBAR_PNPM`：插件自己的覆盖口，优先级最高。可以是 JSON 数组
+ *      （`["node","/path/pnpm.mjs"]`，用别的 node 跑打包的 pnpm 时用），也可以是
+ *      单个可执行文件路径。**不检查文件是否存在** —— 用户显式指定的入口就该照办。
+ *   2. `DSH_DESKTOP_PNPM_ENTRY`：宿主自己的口径（宿主 `runtimeResources()` 在开发
+ *      模式下读它）。排在文件候选之前，宿主以后挪位置也不会失配。
+ *   3. 宿主随包提供的 pnpm，按 `resources` 目录拼出来，三条候选依次尝试：
+ *      - `runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs`：**当前宿主布局**。
+ *        优先用同一套运行时里的 node（`runtime/primary-runtime/dependencies/node/bin/node.exe`）
+ *        去跑它，不依赖 Electron 的 `ELECTRON_RUN_AS_NODE`；那套 node 不在时退回宿主可执行文件
+ *        （此时才需要 `ELECTRON_RUN_AS_NODE=1`）。
+ *      - `runtime/pnpm/bin/pnpm.mjs`：更旧的宿主布局，保留兼容。
+ *      - `app.asar.unpacked/dsh/node_modules/pnpm/bin/pnpm.mjs`：再旧的打包布局，保留兼容。
+ *
+ * 找不到时**不做 PATH 搜索**：Windows 上 PATH 里多半是 `pnpm.cmd`，spawn 它需要
+ * `shell: true`，等于把命令解释权交给 shell，风险面大于收益。真需要时请用户用
+ * `DSH_DESKTOP_STATUSBAR_PNPM` 直接指定（issue 里的绕过写法就是这么用的）。
+ *
+ * @param {{
+ *   env?: {[key: string]: string|undefined},
+ *   execPath?: string,
+ *   resourcesPath?: string,
+ *   exists?: (path: string) => boolean,
+ *   electron?: boolean,
+ *   platform?: string,
+ * }} [options] 全部可选；只有测试会传
+ * @returns {{
+ *   ok: boolean,
+ *   runner: {command: string, args: string[], electron: boolean}|null,
+ *   source: 'custom-env'|'host-env'|'primary-runtime'|'runtime-legacy'|'asar-unpacked'|null,
+ *   tried: Array<{source: string, path: string|null, note: string}>,
+ * }}
  */
-export function resolvePnpm() {
-  const explicit = process.env.DSH_DESKTOP_STATUSBAR_PNPM
-  if (typeof explicit === 'string' && explicit.trim().length > 0) {
-    const text = explicit.trim()
-    if (text.startsWith('[')) {
+export function resolvePnpmDetailed(options) {
+  const opts = options === null || typeof options !== 'object' ? {} : options
+  /** 环境变量来源；默认 process.env。 */
+  const env = opts.env === undefined ? process.env : (opts.env === null ? {} : opts.env)
+  /** 宿主可执行文件；空字符串表示「拿不到」。 */
+  const execPath = asText(opts.execPath, process.execPath)
+  /** 注入的 resources 目录；未传时才回落到 process.resourcesPath。 */
+  const resourcesPath = asText(opts.resourcesPath, process.resourcesPath)
+  /** 是否跑在 Electron 里 —— 只有退回宿主可执行文件当 node 用时才需要它。 */
+  const electron = opts.electron === undefined
+    ? (typeof process.versions === 'object'
+      && process.versions !== null
+      && typeof process.versions.electron === 'string'
+      && process.versions.electron.length > 0)
+    : opts.electron === true
+  /** 平台；只用来决定同套运行时里的 node 叫 node.exe 还是 node。 */
+  const platform = asText(opts.platform, process.platform)
+
+  /** 每次尝试的记录：命中的也记，失败时一并带回给调用方写日志。 */
+  const tried = []
+  /** 记一条命中并直接返回成功结果。 */
+  const hit = (source, runner, path) => {
+    tried.push({ source, path: typeof path === 'string' ? path : null, note: '命中' })
+    return { ok: true, runner, source, tried }
+  }
+  /** 记一条未命中，继续试下一个候选。 */
+  const miss = (source, path, note) => {
+    tried.push({ source, path: typeof path === 'string' ? path : null, note })
+  }
+  /** 全部落空。 */
+  const fail = () => ({ ok: false, runner: null, source: null, tried })
+  /** 文件存在性检查；注入的实现抛错也当成「不存在」，保证本函数永不抛。 */
+  const exists = (target) => {
+    if (typeof opts.exists === 'function') {
+      try { return opts.exists(target) === true } catch (error) { return false }
+    }
+    try { return existsSync(target) === true } catch (error) { return false }
+  }
+
+  /* 1) 插件自己的覆盖口：完全不检查文件是否存在（用户显式指定的入口） */
+  const custom = asText(env.DSH_DESKTOP_STATUSBAR_PNPM, '')
+  if (custom.trim().length > 0) {
+    const text = custom.trim()
+    if (text.startsWith('[') === true) {
+      let parsed = null
       try {
-        const parsed = JSON.parse(text)
-        if (Array.isArray(parsed) === true && parsed.length > 0 && parsed.every((one) => typeof one === 'string')) {
-          return { command: parsed[0], args: parsed.slice(1), electron: false }
+        const value = JSON.parse(text)
+        if (Array.isArray(value) === true && value.length > 0 && value.every((one) => typeof one === 'string') === true) {
+          parsed = value
         }
       } catch (error) {
-        /* 不是合法数组就当单路径处理 */
+        /* 不是合法数组，落到下面的单路径处理 */
       }
+      if (parsed !== null) {
+        return hit('custom-env', { command: parsed[0], args: parsed.slice(1), electron: false }, custom)
+      }
+      /* `'[]'` 也走这里：空数组不够当命令用，退化成单路径（保持旧行为） */
+      miss('custom-env', custom, '不是合法 JSON 数组，按单路径处理')
     }
-    return { command: text, args: [], electron: false }
+    return hit('custom-env', { command: text, args: [], electron: false }, custom)
   }
 
-  const execPath = process.execPath
-  if (typeof execPath === 'string' && execPath.length > 0) {
-    const resources = join(dirname(execPath), 'resources')
-    const candidates = [
-      join(resources, 'runtime', 'pnpm', 'bin', 'pnpm.mjs'),
-      join(resources, 'app.asar.unpacked', 'dsh', 'node_modules', 'pnpm', 'bin', 'pnpm.mjs'),
-    ]
-    for (const candidate of candidates) {
-      try {
-        if (existsSync(candidate)) return { command: execPath, args: [candidate], electron: true }
-      } catch (error) {
-        /* 试下一个 */
-      }
+  /* 2) 宿主自己的口径：只存在于开发模式，但插件照样优先认它 */
+  const hostEntry = asText(env.DSH_DESKTOP_PNPM_ENTRY, '')
+  if (hostEntry.trim().length > 0) {
+    const entry = hostEntry.trim()
+    if (execPath.length === 0) {
+      miss('host-env', hostEntry, '没有可用的宿主可执行文件')
+    } else if (exists(entry) === true) {
+      /* tried.path 记变量原值（契约口径），实际执行用去掉首尾空白的路径 */
+      return hit('host-env', { command: execPath, args: [entry], electron }, hostEntry)
+    } else {
+      miss('host-env', hostEntry, '不存在')
     }
   }
 
-  return null
+  /* 3) 按 resources 目录拼出来的文件候选 */
+  const resources = resolveResourcesDir(resourcesPath, execPath)
+  if (resources === null) {
+    miss('primary-runtime', null, '无法推断 resources 目录')
+    return fail()
+  }
+
+  /* 3.1 当前宿主布局：优先用同一套运行时里的 node，不碰 ELECTRON_RUN_AS_NODE */
+  const primaryPnpm = join(resources, 'runtime', 'primary-runtime', 'dependencies', 'pnpm', 'bin', 'pnpm.mjs')
+  if (exists(primaryPnpm) === true) {
+    const primaryNode = join(resources, 'runtime', 'primary-runtime', 'dependencies', 'node', 'bin', platform === 'win32' ? 'node.exe' : 'node')
+    if (exists(primaryNode) === true) {
+      return hit('primary-runtime', { command: primaryNode, args: [primaryPnpm], electron: false }, primaryPnpm)
+    }
+    if (execPath.length > 0) {
+      return hit('primary-runtime', { command: execPath, args: [primaryPnpm], electron }, primaryPnpm)
+    }
+    miss('primary-runtime', primaryPnpm, '找到 pnpm，但同套运行时里的 node 与宿主可执行文件都不可用')
+  } else {
+    miss('primary-runtime', primaryPnpm, '不存在')
+  }
+
+  /* 3.2 / 3.3 旧布局：向后兼容，用宿主可执行文件加 ELECTRON_RUN_AS_NODE 去跑 */
+  const legacyCandidates = [
+    { source: 'runtime-legacy', file: join(resources, 'runtime', 'pnpm', 'bin', 'pnpm.mjs') },
+    { source: 'asar-unpacked', file: join(resources, 'app.asar.unpacked', 'dsh', 'node_modules', 'pnpm', 'bin', 'pnpm.mjs') },
+  ]
+  for (const candidate of legacyCandidates) {
+    if (exists(candidate.file) !== true) {
+      miss(candidate.source, candidate.file, '不存在')
+      continue
+    }
+    if (execPath.length === 0) {
+      miss(candidate.source, candidate.file, '找到 pnpm，但没有可用的宿主可执行文件')
+      continue
+    }
+    return hit(candidate.source, { command: execPath, args: [candidate.file], electron }, candidate.file)
+  }
+
+  return fail()
+}
+
+/**
+ * 定位 pnpm 可执行文件（向后兼容的薄包装）。
+ *
+ * 内部走 `resolvePnpmDetailed()`，只关心「最终能不能跑」，不关心试过哪些候选。
+ * 现有测试与 `verify-self-update.js --online` 用的都是这个签名。
+ *
+ * @param {object} [options] 透传给 resolvePnpmDetailed（测试注入用）
+ * @returns {{command: string, args: string[], electron: boolean}|null}
+ */
+export function resolvePnpm(options) {
+  const detail = resolvePnpmDetailed(options)
+  return detail.ok === true ? detail.runner : null
 }
 
 /**
@@ -231,9 +414,9 @@ export const RELEASE_AGE_OVERRIDE = '--config.minimum-release-age=0'
  *   - `--save-exact`：清单里写死精确版本，避免 `^` 范围日后漂移。
  *   - 发布年龄归零：见 RELEASE_AGE_OVERRIDE。
  *
- * 不加 `--no-frozen-lockfile`：pnpm 11.7.0 的 `add` 不认这个选项
- * （实测报 `Unknown option: 'frozen-lockfile'`）。`add` 本来就会更新锁文件，
- * 不需要它。
+ * 不加 `--no-frozen-lockfile`：pnpm 11 的 `add` 不认这个选项
+ * （实测报 `Unknown option: 'frozen-lockfile'`；宿主当前自带 pnpm 11.28.5，同样如此）。
+ * `add` 本来就会更新锁文件，不需要它。
  *
  * @param {string[]} base pnpm 自身的参数（例如打包 pnpm 的 .mjs 路径）
  * @param {string} target 安装目标 `包名@版本`
@@ -257,14 +440,30 @@ export async function runSelfUpdate(options) {
      刷新页面不算数 —— 插件包元数据（含 client.js 的 revision）在启动时缓存、直到重启才更新
      （见 @deepseek-ai/dsh-hmr 的已知限制与 dsh-client-modules 的说明）。
      不用「要不要重启」去猜，直接如实告诉界面。 */
-  const result = { ok: false, from, to: options.version, reason: null, detail: null, profileDir: null, changedExclude: false, restartRequired: true }
+  const result = { ok: false, from, to: options.version, reason: null, detail: null, profileDir: null, changedExclude: false, restartRequired: true, tried: [] }
 
-  const pnpm = resolvePnpm()
-  if (pnpm === null) {
+  /* 注意：必须在找 profile 之前就报 pnpm-not-found —— 找不到 pnpm 时 profile
+     目录是否存在无关紧要，先告诉用户真正的卡点。 */
+  const pnpm = resolvePnpmDetailed()
+  if (pnpm.ok !== true) {
     result.reason = 'pnpm-not-found'
+    /* 把试过的候选写进结果和日志：issue 里那次排查全靠手工逐条 Test-Path，
+       以后用户/开发者看日志就能定位，不用再猜插件找的是哪条路径。 */
+    result.tried = pnpm.tried
+      .slice(0, 12)
+      .map((one) => {
+        const where = one.path === null ? '—' : one.path
+        const line = one.source + ': ' + where + '（' + one.note + '）'
+        return line.length > 300 ? line.slice(0, 300) + '…' : line
+      })
+    log('update: pnpm-not-found，尝试过：')
+    for (const line of result.tried) log('  - ' + line)
     return result
   }
 
+  const runner = pnpm.runner
+  log('update: pnpm 来源 ' + pnpm.source + ' → ' + runner.command + ' ' + runner.args.join(' ') + (runner.electron === true ? '（ELECTRON_RUN_AS_NODE）' : ''))
+
   const profileDir = findProfileDir(selfDir)
   result.profileDir = profileDir
   if (profileDir === null) {
@@ -285,13 +484,13 @@ export async function runSelfUpdate(options) {
   /* 精确版本，不用 @latest：后者在发布年龄策略下会静默装成旧的成熟版 */
   const target = SELF_NAME + '@' + options.version
   const env = { ...process.env }
-  if (pnpm.electron === true) env.ELECTRON_RUN_AS_NODE = '1'
+  if (runner.electron === true) env.ELECTRON_RUN_AS_NODE = '1'
   /* CI=true：pnpm 在非交互环境下不会弹提示卡住（与官方插件管理器同一做法） */
   env.CI = 'true'
-  const args = updateArgs(pnpm.args, target)
+  const args = updateArgs(runner.args, target)
 
   log('update: 开始安装 ' + target)
-  const run = await runCommand(pnpm.command, args, {
+  const run = await runCommand(runner.command, args, {
     cwd: profileDir,
     env,
     timeoutMs: options.timeoutMs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-desktop-statusbar",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "type": "module",
   "description": "把 DSH 桌面端对话区底部的统计行换成可配置状态栏：10 个字段可选可排序，按官方峰谷口径估算费用，支持自定义模型单价与账户余额。",
   "icon": "icon.svg",

package/tools/shot.cjs

@@ -236,15 +236,19 @@ function pricingShot(locale) {
      教训：**下标是脆的**，加 hook 必须回来重数，并用 `node tools/shot.cjs` 实际生成一次确认。 */
   const presets = [];
   presets[4] = 'deepseek-flash';
-  /* 浮层里的数字也要跟着币种走：预设草稿按语言挑人民币或美元那套 */
+  /* 浮层里的数字也要跟着币种走：预设草稿按语言挑人民币或美元那套。
+     **`currency` 必须一起写**：下拉按钮显示的正是 `draft.currency`（不是 config.currency），
+     漏了它英文截图就会退回默认的 CNY —— 与整页英文界面自相矛盾（2026-10 实际踩过）。 */
   presets[5] = locale === 'en'
     ? {
       tiered: true,
+      currency: 'USD',
       peak: { input: '0.3', cacheRead: '0.006', cacheWrite: '0', output: '1.2' },
       offPeak: { input: '0.15', cacheRead: '0.003', cacheWrite: '0', output: '0.6' }
     }
     : {
       tiered: true,
+      currency: 'CNY',
       peak: { input: '2', cacheRead: '0.04', cacheWrite: '0', output: '8' },
       offPeak: { input: '1', cacheRead: '0.02', cacheWrite: '0', output: '4' }
     };