balance-dsh 2.0.7 → 2.0.8

package/lib/index.js

@@ -527,7 +527,7 @@ function formatBalance(balance) {
 //                          | { status:"failed" }  （网络失败；官方明确“失败绝不变成 0 余额”）
 // client 是 AccountClientMetadata（version / locale / timezoneOffsetSeconds），
 // 缺字段会在平台侧组装请求头时抛错，所以三个字段都要给。
-const PLUGIN_VERSION = "2.0.7";
+const PLUGIN_VERSION = "2.0.8";
 
 // ─── 检查更新 ───────────────────────────────────────────────────────────────
 // 只查 npm registry 的 latest 标签（一个很小的 JSON），不下载任何东西。
@@ -1940,6 +1940,39 @@ function writeJson(res, status, payload) {
   res.end(body);
 }
 
+/** 后台异步任务的兜底包装。
+ *
+ *  为什么必须有：本插件里所有「不 await 的后台任务」（读设置文件、同步节假日、拉更新）
+ *  都是 fire-and-forget。只要其中任何一个抛出未被包住的异常，Node/Electron 会把它升级成
+ *  unhandledRejection —— **Electron 主进程遇到它会直接报错退出**。用户看到的现象是
+ *  「DSH 更新完启动就崩，把插件禁用了才起得来，之后再启用又正常」（2026-10-30 反馈）。
+ *
+ *  那个现象的本质：启动期插件是主进程的一部分，它抛错 = bootstrap 中止；
+ *  而运行时启用时 app 已经活着，同样的错只影响插件自己。
+ *  所以这里把所有后台任务统一吞掉：失败就降级（设置用默认值 / 日历用内置表 / 跳过这次刷新），
+ *  只写一条 warn，绝不把异常漏成 unhandledRejection。
+ *
+ *  注意：只包**异步/后台**那段。同步的 register 类错误该暴露还是要暴露，
+ *  否则出问题时会变成「插件静默不工作」，更难查。 */
+function runQuietly(label, fn) {
+  const report = (error) => {
+    try {
+      const detail = error && error.message ? error.message : String(error);
+      console.warn("[balance-dsh] " + label + " 失败（已降级，不影响启动）: " + detail);
+    } catch {
+      // console 本身不可用时也不能再抛
+    }
+  };
+  try {
+    const result = fn();
+    if (result && typeof result.then === "function") {
+      result.then(undefined, report);
+    }
+  } catch (error) {
+    report(error);
+  }
+}
+
 export function apply(ctx, config = {}) {
   let todayCache = { expiresAt: 0, value: null };
   let statsCache = { expiresAt: 0, value: null };
@@ -1947,7 +1980,10 @@ export function apply(ctx, config = {}) {
   // 读不到文件不是错误——全新安装就是没有文件，保持默认值即可。
   const settingsState = { value: { ...DEFAULT_SETTINGS }, file: "" };
   let effectiveConfig = withSettings(config, settingsState.value);
-  void (async () => {
+  // 读设置是后台任务：settingsFilePath 走 dshHomePath 服务、readSettingsFile 走 fs，
+  // 两者都可能在 DSH 换版本后抛错（内部服务改名 / 目录权限变化）。
+  // 用 runQuietly 包住 —— 读不到就保持出厂默认值继续跑，绝不能漏成 unhandledRejection。
+  runQuietly("读取设置", async () => {
     settingsState.file = settingsFilePath(ctx);
     const loaded = await readSettingsFile(settingsState.file);
     let dirty = false;
@@ -1980,7 +2016,7 @@ export function apply(ctx, config = {}) {
         // 写盘失败（目录只读等）不影响这一次运行：内存里已经是最新值
       }
     }
-  })();
+  });
   // DSH 热重载(reload)时会重新 apply 本插件；若旧实例注册的 /balance-api 路由
   // 未被清理，新实例再次 register 就会抛出 duplicate route，导致整个 apply 失败、
   // 余额不显示。这里收集每次 register 返回的 disposer，并在插件卸载(ctx.on("dispose"))
@@ -1990,39 +2026,43 @@ export function apply(ctx, config = {}) {
   // 节假日数据：先读本地缓存（这样断网、改过系统时间也照样按上次同步的结果算钱），
   // 再看缓存是不是过期（默认 30 天），过期才去拉。故意不 await —— 网络慢不能拖住启动，
   // isPeakAt 保持同步函数，缓存没到位时继续用内置表。
-  void (async () => {
-    try {
-      await loadCalendarCache(ctx);
-      await refreshCnCalendar(ctx, false);
-    } catch {
-      // 任何异常都只是「这次没更新」，不影响余额与计费
-    }
-  })();
+  runQuietly("同步节假日数据", async () => {
+    await loadCalendarCache(ctx);
+    await refreshCnCalendar(ctx, false);
+  });
 
   // 1) /balance 命令：保留命令行查询入口
   ctx.inject(["commands"], (commandCtx) => {
-    commandCtx.commands.register({
-      name: "balance",
-      description: "查询 DeepSeek 余额与当前会话消耗",
-      handler: async ({ agent, signal }) => {
-        const usage = sumSessionUsage(agent.session, effectiveConfig);
-        const model = detectModel(agent.session);
-        const pricing = catalogPricing(effectiveConfig, model);
-        const multiplier = peakMultiplierOf(effectiveConfig);
-        // 余额来源：官方账号优先（官方版内置登录，无需 API Key），回退 API Key。
-        const { balance, error } = await resolveBalance(ctx, effectiveConfig, signal);
-        if (balance === null) {
+    // register 抛错（命令名冲突 / API 变更）只影响 /balance 命令本身，
+    // 不能让它中止 bootstrap —— 余额行和消耗行都不走命令通道。
+    try {
+      commandCtx.commands.register({
+        name: "balance",
+        description: "查询 DeepSeek 余额与当前会话消耗",
+        handler: async ({ agent, signal }) => {
+          const usage = sumSessionUsage(agent.session, effectiveConfig);
+          const model = detectModel(agent.session);
+          const pricing = catalogPricing(effectiveConfig, model);
+          const multiplier = peakMultiplierOf(effectiveConfig);
+          // 余额来源：官方账号优先（官方版内置登录，无需 API Key），回退 API Key。
+          const { balance, error } = await resolveBalance(ctx, effectiveConfig, signal);
+          if (balance === null) {
+            return {
+              kind: "error",
+              text: `${error}\n\n${formatUsage(usage, pricing, multiplier, model)}`,
+            };
+          }
           return {
-            kind: "error",
-            text: `${error}\n\n${formatUsage(usage, pricing, multiplier, model)}`,
+            kind: "success",
+            text: `${formatBalance(balance)}\n\n${formatUsage(usage, pricing, multiplier, model)}`,
           };
-        }
-        return {
-          kind: "success",
-          text: `${formatBalance(balance)}\n\n${formatUsage(usage, pricing, multiplier, model)}`,
-        };
-      },
-    });
+        },
+      });
+    } catch (error) {
+      runQuietly("注册 /balance 命令", () => {
+        throw error;
+      });
+    }
   });
 
   // 2) /balance-api HTTP 接口：供客户端插件直接渲染余额（不经过命令，不污染会话日志）
@@ -2031,7 +2071,13 @@ export function apply(ctx, config = {}) {
   //      /balance-api 不注册（404）。改为只声 inject ["webServer"]，子代理在
   //      sumSubagentUsage 内部用可空 ctx.get("subagents") 获取。
   ctx.inject(["webServer"], (httpCtx) => {
-    const balanceRouteDisposer = httpCtx.webServer.register({
+    // register 是最可能在启动期炸的一步：DSH 更新/热重载后旧实例路由没清干净，
+    // 新实例再注册就会抛 duplicate exact route。以前这个异常会一路冒到 loader，
+    // 整个插件加载失败（连带余额行、消耗行、设置卡片全不显示）。
+    // 现在单独兜住：注册失败只意味着余额接口这次不可用，启动照常。
+    let balanceRouteDisposer = null;
+    try {
+      balanceRouteDisposer = httpCtx.webServer.register({
       kind: "exact",
       path: "/balance-api",
       handler: async (req, res) => {
@@ -2258,6 +2304,13 @@ export function apply(ctx, config = {}) {
         });
       },
     });
+    } catch (error) {
+      // duplicate exact route / API 变更：余额接口这次不可用，但插件照常加载
+      runQuietly("注册 /balance-api 路由", () => {
+        throw error;
+      });
+      return;
+    }
     if (typeof balanceRouteDisposer === "function") disposers.push(balanceRouteDisposer);
   });
 

package/package.json

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