agent-ssh-cli 0.3.4 → 0.3.6

package/README.md

@@ -12,7 +12,7 @@
   <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white" alt="Node.js >=18"></a>
   <a href="https://www.npmjs.com/"><img src="https://img.shields.io/badge/npm-%3E%3D8-CB3837?logo=npm&logoColor=white" alt="npm >=8"></a>
   <a href="https://github.com/sleepinginsummer/agent-ssh-cli"><img src="https://img.shields.io/badge/sys-win%2Fmac%2Flinux-0078D6" alt="sys win/mac/linux"></a>
-  <a href="https://github.com/sleepinginsummer/agent-ssh-cli/releases"><img src="https://img.shields.io/badge/release-v0.3.3-blue" alt="release v0.3.3"></a>
+  <a href="https://github.com/sleepinginsummer/agent-ssh-cli/releases"><img src="https://img.shields.io/badge/release-v0.3.6-blue" alt="release v0.3.6"></a>
   <a href="https://github.com/sleepinginsummer/agent-ssh-cli/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a>
 </p>
 
@@ -33,11 +33,17 @@
 #### 他的能力：
 - 列出本地配置中的 SSH 服务器连接
 - 在指定远端服务器上执行命令
-- 上传本地文件到远端服务器
+- 上传本地文件到远端服务器，支持临时文件、断点续传和失败重试
 - 从远端服务器下载文件到本地
 - 通过命令黑白名单限制可执行命令
 - 通过本地路径白名单限制上传和下载访问范围
 
+## 上传稳定性
+
+上传会先写入远端 `<remotePath>.part` 临时文件，并写入 `<remotePath>.part.meta` 续传元数据；完成后校验大小，再 rename 为正式目标文件。上传中断后，下次上传同一个本地文件到同一个远端路径会从已有 `.part` 大小继续。
+
+`--no-cache` 上传可用 `Ctrl+C` 停止当前进程；daemon 模式可用 `agentsshcli stop-daemon` 停止连接池进程，但它会影响同一 daemon 内其它任务，不是精确取消单个上传。
+
 ## AI 一键安装
 
 ```
@@ -91,6 +97,8 @@ AGENT_SSH_CONFIG=/path/to/config.json
 - `password` / `passwordRef` / `privateKey`: 认证方式，密码、密码引用、私钥三类认证只能保留一种
 - `port`: SSH 端口，默认 `22`
 - `passphrase`: 私钥口令，仅配合 `privateKey` 使用
+- `socksProxy`: SOCKS5 代理地址，例如 `socks5://127.0.0.1:1080`；也可省略协议写成 `127.0.0.1:1080`
+- `jumpHost`: 跳板机连接名，填写配置文件中另一台机器的 `name`
 - `pty`: 是否分配伪终端，默认 `false`，也可通过 `exec --pty` 临时开启
 - `allowedLocalPaths`: 额外允许上传或下载写入的本地路径
 - `commandWhitelist`: 命令白名单正则数组
@@ -113,12 +121,22 @@ AGENT_SSH_CONFIG=/path/to/config.json
     "username": "root",
     "password": "",
     "passwordRef": "agentsshcli:密码服务器",
+    "jumpHost": "jump-server",
     "commandBlacklist": [
       "(^|[;&|()\\s])rm(\\s|$)",
       "(^|[;&|()\\s])shutdown(\\s|$)",
       "(^|[;&|()\\s])reboot(\\s|$)"
     ]
   },
+  {
+    "name": "jump-server",
+    "host": "198.51.100.20",
+    "port": 22,
+    "username": "ubuntu",
+    "privateKey": "/path/to/jump_key",
+    "passphrase": "******",
+    "socksProxy": "socks5://127.0.0.1:1080"
+  },
   {
     "name": "密钥服务器",
     "host": "198.51.100.10",

package/example.config.json

@@ -6,6 +6,7 @@
     "username": "root",
     "password": "",
     "passwordRef": "agentsshcli:密码服务器",
+    "jumpHost": "跳板机",
     "allowedLocalPaths": [
       "./tmp"
     ],
@@ -15,6 +16,15 @@
       "(^|[;&|()\\s])reboot(\\s|$)"
     ]
   },
+  {
+    "name": "跳板机",
+    "host": "198.51.100.20",
+    "port": 22,
+    "username": "ubuntu",
+    "privateKey": "/path/to/jump_key",
+    "passphrase": "******",
+    "socksProxy": "socks5://127.0.0.1:1080"
+  },
   {
     "name": "密钥服务器",
     "host": "198.51.100.10",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-ssh-cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "基于 CLI 的 SSH 代理工具，按 ssh-mcp-server 的能力一一映射",
   "type": "module",
   "engines": {
@@ -27,10 +27,10 @@
     "build:native-package": "npm run build:native-bin && node scripts/build-native-package.js"
   },
   "optionalDependencies": {
-    "@agent-ssh-cli/darwin-arm64": "0.3.4",
-    "@agent-ssh-cli/darwin-x64": "0.3.4",
-    "@agent-ssh-cli/linux-arm64": "0.3.4",
-    "@agent-ssh-cli/linux-x64": "0.3.4",
-    "@agent-ssh-cli/win32-x64": "0.3.4"
+    "@agent-ssh-cli/darwin-arm64": "0.3.6",
+    "@agent-ssh-cli/darwin-x64": "0.3.6",
+    "@agent-ssh-cli/linux-arm64": "0.3.6",
+    "@agent-ssh-cli/linux-x64": "0.3.6",
+    "@agent-ssh-cli/win32-x64": "0.3.6"
   }
 }