dsh-desktop-statusbar 2.2.0 → 2.2.1

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
@@ -98,6 +98,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 计价单位
@@ -98,7 +98,7 @@ npm view dsh-desktop-statusbar version
 
 - 最快 / 最慢首字与速度来自 host 新增的投影，**升级后需完全退出并重启 DSH** 才开始统计
 - 价格库中缺少单价的模型不计费，补充单价后自动补算
-- 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端用 PATH 上的 pnpm。两者都找不到时会明确提示「找不到 pnpm」，而不是静默失败
+- 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端需要系统里有 `pnpm`。都找不到时会明确提示「找不到 pnpm」，并把**尝试过的每个位置**一并写进日志；也可以用环境变量 `DSH_DESKTOP_STATUSBAR_PNPM` 直接指定要用的命令
 
 ## 开发
 

package/lib/client.js

@@ -74,7 +74,7 @@ window.__ModuleLoader__.load({
 		 */
 		const CONFIG_VERSION = 6;
 		/** 插件版本：显示在设置页底部，用来确认页面加载的是哪一版客户端代码。 */
-		const VERSION = "2.2.0";
+		const VERSION = "2.2.1";
 		/** 官方参考价的版本：官方调价时改这个数字，老价格库会自动并入新参考价。 */
 		const PRICE_VERSION = 2;
 		/** 项目主页：设置页那个「去 GitHub 点 star」按钮跳这里（与 package.json 的 repository 同址）。 */

package/lib/index.js

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