@lenorin/dsh-tauri-launcher 1.0.8 → 1.0.10

package/README.en.md

@@ -77,6 +77,7 @@ loopback routes, and controls the desktop app via a sentinel-file protocol (see
 dsh-tauri-launcher/
 ├── README.md             # Chinese README
 ├── README.en.md          # English README
+├── CHANGELOG.md          # changelog — the single source of release notes (bilingual)
 ├── package.json          # dsh.bundle + dsh.client dual manifest
 ├── cordis.patch.yml      # composition patch (inserts the plugin row)
 ├── lib/
@@ -138,9 +139,12 @@ fit common deployments):
     launcherExe: ''            # absolute path to the desktop-app exe; empty = auto-detect
     launcherDirs: []           # candidate exe directories; empty = built-in defaults
     freshSecs: 4               # heartbeat "freshness window" in seconds (must be > write interval)
-    shortcutName: 'DeepSeek Harness.lnk'   # desktop-shortcut file name
 ```
 
+> Note: the former `shortcutName` key was removed (2026-09) — the shortcut file name is a
+> single constant shared by the plugin and the desktop app (`DeepSeek Harness.lnk`);
+> maintaining it on both sides produced two differently-named `.lnk` files.
+
 ## Desktop App Build & Release
 
 - The npm package ships a pre-built exe (`launcher/bin/dsh-launcher.exe`); the plugin auto-detects it on install — ready to use out of the box;
@@ -156,6 +160,7 @@ fit common deployments):
 
 - [docs/architecture.md](docs/architecture.md) — architecture & sentinel-file protocol (Chinese)
 - [docs/release.md](docs/release.md) — install, build, release, uninstall & configuration reference (Chinese)
+- [CHANGELOG.md](CHANGELOG.md) — release notes per version (Chinese + English)
 
 ## License
 

package/README.md

@@ -73,6 +73,7 @@ Web 插件（宿主半）通过 `/api/dsh-tauri-launcher/*` 回环路由与浏
 dsh-tauri-launcher/
 ├── README.md             # 中文 README
 ├── README.en.md          # 英文 README
+├── CHANGELOG.md          # 更新日志——发版说明的唯一来源（中英双语）
 ├── package.json          # dsh.bundle + dsh.client 双 manifest
 ├── cordis.patch.yml      # 组合补丁（插入插件行）
 ├── lib/
@@ -131,9 +132,28 @@ dsh plugin --profile web remove @lenorin/dsh-tauri-launcher
     launcherExe: ''            # 桌面应用 exe 绝对路径；空 = 自动探测
     launcherDirs: []           # 候选 exe 目录列表；空 = 内置默认候选
     freshSecs: 4               # 心跳“新鲜窗口”（秒），须大于心跳写入周期
-    shortcutName: 'DeepSeek Harness.lnk'   # 桌面快捷方式文件名
 ```
 
+> 注：原 `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`），插件安装后自动探测、装上即用；
@@ -149,6 +169,7 @@ dsh plugin --profile web remove @lenorin/dsh-tauri-launcher
 
 - [docs/architecture.md](docs/architecture.md) — 架构与标记文件协议
 - [docs/release.md](docs/release.md) — 安装、构建、发布、卸载与配置参考
+- [CHANGELOG.md](CHANGELOG.md) — 更新日志（逐版本发版说明，GitHub/Gitee 发行版正文的来源）
 
 ## License
 

package/lib/client.js

@@ -422,6 +422,28 @@ body [class*='centerCol'] {
       ))
     }
 
+    /* ---------- 外壳 ↔ 插件 postMessage 协议 ---------- */
+    // 消息统一信封 { v, type, payload }。为兼容旧版对端（旧 exe 配新插件，
+    // 或反之），发送时同时保留旧字段、解析时信封优先并回退旧字段；下个大
+    // 版本再移除旧字段。字段与超时清单见项目 docs/architecture.md。
+    const MSG_VERSION = 1
+    const MSG = {
+      /** 外壳 → 插件：导航命令（dir: back | forward | ping）。 */
+      NAV_COMMAND: 'navCommand',
+      /** 外壳 → 插件：Windows 系统主题（scheme）。 */
+      SYSTEM_THEME: 'systemTheme',
+      /** 插件 → 外壳：前进/后退可用性（back / forward）。 */
+      NAV_STATUS: 'navStatus',
+      /** 插件 → 外壳：DSH 主题与真实 token（scheme + 六色）。 */
+      THEME_SYNC: 'themeSync',
+    }
+
+    /** 读取信封载荷；版本或类型不匹配时返回 null（调用方回退旧字段）。 */
+    function readEnvelope(data, type) {
+      if (!data || data.v !== MSG_VERSION || data.type !== type) return null
+      return data.payload && typeof data.payload === 'object' ? data.payload : null
+    }
+
     /* ---------- 标题栏主题中继（DSH → 外壳） ---------- */
 
     /**
@@ -431,6 +453,8 @@ body [class*='centerCol'] {
      * 普通浏览器标签（window.parent === window）直接跳过。
      * 注意：内置主题的快照 tokens 是空表，真实颜色在 CSS 变量里
      * （body[data-ds-dark-theme] 切换），必须经 getComputedStyle 取。
+     * ⚠️ 所有读取都在当前任务之后（见下方 schedulePost 的时序说明）——
+     * 同步读会拿到上一个主题的 DOM 状态，标题栏会滞后一个主题。
      */
     function installThemeRelay(ctx) {
       const readVar = (name) => {
@@ -448,9 +472,11 @@ body [class*='centerCol'] {
         }
       }
 
-      let themeSent = false
+      let pending = false
+      let lastSignature = ''
       const postTheme = () => {
-        if (window.parent === window) return
+        pending = false
+        if (window.parent === window) return true
         let scheme = null
         try {
           const theme = ctx.get('theme')
@@ -463,8 +489,7 @@ body [class*='centerCol'] {
         if (!scheme) {
           scheme = document.body.hasAttribute('data-ds-dark-theme') ? 'dark' : 'light'
         }
-        const payload = {
-          __dshLauncherTheme: 1,
+        const theme = {
           scheme,
           bg: readVar('--dsw-specific-sidebar-fill'),
           fg: readVar('--dsw-alias-label-primary'),
@@ -473,19 +498,53 @@ body [class*='centerCol'] {
           sep: readVar('--dsw-alias-border-l1'),
           danger: readVar('--dsw-alias-state-error-primary'),
         }
-        themeSent = true
-        window.parent.postMessage(payload, '*')
-        // 返回 true 供重试梯子判定“已送达”，停止后续重试（与历史 themeSent 语义一致）
+        const signature = JSON.stringify(theme)
+        // 同一状态只投递一次：事件、DOM 观察、重试梯子三路触发时去重
+        if (signature === lastSignature) return true
+        lastSignature = signature
+        // 双发：信封（新）+ 旧字段（兼容旧版外壳）；下个大版本移除旧字段。
+        window.parent.postMessage(
+          { ...theme, __dshLauncherTheme: 1, v: MSG_VERSION, type: MSG.THEME_SYNC, payload: theme },
+          '*',
+        )
+        // 返回 true 供重试梯子判定“已送达”，停止后续重试
+        return true
+      }
+
+      /**
+       * 读取必须延后到当前任务之后（DSH 0.1.2-rc.1 实测的时序坑）：
+       * ui-layout 的 ThemePresenter 与我们的 theme/change 监听器同处一次
+       * **同步**派发，谁先注册不保证；同步读取会拿到上一个主题的 body 属性
+       * 与 --dsw-* 计算值——表现为「DSH 界面已切浅色，标题栏仍是深色」
+       * （标题栏滞后一个主题）。setTimeout(0) 保证 presenter 的 DOM 写入生效。
+       */
+      const schedulePost = () => {
+        if (pending) return true
+        pending = true
+        setTimeout(() => {
+          try {
+            postTheme()
+          } catch {
+            pending = false
+          }
+        }, 0)
         return true
       }
 
       try {
-        ctx.on('theme/change', postTheme)
+        ctx.on('theme/change', schedulePost)
       } catch { /* 事件不可用时依赖下面的重试梯子 */ }
 
+      // 兜底：直接观察 body 的主题属性，事件时序变化时也能补发（同状态去重）
+      if (typeof MutationObserver === 'function') {
+        const observer = new MutationObserver(() => schedulePost())
+        observer.observe(document.body, { attributes: true, attributeFilter: ['data-ds-dark-theme'] })
+        ctx.effect(() => () => observer.disconnect(), 'dsh-tauri-launcher: theme relay observer')
+      }
+
       // 主题服务可能在本插件之后才就绪，且 preference 等于默认值时不会发
       // theme/change：用重试梯子保证初始状态一定送达（成功或 6 秒后停止）。
-      const disposeTimer = retryLadder(postTheme, {})
+      const disposeTimer = retryLadder(schedulePost, {})
       ctx.effect(() => disposeTimer, 'dsh-tauri-launcher: theme relay timer')
     }
 
@@ -524,8 +583,7 @@ body [class*='centerCol'] {
 
       const onSystemThemeMessage = (event) => {
         const data = event.data || {}
-        if (event.source !== window.parent) return
-        if (event.origin !== parentOrigin) return
+        if (!isShellMessage(event, parentOrigin)) return
         const scheme = data.__tbSystemTheme
         if (scheme === 'light' || scheme === 'dark') applySystemTheme(scheme)
       }
@@ -558,11 +616,15 @@ body [class*='centerCol'] {
 
         const sendStatus = () => {
           if (window.parent === window) return
-          const payload = { __tbNavStatus: { back: nav.status().back, forward: nav.status().forward } }
+          const status = { back: nav.status().back, forward: nav.status().forward }
           try {
-            // 用 '*' 投递：WebView2 下对 http://tauri.localhost 虚拟主机的
-            // 精确 targetOrigin 匹配有丢弃嫌疑；外壳侧会校验 event.origin。
-            window.parent.postMessage(payload, '*')
+            // 双发：信封（新）+ 旧字段（兼容旧版外壳）。用 '*' 投递：WebView2 下
+            // 对 http://tauri.localhost 虚拟主机的精确 targetOrigin 匹配有丢弃
+            // 嫌疑；外壳侧会校验 event.origin。
+            window.parent.postMessage(
+              { __tbNavStatus: status, v: MSG_VERSION, type: MSG.NAV_STATUS, payload: status },
+              '*',
+            )
           } catch { /* 忽略 */ }
         }
 
@@ -606,8 +668,7 @@ body [class*='centerCol'] {
 
         const onNavMessage = (event) => {
           const data = event.data || {}
-          if (event.source !== window.parent) return
-          if (event.origin !== parentOrigin) return
+          if (!isShellMessage(event, parentOrigin)) return
           const dir = data.__tbNav
           if (dir === 'back') goBack()
           else if (dir === 'forward') goForward()
@@ -665,15 +726,36 @@ body [class*='centerCol'] {
 
     /**
      * 父窗口 origin：跨源读不到 window.parent.location，用 document.referrer
-     * 推导（兜底 http://tauri.localhost）。
+     * 推导。**注意 referrer 不可靠**：DSH 0.1.5 + WebView2 实测，iframe 经
+     * token 303 握手后 `document.referrer` 为空，推导结果退化为兜底值，
+     * 与外壳实际 origin 不符——因此校验一律走 [`isShellMessage`] 的白名单。
      */
     function deriveParentOrigin() {
       try {
         if (document.referrer) return new URL(document.referrer).origin
-      } catch { /* 兜底 http://tauri.localhost */ }
+      } catch { /* 兜底见 isShellMessage 的白名单 */ }
       return 'http://tauri.localhost'
     }
 
+    /**
+     * 外壳页（桌面端主窗口）的已知 origin：本地外壳服务（`shell_server.rs`，
+     * 127.0.0.1:3081）与历史 tauri 资产协议虚拟主机。
+     */
+    const SHELL_ORIGINS = ['http://127.0.0.1:3081', 'http://tauri.localhost']
+
+    /**
+     * 判断消息是否来自桌面端外壳。
+     * `event.source === window.parent` 是最强的身份校验（只有真正的父 frame
+     * 能匹配）；origin 再按「referrer 推导值或已知外壳白名单」收口——只认
+     * 推导值会在 referrer 缺失时把整条通道（导航命令、系统主题）全部丢弃
+     * （2026-09-12 探针实证：34 次 ping 与全部 nav/theme 消息均因 origin
+     * 不匹配被丢弃，症状是 ◀/▶ 无响应、Windows 主题不跟随）。
+     */
+    function isShellMessage(event, parentOrigin) {
+      if (event.source !== window.parent) return false
+      return event.origin === parentOrigin || SHELL_ORIGINS.includes(event.origin)
+    }
+
     exports.apply = function (ctx) {
       const slots = ctx.get('slots')
       if (slots === undefined) return

package/lib/index.js

@@ -9,6 +9,11 @@
  *
  * 浏览器侧通过本插件注册的 /api/dsh-tauri-launcher/* 路由通信（仅回环）。
  *
+ * 标记协议以 **exe 同目录**为界，而桌面应用可能有多个副本（包内预编译 exe、
+ * 本地构建产物）。因此候选目录按优先级自动探测：行配置 launcherExe →
+ * 运行中实例目录 → 桌面快捷方式目标目录 → 行配置 launcherDirs →
+ * 本会话发现过的目录 → 包内 `launcher/bin`，见 baseDirs。
+ *
  * 可调参数全部走行配置（见 apply 的 config 处理与 README「配置」章节）；
  * 内置候选目录只是默认值，供未配置时自动探测。
  */
@@ -28,9 +33,42 @@ 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` 常量一致——两侧各自维护名字会导致插件与桌面应用各建
+ * 一个 .lnk（优化报告 v2 B3），因此不再提供行配置。
+ */
+const SHORTCUT_NAME = 'DeepSeek Harness.lnk'
+
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
 const psQuote = (value) => "'" + String(value).replace(/'/g, "''") + "'"
 
+/** exe 所在目录（Windows 反斜杠路径）；无分隔符时返回空串（调用方回退）。 */
+const dirOf = (exePath) => {
+  const slash = exePath.lastIndexOf('\\')
+  return slash > 0 ? exePath.slice(0, slash) : ''
+}
+
 function writeJson(res, status, body) {
   const payload = JSON.stringify(body)
   res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
@@ -69,15 +107,26 @@ function isLoopback(req) {
  * 3. Referer 指向 DSH 自身页面地址。
  * 三者全缺（如 <img>/<script> 等无头请求）拒绝。
  */
+/** 允许的 DSH 页面 Origin 集合（按端口缓存，避免每个请求重建 Set）。 */
+const allowedOriginsByPort = new Map()
+function allowedOriginsFor(port) {
+  let set = allowedOriginsByPort.get(port)
+  if (set === undefined) {
+    set = new Set([
+      'http://127.0.0.1:' + port,
+      'http://localhost:' + port,
+      'http://[::1]:' + port,
+    ])
+    allowedOriginsByPort.set(port, set)
+  }
+  return set
+}
+
 function isTrustedRequest(req, port) {
   if (!isLoopback(req)) return false
   const headers = req.headers || {}
   if (headers['x-requested-with'] === 'dsh-tauri-launcher') return true
-  const allowed = new Set([
-    'http://127.0.0.1:' + port,
-    'http://localhost:' + port,
-    'http://[::1]:' + port,
-  ])
+  const allowed = allowedOriginsFor(port)
   if (headers.origin && allowed.has(headers.origin)) return true
   const referer = headers.referer
   if (referer) {
@@ -101,21 +150,101 @@ export function apply(ctx, config) {
     launcherDirs: Array.isArray(config && config.launcherDirs) ? config.launcherDirs.filter((d) => typeof d === 'string') : [],
     /** 心跳“新鲜窗口”（秒）。桌面应用每秒写心跳，默认 4 秒即 4 个周期的余量。 */
     freshSecs: config && typeof config.freshSecs === 'number' && config.freshSecs > 1 ? config.freshSecs : 4,
-    /** 桌面快捷方式的文件名。 */
-    shortcutName: config && typeof config.shortcutName === 'string' && config.shortcutName !== '' ? config.shortcutName : 'DeepSeek Harness.lnk',
   }
 
   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 slash = resolved.launcherExe.lastIndexOf('\\')
-      if (slash > 0) list.push(resolved.launcherExe.slice(0, slash))
+      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)]
   }
@@ -133,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)
   }
 
@@ -156,8 +286,12 @@ export function apply(ctx, config) {
     if (text === null || text === '') return null
     const stamp = Number(text)
     if (!Number.isFinite(stamp)) return null
-    const age = Math.abs(Date.now() / 1000 - stamp)
-    return age < resolved.freshSecs
+    // 单向新鲜度：只认「不早于 now - freshSecs、且不显著超前」的时间戳。
+    // 原实现取 Math.abs()，会把**未来时间戳**也判成新鲜——系统时钟回拨或
+    // 写入方时钟超前时，残留的心跳文件会被误判为「运行中」（优化报告 v2 C1）。
+    // 容 1 秒负向抖动：同一台机器共用系统时钟，正常不会超前。
+    const age = Date.now() / 1000 - stamp
+    return age > -1 && age < resolved.freshSecs
   }
 
   async function isRunning() {
@@ -205,29 +339,32 @@ export function apply(ctx, config) {
     return null
   }
 
-  async function runPowerShell(script, cwd) {
-    if (!subprocess) throw new Error('subprocess 服务不可用')
-    const handle = subprocess.spawn({
-      argv: ['powershell', '-NoProfile', '-NonInteractive', '-Command', script],
-      cwd: cwd || (await pickExe()) || '',
-      stdio: STDIO,
-      graceMs: 3000,
-    })
-    if (handle && handle.done) await handle.done.catch(() => {})
-  }
-
-  async function runPowerShellExitCode(script, cwd) {
-    if (!subprocess) return null
+  /**
+   * 执行 PowerShell 脚本。
+   * - 默认（`wantExitCode: false`）：等待执行结束，忽略退出码；spawn 失败抛出，
+   *   由调用方决定是否记录（写标记等「执行即可」的场景）。
+   * - `wantExitCode: true`：返回退出码（无法取得时为 null），失败记入
+   *   `lastMarkerError` 供诊断使用（原 runPowerShellExitCode 的语义）。
+   */
+  async function runPowerShell(script, cwd, { wantExitCode = false } = {}) {
+    if (!subprocess) {
+      if (wantExitCode) return null
+      throw new Error('subprocess 服务不可用')
+    }
     try {
       const handle = subprocess.spawn({
         argv: ['powershell', '-NoProfile', '-NonInteractive', '-Command', script],
-        cwd: cwd || process.cwd(),
+        // 不带 cwd 时：需要退出码的调用多为绝对路径脚本，用进程 cwd 即可；
+        // 其余（写标记/杀进程）落在 exe 同目录，便于相对路径与权限。
+        cwd: cwd || (wantExitCode ? process.cwd() : ((await pickExe()) || '')),
         stdio: STDIO,
         graceMs: 3000,
       })
       const outcome = handle && handle.done ? await handle.done.catch(() => null) : null
+      if (!wantExitCode) return undefined
       return outcome && typeof outcome.exitCode === 'number' ? outcome.exitCode : null
     } catch (error) {
+      if (!wantExitCode) throw error
       lastMarkerError = String((error && error.message) || error)
       return null
     }
@@ -236,7 +373,7 @@ export function apply(ctx, config) {
   async function quitScriptFor(value) {
     const exe = await pickExe()
     if (!exe) return null
-    const dir = exe.slice(0, exe.lastIndexOf('\\'))
+    const dir = dirOf(exe)
     return {
       dir,
       // dir/value 一律经 psQuote 转义（单引号翻倍），避免含单引号的路径破坏脚本。
@@ -244,23 +381,19 @@ export function apply(ctx, config) {
     }
   }
 
-  async function writeQuitMarker(value) {
+  /**
+   * 写退出标记（`.dsh-quit`）。
+   * - `wait: true`（默认）：等待 PowerShell 结束，成功/失败都记入 `lastMarkerError`；
+   * - `wait: false`：即发即忘（退出收尾阶段不为写标记增加延迟）。
+   * 原 writeQuitMarkerNoWait 与本函数仅此一点差异，合并后由参数区分（v2 C3）。
+   */
+  async function writeQuitMarker(value, { wait = true } = {}) {
     const job = await quitScriptFor(value)
     if (!job) {
-      lastMarkerError = 'writeQuitMarker: no exe dir'
+      if (wait) lastMarkerError = 'writeQuitMarker: no exe dir'
       return
     }
-    try {
-      await runPowerShell(job.script, job.dir)
-      lastMarkerError = ''
-    } catch (error) {
-      lastMarkerError = String((error && error.message) || error)
-    }
-  }
-
-  function writeQuitMarkerNoWait(value) {
-    void quitScriptFor(value).then((job) => {
-      if (!job) return
+    if (!wait) {
       try {
         subprocess.spawn({
           argv: ['powershell', '-NoProfile', '-NonInteractive', '-Command', job.script],
@@ -271,29 +404,42 @@ export function apply(ctx, config) {
       } catch (error) {
         lastMarkerError = String((error && error.message) || error)
       }
-    })
+      return
+    }
+    try {
+      await runPowerShell(job.script, job.dir)
+      lastMarkerError = ''
+    } catch (error) {
+      lastMarkerError = String((error && error.message) || error)
+    }
   }
 
   async function quitFileGone() {
     const exe = await pickExe()
     if (!exe) return true
-    const dir = exe.slice(0, exe.lastIndexOf('\\'))
+    const dir = dirOf(exe)
     return (await fileText(dir, '.dsh-quit')) === null
   }
 
   async function quitMarkerIsOne() {
     const exe = await pickExe()
     if (!exe) return false
-    const dir = exe.slice(0, exe.lastIndexOf('\\'))
+    const dir = dirOf(exe)
     return (await fileText(dir, '.dsh-quit')) === '1'
   }
 
   function shortcutExistsScript() {
-    return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(resolved.shortcutName) + "; if (Test-Path -LiteralPath $lnk) { exit 0 } else { exit 1 }"
+    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(resolved.shortcutName) + "; " +
+    return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(SHORTCUT_NAME) + "; " +
       "$exe=" + psQuote(exe) + "; " +
       '$ws=New-Object -ComObject WScript.Shell; $sc=$ws.CreateShortcut($lnk); ' +
       '$sc.TargetPath=$exe; $sc.WorkingDirectory=Split-Path $exe; ' +
@@ -302,7 +448,7 @@ export function apply(ctx, config) {
   }
 
   function shortcutDeleteScript() {
-    return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(resolved.shortcutName) + '; ' +
+    return "$desktop=[Environment]::GetFolderPath('Desktop'); $lnk=Join-Path $desktop " + psQuote(SHORTCUT_NAME) + '; ' +
       'Remove-Item -LiteralPath $lnk -Force -ErrorAction SilentlyContinue; ' +
       'if (Test-Path -LiteralPath $lnk) { exit 1 } else { exit 0 }'
   }
@@ -310,7 +456,7 @@ export function apply(ctx, config) {
   async function shortcutExists() {
     const now = Date.now()
     if (now - shortcutCache.t < 5000) return shortcutCache.value
-    const code = await runPowerShellExitCode(shortcutExistsScript(), process.cwd())
+    const code = await runPowerShell(shortcutExistsScript(), process.cwd(), { wantExitCode: true })
     shortcutCache = { t: Date.now(), value: code === 0 }
     return shortcutCache.value
   }
@@ -319,14 +465,14 @@ export function apply(ctx, config) {
     if (await shortcutExists()) return true
     const exe = await pickExe()
     if (!exe) return false
-    const code = await runPowerShellExitCode(shortcutCreateScript(exe), process.cwd())
+    const code = await runPowerShell(shortcutCreateScript(exe), process.cwd(), { wantExitCode: true })
     shortcutCache = { t: Date.now(), value: code === 0 }
     return code === 0
   }
 
   async function removeShortcut() {
     if (!(await shortcutExists())) return true
-    const code = await runPowerShellExitCode(shortcutDeleteScript(), process.cwd())
+    const code = await runPowerShell(shortcutDeleteScript(), process.cwd(), { wantExitCode: true })
     shortcutCache = { t: Date.now(), value: code !== 0 }
     return code === 0
   }
@@ -338,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)))
@@ -373,7 +523,9 @@ export function apply(ctx, config) {
         return { ok: false, error: 'subprocess 服务不可用，无法启动桌面应用。', diag: await buildDiag() }
       }
       try {
-        const dir = exe.slice(0, exe.lastIndexOf('\\'))
+        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() }
@@ -410,11 +562,11 @@ export function apply(ctx, config) {
     }
     if (confirmed) {
       if (owned && owned.done) await Promise.race([owned.done.catch(() => {}), sleep(3000)])
-      writeQuitMarkerNoWait('0')
+      void writeQuitMarker('0', { wait: false })
       if (!(await removeShortcut())) lastMarkerError = 'shortcut sync failed (delete)'
       return { ok: true, desktop: false, shortcut: await shortcutExists(), diag: '' }
     }
-    writeQuitMarkerNoWait('0')
+    void writeQuitMarker('0', { wait: false })
     const state = await waitGone(20)
     if (state === true) {
       if (!(await removeShortcut())) lastMarkerError = 'shortcut sync failed (delete)'
@@ -423,7 +575,7 @@ export function apply(ctx, config) {
     if (state === null) return { ok: true, desktop: null, shortcut: await shortcutExists(), diag: '' }
     try {
       const exe = await pickExe()
-      const dir = exe ? exe.slice(0, exe.lastIndexOf('\\')) : process.cwd()
+      const dir = (exe && dirOf(exe)) || process.cwd()
       // 仅终止与探测到的 exe 路径匹配的进程，避免误杀其他同名程序。
       const script = "$p = Get-Process -Name dsh-launcher -ErrorAction SilentlyContinue | Where-Object { $_.Path -eq " + psQuote(exe || '') + " }; if ($p) { $p | Stop-Process -Force -ErrorAction SilentlyContinue }"
       await runPowerShell(script, dir)
@@ -445,39 +597,46 @@ export function apply(ctx, config) {
   }
 
   ctx.effect(() => {
+    /**
+     * 统一的信任边界守卫：回环 + 同源（自定义头 / Origin / Referer）校验，
+     * 不通过直接 403。原实现把这三行复制进每个 handler（优化报告 v2 C4）。
+     */
+    const guard = (handler) => async (req, res) => {
+      if (!isTrustedRequest(req, ctx.webServer.port)) {
+        return writeJson(res, 403, { ok: false, error: 'forbidden' })
+      }
+      return handler(req, res)
+    }
+
     const routes = [
       {
         kind: 'exact',
         path: '/api/dsh-tauri-launcher/state',
-        handler: async (req, res) => {
-          if (!isTrustedRequest(req, ctx.webServer.port)) return writeJson(res, 403, { ok: false, error: 'forbidden' })
+        handler: guard(async (_req, res) => {
           writeJson(res, 200, await getState())
-        },
+        }),
       },
       {
         kind: 'exact',
         path: '/api/dsh-tauri-launcher/set-desktop',
-        handler: async (req, res) => {
-          if (!isTrustedRequest(req, ctx.webServer.port)) return writeJson(res, 403, { ok: false, error: 'forbidden' })
+        handler: guard(async (req, res) => {
           const body = await readJsonBody(req)
           writeJson(res, 200, await setDesktop(Boolean(body.enabled)))
-        },
+        }),
       },
       {
         kind: 'exact',
         path: '/api/dsh-tauri-launcher/set-shortcut',
-        handler: async (req, res) => {
-          if (!isTrustedRequest(req, ctx.webServer.port)) return writeJson(res, 403, { ok: false, error: 'forbidden' })
+        handler: guard(async (_req, res) => {
           writeJson(res, 200, await setShortcut())
-        },
+        }),
       },
       {
         kind: 'exact',
         path: '/api/dsh-tauri-launcher/diagnose',
-        handler: async (req, res) => {
-          if (!isTrustedRequest(req, ctx.webServer.port)) return writeJson(res, 403, { ok: false, error: 'forbidden' })
+        handler: guard(async (_req, res) => {
           writeJson(res, 200, await getDiag())
-        },
+        }),
       },
     ]
     const disposers = routes.map((route) => ctx.webServer.register(route))

package/package.json

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