zcode-pro 0.17.1 → 0.18.0

package/src/host/main.mjs

@@ -5,8 +5,8 @@
 // 3. 连接 CDP，向所有页面注入增强脚本（新文档自动注入 + 已加载页面立即注入）
 // 4. 启动本地辅助 HTTP 服务并常驻，CDP 断开时自动重连
 import { spawn, execSync, spawnSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { randomBytes } from 'node:crypto';
 import { resolveZcodeExecutable, resolveDataRootDir } from './paths.mjs';
@@ -17,6 +17,17 @@ import { runSetup } from './setup.mjs';
 const here = dirname(fileURLToPath(import.meta.url));
 const INJECT_BUNDLE = resolve(here, '..', '..', 'dist', 'inject.js');
 
+// Windows 控制台中文乱码适配：输出为 UTF-8 字节，旧版 conhost/PowerShell 的默认
+// 代码页（936/GBK）按 GBK 解码会显示乱码。检测到真实控制台且非 UTF-8 代码页时
+// 切到 65001——只影响当前控制台会话（重开终端即恢复），重定向/非交互不干预。
+// 放在模块顶层：cli.mjs 经 import main.mjs 进入，setup 等子命令的输出同样受益。
+if (process.platform === 'win32' && process.stdout.isTTY) {
+  try {
+    const cp = execSync('chcp.com', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true }).match(/(\d+)/)?.[1];
+    if (cp && cp !== '65001') execSync('chcp.com 65001', { stdio: 'ignore', windowsHide: true });
+  } catch { /* 无控制台或 chcp 不可用时保持原样 */ }
+}
+
 function usage() {
   return `ZCode Pro — ZCode 桌面版界面增强启动器
 
@@ -74,6 +85,26 @@ function guiNotify(title, body) {
   } catch { /* ignore */ }
 }
 
+// Windows 快捷方式静默启动时控制台与桌面通知都不可见（guiNotify 仅 linux 有渠道），
+// 关键启动阶段与致命错误落盘 ~/.zcode/zcodepro.log，便于排查“双击没反应”（issue #1）。
+// 日志超 512KB 时轮转为 .old（zcode-pro.cmd 失败分支有同款轮转，需同步维护）。
+let winLogRotated = false;
+function winLog(line) {
+  if (process.platform !== 'win32') return;
+  try {
+    const dir = resolveDataRootDir();
+    mkdirSync(dir, { recursive: true });
+    const file = join(dir, 'zcodepro.log');
+    if (!winLogRotated) {
+      winLogRotated = true;
+      try {
+        if (existsSync(file) && statSync(file).size > 512 * 1024) renameSync(file, `${file}.old`);
+      } catch { /* ignore */ }
+    }
+    appendFileSync(file, `[${new Date().toISOString()}] ${line}\n`);
+  } catch { /* ignore */ }
+}
+
 async function cdpAlive(port) {
   try { await fetchBrowserWsUrl(port, 1200); return true; } catch { return false; }
 }
@@ -147,9 +178,13 @@ export async function run(argv) {
   try {
     exe = resolveZcodeExecutable(args.zcodePath);
   } catch (err) {
-    if (err.code === 'ZCODE_NOT_FOUND') guiNotify('ZCode Pro 启动失败', '未找到 ZCode 可执行文件，详见终端输出。');
+    if (err.code === 'ZCODE_NOT_FOUND') {
+      winLog('未找到 ZCode 可执行文件: ' + err.message);
+      guiNotify('ZCode Pro 启动失败', '未找到 ZCode 可执行文件，详见终端输出。');
+    }
     throw err;
   }
+  winLog(`启动: ZCode=${exe}, CDP 端口 ${args.cdpPort}`);
   const dataRoot = resolveDataRootDir();
   const token = randomBytes(16).toString('hex');
   const state = { injectedPages: 0 };
@@ -166,10 +201,12 @@ export async function run(argv) {
     if (!ok) {
       console.error(`[zcodepro] 等待 ZCode 调试端口 ${args.cdpPort} 超时。`);
       if (zcodeAppProcessExists()) {
+        winLog(`等待 CDP 端口 ${args.cdpPort} 超时：ZCode 已在运行但未开调试端口，需先退出原实例`);
         console.error('[zcodepro] 检测到 ZCode 已在运行，但未开启调试端口，无法注入。');
         console.error('[zcodepro] 请手动退出当前 ZCode（zcodepro 不会替你关闭正在运行的实例），然后重新运行 zcodepro。');
         guiNotify('ZCode Pro 暂无法注入', 'ZCode 已在运行但未开启调试端口，请退出 ZCode 后重新打开 ZCode Pro。');
       } else {
+        winLog(`等待 CDP 端口 ${args.cdpPort} 超时（未见 ZCode 进程）`);
         guiNotify('ZCode Pro 启动失败', `等待 ZCode 调试端口 ${args.cdpPort} 超时。`);
       }
       process.exit(1);
@@ -191,6 +228,7 @@ export async function run(argv) {
     healthRes = await fetch(`http://127.0.0.1:${args.helperPort}/health`, { headers: { 'X-ZCodePro-Token': token } }).then((r) => r.json());
   } catch (err) {
     console.error(`[zcodepro] 辅助服务健康检查失败: ${err.message}`);
+    winLog('辅助服务健康检查失败: ' + err.message);
     server.close();
     process.exit(1);
   }
@@ -253,10 +291,12 @@ export async function run(argv) {
   }
   if (!conn) {
     console.error('[zcodepro] 无法连接 CDP，退出。');
+    winLog('无法连接 CDP，退出');
     server.close();
     process.exit(1);
   }
   console.log('[zcodepro] 已连接 CDP 并开始注入。保持本进程运行以维持增强；Ctrl+C 退出（不影响 ZCode）。');
+  winLog('已连接 CDP 并开始注入');
 
   process.on('SIGINT', () => { stopping = true; try { conn.close(); } catch {} server.close(); process.exit(0); });
   process.on('SIGTERM', () => { stopping = true; try { conn.close(); } catch {} server.close(); process.exit(0); });
@@ -268,6 +308,7 @@ export async function run(argv) {
     // 连接断开：ZCode 退出则一并退出，否则重连
     if (!(await cdpAlive(args.cdpPort))) {
       console.log('[zcodepro] ZCode 已退出，zcodepro 一并退出。');
+      winLog('ZCode 已退出，zcodepro 一并退出');
       server.close();
       process.exit(0);
     }

package/src/host/paths.mjs

@@ -1,13 +1,29 @@
 // 跨平台定位 ZCode 桌面版可执行文件。
-// 优先级：--zcode-path 参数 > ZCODEPRO_ZCODE_PATH 环境变量 > 平台默认候选路径 > 注册表（Windows） > PATH 上的 zcode。
+// 优先级：--zcode-path 参数 > ZCODEPRO_ZCODE_PATH 环境变量（进程 > 用户注册表） >
+// 平台默认候选路径 > 注册表 App Paths/卸载表（Windows） > PATH 上的 zcode。
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { arch, homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
 
+// reg 输出按行取 REG_SZ 后的值，容忍引号与 ",0" 图标序号后缀。
+const reg = (args) => {
+  try {
+    return execFileSync('reg', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+  } catch { return ''; }
+};
+const valueAfter = (out) => (out.split(/REG_SZ\s+/)[1] || '').trim();
+
+// 安装脚本 -ZCodePath 持久化的用户级环境变量（HKCU\Environment）：写入后不会传播
+// 到已运行的资源管理器，进程环境变量读不到时从这里兜底，免注销/重启（issue #1）。
+function windowsUserEnvZcodePath() {
+  const value = valueAfter(reg(['query', 'HKCU\\Environment', '/v', 'ZCODEPRO_ZCODE_PATH']));
+  return value ? [value] : [];
+}
+
 // Windows 注册表探测（结果缓存）：自定义安装目录的安装器会在 App Paths（可执行
 // 文件全路径）或卸载表 DisplayIcon（控制面板-卸载软件里可见）留有登记，固定
-// 候选找不到时兜底。reg 输出按行取 REG_SZ 后的值，容忍引号与 ",0" 图标序号后缀。
+// 候选找不到时兜底。
 let winRegistryCandidates;
 
 function windowsRegistryCandidates() {
@@ -21,18 +37,16 @@ function windowsRegistryCandidates() {
       winRegistryCandidates.push(p);
     }
   };
-  const reg = (args) => {
-    try {
-      return execFileSync('reg', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
-    } catch { return ''; }
-  };
-  const valueAfter = (out) => (out.split(/REG_SZ\s+/)[1] || '').trim();
   // App Paths：安装器注册的可执行文件全路径（ShellExecute 同款查找）
   for (const root of ['HKLM', 'HKCU']) {
     const out = reg(['query', `${root}\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\zcode.exe`, '/ve']);
     if (out) push(valueAfter(out));
   }
-  // 卸载表 DisplayIcon：安装目录自定义时通常只有这里能找到
+  // 卸载表 DisplayIcon：安装目录自定义时通常只有这里能找到。
+  // ZCode 的 NSIS 安装器不写 App Paths、DisplayIcon 常指向 uninstallerIcon.ico，
+  // 从其所在目录推导 ZCode.exe（win11 虚拟机实测，issue #1）。逐条验证取第一个
+  // 有效命中。zcode-pro.cmd 与 install.ps1 也各自实现卸载表定位（匹配方式不完全
+  // 相同），改推导规则需三处同步。
   for (const key of [
     'HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall',
     'HKLM\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall',
@@ -41,7 +55,14 @@ function windowsRegistryCandidates() {
     const out = reg(['query', key, '/s', '/v', 'DisplayIcon']);
     for (const line of out.split(/\r?\n/)) {
       const seg = (line.split(/REG_SZ\s+/)[1] || '').trim();
-      if (seg && /zcode/i.test(seg)) push(seg);
+      if (seg && /zcode/i.test(seg)) {
+        push(seg);
+        const dir = seg.replace(/[^\\\/]+$/, '');
+        if (dir) {
+          push(join(dir, 'ZCode.exe'));
+          push(join(dir, 'zcode.exe'));
+        }
+      }
     }
   }
   return winRegistryCandidates;
@@ -53,6 +74,7 @@ function candidates() {
     const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
     const programFiles = process.env.PROGRAMFILES || 'C:\\Program Files';
     return [
+      ...windowsUserEnvZcodePath(),
       join(localAppData, 'Programs', 'ZCode', 'ZCode.exe'),
       join(localAppData, 'Programs', 'zcode', 'zcode.exe'),
       join(programFiles, 'ZCode', 'ZCode.exe'),

package/src/host/pickFolder.mjs

@@ -1,5 +1,5 @@
-// 系统原生目录选择器（Linux：xdg-desktop-portal FileChooser，经 gdbus 调用，
-// KDE/GNOME 弹出各自的原生对话框），支持指定起始目录。
+// 系统原生目录选择器（Windows：PowerShell FolderBrowserDialog；Linux：xdg-desktop-portal
+// FileChooser，经 gdbus 调用，KDE/GNOME 弹出各自的原生对话框），支持指定起始目录。
 // 返回 { path: string | null }（用户取消为 null）或 { unavailable: true }（环境无可用选择器）。
 
 import { spawn, spawnSync } from 'node:child_process';
@@ -133,10 +133,55 @@ function portalPickFolder(startDir, title, timeoutMs) {
   });
 }
 
+// Windows：PowerShell 的 FolderBrowserDialog（系统自带 .NET，无需额外安装）。
+// -STA 是对话框的线程模型要求；无属主窗口的对话框可能沉到别的窗口后面，
+// 用一个 TopMost 空窗当属主强制置前。startDir 经 SelectedPath 预选（路径不存在
+// 时对话框自行忽略）；输出编码固定 UTF-8——GUI 启动的进程无控制台，PowerShell
+// 重定向输出默认走 OEM 代码页（中文系统是 936），Node 按 UTF-8 解码会乱码。
+// 返回路径 / null（取消或超时）/ undefined（起不来）
+function powershellPickFolder(startDir, title, timeoutMs = 600000) {
+  return new Promise((resolve) => {
+    const safeTitle = String(title || '').replace(/'/g, "''");
+    const safeStart = String(startDir || '').replace(/'/g, "''");
+    const script = [
+      '[Console]::OutputEncoding = [System.Text.Encoding]::UTF8',
+      'Add-Type -AssemblyName System.Windows.Forms | Out-Null',
+      "$owner = New-Object System.Windows.Forms.Form",
+      '$owner.TopMost = $true',
+      '$d = New-Object System.Windows.Forms.FolderBrowserDialog',
+      `$d.Description = '${safeTitle}'`,
+      ...(safeStart ? [`$d.SelectedPath = '${safeStart}'`] : []),
+      "if ($d.ShowDialog($owner) -eq [System.Windows.Forms.DialogResult]::OK) { [Console]::Out.Write($d.SelectedPath) }",
+    ].join('; ');
+    let out = '';
+    let done = false;
+    const finish = (v) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      try { child.kill(); } catch { /* ignore */ }
+      resolve(v);
+    };
+    const child = spawn('powershell', ['-NoProfile', '-STA', '-Command', script], {
+      stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
+    });
+    child.on('error', () => finish(undefined));
+    child.stdout.on('data', (d) => { out += d.toString(); });
+    // 退出码非 0 = PowerShell 本身出错（视为不可用）；0 且无输出 = 用户取消
+    child.on('close', (code) => finish(code === 0 ? (out.trim() || null) : undefined));
+    const timer = setTimeout(() => finish(null), timeoutMs);
+  });
+}
+
 export async function pickFolderSystem(startDir, title, timeoutMs = 180000) {
+  const dialogTitle = title || '选择文件夹';
+  if (process.platform === 'win32') {
+    const r = await powershellPickFolder(String(startDir || ''), dialogTitle, timeoutMs);
+    if (r !== undefined) return { path: r };
+    return { unavailable: true };
+  }
   if (process.platform !== 'linux') return { unavailable: true };
   const start = firstExistingDir(String(startDir || '/'));
-  const dialogTitle = title || '选择文件夹';
   if (kdialogAvailable()) {
     const r = await kdialogPickFolder(start, dialogTitle);
     if (r !== undefined) return { path: r };

package/src/host/setup.mjs

@@ -148,7 +148,7 @@ const psQuote = (s) => String(s).replace(/'/g, "''"); // PowerShell 单引号字
 // 桌面目录由 PowerShell 的 GetFolderPath 解析（正确跟随 OneDrive 重定向等）。
 // wshOk 为假（WSH 异常的机器）时降级：.lnk 直接经 cmd 最小化启动，不再依赖
 // wscript+vbs，代价是启动瞬间任务栏短暂闪一个最小化控制台
-export function windowsShortcutPlan(cmd, desktop = false, wshOk = true) {
+export function windowsShortcutPlan(cmd, desktop = false, wshOk = true, menuLnk = true) {
   const paths = windowsPaths();
   // vbs 由 wscript 按 ANSI 代码页解析（不支持 UTF-8），内容只用 ASCII
   const vbsContent = [
@@ -163,7 +163,7 @@ export function windowsShortcutPlan(cmd, desktop = false, wshOk = true) {
     '  Next',
     '  cmd = cmd & " " & Join(parts, " ")',
     'End If',
-    'sh.Run cmd, 0, False',
+    'sh.Run "cmd.exe /d /c " & cmd, 0, False',
     '',
   ].join('\r\n');
   // 图标复用已安装的 ZCode：探测走 paths.mjs 同一条优先级（含注册表，覆盖自定义
@@ -193,9 +193,11 @@ export function windowsShortcutPlan(cmd, desktop = false, wshOk = true) {
     "$ErrorActionPreference = 'Stop'",
     '$wsh = New-Object -ComObject WScript.Shell',
     ...setProps,
-    `$lnk = $wsh.CreateShortcut('${psQuote(paths.lnkPath)}')`,
-    'setProps $lnk',
-    '$lnk.Save()',
+    ...(menuLnk ? [
+      `$lnk = $wsh.CreateShortcut('${psQuote(paths.lnkPath)}')`,
+      'setProps $lnk',
+      '$lnk.Save()',
+    ] : []),
     ...(desktop ? [
       "$desk = Join-Path ([Environment]::GetFolderPath('Desktop')) 'ZCode Pro.lnk'",
       '$dl = $wsh.CreateShortcut($desk)',
@@ -209,6 +211,16 @@ export function windowsShortcutPlan(cmd, desktop = false, wshOk = true) {
   return { ...paths, vbsContent, psScript, icon, wshOk };
 }
 
+// 桌面 .lnk 的 JS 侧近似路径（仅用于结果汇报与“外来不覆盖”预判；实际创建仍走
+// PowerShell 的 GetFolderPath，正确跟随 OneDrive 重定向）。OneDrive 桌面重定向时
+// 桌面在 %OneDrive%\Desktop，未重定向时在用户主目录
+export function desktopLnkPathApprox() {
+  for (const od of [process.env.OneDrive, process.env.OneDriveConsumer]) {
+    if (od && existsSync(join(od, 'Desktop'))) return join(od, 'Desktop', 'ZCode Pro.lnk');
+  }
+  return join(homedir(), 'Desktop', 'ZCode Pro.lnk');
+}
+
 // —— 快捷方式设置项 ——
 
 const DESKTOP_FILE = 'zcode-pro.desktop';
@@ -346,10 +358,18 @@ const shortcutItem = {
 
   installWindows(cmd, opts = {}) {
     const wshOk = windowsWshOk();
-    const plan = windowsShortcutPlan(cmd, !!opts.desktop, wshOk);
-    // .lnk 已存在且不属于本功能（Arguments 无归属标记）＝ install.ps1 等其他方式创建，不覆盖
-    if (existsSync(plan.lnkPath) && !lnkIsOurs(plan.lnkPath)) {
-      return { skipped: `已存在其他方式创建的 ${plan.lnkPath}，未覆盖` };
+    // 菜单/桌面两个 .lnk 各自独立判断“外来不覆盖”，互不连坐（与 Linux/macOS 的
+    // 桌面条目一致）：开始菜单被 install.ps1 等创建占位时，桌面快捷方式仍应能建
+    const paths = windowsPaths();
+    const menuForeign = existsSync(paths.lnkPath) && !lnkIsOurs(paths.lnkPath);
+    const deskPath = desktopLnkPathApprox();
+    const deskForeign = !!opts.desktop && existsSync(deskPath) && !lnkIsOurs(deskPath);
+    const plan = windowsShortcutPlan(cmd, !!opts.desktop, wshOk, !menuForeign);
+    if (menuForeign && (!opts.desktop || deskForeign)) {
+      return { skipped: [
+        menuForeign ? `已存在其他方式创建的 ${plan.lnkPath}，未覆盖` : '',
+        deskForeign ? `桌面 ${deskPath} 已存在其他方式创建的条目，未覆盖` : '',
+      ].filter(Boolean).join('；') };
     }
     if (wshOk) {
       mkdirSync(plan.vbsDir, { recursive: true });
@@ -359,7 +379,12 @@ const shortcutItem = {
     const how = wshOk
       ? `经 ${plan.vbsPath} 静默启动`
       : '本机 WSH 异常，经 cmd 最小化启动（启动时会短暂闪烁控制台窗口）';
-    return { detail: `已创建 ${plan.lnkPath}（${how}${opts.desktop ? '，含桌面' : ''}）` };
+    const parts = [];
+    parts.push(menuForeign
+      ? `开始菜单 ${plan.lnkPath} 已存在其他方式创建的条目，未覆盖`
+      : `已创建 ${plan.lnkPath}`);
+    if (opts.desktop) parts.push(deskForeign ? `桌面 ${deskPath} 已存在其他方式创建的条目，未覆盖` : '已创建桌面快捷方式');
+    return { detail: `${parts.join('；')}（${how}）` };
   },
 
   installMac(cmd, opts = {}) {

package/src/host/webdav.mjs

@@ -1,7 +1,10 @@
-// WebDAV 传输（设置同步用）：用 curl 子进程完成 GET / PUT / MKCOL。
-// Basic 凭据经 stdin 的 --config 文件传入，不进命令行参数；代理由调用方以
-// proxyUrl 注入（与 helper 其他网络访问一致，空 = 不用代理）。
-import { spawn } from 'node:child_process';
+// WebDAV 传输（设置同步用，rtk 升级的 GitHub 请求也复用）：优先用 curl 子进程完成
+// GET / PUT / MKCOL / DELETE / PROPFIND。Basic 凭据经 stdin 的 --config 文件传入，
+// 不进命令行参数；代理由调用方以 proxyUrl 注入（与 helper 其他网络访问一致，空 = 不用代理）。
+// 环境里没有 curl 时（常见于老 Windows / 精简系统虚拟机）自动回退到 Node 自带
+// fetch 直连：凭据改走 Authorization 头，代理在该路径不生效；设
+// ZCODEPRO_SYNC_FORCE_FETCH=1 可强制走 fetch（排障/测试用）。
+import { spawn, spawnSync } from 'node:child_process';
 import { mkdtemp } from 'node:fs/promises'; // fs 的 mkdtemp 是回调版，await 它会把 undefined 当回调
 import { readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -20,6 +23,7 @@ const CURL_EXIT = {
 
 // HTTP 状态 → 同步场景的人话（404 不算失败，由调用方按“云端没有数据”处理）
 export function webdavHttpText(code) {
+  if (code === 404) return '文件或目录不存在（HTTP 404，可能已被删除）';
   if (code === 401 || code === 403) return `登录或密码被拒绝（HTTP ${code}；坚果云等网盘需使用应用密码，不是登录密码）`;
   if (code === 405) return '服务器不允许该操作（HTTP 405）';
   if (code === 409) return '目标目录不存在（HTTP 409）';
@@ -40,15 +44,92 @@ function proxyEnvVars(proxyUrl) {
   };
 }
 
-// 执行一次 WebDAV 请求。method 为 GET / PUT / MKCOL；PUT 用 uploadFile 上传
-// （-T 隐含 PUT）。返回 { ok, httpCode, body, error }：ok 表示 curl 本身执行
-// 成功（HTTP 4xx/5xx 也算 ok，由调用方看 httpCode 分支）；error 为中文原因。
-export async function webdavRequest({ method, url, login = '', password = '', uploadFile = null, proxyUrl = '', timeoutMs = 45000 }) {
+// curl 解析（进程内只探测一次）：先按 PATH 探测；Windows 上再补测 System32 下的
+// curl.exe（Win10 1803+ 自带，但精简环境的 PATH 可能不含）。都不存在返回 null，
+// 后续请求全部走 fetch 兜底。ZCODEPRO_SYNC_FORCE_FETCH=1 强制跳过 curl（排障/测试）。
+// 导出供 /proxy/test（代理连通性检测也依赖 curl，同样受精简 PATH 影响）复用。
+let curlResolved;
+export function findCurl() {
+  if (curlResolved !== undefined) return curlResolved;
+  if (process.env.ZCODEPRO_SYNC_FORCE_FETCH === '1') {
+    curlResolved = null;
+    return null;
+  }
+  const candidates = ['curl'];
+  if (process.platform === 'win32') {
+    const sysRoot = process.env.SystemRoot || process.env.windir || 'C:\\Windows';
+    candidates.push(join(sysRoot, 'System32', 'curl.exe'));
+  }
+  for (const c of candidates) {
+    const r = spawnSync(c, ['--version'], { windowsHide: true, encoding: 'utf8' });
+    if (!r.error && r.status === 0) {
+      curlResolved = c;
+      return c;
+    }
+  }
+  curlResolved = null;
+  return null;
+}
+
+// fetch 网络异常 → 与 curl 版一致的人话（具体错误码在 err.cause 里）
+function fetchErrText(err) {
+  const cause = err?.cause || err;
+  const code = cause?.code || '';
+  if (code === 'ENOTFOUND' || code === 'EAI_AGAIN') return '无法解析服务器地址';
+  if (code === 'ECONNREFUSED') return '无法连接服务器';
+  if (code === 'ETIMEDOUT' || code === 'UND_ERR_CONNECT_TIMEOUT' || code === 'UND_ERR_HEADERS_TIMEOUT'
+    || err?.name === 'TimeoutError' || err?.name === 'AbortError') return '超时';
+  if (code === 'CERT_HAS_EXPIRED' || code === 'DEPTH_ZERO_SELF_SIGNED_CERT' || code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE'
+    || code === 'SELF_SIGNED_CERT_IN_CHAIN') return 'SSL 证书无效';
+  if (code === 'EPROTO') return 'SSL 握手失败';
+  return `网络请求失败：${cause?.message || String(err)}`;
+}
+
+// curl 不可用时的兜底实现：返回值约定与 curl 版一致（{ ok, httpCode, body, error,
+// redirectUrl }，HTTP 4xx/5xx 也算 ok）。凭据走 Authorization 头；proxyUrl 在这条
+// 路径不生效（fetch 不读代理环境变量，调用方仍照传以免改签名）；redirect 不跟随
+// （对齐 curl 不带 -L），302 的目标地址放 redirectUrl
+async function fetchWebdavRequest({ method, url, login = '', password = '', uploadFile = null, timeoutMs = 45000, headers = [] }) {
+  // curl 路径的 headers 是 ["Depth: 1"] 字符串数组，fetch 要对象：按第一个冒号拆开
+  const hdrs = {};
+  for (const h of headers) {
+    const i = h.indexOf(':');
+    if (i > 0) hdrs[h.slice(0, i).trim()] = h.slice(i + 1).trim();
+  }
+  if (method === 'PUT') hdrs['Content-Type'] = 'application/json';
+  if (login || password) hdrs['Authorization'] = 'Basic ' + Buffer.from(`${login}:${password}`).toString('base64');
+  try {
+    const res = await fetch(url, {
+      method,
+      headers: hdrs,
+      redirect: 'manual',
+      signal: AbortSignal.timeout(Math.max(10000, timeoutMs)),
+      body: method === 'PUT' && uploadFile ? readFileSync(uploadFile) : undefined,
+    });
+    const body = await res.text().catch(() => '');
+    return { ok: true, httpCode: res.status, body, error: '', redirectUrl: res.headers.get('location') || '' };
+  } catch (err) {
+    return { ok: false, httpCode: null, body: '', error: fetchErrText(err), redirectUrl: '' };
+  }
+}
+
+// 执行一次 WebDAV 请求。method 为 GET / PUT / MKCOL / DELETE / PROPFIND；PUT 用
+// uploadFile 上传（-T 隐含 PUT），PROPFIND 经 headers 附加 Depth 等请求头。
+// 返回 { ok, httpCode, body, error, redirectUrl }：ok 表示 curl 本身执行成功
+// （HTTP 4xx/5xx 也算 ok，由调用方看 httpCode 分支）；error 为中文原因；
+// redirectUrl 为重定向目标（请求不跟随重定向，302 时才有值）。
+export async function webdavRequest({ method, url, login = '', password = '', uploadFile = null, proxyUrl = '', timeoutMs = 45000, headers = [] }) {
+  const curl = findCurl();
+  if (!curl) return fetchWebdavRequest({ method, url, login, password, uploadFile, timeoutMs, headers });
   const dir = await mkdtemp(join(tmpdir(), 'zcodepro-webdav-'));
   const bodyFile = join(dir, 'body');
   try {
     const args = ['-sS', '--connect-timeout', '10', '--max-time', String(Math.max(10, Math.ceil(timeoutMs / 1000))),
-      '-w', '%{http_code}', '-o', bodyFile, '--config', '-'];
+      '-w', '%{http_code} %{redirect_url}', '-o', bodyFile, '--config', '-'];
+    for (const hd of headers) {
+      // 头只能是这里拼好的固定字符串（Depth: 1 等），带换行的一律丢弃
+      if (typeof hd === 'string' && hd && !/[\r\n]/.test(hd)) args.push('-H', hd);
+    }
     if (method === 'PUT' && uploadFile) {
       args.push('-H', 'Content-Type: application/json', '-T', uploadFile);
     } else {
@@ -57,7 +138,7 @@ export async function webdavRequest({ method, url, login = '', password = '', up
     args.push(url);
     const cfg = login || password ? `user = ${curlQuote(`${login}:${password}`)}\n` : '';
     const r = await new Promise((resolveRun) => {
-      const child = spawn('curl', args, { env: { ...process.env, ...proxyEnvVars(proxyUrl) }, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+      const child = spawn(curl, args, { env: { ...process.env, ...proxyEnvVars(proxyUrl) }, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
       let stdout = '';
       let stderr = '';
       child.stdout.on('data', (d) => { stdout += d.toString(); });
@@ -70,7 +151,8 @@ export async function webdavRequest({ method, url, login = '', password = '', up
       child.stdin.write(cfg);
       child.stdin.end();
     });
-    if (r.code === -1) return { ok: false, httpCode: null, body: '', error: '未找到 curl 命令（WebDAV 同步依赖 curl）' };
+    // 探测时还在、用时被删掉的极端情形：同样转 fetch 兜底，不再报“依赖 curl”
+    if (r.code === -1) return fetchWebdavRequest({ method, url, login, password, uploadFile, timeoutMs, headers });
     if (r.code !== 0) {
       const why = CURL_EXIT[r.code] || `curl 退出码 ${r.code}`;
       const hint = (r.stderr.split('\n').find((l) => l.trim()) || '').trim();
@@ -78,8 +160,10 @@ export async function webdavRequest({ method, url, login = '', password = '', up
     }
     let body = '';
     try { body = readFileSync(bodyFile, 'utf8'); } catch { /* 无响应体 */ }
+    // -w 追加了 redirect_url（无重定向时为空），parseInt 只取开头的状态码不受影响
     const httpCode = Number(parseInt(r.stdout.trim(), 10)) || 0;
-    return { ok: true, httpCode, body, error: '' };
+    const redirectUrl = r.stdout.trim().split(/\s+/)[1] || '';
+    return { ok: true, httpCode, body, error: '', redirectUrl };
   } finally {
     try { rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
   }
@@ -103,3 +187,35 @@ export async function webdavPutWithMkcol({ url, login, password, uploadFile, pro
   } catch { /* URL 解析失败：直接重试原 PUT */ }
   return webdavRequest({ method: 'PUT', url, uploadFile, ...auth, timeoutMs });
 }
+
+// 解析 PROPFIND（Depth: 1）的 multistatus 响应，只取文件条目：各网盘的命名空间
+// 前缀不一（D: / d: / 无前缀），用宽松的标签匹配手写解析（项目零依赖，保持）。
+// href 可能是绝对路径也可能是完整 URL，统一取最后一段并解码成文件名。
+// 返回 [{ name, size, lastModified }]：size 为字节数，lastModified 为 Date.parse
+// 出的毫秒时间戳（缺失为 null）；目录条目与解析不出的条目直接跳过。
+export function parseWebdavListing(body) {
+  const out = [];
+  if (!body || typeof body !== 'string') return out;
+  const respRe = /<(?:[A-Za-z0-9_.-]+:)?response(?:\s[^>]*)?>([\s\S]*?)<\/(?:[A-Za-z0-9_.-]+:)?response>/g;
+  const tagRe = (name) => new RegExp(`<(?:[A-Za-z0-9_.-]+:)?${name}(?:\\s[^>]*)?>([\\s\\S]*?)<\\/(?:[A-Za-z0-9_.-]+:)?${name}>`);
+  let m;
+  while ((m = respRe.exec(body)) !== null) {
+    const block = m[1];
+    const tag = (name) => {
+      const t = tagRe(name).exec(block);
+      return t ? t[1].trim() : '';
+    };
+    const href = tag('href');
+    if (!href) continue;
+    // 目录条目（collection 标记或 href 以 / 结尾）不要
+    if (/<(?:[A-Za-z0-9_.-]+:)?collection[\s/>]/.test(block)) continue;
+    if (href.endsWith('/')) continue;
+    const rawName = (href.split('?')[0].split('#')[0].split('/').filter(Boolean).pop()) || '';
+    let name = rawName;
+    try { name = decodeURIComponent(rawName); } catch { /* 已是普通字符串 */ }
+    if (!name) continue;
+    const lm = tag('getlastmodified');
+    out.push({ name, size: Number(tag('getcontentlength')) || 0, lastModified: lm ? (Date.parse(lm) || null) : null });
+  }
+  return out;
+}