@lenorin/dsh-tauri-launcher 1.0.7 → 1.0.9

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,11 @@ 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。
+
 ## 桌面应用构建与发布
 
 - npm 包自带预编译 exe（`launcher/bin/dsh-launcher.exe`），插件安装后自动探测、装上即用；
@@ -149,6 +152,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

@@ -3,6 +3,16 @@
  * 在设置面板注册「桌面启动」分区：桌面端启动开关（含快速确认与乐观反馈）、
  * 添加快捷方式按钮、关闭确认弹窗、诊断信息（仅出错时显示）。
  * 与宿主通信走 /api/dsh-tauri-launcher/*（同源 fetch，仅回环）。
+ *
+ * 除设置分区外，本文件还承载两个与桌面端外壳（Tauri 主窗口）协作的功能，
+ * 仅在页面被 iframe 内嵌（桌面端）时启用：
+ * 1. 标题栏主题中继：把 DSH 主题方案与真实生效的 token 发给外壳（installThemeRelay）；
+ * 2. 会话导航栈 + 系统主题跟随（installSessionNav / installSystemThemeFollow）。
+ *
+ * 模块级结构（2026-09 阶段一拆分，见优化报告 v2）：
+ * - createSessionNavStack：应用层会话导航栈（纯逻辑，无 DOM/服务依赖，可单测）
+ * - retryLadder：服务就绪重试梯子（theme/change 事件、sessions 服务可能后于插件就绪）
+ * - installDesktopSection / installThemeRelay / installSystemThemeFollow / installSessionNav
  */
 window.__ModuleLoader__.load({
   id: '@lenorin/dsh-tauri-launcher',
@@ -114,12 +124,153 @@ body [class*='centerCol'] {
       },
     }
 
+    /**
+     * 服务就绪重试梯子：目标服务（theme/change 事件、sessions）可能在插件
+     * 之后才就绪，且 preference 等于默认值时不会发变化事件——用短重试保证
+     * 初始状态一定送达（成功或达到 maxTries 后停止）。返回清理函数。
+     */
+    function retryLadder(attempt, { immediate = false, intervalMs = 500, maxTries = 12 } = {}) {
+      let done = false
+      let tries = 0
+      const run = () => {
+        if (done) return
+        try {
+          if (attempt()) done = true
+        } catch { /* 服务未就绪，下一轮重试 */ }
+      }
+      if (immediate) run()
+      const timer = setInterval(() => {
+        tries += 1
+        if (done || tries >= maxTries) {
+          clearInterval(timer)
+          return
+        }
+        run()
+      }, intervalMs)
+      return () => clearInterval(timer)
+    }
+
+    /**
+     * 应用层会话导航栈（纯逻辑，无 DOM / DSH 服务依赖，可单测）。
+     * DSH 是 React SPA：切会话不产生浏览器历史条目，history.back() 无效，
+     * 前进/后退等价于在「最近访问会话」双栈上移动（对标浏览器语义）：
+     * - 非跳转来源的 current 变化 → 上一个会话压 backStack、清空 forwardStack；
+     * - goBack/goForward 弹栈跳转，当前会话压对向栈；栈条目 { id, address }
+     *   （address 供 catalog 子会话 openSubagent）；上限 cap、连续重复跳过；
+     * - 跳转前置 pendingJump 锁，防止自身触发的变化被当作用户切换重复压栈，
+     *   超时（jumpTimeoutMs）兜底解锁，由调用方传入 onUnlock 回调同步最新状态。
+     */
+    function createSessionNavStack({ cap = 50, jumpTimeoutMs = 1500 } = {}) {
+      let backStack = []
+      let forwardStack = []
+      let currentId = undefined
+      let currentAddress = undefined
+      let pendingJump = null
+      let jumpTimer = null
+
+      const pushStack = (stack, entry) => {
+        const top = stack[stack.length - 1]
+        if (top && top.id === entry.id && top.address === entry.address) return
+        stack.push(entry)
+        if (stack.length > cap) stack.shift()
+      }
+
+      const clearJumpTimer = () => {
+        if (jumpTimer) {
+          clearTimeout(jumpTimer)
+          jumpTimer = null
+        }
+      }
+
+      return {
+        /** 前进/后退两个方向当前是否可走（供外壳置灰按钮）。 */
+        status: () => ({ back: backStack.length > 0, forward: forwardStack.length > 0 }),
+        /** 以快照初始化当前会话（订阅前先取一次快照；跳转解锁后同步最新状态）。 */
+        init: (id, address) => {
+          currentId = id
+          currentAddress = address
+        },
+        /** 跳转锁是否生效中。 */
+        isPending: () => pendingJump !== null,
+        /**
+         * 非跳转来源的 current 变化。返回 true 表示状态对外可见变化（调用方应上报）。
+         * 规则：current 变 undefined 只清 address；同 id 只更新 address（不压栈）；
+         * 真正切换才压 backStack 并清空 forwardStack。
+         */
+        onExternalChange(snap) {
+          if (snap.id === undefined) {
+            currentAddress = undefined
+            return true
+          }
+          if (snap.id === currentId) {
+            if (snap.address !== undefined) currentAddress = snap.address
+            return false
+          }
+          if (currentId !== undefined) {
+            pushStack(backStack, { id: currentId, address: currentAddress })
+            forwardStack = []
+          }
+          currentId = snap.id
+          currentAddress = snap.address
+          return true
+        },
+        /**
+         * 跳转锁生效期间的变化。返回 true 表示跳转已被确认（命中目标）或被
+         * 用户的新切换取代（二者都应解锁并同步状态后上报）。
+         */
+        onPendingChange(snap) {
+          if (snap.id === pendingJump.id || (snap.id !== undefined && snap.id !== currentId)) {
+            clearJumpTimer()
+            pendingJump = null
+            currentId = snap.id
+            currentAddress = snap.address
+            return true
+          }
+          return false
+        },
+        /** 后退：弹出目标（当前会话压 forwardStack）。无可退时返回 null。 */
+        goBack() {
+          if (backStack.length === 0) return null
+          const target = backStack.pop()
+          if (currentId !== undefined) pushStack(forwardStack, { id: currentId, address: currentAddress })
+          return target
+        },
+        /** 前进：对称于 goBack。 */
+        goForward() {
+          if (forwardStack.length === 0) return null
+          const target = forwardStack.pop()
+          if (currentId !== undefined) pushStack(backStack, { id: currentId, address: currentAddress })
+          return target
+        },
+        /**
+         * 准备一次跳转：置 pendingJump 锁、同步 current，并启动超时兜底 timer。
+         * 超时先解锁再回调 onUnlock（调用方应读最新快照并上报）；跳转动作抛出
+         * 异常时调用 abortJump 回滚锁（timer 保留：到期仍会同步一次状态）。
+         */
+        jumpTo(entry, onUnlock) {
+          pendingJump = { id: entry.id, address: entry.address }
+          currentId = entry.id
+          currentAddress = entry.address
+          clearJumpTimer()
+          jumpTimer = setTimeout(() => {
+            pendingJump = null
+            onUnlock()
+          }, jumpTimeoutMs)
+        },
+        /** 跳转动作抛出异常时回滚锁。 */
+        abortJump: () => {
+          pendingJump = null
+        },
+        /** 释放 timer（插件卸载时）。 */
+        dispose: clearJumpTimer,
+      }
+    }
+
     exports.inject = ['slots']
 
-    exports.apply = function (ctx) {
-      const slots = ctx.get('slots')
-      if (slots === undefined) return
+    /* ---------- 设置分区「桌面启动」 ---------- */
 
+    function installDesktopSection(ctx, slots) {
       const styleEl = document.createElement('style')
       styleEl.dataset.plugin = '@lenorin/dsh-tauri-launcher'
       styleEl.textContent = CSS
@@ -269,14 +420,43 @@ body [class*='centerCol'] {
         { name: 'settings.section', id: 'desktop-launch', order: 30, label: '桌面启动' },
         () => React.createElement(DesktopSection, null),
       ))
+    }
+
+    /* ---------- 外壳 ↔ 插件 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',
+    }
 
-      // ---------- 标题栏主题中继 ----------
-      // 桌面端把 DSH 嵌在 iframe 里；这里读取官方主题服务解析出的浅/深方案，
-      // 并把 DSH 页面真实生效的设计 token（计算样式）发给启动器外壳，
-      // 让标题栏与 DSH 配色逐像素一致。仅当本页面被嵌入（iframe）时才有意义，
-      // 普通浏览器标签（window.parent === window）直接跳过。
-      // 注意：内置主题的快照 tokens 是空表，真实颜色在 CSS 变量里
-      // （body[data-ds-dark-theme] 切换），必须经 getComputedStyle 取。
+    /** 读取信封载荷；版本或类型不匹配时返回 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 → 外壳） ---------- */
+
+    /**
+     * 桌面端把 DSH 嵌在 iframe 里；这里读取官方主题服务解析出的浅/深方案，
+     * 并把 DSH 页面真实生效的设计 token（计算样式）发给启动器外壳，
+     * 让标题栏与 DSH 配色逐像素一致。仅当本页面被嵌入（iframe）时才有意义，
+     * 普通浏览器标签（window.parent === window）直接跳过。
+     * 注意：内置主题的快照 tokens 是空表，真实颜色在 CSS 变量里
+     * （body[data-ds-dark-theme] 切换），必须经 getComputedStyle 取。
+     * ⚠️ 所有读取都在当前任务之后（见下方 schedulePost 的时序说明）——
+     * 同步读会拿到上一个主题的 DOM 状态，标题栏会滞后一个主题。
+     */
+    function installThemeRelay(ctx) {
       const readVar = (name) => {
         try {
           const style = getComputedStyle(document.body)
@@ -292,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')
@@ -307,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'),
@@ -317,257 +498,279 @@ body [class*='centerCol'] {
           sep: readVar('--dsw-alias-border-l1'),
           danger: readVar('--dsw-alias-state-error-primary'),
         }
-        themeSent = true
-        window.parent.postMessage(payload, '*')
+        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 { /* 事件不可用时依赖下面的重试梯子 */ }
 
-      // 主题服务可能在本插件之后才就绪，且 preference 等于默认值时不会发 theme/change：
-      // 用一个短重试梯子保证初始状态一定送达（成功或 6 秒后停止）。
-      let themeTries = 0
-      const themeTimer = setInterval(() => {
-        themeTries += 1
-        if (themeSent || themeTries >= 12) {
-          clearInterval(themeTimer)
-          return
-        }
-        postTheme()
-      }, 500)
-      ctx.effect(() => () => clearInterval(themeTimer), 'dsh-tauri-launcher: theme relay timer')
-
-      // ---------- 会话导航（应用层会话栈，等价浏览器前进/后退） ----------
-      // DSH 是 React SPA：切会话不产生浏览器历史条目，history.back() 无效。
-      // 这里维护"最近访问会话"栈：非本插件发起的 current 变化 → 上一个会话压
-      // backStack、清空 forwardStack；◀ 弹 backStack 跳转（当前压 forwardStack），
-      // ▶ 反向。跳转前设 pendingJump 锁，防止自身触发的变化被重复压栈，超时兜底解锁。
-      // sessions 服务存在就绪时序：一次性 ctx.get 可能拿到 undefined（静默失效），
-      // 故用重试梯子初始化；外壳每 3 秒 ping 一次，状态周期性回报实现自愈。
-      if (window.parent !== window) {
-        let navDispose = null
-        let navReady = false
+      // 兜底：直接观察 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')
+      }
 
-        // 父窗口 origin：跨源读不到 window.parent.location，用 document.referrer 推导
-        let parentOrigin = 'http://tauri.localhost'
-        try {
-          if (document.referrer) parentOrigin = new URL(document.referrer).origin
-        } catch { /* 兜底 http://tauri.localhost */ }
-
-        // ---------- 桌面端系统主题跟随 ----------
-        // WebView2 页面里的 prefers-color-scheme 只有宿主显式设置
-        // PreferredColorScheme 才会随 Windows 变化，而 tauri/wry 未暴露该能力
-        // （wry#806），DSH 的 `system` 偏好会被冻结在启动时的取值。启动器轮询
-        // 到系统主题变化后经外壳 postMessage 转发到这里：偏好为 `system` 时把
-        // ThemeRuntime 持有的 MediaQueryList.matches（冻结值）覆盖为真实系统值
-        // 并触发重发布——偏好保持「跟随系统」不变，界面随真实系统主题切换；
-        // 用户手动选了固定主题时不干预。浏览器直开不进入本块（Chromium 原生跟随）。
-        // ⚠️ 兼容层 hack：依赖 ThemeRuntime 的 media/publish 运行时成员（无真
-        // 私有化），外壳升级若重命名则静默退化为现状（跟随失效，无副作用）。
-        const applySystemTheme = (scheme) => {
-          try {
-            const theme = ctx.get('theme')
-            if (!theme || !(theme.media instanceof MediaQueryList)) return
-            if (typeof theme.publish !== 'function') return
-            const snap = typeof theme.getTheme === 'function' ? theme.getTheme() : null
-            if (!snap || snap.preference !== 'system') return
-            if (snap.active && snap.active.colorScheme === scheme) return
-            const desc = Object.getOwnPropertyDescriptor(MediaQueryList.prototype, 'matches')
-            if (!desc || typeof desc.get !== 'function') return
-            const wantDark = scheme === 'dark'
-            Object.defineProperty(theme.media, 'matches', {
-              configurable: true,
-              get() { return wantDark }
-            })
-            theme.publish()
-          } catch { /* 主题服务异常：忽略，等待下次通知 */ }
-        }
+      // 主题服务可能在本插件之后才就绪，且 preference 等于默认值时不会发
+      // theme/change：用重试梯子保证初始状态一定送达（成功或 6 秒后停止）。
+      const disposeTimer = retryLadder(schedulePost, {})
+      ctx.effect(() => disposeTimer, 'dsh-tauri-launcher: theme relay timer')
+    }
 
-        const onSystemThemeMessage = (event) => {
-          const data = event.data || {}
-          if (event.source !== window.parent) return
-          if (event.origin !== parentOrigin) return
-          const scheme = data.__tbSystemTheme
-          if (scheme === 'light' || scheme === 'dark') applySystemTheme(scheme)
-        }
-        window.addEventListener('message', onSystemThemeMessage)
-        ctx.effect(() => () => window.removeEventListener('message', onSystemThemeMessage), 'dsh-tauri-launcher: system theme follow')
+    /* ---------- 桌面端系统主题跟随（外壳 → DSH） ---------- */
+
+    /**
+     * WebView2 页面里的 prefers-color-scheme 只有宿主显式设置
+     * PreferredColorScheme 才会随 Windows 变化，而 tauri/wry 未暴露该能力
+     * （wry#806），DSH 的 `system` 偏好会被冻结在启动时的取值。启动器轮询
+     * 到系统主题变化后经外壳 postMessage 转发到这里：偏好为 `system` 时把
+     * ThemeRuntime 持有的 MediaQueryList.matches（冻结值）覆盖为真实系统值
+     * 并触发重发布——偏好保持「跟随系统」不变，界面随真实系统主题切换；
+     * 用户手动选了固定主题时不干预。
+     * ⚠️ 兼容层 hack：依赖 ThemeRuntime 的 media/publish 运行时成员（无真
+     * 私有化），外壳升级若重命名则静默退化为现状（跟随失效，无副作用）。
+     */
+    function installSystemThemeFollow(ctx, parentOrigin) {
+      const applySystemTheme = (scheme) => {
+        try {
+          const theme = ctx.get('theme')
+          if (!theme || !(theme.media instanceof MediaQueryList)) return
+          if (typeof theme.publish !== 'function') return
+          const snap = typeof theme.getTheme === 'function' ? theme.getTheme() : null
+          if (!snap || snap.preference !== 'system') return
+          if (snap.active && snap.active.colorScheme === scheme) return
+          const desc = Object.getOwnPropertyDescriptor(MediaQueryList.prototype, 'matches')
+          if (!desc || typeof desc.get !== 'function') return
+          const wantDark = scheme === 'dark'
+          Object.defineProperty(theme.media, 'matches', {
+            configurable: true,
+            get() { return wantDark }
+          })
+          theme.publish()
+        } catch { /* 主题服务异常：忽略，等待下次通知 */ }
+      }
 
-        const initNav = () => {
-          const sessions = ctx.get('sessions')
-          const store = sessions && sessions.list
-          if (!store || typeof store.subscribe !== 'function') {
-            return false
-          }
+      const onSystemThemeMessage = (event) => {
+        const data = event.data || {}
+        if (!isShellMessage(event, parentOrigin)) return
+        const scheme = data.__tbSystemTheme
+        if (scheme === 'light' || scheme === 'dark') applySystemTheme(scheme)
+      }
+      window.addEventListener('message', onSystemThemeMessage)
+      ctx.effect(() => () => window.removeEventListener('message', onSystemThemeMessage), 'dsh-tauri-launcher: system theme follow')
+    }
 
-          const CAP = 50
-          let backStack = []
-          let forwardStack = []
-          let currentId = undefined
-          let currentAddress = undefined
-          let pendingJump = null
-          let jumpTimer = null
-
-          const snapCurrent = () => {
-            const snap = store.getSnapshot()
-            return { id: snap.current, address: snap.currentAddress }
-          }
+    /* ---------- 会话导航（应用层会话栈，等价浏览器前进/后退） ---------- */
 
-          const sendStatus = () => {
-            if (window.parent === window) return
-            const payload = { __tbNavStatus: { back: backStack.length > 0, forward: forwardStack.length > 0 } }
-            try {
-              // 用 '*' 投递：WebView2 下对 http://tauri.localhost 虚拟主机的
-              // 精确 targetOrigin 匹配有丢弃嫌疑；外壳侧会校验 event.origin。
-              window.parent.postMessage(payload, '*')
-            } catch { /* 忽略 */ }
-          }
+    /**
+     * sessions 服务存在就绪时序：一次性 ctx.get 可能拿到 undefined（静默失效），
+     * 故用重试梯子初始化；外壳每 3 秒 ping 一次，状态周期性回报实现自愈。
+     */
+    function installSessionNav(ctx, parentOrigin) {
+      let navDispose = null
 
-          const pushStack = (stack, entry) => {
-            const top = stack[stack.length - 1]
-            if (top && top.id === entry.id && top.address === entry.address) return
-            stack.push(entry)
-            if (stack.length > CAP) stack.shift()
-          }
+      const initNav = () => {
+        const sessions = ctx.get('sessions')
+        const store = sessions && sessions.list
+        if (!store || typeof store.subscribe !== 'function') {
+          return false
+        }
 
-          const jumpTo = (entry) => {
-            pendingJump = { id: entry.id, address: entry.address }
-            currentId = entry.id
-            currentAddress = entry.address
-            clearTimeout(jumpTimer)
-            jumpTimer = setTimeout(() => {
-              pendingJump = null
-              const snap = snapCurrent()
-              currentId = snap.id
-              currentAddress = snap.address
-              sendStatus()
-            }, 1500)
-            try {
-              if (entry.address) sessions.openSubagent(entry.address)
-              else sessions.open(entry.id)
-            } catch {
-              pendingJump = null
-            }
-          }
+        const snapCurrent = () => {
+          const snap = store.getSnapshot()
+          return { id: snap.current, address: snap.currentAddress }
+        }
 
-          const goBack = () => {
-            if (backStack.length === 0) return
-            const target = backStack.pop()
-            if (currentId !== undefined) pushStack(forwardStack, { id: currentId, address: currentAddress })
-            sendStatus()
-            jumpTo(target)
-          }
+        const nav = createSessionNavStack()
 
-          const goForward = () => {
-            if (forwardStack.length === 0) return
-            const target = forwardStack.pop()
-            if (currentId !== undefined) pushStack(backStack, { id: currentId, address: currentAddress })
-            sendStatus()
-            jumpTo(target)
-          }
+        const sendStatus = () => {
+          if (window.parent === window) return
+          const status = { back: nav.status().back, forward: nav.status().forward }
+          try {
+            // 双发：信封（新）+ 旧字段（兼容旧版外壳）。用 '*' 投递：WebView2 下
+            // 对 http://tauri.localhost 虚拟主机的精确 targetOrigin 匹配有丢弃
+            // 嫌疑；外壳侧会校验 event.origin。
+            window.parent.postMessage(
+              { __tbNavStatus: status, v: MSG_VERSION, type: MSG.NAV_STATUS, payload: status },
+              '*',
+            )
+          } catch { /* 忽略 */ }
+        }
 
-          const onListChange = () => {
+        const jumpTo = (entry) => {
+          nav.jumpTo(entry, () => {
+            // 超时兜底解锁：读最新快照同步当前会话并上报。
             const snap = snapCurrent()
-            if (pendingJump) {
-              if (snap.id === pendingJump.id || snap.id !== undefined && snap.id !== currentId) {
-                pendingJump = null
-                clearTimeout(jumpTimer)
-                currentId = snap.id
-                currentAddress = snap.address
-                sendStatus()
-              }
-              return
-            }
-            if (snap.id === undefined) {
-              currentAddress = undefined
-              sendStatus()
-              return
-            }
-            if (snap.id === currentId) {
-              if (snap.address !== undefined) currentAddress = snap.address
-              return
-            }
-            if (currentId !== undefined) {
-              pushStack(backStack, { id: currentId, address: currentAddress })
-              forwardStack = []
-            }
-            currentId = snap.id
-            currentAddress = snap.address
+            nav.init(snap.id, snap.address)
             sendStatus()
+          })
+          try {
+            if (entry.address) sessions.openSubagent(entry.address)
+            else sessions.open(entry.id)
+          } catch {
+            nav.abortJump()
           }
+        }
 
-          const onNavMessage = (event) => {
-            const data = event.data || {}
-            if (event.source !== window.parent) return
-            if (event.origin !== parentOrigin) return
-            const dir = data.__tbNav
-            if (dir === 'back') goBack()
-            else if (dir === 'forward') goForward()
-            else if (dir === 'ping') sendStatus()
-          }
-          window.addEventListener('message', onNavMessage)
-
-          const onKeydown = (event) => {
-            if (!event.altKey || event.ctrlKey || event.shiftKey) return
-            if (event.key === 'ArrowLeft') {
-              event.preventDefault()
-              goBack()
-            } else if (event.key === 'ArrowRight') {
-              event.preventDefault()
-              goForward()
-            }
-          }
-          window.addEventListener('keydown', onKeydown, true)
-
-          // 鼠标侧键：DOM button 3 = 后退（XButton1）、4 = 前进（XButton2）
-          const onMouseup = (event) => {
-            if (event.button === 3) {
-              event.preventDefault()
-              goBack()
-            } else if (event.button === 4) {
-              event.preventDefault()
-              goForward()
-            }
-          }
-          window.addEventListener('mouseup', onMouseup, true)
+        const goBack = () => {
+          const target = nav.goBack()
+          if (!target) return
+          sendStatus()
+          jumpTo(target)
+        }
 
-          const unsubscribe = store.subscribe(onListChange)
-          const init = snapCurrent()
-          currentId = init.id
-          currentAddress = init.address
+        const goForward = () => {
+          const target = nav.goForward()
+          if (!target) return
           sendStatus()
+          jumpTo(target)
+        }
 
-          navDispose = () => {
-            if (typeof unsubscribe === 'function') unsubscribe()
-            clearTimeout(jumpTimer)
-            window.removeEventListener('message', onNavMessage)
-            window.removeEventListener('keydown', onKeydown, true)
-            window.removeEventListener('mouseup', onMouseup, true)
+        const onListChange = () => {
+          const snap = snapCurrent()
+          if (nav.isPending()) {
+            if (nav.onPendingChange(snap)) sendStatus()
+            return
           }
-          return true
+          if (nav.onExternalChange(snap)) sendStatus()
         }
 
-        // 立即尝试一次，再走重试梯子（服务可能在之后才就绪）
-        let navTries = 0
-        try {
-          navReady = initNav()
-        } catch { /* 服务未就绪，走重试 */ }
-        const navTimer = setInterval(() => {
-          navTries += 1
-          if (navReady || navTries >= 12) {
-            clearInterval(navTimer)
-            return
+        const onNavMessage = (event) => {
+          const data = event.data || {}
+          if (!isShellMessage(event, parentOrigin)) return
+          const dir = data.__tbNav
+          if (dir === 'back') goBack()
+          else if (dir === 'forward') goForward()
+          else if (dir === 'ping') sendStatus()
+        }
+        window.addEventListener('message', onNavMessage)
+
+        const onKeydown = (event) => {
+          if (!event.altKey || event.ctrlKey || event.shiftKey) return
+          if (event.key === 'ArrowLeft') {
+            event.preventDefault()
+            goBack()
+          } else if (event.key === 'ArrowRight') {
+            event.preventDefault()
+            goForward()
           }
-          try {
-            navReady = initNav()
-          } catch { /* 下一轮重试 */ }
-        }, 500)
-
-        ctx.effect(() => () => {
-          clearInterval(navTimer)
-          if (navDispose) navDispose()
-        }, 'dsh-tauri-launcher: session nav')
+        }
+        window.addEventListener('keydown', onKeydown, true)
+
+        // 鼠标侧键：DOM button 3 = 后退（XButton1）、4 = 前进（XButton2）
+        const onMouseup = (event) => {
+          if (event.button === 3) {
+            event.preventDefault()
+            goBack()
+          } else if (event.button === 4) {
+            event.preventDefault()
+            goForward()
+          }
+        }
+        window.addEventListener('mouseup', onMouseup, true)
+
+        const unsubscribe = store.subscribe(onListChange)
+        const init = snapCurrent()
+        nav.init(init.id, init.address)
+        sendStatus()
+
+        navDispose = () => {
+          if (typeof unsubscribe === 'function') unsubscribe()
+          nav.dispose()
+          window.removeEventListener('message', onNavMessage)
+          window.removeEventListener('keydown', onKeydown, true)
+          window.removeEventListener('mouseup', onMouseup, true)
+        }
+        return true
+      }
+
+      // 立即尝试一次，再走重试梯子（服务可能在之后才就绪）
+      const disposeTimer = retryLadder(initNav, { immediate: true })
+
+      ctx.effect(() => () => {
+        disposeTimer()
+        if (navDispose) navDispose()
+      }, 'dsh-tauri-launcher: session nav')
+    }
+
+    /**
+     * 父窗口 origin：跨源读不到 window.parent.location，用 document.referrer
+     * 推导。**注意 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 { /* 兜底见 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
+
+      installDesktopSection(ctx, slots)
+
+      // 主题中继内部自带 window.parent 检查（浏览器直开自动不启用）。
+      installThemeRelay(ctx)
+
+      // 以下功能仅在 iframe 内嵌（桌面端）时有意义；浏览器直开时
+      // Chromium 原生跟随系统主题、且无标题栏，直接跳过。
+      if (window.parent !== window) {
+        const parentOrigin = deriveParentOrigin()
+        installSystemThemeFollow(ctx, parentOrigin)
+        installSessionNav(ctx, parentOrigin)
       }
     }
 

package/lib/index.js

@@ -28,9 +28,22 @@ const PACKAGE_BIN = fileURLToPath(new URL('../launcher/bin', import.meta.url))
 /** 未配置 launcherDirs 时的默认候选目录（仅包内随附的预编译 exe；本地自行构建的 exe 通过行配置 launcherDirs/launcherExe 指定）。 */
 const DEFAULT_DIRS = [PACKAGE_BIN]
 
+/**
+ * 桌面快捷方式文件名。**单一来源**：必须与桌面应用 `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 +82,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,8 +125,6 @@ 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 = ''
@@ -113,8 +135,8 @@ export function apply(ctx, config) {
   function baseDirs() {
     const list = resolved.launcherDirs.slice()
     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 DEFAULT_DIRS) list.push(dir)
     return [...new Set(list)]
@@ -156,8 +178,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 +231,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 +265,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 +273,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 +296,36 @@ 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 }"
   }
 
   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 +334,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 +342,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 +351,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
   }
@@ -373,7 +405,7 @@ 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)
         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 +442,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 +455,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 +477,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.7",
+  "version": "1.0.9",
   "description": "DSH Web 插件：基于 Tauri 2 的 DeepSeek Harness 桌面启动器，自动联动桌面快捷方式，exe 路径与探测窗口可配置。",
   "type": "module",
   "main": "lib/index.js",