@zhangfengshun/dsh-remote-ssh 2.3.0 → 2.3.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [2.3.2] — 远程工作区图标改为单个「地球角标文件夹」
+### 变更
+- **工作区标题去掉 🌐 前缀**：新建远程工作区的原生标题不再带 🌐（此前标题 emoji + 壳层文件夹图标造成「文件夹 + 地球」双重标识）；启动自愈同步剥掉既有工作区标题中的旧 🌐 前缀（仅限已知旧形态，不覆盖自定义标题）。
+- **客户端图标替换**：按工作区标题文本定位侧边栏工作区行，隐藏壳层默认纯文件夹 svg，插入内联「地球角标文件夹」SVG（文件夹描边 + 主题色圆形地球角标，跟随明暗主题）；复用 2.3.1 的增量观察器（只扫新增子树、30s 刷新标题集、data 标记防重入），稳态成本≈0。
+
+## [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,38 +1115,124 @@ 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) {}
+        }
+        // ---- 远程工作区图标：单个「地球角标文件夹」SVG 替换壳层默认纯文件夹图标 ----
+        // 壳层工作区行的文件夹图标是固定原语（IconFolderOpen16/Close16），无 per-workspace
+        // 图标 API；旧方案在标题里塞 🌐 emoji 造成「文件夹 + 地球」双重标识。现按标题文本
+        // 定位远程工作区行，隐藏原 svg 并插入内联「地球角标文件夹」svg（data 标记防重入）。
+        var remoteTitles = new Set();
+        function refreshRemoteTitles() {
+          api("listWorkspaces").then(function (r) {
+            if (!(r && r.ok && Array.isArray(r.workspaces))) return;
+            var next = new Set();
+            for (var i = 0; i < r.workspaces.length; i++) {
+              var t = String(r.workspaces[i].title || "").trim();
+              if (t) { next.add(t); next.add("🌐 " + t); } // 兼容自愈前的旧前缀标题
+            }
+            remoteTitles = next;
+            swapWorkspaceIconsIn(document.body); // 标题集就绪后补一次全量替换
+          }).catch(function () {});
+        }
+        function folderGlobeSvg() {
+          var NS = "http://www.w3.org/2000/svg";
+          var svg = document.createElementNS(NS, "svg");
+          svg.setAttribute("viewBox", "0 0 20 16");
+          svg.setAttribute("width", "16");
+          svg.setAttribute("height", "16");
+          svg.setAttribute("aria-hidden", "true");
+          svg.setAttribute("data-rssh-folder-globe", "1");
+          svg.innerHTML =
+            '<path d="M2.4 4.2c0-1.05.85-1.9 1.9-1.9h3.1c.52 0 1.02.21 1.39.58l1.05 1.05c.28.28.66.44 1.06.44h6.3c1.05 0 1.9.85 1.9 1.9v6.53c0 1.05-.85 1.9-1.9 1.9H4.3c-1.05 0-1.9-.85-1.9-1.9V4.2z" fill="none" stroke="currentColor" stroke-width="1.2"/>' +
+            '<circle cx="6.3" cy="12.1" r="3.1" fill="var(--dsw-alias-state-business-primary, #4c6ef5)" stroke="var(--dsw-alias-bg-layer-1, #1b1b1b)" stroke-width="0.8"/>' +
+            '<g fill="none" stroke="#ffffff" stroke-width="0.75"><circle cx="6.3" cy="12.1" r="1.95"/><ellipse cx="6.3" cy="12.1" rx="0.95" ry="1.95"/><path d="M4.35 12.1h3.9"/></g>';
+          return svg;
+        }
+        function swapWorkspaceIconsIn(root) {
+          if (!remoteTitles.size) return;
+          try {
+            var nodes = root.querySelectorAll("span,div,button,a,p");
+            for (var i = 0; i < nodes.length; i++) {
+              var el = nodes[i];
+              if (el.getAttribute && el.getAttribute("data-rssh-title-scan") === "1") continue;
+              var t = (el.textContent || "").trim();
+              if (!t || !remoteTitles.has(t) || el.childElementCount > 2) continue;
+              el.setAttribute("data-rssh-title-scan", "1");
+              // 向上找最近的「直接子级含 svg」的容器（壳层 slot.folder 槽位）
+              var p = el, slot = null, guard = 0;
+              while (p && p.nodeType === 1 && p !== document.body && guard++ < 6) {
+                if (p.querySelector(":scope > svg")) { slot = p; break; }
+                p = p.parentElement;
               }
+              if (!slot) continue;
+              var old = slot.querySelector(":scope > svg");
+              if (old && old.getAttribute("data-rssh-folder-globe") === "1") continue;
+              if (old) old.style.display = "none";
+              var mine = folderGlobeSvg();
+              if (old) slot.insertBefore(mine, old); else slot.appendChild(mine);
             }
           } catch (e) {}
-          return false;
         }
         ctx.effect(function () {
           if (typeof document === "undefined") return;
           hideRemoteGearIcon();
+          refreshRemoteTitles();
+          var titleTimer = setInterval(refreshRemoteTitles, 30000);
           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]); swapWorkspaceIconsIn(roots[i]); }
+                }
+              } else {
+                hideRemoteGearIcon(); // 语言切换等无根场景全量扫一次
+                swapWorkspaceIconsIn(document.body);
+              }
+            }, 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();
             if (timer) clearTimeout(timer);
+            clearInterval(titleTimer);
           };
-        }, "dsh-remote-ssh: hide settings nav gear icon");
+        }, "dsh-remote-ssh: settings gear hide + remote workspace folder-globe icon");
       }
 
       // better-sidebar 0.15+ 的文件上传 UI 把原始字节流 POST 到 /sidebar/upload。

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);
 }
@@ -1256,7 +1273,7 @@ function apply(ctx, config) {
       let workspaceId = null;
       if (workspaceRegistry) {
         try {
-          const wsTitle = "🌐 " + title;
+          const wsTitle = title; // 图标语义由客户端「地球角标文件夹」图标承担，标题不再带 🌐 前缀
           const native = await workspaceRegistry.create(mirrorDir, wsTitle);
           workspaceId = native.id;
           // workspaceRegistry.create 仅首次创建时应用 title；已存在的旧工作区
@@ -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) => {
@@ -1838,10 +1856,11 @@ function apply(ctx, config) {
     }
   })();
 
-  // ---- 启动自愈：把既有远程工作区的原生标题统一为「🌐 + 远程路径最后一段」----
+  // ---- 启动自愈：把既有远程工作区的原生标题统一为「远程路径最后一段」----
   // 早期版本 create 工作区时未传 title，DSH 用镜像目录 basename（wsId，如 wmt3tev5cdfge）
   // 作标题；workspaceRegistry.create 只对新建记录应用 title，旧记录会被原样返回。
-  // 这里仅在标题等于镜像目录 basename（明显是旧 bug 产物）时修复，不覆盖用户自定义标题。
+  // 2.3.2 起标题不再带 🌐 前缀（图标由客户端地球角标文件夹 SVG 承担），自愈同时剥掉
+  // 旧版遗留的 🌐 前缀。仅在标题等于已知旧形态时修复，不覆盖用户自定义标题。
   function healWorkspaceTitles() {
     const reg = workspaceRegistry;
     if (!reg || typeof reg.resolveByPath !== "function") return;
@@ -1850,13 +1869,14 @@ function apply(ctx, config) {
       if (!w || !w.mirrorPath || !w.remotePath) continue;
       const lastSeg = String(w.remotePath).replace(/\/+$/, "").split("/").pop();
       if (!lastSeg || lastSeg === "~" || lastSeg === ".") continue;
-      const desired = "🌐 " + lastSeg;
+      const desired = lastSeg;
       const base = String(w.mirrorPath).split(/[\\/]/).filter(Boolean).pop();
+      const legacy = new Set([base, "🌐 " + base, desired, "🌐 " + desired, "🌐 " + w.title]);
       (async () => {
         try {
           const ent = await reg.resolveByPath(w.mirrorPath);
-          // 只在标题仍卡在镜像目录名（旧 bug）时才改，尊重用户自定义标题。
-          if (ent && typeof ent.setTitle === "function" && (ent.title === base || ent.title === "🌐 " + base)) {
+          // 只在标题仍是已知旧形态（镜像目录名旧 bug / 🌐 前缀旧版）时修复，尊重自定义标题。
+          if (ent && typeof ent.setTitle === "function" && legacy.has(ent.title)) {
             await ent.setTitle(desired);
           }
         } catch (e) {}
@@ -2157,12 +2177,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.2",
   "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",