@zhangfengshun/dsh-remote-ssh 2.4.4 → 2.4.6

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 本文件的版本号与 `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` 并追加远程命令：
+  - `~`/`~/x` 的展开交给**远端** shell（`$HOME/...`）——本地 homedir 与远程不同，本地展开必错；
+  - `cd … 2>/dev/null || cd "$HOME"`：目标目录被删/改名时回退，终端仍可打开；
+  - `exec "${SHELL:-/bin/bash}" -l`：尊重远端登录 shell（zsh/fish 等），保持单进程与退出码语义；
+  - 无 `remotePath` 的旧标记文件不追加命令，行为与 2.4.5 之前完全一致（向后兼容）。
+- **密码认证的远程工作区现在会明确提示**：集成终端仅支持密钥认证，此前静默回退为本地 shell，用户会误以为已连上远程；现在向 stderr 打印中英双语提示（本地工作区与密钥认证路径不受影响）。
+
+### 测试
+- 新增 `tests/wrapper-terminal.test.mjs`：从 `lib/index.js` 提取**真实**的 wrapper 生成文本，用 CJS runner 桩掉 `child_process` 后捕获实际 spawn argv，覆盖 5 组场景（`~/子路径`、`~`、绝对路径、无 remotePath、非密钥认证）共 16 条断言。
+
 ## [2.4.4] — 文档结构补全（README 代码示例 / 兼容性矩阵 / 故障排查）
 ### 文档
 - **新增「代码示例」章节**（中英双语）：6 组可直接照抄的示例——远程命令（含 `timeoutMs`）、文件读写、长时任务与挂起恢复（`timeoutMs: 0` / `remote_ssh_kill`）、远程工作区内的免参调用、`~/.ssh/config` 导入、镜像 sync/push，并给出真实返回值形状。

package/README.md

@@ -12,7 +12,7 @@
 | --- | --- |
 | 🔌 SSH 连接 | 密钥 / 密码认证，ProxyJump 跳板机，`~/.ssh/config` 一键导入 |
 | 📂 远程文件 | 内置「文件」页签直接 SSH 读写远程文件，无需同步 |
-| 💻 远程终端 | 内置「终端」页签自动检测远程工作区，SSH 交互式终端 |
+| 💻 远程终端 | 内置「终端」页签自动检测远程工作区，SSH 交互式终端，**落在工作区对应的远程目录**（与 VSCode Remote-SSH 一致） |
 | 🌐 远程工作区 | 选择远程目录创建原生工作区，一键进入远程环境 |
 | 🤖 模型工具 | 13 个 `remote_ssh_*` 工具，会话感知免填连接参数；命令级超时 + `remote_ssh_kill` 兜底恢复 |
 | ⚡ 打开提速 | 单往返合并读 + raw 文本快路径 + 结果缓存（LRU + 5s TTL）：首开 ≈**1.31×**，TTL 内重复打开 **0 往返**，过期复验 **≈5×**（真实超算实测）；`remote_ssh_exec` 连接复用 **≈15×** |
@@ -45,7 +45,7 @@
 **一条命令安装**（无需 token、API Key 或额外配置）：
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.4
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.6
 ```
 
 安装后**重启 DSH**。`@zhangfengshun/dsh-remote-ssh` 必须在 bundles 列表中排在 `dsh-better-sidebar` **之后**。
@@ -64,7 +64,7 @@ dsh plugin --profile <name> remove @zhangfengshun/dsh-remote-ssh
 
 1. **设置 → 远程连接** → 添加连接（主机 / 端口 / 用户 / 密钥）→ 点「测试连接」验证；已有 `~/.ssh/config` 可直接一键导入
 2. **添加工作区** → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录（该目录会成为原生 DSH 工作区）
-3. 进入该工作区会话：内置「文件」页签直接显示远程文件（编辑保存直写远程），「终端」页签自动 SSH 到远程主机（仅密钥认证）
+3. 进入该工作区会话：内置「文件」页签直接显示远程文件（编辑保存直写远程），「终端」页签自动 SSH 到该工作区的**远程目录**（仅密钥认证）
 
 **会话内直接对模型说**（远程工作区会话中免填连接参数）：
 
@@ -185,7 +185,9 @@ dsh plugin --profile <name> remove @zhangfengshun/dsh-remote-ssh
 | 「测试连接」报 `Permission denied (publickey)` | ① 私钥**带口令**：插件以批处理模式运行（`BatchMode=yes`），无法交互输口令——先用 `ssh-add` 加载，或去掉密钥口令；② Windows host 且用户在 Administrators 组时，公钥须写入 `C:\ProgramData\ssh\administrators_authorized_keys`；③ 用户名的写法（`user` / `.\user` / `user@domain`）要与手动连接一致 |
 | 从 git-bash 启动 `dsh web` 后密钥认证失败 | 2.3.9 起已修复：Windows 下 ssh 解析固定为系统 OpenSSH 绝对路径（此前会误用 Git 自带的 MSYS2 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` 交互式通道，**仅支持密钥认证**；密码认证请改用「文件」页签与模型工具 |
+| 内置「终端」页签连不上 | 终端为 `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

@@ -12,7 +12,7 @@ A **DSH** plugin like **VSCode Remote-SSH**: connect to remote HPC / servers via
 | --- | --- |
 | 🔌 SSH Connection | Key / password auth, ProxyJump bastion, one-click import from `~/.ssh/config` |
 | 📂 Remote Files | Built-in **Files** tab reads/writes remote files directly via SSH — no sync needed |
-| 💻 Remote Terminal | Built-in **Terminal** tab auto-detects remote workspaces, opens SSH interactive shell |
+| 💻 Remote Terminal | Built-in **Terminal** tab auto-detects remote workspaces, opens an SSH interactive shell **in the workspace's remote directory** (like VSCode Remote-SSH) |
 | 🌐 Remote Workspace | Select a remote directory to create a native workspace, one-click enter |
 | 🤖 Model Tools | 13 `remote_ssh_*` tools, session-aware with auto-filled connection params; command-level timeout + `remote_ssh_kill` recovery |
 | ⚡ Faster Opens | Single-roundtrip merged reads + raw text fast path + result cache (LRU + 5s TTL): first open ≈**1.31×**, repeat opens within TTL **0 round-trips**, expired revalidation **≈5×** (measured on a real HPC); `remote_ssh_exec` connection reuse **≈15×** |
@@ -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.4
+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.
@@ -64,7 +64,7 @@ dsh plugin --profile <name> remove @zhangfengshun/dsh-remote-ssh
 
 1. **Settings → Remote SSH** → Add a connection (host / port / user / key) → Click "Test Connection"; an existing `~/.ssh/config` can be imported in one click
 2. **Add Workspace** → Choose "Select Remote Directory…" → Pick a connection → Browse and select a remote directory (it becomes a native DSH workspace)
-3. Inside that workspace session: the built-in **Files** tab shows remote files (edits save straight back to remote), and the **Terminal** tab auto-SSHes to the host (key auth only)
+3. Inside that workspace session: the built-in **Files** tab shows remote files (edits save straight back to remote), and the **Terminal** tab auto-SSHes **into the workspace's remote directory** (key auth only)
 
 **Just ask the model** (connection params are auto-filled inside a remote-workspace session):
 
@@ -185,7 +185,9 @@ The plugin never patches DSH sources or injects into the profile dependency tree
 | "Test Connection" reports `Permission denied (publickey)` | ① key has a **passphrase**: the plugin runs in batch mode (`BatchMode=yes`) and cannot prompt — load it with `ssh-add` first, or strip the passphrase; ② on a Windows host where the user is in Administrators, the public key must go to `C:\ProgramData\ssh\administrators_authorized_keys`; ③ the username spelling (`user` / `.\user` / `user@domain`) must match a manual connection |
 | Key auth fails after launching `dsh web` from git-bash | Fixed in 2.3.9: on Windows the ssh binary is pinned to the system OpenSSH absolute path (previously Git's MSYS2 ssh was picked up) |
 | 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**; use the Files tab and the model tools for password auth |
+| 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/lib/index.js

@@ -1947,8 +1947,9 @@ function apply(ctx, config) {
   });
 
   // ---- 创建 shell wrapper（供 better-sidebar 的 shell 配置指向它，实现远程终端透明接入）----
-  // wrapper 逻辑：读取当前工作目录下的 .remote-ssh.json，若存在且含 keyPath → exec ssh -tt；
-  // 否则降级到平台默认 shell（bash -l / powershell）。
+  // wrapper 逻辑：读取当前工作目录下的 .remote-ssh.json，若存在且含 keyPath → exec ssh -tt
+  // （并把终端 cd 到该工作区的 remotePath，与 VSCode Remote-SSH 行为一致）；
+  // 否则降级到平台默认 shell（bash -l / powershell）——远程工作区但非密钥认证时打一行提示。
   // 实现方式：跨平台 Node.js 脚本 + 平台特定的薄壳调用它。
   const wrapperDir = join(homedir(), ".dsh", "remote-ssh");
   const isWin = process.platform === "win32";
@@ -1971,10 +1972,23 @@ function apply(ctx, config) {
     "      // ExitOnForwardFailure=no：ssh config 里的 RemoteForward 端口被占时终端仍能打开",
     "      const args = ['-tt', '-o', 'StrictHostKeyChecking=no', '-o', 'ExitOnForwardFailure=no', '-p', String(port), '-i', j.keyPath, j.user + '@' + j.host];",
     "      if (j.proxyJump) { args.splice(2, 0, '-J', j.proxyJump); }",
+    "      // 终端落在工作区对应的远程目录（issue #7：此前不带远程命令，落点是远程 $HOME）。",
+    "      // remotePath 的 ~ 必须交给【远端】shell 展开——本地 homedir 与远程不同，本地展开必错；",
+    "      // cd 失败（目录被删/改名）回退 $HOME，保证终端仍能打开；",
+    "      // exec 让远端只留一个交互式登录 shell，退出码语义与之前一致。",
+    "      const remotePath = typeof j.remotePath === 'string' ? j.remotePath.trim() : '';",
+    "      if (remotePath !== '') {",
+    "        const expanded = remotePath === '~' ? '$HOME' : (remotePath.indexOf('~/') === 0 ? '$HOME/' + remotePath.slice(2) : remotePath);",
+    "        args.push('cd \"' + expanded + '\" 2>/dev/null || cd \"$HOME\"; exec \"${SHELL:-/bin/bash}\" -l');",
+    "      }",
     "      const ssh = spawn(sshBin, args, { stdio: 'inherit' });",
     "      ssh.on('exit', function(c) { process.exit(c == null ? 0 : c); });",
     "      return;",
     "    }",
+    "    // 远程工作区但该连接不是密钥认证（如密码认证，keyPath 为空）：集成终端仅支持",
+    "    // 密钥认证，这里显式提示一行，避免用户把本地 shell 误认为已连上远程。",
+    "    process.stderr.write('[dsh-remote-ssh] 检测到远程工作区，但该连接不是密钥认证：集成终端仅支持密钥认证，已回退为本地 shell。\\n');",
+    "    process.stderr.write('[dsh-remote-ssh] remote workspace detected, but this profile is not key-authenticated; the integrated terminal only supports key auth and fell back to a local shell.\\n');",
     "  }",
     "} catch (e) {}",
     "// 默认本地 shell",

package/package.json

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