@zhangfengshun/dsh-remote-ssh 2.4.5 → 2.4.6

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [2.4.6] — 「文件」页签树根显示远程目录名（issue #9）
+### 修复
+- **树根标签不再显示本地镜像目录 ID**（感谢 @Linhaojing 的链路定位）：better-sidebar「文件」页签的树根标签取自会话 cwd（= 本地镜像路径）的 basename，于是显示成 `wmu3sxe24jpvg` 之类的镜像目录名。这条链路**不经过任何 `fs.*` 路由**，且 Host 侧 `session.cwd` 虽已返回 `root` 字段但客户端只消费 `cwd`（`api.sessionCwd(...).then(r => setFetchedCwd(r.cwd))`，另有 `useSessionCwd` 直接读客户端会话列表的 `cwd`），因此只能在渲染层替换文本。现由客户端取 `listWorkspaces` 的 `mirrorPath`/`remotePath` 建立「镜像 basename → 远程 basename」映射，把树根那一行换成**远程目录名**（如 `IB_Robot`），并给该行加 `title` 显示完整远程路径（如 `~/lhj/IB_Robot`）。
+  - **定位不依赖构建期哈希类名**：根行是树里唯一带内联 `padding-left:6px` 的行，仅当该行内纯文本节点恰好等于某远程工作区的镜像 basename 时才替换——同名子条目、本地工作区、无根行标志（上游改版）时一律保守不动；
+  - **同步替换 + 幂等自愈**：与设置导航图标同样在 MutationObserver 回调（微任务、绘制前）内完成，不会先闪一下镜像 ID；React 重渲染还原文本时由 1s 复检与 30s 工作区轮询恢复。
+
+### 测试
+- 新增 `tests/tree-root-label.test.mjs`：从 `lib/client.js` 提取**真实**实现配极简 DOM 桩执行，覆盖 7 组场景共 17 条断言（替换、假阳性防护、幂等、React 还原自愈、本地工作区、同名边界、样式容错、接线检查）。
+
 ## [2.4.5] — 集成终端落在工作区远程目录（issue #7）+ 密码认证回退提示
 ### 修复
 - **「终端」页签现在落在工作区对应的远程目录**（感谢 @Linhaojing 的完整定位与验证矩阵）：此前生成的 `dsh-remote-shell.js` 只拼 host/user/port/keyPath/proxyJump，`ssh -tt` 不带远程命令，交互式 shell 落在远程 `$HOME`；同一会话里出现「文件树在工作区目录、终端在 $HOME」的割裂。现在 wrapper 读取标记文件里**已有的** `remotePath` 并追加远程命令：

package/README.md

@@ -45,7 +45,7 @@
 **一条命令安装**（无需 token、API Key 或额外配置）：
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.5
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.6
 ```
 
 安装后**重启 DSH**。`@zhangfengshun/dsh-remote-ssh` 必须在 bundles 列表中排在 `dsh-better-sidebar` **之后**。
@@ -187,6 +187,7 @@ dsh plugin --profile <name> remove @zhangfengshun/dsh-remote-ssh
 | 侧边栏文件页签显示「这类内容还没有可用的查看方式。」 | `dsh-better-sidebar` 主机半边未加载：0.18.1 / 0.19.0 / 0.19.1 在 DSH Desktop 上会因 `SessionLogOffset` 运行时导入失败——降到 0.18.0 或使用修复版（上游 PR [#641](https://github.com/omdsh-dev/DSH-better-sidebar/pull/641)） |
 | 内置「终端」页签连不上 | 终端为 `ssh -tt` 交互式通道，**仅支持密钥认证**；密码认证的连接会回退为本地 shell 并打印一行提示（避免把本地 shell 误认为已连上远程），密码认证请改用「文件」页签与模型工具 |
 | 终端落在远程 `$HOME` 而不是工作区目录 | 2.4.5 起已修复（wrapper 会 `cd` 到工作区 `remotePath`，目录不存在时回退 `$HOME`）；若仍停在 `$HOME`，确认 2.4.5 已装入并重启 DSH |
+| 「文件」页签树根显示镜像目录 ID（如 `wmu3sxe24jpvg`） | 2.4.6 起已修复：树根改为显示**远程目录名**（如 `IB_Robot`），悬停可见完整远程路径；该标签不经过 `fs.*` 路由，由客户端渲染层替换 |
 | 安装时提示 `minimumReleaseAge` 或「No matching version」（刚发布） | npm 供应链新鲜度策略，等 1–5 分钟后重试即可 |
 | 命令卡住不返回 | 默认 120s 超时后自动丢弃会话；长时任务用 `timeoutMs: 0`，随时可用 `remote_ssh_kill` 强杀 |
 | 大文件读取被截断 | 单文件读取上限 4MB、下载池化路径约 6.29MB（更大自动回落一次性连接）；用 `remote_ssh_exec` + `head`/`tail` 分段处理 |

package/README_EN.md

@@ -45,7 +45,7 @@ A **DSH** plugin like **VSCode Remote-SSH**: connect to remote HPC / servers via
 **One command** (no token, API key or extra configuration needed):
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.5
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.6
 ```
 
 **Restart DSH** after installation. `@zhangfengshun/dsh-remote-ssh` must come **after** `dsh-better-sidebar` in the bundles list.
@@ -187,6 +187,7 @@ The plugin never patches DSH sources or injects into the profile dependency tree
 | Sidebar Files tab says "Nothing here can view this kind of content yet." | `dsh-better-sidebar` host half failed to load: 0.18.1 / 0.19.0 / 0.19.1 hit the `SessionLogOffset` runtime import on DSH Desktop — downgrade to 0.18.0 or use a fixed build (upstream PR [#641](https://github.com/omdsh-dev/DSH-better-sidebar/pull/641)) |
 | Built-in Terminal tab cannot connect | The terminal is an `ssh -tt` interactive channel and supports **key auth only**; password-auth profiles fall back to a local shell and now print a one-line notice (so a local shell is not mistaken for a remote one) — use the Files tab and the model tools for password auth |
 | Terminal opens in the remote `$HOME` instead of the workspace directory | Fixed in 2.4.5 (the wrapper `cd`s into the workspace `remotePath`, falling back to `$HOME` when it no longer exists); if it still starts in `$HOME`, make sure 2.4.5 is installed and DSH restarted |
+| Files tab tree root shows the mirror directory id (e.g. `wmu3sxe24jpvg`) | Fixed in 2.4.6: the root row now shows the **remote directory name** (e.g. `IB_Robot`) with the full remote path on hover; that label never passes through the `fs.*` routes, so the client renders the replacement |
 | Install fails with `minimumReleaseAge` or "No matching version" right after a release | npm supply-chain freshness policy — retry after 1–5 minutes |
 | A command hangs forever | The 120s timeout discards the pooled session automatically; use `timeoutMs: 0` for long jobs and `remote_ssh_kill` at any time |
 | Large files are truncated | 4MB per read, ≈6.29MB on the pooled download path (larger files fall back to a one-shot connection); use `remote_ssh_exec` with `head`/`tail` to page through |

package/lib/client.js

@@ -1167,6 +1167,8 @@ window.__ModuleLoader__.load({
         // 追加地球经纬线组 —— 文件夹本体保持壳层默认原语几何，零改写零对账风险。
         var remoteTitles = new Set();
         var watchedTitles = []; // 已匹配的标题元素：定时幂等复检，抵消 React 重渲染对图标的还原
+        /** 镜像目录 basename → { label: 远程目录 basename, remotePath }（issue #9）。 */
+        var rootLabels = {};
         function refreshRemoteTitles() {
           api("listWorkspaces").then(function (r) {
             if (!(r && r.ok && Array.isArray(r.workspaces))) return;
@@ -1176,7 +1178,9 @@ window.__ModuleLoader__.load({
               if (t) { next.add(t); next.add("🌐 " + t); } // 兼容自愈前的旧前缀标题
             }
             remoteTitles = next;
+            refreshRootLabels(r.workspaces);
             swapWorkspaceIconsIn(document.body); // 标题集就绪后补一次全量替换
+            applyRootLabelsIn(document.body);    // 树根标签同样补一次全量替换
           }).catch(function () {});
         }
         /** 地球经纬线组（右下角、无圆盘底色）：线为白色、其余全透明；文件夹本体完全
@@ -1247,12 +1251,83 @@ window.__ModuleLoader__.load({
             }
           } catch (e) {}
         }
+
+        // ---- 文件树根标签：显示远程目录名，而不是本地镜像目录 ID（issue #9）----
+        // better-sidebar「文件」页签的树根标签取自会话 cwd（= 本地镜像路径）的 basename，
+        // 于是显示成镜像目录 ID（如 wmu3sxe24jpvg）。这条链路不经过任何 fs.* 路由，
+        // 而 Host 侧 session.cwd 虽然已返回 root 字段，客户端只消费 cwd
+        // （client-registry 的 api.sessionCwd(...).then(r => setFetchedCwd(r.cwd))，
+        // 另有 useSessionCwd 直接读客户端会话列表的 cwd），因此只能在渲染层替换文本。
+        // 定位不依赖构建期哈希类名：根行是树里唯一带内联 padding-left:6px 的行，
+        // 仅当该行内的纯文本节点 === 某远程工作区的镜像 basename 时才替换（幂等、可自愈）。
+        var watchedRootLabels = []; // 已替换的标签元素：1s 幂等复检，抵消 React 重渲染
+        function refreshRootLabels(workspaces) {
+          var next = {};
+          for (var i = 0; i < (workspaces || []).length; i++) {
+            var w = workspaces[i] || {};
+            var mirror = String(w.mirrorPath || "").replace(/[\\/]+$/, "");
+            var remote = String(w.remotePath || "").replace(/[\\/]+$/, "");
+            if (!mirror || !remote) continue;
+            var mb = mirror.split(/[\\/]/).pop();
+            var rb = remote.split(/[\\/]/).pop();
+            if (mb && rb && mb !== rb) next[mb] = { label: rb, remotePath: remote };
+          }
+          rootLabels = next;
+        }
+        /** 根行判据：自身或 ≤3 层祖先带内联 padding-left:6px（better-sidebar 根行样式）。 */
+        function isRootRow(el) {
+          var node = el;
+          for (var hop = 0; hop < 3 && node; hop++) {
+            var style = node.getAttribute ? node.getAttribute("style") : null;
+            if (style && /padding-left:\s*6px/i.test(String(style))) return true;
+            node = node.parentElement;
+          }
+          return false;
+        }
+        /** 单个标签替换：纯文本 + 命中镜像 basename + 位于根行 → 换成远程目录名。 */
+        function fixRootLabel(el) {
+          var text = (el.textContent || "").trim();
+          if (!text) return false;
+          var hit = rootLabels[text];
+          if (hit === undefined) {
+            // 文本已是远程目录名（上一轮替换过）→ 幂等成功；否则与本插件无关
+            return el.getAttribute && el.getAttribute("data-rssh-root-label") === "1";
+          }
+          if (el.childElementCount > 0) return false; // 只改纯文本节点
+          if (!isRootRow(el)) return false;           // 非根行（例如同名子条目）不动
+          el.textContent = hit.label;
+          if (el.setAttribute) {
+            el.setAttribute("data-rssh-root-label", "1");
+            el.setAttribute("title", hit.remotePath); // 悬停可见完整远程路径
+          }
+          watchRootLabel(el);
+          return true;
+        }
+        function watchRootLabel(el) {
+          for (var i = 0; i < watchedRootLabels.length; i++) { if (watchedRootLabels[i] === el) return; }
+          watchedRootLabels.push(el);
+        }
+        function recheckRootLabels() {
+          for (var i = watchedRootLabels.length - 1; i >= 0; i--) {
+            var el = watchedRootLabels[i];
+            if (!el || !el.isConnected) { watchedRootLabels.splice(i, 1); continue; }
+            fixRootLabel(el);
+          }
+        }
+        function applyRootLabelsIn(root) {
+          if (!root || !root.querySelectorAll) return;
+          try {
+            var nodes = root.querySelectorAll("span,div");
+            for (var i = 0; i < nodes.length; i++) fixRootLabel(nodes[i]);
+            if (root.nodeType === 1) fixRootLabel(root);
+          } catch (e) {}
+        }
         ctx.effect(function () {
           if (typeof document === "undefined") return;
           applyRemoteNavIcon();
           refreshRemoteTitles();
           var titleTimer = setInterval(refreshRemoteTitles, 30000);
-          var recheckTimer = setInterval(recheckWatched, 1000); // 抵消 React 属性还原
+          var recheckTimer = setInterval(function () { recheckWatched(); recheckRootLabels(); }, 1000); // 抵消 React 属性还原
           var timer = null;
           var pendingRoots = null;
           var schedule = function (root) {
@@ -1265,13 +1340,14 @@ window.__ModuleLoader__.load({
               if (document.hidden) return; // 后台页签零开销
               if (roots && roots.length) {
                 // 只扫新增子树：流式聊天期间不做全文档扫描（稳态成本≈0）
-                // （设置导航图标已在 MutationObserver 回调里同步替换，这里只补工作区角标）
+                // （设置导航图标与树根标签已在 MutationObserver 回调里同步替换，这里只补工作区角标）
                 for (var i = 0; i < roots.length; i++) {
                   if (roots[i].isConnected) swapWorkspaceIconsIn(roots[i]);
                 }
               } else {
                 applyRemoteNavIcon(); // 语言切换等无根场景全量扫一次
                 swapWorkspaceIconsIn(document.body);
+                applyRootLabelsIn(document.body);
               }
             }, 500);
           };
@@ -1283,7 +1359,11 @@ window.__ModuleLoader__.load({
                 // 设置导航图标：同步原位替换。MutationObserver 回调是微任务，
                 // 在浏览器绘制前执行 —— 齿轮刚插入 DOM 就被换成显示器图标，
                 // 用户看到的第一帧就是最终图标（2.4.2 修复齿轮闪现）。
-                if (node && node.nodeType === 1 && node.isConnected) checkCellIn(node);
+                if (node && node.nodeType === 1 && node.isConnected) {
+                  checkCellIn(node);
+                  // 树根标签同样同步替换：微任务内、绘制前完成，避免先闪一下镜像目录 ID
+                  applyRootLabelsIn(node);
+                }
                 // 工作区地球角标依赖异步 remoteTitles，仍走防抖批量路径
                 schedule(node);
               }
@@ -1298,7 +1378,7 @@ window.__ModuleLoader__.load({
             clearInterval(titleTimer);
             clearInterval(recheckTimer);
           };
-        }, "dsh-remote-ssh: settings nav monitor icon + remote workspace folder-globe icon");
+        }, "dsh-remote-ssh: settings nav monitor icon + tree root label + remote workspace folder-globe icon");
       }
 
       // better-sidebar 0.15+ 的文件上传 UI 把原始字节流 POST 到 /sidebar/upload。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhangfengshun/dsh-remote-ssh",
-  "version": "2.4.5",
+  "version": "2.4.6",
   "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",