dsh-app-deploy 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,11 @@
 # dsh-app-deploy
 
+[![npm](https://img.shields.io/npm/v/dsh-app-deploy)](https://www.npmjs.com/package/dsh-app-deploy)
+
 [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh)（DSH）插件：把交互式部署工具收进 DSH Web 面板。按环境分组管理配置，勾选模块、拖拽编排执行顺序，一键完成 Gradle 构建、rsync 同步与 SSH 远程命令，实时推送日志并保留执行记录。
 
+![插件界面](docs/screenshot.webp)
+
 ## 特性
 
 - **部署面板**：侧边栏「部署」入口，按环境分组管理，模块勾选 + 拖拽排序，一键部署。
@@ -16,19 +20,23 @@
 | --- | --- |
 | Node.js | >= 22 |
 | DSH | >= 0.2.1-rc.3, < 0.3.0 |
-| 部署机工具 | `rsync`、`ssh`；配置 SSH 密码时另需 `sshpass` |
+| 部署机工具 | `rsync`（或 `rclone`）、`ssh`；rsync + SSH 密码时另需 `sshpass`（无 Windows 版） |
+
+> **同步工具回退**：本机有 `rsync` 优先用 rsync over ssh；没有 rsync 时自动回退 `rclone`（SFTP 后端）：前端模块用 `rclone sync`（自带镜像删除，等价 `--delete`），服务端模块用 `rclone copy`（不删除）。rclone 同步自身支持密码与密钥（密钥取 SSH 自定义选项里的 `-i`），不依赖 sshpass。
+>
+> **Windows 主机**：Gradle 构建（`gradlew.bat`）、JDK 自动发现（`JAVA_HOME` + 常见安装目录）、目录浏览均可原生工作。装一个 [rclone](https://rclone.org) 即可获得完整同步能力（含密码认证）；仅当模块配置了远程命令时才需要系统自带 OpenSSH 的 `ssh`——远程命令 + 密码依赖 sshpass（Windows 无此工具），请改用密钥认证（SSH 自定义选项填 `-i 私钥路径`，并清空密码）。
 
 ## 安装
 
 插件发布在 npm，通过 DSH 插件管理器直接安装：
 
 ```text
-plugin_manager → action: install_bundle → target: dsh-app-deploy
+plugin_manager → action: install_bundle → target: dsh-app-deploy@0.2.0
 ```
 
 安装后刷新 DSH Web，左侧导航出现「部署」入口。
 
-卸载用 `plugin_manager` 的 `remove_bundle`；升级先卸载再以同样方式安装（`install_bundle` 按 `name@version` 精确锁定当前发布版本）。
+卸载用 `plugin_manager` 的 `remove_bundle`；升级先卸载再安装新版本（`target` 换成新的 `dsh-app-deploy@<version>`）。
 
 ## 配置
 
@@ -48,6 +56,7 @@ plugin_manager → action: install_bundle → target: dsh-app-deploy
 ```
 清理构建目录 → ./gradlew <task> [-Pkey] [额外参数] [-PexpTime]
   → rsync [-r -t -z] 本地产物 → user@host:远程路径（前端加 --delete）
+    （无 rsync 时回退 rclone：前端 rclone sync / 服务端 rclone copy，走 SFTP）
   → ssh 远程命令（可空）
   → 健康检查（可空：HTTP 2xx + success=true + code=200）
 ```

package/client.js

@@ -48,17 +48,19 @@ window.__ModuleLoader__.load({
     }
     function clone(v) { return JSON.parse(JSON.stringify(v)) }
     function normPath(p) { return (p || '').replace(/\/+$/, '') }
+    // 绝对路径：posix 以 / 开头，Windows 为盘符或 \ 开头（如 C:\proj、D:/proj）
+    function isAbsPath(p) { return /^([a-zA-Z]:[\\/]|[\\/])/.test(p || '') }
     function joinPath(base, name) {
       if (!name) return base || ''
-      if (name.startsWith('/')) return name
+      if (isAbsPath(name)) return name
       const b = base || ''
       if (!b) return name
-      return b === '/' ? '/' + name : b.replace(/\/+$/, '') + '/' + name
+      return b === '/' ? '/' + name : b.replace(/[\\/]+$/, '') + '/' + name
     }
     function parentPath(p) {
       const base = normPath(p || '')
-      if (!base || base === '/') return '/'
-      const i = base.lastIndexOf('/')
+      if (!base || base === '/' || /^[a-zA-Z]:[\\/]?$/.test(base)) return base || '/'
+      const i = Math.max(base.lastIndexOf('/'), base.lastIndexOf('\\'))
       return i <= 0 ? '/' : base.slice(0, i)
     }
     function newEnvId(envs) {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "dsh-app-deploy",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "DSH 插件：按环境编排并执行 Gradle 构建、rsync 同步与 SSH 远程命令的部署面板，实时推送日志并保留执行记录。",
+  "repository": "btboys/dsh-app-deploy",
   "type": "module",
   "icon": "./icon.svg",
   "exports": {

package/server/config.js

@@ -138,6 +138,8 @@ export function getDefaultProjectPath() { return defaultProjectPath }
 
 // ---------- 校验 ----------
 const BAD_PATH = /[\s;"'`$&|<>()*?[\]{}!]/ // 禁止空格/引号/; & | ` $ 等
+// 绝对路径：posix 以 / 开头，Windows 为盘符 + \ 或 /（如 C:\jdk、D:/proj）
+const isAbsPath = (p) => /^(\/|[a-zA-Z]:[\\/])/.test(p)
 const BAD_CMD = /["'`;&|<>$()*?[\]{}!]/ // 允许空格，其余同上
 
 // 前端 .env 文本：只允许 KEY=VALUE（KEY 为 A-Z0-9_）、空行、# 注释
@@ -152,11 +154,11 @@ export function validateFrontEnv(s) {
 
 // 前端 .env 文件路径（仅种子 bsFront/adminFront 有约定路径，供「配置为空时读文件作参考」）
 export function frontEnvFile(e, m) {
-  const p = (e.projectPath || defaultProjectPath || '').replace(/\/+$/, '')
+  const p = (e.projectPath || defaultProjectPath || '').replace(/[\\/]+$/, '')
   if (!p) return null
   const key = m.key ? '.' + m.key : ''
-  if (m.id === 'bsFront') return `${p}/client/client-front/.env${key}`
-  if (m.id === 'adminFront') return `${p}/admin/admin-front/.env${key}`
+  if (m.id === 'bsFront') return path.join(p, 'client/client-front', `.env${key}`)
+  if (m.id === 'adminFront') return path.join(p, 'admin/admin-front', `.env${key}`)
   return null
 }
 
@@ -165,9 +167,9 @@ export function validateEnv(e) {
   if (!/^[a-z0-9-]+$/.test(e.id)) errs.push('ID 只能是小写字母/数字/连字符')
   if (!e.name.trim()) errs.push('名称必填')
   if (e.group && !/^[\u4e00-\u9fa5A-Za-z0-9 -]{1,20}$/.test(e.group)) errs.push('分组只能含中文/字母/数字/空格/连字符，最长 20 字符')
-  if (!e.projectPath.startsWith('/')) errs.push('项目路径必须是绝对路径')
+  if (!isAbsPath(e.projectPath)) errs.push('项目路径必须是绝对路径（如 /opt/proj 或 C:\\proj）')
   if (BAD_PATH.test(e.projectPath)) errs.push('项目路径含非法字符（禁止空格/引号/; & | ` $ 等）')
-  if (e.jdkHome && !e.jdkHome.startsWith('/')) errs.push('JDK 路径必须是绝对路径')
+  if (e.jdkHome && !isAbsPath(e.jdkHome)) errs.push('JDK 路径必须是绝对路径')
   if (e.jdkHome && BAD_PATH.test(e.jdkHome)) errs.push('JDK 路径含非法字符')
   const s = e.ssh
   if (!/^[a-zA-Z0-9.-]+$/.test(s.host)) errs.push('SSH host 非法（仅字母/数字/./-）')

package/server/deployment.js

@@ -3,10 +3,13 @@ import { promises as fsp } from 'node:fs'
 import path from 'node:path'
 import { getEnvs } from './config.js'
 import { getHistory, saveHistory, LOGTAIL_CHARS } from './history.js'
-import { listWorktrees, which } from './local-tools.js'
+import { listWorktrees, which, rcloneObscure } from './local-tools.js'
 import { checkHealth } from './health-check.js'
 
 // ---------- SSE 日志与部署锁（同一时刻只允许一个部署） ----------
+const IS_WIN = process.platform === 'win32'
+// Windows 上 gradlew 是 .bat，必须经 cmd 启动（shell:true 仅用于 win32；参数均过 BAD_CMD 白名单校验）
+const GRADLEW = IS_WIN ? 'gradlew.bat' : './gradlew'
 let running = null // { clients: Set<ServerResponse>, done, label, record, logTail, lastCode }
 let activeProc = null // 当前正在执行的子进程（gradlew/rsync/ssh），插件卸载时终止
 
@@ -42,7 +45,11 @@ setInterval(() => {
 // 插件卸载/重载时终止正在运行的构建子进程，避免 gradlew 成为孤儿继续跑；
 // gradlew 客户端被杀后，daemon 端会因连接断开取消本次构建
 export function killActiveProcess() {
-  try { activeProc?.kill() } catch {}
+  // Windows 上构建进程跑在 cmd.exe 下，kill() 只杀 cmd 会留下 java 孤儿，必须 taskkill 整棵树
+  try {
+    if (activeProc?.pid && IS_WIN) spawn('taskkill', ['/pid', String(activeProc.pid), '/t', '/f'])
+    else activeProc?.kill()
+  } catch {}
   activeProc = null
 }
 
@@ -59,7 +66,7 @@ function runStep(label, args, opts = {}) {
     }
     let child
     try {
-      child = spawn(args[0], args.slice(1), { cwd: opts.cwd, env: opts.env, stdio: ['ignore', 'pipe', 'pipe'] })
+      child = spawn(args[0], args.slice(1), { cwd: opts.cwd, env: opts.env, shell: opts.shell, stdio: ['ignore', 'pipe', 'pipe'] })
       activeProc = child
     } catch (err) {
       broadcast(`启动失败: ${String(err)}\n`)
@@ -79,7 +86,7 @@ async function stopGradleDaemon(env) {
   try {
     const stopEnv = env.jdkHome ? { ...process.env, JAVA_HOME: env.jdkHome } : process.env
     await new Promise((resolve) => {
-      const p = spawn('./gradlew', ['--stop'], { cwd: env.projectPath, env: stopEnv, stdio: 'ignore' })
+      const p = spawn(GRADLEW, ['--stop'], { cwd: env.projectPath, env: stopEnv, shell: IS_WIN, stdio: 'ignore' })
       p.once('error', resolve)
       p.once('close', resolve)
     })
@@ -125,25 +132,27 @@ async function rmTree(p) {
 // 前端（kind=front）：取 localPath 中 dist 及之前部分（client/client-front/dist/fxy/ → …/dist）
 // 服务端（kind=server）：清空 localPath 所在目录（…/build/libs/financial-v5.jar → …/build/libs；目录型 localPath 清空自身）
 export function cleanTarget(env, m) {
-  const pp = env.projectPath.replace(/\/+$/, '')
-  const local = m.localPath.startsWith('/') ? m.localPath : `${pp}/${m.localPath}`
+  const pp = path.resolve(env.projectPath.replace(/[\\/]+$/, ''))
+  const local = path.isAbsolute(m.localPath) ? m.localPath : path.join(pp, m.localPath)
+  // 统一成正斜杠视图做推导，兼容 Windows 反斜杠路径
+  const lv = local.replace(/\\/g, '/')
   let rel
   if (m.kind === 'front') {
-    const i = local.lastIndexOf('/dist')
+    const i = lv.lastIndexOf('/dist')
     if (i < 0) return null
-    rel = local.slice(0, i + 5)
+    rel = lv.slice(0, i + 5)
   } else {
-    const isDir = local.endsWith('/')
-    const p = local.replace(/\/+$/, '')
+    // 目录型（以 / 或 \ 结尾）清空自身，文件型清空所在目录
+    const isDir = /[\\/]$/.test(local)
+    const p = lv.replace(/\/+$/, '')
     rel = isDir ? p : p.slice(0, p.lastIndexOf('/'))
   }
-  const clean = rel.replace(/\/+/g, '/').replace(/\/+$/, '')
   // 安全约束：不含 ..、解析后须在 projectPath 内、深度 ≥ projectPath 下 2 级
-  if (!clean || clean.includes('..')) return null
-  const resolved = clean.startsWith('/') ? clean : `${pp}/${clean}`
-  if (!resolved.startsWith(pp + '/')) return null
-  const depth = resolved.slice(pp.length + 1).split('/').length
-  if (depth < 2) return null
+  if (!rel || rel.includes('..')) return null
+  const resolved = path.resolve(rel.replace(/\/+/g, '/'))
+  const relToPp = path.relative(pp, resolved)
+  if (relToPp.startsWith('..') || path.isAbsolute(relToPp)) return null
+  if (relToPp.split(/[\\/]/).length < 2) return null
   return resolved
 }
 
@@ -167,14 +176,29 @@ async function cleanBuildDir(env, m) {
   }
 }
 
+// 组装 rclone 同步参数（SFTP 后端）：sync 自带 --delete 用于前端镜像，copy 不删用于服务端；
+// 密码用 obscure 混淆值（只进 spawn 参数，不进日志标签）；密钥取 SSH 自定义选项里的 -i
+export function buildRcloneArgs(env, m, local, rclone) {
+  const isFront = m.kind === 'front'
+  const args = [isFront ? 'sync' : 'copy', local, `:sftp:${m.remotePath}`,
+    '--sftp-host', env.ssh.host, '--sftp-port', String(env.ssh.port), '--sftp-user', env.ssh.user,
+    '--stats-one-line', '--stats', '10s', '-v']
+  if (isFront) args.push('--exclude', '.user.ini') // 宝塔锁定文件；exclude 同时豁免 sync 的删除
+  if (rclone.pass) args.push('--sftp-pass', rclone.pass)
+  const key = (env.ssh.options || '').match(/(?:^|\s)-i\s+(\S+)/)
+  if (!rclone.pass && key) args.push('--sftp-key-file', key[1])
+  return args
+}
+
 // 返回退出码与失败阶段（清理/构建/同步/远程命令），用于执行记录
-export async function deployModule(env, m, sshBase, dest, sshpass) {
+// rclone 非空时用 rclone（SFTP）替代 rsync 同步；rsyncEnv 同时承载 sshpass 的 SSHPASS
+export async function deployModule(env, m, sshBase, dest, sshpass, rclone = null) {
   // 0. 清理构建目录（恢复原 update-*.sh 行为）
   const c0 = await cleanBuildDir(env, m)
   if (c0 !== 0) return { code: c0, step: '清理' }
 
   // 1. 构建
-  const buildArgs = ['./gradlew', m.gradleTask]
+  const buildArgs = [GRADLEW, m.gradleTask]
   if (m.key) buildArgs.push(`-Pkey=${m.key}`)
   if (m.extraArgs) buildArgs.push(...m.extraArgs.trim().split(/\s+/).filter(Boolean))
   if (m.kind === 'server' && env.expTime) buildArgs.push(`-PexpTime=${env.expTime}`)
@@ -191,17 +215,26 @@ export async function deployModule(env, m, sshBase, dest, sshpass) {
       if (/^[A-Za-z0-9_]+$/.test(k)) envForGradle[k] = v
     }
   }
-  const c1 = await runStep(`[${m.name}] 构建: ${buildArgs.join(' ')} ${jdkNote}`, buildArgs, { cwd: env.projectPath, env: envForGradle })
+  const c1 = await runStep(`[${m.name}] 构建: ${buildArgs.join(' ')} ${jdkNote}`, buildArgs, { cwd: env.projectPath, env: envForGradle, shell: IS_WIN })
   if (c1 !== 0) { broadcast(`[${m.name}] 构建失败，退出码 ${c1}，中止部署\n`); return { code: c1, step: '构建' } }
 
-  // 2. rsync（--delete 仅用于前端模块，与原脚本行为一致）
-  const local = m.localPath.startsWith('/') ? m.localPath : `${env.projectPath.replace(/\/+$/, '')}/${m.localPath}`
-  const rsyncArgs = ['rsync', '-r', '-t', '-z', '-e', sshpass ? `sshpass -e ${sshBase}` : sshBase]
+  // 2. 同步：优先 rsync；本机没有时回退 rclone（--delete 仅用于前端模块，与原脚本行为一致）
   const isFront = m.kind === 'front'
-  if (isFront) rsyncArgs.push('--delete', '--exclude=.user.ini') // 排除宝塔 .user.ini（chattr +i 锁定，--delete 无法删除且会导致退出码非 0）
-  rsyncArgs.push(local, `${dest}:${m.remotePath}`)
+  // 保留 rsync 的目录尾斜杠语义：dist/ 传内容本身，dist 传 dist 目录
+  const isDirLike = /[\\/]$/.test(m.localPath)
+  const joined = path.isAbsolute(m.localPath) ? m.localPath : path.join(env.projectPath, m.localPath)
+  const local = joined.replace(/[\\/]+$/, '') + (isDirLike ? '/' : '')
   const rsyncEnv = sshpass ? { ...process.env, SSHPASS: env.ssh.password } : process.env
-  const c2 = await runStep(`[${m.name}] rsync ${local} → ${dest}:${m.remotePath}${isFront ? '（--delete）' : ''}`, rsyncArgs, { env: rsyncEnv })
+  let c2
+  if (rclone) {
+    const args = buildRcloneArgs(env, m, local, rclone)
+    c2 = await runStep(`[${m.name}] rclone ${isFront ? 'sync' : 'copy'} ${local} → :sftp:${m.remotePath}${isFront ? '（镜像 --delete）' : ''}`, [rclone.bin, ...args], {})
+  } else {
+    const rsyncArgs = ['rsync', '-r', '-t', '-z', '-e', sshpass ? `sshpass -e ${sshBase}` : sshBase]
+    if (isFront) rsyncArgs.push('--delete', '--exclude=.user.ini') // 排除宝塔 .user.ini（chattr +i 锁定，--delete 无法删除且会导致退出码非 0）
+    rsyncArgs.push(local, `${dest}:${m.remotePath}`)
+    c2 = await runStep(`[${m.name}] rsync ${local} → ${dest}:${m.remotePath}${isFront ? '（--delete）' : ''}`, rsyncArgs, { env: rsyncEnv })
+  }
   if (c2 !== 0) { broadcast(`[${m.name}] 同步失败，退出码 ${c2}，中止部署\n`); return { code: c2, step: '同步' } }
 
   // 3. ssh 远程命令
@@ -223,17 +256,43 @@ export async function deployModule(env, m, sshBase, dest, sshpass) {
 async function runDeployment(env, mods) {
   let code = 1
   try {
-    const sshpass = env.ssh.password ? await which('sshpass') : null
-    if (env.ssh.password && !sshpass) {
-      broadcast('错误: 配置了 SSH 密码但本机没有 sshpass。请先安装: brew install hudochenkov/sshpass/sshpass\n')
+    // 预检本地工具，缺失时给出可操作的提示（避免到同步步骤才报 127 启动失败）
+    // 同步优先 rsync，缺失回退 rclone（SFTP）；ssh 仅 rsync 传输或有远程命令时需要
+    const hasRsync = await which('rsync')
+    const rcloneBin = hasRsync ? null : await which('rclone')
+    const needSsh = mods.some(m => m.enabled && m.postCommand.trim())
+    const missing = []
+    if (!hasRsync && !rcloneBin) missing.push('rsync（或 rclone）')
+    if ((hasRsync || needSsh) && !(await which('ssh'))) missing.push('ssh')
+    // sshpass：rsync 密码传输恒需要；rclone 模式自身支持密码，仅「密码 + 远程命令」时才需要
+    const needSshpass = !!env.ssh.password && (hasRsync || needSsh)
+    const sshpass = needSshpass ? await which('sshpass') : null
+    if (missing.length) {
+      broadcast(`错误: 本机未找到 ${missing.join('、')}（须在 PATH 中）。${IS_WIN ? 'Windows 可安装 rclone 替代 rsync（https://rclone.org），ssh 用系统自带 OpenSSH' : '请先安装 rsync（或 rclone）与 OpenSSH'}\n`)
+      code = 127
+    } else if (needSshpass && !sshpass) {
+      broadcast(IS_WIN
+        ? '错误: 远程命令 + SSH 密码需要 sshpass，而 Windows 无此工具；请改用密钥认证（SSH 自定义选项填 -i 私钥路径，并清空密码），或移除远程命令让 rclone 直接同步\n'
+        : '错误: 配置了 SSH 密码但本机没有 sshpass。请先安装: brew install hudochenkov/sshpass/sshpass\n')
       code = 127
     } else {
       const sshBase = `ssh -p ${env.ssh.port}${env.ssh.options ? ' ' + env.ssh.options : ''}`
       const dest = `${env.ssh.user}@${env.ssh.host}`
+      // rclone 密码认证走 obscure 混淆值（失败立即中止，避免到同步步骤才报错）
+      let rclone = null
+      if (rcloneBin) {
+        const pass = env.ssh.password ? await rcloneObscure(rcloneBin, env.ssh.password) : null
+        if (env.ssh.password && !pass) {
+          broadcast('错误: rclone obscure 密码处理失败，无法使用密码认证\n')
+          code = 127
+          return finishDeploy(code) // 尚未构建，无需停 daemon
+        }
+        rclone = { bin: rcloneBin, pass }
+      }
       code = 0
       for (const m of mods) {
         if (!m.enabled) { broadcast(`[跳过] ${m.name} 已禁用\n`); continue }
-        const res = await deployModule(env, m, sshBase, dest, sshpass)
+        const res = await deployModule(env, m, sshBase, dest, sshpass, rclone)
         if (res.code !== 0) {
           if (running?.record) { running.record.failedModule = m.name; running.record.failedStep = res.step }
           code = res.code

package/server/local-tools.js

@@ -16,13 +16,22 @@ function run(cmd, args, options = {}) {
   })
 }
 
-// 等价旧 Bun.which：找到返回绝对路径，找不到返回 null
+const IS_WIN = process.platform === 'win32'
+
+// 等价旧 Bun.which：找到返回绝对路径，找不到返回 null（Windows 用 where）
 export async function which(command) {
-  const { code, stdout } = await run('which', [command])
-  const found = stdout.trim()
+  const { code, stdout } = await run(IS_WIN ? 'where' : 'which', [command])
+  const found = stdout.split('\n')[0].trim()
   return code === 0 && found ? found : null
 }
 
+// rclone obscure 密码混淆（--sftp-pass 只接受混淆值）；失败返回 null
+export async function rcloneObscure(bin, password) {
+  const { code, stdout } = await run(bin, ['obscure', password])
+  const v = stdout.trim()
+  return code === 0 && v ? v : null
+}
+
 // 列出目录所在 git 仓库的全部 worktree（含主工作区）；非 git 仓库/失败返回空数组
 export async function listWorktrees(dir) {
   const worktrees = []
@@ -98,16 +107,32 @@ export async function listJdks() {
       for (const v of vers) found.add(path.join(vdir, v, 'libexec/openjdk.jdk/Contents/Home'))
     }
   } catch {}
+  // Windows：JAVA_HOME + 常见厂商安装目录（Oracle / Temurin / Microsoft / Zulu / Corretto）
+  if (IS_WIN) {
+    if (process.env.JAVA_HOME) found.add(process.env.JAVA_HOME)
+    const roots = [process.env.ProgramFiles, process.env['ProgramFiles(x86)']].filter(Boolean)
+    const vendors = ['Java', 'Eclipse Adoptium', 'Eclipse Foundation', 'Microsoft', 'Zulu', 'Amazon Corretto']
+    for (const root of roots) {
+      for (const vendor of vendors) {
+        try { for (const n of await fsp.readdir(path.join(root, vendor))) found.add(path.join(root, vendor, n)) } catch {}
+      }
+    }
+  }
   // 只保留 bin/java 真实存在者，生成友好短名
   const jdks = []
-  for (const p of found) if (await fileExists(`${p}/bin/java`)) {
-    const m = p.match(/\/JavaVirtualMachines\/([^/]+)\.jdk\/Contents\/Home$/)
+  for (const p of found) if (await fileExists(path.join(p, 'bin', IS_WIN ? 'java.exe' : 'java'))) {
+    // 标签推导统一用正斜杠视图（Windows 反斜杠路径也能复用同一套正则）
+    const pv = p.replace(/\\/g, '/')
+    const m = pv.match(/\/JavaVirtualMachines\/([^/]+)\.jdk\/Contents\/Home$/)
     let label
     if (m) label = (m[1].match(/\d+(?:\.\d+)*/) || [])[1] || m[1]
-    else if (p.includes('/opt/homebrew/')) {
-      const v = (p.match(/openjdk@?(\d+)/) || [])[1] || (p.match(/\/(\d+(?:\.\d+)+)\/libexec/) || [])[1]
+    else if (pv.includes('/opt/homebrew/')) {
+      const v = (pv.match(/openjdk@?(\d+)/) || [])[1] || (pv.match(/\/(\d+(?:\.\d+)+)\/libexec/) || [])[1]
       label = v ? 'homebrew-' + v : 'homebrew'
-    } else label = p.split('/').filter(Boolean).pop()
+    } else if (/^[a-zA-Z]:\//.test(pv)) {
+      const segs = pv.split('/').filter(Boolean)
+      label = segs.pop() || pv
+    } else label = pv.split('/').filter(Boolean).pop()
     jdks.push({ label, path: p })
   }
   // 短名去重：同名者追加版本/opt-cellar 段区分
@@ -139,7 +164,7 @@ export async function listJdks() {
 export async function browseDirectory(args = {}) {
   let p = typeof args.path === 'string' ? args.path : ''
   const showHidden = args.hidden === true || args.hidden === '1' || args.hidden === 1
-  if (!p) p = process.env.HOME || '/'
+  if (!p) p = process.env.HOME || (IS_WIN ? (process.env.USERPROFILE || 'C:\\') : '/')
   if (!path.isAbsolute(p)) throw new Error('必须为绝对路径')
   p = path.resolve(p)
   try {

package/server/rpc.js

@@ -4,6 +4,11 @@ import { getHistory, replaceHistory, HIST_LIMIT } from './history.js'
 import { activeRecord } from './deployment.js'
 import { listJdks, listWorktrees, readGitInfo, browseDirectory, which } from './local-tools.js'
 
+// sshpass 无 Windows 版本；警告文案按平台给出可操作的下一步（保存/导入两处共用）
+const SSHPASS_HINT = process.platform === 'win32'
+  ? '但本机没有 sshpass（Windows 无此工具），部署时无法使用密码认证；请改用密钥认证（SSH 自定义选项填 -i 私钥路径，并清空密码）'
+  : '但本机未安装 sshpass，部署时无法使用密码认证。请先执行: brew install hudochenkov/sshpass/sshpass'
+
 // JSON-RPC 方法表：与旧 server.ts 的 /api/* 逐一对齐（字段名不变）
 const methods = {
   config: () => {
@@ -27,7 +32,7 @@ const methods = {
     await saveEnvs()
     let warning = ''
     if (env.ssh.password && !(await which('sshpass'))) {
-      warning = '已保存，但本机未安装 sshpass，部署时无法使用密码认证。请先执行: brew install hudochenkov/sshpass/sshpass'
+      warning = '已保存，' + SSHPASS_HINT
     }
     return { envs: getEnvs(), warning }
   },
@@ -68,7 +73,7 @@ const methods = {
     const touched = new Set([...added, ...overwritten])
     let warning = ''
     if (getEnvs().some(e => touched.has(e.id) && e.ssh.password) && !(await which('sshpass'))) {
-      warning = '已导入，但本机未安装 sshpass，部署时无法使用密码认证。请先执行: brew install hudochenkov/sshpass/sshpass'
+      warning = '已导入，' + SSHPASS_HINT
     }
     return { envs: getEnvs(), added, overwritten, warning }
   },