@zhangfengshun/dsh-remote-ssh 2.4.8 → 2.4.9

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [2.4.9] — 「添加工作区」目录选择器支持新建目录（issue #11）
+### 新增
+- **「添加工作区」弹窗的目录选择器新增「新建目录」**（感谢 @Linhaojing 的定位与接线建议）：此前本地 / 远程两个 tab 都只有「打开 / 上级 / 选择此目录」，要把**尚不存在**的目录加为工作区（例如远端起新项目 `~/lhj/new-project`）必须先跳出 DSH 用别的终端 `mkdir`。现在底部操作区多一个「📁 新建目录」按钮：点开输入行 → 填名字（回车即提交）→ 在当前 `path` 下创建 → **自动进入新目录**，紧接着点「选择此目录」即可成为工作区，全程不离开 DSH（对齐 VSCode「新建文件夹」的交互预期）。
+  - **两个 tab 都支持**：远程走既有 `api("mkdir")`（`mkdir -p` + 缓存失效，与远程资源管理器的「新建目录」同一条已验证链路）；本地新增宿主 API `mkdirLocal`（`fs.mkdir(recursive)`），补齐此前本地侧完全没有入口的缺口；
+  - **名字校验**：只接受单个路径段——空名、`.`、`..`、含 `/` 或 `\` 一律拦截并给出中英文提示（避免「在 path 下新建」变成任意位置写入）；
+  - **路径拼接**：`joinChild()` 沿用基路径的分隔符（POSIX `/`、Windows `\`，含 `C:\` 根与 `~` 前缀），不改变远端路径语义；
+  - **失败与异常都不影响弹窗**：后端报错（如远端只读）展示原文且不跳转；Promise 异常被捕获；提交中按钮禁用并显示「处理中…」。
+
+### 测试
+- 新增 `tests/dir-picker-newdir.test.mjs`（**48 条断言**）：名字校验（空/空白/`.`/`..`/含分隔符/中文/含点号）、路径拼接（POSIX、尾部多分隔符、空基路径、根路径、`~`、Windows 反斜杠、盘符根、非 ASCII）、**组件行为**（提取 DirPicker 里真实的 `submitNewDir` 逻辑注入桩状态：非法名不调用 createFn、成功进入新目录、后端未回 path 时回退 joinChild、失败不跳转、异常被捕获、未进入新建状态时 no-op）、以及接线断言（两个 tab 都传 createFn、远程/本地分流、宿主 `mkdirLocal` 用 recursive mkdir、5 个 i18n 键中英齐全）。
+
 ## [2.4.8] — 修复大仓里 `@` 补全不可用：索引排除必须发生在截断之前（issue #10 实测反馈）
 ### 修复
 - **根因**：2.4.7 的索引命令在 git 分支里是 `git ls-files … | head -n 20001 | sed …`——**先截断、后排除**（排除原本只在客户端 `refParseIndexOutput` 里做）。而 `git ls-files --cached --others` 的输出**不是全局字典序**：未跟踪文件按 readdir 顺序先输出，`node_modules/` 这类目录可能占满前两万行。实测报告者的仓库 node_modules 有 **18,880 条（84.5%）**，把 `head` 配额吃掉 94%，`AGENTS.md` 落在第 **20417** 行被整段切掉，`src/**`（1,742 个文件）同样全部缺失——症状是 `@AGENTS` 搜不到、返回一堆 pip 内部目录（命中 300 分子序列分支）。

package/README.md

@@ -46,7 +46,7 @@
 **一条命令安装**（无需 token、API Key 或额外配置）：
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.8
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.9
 ```
 
 安装后**重启 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 工作区）
+2. **添加工作区** → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录（该目录会成为原生 DSH 工作区）；目录还不存在时点「📁 新建目录」就地创建（本地 / 远程 tab 均支持），创建后自动进入新目录
 3. 进入该工作区会话：内置「文件」页签直接显示远程文件（编辑保存直写远程），「终端」页签自动 SSH 到该工作区的**远程目录**（仅密钥认证）
 
 **会话内直接对模型说**（远程工作区会话中免填连接参数）：
@@ -201,6 +201,7 @@ dsh plugin --profile <name> remove @zhangfengshun/dsh-remote-ssh
 | 「文件」页签树根显示镜像目录 ID（如 `wmu3sxe24jpvg`） | 2.4.6 起已修复：树根改为显示**远程目录名**（如 `IB_Robot`），悬停可见完整远程路径；该标签不经过 `fs.*` 路由，由客户端渲染层替换 |
 | `@` 补全只搜到镜像里那几个文件 | 2.4.7 起已修复：远程工作区会话的 `@` 补全改列远端文件（索引缓存 60s + 900ms 查询预算）；若仍只有镜像文件，确认 2.4.7 已装入并重启 DSH |
 | 大仓里 `@` 搜不到真实文件（如根目录 `AGENTS.md`、`src/**`） | 2.4.8 起已修复：此前排除目录发生在截断之后，`node_modules/` 这类目录会吃光索引配额；现在排除由远端 `grep`/`-prune` 在截断前完成，并会在索引达上限时打 warn 提示 |
+| 想加的远程目录还不存在，「添加工作区」里没法创建 | 2.4.9 起「目录选择器」底部有「📁 新建目录」（本地 / 远程 tab 均有）：输入名字即可就地创建并自动进入 |
 | 安装时提示 `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

@@ -46,7 +46,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.8
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.9
 ```
 
 **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
 **Three steps**
 
 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)
+2. **Add Workspace** → Choose "Select Remote Directory…" → Pick a connection → Browse and select a remote directory (it becomes a native DSH workspace); if the directory does not exist yet, click "📁 New folder" to create it in place (both the local and remote tabs) — the picker then enters it automatically
 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):
@@ -201,6 +201,7 @@ The plugin never patches DSH sources or injects into the profile dependency tree
 | 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 |
 | `@` completion only finds the few files in the mirror | Fixed in 2.4.7: in a remote-workspace session `@` now lists remote files (60s index cache + 900ms query budget); if only mirror files show up, make sure 2.4.7 is installed and DSH restarted |
 | In a large repo `@` cannot find real files (e.g. root `AGENTS.md`, `src/**`) | Fixed in 2.4.8: exclusion used to run *after* truncation, so a `node_modules/` tree could exhaust the index quota; exclusion now happens remotely (`grep`/`-prune`) before truncation, and hitting the cap logs a warning |
+| The remote directory you want does not exist yet and "Add Workspace" cannot create it | Fixed in 2.4.9: the directory picker has a "📁 New folder" button (both tabs) — type a name to create it in place and enter it automatically |
 | 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

@@ -119,6 +119,8 @@ window.__ModuleLoader__.load({
       "term.errSpawn": "启动终端失败",
       "picker.dir": "目录",
       "picker.choose": "选择此目录",
+      "picker.errNameEmpty": "目录名不能为空",
+      "picker.errNameBad": "目录名不能包含 / 或 \\，也不能是 . 或 ..",
       "flow.localTitle": "选择本地目录",
       "flow.remoteTitle": "选择远程目录",
       "flow.localDir": "本地目录",
@@ -130,6 +132,7 @@ window.__ModuleLoader__.load({
       "flow.chooseRemote": "选择远程目录…",
       "flow.backLocal": "← 选择本地目录",
       "flow.errCreate": "创建远程工作区失败",
+      "flow.errMkdir": "新建目录失败",
       "settings.importSshConfig": "从 ~/.ssh/config 导入…",
       "settings.importTitle": "导入 ~/.ssh/config 主机",
       "settings.noneFound": "未在 ~/.ssh/config 中发现可用主机",
@@ -219,6 +222,8 @@ window.__ModuleLoader__.load({
       "term.errSpawn": "Failed to start terminal",
       "picker.dir": "Directory",
       "picker.choose": "Choose this directory",
+      "picker.errNameEmpty": "Folder name cannot be empty",
+      "picker.errNameBad": "Folder name cannot contain / or \\, nor be . or ..",
       "flow.localTitle": "Select Local Directory",
       "flow.remoteTitle": "Select Remote Directory",
       "flow.localDir": "Local directory",
@@ -230,6 +235,7 @@ window.__ModuleLoader__.load({
       "flow.chooseRemote": "Choose remote directory…",
       "flow.backLocal": "← Choose local directory",
       "flow.errCreate": "Failed to create remote workspace",
+      "flow.errMkdir": "Failed to create the folder",
       "settings.importSshConfig": "Import from ~/.ssh/config…",
       "settings.importTitle": "Import ~/.ssh/config hosts",
       "settings.noneFound": "No usable hosts found in ~/.ssh/config",
@@ -777,14 +783,36 @@ window.__ModuleLoader__.load({
       return parent;
     }
 
+    // 新建目录名校验（issue #11）：返回 i18n 键，合法则返回 null。
+    // 只接受单个路径段——分隔符会让「在 path 下新建」变成任意位置写入。
+    function newDirNameError(name) {
+      var s = String(name == null ? "" : name).trim();
+      if (!s) return "picker.errNameEmpty";
+      if (s === "." || s === "..") return "picker.errNameBad";
+      if (s.indexOf("/") >= 0 || s.indexOf("\\") >= 0) return "picker.errNameBad";
+      return null;
+    }
+
+    // 把子目录名拼到基路径之后：沿用基路径的分隔符（Windows 反斜杠 / POSIX 斜杠），
+    // 并保留根路径语义（"/" + name、"C:\" + name）。
+    function joinChild(base, name) {
+      var raw = String(base == null ? "" : base);
+      var b = raw.replace(/[\/\\]+$/, "");
+      if (!b) return (raw.charAt(0) === "/" ? "/" : "") + String(name);
+      var sep = (b.indexOf("\\") >= 0 && b.indexOf("/") < 0) || /^[A-Za-z]:$/.test(b) ? "\\" : "/";
+      return b + sep + String(name);
+    }
+
     // 通用目录选择器：listFn(path) 返回 {ok, path, entries:[{name,type,path}]}。
     // resetKey 变化（如远程切换连接）时从根目录重新加载。
+    // createFn(path, name)（可选）：在当前目录下新建子目录，远程/本地由调用方分流（issue #11）。
     function DirPicker(props) {
       var t = useT();
       var [path, setPath] = React.useState("");
       var [entries, setEntries] = React.useState([]);
       var [err, setErr] = React.useState(null);
       var [loading, setLoading] = React.useState(false);
+      var [newDir, setNewDir] = React.useState(null); // { name, busy, error } | null
 
       var listFnRef = React.useRef(props.listFn);
       listFnRef.current = props.listFn;
@@ -810,6 +838,26 @@ window.__ModuleLoader__.load({
         load(path || undefined);
       }
 
+      // 在当前 path 下新建子目录（远程/本地由 createFn 分流），成功后进入该目录，
+      // 便于紧接着点「选择此目录」——对齐 VSCode「新建文件夹」的交互预期（issue #11）。
+      function submitNewDir() {
+        if (!newDir || !props.createFn) return;
+        var name = String(newDir.name || "").trim();
+        var invalid = newDirNameError(name);
+        if (invalid) { setNewDir({ name: name, busy: false, error: t(invalid) }); return; }
+        setNewDir({ name: name, busy: true, error: null });
+        Promise.resolve(props.createFn(path, name)).then(function (r) {
+          if (r && r.ok) {
+            setNewDir(null);
+            load((r && r.path) || joinChild(path, name));
+          } else {
+            setNewDir({ name: name, busy: false, error: (r && r.error) || t("common.errList") });
+          }
+        }).catch(function (e) {
+          setNewDir({ name: name, busy: false, error: String(e && e.message ? e.message : e) });
+        });
+      }
+
       // 路径栏：输入框（回车导航）+ 打开按钮（紧挨在右侧）+ 上级
       return h("div", null,
         h("div", { className: "rssh-pathbar" },
@@ -820,6 +868,16 @@ window.__ModuleLoader__.load({
           h("button", { className: "rssh-btn", onClick: open, disabled: loading }, t("common.open")),
           h("button", { className: "rssh-btn", onClick: goUp }, t("common.up"))
         ),
+        // 新建目录输入行（点底部「新建目录」按钮后出现）
+        newDir ? h("div", { className: "rssh-pathbar", style: { marginTop: 6 } },
+          h("input", { className: "rssh-input", value: newDir.name, autoFocus: true,
+            placeholder: t("ops.newDirPh"),
+            onChange: function (e) { setNewDir({ name: e.target.value, busy: false, error: null }); },
+            onKeyDown: function (e) { if (e.key === "Enter") { e.preventDefault(); submitNewDir(); } } }),
+          h("button", { className: "rssh-btn", onClick: submitNewDir, disabled: newDir.busy }, newDir.busy ? t("common.processing") : t("common.save")),
+          h("button", { className: "rssh-btn", onClick: function () { setNewDir(null); }, disabled: newDir.busy }, t("common.close"))
+        ) : null,
+        newDir && newDir.error ? h("div", { className: "rssh-err" }, newDir.error) : null,
         loading ? h("div", { className: "rssh-muted" }, t("common.loading")) : null,
         err ? h("div", { className: "rssh-err" }, err) : null,
         // 当前路径下的文件树（仅目录可进入）
@@ -832,7 +890,10 @@ window.__ModuleLoader__.load({
             })
         ),
         h("div", { className: "rssh-actions", style: { marginTop: 8 } },
-          h("button", { className: "rssh-btn", disabled: !path || props.disabled, onClick: function () { props.onChoose(path); } }, t("picker.choose"))
+          h("button", { className: "rssh-btn", disabled: !path || props.disabled, onClick: function () { props.onChoose(path); } }, t("picker.choose")),
+          props.createFn ? h("button", { className: "rssh-btn",
+            disabled: !path || loading || props.disabled || !!(newDir && newDir.busy),
+            onClick: function () { setNewDir({ name: "", busy: false, error: null }); } }, t("ops.newDir")) : null
         )
       );
     }
@@ -882,11 +943,29 @@ window.__ModuleLoader__.load({
               profiles.map(function (p) { return h("option", { key: p.id, value: p.id }, p.name); })
             )
           ) : null,
-          // 目录选择器：远程需选好连接后才显示
+          // 目录选择器：远程需选好连接后才显示。
+          // createFn：在当前目录下新建子目录（远程走 SSH 的 mkdir -p，本地走宿主 mkdirLocal），
+          // 两个 tab 都提供——新建远程项目目录是本 issue 的痛点，本地顺手补齐（issue #11）。
           isRemote
-            ? (profileId ? h(DirPicker, { resetKey: profileId, placeholder: t("flow.remoteDir"), listFn: function (p) { return remoteListFn(profileId, p); }, onChoose: chooseRemote, disabled: creating })
+            ? (profileId ? h(DirPicker, { resetKey: profileId, placeholder: t("flow.remoteDir"),
+                 listFn: function (p) { return remoteListFn(profileId, p); },
+                 createFn: function (p, name) {
+                   var target = joinChild(p, name);
+                   return api("mkdir", { profileId: profileId, path: target }).then(function (r) {
+                     return (r && r.ok) ? { ok: true, path: target } : { ok: false, error: (r && r.error) || t("flow.errMkdir") };
+                   });
+                 },
+                 onChoose: chooseRemote, disabled: creating })
                : h("div", { className: "rssh-pick-empty" }, t("common.selectProfile")))
-            : h(DirPicker, { resetKey: "local", placeholder: t("flow.localDir"), listFn: function (p) { return localListFn(props.workspaces, p); }, onChoose: chooseLocal })
+            : h(DirPicker, { resetKey: "local", placeholder: t("flow.localDir"),
+                listFn: function (p) { return localListFn(props.workspaces, p); },
+                createFn: function (p, name) {
+                  var target = joinChild(p, name);
+                  return api("mkdirLocal", { path: target }).then(function (r) {
+                    return (r && r.ok) ? { ok: true, path: target } : { ok: false, error: (r && r.error) || t("flow.errMkdir") };
+                  });
+                },
+                onChoose: chooseLocal })
         )
       );
     }

package/lib/index.js

@@ -1635,6 +1635,18 @@ function apply(ctx, config) {
       invalidateRemoteCaches(p, args.path, { subtree: false }); // 父目录列举变化
       return r;
     },
+    /** 本地（宿主机器）新建目录：供「添加工作区」目录选择器的**本地** tab 创建目录用（issue #11）。
+     *  远程侧走上面的 mkdir；本地侧此前没有任何入口，用户只能离开 DSH 去系统文件管理器建。 */
+    mkdirLocal: async (args) => {
+      const p = String((args && args.path) || "").trim();
+      if (!p) return { ok: false, error: "path 为必填项" };
+      try {
+        await mkdir(p, { recursive: true });
+        return { ok: true, path: p };
+      } catch (e) {
+        return { ok: false, error: "创建目录失败: " + String(e && e.message ? e.message : e) };
+      }
+    },
     deleteFile: async (args) => {
       const p = resolveProfile(args);
       if (!p) return { ok: false, error: "需要 profileId 或 host+user" };

package/package.json

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