@pyrokine/mcp-ssh 1.1.0 → 1.1.2

package/README.md

@@ -19,16 +19,16 @@ A comprehensive SSH MCP Server for AI assistants (Claude, Cursor, Windsurf, etc.
 - **Connection Management**: Connection pooling, keepalive, auto-reconnect
 - **Session Persistence**: Sessions info saved for reconnection
 - **Command Execution**:
-  - Basic exec with timeout
-  - PTY mode (for interactive commands like `top`, `htop`)
-  - `sudo` execution
-  - `su` (switch user) execution - *run commands as different user*
-  - Batch execution
-  - Parallel execution on multiple hosts
+    - Basic exec with timeout
+    - PTY mode (for interactive commands like `top`, `htop`)
+    - `sudo` execution
+    - `su` (switch user) execution - *run commands as different user*
+    - Batch execution
+    - Parallel execution on multiple hosts
 - **Persistent PTY Sessions**: For long-running interactive commands (top, htop, tmux, vim, etc.)
-  - Output buffering with polling read
-  - Send keystrokes and commands
-  - Window resize support
+    - Output buffering with polling read
+    - Send keystrokes and commands
+    - Window resize support
 - **File Operations**: Upload, download, read, write, list directory (via SFTP)
 - **Smart Sync**: Directory sync with rsync (auto-fallback to SFTP if rsync unavailable)
 - **Environment Configuration**: LANG, LC_ALL, custom env vars
@@ -36,15 +36,15 @@ A comprehensive SSH MCP Server for AI assistants (Claude, Cursor, Windsurf, etc.
 
 ## Compatible Clients
 
-| Client | Status |
-|--------|--------|
-| Claude Code | ✅ |
-| Claude Desktop | ✅ |
-| Cursor | ✅ |
-| Windsurf | ✅ |
-| Continue.dev | ✅ |
-| Cline | ✅ |
-| Any MCP-compatible client | ✅ |
+| Client                    | Status |
+|---------------------------|--------|
+| Claude Code               | ✅      |
+| Claude Desktop            | ✅      |
+| Cursor                    | ✅      |
+| Windsurf                  | ✅      |
+| Continue.dev              | ✅      |
+| Cline                     | ✅      |
+| Any MCP-compatible client | ✅      |
 
 ## Installation
 
@@ -90,57 +90,57 @@ Add to your MCP settings (e.g., `~/.claude/settings.json` or client-specific con
 
 ### Connection Management
 
-| Tool | Description |
-|------|-------------|
-| `ssh_connect` | Establish SSH connection (supports ~/.ssh/config) |
-| `ssh_disconnect` | Close connection |
-| `ssh_list_sessions` | List active sessions |
-| `ssh_reconnect` | Reconnect a disconnected session |
-| `ssh_config_list` | List hosts from ~/.ssh/config |
+| Tool                | Description                                       |
+|---------------------|---------------------------------------------------|
+| `ssh_connect`       | Establish SSH connection (supports ~/.ssh/config) |
+| `ssh_disconnect`    | Close connection                                  |
+| `ssh_list_sessions` | List active sessions                              |
+| `ssh_reconnect`     | Reconnect a disconnected session                  |
+| `ssh_config_list`   | List hosts from ~/.ssh/config                     |
 
 ### Command Execution
 
-| Tool | Description |
-|------|-------------|
-| `ssh_exec` | Execute command (supports PTY mode) |
-| `ssh_exec_as_user` | Execute as different user (via `su`) |
-| `ssh_exec_sudo` | Execute with `sudo` |
-| `ssh_exec_batch` | Execute multiple commands sequentially |
+| Tool                | Description                                   |
+|---------------------|-----------------------------------------------|
+| `ssh_exec`          | Execute command (supports PTY mode)           |
+| `ssh_exec_as_user`  | Execute as different user (via `su`)          |
+| `ssh_exec_sudo`     | Execute with `sudo`                           |
+| `ssh_exec_batch`    | Execute multiple commands sequentially        |
 | `ssh_exec_parallel` | Execute command on multiple hosts in parallel |
-| `ssh_quick_exec` | One-shot: connect, execute, disconnect |
+| `ssh_quick_exec`    | One-shot: connect, execute, disconnect        |
 
 ### File Operations
 
-| Tool | Description |
-|------|-------------|
-| `ssh_upload` | Upload local file to remote server |
-| `ssh_download` | Download remote file to local |
-| `ssh_read_file` | Read remote file content |
-| `ssh_write_file` | Write content to remote file |
-| `ssh_list_dir` | List remote directory contents |
-| `ssh_file_info` | Get file/directory metadata |
-| `ssh_mkdir` | Create remote directory |
-| `ssh_sync` | Smart sync with rsync (fallback to SFTP) |
+| Tool             | Description                              |
+|------------------|------------------------------------------|
+| `ssh_upload`     | Upload local file to remote server       |
+| `ssh_download`   | Download remote file to local            |
+| `ssh_read_file`  | Read remote file content                 |
+| `ssh_write_file` | Write content to remote file             |
+| `ssh_list_dir`   | List remote directory contents           |
+| `ssh_file_info`  | Get file/directory metadata              |
+| `ssh_mkdir`      | Create remote directory                  |
+| `ssh_sync`       | Smart sync with rsync (fallback to SFTP) |
 
 ### PTY Sessions (Persistent Interactive Terminal)
 
-| Tool | Description |
-|------|-------------|
-| `ssh_pty_start` | Start persistent PTY session (for top, htop, tmux, etc.) |
-| `ssh_pty_write` | Send data to PTY (keystrokes, commands) |
-| `ssh_pty_read` | Read PTY output (screen mode: current screen, raw mode: ANSI stream) |
-| `ssh_pty_resize` | Resize PTY window |
-| `ssh_pty_close` | Close PTY session |
-| `ssh_pty_list` | List all PTY sessions |
+| Tool             | Description                                                          |
+|------------------|----------------------------------------------------------------------|
+| `ssh_pty_start`  | Start persistent PTY session (for top, htop, tmux, etc.)             |
+| `ssh_pty_write`  | Send data to PTY (keystrokes, commands)                              |
+| `ssh_pty_read`   | Read PTY output (screen mode: current screen, raw mode: ANSI stream) |
+| `ssh_pty_resize` | Resize PTY window                                                    |
+| `ssh_pty_close`  | Close PTY session                                                    |
+| `ssh_pty_list`   | List all PTY sessions                                                |
 
 ### Port Forwarding
 
-| Tool | Description |
-|------|-------------|
-| `ssh_forward_local` | Local port forwarding (ssh -L): access remote services |
+| Tool                 | Description                                            |
+|----------------------|--------------------------------------------------------|
+| `ssh_forward_local`  | Local port forwarding (ssh -L): access remote services |
 | `ssh_forward_remote` | Remote port forwarding (ssh -R): expose local services |
-| `ssh_forward_close` | Close port forwarding |
-| `ssh_forward_list` | List all port forwards |
+| `ssh_forward_close`  | Close port forwarding                                  |
+| `ssh_forward_list`   | List all port forwards                                 |
 
 ## Usage Examples
 
@@ -161,6 +161,7 @@ ssh_connect(configHost="myserver", configPath="/custom/path/config")
 ```
 
 Supported SSH config features:
+
 - `Host` with multiple aliases (e.g., `Host a b c`)
 - `Host *` global defaults inheritance (first `Host *` block only)
 - `HostName`, `User`, `Port`, `IdentityFile`
@@ -168,11 +169,13 @@ Supported SSH config features:
 - Explicit parameters override config values (e.g., `ssh_connect(configHost="x", user="override")`)
 
 **Not supported** (skipped):
+
 - `Include` directive
 - `Match` blocks (entire block skipped until next `Host`)
 - Wildcard patterns (e.g., `Host *.example.com`)
 
 **Behavior notes**:
+
 - Multiple `Host *` blocks: only first is used
 - Duplicate Host definitions: `ssh_config_list` shows all, `ssh_connect` uses first
 - IPv6 in ProxyJump: use bracket notation `[2001:db8::1]:22`
@@ -224,6 +227,10 @@ Perfect for scenarios where you SSH as root but need to run commands as another
    // Output: appuser
 ```
 
+By default, shell profile is loaded to ensure environment variables are available (since `su -c` creates a
+non-interactive shell which doesn't execute rc files). Supports bash (`.bashrc`), zsh (`.zshrc`), and other shells (
+`.profile`). Disable with `loadProfile=false` if not needed.
+
 ### Interactive Commands (PTY mode)
 
 For commands that need a terminal:
@@ -306,7 +313,8 @@ ssh_sync(..., dryRun=true)
 
 If rsync is not available on remote or local, it automatically falls back to SFTP.
 
-**Note**: rsync mode uses SSH key/agent authentication and disables strict host key checking (`StrictHostKeyChecking=no`) for convenience. If you require host key verification, use SFTP mode instead.
+**Note**: rsync mode uses SSH key/agent authentication and disables strict host key checking (
+`StrictHostKeyChecking=no`) for convenience. If you require host key verification, use SFTP mode instead.
 
 ### Persistent PTY Sessions (top, tmux, etc.)
 
@@ -345,6 +353,7 @@ ssh_pty_write(ptyId="pty_1_xxx", data="\x02d")
 ```
 
 Common control sequences:
+
 - Enter: `\r` or `\n`
 - Ctrl+C: `\x03`
 - Ctrl+D: `\x04`
@@ -374,25 +383,25 @@ ssh_forward_close(forwardId="fwd_1_xxx")
 
 ### Connection Options
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `host` | string | *required* | Server address |
-| `user` | string | *required* | Username |
-| `password` | string | - | Password authentication |
-| `keyPath` | string | - | Path to SSH private key |
-| `port` | number | 22 | SSH port |
-| `alias` | string | auto-generated | Connection alias for reference |
-| `env` | object | - | Environment variables |
-| `keepaliveInterval` | number | 30000 | Keepalive interval in ms |
+| Option              | Type   | Default        | Description                    |
+|---------------------|--------|----------------|--------------------------------|
+| `host`              | string | *required*     | Server address                 |
+| `user`              | string | *required*     | Username                       |
+| `password`          | string | -              | Password authentication        |
+| `keyPath`           | string | -              | Path to SSH private key        |
+| `port`              | number | 22             | SSH port                       |
+| `alias`             | string | auto-generated | Connection alias for reference |
+| `env`               | object | -              | Environment variables          |
+| `keepaliveInterval` | number | 30000          | Keepalive interval in ms       |
 
 ### Exec Options
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `timeout` | number | 30000 | Command timeout in ms |
-| `cwd` | string | - | Working directory |
-| `env` | object | - | Additional environment variables |
-| `pty` | boolean | false | Enable PTY mode for interactive commands |
+| Option    | Type    | Default | Description                              |
+|-----------|---------|---------|------------------------------------------|
+| `timeout` | number  | 30000   | Command timeout in ms                    |
+| `cwd`     | string  | -       | Working directory                        |
+| `env`     | object  | -       | Additional environment variables         |
+| `pty`     | boolean | false   | Enable PTY mode for interactive commands |
 
 ## Project Structure
 

package/README_zh.md

@@ -19,16 +19,16 @@
 - **连接管理**：连接池复用、心跳保持、自动重连
 - **会话持久化**：会话信息保存，支持重连
 - **命令执行**：
-  - 基础执行（带超时）
-  - PTY 模式（用于 `top`、`htop` 等交互式命令）
-  - `sudo` 执行
-  - `su` 切换用户执行
-  - 批量执行
-  - 多主机并行执行
+    - 基础执行（带超时）
+    - PTY 模式（用于 `top`、`htop` 等交互式命令）
+    - `sudo` 执行
+    - `su` 切换用户执行
+    - 批量执行
+    - 多主机并行执行
 - **持久化 PTY 会话**：用于长时间运行的交互式命令（top、htop、tmux、vim 等）
-  - 输出缓冲区，支持轮询读取
-  - 发送按键和命令
-  - 窗口大小调整
+    - 输出缓冲区，支持轮询读取
+    - 发送按键和命令
+    - 窗口大小调整
 - **文件操作**：上传、下载、读取、写入、目录列表（通过 SFTP）
 - **智能同步**：目录同步，优先使用 rsync（无 rsync 时自动回退到 SFTP）
 - **环境配置**：LANG、LC_ALL、自定义环境变量
@@ -36,15 +36,15 @@
 
 ## 兼容客户端
 
-| 客户端 | 状态 |
-|--------|------|
-| Claude Code | ✅ |
-| Claude Desktop | ✅ |
-| Cursor | ✅ |
-| Windsurf | ✅ |
-| Continue.dev | ✅ |
-| Cline | ✅ |
-| 其他 MCP 兼容客户端 | ✅ |
+| 客户端            | 状态 |
+|----------------|----|
+| Claude Code    | ✅  |
+| Claude Desktop | ✅  |
+| Cursor         | ✅  |
+| Windsurf       | ✅  |
+| Continue.dev   | ✅  |
+| Cline          | ✅  |
+| 其他 MCP 兼容客户端   | ✅  |
 
 ## 安装
 
@@ -90,57 +90,57 @@ claude mcp add ssh -- node /path/to/mcp-ssh/dist/index.js
 
 ### 连接管理
 
-| 工具 | 描述 |
-|------|------|
-| `ssh_connect` | 建立 SSH 连接（支持 ~/.ssh/config） |
-| `ssh_disconnect` | 关闭连接 |
-| `ssh_list_sessions` | 列出活跃会话 |
-| `ssh_reconnect` | 重新连接断开的会话 |
-| `ssh_config_list` | 列出 ~/.ssh/config 中的 Host |
+| 工具                  | 描述                          |
+|---------------------|-----------------------------|
+| `ssh_connect`       | 建立 SSH 连接（支持 ~/.ssh/config） |
+| `ssh_disconnect`    | 关闭连接                        |
+| `ssh_list_sessions` | 列出活跃会话                      |
+| `ssh_reconnect`     | 重新连接断开的会话                   |
+| `ssh_config_list`   | 列出 ~/.ssh/config 中的 Host    |
 
 ### 命令执行
 
-| 工具 | 描述 |
-|------|------|
-| `ssh_exec` | 执行命令（支持 PTY 模式） |
-| `ssh_exec_as_user` | 以其他用户身份执行（通过 `su`） |
-| `ssh_exec_sudo` | 使用 `sudo` 执行 |
-| `ssh_exec_batch` | 批量执行多条命令 |
-| `ssh_exec_parallel` | 在多台主机上并行执行命令 |
-| `ssh_quick_exec` | 一次性执行：连接、执行、断开 |
+| 工具                  | 描述                 |
+|---------------------|--------------------|
+| `ssh_exec`          | 执行命令（支持 PTY 模式）    |
+| `ssh_exec_as_user`  | 以其他用户身份执行（通过 `su`） |
+| `ssh_exec_sudo`     | 使用 `sudo` 执行       |
+| `ssh_exec_batch`    | 批量执行多条命令           |
+| `ssh_exec_parallel` | 在多台主机上并行执行命令       |
+| `ssh_quick_exec`    | 一次性执行：连接、执行、断开     |
 
 ### 文件操作
 
-| 工具 | 描述 |
-|------|------|
-| `ssh_upload` | 上传本地文件到远程 |
-| `ssh_download` | 从远程下载文件到本地 |
-| `ssh_read_file` | 读取远程文件内容 |
-| `ssh_write_file` | 写入内容到远程文件 |
-| `ssh_list_dir` | 列出远程目录内容 |
-| `ssh_file_info` | 获取文件/目录元数据 |
-| `ssh_mkdir` | 创建远程目录 |
-| `ssh_sync` | 智能同步（优先 rsync，回退 SFTP） |
+| 工具               | 描述                     |
+|------------------|------------------------|
+| `ssh_upload`     | 上传本地文件到远程              |
+| `ssh_download`   | 从远程下载文件到本地             |
+| `ssh_read_file`  | 读取远程文件内容               |
+| `ssh_write_file` | 写入内容到远程文件              |
+| `ssh_list_dir`   | 列出远程目录内容               |
+| `ssh_file_info`  | 获取文件/目录元数据             |
+| `ssh_mkdir`      | 创建远程目录                 |
+| `ssh_sync`       | 智能同步（优先 rsync，回退 SFTP） |
 
 ### PTY 会话（持久化交互式终端）
 
-| 工具 | 描述 |
-|------|------|
-| `ssh_pty_start` | 启动持久化 PTY 会话（用于 top、htop、tmux 等） |
-| `ssh_pty_write` | 向 PTY 发送数据（按键、命令） |
-| `ssh_pty_read` | 读取 PTY 输出（screen 模式：当前屏幕，raw 模式：ANSI 流） |
-| `ssh_pty_resize` | 调整 PTY 窗口大小 |
-| `ssh_pty_close` | 关闭 PTY 会话 |
-| `ssh_pty_list` | 列出所有 PTY 会话 |
+| 工具               | 描述                                      |
+|------------------|-----------------------------------------|
+| `ssh_pty_start`  | 启动持久化 PTY 会话（用于 top、htop、tmux 等）        |
+| `ssh_pty_write`  | 向 PTY 发送数据（按键、命令）                       |
+| `ssh_pty_read`   | 读取 PTY 输出（screen 模式：当前屏幕，raw 模式：ANSI 流） |
+| `ssh_pty_resize` | 调整 PTY 窗口大小                             |
+| `ssh_pty_close`  | 关闭 PTY 会话                               |
+| `ssh_pty_list`   | 列出所有 PTY 会话                             |
 
 ### 端口转发
 
-| 工具 | 描述 |
-|------|------|
-| `ssh_forward_local` | 本地端口转发（ssh -L）：访问远程服务 |
+| 工具                   | 描述                    |
+|----------------------|-----------------------|
+| `ssh_forward_local`  | 本地端口转发（ssh -L）：访问远程服务 |
 | `ssh_forward_remote` | 远程端口转发（ssh -R）：暴露本地服务 |
-| `ssh_forward_close` | 关闭端口转发 |
-| `ssh_forward_list` | 列出所有端口转发 |
+| `ssh_forward_close`  | 关闭端口转发                |
+| `ssh_forward_list`   | 列出所有端口转发              |
 
 ## 使用示例
 
@@ -161,6 +161,7 @@ ssh_connect(configHost="myserver", configPath="/custom/path/config")
 ```
 
 支持的 SSH config 特性：
+
 - `Host` 多别名（如 `Host a b c`）
 - `Host *` 全局默认继承（仅第一个 `Host *` 块）
 - `HostName`、`User`、`Port`、`IdentityFile`
@@ -168,11 +169,13 @@ ssh_connect(configHost="myserver", configPath="/custom/path/config")
 - 显式参数优先于 config 值（如 `ssh_connect(configHost="x", user="覆盖值")`）
 
 **不支持**（跳过）：
+
 - `Include` 指令
 - `Match` 块（整个块跳过直到下一个 `Host`）
 - 通配符模式（如 `Host *.example.com`）
 
 **行为说明**：
+
 - 多个 `Host *` 块：仅使用第一个
 - 重复的 Host 定义：`ssh_config_list` 显示全部，`ssh_connect` 使用第一个
 - ProxyJump 中的 IPv6：使用方括号格式 `[2001:db8::1]:22`
@@ -224,6 +227,9 @@ ssh_connect(
    // 输出: appuser
 ```
 
+默认加载 shell 配置以确保环境变量可用（`su -c` 创建非交互式 shell，不会自动执行 rc 文件）。支持 bash（`.bashrc`）、zsh（`.zshrc`
+）及其他 shell（`.profile`）。如不需要可设置 `loadProfile=false`。
+
 ### 交互式命令（PTY 模式）
 
 用于需要终端的命令：
@@ -306,7 +312,8 @@ ssh_sync(..., dryRun=true)
 
 如果远程或本地没有 rsync，会自动回退到 SFTP。
 
-**注意**：rsync 模式使用 SSH 密钥/代理认证，并禁用严格主机密钥检查（`StrictHostKeyChecking=no`）以方便使用。如需主机密钥验证，请使用 SFTP 模式。
+**注意**：rsync 模式使用 SSH 密钥/代理认证，并禁用严格主机密钥检查（`StrictHostKeyChecking=no`）以方便使用。如需主机密钥验证，请使用
+SFTP 模式。
 
 ### 持久化 PTY 会话（top、tmux 等）
 
@@ -345,6 +352,7 @@ ssh_pty_write(ptyId="pty_1_xxx", data="\x02d")
 ```
 
 常用控制序列：
+
 - 回车: `\r` 或 `\n`
 - Ctrl+C: `\x03`
 - Ctrl+D: `\x04`
@@ -374,25 +382,25 @@ ssh_forward_close(forwardId="fwd_1_xxx")
 
 ### 连接选项
 
-| 选项 | 类型 | 默认值 | 描述 |
-|------|------|--------|------|
-| `host` | string | *必需* | 服务器地址 |
-| `user` | string | *必需* | 用户名 |
-| `password` | string | - | 密码认证 |
-| `keyPath` | string | - | SSH 私钥路径 |
-| `port` | number | 22 | SSH 端口 |
-| `alias` | string | 自动生成 | 连接别名，用于后续引用 |
-| `env` | object | - | 环境变量 |
-| `keepaliveInterval` | number | 30000 | 心跳间隔（毫秒） |
+| 选项                  | 类型     | 默认值   | 描述          |
+|---------------------|--------|-------|-------------|
+| `host`              | string | *必需*  | 服务器地址       |
+| `user`              | string | *必需*  | 用户名         |
+| `password`          | string | -     | 密码认证        |
+| `keyPath`           | string | -     | SSH 私钥路径    |
+| `port`              | number | 22    | SSH 端口      |
+| `alias`             | string | 自动生成  | 连接别名，用于后续引用 |
+| `env`               | object | -     | 环境变量        |
+| `keepaliveInterval` | number | 30000 | 心跳间隔（毫秒）    |
 
 ### 执行选项
 
-| 选项 | 类型 | 默认值 | 描述 |
-|------|------|--------|------|
-| `timeout` | number | 30000 | 命令超时（毫秒） |
-| `cwd` | string | - | 工作目录 |
-| `env` | object | - | 额外环境变量 |
-| `pty` | boolean | false | 启用 PTY 模式（用于交互式命令） |
+| 选项        | 类型      | 默认值   | 描述                 |
+|-----------|---------|-------|--------------------|
+| `timeout` | number  | 30000 | 命令超时（毫秒）           |
+| `cwd`     | string  | -     | 工作目录               |
+| `env`     | object  | -     | 额外环境变量             |
+| `pty`     | boolean | false | 启用 PTY 模式（用于交互式命令） |
 
 ## 项目结构
 

package/dist/file-ops.js

@@ -1,9 +1,9 @@
 /**
  * SSH File Operations - 文件操作
  */
+import { execSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
-import { execSync } from 'child_process';
 import { sessionManager } from './session-manager.js';
 /**
  * 上传文件
@@ -20,12 +20,14 @@ export async function uploadFile(alias, localPath, remotePath, onProgress) {
         const writeStream = sftp.createWriteStream(remotePath);
         let settled = false;
         const cleanup = (err) => {
-            if (settled)
+            if (settled) {
                 return;
+            }
             settled = true;
             sftp.end();
-            if (err)
+            if (err) {
                 reject(err);
+            }
         };
         let transferred = 0;
         readStream.on('data', (chunk) => {
@@ -58,10 +60,12 @@ export async function downloadFile(alias, remotePath, localPath, onProgress) {
     // 获取远程文件大小
     const stats = await new Promise((resolve, reject) => {
         sftp.stat(remotePath, (err, stats) => {
-            if (err)
+            if (err) {
                 reject(err);
-            else
+            }
+            else {
                 resolve(stats);
+            }
         });
     });
     const totalSize = stats.size;
@@ -75,12 +79,14 @@ export async function downloadFile(alias, remotePath, localPath, onProgress) {
         const writeStream = fs.createWriteStream(localPath);
         let settled = false;
         const cleanup = (err) => {
-            if (settled)
+            if (settled) {
                 return;
+            }
             settled = true;
             sftp.end();
-            if (err)
+            if (err) {
                 reject(err);
+            }
         };
         let transferred = 0;
         readStream.on('data', (chunk) => {
@@ -108,16 +114,17 @@ export async function downloadFile(alias, remotePath, localPath, onProgress) {
 /**
  * 读取远程文件内容
  */
-export async function readFile(alias, remotePath, maxBytes = 1024 * 1024 // 默认最大 1MB
-) {
+export async function readFile(alias, remotePath, maxBytes = 1024 * 1024) {
     const sftp = await sessionManager.getSftp(alias);
     // 获取文件大小
     const stats = await new Promise((resolve, reject) => {
         sftp.stat(remotePath, (err, stats) => {
-            if (err)
+            if (err) {
                 reject(err);
-            else
+            }
+            else {
                 resolve(stats);
+            }
         });
     });
     const actualSize = stats.size;
@@ -264,10 +271,12 @@ export async function mkdir(alias, remotePath, recursive = false) {
     return new Promise((resolve, reject) => {
         sftp.mkdir(remotePath, (err) => {
             sftp.end();
-            if (err)
+            if (err) {
                 reject(err);
-            else
+            }
+            else {
                 resolve(true);
+            }
         });
     });
 }
@@ -279,10 +288,12 @@ export async function removeFile(alias, remotePath) {
     return new Promise((resolve, reject) => {
         sftp.unlink(remotePath, (err) => {
             sftp.end();
-            if (err)
+            if (err) {
                 reject(err);
-            else
+            }
+            else {
                 resolve(true);
+            }
         });
     });
 }
@@ -323,7 +334,7 @@ export async function syncFiles(alias, localPath, remotePath, direction, options
  * 转义 shell 路径参数
  */
 function escapeShellPath(p) {
-    return `'${p.replace(/'/g, "'\\''")}'`;
+    return `'${p.replace(/'/g, '\'\\\'\'')}'`;
 }
 /**
  * 使用 rsync 同步文件
@@ -336,7 +347,8 @@ async function syncWithRsync(alias, localPath, remotePath, direction, options) {
         execSync('which rsync', { stdio: 'pipe' });
         hasLocalRsync = true;
     }
-    catch { }
+    catch {
+    }
     if (!hasLocalRsync) {
         // 本地没有 rsync，回退到 SFTP
         return syncWithSftp(alias, localPath, remotePath, direction, options);
@@ -374,13 +386,16 @@ async function syncWithRsync(alias, localPath, remotePath, direction, options) {
         const result = execSync(rsyncCmd, {
             encoding: 'utf-8',
             timeout: 600000, // 10 分钟超时
-            stdio: ['pipe', 'pipe', 'pipe']
+            stdio: ['pipe', 'pipe', 'pipe'],
         });
         // 解析 rsync 输出统计文件数
         const lines = result.split('\n');
         let filesTransferred = 0;
         for (const line of lines) {
-            if (line.trim() && !line.startsWith('sending') && !line.startsWith('receiving') && !line.startsWith('total')) {
+            if (line.trim() &&
+                !line.startsWith('sending') &&
+                !line.startsWith('receiving') &&
+                !line.startsWith('total')) {
                 filesTransferred++;
             }
         }
@@ -409,7 +424,8 @@ async function syncWithSftp(alias, localPath, remotePath, direction, options) {
         return {
             success: true,
             method: 'sftp',
-            output: 'Dry run mode: would transfer files via SFTP' + (warnings.length ? `. Warning: ${warnings.join('; ')}` : ''),
+            output: 'Dry run mode: would transfer files via SFTP' +
+                (warnings.length ? `. Warning: ${warnings.join('; ')}` : ''),
         };
     }
     try {