@zhangfengshun/dsh-remote-ssh 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [1.6.0] — 远程搜索与文件操作工具
+### 新增
+- **内容搜索 `remote_ssh_grep`**：在远端递归搜索文件内容（`grep -rnIE`，扩展正则），支持 `include` 文件名过滤（如 `*.py`）、`ignoreCase` 忽略大小写、`maxResults` 限流（默认 200）。借鉴 dsh-remote / dsh-remote-ssh 的远程搜索，但用通用 GNU grep（超算/Linux 通用，不依赖 ripgrep）。
+- **文件名查找 `remote_ssh_glob`**：按通配符查找远程文件（`find -name`，递归），自动剥离前导 `**/` 以适配 POSIX find。
+- **创建目录 `remote_ssh_mkdir`**：`mkdir -p`（含父目录）。
+- **删除 `remote_ssh_delete`**：删除远程文件或目录（`rm -rf`，递归不询问，⚠️ 不可恢复）。
+- **移动/重命名 `remote_ssh_move`**：`mv` 移动或重命名文件/目录。
+- 上述 5 个工具均会话感知：在远程工作区会话中免填 `profileId`，相对路径基于工作区远程目录解析。
+- 「远程文件」页签新增操作栏（选中工作区或连接时显示）：🔍 搜索 / 按名查找 / 新建目录 / 重命名移动 / 删除，均以弹窗形式执行并就地显示结果。
+- 远程工作区镜像目录的 `README.md` 补全新增工具说明。
+
 ## [1.5.0] — 导入 OpenSSH 配置 + 双向同步
 ### 新增
 - **从 `~/.ssh/config` 导入连接**：设置小节「从 ~/.ssh/config 导入…」按钮读取本机 OpenSSH 用户配置（递归解析 `Include`），多选主机后批量导入为连接配置（`HostName` / `User` / `Port` / `IdentityFile` / `ProxyJump` 一并带入）。借鉴 Yan-Zero `dsh-remote-ssh`，免去逐条手动录入。

package/README.md

@@ -14,7 +14,7 @@
 | 💻 远程终端 | 在 better-sidebar「远程终端」页签打开 `ssh -tt` 集成终端，支持多终端并发 |
 | 🔄 双向同步 | `remote_ssh_sync`（远端 → 本地镜像）/ `remote_ssh_push`（本地镜像 → 远端），tar 流式管道，同步后内置文件工具可见 |
 | 🌐 远程工作区 | 选择远程目录创建**原生工作区**（本地镜像目录 + 原生注册），一键打开进入远程环境 |
-| 🤖 模型工具 | 7 个 `remote_ssh_*` 工具，模型可读写远程文件、执行远程命令、双向同步；在远程工作区会话中免填连接参数 |
+| 🤖 模型工具 | 12 个 `remote_ssh_*` 工具，模型可读写远程文件、执行远程命令、内容搜索、文件名查找、目录/删除/移动、双向同步；在远程工作区会话中免填连接参数 |
 | 🌍 国际化 | 界面文案 + 工具描述中英双语，通过 `ctx.locale` 跟随 DSH 语言设置自动切换 |
 | 🧠 会话记忆 | 切换会话后，「远程文件」「远程终端」页签记住已选连接、浏览目录、打开的文件与终端 |
 
@@ -29,7 +29,7 @@ dsh plugin --profile <name> add /absolute/path/to/dsh-remote-ssh
 ### 发布后安装
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@1.5.0
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@1.6.0
 ```
 
 > ⚠️ 安装后需**重启 DSH** 才生效；后续仅修改 Client 半边时刷新浏览器即可。
@@ -90,6 +90,11 @@ dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@1.5.0
 | `remote_ssh_write` | 写入远程文件（覆盖写入） |
 | `remote_ssh_sync` | 远端文件同步到本地镜像目录（tar 流式管道） |
 | `remote_ssh_push` | 本地镜像目录推送回远端（tar 流式管道） |
+| `remote_ssh_grep` | 递归搜索远程文件内容（grep -rnIE，支持 include/ignoreCase） |
+| `remote_ssh_glob` | 按通配符查找远程文件（find -name，递归） |
+| `remote_ssh_mkdir` | 创建远程目录（mkdir -p） |
+| `remote_ssh_delete` | 删除远程文件或目录（rm -rf，⚠️ 不可恢复） |
+| `remote_ssh_move` | 移动/重命名远程文件或目录（mv） |
 
 **会话感知**：当会话是从远程工作区创建时，模型调用这些工具可**不填** `profileId` / `host` / `user` 等连接参数，自动复用该工作区的连接，相对路径基于该工作区远程目录解析。
 
@@ -116,7 +121,7 @@ dsh-remote-ssh/
 │  · 远程文件 / 远程终端        │ ◀────── │  · SSH：listDir/readFile/…       │
 │ ctx.slots: settings.section   │  JSON   │  · settings：profiles/workspaces  │
 │  · DSH 设置页「远程连接」      │         │  · terminals：ssh -tt 管道        │
-└───────────────────────────────┘         │ ctx.tools：7 个 remote_ssh_*     │
+└───────────────────────────────┘         │ ctx.tools：12 个 remote_ssh_*    │
                                           └───────────────┬──────────────────┘
                                                           │ SSH
                                                      远程超算 / 服务器

package/lib/client.js

@@ -126,7 +126,25 @@ window.__ModuleLoader__.load({
       "sync.syncing": "同步中…",
       "sync.pushing": "推送中…",
       "sync.done": "同步完成",
-      "sync.fail": "同步失败"
+      "sync.fail": "同步失败",
+      "ops.search": "🔍 搜索",
+      "ops.find": "按名查找",
+      "ops.searchPh": "正则或关键词…",
+      "ops.globPh": "*.py",
+      "ops.newDir": "📁 新建目录",
+      "ops.newDirPh": "目录名",
+      "ops.rename": "✏ 重命名/移动",
+      "ops.renamePh": "目标路径",
+      "ops.delete": "🗑 删除",
+      "ops.confirmDel": "确认删除远程文件/目录？（不可恢复）",
+      "ops.grepTitle": "远程内容搜索 (grep)",
+      "ops.globTitle": "按文件名查找 (glob)",
+      "ops.mkdirTitle": "新建远程目录",
+      "ops.moveTitle": "移动/重命名",
+      "ops.deleteTitle": "删除远程文件/目录",
+      "ops.noMatch": "无匹配",
+      "ops.done": "操作完成",
+      "ops.fail": "操作失败"
     };
     var en = {
       "tabs.files": "Remote Files",
@@ -202,7 +220,25 @@ window.__ModuleLoader__.load({
       "sync.syncing": "Syncing…",
       "sync.pushing": "Pushing…",
       "sync.done": "Sync complete",
-      "sync.fail": "Sync failed"
+      "sync.fail": "Sync failed",
+      "ops.search": "🔍 Search",
+      "ops.find": "Find by name",
+      "ops.searchPh": "regex or keyword…",
+      "ops.globPh": "*.py",
+      "ops.newDir": "📁 New dir",
+      "ops.newDirPh": "dir name",
+      "ops.rename": "✏ Rename/Move",
+      "ops.renamePh": "target path",
+      "ops.delete": "🗑 Delete",
+      "ops.confirmDel": "Confirm delete remote file/dir? (irreversible)",
+      "ops.grepTitle": "Remote content search (grep)",
+      "ops.globTitle": "Find by name (glob)",
+      "ops.mkdirTitle": "Create remote directory",
+      "ops.moveTitle": "Move/Rename",
+      "ops.deleteTitle": "Delete remote file/dir",
+      "ops.noMatch": "No match",
+      "ops.done": "Done",
+      "ops.fail": "Operation failed"
     };
     var i18n = {
       t: function (key) { return key; },
@@ -273,6 +309,63 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // ======================================================================
+    // 远程操作弹窗（grep / glob / mkdir / move / delete）
+    // ======================================================================
+    function OpsModal(props) {
+      var d = props.opsDlg;
+      var t = props.t;
+      var patchOps = props.patchOps;
+      var runOps = props.runOps;
+      var title = ({
+        grep: t("ops.grepTitle"), glob: t("ops.globTitle"), mkdir: t("ops.mkdirTitle"),
+        move: t("ops.moveTitle"), delete: t("ops.deleteTitle")
+      })[d.type] || "";
+      var isGrep = d.type === "grep";
+      var isGlob = d.type === "glob";
+      var isMove = d.type === "move";
+      var isDel = d.type === "delete";
+      // 结果渲染
+      var resultEl = null;
+      if (d.result) {
+        var r = d.result;
+        if (isGrep) {
+          var ms = r.matches || [];
+          resultEl = h("div", { style: { maxHeight: 260, overflow: "auto", marginTop: 8, fontSize: 11, whiteSpace: "pre-wrap", fontFamily: "monospace" } },
+            !r.ok ? h("div", { className: "rssh-err" }, r.error || t("ops.fail")) :
+            ms.length === 0 ? h("div", { className: "rssh-muted" }, t("ops.noMatch")) :
+            ms.map(function (m, i) { return h("div", { key: i }, m.file + ":" + m.line + ": " + m.content); }),
+            r.truncated ? h("div", { className: "rssh-muted" }, "…") : null
+          );
+        } else if (isGlob) {
+          var fs2 = r.files || [];
+          resultEl = h("div", { style: { maxHeight: 260, overflow: "auto", marginTop: 8, fontSize: 11, whiteSpace: "pre-wrap", fontFamily: "monospace" } },
+            !r.ok ? h("div", { className: "rssh-err" }, r.error || t("ops.fail")) :
+            fs2.length === 0 ? h("div", { className: "rssh-muted" }, t("ops.noMatch")) :
+            fs2.map(function (f, i) { return h("div", { key: i }, f); })
+          );
+        } else {
+          // exec 结果（mkdir/move/delete）
+          resultEl = h("div", { style: { marginTop: 8 } },
+            r.ok ? h("div", { className: "rssh-ok" }, t("ops.done") + (r.stderr ? "  " + String(r.stderr).slice(0, 200) : "")) :
+            h("div", { className: "rssh-err" }, (r.error || r.stderr || t("ops.fail")))
+          );
+        }
+      }
+      return h(Modal, { open: true, onClose: props.close, title: title, closeLabel: t("common.close"), className: "rssh-flow-dialog" },
+        h("div", { style: { display: "flex", flexDirection: "column", gap: 6 } },
+          h("input", { className: "rssh-input", value: d.p1, onChange: function (e) { patchOps({ p1: e.target.value }); }, placeholder: isGrep ? t("ops.searchPh") : (isGlob ? t("ops.globPh") : t("ops.newDirPh")) }),
+          isGrep ? h("input", { className: "rssh-input", value: d.p2, onChange: function (e) { patchOps({ p2: e.target.value }); }, placeholder: "*.py (include)" }) : null,
+          isMove ? h("input", { className: "rssh-input", value: d.p2, onChange: function (e) { patchOps({ p2: e.target.value }); }, placeholder: t("ops.renamePh") }) : null,
+          h("div", { className: "rssh-actions" },
+            h("button", { className: "rssh-btn", onClick: runOps, disabled: d.busy }, d.busy ? t("common.processing") : (isDel ? t("ops.delete") : t("common.save"))),
+            h("button", { className: "rssh-btn", onClick: props.close, disabled: d.busy }, t("common.close"))
+          ),
+          resultEl
+        )
+      );
+    }
+
     // ======================================================================
     // 远程文件页签
     // ======================================================================
@@ -290,6 +383,7 @@ window.__ModuleLoader__.load({
       var [loading, setLoading] = React.useState(false);
       var [defaultDir, setDefaultDir] = useSessionMemory(sessionId, "defaultDir", "");
       var [syncSt, setSyncSt] = React.useState(null); // { busy, msg, ok }
+      var [opsDlg, setOpsDlg] = React.useState(null); // { type, p1, p2, result, busy }
 
       React.useEffect(function () {
         api("listWorkspaces").then(function (r) { if (r && r.ok) setWorkspaces(r.workspaces || []); });
@@ -347,6 +441,69 @@ window.__ModuleLoader__.load({
         });
       }
 
+      function activeProfileId() {
+        if (wsId) {
+          var ws = workspaces.find(function (w) { return w.id === wsId; });
+          if (ws) return ws.profileId;
+        }
+        return profileId;
+      }
+      function opsBase() {
+        if (wsId) {
+          var ws = workspaces.find(function (w) { return w.id === wsId; });
+          if (ws) return ws.remotePath || path || "~";
+        }
+        return path || "~";
+      }
+      function openOps(type) {
+        var init = { type: type, p1: "", p2: "", result: null, busy: false };
+        if (type === "mkdir") init.p1 = path ? (path.replace(/\/+$/, "") + "/") : "";
+        if (type === "move") { init.p1 = path ? (path.replace(/\/+$/, "") + "/") : ""; init.p2 = path ? (path.replace(/\/+$/, "") + "/") : ""; }
+        if (type === "delete") init.p1 = path ? (path.replace(/\/+$/, "") + "/") : "";
+        setOpsDlg(init);
+      }
+      function patchOps(patch) {
+        setOpsDlg(function (d) { var n = {}; for (var k in d) n[k] = d[k]; for (var k2 in patch) n[k2] = patch[k2]; return n; });
+      }
+      function runOps() {
+        if (!opsDlg) return;
+        var pid = activeProfileId();
+        if (!pid) { patchOps({ result: { ok: false, msg: t("ops.fail") }, busy: false }); return; }
+        var base = opsBase();
+        var d = opsDlg;
+        patchOps({ busy: true, result: null });
+        function resolveP(p) {
+          if (!p) return p;
+          var c = String(p).charAt(0);
+          if (c === "/" || c === "~") return p;
+          return base.replace(/\/+$/, "") + "/" + p;
+        }
+        if (d.type === "grep") {
+          api("grep", { profileId: pid, pattern: d.p1, path: base, include: d.p2 || undefined }).then(function (r) {
+            patchOps({ busy: false, result: r });
+          });
+        } else if (d.type === "glob") {
+          api("glob", { profileId: pid, pattern: d.p1, path: base }).then(function (r) {
+            patchOps({ busy: false, result: r });
+          });
+        } else if (d.type === "mkdir") {
+          api("mkdir", { profileId: pid, path: resolveP(d.p1) }).then(function (r) {
+            patchOps({ busy: false, result: r });
+            if (r && r.ok) { setErr(null); load(pid, path); }
+          });
+        } else if (d.type === "move") {
+          api("move", { profileId: pid, src: resolveP(d.p1), dst: resolveP(d.p2) }).then(function (r) {
+            patchOps({ busy: false, result: r });
+            if (r && r.ok) { setErr(null); load(pid, path); }
+          });
+        } else if (d.type === "delete") {
+          api("deleteFile", { profileId: pid, path: resolveP(d.p1) }).then(function (r) {
+            patchOps({ busy: false, result: r });
+            if (r && r.ok) { setErr(null); load(pid, path); }
+          });
+        }
+      }
+
       function openEntry(e) {
         var base = path ? (path.replace(/\/+$/, "") + "/" + e.name) : e.name;
         if (e.type === "directory") {
@@ -408,8 +565,16 @@ window.__ModuleLoader__.load({
             h("button", { className: "rssh-btn", onClick: function () { doSync("up"); }, disabled: syncSt && syncSt.busy }, t("sync.up")),
             syncSt ? h("span", { className: syncSt.ok === false ? "rssh-err" : (syncSt.ok ? "rssh-ok" : "rssh-muted"), style: { flex: 1, fontSize: 11 } }, syncSt.msg) : null
           ) : null,
+          (wsId || profileId) ? h("div", { className: "rssh-pathbar", style: { flexWrap: "wrap" } },
+            h("button", { className: "rssh-btn", onClick: function () { openOps("grep"); } }, t("ops.search")),
+            h("button", { className: "rssh-btn", onClick: function () { openOps("glob"); } }, t("ops.find")),
+            h("button", { className: "rssh-btn", onClick: function () { openOps("mkdir"); } }, t("ops.newDir")),
+            h("button", { className: "rssh-btn", onClick: function () { openOps("move"); } }, t("ops.rename")),
+            h("button", { className: "rssh-btn", onClick: function () { openOps("delete"); } }, t("ops.delete"))
+          ) : null,
           loading ? h("div", { className: "rssh-muted" }, t("common.loading")) : null,
-          err ? h("div", { className: "rssh-err", style: { whiteSpace: "pre-wrap" } }, err) : null
+          err ? h("div", { className: "rssh-err", style: { whiteSpace: "pre-wrap" } }, err) : null,
+          opsDlg ? h(OpsModal, { opsDlg: opsDlg, patchOps: patchOps, runOps: runOps, close: function () { setOpsDlg(null); }, t: t }) : null
         ),
         h("div", { style: { flex: 1, minHeight: 0, overflowY: "auto", marginTop: 6 } },
           entries.map(function (e) {

package/lib/index.js

@@ -259,6 +259,63 @@ async function remoteWriteFile(subprocess, p, path, content) {
   return await runRemote(subprocess, p, "cat > " + shellQuotePath(path), c, MAX_BYTES);
 }
 
+/**
+ * 在远端递归搜索文件内容（grep -rnIE）。借鉴 dsh-remote / dsh-remote-ssh 的远程内容搜索，
+ * 但用通用的 GNU grep（超算/Linux 通用），不依赖 ripgrep。
+ * exit 1 = 无匹配（ok，空结果）；exit 0 = 有匹配；exit 2 = 出错。
+ */
+async function remoteGrep(subprocess, p, pattern, path, opts) {
+  opts = opts || {};
+  const target = path || p.remoteRoot || "~";
+  const parts = ["grep", "-rnIE"];
+  if (opts.ignoreCase) parts.push("-i");
+  if (opts.include) parts.push("--include=" + String(opts.include));
+  parts.push("--", shellQuote(pattern), shellQuotePath(target));
+  const cmd = parts.join(" ");
+  const r = await runRemote(subprocess, p, cmd, undefined, MAX_BYTES);
+  if (r.exitCode === 1 || (r.ok && !r.stdout)) {
+    return { ok: true, pattern: pattern, path: target, matches: [], truncated: false, error: "" };
+  }
+  if (r.exitCode > 1 && !r.ok) {
+    const err = (r.stderr || r.error || "").trim();
+    if (err && !r.stdout) return { ok: false, pattern: pattern, path: target, matches: [], truncated: false, error: err };
+  }
+  const all = [];
+  const lines = String(r.stdout || "").split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line) continue;
+    const c1 = line.indexOf(":");
+    if (c1 < 0) { all.push({ file: line, line: 0, content: "" }); continue; }
+    const file = line.slice(0, c1);
+    const rest = line.slice(c1 + 1);
+    const c2 = rest.indexOf(":");
+    if (c2 < 0) { all.push({ file: file, line: 0, content: rest }); continue; }
+    const ln = parseInt(rest.slice(0, c2), 10);
+    all.push({ file: file, line: isNaN(ln) ? 0 : ln, content: rest.slice(c2 + 1) });
+  }
+  const max = parseInt(String(opts.maxResults || 200), 10) || 200;
+  const truncated = all.length > max || !!r.truncated;
+  const matches = all.slice(0, max);
+  return { ok: true, pattern: pattern, path: target, matches: matches, truncated: truncated, error: "" };
+}
+
+/**
+ * 在远端按 glob 模式查找文件（find -name）。find 已递归；pattern 为 basename 通配
+ * （如 .py 后缀），自动剥离前导双星号-斜杠与星号-斜杠以适配 POSIX find -name。
+ */
+async function remoteGlob(subprocess, p, pattern, path, opts) {
+  opts = opts || {};
+  const target = path || p.remoteRoot || "~";
+  let pat = String(pattern || "").trim();
+  pat = pat.replace(/^(\*\*\/|\*\/)+/, "");
+  const max = parseInt(String(opts.maxResults || 500), 10) || 500;
+  const cmd = "find " + shellQuotePath(target) + " -name " + shellQuote(pat) + " -printf '%p\\n' 2>/dev/null | sort | head -n " + max;
+  const r = await runRemote(subprocess, p, cmd, undefined, MAX_BYTES);
+  const files = String(r.stdout || "").split("\n").filter(function (s) { return !!s; });
+  return { ok: true, pattern: pattern, path: target, files: files, truncated: !!r.truncated, error: "" };
+}
+
 /**
  * tar-over-ssh 双向同步（借鉴 flymysql dsh-remote 的 SFTP 镜像同步，但复用现有 ssh.exe + tar，
  * 不引入 ssh2 依赖）。用流式管道把一条 ssh 的 stdout 喂给本地 tar 的 stdin（反之亦然），
@@ -443,6 +500,13 @@ function remoteWorkspaceReadme(profileName, remotePath) {
     "- `remote_ssh_cat`       — read a remote file / 读取远程文件",
     "- `remote_ssh_write`     — write a remote file / 写入远程文件",
     "- `remote_ssh_exec`      — run a command on the remote host (like a terminal) / 在远程执行命令",
+    "- `remote_ssh_grep`      — search file contents (recursive grep) / 递归搜索文件内容",
+    "- `remote_ssh_glob`      — find files by glob pattern / 按通配符查找文件",
+    "- `remote_ssh_mkdir`     — create a directory (mkdir -p) / 创建目录",
+    "- `remote_ssh_delete`    — delete a file or directory (rm -rf) / 删除文件或目录",
+    "- `remote_ssh_move`      — move/rename a file or directory (mv) / 移动或重命名",
+    "- `remote_ssh_sync`      — sync remote files to this local mirror / 同步远端文件到本地镜像",
+    "- `remote_ssh_push`      — push local mirror changes back to remote / 推送本地改动回远端",
     "- `remote_ssh_profiles`  — list profiles and the current remote-workspace context / 查看配置与当前上下文",
     "",
     "Workspace info / 工作区信息：",
@@ -676,6 +740,34 @@ function apply(ctx, config) {
       if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
       return await remoteWriteFile(subprocess, p, args && args.path, args && args.content);
     },
+    grep: async (args) => {
+      const p = resolveProfile(args);
+      if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
+      return await remoteGrep(subprocess, p, args && args.pattern, args && args.path, args || {});
+    },
+    glob: async (args) => {
+      const p = resolveProfile(args);
+      if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
+      return await remoteGlob(subprocess, p, args && args.pattern, args && args.path, args || {});
+    },
+    mkdir: async (args) => {
+      const p = resolveProfile(args);
+      if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
+      if (!args || !args.path) return { ok: false, error: "path 为必填项" };
+      return await runRemote(subprocess, p, "mkdir -p " + shellQuotePath(args.path), undefined, undefined);
+    },
+    deleteFile: async (args) => {
+      const p = resolveProfile(args);
+      if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
+      if (!args || !args.path) return { ok: false, error: "path 为必填项" };
+      return await runRemote(subprocess, p, "rm -rf " + shellQuotePath(args.path), undefined, undefined);
+    },
+    move: async (args) => {
+      const p = resolveProfile(args);
+      if (!p) return { ok: false, error: "需要 profileId 或 host+user" };
+      if (!args || !args.src || !args.dst) return { ok: false, error: "src 和 dst 为必填项" };
+      return await runRemote(subprocess, p, "mv " + shellQuotePath(args.src) + " " + shellQuotePath(args.dst), undefined, undefined);
+    },
     /** 远端 → 本地镜像（按工作区）。 */
     syncDown: async (args) => {
       const a = args || {};
@@ -932,6 +1024,130 @@ function apply(ctx, config) {
     }
   });
 
+  // ---- 搜索与文件操作（借鉴 dsh-remote 的 rw_grep/rw_glob/rw_mkdir/rw_delete/rw_move）----
+  // 内容搜索：grep -rnIE（GNU grep，超算/Linux 通用，不依赖 ripgrep）。
+  register({
+    name: "remote_ssh_grep",
+    description: "通过 SSH 在远程主机上递归搜索文件内容（grep -rnIE，扩展正则）。用 profileId 引用已保存配置，或直接给 host/user。在当前远程工作区会话中可不填连接参数，path 默认为工作区远程目录。可选 include 限定文件名通配（如 *.py）、ignoreCase 忽略大小写、maxResults 限制条数（默认 200）。Search file contents on a remote host over SSH (recursive grep).",
+    parameters: Object.assign({}, CONN_PARAMS, {
+      pattern: { type: "string", required: true, description: "搜索模式（grep 扩展正则）。" },
+      path: { type: "string", description: "搜索目录，默认使用工作区远程目录。" },
+      include: { type: "string", description: "文件名通配过滤，如 *.py（GNU grep --include）。" },
+      ignoreCase: { type: "boolean", description: "忽略大小写。" },
+      maxResults: { type: "number", description: "最多返回的匹配条数，默认 200。" }
+    }),
+    output: {
+      schema: {
+        type: "object", additionalProperties: false, properties: {
+          ok: { type: "boolean", required: true },
+          pattern: { type: "string", required: true },
+          path: { type: "string", required: true },
+          matches: { type: "array", required: true, items: { type: "object", additionalProperties: true } },
+          truncated: { type: "boolean", required: true },
+          error: { type: "string", required: true }
+        }
+      },
+      render: textRender(function (a, v) {
+        if (!v.ok) return v.error || "搜索失败";
+        const ms = v.matches || [];
+        if (!ms.length) return "无匹配";
+        const lines = ms.map(function (m) { return m.file + ":" + m.line + ": " + m.content; });
+        return lines.join("\n") + (v.truncated ? "\n…（已截断）" : "");
+      })
+    },
+    execute: async function (args, exec) {
+      const tc = toolContext(args, exec);
+      if (!tc.profile) return { ok: false, pattern: "", path: "", matches: [], truncated: false, error: "需要 profileId 或 host+user（当前会话非远程工作区时必填）" };
+      if (!args.pattern) return { ok: false, pattern: "", path: "", matches: [], truncated: false, error: "pattern 为必填项" };
+      const r = await remoteGrep(subprocess, tc.profile, args.pattern, resolveRemotePath(args.path, tc.remotePath), args);
+      return { ok: !!r.ok, pattern: r.pattern || args.pattern, path: r.path || "", matches: r.matches || [], truncated: !!r.truncated, error: r.error || "" };
+    }
+  });
+
+  // 文件名通配查找：find -name（已递归，自动剥离前导 **/）。
+  register({
+    name: "remote_ssh_glob",
+    description: "通过 SSH 在远程主机上按通配符查找文件（find -name，递归）。用 profileId 引用已保存配置，或直接给 host/user。在当前远程工作区会话中可不填连接参数，path 默认为工作区远程目录。pattern 为 basename 通配，如 *.py（自动剥离前导 **/ 以适配 POSIX find）。Find files by glob pattern on a remote host over SSH.",
+    parameters: Object.assign({}, CONN_PARAMS, {
+      pattern: { type: "string", required: true, description: "文件名通配，如 *.py 或 *.js。" },
+      path: { type: "string", description: "查找目录，默认使用工作区远程目录。" },
+      maxResults: { type: "number", description: "最多返回条数，默认 500。" }
+    }),
+    output: {
+      schema: {
+        type: "object", additionalProperties: false, properties: {
+          ok: { type: "boolean", required: true },
+          pattern: { type: "string", required: true },
+          path: { type: "string", required: true },
+          files: { type: "array", required: true, items: { type: "string" } },
+          truncated: { type: "boolean", required: true },
+          error: { type: "string", required: true }
+        }
+      },
+      render: textRender(function (a, v) {
+        if (!v.ok) return v.error || "查找失败";
+        const fs2 = v.files || [];
+        if (!fs2.length) return "无匹配文件";
+        return fs2.join("\n") + (v.truncated ? "\n…（已截断）" : "");
+      })
+    },
+    execute: async function (args, exec) {
+      const tc = toolContext(args, exec);
+      if (!tc.profile) return { ok: false, pattern: "", path: "", files: [], truncated: false, error: "需要 profileId 或 host+user（当前会话非远程工作区时必填）" };
+      if (!args.pattern) return { ok: false, pattern: "", path: "", files: [], truncated: false, error: "pattern 为必填项" };
+      const r = await remoteGlob(subprocess, tc.profile, args.pattern, resolveRemotePath(args.path, tc.remotePath), args);
+      return { ok: !!r.ok, pattern: r.pattern || args.pattern, path: r.path || "", files: r.files || [], truncated: !!r.truncated, error: r.error || "" };
+    }
+  });
+
+  // 创建目录：mkdir -p。
+  register({
+    name: "remote_ssh_mkdir",
+    description: "通过 SSH 在远程主机上创建目录（mkdir -p，含父目录）。用 profileId 引用已保存配置，或直接给 host/user。在当前远程工作区会话中可不填连接参数，相对路径基于工作区远程目录解析。Create a directory on a remote host over SSH (mkdir -p).",
+    parameters: Object.assign({}, CONN_PARAMS, { path: { type: "string", required: true, description: "远程目录路径。" } }),
+    output: { schema: execSchema(), render: textRender(function (a, v) { return v.ok ? "已创建" : (v.error || v.stderr || "创建失败"); }) },
+    execute: async function (args, exec) {
+      const tc = toolContext(args, exec);
+      if (!tc.profile) return normExec({ ok: false, error: "需要 profileId 或 host+user（当前会话非远程工作区时必填）" });
+      if (!args.path) return normExec({ ok: false, error: "path 为必填项" });
+      let cmd = "mkdir -p " + shellQuotePath(resolveRemotePath(args.path, tc.remotePath));
+      return normExec(await runRemote(subprocess, tc.profile, cmd, undefined, undefined));
+    }
+  });
+
+  // 删除文件或目录：rm -rf。谨慎使用。
+  register({
+    name: "remote_ssh_delete",
+    description: "通过 SSH 删除远程主机上的文件或目录（rm -rf，递归不询问）。用 profileId 引用已保存配置，或直接给 host/user。在当前远程工作区会话中可不填连接参数，相对路径基于工作区远程目录解析。⚠️ 不可恢复，请谨慎使用。Delete a file or directory on a remote host over SSH (rm -rf).",
+    parameters: Object.assign({}, CONN_PARAMS, { path: { type: "string", required: true, description: "远程文件或目录路径。" } }),
+    output: { schema: execSchema(), render: textRender(function (a, v) { return v.ok ? "已删除" : (v.error || v.stderr || "删除失败"); }) },
+    execute: async function (args, exec) {
+      const tc = toolContext(args, exec);
+      if (!tc.profile) return normExec({ ok: false, error: "需要 profileId 或 host+user（当前会话非远程工作区时必填）" });
+      if (!args.path) return normExec({ ok: false, error: "path 为必填项" });
+      let cmd = "rm -rf " + shellQuotePath(resolveRemotePath(args.path, tc.remotePath));
+      return normExec(await runRemote(subprocess, tc.profile, cmd, undefined, undefined));
+    }
+  });
+
+  // 移动/重命名：mv。
+  register({
+    name: "remote_ssh_move",
+    description: "通过 SSH 在远程主机上移动或重命名文件/目录（mv）。用 profileId 引用已保存配置，或直接给 host/user。在当前远程工作区会话中可不填连接参数，相对路径基于工作区远程目录解析。Move or rename a file/directory on a remote host over SSH (mv).",
+    parameters: Object.assign({}, CONN_PARAMS, {
+      src: { type: "string", required: true, description: "源路径。" },
+      dst: { type: "string", required: true, description: "目标路径。" }
+    }),
+    output: { schema: execSchema(), render: textRender(function (a, v) { return v.ok ? "已移动" : (v.error || v.stderr || "移动失败"); }) },
+    execute: async function (args, exec) {
+      const tc = toolContext(args, exec);
+      if (!tc.profile) return normExec({ ok: false, error: "需要 profileId 或 host+user（当前会话非远程工作区时必填）" });
+      if (!args.src || !args.dst) return normExec({ ok: false, error: "src 和 dst 为必填项" });
+      let cmd = "mv " + shellQuotePath(resolveRemotePath(args.src, tc.remotePath)) + " " + shellQuotePath(resolveRemotePath(args.dst, tc.remotePath));
+      return normExec(await runRemote(subprocess, tc.profile, cmd, undefined, undefined));
+    }
+  });
+
   // ---- 清理 ----
   ctx.effect(() => () => {
     terminals.forEach(function (s) { try { s.handle.terminate(); } catch (e) {} });

package/package.json

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