dsh-windows-tray 1.0.2 → 1.0.4

package/launcher/dsh-tray.ps1

@@ -1,419 +1,430 @@
-# dsh-tray.ps1 —— DSH 系统托盘 (状态图标 + 右键菜单)
-# 启动方式:
-#   1. 双击 dsh-tray.bat
-#   2. 由 dsh-control.ps1 启动/重启 Web 时自动拉起
-#   3. 手动: pwsh -NoProfile -WindowStyle Hidden -File dsh-tray.ps1
-# 功能:
-#   - 图标 = 状态: 品牌蓝鲸鱼 = Web 运行中; 灰鲸鱼 = 未运行 (官方 favicon 渲染)
-#   - 悬停提示: 当前状态与 PID
-#   - 双击: 打开 Web UI
-#   - 右键菜单: 顶部 DSH/TUI 双状态行 + DSH/TUI 子菜单 + 日志目录/版本信息/退出托盘
-#   - 状态变化气泡通知; 状态/动作日志: ~/.dsh/logs/dsh-tray.log
-#   - TUI 状态独立检测: 菜单项按 TUI 是否运行自动禁用/启用
-#   - 浅色圆角菜单(借鉴社区 dsh-tray 方案) + npm 自更新(借鉴 dsh-tray-launcher 方案)
-param(
-    [int]$Port = 3088,
-    [switch]$NoBalloon
-)
-$ErrorActionPreference = 'Stop'
-
-# ---- 单实例保护: 命名互斥锁 (被强杀遗留的锁自动接管, 无竞态) ----
-$mutex = New-Object System.Threading.Mutex($false, 'dsh-tray-singleton')
-$gotMutex = $false
-try { $gotMutex = $mutex.WaitOne(0) } catch { $gotMutex = $true }   # AbandonedMutexException -> 接管
-if (-not $gotMutex) { exit 0 }
-
-. (Join-Path $PSScriptRoot 'dsh-lib.ps1')
-$PORT = $Port
-$URL  = "http://127.0.0.1:$PORT"
-
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-
-$logFile = Join-Path $LOG_DIR 'dsh-tray.log'
-function Log([string]$msg) {
-    $line = ('[{0}] {1}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $msg)
-    Add-Content -Path $logFile -Value $line -ErrorAction SilentlyContinue
-}
-
-# ---- 图标: 官方鲸鱼 .ico; 缺失时回退为纯色圆点 ----
-$iconsDir = Join-Path $PSScriptRoot 'icons'
-$icoRun  = Join-Path $iconsDir 'dsh-tray-running.ico'
-$icoStop = Join-Path $iconsDir 'dsh-tray-stopped.ico'
-
-function New-FallbackIcon([System.Drawing.Color]$color) {
-    $bmp = New-Object System.Drawing.Bitmap 16, 16, ([System.Drawing.Imaging.PixelFormat]::Format32bppArgb)
-    $g = [System.Drawing.Graphics]::FromImage($bmp)
-    $g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
-    $brush = New-Object System.Drawing.SolidBrush($color)
-    $g.FillEllipse($brush, 2, 2, 12, 12)
-    $g.Dispose(); $brush.Dispose()
-    $icon = [System.Drawing.Icon]::FromHandle($bmp.GetHicon())
-    $bmp.Dispose()
-    return $icon
-}
-
-$iconRun  = if (Test-Path $icoRun)  { New-Object System.Drawing.Icon($icoRun) }  else { New-FallbackIcon ([System.Drawing.Color]::FromArgb(0x41, 0x76, 0xE6)) }
-$iconStop = if (Test-Path $icoStop) { New-Object System.Drawing.Icon($icoStop) } else { New-FallbackIcon ([System.Drawing.Color]::FromArgb(0x81, 0x85, 0x8C)) }
-
-# ---- 版本烙印 (npm 包安装时优先读 package.json) ----
-$script:TrayVersion = $TRAY_VERSION
-try {
-    $pk = Join-Path $PSScriptRoot 'package.json'
-    if (Test-Path $pk) { $pv = (Get-Content $pk -Raw | ConvertFrom-Json).version; if ($pv) { $script:TrayVersion = $pv } }
-} catch { }
-
-# ---- 圆角浅色菜单 (白底 + 浅蓝 hover + 圆角窗口 + 投影阴影, 借鉴社区 dsh-tray) ----
-$winFormsAsm = [System.Windows.Forms.Application].Assembly.Location
-$drawingAsm  = [System.Drawing.Bitmap].Assembly.Location
-$drawingPrimAsm = [System.Drawing.Rectangle].Assembly.Location   # .NET 5+ 中 Rectangle 等转发到 System.Drawing.Primitives
-Add-Type -TypeDefinition @'
-using System;
-using System.Drawing;
-using System.Drawing.Drawing2D;
-using System.Runtime.InteropServices;
-using System.Windows.Forms;
-
-public static class MenuRounded {
-    [DllImport("user32.dll")] public static extern int SetWindowRgn(IntPtr hWnd, IntPtr hRgn, bool bRedraw);
-    [DllImport("gdi32.dll")] public static extern IntPtr CreateRoundRectRgn(int x1, int y1, int x2, int y2, int w, int h);
-    [DllImport("user32.dll")] public static extern int GetClassLong(IntPtr hWnd, int nIndex);
-    [DllImport("user32.dll")] public static extern int SetClassLong(IntPtr hWnd, int nIndex, int dwNewLong);
-    [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
-    [DllImport("user32.dll")] public static extern bool MoveWindow(IntPtr hWnd, int X, int Y, int nWidth, int nHeight, bool bRepaint);
-    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
-    [StructLayout(LayoutKind.Sequential)] public struct RECT { public int Left, Top, Right, Bottom; }
-}
-
-public class SoftColors : ProfessionalColorTable {
-    public override Color ToolStripDropDownBackground { get { return Color.White; } }
-    public override Color ImageMarginGradientBegin { get { return Color.White; } }
-    public override Color ImageMarginGradientMiddle { get { return Color.White; } }
-    public override Color ImageMarginGradientEnd { get { return Color.White; } }
-    public override Color MenuBorder { get { return Color.FromArgb(228, 232, 242); } }
-    public override Color MenuItemSelected { get { return Color.Transparent; } }
-    public override Color MenuItemBorder { get { return Color.Transparent; } }
-    public override Color SeparatorDark { get { return Color.Transparent; } }
-    public override Color SeparatorLight { get { return Color.Transparent; } }
-}
-
-public class SoftMenuRenderer : ToolStripProfessionalRenderer {
-    public SoftMenuRenderer() : base(new SoftColors()) { }
-    private static GraphicsPath Rounded(Rectangle r, int radius) {
-        GraphicsPath p = new GraphicsPath();
-        int d = radius * 2;
-        p.AddArc(r.X, r.Y, d, d, 180, 90);
-        p.AddArc(r.Right - d, r.Y, d, d, 270, 90);
-        p.AddArc(r.Right - d, r.Bottom - d, d, d, 0, 90);
-        p.AddArc(r.X, r.Bottom - d, d, d, 90, 90);
-        p.CloseFigure();
-        return p;
-    }
-    protected override void OnRenderMenuItemBackground(ToolStripItemRenderEventArgs e) {
-        if (e.Item.Selected || e.Item.Pressed) {
-            Rectangle r = new Rectangle(5, 3, e.Item.Width - 10, e.Item.Height - 6);
-            using (GraphicsPath p = Rounded(r, 8))
-            using (SolidBrush b = new SolidBrush(Color.FromArgb(238, 243, 255)))
-                e.Graphics.FillPath(b, p);
-        }
-    }
-    protected override void OnRenderSeparator(ToolStripSeparatorRenderEventArgs e) {
-        using (SolidBrush b = new SolidBrush(Color.FromArgb(240, 242, 247)))
-            e.Graphics.FillRectangle(b, 16, 4, e.Item.Width - 32, 1);
-    }
-    protected override void OnRenderToolStripBorder(ToolStripRenderEventArgs e) {
-        using (Pen p = new Pen(Color.FromArgb(226, 230, 240)))
-            e.Graphics.DrawRectangle(p, 1, 1, e.AffectedBounds.Width - 3, e.AffectedBounds.Height - 3);
-    }
-}
-'@ -ReferencedAssemblies @($winFormsAsm, $drawingAsm, $drawingPrimAsm)
-
-# ---- 右键菜单 (浅色圆角) ----
-$menu = New-Object System.Windows.Forms.ContextMenuStrip
-$menu.ShowImageMargin = $false
-$menu.Renderer = New-Object SoftMenuRenderer
-$menu.Font = New-Object System.Drawing.Font('Segoe UI', 8.25)
-
-# 圆角窗口 + 投影阴影 (主菜单与子菜单通用); 子菜单额外对齐父项
-# 背景: WinForms 中带箭头的子菜单父项会被拉伸到菜单宽度后再加箭头预留,
-#       导致父项宽度超过菜单窗口, 子菜单锚在父项右缘 -> 与菜单之间出现空隙
-function Round-Menu($m) {
-    try {
-        $h = $m.Handle
-        $style = [MenuRounded]::GetClassLong($h, -26)
-        [void][MenuRounded]::SetClassLong($h, -26, $style -bor 0x20000)   # CS_DROPSHADOW 投影
-        $r = [MenuRounded]::CreateRoundRectRgn(0, 0, $m.Width, $m.Height, 18, 18)
-        [void][MenuRounded]::SetWindowRgn($h, $r, $true)
-        $pi = $m.OwnerItem
-        if ($pi -and $pi.Owner) {
-            # 子菜单: 左缘对齐父菜单窗口右缘 (-3px 标准重叠), 垂直对齐父项顶部 (-3px)
-            $pt = $pi.Owner.PointToScreen($pi.Bounds.Location)
-            $ow = New-Object MenuRounded+RECT
-            [void][MenuRounded]::GetWindowRect($pi.Owner.Handle, [ref]$ow)
-            [void][MenuRounded]::MoveWindow($h, $ow.Right - 3, $pt.Y - 3, $m.Width, $m.Height, $true)
-        }
-        [void][MenuRounded]::SetForegroundWindow($h)
-    } catch { }
-}
-$menu.add_Opened({ Round-Menu $this })   # $this = 事件发送者 (避免闭包捕获函数局部变量的坑)
-$menu.add_Opening({ Update-State -ForceTui })   # 打开菜单时强制刷新 (含 TUI 状态)
-
-function New-MenuItem([string]$text, [scriptblock]$action) {
-    $it = New-Object System.Windows.Forms.ToolStripMenuItem($text)
-    $it.ForeColor = [System.Drawing.Color]::FromArgb(32, 36, 43)
-    $it.Padding = New-Object System.Windows.Forms.Padding(10, 4, 14, 4)
-    if ($action) { $it.Add_Click($action) }
-    return $it
-}
-
-function New-SubMenu([string]$text) {
-    $it = New-Object System.Windows.Forms.ToolStripMenuItem($text)
-    $it.ForeColor = [System.Drawing.Color]::FromArgb(32, 36, 43)
-    $it.Padding = New-Object System.Windows.Forms.Padding(10, 4, 14, 4)
-    $it.DropDown.Renderer = New-Object SoftMenuRenderer
-    $it.DropDown.add_Opened({ Round-Menu $this })   # $this = 子菜单 DropDown (闭包捕获 $it 会得 $null, 勿用)
-    return $it
-}
-
-# ---- 顶部双状态 ----
-$itemDshStatus  = New-MenuItem 'Web UI 状态: 检测中…' $null; $itemDshStatus.Enabled = $false
-$itemTuiStatus  = New-MenuItem 'TUI 状态: 检测中…' $null; $itemTuiStatus.Enabled = $false
-$menu.Items.Add($itemDshStatus) | Out-Null
-$menu.Items.Add($itemTuiStatus) | Out-Null
-$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
-
-# ---- Web UI 子菜单 ----
-$itemDsh = New-SubMenu 'Web UI'
-$itemOpen    = New-MenuItem '打开 Web UI'  { try { Start-Process $URL } catch { Log "打开 Web 失败: $($_.Exception.Message)" } }
-$itemStart   = New-MenuItem '启动 Web UI'  { Invoke-DshAction 'start' }
-$itemStop    = New-MenuItem '停止 Web UI'  {
-    $r = [System.Windows.Forms.MessageBox]::Show('确定停止 Web UI 服务？Web 界面与当前会话将关闭。', 'DSH 系统托盘', 'YesNo', 'Question', 'DefaultButton2')
-    if ($r -eq [System.Windows.Forms.DialogResult]::Yes) { Invoke-DshAction 'stop' }
-}
-$itemRestart = New-MenuItem '重启 Web UI'  { Invoke-DshAction 'restart' }
-$itemDsh.DropDownItems.AddRange(@($itemOpen, $itemStart, $itemStop, $itemRestart))
-$menu.Items.Add($itemDsh) | Out-Null
-
-# ---- TUI 子菜单 ----
-$itemTui = New-SubMenu 'TUI'
-$itemTuiStart = New-MenuItem '启动 TUI'    { Invoke-DshAction 'tui-start' }
-$itemTuiStop  = New-MenuItem '停止 TUI'    { Invoke-DshAction 'tui-stop' }
-$itemTui.DropDownItems.AddRange(@($itemTuiStart, $itemTuiStop))
-$menu.Items.Add($itemTui) | Out-Null
-
-$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
-$itemLogs    = New-MenuItem '打开日志目录' { try { Start-Process $LOG_DIR } catch { Log "打开日志目录失败: $($_.Exception.Message)" } }
-$menu.Items.Add($itemLogs) | Out-Null
-
-# ---- 版本信息 (非日常功能, 放在退出前; npm 安装版支持一键更新) ----
-$itemUpdate = New-SubMenu '版本信息'
-$itemUpdateStatus = New-MenuItem ("版本: v$($script:TrayVersion)") $null; $itemUpdateStatus.Enabled = $false
-$itemUpdateCheck  = New-MenuItem '检查更新' { Update-Check }
-$itemUpdateDo     = New-MenuItem '更新到最新版' { Update-Do }; $itemUpdateDo.Enabled = $false
-$itemUpdate.DropDownItems.AddRange(@($itemUpdateStatus, $itemUpdateCheck, $itemUpdateDo))
-$menu.Items.Add($itemUpdate) | Out-Null
-$itemExit    = New-MenuItem '退出托盘'     {
-    Log '退出托盘'
-    $notify.Visible = $false
-    $timer.Stop()
-    $notify.Dispose()
-    $appContext.ExitThread()
-}
-$menu.Items.Add($itemExit) | Out-Null
-
-# ---- 动作在独立进程执行, 不阻塞托盘 UI ----
-function Invoke-DshAction([string]$action) {
-    $scriptPath = Join-Path $PSScriptRoot 'dsh-actions.ps1'
-    $args = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $scriptPath, '-Action', $action)
-    try {
-        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 }
-        Log "已触发动作: $action"
-    } catch { Log "触发动作 $action 失败: $($_.Exception.Message)" }
-}
-
-# ---- 自更新: 版本对比 / npm 定位 / 检查 / 执行 ----
-function Compare-Version($a, $b) {
-    $pa = @(); $pb = @()
-    foreach ($x in ($a -split '\.')) { try { $pa += [int]$x } catch { $pa += 0 } }
-    foreach ($x in ($b -split '\.')) { try { $pb += [int]$x } catch { $pb += 0 } }
-    for ($i = 0; $i -lt 3; $i++) {
-        $va = if ($i -lt $pa.Count) { $pa[$i] } else { 0 }
-        $vb = if ($i -lt $pb.Count) { $pb[$i] } else { 0 }
-        if ($va -gt $vb) { return 1 }
-        if ($va -lt $vb) { return -1 }
-    }
-    return 0
-}
-
-function Find-NpmCmd {
-    if ($NODE -and (Test-Path $NODE)) {
-        $p = Join-Path (Split-Path $NODE -Parent) 'npm.cmd'
-        if (Test-Path $p) { return $p }
-    }
-    $c = Get-Command npm.cmd -ErrorAction SilentlyContinue
-    if ($c) { return $c.Source }
-    $c2 = Get-Command npm -ErrorAction SilentlyContinue
-    if ($c2) { return $c2.Source }
-    return $null
-}
-
-function Get-LatestTrayVersion {
-    $npm = Find-NpmCmd
-    if (-not $npm) { Log '自更新: npm 未找到'; return '' }
-    $tmp = Join-Path $LOG_DIR 'tray-npm-view.txt'
-    Remove-Item $tmp -Force -ErrorAction SilentlyContinue
-    $cmdLine = '/c ""' + $npm + '" view ' + $TRAY_PKG + ' version > "' + $tmp + '" 2>nul "'
-    $psi = New-Object System.Diagnostics.ProcessStartInfo
-    $psi.FileName = $env:ComSpec
-    $psi.Arguments = $cmdLine
-    $psi.UseShellExecute = $false
-    $psi.CreateNoWindow = $true
-    try {
-        $p = [System.Diagnostics.Process]::Start($psi)
-        $p.WaitForExit(20000) | Out-Null
-        if (-not $p.HasExited) { $p.Kill() }
-    } catch { Log "npm view 执行失败: $($_.Exception.Message)"; return '' }
-    try {
-        if (Test-Path $tmp) {
-            $v = (Get-Content $tmp -Raw).Trim()
-            Remove-Item $tmp -Force -ErrorAction SilentlyContinue
-            if ($v -match '^[0-9]+\.[0-9]+\.[0-9]+') { return $Matches[0] }
-        }
-    } catch { }
-    return ''
-}
-
-function Update-Check {
-    $itemUpdateStatus.Text = '检查中…'
-    $latest = Get-LatestTrayVersion
-    if (-not $latest) {
-        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 检查失败(网络/npm)"
-        Show-Balloon 'DSH' '检查更新失败（网络或 npm 不可用），详见日志'
-        return
-    }
-    if ((Compare-Version $latest $script:TrayVersion) -gt 0) {
-        $script:latestVersion = $latest
-        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 最新 v$latest"
-        $itemUpdateDo.Text = "更新到 v$latest"
-        $itemUpdateDo.Enabled = $true
-        Show-Balloon 'DSH' "托盘有新版本 v$latest，可一键更新"
-    } else {
-        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 已是最新"
-        $itemUpdateDo.Enabled = $false
-        Show-Balloon 'DSH' "已是最新版 v$($script:TrayVersion)"
-    }
-}
-
-function Update-Do {
-    $updater = Join-Path $PSScriptRoot 'dsh-update.ps1'
-    if (-not (Test-Path $updater)) { Show-Balloon 'DSH' '缺少 dsh-update.ps1，无法更新'; return }
-    $args = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $updater, '-OldPid', "$PID")
-    try {
-        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 }
-        Log '已触发自更新'
-        $itemUpdateStatus.Text = '更新中…'
-        Show-Balloon 'DSH' '正在更新… 完成后托盘会自动重启（约 1 分钟）'
-    } catch { Log "触发自更新失败: $($_.Exception.Message)" }
-}
-
-# ---- 托盘本体 ----
-$notify = New-Object System.Windows.Forms.NotifyIcon
-$notify.Icon = $iconStop
-$notify.Text = "DSH 托盘 · 检测中 (端口 $PORT)"
-$notify.ContextMenuStrip = $menu
-$notify.Visible = $true
-$notify.add_DoubleClick({
-    if (Test-Port $PORT) { Start-Process $URL } else { Show-Balloon 'DSH' 'Web UI 未运行，右键选择「启动 Web UI」' }
-})
-
-function Show-Balloon([string]$title, [string]$text) {
-    if ($NoBalloon) { return }
-    try {
-        $notify.BalloonTipTitle = $title
-        $notify.BalloonTipText = $text
-        $notify.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::Info
-        $notify.ShowBalloonTip(4000)
-    } catch { }
-}
-
-# ---- 状态轮询 ----
-$script:prevState = $null   # $null=初始; $true=运行; $false=停止
-$script:prevTui = $null     # TUI 状态 ($null=初始; $true=运行; $false=停止)
-$script:firstRun = $true    # 首次刷新只设图标, 不弹变化通知
-$script:lastTuiCheck = 0    # TUI 检测节流 (常规 20s 一次, 打开菜单时强制)
-
-function Update-State {
-    param([switch]$ForceTui)
-    try {
-        # TUI 状态独立检测 (不随 Web 状态提前返回); WMI 查询节流, 减少周期开销
-        if ($ForceTui -or ([Environment]::TickCount - $script:lastTuiCheck) -gt 20000) {
-            $script:lastTuiCheck = [Environment]::TickCount
-            $tuiProcs = @(Get-TuiProcesses)
-            $tuiRunning = $tuiProcs.Count -gt 0
-            if ($tuiRunning) {
-                $itemTuiStatus.Text = "TUI 状态: 运行中 (PID $(($tuiProcs.ProcessId) -join ','))"
-            } else {
-                $itemTuiStatus.Text = 'TUI 状态: 未运行'
-            }
-            if ($tuiRunning -ne $script:prevTui) {
-                $script:prevTui = $tuiRunning
-                $itemTuiStart.Enabled = -not $tuiRunning
-                $itemTuiStop.Enabled = $tuiRunning
-                if ($tuiRunning) {
-                    Log "TUI: 运行中 (PID $(($tuiProcs.ProcessId) -join ','))"
-                } else {
-                    Log 'TUI: 未运行'
-                }
-            }
-        }
-        $running = Test-Port $PORT
-        if ($running -eq $script:prevState -and -not $script:firstRun) { return }   # 无变化
-        $script:prevState = $running
-        if ($running) {
-            $pids = @(Get-WebPid)
-            $notify.Icon = $iconRun
-            $notify.Text = "Web UI 运行中 · 127.0.0.1:$PORT"
-            $itemDshStatus.Text = "Web UI 状态: 运行中 (PID $($pids -join ','))"
-            $itemOpen.Enabled = $true
-            $itemStart.Enabled = $false
-            $itemStop.Enabled = $true
-            $itemRestart.Enabled = $true
-            Log "状态: 运行中 (PID $($pids -join ','))"
-            if (-not $script:firstRun) { Show-Balloon 'DSH' "Web UI 已启动 ($URL)" }
-        } else {
-            $notify.Icon = $iconStop
-            $notify.Text = 'Web UI 未运行 · 右键可启动'
-            $itemDshStatus.Text = 'Web UI 状态: 未运行'
-            $itemOpen.Enabled = $false
-            $itemStart.Enabled = $true
-            $itemStop.Enabled = $false
-            $itemRestart.Enabled = $false
-            Log '状态: 未运行'
-            if (-not $script:firstRun) { Show-Balloon 'DSH' 'Web UI 已停止' }
-        }
-        $script:firstRun = $false
-    } catch { Log "轮询异常: $($_.Exception.Message)" }
-}
-
-$timer = New-Object System.Windows.Forms.Timer
-$timer.Interval = 2000
-$timer.add_Tick({ Update-State })
-$timer.Start()
-
-# 启动即刷新一次状态(不弹变化通知), 并提示就绪
-Update-State
-if (-not $NoBalloon) { Show-Balloon 'DSH' "托盘已就绪 · 双击打开 Web · 右键控制 (端口 $PORT) · 若图标在 ^ 溢出区, 请拖到任务栏" }
-Log "托盘启动 (v$($script:TrayVersion), PID $PID, 端口 $PORT)"
-
-$appContext = New-Object System.Windows.Forms.ApplicationContext
-[System.Windows.Forms.Application]::Run($appContext)
-
-# 退出清理
-$timer.Dispose()
-$menu.Dispose()
-$iconRun.Dispose(); $iconStop.Dispose()
-try { $mutex.ReleaseMutex() } catch { }
-Log '托盘已退出'
+# dsh-tray.ps1 —— DSH 系统托盘 (状态图标 + 右键菜单)
+# 启动方式:
+#   1. 双击 dsh-tray.bat
+#   2. 由 dsh-control.ps1 启动/重启 Web 时自动拉起
+#   3. 手动: pwsh -NoProfile -WindowStyle Hidden -File dsh-tray.ps1
+# 功能:
+#   - 图标 = 状态: 品牌蓝鲸鱼 = Web 运行中; 灰鲸鱼 = 未运行 (官方 favicon 渲染)
+#   - 悬停提示: 当前状态与 PID
+#   - 双击: 打开 Web UI
+#   - 右键菜单: 顶部 DSH/TUI 双状态行 + DSH/TUI 子菜单 + 日志目录/版本信息/退出托盘
+#   - 状态变化气泡通知; 状态/动作日志: ~/.dsh/logs/dsh-tray.log
+#   - TUI 状态独立检测: 菜单项按 TUI 是否运行自动禁用/启用
+#   - 浅色圆角菜单(借鉴社区 dsh-tray 方案) + npm 自更新(借鉴 dsh-tray-launcher 方案)
+param(
+    [int]$Port = 3088,
+    [switch]$NoBalloon
+)
+$ErrorActionPreference = 'Stop'
+
+# ---- 单实例保护: 命名互斥锁 (被强杀遗留的锁自动接管, 无竞态) ----
+$mutex = New-Object System.Threading.Mutex($false, 'dsh-tray-singleton')
+$gotMutex = $false
+try { $gotMutex = $mutex.WaitOne(0) } catch { $gotMutex = $true }   # AbandonedMutexException -> 接管
+if (-not $gotMutex) { exit 0 }
+
+. (Join-Path $PSScriptRoot 'dsh-lib.ps1')
+$PORT = $Port
+$URL  = "http://127.0.0.1:$PORT"
+
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+# ---- 通知身份 (v1.0.3): 注册本进程 AUMID, 气泡通知归属「DSH 系统托盘」快捷方式而非 PowerShell ----
+# Win11 升级会重置应用通知授权; 配合 install.ps1 写入的带 AUMID 开始菜单快捷方式生效。
+# 必须在创建任何窗口/NotifyIcon 之前调用。
+if (-not ('DSH.NativeShell' -as [type])) {
+    Add-Type -Namespace DSH -Name NativeShell -MemberDefinition @'
+[DllImport("shell32.dll")]
+public static extern int SetCurrentProcessExplicitAppUserModelID([MarshalAs(UnmanagedType.LPWStr)] string AppID);
+'@
+}
+[void][DSH.NativeShell]::SetCurrentProcessExplicitAppUserModelID('DSH.WindowsTray')
+
+$logFile = Join-Path $LOG_DIR 'dsh-tray.log'
+function Log([string]$msg) {
+    $line = ('[{0}] {1}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $msg)
+    Add-Content -Path $logFile -Value $line -ErrorAction SilentlyContinue
+}
+
+# ---- 图标: 官方鲸鱼 .ico; 缺失时回退为纯色圆点 ----
+$iconsDir = Join-Path $PSScriptRoot 'icons'
+$icoRun  = Join-Path $iconsDir 'dsh-tray-running.ico'
+$icoStop = Join-Path $iconsDir 'dsh-tray-stopped.ico'
+
+function New-FallbackIcon([System.Drawing.Color]$color) {
+    $bmp = New-Object System.Drawing.Bitmap 16, 16, ([System.Drawing.Imaging.PixelFormat]::Format32bppArgb)
+    $g = [System.Drawing.Graphics]::FromImage($bmp)
+    $g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
+    $brush = New-Object System.Drawing.SolidBrush($color)
+    $g.FillEllipse($brush, 2, 2, 12, 12)
+    $g.Dispose(); $brush.Dispose()
+    $icon = [System.Drawing.Icon]::FromHandle($bmp.GetHicon())
+    $bmp.Dispose()
+    return $icon
+}
+
+$iconRun  = if (Test-Path $icoRun)  { New-Object System.Drawing.Icon($icoRun) }  else { New-FallbackIcon ([System.Drawing.Color]::FromArgb(0x41, 0x76, 0xE6)) }
+$iconStop = if (Test-Path $icoStop) { New-Object System.Drawing.Icon($icoStop) } else { New-FallbackIcon ([System.Drawing.Color]::FromArgb(0x81, 0x85, 0x8C)) }
+
+# ---- 版本烙印 (npm 包安装时优先读 package.json) ----
+$script:TrayVersion = $TRAY_VERSION
+try {
+    $pk = Join-Path $PSScriptRoot 'package.json'
+    if (Test-Path $pk) { $pv = (Get-Content $pk -Raw | ConvertFrom-Json).version; if ($pv) { $script:TrayVersion = $pv } }
+} catch { }
+
+# ---- 圆角浅色菜单 (白底 + 浅蓝 hover + 圆角窗口 + 投影阴影, 借鉴社区 dsh-tray) ----
+$winFormsAsm = [System.Windows.Forms.Application].Assembly.Location
+$drawingAsm  = [System.Drawing.Bitmap].Assembly.Location
+$drawingPrimAsm = [System.Drawing.Rectangle].Assembly.Location   # .NET 5+ 中 Rectangle 等转发到 System.Drawing.Primitives
+Add-Type -TypeDefinition @'
+using System;
+using System.Drawing;
+using System.Drawing.Drawing2D;
+using System.Runtime.InteropServices;
+using System.Windows.Forms;
+
+public static class MenuRounded {
+    [DllImport("user32.dll")] public static extern int SetWindowRgn(IntPtr hWnd, IntPtr hRgn, bool bRedraw);
+    [DllImport("gdi32.dll")] public static extern IntPtr CreateRoundRectRgn(int x1, int y1, int x2, int y2, int w, int h);
+    [DllImport("user32.dll")] public static extern int GetClassLong(IntPtr hWnd, int nIndex);
+    [DllImport("user32.dll")] public static extern int SetClassLong(IntPtr hWnd, int nIndex, int dwNewLong);
+    [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
+    [DllImport("user32.dll")] public static extern bool MoveWindow(IntPtr hWnd, int X, int Y, int nWidth, int nHeight, bool bRepaint);
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
+    [StructLayout(LayoutKind.Sequential)] public struct RECT { public int Left, Top, Right, Bottom; }
+}
+
+public class SoftColors : ProfessionalColorTable {
+    public override Color ToolStripDropDownBackground { get { return Color.White; } }
+    public override Color ImageMarginGradientBegin { get { return Color.White; } }
+    public override Color ImageMarginGradientMiddle { get { return Color.White; } }
+    public override Color ImageMarginGradientEnd { get { return Color.White; } }
+    public override Color MenuBorder { get { return Color.FromArgb(228, 232, 242); } }
+    public override Color MenuItemSelected { get { return Color.Transparent; } }
+    public override Color MenuItemBorder { get { return Color.Transparent; } }
+    public override Color SeparatorDark { get { return Color.Transparent; } }
+    public override Color SeparatorLight { get { return Color.Transparent; } }
+}
+
+public class SoftMenuRenderer : ToolStripProfessionalRenderer {
+    public SoftMenuRenderer() : base(new SoftColors()) { }
+    private static GraphicsPath Rounded(Rectangle r, int radius) {
+        GraphicsPath p = new GraphicsPath();
+        int d = radius * 2;
+        p.AddArc(r.X, r.Y, d, d, 180, 90);
+        p.AddArc(r.Right - d, r.Y, d, d, 270, 90);
+        p.AddArc(r.Right - d, r.Bottom - d, d, d, 0, 90);
+        p.AddArc(r.X, r.Bottom - d, d, d, 90, 90);
+        p.CloseFigure();
+        return p;
+    }
+    protected override void OnRenderMenuItemBackground(ToolStripItemRenderEventArgs e) {
+        if (e.Item.Selected || e.Item.Pressed) {
+            Rectangle r = new Rectangle(5, 3, e.Item.Width - 10, e.Item.Height - 6);
+            using (GraphicsPath p = Rounded(r, 8))
+            using (SolidBrush b = new SolidBrush(Color.FromArgb(238, 243, 255)))
+                e.Graphics.FillPath(b, p);
+        }
+    }
+    protected override void OnRenderSeparator(ToolStripSeparatorRenderEventArgs e) {
+        using (SolidBrush b = new SolidBrush(Color.FromArgb(240, 242, 247)))
+            e.Graphics.FillRectangle(b, 16, 4, e.Item.Width - 32, 1);
+    }
+    protected override void OnRenderToolStripBorder(ToolStripRenderEventArgs e) {
+        using (Pen p = new Pen(Color.FromArgb(226, 230, 240)))
+            e.Graphics.DrawRectangle(p, 1, 1, e.AffectedBounds.Width - 3, e.AffectedBounds.Height - 3);
+    }
+}
+'@ -ReferencedAssemblies @($winFormsAsm, $drawingAsm, $drawingPrimAsm)
+
+# ---- 右键菜单 (浅色圆角) ----
+$menu = New-Object System.Windows.Forms.ContextMenuStrip
+$menu.ShowImageMargin = $false
+$menu.Renderer = New-Object SoftMenuRenderer
+$menu.Font = New-Object System.Drawing.Font('Segoe UI', 8.25)
+
+# 圆角窗口 + 投影阴影 (主菜单与子菜单通用); 子菜单额外对齐父项
+# 背景: WinForms 中带箭头的子菜单父项会被拉伸到菜单宽度后再加箭头预留,
+#       导致父项宽度超过菜单窗口, 子菜单锚在父项右缘 -> 与菜单之间出现空隙
+function Round-Menu($m) {
+    try {
+        $h = $m.Handle
+        $style = [MenuRounded]::GetClassLong($h, -26)
+        [void][MenuRounded]::SetClassLong($h, -26, $style -bor 0x20000)   # CS_DROPSHADOW 投影
+        $r = [MenuRounded]::CreateRoundRectRgn(0, 0, $m.Width, $m.Height, 18, 18)
+        [void][MenuRounded]::SetWindowRgn($h, $r, $true)
+        $pi = $m.OwnerItem
+        if ($pi -and $pi.Owner) {
+            # 子菜单: 左缘对齐父菜单窗口右缘 (-3px 标准重叠), 垂直对齐父项顶部 (-3px)
+            $pt = $pi.Owner.PointToScreen($pi.Bounds.Location)
+            $ow = New-Object MenuRounded+RECT
+            [void][MenuRounded]::GetWindowRect($pi.Owner.Handle, [ref]$ow)
+            [void][MenuRounded]::MoveWindow($h, $ow.Right - 3, $pt.Y - 3, $m.Width, $m.Height, $true)
+        }
+        [void][MenuRounded]::SetForegroundWindow($h)
+    } catch { }
+}
+$menu.add_Opened({ Round-Menu $this })   # $this = 事件发送者 (避免闭包捕获函数局部变量的坑)
+$menu.add_Opening({ Update-State -ForceTui })   # 打开菜单时强制刷新 (含 TUI 状态)
+
+function New-MenuItem([string]$text, [scriptblock]$action) {
+    $it = New-Object System.Windows.Forms.ToolStripMenuItem($text)
+    $it.ForeColor = [System.Drawing.Color]::FromArgb(32, 36, 43)
+    $it.Padding = New-Object System.Windows.Forms.Padding(10, 4, 14, 4)
+    if ($action) { $it.Add_Click($action) }
+    return $it
+}
+
+function New-SubMenu([string]$text) {
+    $it = New-Object System.Windows.Forms.ToolStripMenuItem($text)
+    $it.ForeColor = [System.Drawing.Color]::FromArgb(32, 36, 43)
+    $it.Padding = New-Object System.Windows.Forms.Padding(10, 4, 14, 4)
+    $it.DropDown.Renderer = New-Object SoftMenuRenderer
+    $it.DropDown.add_Opened({ Round-Menu $this })   # $this = 子菜单 DropDown (闭包捕获 $it 会得 $null, 勿用)
+    return $it
+}
+
+# ---- 顶部双状态 ----
+$itemDshStatus  = New-MenuItem 'Web UI 状态: 检测中…' $null; $itemDshStatus.Enabled = $false
+$itemTuiStatus  = New-MenuItem 'TUI 状态: 检测中…' $null; $itemTuiStatus.Enabled = $false
+$menu.Items.Add($itemDshStatus) | Out-Null
+$menu.Items.Add($itemTuiStatus) | Out-Null
+$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
+
+# ---- Web UI 子菜单 ----
+$itemDsh = New-SubMenu 'Web UI'
+$itemOpen    = New-MenuItem '打开 Web UI'  { try { Start-Process $URL } catch { Log "打开 Web 失败: $($_.Exception.Message)" } }
+$itemStart   = New-MenuItem '启动 Web UI'  { Invoke-DshAction 'start' }
+$itemStop    = New-MenuItem '停止 Web UI'  {
+    $r = [System.Windows.Forms.MessageBox]::Show('确定停止 Web UI 服务？Web 界面与当前会话将关闭。', 'DSH 系统托盘', 'YesNo', 'Question', 'Button2')
+    if ($r -eq [System.Windows.Forms.DialogResult]::Yes) { Invoke-DshAction 'stop' }
+}
+$itemRestart = New-MenuItem '重启 Web UI'  { Invoke-DshAction 'restart' }
+$itemDsh.DropDownItems.AddRange(@($itemOpen, $itemStart, $itemStop, $itemRestart))
+$menu.Items.Add($itemDsh) | Out-Null
+
+# ---- TUI 子菜单 ----
+$itemTui = New-SubMenu 'TUI'
+$itemTuiStart = New-MenuItem '启动 TUI'    { Invoke-DshAction 'tui-start' }
+$itemTuiStop  = New-MenuItem '停止 TUI'    { Invoke-DshAction 'tui-stop' }
+$itemTui.DropDownItems.AddRange(@($itemTuiStart, $itemTuiStop))
+$menu.Items.Add($itemTui) | Out-Null
+
+$menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
+$itemLogs    = New-MenuItem '打开日志目录' { try { Start-Process $LOG_DIR } catch { Log "打开日志目录失败: $($_.Exception.Message)" } }
+$menu.Items.Add($itemLogs) | Out-Null
+
+# ---- 版本信息 (非日常功能, 放在退出前; npm 安装版支持一键更新) ----
+$itemUpdate = New-SubMenu '版本信息'
+$itemUpdateStatus = New-MenuItem ("版本: v$($script:TrayVersion)") $null; $itemUpdateStatus.Enabled = $false
+$itemUpdateCheck  = New-MenuItem '检查更新' { Update-Check }
+$itemUpdateDo     = New-MenuItem '更新到最新版' { Update-Do }; $itemUpdateDo.Enabled = $false
+$itemUpdate.DropDownItems.AddRange(@($itemUpdateStatus, $itemUpdateCheck, $itemUpdateDo))
+$menu.Items.Add($itemUpdate) | Out-Null
+$itemExit    = New-MenuItem '退出托盘'     {
+    Log '退出托盘'
+    $notify.Visible = $false
+    $timer.Stop()
+    $notify.Dispose()
+    $appContext.ExitThread()
+}
+$menu.Items.Add($itemExit) | Out-Null
+
+# ---- 动作在独立进程执行, 不阻塞托盘 UI ----
+function Invoke-DshAction([string]$action) {
+    $scriptPath = Join-Path $PSScriptRoot 'dsh-actions.ps1'
+    $args = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $scriptPath, '-Action', $action)
+    try {
+        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 }
+        Log "已触发动作: $action"
+    } catch { Log "触发动作 $action 失败: $($_.Exception.Message)" }
+}
+
+# ---- 自更新: 版本对比 / npm 定位 / 检查 / 执行 ----
+function Compare-Version($a, $b) {
+    $pa = @(); $pb = @()
+    foreach ($x in ($a -split '\.')) { try { $pa += [int]$x } catch { $pa += 0 } }
+    foreach ($x in ($b -split '\.')) { try { $pb += [int]$x } catch { $pb += 0 } }
+    for ($i = 0; $i -lt 3; $i++) {
+        $va = if ($i -lt $pa.Count) { $pa[$i] } else { 0 }
+        $vb = if ($i -lt $pb.Count) { $pb[$i] } else { 0 }
+        if ($va -gt $vb) { return 1 }
+        if ($va -lt $vb) { return -1 }
+    }
+    return 0
+}
+
+function Find-NpmCmd {
+    if ($NODE -and (Test-Path $NODE)) {
+        $p = Join-Path (Split-Path $NODE -Parent) 'npm.cmd'
+        if (Test-Path $p) { return $p }
+    }
+    $c = Get-Command npm.cmd -ErrorAction SilentlyContinue
+    if ($c) { return $c.Source }
+    $c2 = Get-Command npm -ErrorAction SilentlyContinue
+    if ($c2) { return $c2.Source }
+    return $null
+}
+
+function Get-LatestTrayVersion {
+    $npm = Find-NpmCmd
+    if (-not $npm) { Log '自更新: npm 未找到'; return '' }
+    $tmp = Join-Path $LOG_DIR 'tray-npm-view.txt'
+    Remove-Item $tmp -Force -ErrorAction SilentlyContinue
+    $cmdLine = '/c ""' + $npm + '" view ' + $TRAY_PKG + ' version > "' + $tmp + '" 2>nul "'
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $env:ComSpec
+    $psi.Arguments = $cmdLine
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    try {
+        $p = [System.Diagnostics.Process]::Start($psi)
+        $p.WaitForExit(20000) | Out-Null
+        if (-not $p.HasExited) { $p.Kill() }
+    } catch { Log "npm view 执行失败: $($_.Exception.Message)"; return '' }
+    try {
+        if (Test-Path $tmp) {
+            $v = (Get-Content $tmp -Raw).Trim()
+            Remove-Item $tmp -Force -ErrorAction SilentlyContinue
+            if ($v -match '^[0-9]+\.[0-9]+\.[0-9]+') { return $Matches[0] }
+        }
+    } catch { }
+    return ''
+}
+
+function Update-Check {
+    $itemUpdateStatus.Text = '检查中…'
+    $latest = Get-LatestTrayVersion
+    if (-not $latest) {
+        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 检查失败(网络/npm)"
+        Show-Balloon 'DSH' '检查更新失败（网络或 npm 不可用），详见日志'
+        return
+    }
+    if ((Compare-Version $latest $script:TrayVersion) -gt 0) {
+        $script:latestVersion = $latest
+        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 最新 v$latest"
+        $itemUpdateDo.Text = "更新到 v$latest"
+        $itemUpdateDo.Enabled = $true
+        Show-Balloon 'DSH' "托盘有新版本 v$latest，可一键更新"
+    } else {
+        $itemUpdateStatus.Text = "版本: v$($script:TrayVersion) · 已是最新"
+        $itemUpdateDo.Enabled = $false
+        Show-Balloon 'DSH' "已是最新版 v$($script:TrayVersion)"
+    }
+}
+
+function Update-Do {
+    $updater = Join-Path $PSScriptRoot 'dsh-update.ps1'
+    if (-not (Test-Path $updater)) { Show-Balloon 'DSH' '缺少 dsh-update.ps1，无法更新'; return }
+    $args = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $updater, '-OldPid', "$PID")
+    try {
+        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 }
+        Log '已触发自更新'
+        $itemUpdateStatus.Text = '更新中…'
+        Show-Balloon 'DSH' '正在更新… 完成后托盘会自动重启（约 1 分钟）'
+    } catch { Log "触发自更新失败: $($_.Exception.Message)" }
+}
+
+# ---- 托盘本体 ----
+$notify = New-Object System.Windows.Forms.NotifyIcon
+$notify.Icon = $iconStop
+$notify.Text = "DSH 托盘 · 检测中 (端口 $PORT)"
+$notify.ContextMenuStrip = $menu
+$notify.Visible = $true
+$notify.add_DoubleClick({
+    if (Test-Port $PORT) { Start-Process $URL } else { Show-Balloon 'DSH' 'Web UI 未运行，右键选择「启动 Web UI」' }
+})
+
+function Show-Balloon([string]$title, [string]$text) {
+    if ($NoBalloon) { return }
+    try {
+        $notify.BalloonTipTitle = $title
+        $notify.BalloonTipText = $text
+        $notify.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::Info
+        $notify.ShowBalloonTip(4000)
+    } catch { }
+}
+
+# ---- 状态轮询 ----
+$script:prevState = $null   # $null=初始; $true=运行; $false=停止
+$script:prevTui = $null     # TUI 状态 ($null=初始; $true=运行; $false=停止)
+$script:firstRun = $true    # 首次刷新只设图标, 不弹变化通知
+$script:lastTuiCheck = 0    # TUI 检测节流 (常规 20s 一次, 打开菜单时强制)
+
+function Update-State {
+    param([switch]$ForceTui)
+    try {
+        # TUI 状态独立检测 (不随 Web 状态提前返回); WMI 查询节流, 减少周期开销
+        if ($ForceTui -or ([Environment]::TickCount - $script:lastTuiCheck) -gt 20000) {
+            $script:lastTuiCheck = [Environment]::TickCount
+            $tuiProcs = @(Get-TuiProcesses)
+            $tuiRunning = $tuiProcs.Count -gt 0
+            if ($tuiRunning) {
+                $itemTuiStatus.Text = "TUI 状态: 运行中 (PID $(($tuiProcs.ProcessId) -join ','))"
+            } else {
+                $itemTuiStatus.Text = 'TUI 状态: 未运行'
+            }
+            if ($tuiRunning -ne $script:prevTui) {
+                $script:prevTui = $tuiRunning
+                $itemTuiStart.Enabled = -not $tuiRunning
+                $itemTuiStop.Enabled = $tuiRunning
+                if ($tuiRunning) {
+                    Log "TUI: 运行中 (PID $(($tuiProcs.ProcessId) -join ','))"
+                } else {
+                    Log 'TUI: 未运行'
+                }
+            }
+        }
+        $running = Test-Port $PORT
+        if ($running -eq $script:prevState -and -not $script:firstRun) { return }   # 无变化
+        $script:prevState = $running
+        if ($running) {
+            $pids = @(Get-WebPid)
+            $notify.Icon = $iconRun
+            $notify.Text = "Web UI 运行中 · 127.0.0.1:$PORT"
+            $itemDshStatus.Text = "Web UI 状态: 运行中 (PID $($pids -join ','))"
+            $itemOpen.Enabled = $true
+            $itemStart.Enabled = $false
+            $itemStop.Enabled = $true
+            $itemRestart.Enabled = $true
+            Log "状态: 运行中 (PID $($pids -join ','))"
+            if (-not $script:firstRun) { Show-Balloon 'DSH' "Web UI 已启动 ($URL)" }
+        } else {
+            $notify.Icon = $iconStop
+            $notify.Text = 'Web UI 未运行 · 右键可启动'
+            $itemDshStatus.Text = 'Web UI 状态: 未运行'
+            $itemOpen.Enabled = $false
+            $itemStart.Enabled = $true
+            $itemStop.Enabled = $false
+            $itemRestart.Enabled = $false
+            Log '状态: 未运行'
+            if (-not $script:firstRun) { Show-Balloon 'DSH' 'Web UI 已停止' }
+        }
+        $script:firstRun = $false
+    } catch { Log "轮询异常: $($_.Exception.Message)" }
+}
+
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 2000
+$timer.add_Tick({ Update-State })
+$timer.Start()
+
+# 启动即刷新一次状态(不弹变化通知), 并提示就绪
+Update-State
+if (-not $NoBalloon) { Show-Balloon 'DSH' "托盘已就绪 · 双击打开 Web · 右键控制 (端口 $PORT) · 若图标在 ^ 溢出区, 请拖到任务栏" }
+Log "托盘启动 (v$($script:TrayVersion), PID $PID, 端口 $PORT)"
+
+$appContext = New-Object System.Windows.Forms.ApplicationContext
+[System.Windows.Forms.Application]::Run($appContext)
+
+# 退出清理
+$timer.Dispose()
+$menu.Dispose()
+$iconRun.Dispose(); $iconStop.Dispose()
+try { $mutex.ReleaseMutex() } catch { }
+Log '托盘已退出'