fix(rclone): 前台 WebUI 直接输出日志

前台运行的目的就是让操作者看到 rclone 的启动和错误输出。默认前台模式不再传 --log-file，让 rclone stdout/stderr 直接留在当前终端；后台模式仍写入 .runtime/logs/webui.log。

Constraint: 保持后台日志文件行为
Rejected: 前台继续只提示 tail 日志 | 仍需要用户额外操作才能判断启动失败原因
Confidence: high
Scope-risk: narrow
Tested: Pester RcloneOps.Tests.ps1
Tested: node --test config/service/oss/rclone/rclone-ops.test.mjs
Tested: pnpm qa
Not-tested: 真实 rclone WebUI 交互登录

Author: mudssky

config/service/oss/rclone/README.md

@@ -102,7 +102,7 @@ pwsh ./rclone-ops.ps1 doctor
 
 ## 启动 WebUI / RC
 
-默认监听 `127.0.0.1:5572`。不带 `--background` 时是前台运行模式，命令会持续占用当前终端；如果没有持续输出，通常表示 `rclone rcd` 仍在运行，可打开 `http://127.0.0.1:5572` 或查看 `.runtime/logs/webui.log` 确认状态，按 `Ctrl+C` 停止。
+默认监听 `127.0.0.1:5572`。不带 `--background` 时是前台运行模式，命令会持续占用当前终端，并把 rclone 日志直接显示在当前终端；可打开 `http://127.0.0.1:5572` 确认状态，按 `Ctrl+C` 停止。后台模式才会把日志写入 `.runtime/logs/webui.log`。
 
 如果未设置 `RCLONE_RC_PASS`，rclone WebUI 会自动生成临时认证信息；建议日常运维显式设置强密码：
 

config/service/oss/rclone/rclone-ops.mjs

@@ -369,13 +369,16 @@ function commandWebui(flags, passthrough) {
     'RCLONE_RC_PASS',
     process.env.RCLONE_RC_PASS ?? '',
   )
+  const isBackground = flags.has('background')
   const logFile = resolveOption(
     flags,
     'log-file',
     'RCLONE_LOG_FILE',
     join(DEFAULT_LOG_DIR, 'webui.log'),
   )
-  ensureDir(dirname(logFile))
+  if (isBackground) {
+    ensureDir(dirname(logFile))
+  }
   const rcloneCheck = checkRclone(binary)
   if (!rcloneCheck.ok) {
     throw new Error(
@@ -389,9 +392,11 @@ function commandWebui(flags, passthrough) {
     '--rc-web-gui',
     `--rc-addr=${rcAddr}`,
     `--config=${configPath}`,
-    `--log-file=${logFile}`,
     ...passthrough,
   ]
+  if (isBackground) {
+    args.push(`--log-file=${logFile}`)
+  }
   if (rcPass) {
     args.push(`--rc-user=${rcUser}`, `--rc-pass=${rcPass}`)
   }
@@ -402,23 +407,21 @@ function commandWebui(flags, passthrough) {
   console.log('准备启动 rclone WebUI/RC：')
   console.log(`  地址: http://${rcAddr}`)
   console.log(`  配置: ${configPath}`)
-  console.log(`  日志: ${logFile}`)
+  console.log(`  日志: ${isBackground ? logFile : '当前终端（rclone stdout/stderr）'}`)
   if (!rcPass) {
     console.log(
       '  认证: 未设置 RCLONE_RC_PASS，rclone 会生成临时认证信息；建议日常运维显式设置强密码。',
     )
   }
-  if (flags.has('background')) {
+  if (isBackground) {
     console.log('  模式: 后台启动，可用 stop-webui 停止。')
   } else {
-    console.log(
-      '  模式: 前台运行，会持续占用当前终端；无持续输出通常表示服务仍在运行，按 Ctrl+C 停止。',
-    )
+    console.log('  模式: 前台运行，rclone 日志会直接显示在当前终端，按 Ctrl+C 停止。')
     console.log('  提示: 如需命令立即返回，请使用 --background --no-open-browser。')
   }
 
   return runRclone(binary, args, {
-    background: flags.has('background'),
+    background: isBackground,
     pidFile: join(DEFAULT_RUNTIME_DIR, 'webui.pid'),
   })
 }

config/service/oss/rclone/rclone-ops.ps1

@@ -624,35 +624,39 @@ function Start-RcloneOpsWebUi {
     $rcAddr = Get-RcloneOpsOption -Flags $Flags -Name 'addr' -EnvName 'RCLONE_RC_ADDR' -DefaultValue $script:DefaultRcAddr
     $rcPass = Get-RcloneOpsOption -Flags $Flags -Name 'pass' -EnvName 'RCLONE_RC_PASS' -DefaultValue ''
     $rcUser = if ($rcPass) { Get-RcloneOpsOption -Flags $Flags -Name 'user' -EnvName 'RCLONE_RC_USER' -DefaultValue $script:DefaultRcUser } else { '' }
+    $isBackground = $Flags.ContainsKey('background')
     $logFile = Get-RcloneOpsOption -Flags $Flags -Name 'log-file' -EnvName 'RCLONE_LOG_FILE' -DefaultValue (Join-Path $script:DefaultLogDir 'webui.log')
-    New-Item -ItemType Directory -Path (Split-Path -Parent $logFile) -Force | Out-Null
+    if ($isBackground) {
+        New-Item -ItemType Directory -Path (Split-Path -Parent $logFile) -Force | Out-Null
+    }
 
     if (-not (Get-Command $rclone -ErrorAction SilentlyContinue)) {
         throw "未找到 rclone 命令：$rclone。请先安装 rclone，或通过 --rclone / RCLONE_BIN 指定路径。"
     }
 
-    # WebUI 会暴露 RC API；默认只监听 localhost，避免无意暴露到公网。
-    $rcloneArgs = @('rcd', '--rc-web-gui', "--rc-addr=$rcAddr", "--config=$configPath", "--log-file=$logFile")
+    # 前台模式保留 rclone 的 stderr/stdout，后台模式才写日志文件，避免用户误判“没反应”。
+    $rcloneArgs = @('rcd', '--rc-web-gui', "--rc-addr=$rcAddr", "--config=$configPath")
+    if ($isBackground) { $rcloneArgs += "--log-file=$logFile" }
     if ($rcPass) { $rcloneArgs += @("--rc-user=$rcUser", "--rc-pass=$rcPass") }
     if ($Flags.ContainsKey('no-open-browser')) { $rcloneArgs += '--rc-web-gui-no-open-browser' }
     $rcloneArgs += $Passthrough
 
     Write-Host '准备启动 rclone WebUI/RC：'
     Write-Host "  地址: http://$rcAddr"
     Write-Host "  配置: $configPath"
-    Write-Host "  日志: $logFile"
+    Write-Host ("  日志: {0}" -f ($(if ($isBackground) { $logFile } else { '当前终端（rclone stdout/stderr）' })))
     if (-not $rcPass) {
         Write-Host '  认证: 未设置 RCLONE_RC_PASS，rclone 会生成临时认证信息；建议日常运维显式设置强密码。'
     }
-    if ($Flags.ContainsKey('background')) {
+    if ($isBackground) {
         Write-Host '  模式: 后台启动，可用 stop-webui 停止。'
     }
     else {
-        Write-Host '  模式: 前台运行，会持续占用当前终端；无持续输出通常表示服务仍在运行，按 Ctrl+C 停止。'
+        Write-Host '  模式: 前台运行，rclone 日志会直接显示在当前终端，按 Ctrl+C 停止。'
         Write-Host '  提示: 如需命令立即返回，请使用 --background --no-open-browser。'
     }
 
-    Invoke-RcloneOpsProcess -FilePath $rclone -Arguments $rcloneArgs -Background:($Flags.ContainsKey('background')) -PidFile (Join-Path $script:DefaultRuntimeDir 'webui.pid')
+    Invoke-RcloneOpsProcess -FilePath $rclone -Arguments $rcloneArgs -Background:$isBackground -PidFile (Join-Path $script:DefaultRuntimeDir 'webui.pid')
 }
 
 function Stop-RcloneOpsWebUi {