@lenorin/dsh-tauri-launcher 1.0.9 → 1.0.11

package/README.md

@@ -137,6 +137,23 @@ dsh plugin --profile web remove @lenorin/dsh-tauri-launcher
 > 注：原 `shortcutName` 配置项已移除（2026-09）——快捷方式文件名由插件与桌面应用
 > 共用同一常量（`DeepSeek Harness.lnk`）：两侧各自维护名字会导致各建出一个 .lnk。
 
+### 候选目录的自动探测
+
+心跳、退出标记与桌面应用配置都在**桌面应用 exe 同目录**，而桌面应用可能存在多份
+副本（npm 包内预编译 exe、本地 `build.ps1` 产物）。插件按下述优先级挑目录，因此
+无论实际运行的是哪一份副本，状态判定、退出标记与启动目标都会对齐到同一个实例：
+
+1. 行配置 `launcherExe` 所在目录（硬指定）；
+2. **正在运行的** `dsh-launcher` 进程所在目录（`Get-Process` 取 `Path`）；
+3. 桌面快捷方式 `DeepSeek Harness.lnk` 的目标目录（WScript.Shell 读 `TargetPath`）；
+4. 行配置 `launcherDirs`（候选列表）；
+5. 本次插件运行中发现过的目录（实例退出后仍扫描其心跳，避免状态在「已停止/未知」间抖动）；
+6. 包内 `launcher/bin`（兜底）。
+
+只有真的含 `dsh-launcher.exe` 的目录会被采用——指向已删除副本的失效快捷方式会自动
+跳过，回退到下一候选。运行中实例/快捷方式目标的探测结果缓存 5 秒；探测不可用时
+（无 `subprocess` 服务等）自动回退到第 4/6 项，行为与旧版一致。
+
 ## 桌面应用构建与发布
 
 - npm 包自带预编译 exe（`launcher/bin/dsh-launcher.exe`），插件安装后自动探测、装上即用；

package/lib/index.js

@@ -9,6 +9,11 @@
  *
  * 浏览器侧通过本插件注册的 /api/dsh-tauri-launcher/* 路由通信（仅回环）。
  *
+ * 标记协议以 **exe 同目录**为界，而桌面应用可能有多个副本（包内预编译 exe、
+ * 本地构建产物）。因此候选目录按优先级自动探测：行配置 launcherExe →
+ * 运行中实例目录 → 桌面快捷方式目标目录 → 行配置 launcherDirs →
+ * 本会话发现过的目录 → 包内 `launcher/bin`，见 baseDirs。
+ *
  * 可调参数全部走行配置（见 apply 的 config 处理与 README「配置」章节）；
  * 内置候选目录只是默认值，供未配置时自动探测。
  */
@@ -22,12 +27,44 @@ export const inject = ['webServer', 'fs', 'subprocess']
 
 const STDIO = { stdin: 'ignore', stdout: 'inherit', stderr: 'inherit' }
 
+/**
+ * 拉起桌面应用时使用的 stdio（**不能用 inherit**）。
+ *
+ * DSH 自身可能是被桌面应用拉起的：它的 stdout/stderr 就是桌面应用当时创建的管道
+ * （`harness.rs` 用 `Stdio::piped()` 拉起 `dsh web`）。桌面应用退出后这根管道的读端
+ * 消失，此后以 inherit 拉起的子进程继承的是**已断开的手柄**，一写即 panic 退出
+ * （2026-09-15 实测：exit code 101，现象为「设置里开关打开但桌面端起不来」，而关闭
+ * 方向正常——关闭只写标记文件）。收集模式让管道由 DSH 这一侧持有，既避开坏句柄，
+ * 又把桌面应用启动期的输出留下来供诊断使用。
+ */
+const APP_STDIO = { stdin: 'ignore', stdout: { maxBytes: 16384 }, stderr: { maxBytes: 16384 } }
+
 /** 本包随附的预编译桌面应用 exe 目录（无论安装到哪个 profile 都能定位）。 */
 const PACKAGE_BIN = fileURLToPath(new URL('../launcher/bin', import.meta.url))
 
 /** 未配置 launcherDirs 时的默认候选目录（仅包内随附的预编译 exe；本地自行构建的 exe 通过行配置 launcherDirs/launcherExe 指定）。 */
 const DEFAULT_DIRS = [PACKAGE_BIN]
 
+/**
+ * 运行中实例 / 桌面快捷方式目标的探测缓存时长（毫秒）。状态轮询与启停等待
+ * 循环都会反复取候选目录，探测结果按此窗口复用，避免每次读取都拉起 PowerShell。
+ */
+const DISCOVERY_TTL_MS = 5000
+
+/** 会话内累积的候选目录上限（含已退出实例的目录）。 */
+const MAX_KNOWN_DIRS = 8
+
+/**
+ * PowerShell 输出编码前置：Windows PowerShell 5.1 默认按控制台代码页写重定向
+ * 输出，非 ASCII 路径会乱码；`ctx.subprocess` 的收集模式按 UTF-8 解码，故显式
+ * 钉成 UTF-8（与 `@deepseek-ai/dsh-pwsh-local` 的 ENCODING_PREAMBLE 同做法）。
+ */
+const PS_UTF8_PREAMBLE = '[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false); $OutputEncoding = [System.Text.UTF8Encoding]::new($false); '
+
+/** 列出运行中的桌面应用 exe 路径（同名 exe 可能有多份副本同时在跑）。 */
+const RUNNING_EXE_SCRIPT =
+  'Get-Process -Name dsh-launcher -ErrorAction SilentlyContinue | ForEach-Object { try { $_.Path } catch {} }'
+
 /**
  * 桌面快捷方式文件名。**单一来源**：必须与桌面应用 `src-tauri/src/settings.rs`
  * 的 `SHORTCUT_NAME` 常量一致——两侧各自维护名字会导致插件与桌面应用各建
@@ -129,15 +166,126 @@ export function apply(ctx, config) {
 
   let lastFsError = ''
   let lastMarkerError = ''
+  let lastProbeError = ''
   let spawnHandle = null
   let shortcutCache = { t: 0, value: false }
+  /** 最近一次拉起桌面应用的退出事实（未退出为 null），用于把「起来即死」报出来。 */
+  let appExit = null
+  /** 该桌面应用进程启动期的输出（收集模式），仅在启动失败时用于诊断。 */
+  let appOutput = ''
 
-  function baseDirs() {
-    const list = resolved.launcherDirs.slice()
+  /**
+   * 已在本次插件运行中发现过的候选目录（最近使用在前）。实例退出后仍保留：
+   * 该目录里的心跳文件会变成「过期」而非「不存在」，让状态稳定落在
+   * 「已停止」而不是回跳到 null（未知），退出流程的确认逻辑也不会中途丢目标。
+   */
+  const knownDirs = []
+  /** 「运行中实例目录 + 桌面快捷方式目标目录」的探测缓存。 */
+  const discovery = { t: 0, runningDirs: [], shortcutDir: '' }
+
+  /**
+   * 运行采集模式 PowerShell 并取回 stdout 文本（短探测脚本）。
+   * 任何失败（服务缺失、spawn 失败、provider 未提供收集流）都返回空串，
+   * 调用方据此回退到既有候选目录——探测不可用不改变原有行为。
+   */
+  async function capturePowerShell(script) {
+    if (!subprocess) return ''
+    try {
+      const handle = subprocess.spawn({
+        argv: ['powershell', '-NoLogo', '-NoProfile', '-NonInteractive', '-Command', PS_UTF8_PREAMBLE + script],
+        cwd: process.cwd(),
+        stdio: { stdin: 'ignore', stdout: { maxBytes: 16384 }, stderr: { maxBytes: 4096 } },
+        graceMs: 3000,
+      })
+      if (handle && handle.done) await handle.done.catch(() => null)
+      const reader = handle && handle.collected ? handle.collected.stdout : null
+      if (!reader) return ''
+      return String(reader.readFrom(0).text || '')
+    } catch (error) {
+      lastProbeError = String((error && error.message) || error)
+      return ''
+    }
+  }
+
+  /** 收集模式下该句柄的输出（stdout/stderr 合并、限长），用于诊断「起来即死」。 */
+  function collectedText(handle) {
+    if (!handle || !handle.collected) return ''
+    const parts = []
+    for (const stream of ['stdout', 'stderr']) {
+      const reader = handle.collected[stream]
+      if (!reader) continue
+      try {
+        const text = String(reader.readFrom(0).text || '').trim()
+        if (text) parts.push(stream + ': ' + text)
+      } catch {
+        // 收集流不可读取时忽略：诊断信息缺一行不影响主流程。
+      }
+    }
+    return parts.join('\n').slice(0, 2000)
+  }
+
+  /** 退出事实的可读描述（exit code / signal / 未知原因）。 */
+  function describeExit(outcome) {
+    if (!outcome) return '未知原因'
+    if (typeof outcome.exitCode === 'number') return 'exit code ' + outcome.exitCode
+    if (outcome.signal) return 'signal ' + outcome.signal
+    return outcome.error ? String(outcome.error) : '未知原因'
+  }
+
+  /** 记住一个已发现的候选目录（去重、最近使用在前、限量）。 */
+  function rememberDir(dir) {
+    if (!dir) return
+    const hit = knownDirs.indexOf(dir)
+    if (hit >= 0) knownDirs.splice(hit, 1)
+    knownDirs.unshift(dir)
+    if (knownDirs.length > MAX_KNOWN_DIRS) knownDirs.length = MAX_KNOWN_DIRS
+  }
+
+  /**
+   * 探测正在运行的桌面应用目录与桌面快捷方式目标目录（TTL 内复用）。
+   *
+   * 为什么需要：标记协议以 exe 同目录为界，而桌面应用存在多份副本（包内预编译
+   * exe、本地构建产物）。只看包内目录时，若实际运行的是另一份副本，就会读到空
+   * 心跳 → 状态「未知」、退出标记写进错误目录、开关反而拉起第二份实例。
+   */
+  async function probe() {
+    if (Date.now() - discovery.t < DISCOVERY_TTL_MS) return discovery
+    const [runningText, targetText] = await Promise.all([
+      capturePowerShell(RUNNING_EXE_SCRIPT),
+      capturePowerShell(shortcutTargetScript()),
+    ])
+    const runningDirs = []
+    for (const line of String(runningText).split(/\r?\n/)) {
+      const dir = dirOf(line.trim())
+      if (dir && !runningDirs.includes(dir)) runningDirs.push(dir)
+    }
+    const targetLine = String(targetText).split(/\r?\n/).map((line) => line.trim()).filter((line) => line !== '')[0] || ''
+    discovery.t = Date.now()
+    discovery.runningDirs = runningDirs
+    discovery.shortcutDir = dirOf(targetLine)
+    for (const dir of runningDirs) rememberDir(dir)
+    if (discovery.shortcutDir) rememberDir(discovery.shortcutDir)
+    return discovery
+  }
+
+  /**
+   * 候选 exe 目录，按启动优先级排列：
+   * 1. 行配置 launcherExe 所在目录；2. 运行中实例目录；3. 桌面快捷方式目标目录；
+   * 4. 行配置 launcherDirs；5. 本会话发现过的目录；6. 包内随附 exe 目录。
+   * 只有真的含 dsh-launcher.exe 的目录才会被 exeDirs() 采用——失效的快捷方式
+   * 目标会被自动跳过，回退到下一候选。
+   */
+  async function baseDirs() {
+    const found = await probe()
+    const list = []
     if (resolved.launcherExe) {
       const dir = dirOf(resolved.launcherExe)
       if (dir) list.push(dir)
     }
+    for (const dir of found.runningDirs) list.push(dir)
+    if (found.shortcutDir) list.push(found.shortcutDir)
+    for (const dir of resolved.launcherDirs) list.push(dir)
+    for (const dir of knownDirs) list.push(dir)
     for (const dir of DEFAULT_DIRS) list.push(dir)
     return [...new Set(list)]
   }
@@ -155,7 +303,8 @@ export function apply(ctx, config) {
   }
 
   async function exeDirs() {
-    const checked = await Promise.all(baseDirs().map(async (dir) => ((await exeExists(dir)) ? dir : null)))
+    const dirs = await baseDirs()
+    const checked = await Promise.all(dirs.map(async (dir) => ((await exeExists(dir)) ? dir : null)))
     return checked.filter((dir) => dir !== null)
   }
 
@@ -324,6 +473,12 @@ export function apply(ctx, config) {
     return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(SHORTCUT_NAME) + "; if (Test-Path -LiteralPath $lnk) { exit 0 } else { exit 1 }"
   }
 
+  /** 读桌面快捷方式的目标 exe 路径；快捷方式不存在或目标为空时无输出。 */
+  function shortcutTargetScript() {
+    return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(SHORTCUT_NAME) + '; ' +
+      'if (Test-Path -LiteralPath $lnk) { $ws=New-Object -ComObject WScript.Shell; $sc=$ws.CreateShortcut($lnk); if ($sc.TargetPath) { $sc.TargetPath } }'
+  }
+
   function shortcutCreateScript(exe) {
     return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(SHORTCUT_NAME) + "; " +
       "$exe=" + psQuote(exe) + "; " +
@@ -370,12 +525,18 @@ export function apply(ctx, config) {
     lines.push('freshWindowSecs: ' + resolved.freshSecs)
     lines.push('launcherExe: ' + (resolved.launcherExe || '(auto)'))
     lines.push('shortcut: ' + (await shortcutExists()))
+    const found = await probe()
+    lines.push('runningDirs: ' + JSON.stringify(found.runningDirs))
+    lines.push('shortcutTarget: ' + (found.shortcutDir || '(none)'))
     const dirs = await exeDirs()
     lines.push('exeDirs: ' + JSON.stringify(dirs))
     const exe = await pickExe()
     lines.push('pickExe: ' + (exe || '(null)'))
     if (lastFsError) lines.push('fsError: ' + lastFsError)
+    if (lastProbeError) lines.push('probeError: ' + lastProbeError)
     lines.push('markerWrite: ' + (lastMarkerError || 'ok'))
+    if (appExit) lines.push('appExit: ' + describeExit(appExit))
+    if (appOutput) lines.push('appOutput: ' + appOutput)
     for (const dir of dirs) {
       lines.push('heartbeat(' + dir.split('\\').slice(-2).join('\\') + '): ' + String(await hbState(dir)))
     }
@@ -395,6 +556,8 @@ export function apply(ctx, config) {
   }
 
   async function setDesktop(enabled) {
+    appExit = null
+    appOutput = ''
     if (enabled) {
       if (await quitMarkerIsOne()) await writeQuitMarker('0')
       const exe = await pickExe()
@@ -406,7 +569,18 @@ export function apply(ctx, config) {
       }
       try {
         const dir = dirOf(exe)
-        spawnHandle = subprocess.spawn({ argv: [exe], cwd: dir, stdio: STDIO, graceMs: 3000 })
+        // 拉起前记住该目录：即使探测缓存仍是旧的，心跳扫描也已覆盖新实例的目录。
+        rememberDir(dir)
+        const handle = subprocess.spawn({ argv: [exe], cwd: dir, stdio: APP_STDIO, graceMs: 3000 })
+        spawnHandle = handle
+        // 记录退出事实：桌面应用「起来即死」时（例如继承了坏句柄而 panic），
+        // 只有退出码 + 它自己的输出能说明原因，否则用户只看到开关弹回而没有解释。
+        if (handle && handle.done) {
+          handle.done.then(
+            (outcome) => { appExit = outcome || { exitCode: null, signal: null } },
+            (error) => { appExit = { exitCode: null, signal: null, error: String((error && error.message) || error) } },
+          )
+        }
       } catch (error) {
         return { ok: false, error: '启动桌面应用失败：' + String((error && error.message) || error), diag: await buildDiag() }
       }
@@ -424,6 +598,17 @@ export function apply(ctx, config) {
         }
         return { ok: true, desktop: true, shortcut: true, diag: '' }
       }
+      // 未在就绪窗口内看到新鲜心跳：若进程已退出，把退出事实与输出报出来。
+      appOutput = collectedText(spawnHandle)
+      if (appExit) {
+        return {
+          ok: false,
+          desktop: false,
+          shortcut: await shortcutExists(),
+          error: '桌面应用启动后立即退出（' + describeExit(appExit) + '）。',
+          diag: await buildDiag(),
+        }
+      }
       if (state === null) return { ok: true, desktop: null, shortcut: await shortcutExists(), diag: '' }
       return { ok: true, desktop: false, shortcut: await shortcutExists(), diag: '' }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenorin/dsh-tauri-launcher",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "DSH Web 插件：基于 Tauri 2 的 DeepSeek Harness 桌面启动器，自动联动桌面快捷方式，exe 路径与探测窗口可配置。",
   "type": "module",
   "main": "lib/index.js",