dsh-windows-tray 1.0.13 → 1.0.14

package/launcher/dsh-lib.ps1

@@ -2,20 +2,153 @@
 # 被 dsh-control.ps1 (控制台) 与 dsh-tray.ps1 (系统托盘) 点源引用 (dot-source)
 # 所有路径/端口/进程管理逻辑的单一事实来源: 修改此处, 两个入口同时生效
 $ErrorActionPreference = 'Stop'
+# 原生命令非零退出在 Stop 模式下默认抛 NativeCommandExitException（PS 7.3/7.4 起
+# $PSNativeCommandUseErrorActionPreference 默认 $true）⇒ taskkill 命中已退 PID / 引擎调用失败
+# 会**终止控制流**并吞掉诊断。统一钉 false，退出码一律走 $LASTEXITCODE 判（2026-09-23 独审 P2-2）。
+$PSNativeCommandUseErrorActionPreference = $false
 
-$DSH_CMD = 'D:\Program Files (x86)\dsh\dsh.cmd'
-$NODE    = 'C:\Program Files\nodejs\node.exe'
-$BIN     = 'D:\Program Files (x86)\dsh\node_modules\@deepseek-ai\dsh\lib\bin.js'
-$WORKDIR = 'D:\Program Files (x86)\dsh'
-$PORT    = 3080
+$DSH_CMD = 'SET-BY-INSTALL-PS1\dsh.cmd'   # install.ps1 [6/7] 回填本机值（源码不写死机器路径，release-standards §7）
+$NODE    = 'SET-BY-INSTALL-PS1\node.exe'   # 同上
+$BIN     = 'SET-BY-INSTALL-PS1\node_modules\@deepseek-ai\dsh\lib\bin.js'   # 同上
+$WORKDIR = 'SET-BY-INSTALL-PS1'   # 同上
+$PORT    = 0
 $URL     = "http://127.0.0.1:$PORT"
 $LOG_DIR = Join-Path (Join-Path $env:USERPROFILE '.dsh\logs') 'dsh-windows-tray'   # 本插件专属日志目录 (logs\<插件名>\, 边界规则见 release-standards §3.1)
 $WT      = "$env:LOCALAPPDATA\Microsoft\WindowsApps\wt.exe"
-$PWSH    = 'D:\Program Files (x86)\PowerShell-7.6.4\pwsh.exe'
-$TRAY_VERSION = '1.0.13'   # 托盘版本 (与 npm 包版本同步, 用于日志/排查)
+$PWSH    = 'SET-BY-INSTALL-PS1\pwsh.exe'   # 同上
+$TRAY_VERSION = '1.0.14'   # 托盘版本 (与 npm 包版本同步, 用于日志/排查)
 $TRAY_PKG     = 'dsh-windows-tray'   # npm 包名 (托盘自更新)
 $TRAY_SCRIPT = Join-Path $PSScriptRoot 'dsh-tray.ps1'
 
+# ---- 原生命令输出解码：钉成 UTF-8 ----
+# 隐藏窗口里 `[Console]::OutputEncoding` 可能退回 ANSI(本机 GBK)，此时捕获 node 的 UTF-8 输出会先被
+# GBK 解码再写进日志 ⇒ 中文变乱码（2026-09-22 实测：`✔ data: 204 文件` 记成 `鉁?data: 204 鏂囦欢`，
+# 而 exit 码与数字仍对）。三个消费者（托盘/动作/boot）都点源本文件 ⇒ 在这里一处钉住。
+try {
+    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+    [Console]::OutputEncoding = $utf8NoBom   # 解码原生**输出**（我们读 node 的 stdout）
+    $OutputEncoding = $utf8NoBom             # 编码送往原生命令的**输入**
+} catch { }   # 无控制台/受限环境：失败就降级，不阻断主流程
+
+# ---- 备份状态显示（M2, 2026-09-22）----
+# 库位置**不写死盘符**（2026-09-22 用户改判）：与引擎同口径解析
+#   $env:DSH_BACKUP_STORE > 机器配置 <DSH_HOME>\backup-store.txt > 自动发现已有库（<盘>:\dsh-backups\auto\key-salt）
+# 三者都没有 ⇒ $null（状态行显示"未配置"；首次「立即备份」时引擎会自己探测并记下配置）
+function Resolve-BackupStore {
+    $envv = [string]$env:DSH_BACKUP_STORE
+    if ($envv.Trim()) { return $envv.Trim() }
+    $cfg = Join-Path ($(if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' })) 'backup-store.txt'   # 与引擎同口径：<DSH_HOME>\backup-store.txt（非默认数据目录机器此前读错位，2026-09-22 LJS 实测）
+    if (Test-Path -LiteralPath $cfg) {
+        $line = Get-Content -LiteralPath $cfg -TotalCount 1 -ErrorAction SilentlyContinue
+        if ($line -and ([string]$line).Trim()) { return ([string]$line).Trim() }
+    }
+    foreach ($c in 67..90) {                                             # C..Z：找已有库（与引擎 discovered 口径一致）
+        if (-not (Get-PSDrive -Name ([char]$c) -PSProvider FileSystem -ErrorAction SilentlyContinue)) { continue }
+        # ↑ 盘符不存在（I..Z 等）：Test-Path 直碰会抛 DriveNotFound（脚本顶 Stop ⇒ 托盘起不来，09-22 LJS 实测）——先跳过
+        $p = "$([char]$c):\dsh-backups\auto"
+        if (Test-Path -LiteralPath (Join-Path $p 'key-salt')) { return $p }
+    }
+    return $null
+}
+# 档位判定与库解析**放在文件末尾**（落点约束：晚于日志设施 Write-DshLog:163/Initialize-LogDir:189、
+# 早于托盘菜单构建 dsh-tray.ps1:192；依据 = 方案定稿 §2/§3 + 方案审 F-05）
+
+# 读库里的 status.json 并解析成状态对象（**只缓存解析结果**，age 每次现算 —— 缓存整行会把陈旧告警冻死）。
+# 缓存命中判据 = **内容本体相等**（status.json 仅数百字节，串比较可忽略）：原键 (mtime.Ticks, size) 在 NTFS 上有
+# 「同秒连续写 mtime 短暂不刷新」的陈旧读竞态（2026-09-22 LJS 实测：同长不同内容连续写 ⇒ 读到上一份，用例随机红）
+# ⇒ 换内容本体后竞态从根上消掉；缓存防的仍是重复解析（实现审 B-13 语义不变）。
+$script:backupStatusCache = $null
+function Read-BackupStatus {
+    param([string]$StorePath = $BACKUP_STORE)
+    if (-not $StorePath) { return [pscustomobject]@{ Kind = 'Missing' } }
+    $p = Join-Path $StorePath 'status.json'
+    try { $raw = Get-Content -LiteralPath $p -Raw -Encoding UTF8 -ErrorAction Stop }
+    catch { $script:backupStatusCache = $null; return [pscustomobject]@{ Kind = 'Missing' } }
+    $c = $script:backupStatusCache
+    if ($c -and $c.Store -eq $StorePath -and $c.Raw -eq $raw) { return $c.State }
+    $result = [pscustomobject]@{ Kind = 'Corrupt'; Never = @(); Items = @(); LastFailedAt = $null }
+    do {
+        if ([string]::IsNullOrWhiteSpace($raw)) { break }
+        # -DateKind String（PS 7.5+）保留原始串：不加时 ConvertFrom-Json 会把 ISO 串**自动转成 [datetime]**，
+        # 于是「lastOkAt 必须是对象」的守卫被绕过（2026-09-22 单测 ②f 实测踩到）；老版本走 fallback 兼容。
+        $s = $null
+        try { $s = $raw | ConvertFrom-Json -DateKind String } catch { try { $s = $raw | ConvertFrom-Json } catch { break } }
+        if ($null -eq $s -or $s -is [array] -or $s -isnot [System.Management.Automation.PSCustomObject]) { break }
+        # lastOkAt 必须存在且为「对象」（DateKind 不可用的老版本里 JSON 串会变 [datetime] ⇒ 一并算损坏）
+        if ($s.lastOkAt -isnot [System.Management.Automation.PSCustomObject]) { break }
+        $wanted = @('data', 'runtime', 'vault')          # 关注面（与引擎的三对象一致）
+        $never = @(); $items = @(); $bad = $false
+        foreach ($k in $wanted) {
+            $v = $s.lastOkAt.$k
+            if ($null -eq $v -or ($v -is [string] -and [string]::IsNullOrWhiteSpace($v))) { $never += $k; continue }
+            if ($v -is [datetime]) { $items += [pscustomobject]@{ Key = $k; Utc = $v.ToUniversalTime() }; continue }
+            $t = [datetime]::MinValue
+            $styles = [Globalization.DateTimeStyles]::AdjustToUniversal -bor [Globalization.DateTimeStyles]::AssumeUniversal
+            if ($v -is [string] -and [datetime]::TryParse($v, [Globalization.CultureInfo]::InvariantCulture, $styles, [ref]$t)) {
+                $items += [pscustomobject]@{ Key = $k; Utc = $t }; continue
+            }
+            $bad = $true; break                           # 键在但值不是可解析时间 ⇒ 文件坏了，不许静默当成"从未成功"
+        }
+        if ($bad) { break }
+        if ($never.Count -gt 0) { $result = [pscustomobject]@{ Kind = 'Never'; Never = $never; Items = $items; LastFailedAt = $null }; break }
+        if ($items.Count -eq 0) { break }
+        # 失败可见（B-07/B-12 的反面：备份静默停摆时托盘要看得出来）
+        $lf = $null
+        if ($s.lastFailedAt) {
+            $t2 = [datetime]::MinValue
+            $styles2 = [Globalization.DateTimeStyles]::AdjustToUniversal -bor [Globalization.DateTimeStyles]::AssumeUniversal
+            if ([datetime]::TryParse([string]$s.lastFailedAt, [Globalization.CultureInfo]::InvariantCulture, $styles2, [ref]$t2)) { $lf = $t2 }
+        }
+        $result = [pscustomobject]@{ Kind = 'Ok'; Never = @(); Items = $items; LastFailedAt = $lf }
+    } while ($false)
+    $script:backupStatusCache = @{ Store = $StorePath; Raw = $raw; State = $result }
+    return $result
+}
+
+# 返回一行给托盘顶部状态区。纯函数（除解析缓存）、可单测（tests/backup-status.test.ps1）。
+# 显示的是**最旧**那个对象 ⇒ 任一对象陈旧都不会被掩盖；同刻按 data>runtime>vault。
+# 引擎是否在位。**托盘不耦合备份引擎**（引擎由 personal-docs 的 config/tools 分发，不随 npm 包走）
+#  ⇒ 别人只装本包时，备份必须显式说"未就绪 + 怎么补"，**不能**显示成"失败/坏了"（2026-09-22 用户问）
+function Test-BackupEngine([string]$DshHomePath = $null) {
+    $h = if ($DshHomePath) { $DshHomePath } elseif ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
+    return (Test-Path -LiteralPath (Join-Path $h 'tools\dsh-backup.mjs'))
+}
+function Get-BackupStatusLine {
+    param(
+        [string]$StorePath = $BACKUP_STORE,
+        [int]$WarnHours = $BACKUP_WARN_HOURS,
+        [string]$EnginePath = $null        # 仅供单测注入"引擎文件路径"，默认走 Test-BackupEngine
+    )
+    if (-not $StorePath) {
+        $engineOk = if ($EnginePath) { Test-Path -LiteralPath $EnginePath } else { Test-BackupEngine }
+        if (-not $engineOk) { return '备份: 未就绪（缺备份引擎，见 README）⚠' }
+        return '备份: 未配置（首次「立即备份」会自动挑盘建库）'
+    }
+    $st = Read-BackupStatus -StorePath $StorePath
+    switch ($st.Kind) {
+        'Missing' { return '备份: 未配置' }
+        'Corrupt' { return '备份: 状态文件损坏' }
+        'Never' { return ('备份: 从未成功（' + ($st.Never -join '/') + '）⚠') }
+    }
+    $nowUtc = (Get-Date).ToUniversalTime()
+    # 未来时间：**任一**对象在未来即报时钟异常（此前只判"最旧"那个 ⇒ data 未来会被新鲜的 runtime 掩盖）
+    $fut = $st.Items | Where-Object { $_.Utc -gt $nowUtc.AddMinutes(5) } | Sort-Object Utc -Descending | Select-Object -First 1
+    if ($fut) { return ('备份: 时钟异常 {0} +{1}h ⚠' -f $fut.Key, [math]::Round(($fut.Utc - $nowUtc).TotalHours, 1)) }
+    # 取最旧；**同刻时按关注面顺序取 data > runtime > vault**（此前同刻会随属性序取到 vault）
+    $wanted = @('data', 'runtime', 'vault')
+    $worst = $st.Items | Sort-Object Utc, @{ Expression = { [array]::IndexOf($wanted, $_.Key) } } | Select-Object -First 1
+    $age = [math]::Round(($nowUtc - $worst.Utc).TotalHours, 1)
+    $mark = if ($age -gt $WarnHours) { '⚠' } else { '✅' }
+    # 最近一次**失败**晚于最近一次**成功** ⇒ 先说失败（否则"1h 前 ✅"会掩盖"刚刚失败"）
+    #  ⚠ 比对基准 = **最近成功**（不是上面用于显示陈旧度的"最旧成功"；证伪 FB-F9：文档与代码口径曾不一致）
+    $newest = $st.Items | Sort-Object Utc -Descending | Select-Object -First 1
+    if ($st.LastFailedAt -and $st.LastFailedAt -gt $newest.Utc) {
+        $fage = [math]::Round(($nowUtc - $st.LastFailedAt).TotalHours, 1)
+        return ('备份: 上次失败 {0}h 前 ⚠（状态停在 {1}h 前）' -f $fage, $age)
+    }
+    return ('备份: {0}h 前 {1}（{2}）' -f $age, $mark, $worst.Key)
+}
+
 function Test-Port([int]$port) {
     $client = New-Object System.Net.Sockets.TcpClient
     try {
@@ -74,9 +207,81 @@ function Initialize-LogDir {
     }
 }
 
+# ================= 插件配置与功能开关（plugin-config 统一模式，2026-09-23 立）=================
+# 目录规范：<DSH_HOME>\plugin-config\<包名>.json（供后续插件沿用；`~/.dsh` 根已有 46 条目，配置不丢根）
+# 读取纪律（方案定稿 §2）：缺失 ⇒ 内置默认且**不创建文件**；损坏 / 类型不对 / version 高于已知 ⇒ 默认值，
+#   **绝不抛错**（任何配置问题都不得阻断托盘/动作/boot 的启动）。
+# 落点（实现审 R4-A17 更正）：本块在**函数定义之后**（Write-DshLog:163 / Initialize-LogDir:189 已定义），
+#   但"设施就绪"要自己保证 ⇒ 记日志前先调一次 Initialize-LogDir（幂等）。否则在**没有日志目录**的机器上
+#   "坏配置 ⇒ 记一行"会静默丢失（实现审实测：全新 home ⇒ 零日志文件）。菜单构建在 dsh-tray.ps1:192（点源本文件之后）。
+function Get-DshHomeDir {
+    if ($env:DSH_HOME) { return $env:DSH_HOME }
+    return (Join-Path $env:USERPROFILE '.dsh')
+}
+# 配置/写通道一律用本函数解析（与引擎、与 backup-store.txt 同口径）——写读不同口径会让
+# 非默认数据目录的机器（DSH_HOME=D:\dsh 这类）开关**静默失效**（方案审 R1-07）
+function Get-PluginConfigPath([string]$PluginName = $TRAY_PKG) {
+    return (Join-Path (Join-Path (Get-DshHomeDir) 'plugin-config') "$PluginName.json")
+}
+function Read-PluginConfig([string]$PluginName = $TRAY_PKG) {
+    $f = Get-PluginConfigPath $PluginName
+    if (-not (Test-Path -LiteralPath $f)) { return $null }
+    try {
+        $raw = Get-Content -LiteralPath $f -Raw
+        # ⚠ 顶层**数组**必须在这里挡住：`return (ConvertFrom-Json '[{…}]')` 会被 PowerShell 的
+        #   单元素数组解包成那个对象 ⇒ 下游 `-is [PSCustomObject]` 检查会漏（实现审 R4-P3-10 的形态之一，
+        #   2026-09-23 整改时实测：顶层数组曾误判为 v1 并采信 features.backup）
+        if ($raw.TrimStart().StartsWith('[')) { return $null }
+        return (ConvertFrom-Json -InputObject $raw)
+    } catch { return $null }
+}
+function Write-SwitchLog([string]$Message) {
+    # ⚠ 只建目录、**不做遗留迁移**（实现审 R5-N9：旧写法调 Initialize-LogDir 会把"启动清扫/日志迁移"
+    #   提前到点源期 —— 点源一个库就可能顺带搬动真机 logs 根的文件；迁移留给托盘/动作的显式启动点）
+    try { New-Item -ItemType Directory -Force -Path $LOG_DIR | Out-Null } catch { }
+    try { Write-DshLog -Path (Join-Path $LOG_DIR 'dsh-tray.log') -Message $Message } catch { }
+}
+# 单总开关 features.backup（默认关）。优先级：env（临时覆盖、不落盘）> 配置文件 > 默认
+$script:BackupEnabled = $false
+$script:BackupSwitchSource = 'default'
+$switchRaw = ([string]$env:DSH_TRAY_BACKUP).Trim()   # Trim：Windows `set VAR=1 ` 尾随空格是常见形态（R4-P3-11）
+if ($switchRaw -match '^(?i)(1|true|on)$') { $script:BackupEnabled = $true; $script:BackupSwitchSource = 'env' }
+elseif ($switchRaw -match '^(?i)(0|false|off)$') { $script:BackupEnabled = $false; $script:BackupSwitchSource = 'env' }
+else {
+    $cfgObj = Read-PluginConfig
+    if ($cfgObj -and ($cfgObj -is [System.Management.Automation.PSCustomObject])) {
+        # version：**只接受整数类型**（`[int]`/`[long]`）；**数字形字符串（"1"）也算未知 schema ⇒ 关**
+        #   （实现审 R5-N2：旧实现接受 `^\d+$` 字符串 ⇒ 与"version 存在但非整数 ⇒ 关"的口径自相矛盾，
+        #   且未来 schema 用字符串写版本号时会被误当 v1 采信）；无 version 键则按骨架允许（视作 v1）
+        $hasVer = ($null -ne $cfgObj.PSObject.Properties['version'])
+        $cfgVer = 0; $verOk = -not $hasVer; $verUnknown = $false
+        if ($hasVer) {
+            $vRaw = $cfgObj.version
+            if ($vRaw -is [int] -or $vRaw -is [long]) { $cfgVer = [int]$vRaw; $verOk = $true }
+            if (-not $verOk) { $verUnknown = $true; Write-SwitchLog "plugin-config: version='$vRaw' 不是整数 ⇒ 视为未知 schema ⇒ 按默认关闭" }
+        }
+        if ($verUnknown) { }
+        elseif ($cfgVer -gt 1) { Write-SwitchLog "plugin-config: version=$cfgVer 高于已知(1) ⇒ 按默认关闭（前向兼容，不猜新语义）" }
+        elseif ($cfgObj.features -and ($cfgObj.features.backup -is [bool])) {
+            $script:BackupEnabled = [bool]$cfgObj.features.backup
+            $script:BackupSwitchSource = 'config'
+        } else { Write-SwitchLog 'plugin-config: 未含 features.backup(bool) ⇒ 按默认关闭' }
+    } elseif ($cfgObj) {
+        Write-SwitchLog 'plugin-config: 根节点不是对象 ⇒ 按默认关闭'
+    } elseif (Test-Path -LiteralPath (Get-PluginConfigPath)) {
+        Write-SwitchLog 'plugin-config: 解析失败 ⇒ 按默认关闭'
+    }
+}
+# 库解析**随开关**：OFF ⇒ 不解析（对他人机器零盘符扫描；实现审 R4 插桩实测：OFF 三态调用数=0、ON 态=1）
+$BACKUP_STORE      = if ($script:BackupEnabled) { Resolve-BackupStore } else { $null }
+$BACKUP_WARN_HOURS = 36
+
 function Get-WebPid {
     # 优化(1.0.12): netstat 解析优先 (原 Get-NetTCPConnection 在本机 727 进程下 avg 1.3s,
     # 直接拖慢右键菜单转态路径); 解析失败回退 CIM 查询
+    # 守卫 (2026-09-23 独审 P1-1 纵深防御): 源码态 $PORT=0 未回填时直接空返回,
+    # 不依赖"netstat 恰好匹配不到"这一隐式安全 — 宁可"未在运行"也不猜端口
+    if ($PORT -lt 1) { return @() }
     try {
         $pids = @()
         foreach ($row in (& netstat -ano -p tcp 2>$null)) {
@@ -91,11 +296,17 @@ function Start-Dsh {
     param([switch]$OpenBrowser = $true)
     $trayStarted = -not (Ensure-DshTray)   # 先保证系统托盘在(幂等)
     $pids = @(Get-WebPid)
-    if ($pids.Count -gt 0) {
-        Write-Host "[dsh] 已在运行: $URL (PID $($pids -join ','))" -ForegroundColor Green
+    $dshPids = @($pids | Where-Object { Test-WebIdentity $_ })
+    if ($dshPids.Count -gt 0) {
+        Write-Host "[dsh] 已在运行: $URL (PID $($dshPids -join ','))" -ForegroundColor Green
         if ($trayStarted) { Write-Host '[tray] 系统托盘已自动启动（右键可控制 DSH）' -ForegroundColor DarkGray }
         if ($OpenBrowser) { Open-DshWeb }
-        return
+        return $true
+    }
+    if ($pids.Count -gt 0) {
+        # 端口被非 dsh 进程占用（R2-P2#1 对侧补齐）：不谎报"已在运行"，明说并失败
+        Write-Host "[dsh] 端口 $PORT 被非 dsh 进程占用 (PID $($pids -join ',')), 无法启动 dsh" -ForegroundColor Yellow
+        return $false
     }
     Write-Host "[dsh] 启动中 (端口 $PORT)..."
     $out = Join-Path $LOG_DIR 'web-menu.out.log'
@@ -112,16 +323,33 @@ function Start-Dsh {
         if ($trayStarted) { Write-Host '[tray] 系统托盘已自动启动（右键可控制 DSH）' -ForegroundColor DarkGray }
         Start-Sleep -Seconds 2
         if ($OpenBrowser) { Open-DshWeb }
+        return $true
     } else {
         Write-Host "[dsh] 启动失败: 12 秒内端口 $PORT 未监听" -ForegroundColor Red
         Write-Host "[dsh] 错误日志: $err（末尾 10 行）"
         Get-Content $err -Tail 10 -ErrorAction SilentlyContinue
+        return $false
     }
 }
 
+function Test-WebIdentity([int]$ProcessId) {
+    # 身份核对（2026-09-23 独审 P2-5 / R2-P2#1）：监听 $PORT 的 PID 命令行必须含 bin.js（dsh web 入口特征）
+    # 才算 dsh —— 端口被其它服务占用时"不误杀、不谎报"，Stop/Start/Status/boot 共用
+    # ⚠ 参数不能叫 $Pid（与只读自动变量 $PID 大小写不敏感冲突 ⇒ 调用即炸，2026-09-23 实况抓到）
+    $proc = Get-CimInstance Win32_Process -Filter "ProcessId=$ProcessId" -ErrorAction SilentlyContinue
+    return ($null -ne $proc -and $proc.CommandLine -match 'bin\.js')
+}
+
 function Stop-Dsh {
     $pids = @(Get-WebPid)
-    if ($pids.Count -eq 0) { Write-Host '[dsh] 未在运行'; return }
+    if ($pids.Count -eq 0) { Write-Host '[dsh] 未在运行'; return $true }
+    # 身份核对（P2-5）：非 dsh 进程占用端口只报不杀
+    $foreign = @($pids | Where-Object { -not (Test-WebIdentity $_) })
+    if ($foreign.Count -gt 0) {
+        Write-Host "[dsh] 端口 $PORT 被非 dsh 进程占用 (PID $($foreign -join ',')), 不操作" -ForegroundColor Yellow
+        $pids = @($pids | Where-Object { $_ -notin $foreign })
+        if ($pids.Count -eq 0) { return $true }
+    }
     foreach ($p in $pids) {
         Write-Host "[dsh] 停止进程 $p"
         & taskkill /PID $p /T /F 2>$null | Out-Null
@@ -130,21 +358,21 @@ function Stop-Dsh {
         Start-Sleep -Seconds 1
         if (-not (Test-Port $PORT)) { break }
     }
-    if (Test-Port $PORT) { Write-Host '[dsh] 端口未释放，请稍后重试' -ForegroundColor Red }
-    else { Write-Host '[dsh] 已停止' -ForegroundColor Yellow }
+    if (Test-Port $PORT) { Write-Host '[dsh] 端口未释放，请稍后重试' -ForegroundColor Red; return $false }
+    else { Write-Host '[dsh] 已停止' -ForegroundColor Yellow; return $true }
 }
 
 function Restart-Dsh {
     Stop-Dsh
     Start-Sleep -Seconds 1
-    Start-Dsh
+    return (Start-Dsh)
 }
 
 function Start-Tui {
     $existing = @(Get-TuiProcesses)
     if ($existing.Count -gt 0) {
         Write-Host "[tui] TUI 已在运行 (PID $($existing.ProcessId -join ',')), 不重复启动" -ForegroundColor Yellow
-        return
+        return $true
     }
     # 清理上次强杀残留的外壳 (node 已死但 pwsh -NoExit 窗口还在)
     $stale = @(Get-TuiTree)
@@ -165,6 +393,14 @@ function Start-Tui {
         Start-Process 'powershell' -ArgumentList '-NoExit','-Command',$cmdLine
         Write-Host '[tui] 已在新 PowerShell 窗口启动 DSH TUI' -ForegroundColor Green
     }
+    # 验活（2026-09-23 独审 P2-3：外壳开出来但 dsh.cmd 起不来也报"已启动"= 谎报）——
+    # 轮询至多 6s 等 TUI 主进程 node 出现，出现才算成功
+    for ($i = 0; $i -lt 6; $i++) {
+        Start-Sleep -Seconds 1
+        if (@(Get-TuiProcesses).Count -gt 0) { Write-Host '[tui] TUI 主进程已在运行' -ForegroundColor Green; return $true }
+    }
+    Write-Host '[tui] TUI 主进程 6 秒内未出现，可能启动失败（看 TUI 窗口报错）' -ForegroundColor Red
+    return $false
 }
 
 # TUI 进程树: 外壳 pwsh(-NoExit) → cmd(dsh.cmd) → node(bin.js), 三层命令行都含 dsh-tui
@@ -172,9 +408,33 @@ function Start-Tui {
 # 优化(1.0.12): WQL 先按 Name 窄集 (原全量枚举会拉全部进程的 CommandLine);
 # ⚠️ 本机实测任何 Win32_Process 查询固定 ~450-570ms (WinRM 不可用, DCOM/持久会话均无效)——
 # **调用方 (托盘状态刷新) 必须在 ThreadJob 里异步跑, 禁止在 UI/菜单路径同步调用** (见 dsh-tray.ps1)
+# ⚠️ 2026-09-23 误认修复（独审 P2-1 补全）：web 的本地子进程执行器 dsh-subprocess-local/runner.js 命令行携带
+#   **整段工具调用文本**，任何命令提到 dsh-tui 就会被误认成 TUI。排除口径 = **自含 + 祖先链**：
+#   runner 自身命令行恒含该串；其派生的 pwsh/cmd/node 子孙（命令行带 dsh-tui 但不带该串）靠祖先链剔除
+#   （只挡自身会漏子孙 —— 独审复现：子进程视角仍命中 runner 派生的 pwsh）。
+function Test-DshWorkerAncestor {
+    param([int]$Id, $Index)
+    $cur = $Id
+    for ($i = 0; $i -lt 32 -and $cur -gt 0; $i++) {
+        $n = $Index[[int]$cur]
+        if (-not $n) { return $false }   # 父超出快照（进程刚退/系统根）⇒ 无法归因，保守保留
+        if ($n.CommandLine -and $n.CommandLine -match 'dsh-subprocess-local') { return $true }
+        $cur = [int]$n.ParentProcessId
+    }
+    return $false
+}
 function Get-TuiTree {
-    Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe' OR Name='pwsh.exe' OR Name='powershell.exe'" -ErrorAction SilentlyContinue | Where-Object {
-        $_.ProcessId -ne $PID -and $_.CommandLine -and $_.CommandLine -match 'dsh-tui'
+    # 单次窄集快照（锁⑨：禁全量枚举；锁⑫：查询管道带 $PID 自排除）+ 祖先链剔除（P2-1/P3-1：无跨查询竞态）。
+    # 匹配收紧为 `--profile\s+dsh-tui`（R2-P3-3：裸 'dsh-tui' 在工具文本里太常见；真 TUI 三层命令行恒为该形态）。
+    $snap = @(Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe' OR Name='pwsh.exe' OR Name='powershell.exe'" -ErrorAction SilentlyContinue |
+        Where-Object { $_.ProcessId -ne $PID })
+    $byId = @{}
+    foreach ($p in $snap) { $byId[[int]$p.ProcessId] = $p }
+    # 补调用者自身入索引（祖先链走到自己时不断链；按 PID 单查、快、无竞态）
+    $me = Get-CimInstance Win32_Process -Filter "ProcessId=$PID" -ErrorAction SilentlyContinue
+    if ($me) { $byId[[int]$PID] = $me }
+    $snap | Where-Object {
+        $_.CommandLine -and $_.CommandLine -match '--profile\s+dsh-tui' -and -not (Test-DshWorkerAncestor -Id ([int]$_.ProcessId) -Index $byId)
     }
 }
 
@@ -185,12 +445,23 @@ function Get-TuiProcesses {
 
 function Stop-Tui {
     $tree = @(Get-TuiTree)
-    if ($tree.Count -eq 0) { Write-Host '[tui] TUI: 未在运行'; return }
+    if ($tree.Count -eq 0) { Write-Host '[tui] TUI: 未在运行'; return $true }
+    # 诊断（2026-09-23 LJS 疑案：tui-stop 后 web 掉线）：动手前把匹配到的树**全部落动作日志**
+    # （PID/名/父PID/命令行）。Get-TuiTree 是 'dsh-tui' 子串匹配，web 的工具执行器
+    # （dsh-subprocess-local/runner.js，命令行携带整段工具调用文本）可能被误认 ⇒ 日志直接钉死真凶。
+    $actLog = Join-Path $LOG_DIR 'dsh-tray-actions.log'
+    Write-DshLog -Path $actLog -Message "[tui] Stop-Tui 匹配 $($tree.Count) 个进程，动手前快照："
+    foreach ($p in $tree) {
+        $cmd = ($p.CommandLine -replace "`r?`n", ' ').Trim()
+        if ($cmd.Length -gt 400) { $cmd = $cmd.Substring(0, 400) + '…' }
+        Write-DshLog -Path $actLog -Message ("  PID {0} {1} 父 {2} :: {3}" -f $p.ProcessId, $p.Name, $p.ParentProcessId, $cmd)
+    }
     # 从树根整树终止 (根 = 父进程不在树中的进程, 即 pwsh -NoExit 外壳)。
     # 只杀 node 会导致外壳与窗口残留, 终端停在 raw mode 刷乱码且关不掉
     $ids = @($tree | ForEach-Object { $_.ProcessId })
     $roots = @($tree | Where-Object { $ids -notcontains $_.ParentProcessId })
     foreach ($r in $roots) {
+        Write-DshLog -Path $actLog -Message "[tui] 终止进程树 根 PID $($r.ProcessId) $($r.Name)"
         Write-Host "[tui] 停止 TUI 进程树 (根 PID $($r.ProcessId) $($r.Name))"
         & taskkill /PID $r.ProcessId /T /F 2>$null | Out-Null
     }
@@ -198,7 +469,7 @@ function Stop-Tui {
         Start-Sleep -Milliseconds 600
         if (@(Get-TuiTree).Count -eq 0) { break }
     }
-    if (@(Get-TuiTree).Count -gt 0) { Write-Host '[tui] TUI 进程未完全退出，请稍后重试' -ForegroundColor Red }
+    if (@(Get-TuiTree).Count -gt 0) { Write-Host '[tui] TUI 进程未完全退出，请稍后重试' -ForegroundColor Red; return $false }
     else {
         # 收尾: 关闭专为 TUI 开的 Windows Terminal 窗口。
         # 强杀外壳退出码非 0, WT 默认 closeOnExit=graceful 不自动关标签, 会留死面板;
@@ -208,13 +479,16 @@ function Stop-Tui {
         foreach ($w in $wts) {
             $kids = @(Get-CimInstance Win32_Process -ErrorAction SilentlyContinue | Where-Object { $_.ParentProcessId -eq $w.ProcessId })
             if ($kids.Count -eq 0) {
+                Write-DshLog -Path $actLog -Message "[tui] 关闭 TUI 终端窗口 (PID $($w.ProcessId))"
                 Write-Host "[tui] 关闭 TUI 终端窗口 (PID $($w.ProcessId))"
                 & taskkill /PID $w.ProcessId /F 2>$null | Out-Null
             } else {
+                Write-DshLog -Path $actLog -Message "[tui] 终端窗口 (PID $($w.ProcessId)) 还有其他标签页, 保留"
                 Write-Host "[tui] 终端窗口 (PID $($w.ProcessId)) 还有其他标签页, 保留" -ForegroundColor DarkGray
             }
         }
         Write-Host '[tui] TUI 已停止' -ForegroundColor Yellow
+        return $true
     }
 }
 
@@ -353,10 +627,18 @@ function Show-Status {
 # ---- 系统托盘 ----
 
 function Get-TrayProcesses {
-    Get-CimInstance Win32_Process -Filter "Name='pwsh.exe' OR Name='powershell.exe'" -ErrorAction SilentlyContinue | Where-Object {
-        $_.CommandLine -and $_.CommandLine -match 'dsh-tray\.ps1' -and
-        $_.ProcessId -ne $PID
-    }
+    # 与 Get-TuiTree 同构：单次窄集快照（锁⑨/⑫）+ 祖先链剔除 runner 子孙（R2-P2#3：
+    # 'dsh-tray.ps1' 子串同会被 web 工具执行器子孙误命中 ⇒ 漏启托盘/谎报运行中）
+    $snap = @(Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe' OR Name='pwsh.exe' OR Name='powershell.exe'" -ErrorAction SilentlyContinue |
+        Where-Object { $_.ProcessId -ne $PID })
+    $byId = @{}
+    foreach ($p in $snap) { $byId[[int]$p.ProcessId] = $p }
+    $me = Get-CimInstance Win32_Process -Filter "ProcessId=$PID" -ErrorAction SilentlyContinue
+    if ($me) { $byId[[int]$PID] = $me }
+    @($snap | Where-Object {
+        $_.Name -in @('pwsh.exe', 'powershell.exe') -and $_.CommandLine -and $_.CommandLine -match 'dsh-tray\.ps1' -and
+        -not (Test-DshWorkerAncestor -Id ([int]$_.ProcessId) -Index $byId)
+    })
 }
 
 # 确保托盘在运行(幂等): 已在运行返回 $true; 刚拉起返回 $false
@@ -364,10 +646,13 @@ function Ensure-DshTray {
     $existing = @(Get-TrayProcesses)
     if ($existing.Count -gt 0) { return $true }
     $args = @('-NoProfile','-ExecutionPolicy','Bypass','-WindowStyle','Hidden','-File',$TRAY_SCRIPT)
-    if (Test-Path $PWSH) {
-        Start-Process -FilePath $PWSH -ArgumentList $args -WindowStyle Hidden | Out-Null
-    } else {
-        Start-Process -FilePath 'powershell.exe' -ArgumentList $args -WindowStyle Hidden | Out-Null
+    try {
+        # R2-P3-5：托盘只是可选件，$PWSH 失效（升级/换路径）不该阻断 web 启动 —— 起不来降级为 $false 并留痕
+        if (Test-Path $PWSH) { Start-Process -FilePath $PWSH -ArgumentList $args -WindowStyle Hidden | Out-Null }
+        else { Start-Process -FilePath 'powershell.exe' -ArgumentList $args -WindowStyle Hidden | Out-Null }
+    } catch {
+        Write-Host "[tray] 托盘启动失败（不影响 dsh）: $($_.Exception.Message)" -ForegroundColor DarkGray
+        return $false
     }
     return $false
 }

package/launcher/dsh-menu.ps1

@@ -1,4 +1,4 @@
-# dsh (DeepSeek Harness) 启动器 —— 公司机部署 2026-08-14
+# dsh (DeepSeek Harness) 启动器 —— 公司机部署 2026-08-14
 # 用法:
 #   交互菜单: 双击 dsh-menu.bat
 #   非交互:   dsh-menu.ps1 -Cmd start|stop|status
@@ -9,9 +9,12 @@ param(
 )
 $ErrorActionPreference = 'Stop'
 
-$DSH_CMD = 'D:\Program Files (x86)\dsh\dsh.cmd'
-$PORT    = 3080
-$URL     = 'http://127.0.0.1:3080'
+# 路径/端口不写死（release-standards §7；2026-09-22 去 `D:\Program Files (x86)\...` + 3080 字面量）：
+# 点源同目录 dsh-lib.ps1，用 install.ps1 [6/7] 回填的 $DSH_CMD / $PORT（源码侧 = SET-BY-INSTALL-PS1 占位）。
+$lib = Join-Path $PSScriptRoot 'dsh-lib.ps1'
+if (-not (Test-Path -LiteralPath $lib)) { throw "dsh-lib.ps1 not found next to dsh-menu.ps1: $lib" }
+. $lib
+$URL = "http://127.0.0.1:$PORT"
 
 function Test-Port([int]$port) {
     $client = New-Object System.Net.Sockets.TcpClient