balance-dsh 2.1.2 → 2.1.3

package/README.md

@@ -90,9 +90,11 @@ token 数用官方文档站「图片 Token 计算器」的同一套算法估算
 
 整张卡片可以收起（点标题一行展开 / 折叠）。**没有保存按钮**，改动后约 0.35 秒自动保存，左下角依次显示「修改中… → 保存中… → 已保存」；点「恢复默认」立刻写回全部默认值。设置存放在你的 `.dsh` 目录下的 `balance-dsh.json`。
 
-### `/balance` 命令
+### `/balance-dsh-rannist` 命令
 
-在对话里输入 `/balance` 查询余额明细和当前会话消耗。
+在对话里输入 `/balance-dsh-rannist` 查询余额明细和当前会话消耗。
+
+命令名带作者后缀是刻意的：DSH 的命令名全局唯一，`/balance` 这类通用名会和别的余额插件撞车（先注册的赢、后来的整条命令消失），所以用全名、不设备用名。注意 DSH 只接受**小写**命令名，写成大写会在注册时被判非法。
 
 ## 使用统计口径
 

package/lib/index.js

@@ -758,7 +758,13 @@ function formatBalance(balance) {
 //                          | { status:"failed" }  （网络失败；官方明确“失败绝不变成 0 余额”）
 // client 是 AccountClientMetadata（version / locale / timezoneOffsetSeconds），
 // 缺字段会在平台侧组装请求头时抛错，所以三个字段都要给。
-const PLUGIN_VERSION = "2.1.2";
+const PLUGIN_VERSION = "2.1.3";
+
+/** 斜杠命令名（2026-10-31 定案：用带作者后缀的全名，避免和别的余额插件撞车，也不设备用名）。
+ *  ⚠️ DSH 的 COMMAND_NAME = /^[a-z][a-z0-9_-]*$/u —— **只允许小写**。
+ *  写成 balance-dsh-Rannist 会在 normalizeDefinition 里抛 TypeError，整条命令直接消失，
+ *  所以这里落成小写；界面里输入 `/balance-dsh-rannist` 即可。 */
+const COMMAND_NAME = "balance-dsh-rannist";
 
 /** 磁盘上**实际安装**的版本号。
  *
@@ -3111,7 +3117,7 @@ async function sumSubagentUsage(ctx, sessionId, config) {
 function formatUsage(usage, pricing, multiplier = 2, model = "") {
   // ⚠️ usage 为 null 时绝不许直接解引用（2026-10-31 全量审查）。
   // sumSessionUsage 在会话还在装载 / 事件为空时会返回 null，
-  // 而 /balance 命令把它直接传进来 —— 下面一行 usage.byModel 就是 TypeError，
+  // 而命令处理把 usage 直接传进来 —— 下面一行 usage.byModel 就是 TypeError，
   // 整个命令面板报错。命令只是查看入口，拿不到数字就说一句话。
   if (usage == null || typeof usage !== "object") {
     return "当前会话消耗：暂时无数据（会话可能还在加载，稍后再试）";
@@ -3301,13 +3307,17 @@ let statsInFlight = null;
     await refreshCnCalendar(ctx, false);
   });
 
-  // 1) /balance 命令：保留命令行查询入口
+  // 1) 命令行查询入口。命令名**必须是插件专属的**（2026-10-31 用户反馈：
+  //    「这个指令跟好多插件冲突了」）—— DSH 的命令名是全局唯一的，注册重名会抛
+  //    `command "x" is already registered`，先注册的那个赢、后来的整条命令消失。
+  //    所以直接用带作者后缀的全名，不设备用名（用户 2026-10-31 定案）。
+  //    ⚠️ DSH 的命令名规则是 COMMAND_NAME = /^[a-z][a-z0-9_-]*$/u，**只允许小写**，
+  //    写成大写 Rannist 会在 normalizeDefinition 里抛 TypeError、整条命令消失，
+  //    所以这里落成小写的 balance-dsh-rannist。
   ctx.inject(["commands"], (commandCtx) => {
-    // register 抛错（命令名冲突 / API 变更）只影响 /balance 命令本身，
-    // 不能让它中止 bootstrap —— 余额行和消耗行都不走命令通道。
     try {
       commandCtx.commands.register({
-        name: "balance",
+        name: COMMAND_NAME,
         description: "查询 DeepSeek 余额与当前会话消耗",
         handler: async ({ agent, signal }) => {
           const usage = sumSessionUsage(agent.session, effectiveConfig);
@@ -3334,7 +3344,7 @@ let statsInFlight = null;
         },
       });
     } catch (error) {
-      runQuietly("注册 /balance 命令", () => {
+      runQuietly("注册 /" + COMMAND_NAME + " 命令", () => {
         throw error;
       });
     }
@@ -3423,8 +3433,7 @@ let statsInFlight = null;
           wantUpdate = false;
         }
         if (wantUpdate) {
-          if (req.method === "POST") {
-            // ⚠️ 必须和设置写入同一道同源校验（2026-10-31 第二十二轮审计）：
+          if (req.method === "POST") {            // ⚠️ 必须和设置写入同一道同源校验（2026-10-31 第二十二轮审计）：
             // 这条分支会真的下载 npm 包并覆盖插件安装目录。少了校验，本机任意网页
             // 用一个 text/plain 的简单请求就能触发写盘（CSRF）。
             if (!isSameOriginJsonRequest(req)) {

package/package.json

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