@zhangfengshun/dsh-remote-ssh 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [2.3.1] — 修复 2.3.0 上线后的界面卡顿（GC 压力 + 客户端全页扫描）
+### 修复
+- **读缓存字节预算（review m1）**：单条结果 >1MiB 不再缓存（结果照常返回），缓存总量上限 32MB 超限逐出最旧条目——消除大文件驻留字符串造成的 GC 压力（最坏 ~270MB → ≤32MB）。
+- **设置导航齿轮观察器改为增量扫描**：此前任何 DOM 变动都会触发全文档 `querySelectorAll("button")` 扫描（流式聊天期间持续打断主线程）；现改为只扫描新增子树、节流 500ms、后台页签零开销，稳态成本≈0。
+- **exec 失败不再 bump epoch（review m3）**：失败的命令通常无副作用，不再无谓打断整代缓存（部分副作用由 ≤5s TTL 兜底）。
+- **git 只读命令不再整代失效（review m4）**：仅 add/reset/commit/checkout/revert/cherry-pick 变更类子命令 bump，status/diff/log/branch/show 不再打断缓存。
+
 ## [2.3.0] — 远程文件打开提速：单往返合并读 + 结果缓存（实测 ≈1.3×~5×）
 ### 性能
 - **fs.read 单往返合并读**：size/mtime 与文件内容合并为一条池化命令（`__DSH_ST__` 帧，`_` 不在 base64 字母表故标记天然抗噪），去掉每文件一次的 stat 往返。真实 HPC 实测（100KB 文件，各 10 次 p50）：raw 直传 396.6→301.8ms、base64 443.8→337.9ms，约 **1.31×**；1MB 大文件同步受益。>4MB 仍 `head -c 4MiB` 截断，二进制探测与解码语义不变。

package/lib/client.js

@@ -1115,32 +1115,58 @@ window.__ModuleLoader__.load({
       // 不可靠。这里改为按条目文本（settings.nav）定位设置导航按钮，隐藏其 svg 图标；
       // 设置面板按需挂载、语言会切换，用 MutationObserver + 语言订阅自动重跑。
       if (slots) {
+        function checkCell(btn) {
+          var label = i18n.t("settings.nav");
+          var text = (btn.textContent || "").trim();
+          if (text !== label.trim() || text === "") return false;
+          var icon = btn.querySelector("svg");
+          if (icon) { icon.style.display = "none"; return true; }
+          return false;
+        }
+        function checkCellIn(root) {
+          try {
+            if (root.tagName && String(root.tagName).toLowerCase() === "button") checkCell(root);
+            var cells = root.querySelectorAll("button");
+            for (var i = 0; i < cells.length; i++) checkCell(cells[i]);
+          } catch (e) {}
+        }
         function hideRemoteGearIcon() {
           try {
-            var label = i18n.t("settings.nav");
             var buttons = document.querySelectorAll("button");
-            for (var i = 0; i < buttons.length; i++) {
-              var btn = buttons[i];
-              var text = (btn.textContent || "").trim();
-              if (text === label.trim() && text !== "") {
-                var icon = btn.querySelector("svg");
-                if (icon) { icon.style.display = "none"; return true; }
-              }
-            }
+            for (var i = 0; i < buttons.length; i++) checkCell(buttons[i]);
           } catch (e) {}
-          return false;
         }
         ctx.effect(function () {
           if (typeof document === "undefined") return;
           hideRemoteGearIcon();
           var timer = null;
-          var schedule = function () {
+          var pendingRoots = null;
+          var schedule = function (root) {
+            if (root && root.nodeType === 1) (pendingRoots || (pendingRoots = [])).push(root);
             if (timer) return;
-            timer = setTimeout(function () { timer = null; hideRemoteGearIcon(); }, 120);
+            timer = setTimeout(function () {
+              timer = null;
+              var roots = pendingRoots;
+              pendingRoots = null;
+              if (document.hidden) return; // 后台页签零开销
+              if (roots && roots.length) {
+                // 只扫新增子树：流式聊天期间不做全文档扫描（稳态成本≈0）
+                for (var i = 0; i < roots.length; i++) {
+                  if (roots[i].isConnected) checkCellIn(roots[i]);
+                }
+              } else {
+                hideRemoteGearIcon(); // 语言切换等无根场景全量扫一次
+              }
+            }, 500);
           };
-          var mo = new MutationObserver(schedule);
+          var mo = new MutationObserver(function (muts) {
+            for (var i = 0; i < muts.length; i++) {
+              var added = muts[i].addedNodes;
+              for (var j = 0; j < added.length; j++) schedule(added[j]);
+            }
+          });
           mo.observe(document.body, { childList: true, subtree: true });
-          var off = i18n.subscribe(schedule);
+          var off = i18n.subscribe(function () { schedule(null); });
           return function () {
             mo.disconnect();
             if (off) off();

package/lib/index.js

@@ -518,6 +518,23 @@ function lruPut(map, key, val, max) {
   while (map.size > max) map.delete(map.keys().next().value);
 }
 
+/** 读缓存字节预算（review m1）：单条 >1MiB 不缓存、总量 ≤32MB，防止大文件驻留
+ *  造成 GC 压力拖慢整个宿主进程。超预算时从最旧条目开始逐出。 */
+const READ_CACHE_MAX_ENTRY_BYTES = 1024 * 1024;
+const READ_CACHE_TOTAL_BYTES = 32 * 1024 * 1024;
+function readCachePut(key, entry, max) {
+  entry.bytes = Buffer.byteLength(entry.content, "utf8");
+  if (entry.bytes > READ_CACHE_MAX_ENTRY_BYTES) return; // 大文件不缓存（结果照常返回）
+  lruPut(readCache, key, entry, max);
+  let total = 0;
+  for (const v of readCache.values()) total += v.bytes || 0;
+  while (total > READ_CACHE_TOTAL_BYTES && readCache.size > 1) {
+    const oldest = readCache.keys().next().value;
+    total -= readCache.get(oldest).bytes || 0;
+    readCache.delete(oldest);
+  }
+}
+
 function normalizeCachePath(path) {
   let s = String(path || "");
   while (s.length > 1 && s.charCodeAt(s.length - 1) === 47) s = s.slice(0, -1);
@@ -689,7 +706,7 @@ async function remoteReadFile(runner, p, path) {
       }
       if (rst.framed && rst.size === hit.size && rst.mtime === hit.mtime) {
         hit.at = Date.now();
-        lruPut(readCache, key, hit, READ_CACHE_MAX);
+        readCachePut(key, hit, READ_CACHE_MAX);
         return readResultOk(path, hit.content, hit.binary, hit.truncated);
       }
     }
@@ -705,7 +722,7 @@ async function remoteReadFile(runner, p, path) {
     if (rawOk) {
       const truncated = st.size !== null && st.size > MAX_BYTES;
       if (!r.truncated) {
-        lruPut(readCache, key, { content: rawOk.text, binary: rawOk.binary, truncated: truncated, size: st.size, mtime: st.mtime, epoch: epoch, at: Date.now() }, READ_CACHE_MAX);
+        readCachePut(key, { content: rawOk.text, binary: rawOk.binary, truncated: truncated, size: st.size, mtime: st.mtime, epoch: epoch, at: Date.now() }, READ_CACHE_MAX);
       }
       return readResultOk(path, rawOk.text, rawOk.binary, truncated || !!r.truncated);
     }
@@ -731,7 +748,7 @@ async function remoteReadFile(runner, p, path) {
   }
   const truncated = st.framed && st.size !== null && st.size > MAX_BYTES;
   if (st.framed && !r.truncated) {
-    lruPut(readCache, key, { content: decoded.text, binary: decoded.binary, truncated: truncated, size: st.size, mtime: st.mtime, epoch: epoch, at: Date.now() }, READ_CACHE_MAX);
+    readCachePut(key, { content: decoded.text, binary: decoded.binary, truncated: truncated, size: st.size, mtime: st.mtime, epoch: epoch, at: Date.now() }, READ_CACHE_MAX);
   }
   return readResultOk(path, decoded.text, decoded.binary, truncated || !!r.truncated);
 }
@@ -1306,9 +1323,10 @@ function apply(ctx, config) {
       if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
       if (!args || !args.command) return { ok: false, error: "command 为必填项" };
       // 走持久会话池（stderr 分离）：首调用建立连接后，后续调用毫秒级返回。
-      // 远程命令可能改任意文件（插件不可见）→ 整代失效读/列举缓存（findings §4.3a）。
+      // 远程命令可能改任意文件（插件不可见）→ 成功后整代失效读/列举缓存（findings §4.3a）；
+      // 失败的命令通常无副作用，不 bump 以免无谓打断缓存（部分副作用由 ≤5s TTL 兜底）。
       const r = await runPooled(p, args.command, args.stdin, undefined, true);
-      bumpCacheEpoch(p);
+      if (r.ok) bumpCacheEpoch(p);
       return r;
     },
     listDir: async (args) => {
@@ -2157,12 +2175,15 @@ function apply(ctx, config) {
   }
 
   /** 远端 git 执行（远程工作区）：在 remoteDir 里跑同一 git 语义。 */
+  const GIT_MUTATING_FIRST_TOKENS = new Set(["add", "reset", "commit", "checkout", "revert", "cherry-pick"]);
   async function runGitRemote(profile, remoteDir, args) {
     const quoted = args.map((a) => shellQuote(a)).join(" ");
     const r = await runPooled(profile, "git -C " + shellQuotePath(remoteDir) + " --no-pager -c color.ui=false " + quoted, undefined, 8 * 1024 * 1024);
     if (!r.ok) throw { code: "git-error", message: String(r.stdout || r.error || "").trim() || "remote git exited with " + r.exitCode };
-    // commit/checkout/revert/cherry-pick 等会改工作区文件 → 整代失效读/列举缓存
-    bumpCacheEpoch(profile);
+    // 仅变更类子命令（stage→add / unstage→reset / commit / checkout / discard→checkout /
+    // revert / cherry-pick）会改工作区文件 → 整代失效读/列举缓存；
+    // status/diff/log/branch/show 等只读命令不再打断缓存（review m4）。
+    if (GIT_MUTATING_FIRST_TOKENS.has(String(args[0] || ""))) bumpCacheEpoch(profile);
     return r.stdout;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhangfengshun/dsh-remote-ssh",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "DSH web plugin: VSCode Remote-SSH-like remote development (SSH to supercomputers/servers, remote workspace, file explorer, integrated terminal), integrated with dsh-better-sidebar and DSH settings.",
   "keywords": [
     "dsh",