@zhangfengshun/dsh-remote-ssh 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [1.9.3] — 修复 syncDown 删除 .remote-ssh.json 导致终端不工作
+### 修复
+- **`remoteSyncDown` 会清空镜像目录**：syncDown 先 `rm -rf` 镜像目录再 `tar xf` 展开，导致之前写入的 `.remote-ssh.json`（供 shell wrapper 读取连接信息）被删掉，终端 wrapper 检测不到远程工作区，降级到本地 shell。
+- **修复**：在 `createRemoteWorkspace`、`syncDown` API、`remote_ssh_sync` 工具三处，都在 `remoteSyncDown` 完成后重新写入 `.remote-ssh.json`。
+- 已为现有工作区补写 `.remote-ssh.json`（无需重新创建工作区）。
+
+## [1.9.2] — 修复自动配置 patch 不生效（bundles 顺序）
+### 修复
+- **config 覆盖被跳过**：`cordis.patch.yml` 中的 `id: better-sidebar` config 覆盖需要在 `better-sidebar` 条目被 insert 之后才能生效。如果 `@zhangfengshun/dsh-remote-ssh` 在 bundles 列表中排在 `dsh-better-sidebar` 之前，patch 会因"entry not found"被跳过。
+- **修复方式**：在 README 中明确要求安装顺序（`@zhangfengshun/dsh-remote-ssh` 必须在 `dsh-better-sidebar` 之后），并提供手动调整 `profile/package.json` 中 `dsh.profile.bundles` 顺序的说明。
+
 ## [1.9.1] — 安装时自动配置 better-sidebar shell
 ### 改进
 - **安装即生效**：`cordis.patch.yml` 新增 `id: better-sidebar` 的 `config.shell` 覆盖，用 `!!js` 动态计算 wrapper 脚本路径（适配不同平台和用户主目录）。安装插件后无需手动编辑任何配置文件，重启 DSH 即可使用远程终端透明接入。

package/README.md

@@ -29,10 +29,12 @@ dsh plugin --profile <name> add /absolute/path/to/dsh-remote-ssh
 ### 发布后安装
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@1.9.1
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@1.9.3
 ```
 
 > ⚠️ 安装后需**重启 DSH** 才生效；后续仅修改 Client 半边时刷新浏览器即可。
+>
+> ⚠️ **安装顺序**：本插件会自动覆盖 `dsh-better-sidebar` 的 `shell` 配置。为确保 patch 生效（config 覆盖在 insert 之后应用），`@zhangfengshun/dsh-remote-ssh` 必须在 bundles 列表中排在 `dsh-better-sidebar` **之后**。如果先安装了 `@zhangfengshun/dsh-remote-ssh`，再安装 `dsh-better-sidebar`，需手动调整 `profile/package.json` 中 `dsh.profile.bundles` 的顺序，把 `@zhangfengshun/dsh-remote-ssh` 移到最后。
 
 ## 快速开始
 

package/cordis.patch.yml

@@ -13,9 +13,10 @@
 - id: better-sidebar
   config:
     shell: !!js |
-      var os = require('os');
-      var path = require('path');
-      var dir = path.join(os.homedir(), '.dsh', 'remote-ssh');
-      var isWin = process.platform === 'win32';
-      var wrapper = isWin ? path.join(dir, 'dsh-remote-shell.cmd') : path.join(dir, 'dsh-remote-shell');
-      return wrapper;
+      (() => {
+        var homedir = process.env.USERPROFILE || process.env.HOME || process.env.HOMEDRIVE + process.env.HOMEPATH;
+        var isWin = process.platform === 'win32';
+        var sep = isWin ? '\\' : '/';
+        var dir = homedir + sep + '.dsh' + sep + 'remote-ssh';
+        return isWin ? dir + sep + 'dsh-remote-shell.cmd' : dir + sep + 'dsh-remote-shell';
+      })()

package/lib/index.js

@@ -819,7 +819,13 @@ function apply(ctx, config) {
       try {
         await writeFile(join(mirrorDir, "README.md"), remoteWorkspaceReadme(p.name, a.remotePath), "utf8");
       } catch (e) {}
+      // 自动同步：把远程文件拉到本地镜像，使内置「文件」页签可见真实远程文件。
+      // 注意：remoteSyncDown 会先清空镜像目录，所以 .remote-ssh.json 必须在同步之后写。
+      try {
+        await remoteSyncDown(subprocess, p, a.remotePath, mirrorDir);
+      } catch (e) {}
       // 写 .remote-ssh.json：供 shell wrapper 读取连接信息（仅密钥认证，不含密码）。
+      // 必须在 remoteSyncDown 之后写，否则会被同步过程清空。
       try {
         const connInfo = {
           profileId: p.id, host: p.host, port: p.port || 22, user: p.user,
@@ -827,10 +833,6 @@ function apply(ctx, config) {
         };
         await writeFile(join(mirrorDir, ".remote-ssh.json"), JSON.stringify(connInfo, null, 2), "utf8");
       } catch (e) {}
-      // 自动同步：把远程文件拉到本地镜像，使内置「文件」页签可见真实远程文件。
-      try {
-        await remoteSyncDown(subprocess, p, a.remotePath, mirrorDir);
-      } catch (e) {}
       let workspaceId = null;
       if (workspaceRegistry) {
         try {
@@ -936,7 +938,18 @@ function apply(ctx, config) {
       if (!ws) return { ok: false, error: "未找到远程工作区" };
       const p = getProfile(ws.profileId);
       if (!p) return { ok: false, error: "未找到连接配置" };
-      return await remoteSyncDown(subprocess, p, ws.remotePath, ws.mirrorPath);
+      const r = await remoteSyncDown(subprocess, p, ws.remotePath, ws.mirrorPath);
+      // remoteSyncDown 会清空镜像目录，需要重新写入 .remote-ssh.json
+      if (r.ok) {
+        try {
+          const connInfo = {
+            profileId: p.id, host: p.host, port: p.port || 22, user: p.user,
+            keyPath: p.keyPath || "", proxyJump: p.proxyJump || "", remotePath: ws.remotePath
+          };
+          await writeFile(join(ws.mirrorPath, ".remote-ssh.json"), JSON.stringify(connInfo, null, 2), "utf8");
+        } catch (e) {}
+      }
+      return r;
     },
     /** 本地镜像 → 远端（按工作区）。 */
     syncUp: async (args) => {
@@ -1168,7 +1181,18 @@ function apply(ctx, config) {
       if (!ws) return { ok: false, error: "未找到远程工作区（workspaceId 必填，或当前会话非远程工作区）" };
       const p = getProfile(ws.profileId);
       if (!p) return { ok: false, error: "未找到连接配置" };
-      return await remoteSyncDown(subprocess, p, ws.remotePath, ws.mirrorPath);
+      const r = await remoteSyncDown(subprocess, p, ws.remotePath, ws.mirrorPath);
+      // remoteSyncDown 会清空镜像目录，需要重新写入 .remote-ssh.json
+      if (r.ok) {
+        try {
+          const connInfo = {
+            profileId: p.id, host: p.host, port: p.port || 22, user: p.user,
+            keyPath: p.keyPath || "", proxyJump: p.proxyJump || "", remotePath: ws.remotePath
+          };
+          await writeFile(join(ws.mirrorPath, ".remote-ssh.json"), JSON.stringify(connInfo, null, 2), "utf8");
+        } catch (e) {}
+      }
+      return r;
     }
   });
   register({

package/package.json

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