@lenorin/dsh-tauri-launcher 1.0.9 → 1.0.10

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「配置」章节）；
  * 内置候选目录只是默认值，供未配置时自动探测。
  */
@@ -28,6 +33,26 @@ 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 +154,97 @@ export function apply(ctx, config) {
 
   let lastFsError = ''
   let lastMarkerError = ''
+  let lastProbeError = ''
   let spawnHandle = null
   let shortcutCache = { t: 0, value: false }
 
-  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 ''
+    }
+  }
+
+  /** 记住一个已发现的候选目录（去重、最近使用在前、限量）。 */
+  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 +262,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 +432,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,11 +484,15 @@ 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'))
     for (const dir of dirs) {
       lines.push('heartbeat(' + dir.split('\\').slice(-2).join('\\') + '): ' + String(await hbState(dir)))
@@ -406,6 +524,8 @@ export function apply(ctx, config) {
       }
       try {
         const dir = dirOf(exe)
+        // 拉起前记住该目录：即使探测缓存仍是旧的，心跳扫描也已覆盖新实例的目录。
+        rememberDir(dir)
         spawnHandle = subprocess.spawn({ argv: [exe], cwd: dir, stdio: STDIO, graceMs: 3000 })
       } catch (error) {
         return { ok: false, error: '启动桌面应用失败：' + String((error && error.message) || error), diag: await buildDiag() }

package/package.json

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