dsh-winrm 0.2.0 → 0.3.0

package/README.md

@@ -15,7 +15,7 @@
 | PowerShell 控制台 | WebSocket 命令会话（每条命令通过原生 Node WinRM 客户端执行，输出实时返回） |
 | 服务管理 | 列出 / 启动 / 停止 / 重启 / 改启动类型（自动/手动/禁用） |
 | 进程管理 | 列出（CPU/内存/路径）/ 按 PID 结束 |
-| 文件传输 | base64 分块读写，**不依赖 SMB**，任意路径可传；上传自动建目录 |
+| 文件传输 | WinRM 流式传输（上传单 shell 单流 / 下载并行区间，**不依赖 SMB**，任意路径可传）；上传自动建目录 |
 | 集群 | 一条命令并发跑多台主机（按 aliases / environment / tags 过滤） |
 
 ## 认证与传输
@@ -47,7 +47,7 @@ powershell -ExecutionPolicy Bypass -File .\scripts\enable-winrm.ps1
 从 [Releases](https://github.com/MoRanYue/dsh-winrm/releases) 下载最新的 `dsh-winrm-*.tgz`，加入 profile：
 
 ```powershell
-dsh plugin --profile web add D:\downloads\dsh-winrm-0.2.0.tgz
+dsh plugin --profile web add D:\downloads\dsh-winrm-0.3.0.tgz
 ```
 
 也可以直接从 npm 安装：
@@ -93,10 +93,11 @@ src/
   engine.ts           WinRmEngine 门面：exec / services / processes / ls / upload / download / console / cluster / test
   store.ts            ~/.dsh/dsh-winrm.json 主机存储（原子写，0600）
   protocol.ts         宿主↔浏览器 wire 类型
-  powershell.ts       PS 片段构造器 + stdin 信封（outer/child 包装 / 服务 / 进程 / 目录 / 分块读写）
+  powershell.ts       PS 片段构造器 + stdin 信封（outer/child 包装 / 服务 / 进程 / 目录 / 流式收发脚本）
   routes.ts           /api/dsh-winrm 路由族 + 控制台 WebSocket（loopback 围栏）
   tools.ts            7 个 winrm_* agent 工具
-  engine/client.ts    winrm-client 传输层：进程内认证（NTLM/Basic）、UTF-8 信封、分块传输
+  engine/client.ts    winrm-client 传输层：进程内认证（NTLM/Basic）、UTF-8 信封、流式上传/下载 + 分块回退
+  engine/wsman.ts     手写 WSMan Send/Receive 信封（原始字节走 stdin，不做二次 base64；512000 信封上限）
   engine/console.ts   流式 PowerShell 控制台会话
   client/             浏览器半：侧边栏入口 + 居中面板（5 页签）
 scripts/
@@ -109,7 +110,10 @@ scripts/
 ## 已知限制
 
 - 控制台是命令会话，不保持 PowerShell 变量和当前目录状态；每条命令独立执行
-- 传输按 48KB 分块，大文件较慢（每块一次往返）；分块大小由 `TRANSFER_CHUNK` 决定，脚本本身已不再受命令行长度限制
+- 上传走**单条 stdin 流**：一个 shell、一个命令，每 256KB 一个 `Send`，可压缩内容自动按块 gzip（实测 1.7MB JSON 线上仅 91KB）。旧的 48KB 分块路径保留为回退，仅在流式通道不可用时启用
+- 下载走**并行区间流**：默认最多 4 个 worker，各自一个 shell 读同一文件的绝对字节区间，远端 gzip 后回传，本地按 offset 落位（实测 2MiB 约 10-12 秒，16MiB 约 21-23 秒，可压缩的 16MiB 约 6 秒；旧的 48KB 分块路径 2MiB 需 129 秒，保留为回退）。服务端单次 `Receive` 最多回 128KB，与信封大小无关，所以下载是往返次数受限而非带宽受限
+- `channel=auto`（默认）先探测目标机 445 端口：`net use` 自身没有短超时，SMB 不可用时要等约 60 秒才失败，此前这段等待发生在每次上传之前。现在 3 秒内判定并直接走 WinRM
+- 下载失败不留残file：已写入的数据会被丢弃、目标文件被删除；若失败发生在任何字节到达之前（路径不存在、目标是目录、主机不可达），已存在的本地文件保持原样不动（目标文件在首次写入时才创建）
 - 单命令默认 60s 超时，可传 `timeoutMs`
 - 目标机需已启用 WinRM（见上）；HTTP 明文 Basic 不应用于公网
 - 面板关闭再打开会回到「主机」页签：面板是 `main` 插槽的占用者，切回对话时卸载，页签状态不跨开关保留

package/README.zh.md

@@ -13,7 +13,7 @@
 | PowerShell 控制台 | WebSocket 命令会话（每条命令通过原生 Node WinRM 客户端执行，输出实时返回） |
 | 服务管理 | 列出 / 启动 / 停止 / 重启 / 改启动类型（自动/手动/禁用） |
 | 进程管理 | 列出（CPU/内存/路径）/ 按 PID 结束 |
-| 文件传输 | base64 分块读写，**不依赖 SMB**，任意路径可传；上传自动建目录 |
+| 文件传输 | WinRM 流式传输（上传单 shell 单流 / 下载并行区间，**不依赖 SMB**，任意路径可传）；上传自动建目录 |
 | 集群 | 一条命令并发跑多台主机（按 aliases / environment / tags 过滤） |
 
 ## 认证与传输
@@ -50,7 +50,7 @@ powershell -ExecutionPolicy Bypass -File .\scripts\enable-winrm.ps1
 从 [Releases](https://github.com/MoRanYue/dsh-winrm/releases) 下载最新的 `dsh-winrm-*.tgz`，加入 profile：
 
 ```powershell
-dsh plugin --profile web add D:\downloads\dsh-winrm-0.2.0.tgz
+dsh plugin --profile web add D:\downloads\dsh-winrm-0.3.0.tgz
 ```
 
 也可以直接从 npm 安装：
@@ -96,10 +96,11 @@ src/
   engine.ts           WinRmEngine 门面：exec / services / processes / ls / upload / download / console / cluster / test
   store.ts            ~/.dsh/dsh-winrm.json 主机存储（原子写，0600）
   protocol.ts         宿主↔浏览器 wire 类型
-  powershell.ts       PS 片段构造器 + stdin 信封（outer/child 包装 / 服务 / 进程 / 目录 / 分块读写）
+  powershell.ts       PS 片段构造器 + stdin 信封（outer/child 包装 / 服务 / 进程 / 目录 / 流式收发脚本）
   routes.ts           /api/dsh-winrm 路由族 + 控制台 WebSocket（loopback 围栏）
   tools.ts            7 个 winrm_* agent 工具
-  engine/client.ts    winrm-client 传输层：进程内认证（NTLM/Basic）、UTF-8 信封、分块传输
+  engine/client.ts    winrm-client 传输层：进程内认证（NTLM/Basic）、UTF-8 信封、流式上传/下载 + 分块回退
+  engine/wsman.ts     手写 WSMan Send/Receive 信封（原始字节走 stdin，不做二次 base64；512000 信封上限）
   engine/console.ts   流式 PowerShell 控制台会话
   client/             浏览器半：侧边栏入口 + 居中面板（5 页签）
 scripts/
@@ -112,7 +113,10 @@ scripts/
 ## 已知限制
 
 - 控制台是命令会话，不保持 PowerShell 变量和当前目录状态；每条命令独立执行
-- 传输按 48KB 分块，大文件较慢（每块一次往返）；分块大小由 `TRANSFER_CHUNK` 决定，脚本本身已不再受命令行长度限制
+- 上传走**单条 stdin 流**：一个 shell、一个命令，每 256KB 一个 `Send`，可压缩内容自动按块 gzip（实测 1.7MB JSON 线上仅 91KB）。旧的 48KB 分块路径保留为回退，仅在流式通道不可用时启用
+- 下载走**并行区间流**：默认最多 4 个 worker，各自一个 shell 读同一文件的绝对字节区间，远端 gzip 后回传，本地按 offset 落位（实测 2MiB 约 10-12 秒，16MiB 约 21-23 秒，可压缩的 16MiB 约 6 秒；旧的 48KB 分块路径 2MiB 需 129 秒，保留为回退）。服务端单次 `Receive` 最多回 128KB，与信封大小无关，所以下载是往返次数受限而非带宽受限
+- `channel=auto`（默认）先探测目标机 445 端口：`net use` 自身没有短超时，SMB 不可用时要等约 60 秒才失败，此前这段等待发生在每次上传之前。现在 3 秒内判定并直接走 WinRM
+- 下载失败不留残file：已写入的数据会被丢弃、目标文件被删除；若失败发生在任何字节到达之前（路径不存在、目标是目录、主机不可达），已存在的本地文件保持原样不动（目标文件在首次写入时才创建）
 - 单命令默认 60s 超时，可传 `timeoutMs`
 - 目标机需已启用 WinRM（见上）；HTTP 明文 Basic 不应用于公网
 - 面板关闭再打开会回到「主机」页签：面板是 `main` 插槽的占用者，切回对话时卸载，页签状态不跨开关保留

package/lib/client.js

@@ -565,93 +565,93 @@ if (typeof document !== "undefined" && document.querySelector("style[data-plugin
 	document.head.appendChild(tag);
 }
 var panel_module_css_default = {
-	"modalBackdrop": "hAbY3W_modalBackdrop",
-	"panel": "hAbY3W_panel",
-	"groupCount": "hAbY3W_groupCount",
-	"tab": "hAbY3W_tab",
-	"iconButton": "hAbY3W_iconButton",
-	"banner": "hAbY3W_banner",
-	"panelHeader": "hAbY3W_panelHeader",
-	"utf8Note": "hAbY3W_utf8Note",
-	"cellPre": "hAbY3W_cellPre",
-	"dialog": "hAbY3W_dialog",
+	"table": "hAbY3W_table",
+	"modalFooter": "hAbY3W_modalFooter",
 	"hiddenFile": "hAbY3W_hiddenFile",
-	"linkButton": "hAbY3W_linkButton",
-	"tabBody": "hAbY3W_tabBody",
-	"dirName": "hAbY3W_dirName",
-	"fillBody": "hAbY3W_fillBody",
+	"groupChevron": "hAbY3W_groupChevron",
+	"groupToggle": "hAbY3W_groupToggle",
+	"tab": "hAbY3W_tab",
+	"primaryButton": "hAbY3W_primaryButton",
+	"browsePath": "hAbY3W_browsePath",
+	"consoleInputRow": "hAbY3W_consoleInputRow",
 	"backButton": "hAbY3W_backButton",
-	"mono": "hAbY3W_mono",
-	"actions": "hAbY3W_actions",
-	"tunnelRow": "hAbY3W_tunnelRow",
-	"commandInput": "hAbY3W_commandInput",
-	"ghostButton": "hAbY3W_ghostButton",
-	"dialogOverlay": "hAbY3W_dialogOverlay",
-	"table": "hAbY3W_table",
-	"termBody": "hAbY3W_termBody",
-	"browseList": "hAbY3W_browseList",
-	"radioRow": "hAbY3W_radioRow",
+	"dirType": "hAbY3W_dirType",
+	"termContainer": "hAbY3W_termContainer",
+	"browseHeader": "hAbY3W_browseHeader",
+	"modalBackdrop": "hAbY3W_modalBackdrop",
+	"groupName": "hAbY3W_groupName",
+	"tableWrap": "hAbY3W_tableWrap",
 	"progressBar": "hAbY3W_progressBar",
-	"dialogTitle": "hAbY3W_dialogTitle",
+	"toolbarSpacer": "hAbY3W_toolbarSpacer",
+	"inlineTest": "hAbY3W_inlineTest",
+	"termWrap": "hAbY3W_termWrap",
+	"tunnelLabel": "hAbY3W_tunnelLabel",
+	"dirName": "hAbY3W_dirName",
 	"dirRow": "hAbY3W_dirRow",
-	"groupHeader": "hAbY3W_groupHeader",
-	"consoleOutput": "hAbY3W_consoleOutput",
-	"spinner": "hAbY3W_spinner",
-	"transferBlock": "hAbY3W_transferBlock",
+	"termBody": "hAbY3W_termBody",
+	"dialogOverlay": "hAbY3W_dialogOverlay",
+	"dialog": "hAbY3W_dialog",
+	"utf8Note": "hAbY3W_utf8Note",
 	"consoleHeader": "hAbY3W_consoleHeader",
-	"progressTrack": "hAbY3W_progressTrack",
-	"termContainer": "hAbY3W_termContainer",
-	"loading": "hAbY3W_loading",
+	"mono": "hAbY3W_mono",
+	"spinner": "hAbY3W_spinner",
 	"tunnelList": "hAbY3W_tunnelList",
-	"cellDetails": "hAbY3W_cellDetails",
-	"consoleWrap": "hAbY3W_consoleWrap",
-	"modal": "hAbY3W_modal",
-	"formRow": "hAbY3W_formRow",
-	"progressMeta": "hAbY3W_progressMeta",
+	"groupBySelect": "hAbY3W_groupBySelect",
+	"entryIcon": "hAbY3W_entryIcon",
+	"ghostButton": "hAbY3W_ghostButton",
+	"formCard": "hAbY3W_formCard",
+	"fieldLabel": "hAbY3W_fieldLabel",
 	"controls": "hAbY3W_controls",
-	"modalFooter": "hAbY3W_modalFooter",
-	"groupName": "hAbY3W_groupName",
+	"linkButton": "hAbY3W_linkButton",
+	"formError": "hAbY3W_formError",
 	"modalTitle": "hAbY3W_modalTitle",
-	"radioLabel": "hAbY3W_radioLabel",
-	"toolbarSpacer": "hAbY3W_toolbarSpacer",
-	"browsePanel": "hAbY3W_browsePanel",
+	"tunnelRow": "hAbY3W_tunnelRow",
+	"modal": "hAbY3W_modal",
+	"panelContent": "hAbY3W_panelContent",
+	"empty": "hAbY3W_empty",
+	"loading": "hAbY3W_loading",
+	"progressMeta": "hAbY3W_progressMeta",
 	"checkRow": "hAbY3W_checkRow",
-	"entryIcon": "hAbY3W_entryIcon",
+	"panel": "hAbY3W_panel",
 	"groupSection": "hAbY3W_groupSection",
-	"input": "hAbY3W_input",
-	"formError": "hAbY3W_formError",
-	"empty": "hAbY3W_empty",
+	"banner": "hAbY3W_banner",
+	"formRow": "hAbY3W_formRow",
+	"progressTrack": "hAbY3W_progressTrack",
+	"cellMuted": "hAbY3W_cellMuted",
+	"tabBar": "hAbY3W_tabBar",
+	"browsePanel": "hAbY3W_browsePanel",
+	"cellDetails": "hAbY3W_cellDetails",
 	"entry": "hAbY3W_entry",
-	"badge": "hAbY3W_badge",
-	"field": "hAbY3W_field",
-	"browsePath": "hAbY3W_browsePath",
-	"dshSshSpin": "hAbY3W_dshSshSpin",
-	"toolbar": "hAbY3W_toolbar",
-	"dirType": "hAbY3W_dirType",
+	"dirSize": "hAbY3W_dirSize",
+	"radioRow": "hAbY3W_radioRow",
+	"cellPre": "hAbY3W_cellPre",
+	"search": "hAbY3W_search",
+	"fieldHint": "hAbY3W_fieldHint",
+	"panelHeader": "hAbY3W_panelHeader",
 	"panelTitle": "hAbY3W_panelTitle",
-	"formCard": "hAbY3W_formCard",
-	"browseHeader": "hAbY3W_browseHeader",
-	"entryLabel": "hAbY3W_entryLabel",
-	"groupChevron": "hAbY3W_groupChevron",
-	"panelContent": "hAbY3W_panelContent",
-	"termWrap": "hAbY3W_termWrap",
+	"radioLabel": "hAbY3W_radioLabel",
 	"termPlaceholder": "hAbY3W_termPlaceholder",
-	"fieldHint": "hAbY3W_fieldHint",
-	"groupBySelect": "hAbY3W_groupBySelect",
-	"groupToggle": "hAbY3W_groupToggle",
+	"browseList": "hAbY3W_browseList",
+	"clusterFilters": "hAbY3W_clusterFilters",
+	"transferBlock": "hAbY3W_transferBlock",
+	"consoleWrap": "hAbY3W_consoleWrap",
+	"dshSshSpin": "hAbY3W_dshSshSpin",
+	"groupCount": "hAbY3W_groupCount",
 	"clusterForm": "hAbY3W_clusterForm",
-	"fieldLabel": "hAbY3W_fieldLabel",
-	"cellMuted": "hAbY3W_cellMuted",
-	"tabBar": "hAbY3W_tabBar",
-	"tableWrap": "hAbY3W_tableWrap",
-	"consoleInputRow": "hAbY3W_consoleInputRow",
-	"search": "hAbY3W_search",
-	"inlineTest": "hAbY3W_inlineTest",
+	"consoleOutput": "hAbY3W_consoleOutput",
+	"fillBody": "hAbY3W_fillBody",
+	"entryLabel": "hAbY3W_entryLabel",
+	"toolbar": "hAbY3W_toolbar",
+	"groupHeader": "hAbY3W_groupHeader",
+	"badge": "hAbY3W_badge",
+	"commandInput": "hAbY3W_commandInput",
+	"dialogTitle": "hAbY3W_dialogTitle",
+	"tabBody": "hAbY3W_tabBody",
+	"iconButton": "hAbY3W_iconButton",
+	"field": "hAbY3W_field",
 	"hint": "hAbY3W_hint",
-	"tunnelLabel": "hAbY3W_tunnelLabel",
-	"dirSize": "hAbY3W_dirSize",
-	"clusterFilters": "hAbY3W_clusterFilters",
-	"primaryButton": "hAbY3W_primaryButton"
+	"actions": "hAbY3W_actions",
+	"input": "hAbY3W_input"
 };
 //#endregion
 //#region src/client/panel/ConsoleTab.tsx