dsh-windows-tray 1.0.0

package/launcher/dsh-tray.ps1

@@ -0,0 +1,418 @@
+# 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 '托盘已退出'

package/launcher/dsh-update.ps1

@@ -0,0 +1,116 @@
+# dsh-update.ps1 —— 托盘自更新执行器 (由托盘菜单「更新到最新版」触发, 独立隐藏进程)
+# 流程: npm install -g 最新包 -> 运行新包 install.ps1 (重新部署+改写路径+快捷方式) -> 杀旧托盘 -> 起新托盘
+# 失败时旧托盘不受影响 (旧托盘在最后一步才被终止)
+param(
+    [int]$OldPid = 0
+)
+$ErrorActionPreference = 'Stop'
+. (Join-Path $PSScriptRoot 'dsh-lib.ps1')
+
+$logFile = Join-Path $LOG_DIR 'dsh-tray-actions.log'
+function Log([string]$msg) {
+    Add-Content -Path $logFile -Value ('[{0}] {1}' -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $msg) -ErrorAction SilentlyContinue
+}
+
+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
+}
+
+# 隐藏执行 cmd /c (CreateNoWindow: 不弹黑窗), 可选超时
+function Run-HiddenCmd([string]$cmdLine, [int]$timeoutMs = 0) {
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $env:ComSpec
+    $psi.Arguments = $cmdLine
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $p = [System.Diagnostics.Process]::Start($psi)
+    if ($timeoutMs -gt 0) {
+        $p.WaitForExit($timeoutMs) | Out-Null
+        if (-not $p.HasExited) { $p.Kill(); return -1 }
+    } else { $p.WaitForExit() }
+    return $p.ExitCode
+}
+
+# 结果气泡 (临时 NotifyIcon, 更新脚本自身无托盘)
+function Show-Balloon([string]$text, [string]$icon = 'Info') {
+    try {
+        Add-Type -AssemblyName System.Windows.Forms
+        Add-Type -AssemblyName System.Drawing
+        $n = New-Object System.Windows.Forms.NotifyIcon
+        $n.Icon = [System.Drawing.SystemIcons]::Information
+        $n.Visible = $true
+        $n.BalloonTipTitle = 'DSH 系统托盘'
+        $n.BalloonTipText = $text
+        $n.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::$icon
+        $n.ShowBalloonTip(5000)
+        Start-Sleep -Seconds 6
+        $n.Visible = $false
+        $n.Dispose()
+    } catch { }
+}
+
+Log '自更新开始'
+$npm = Find-NpmCmd
+if (-not $npm) {
+    Log '自更新失败: npm 未找到'
+    Show-Balloon '自更新失败：npm 未找到' 'Error'
+    exit 1
+}
+
+# 1) 安装最新包 (全局)
+$code = Run-HiddenCmd ('/c ""' + $npm + '" install -g ' + $TRAY_PKG + ' 2>nul "', 180000)
+if ($code -ne 0) {
+    Log "自更新失败: npm install 退出码 $code"
+    Show-Balloon '自更新失败：npm install 出错，详见日志' 'Error'
+    exit 1
+}
+Log 'npm install -g 完成'
+
+# 2) 定位新包根目录
+$rootTmp = Join-Path $LOG_DIR 'tray-npm-root.txt'
+Remove-Item $rootTmp -Force -ErrorAction SilentlyContinue
+Run-HiddenCmd ('/c ""' + $npm + '" root -g > "' + $rootTmp + '" 2>nul "') | Out-Null
+$globalRoot = ''
+if (Test-Path $rootTmp) {
+    $globalRoot = (Get-Content $rootTmp -Raw).Trim()
+    Remove-Item $rootTmp -Force -ErrorAction SilentlyContinue
+}
+$newInstall = Join-Path $globalRoot ($TRAY_PKG + '\install.ps1')
+if (-not (Test-Path $newInstall)) {
+    Log "自更新失败: 未找到新包 $newInstall"
+    Show-Balloon '自更新失败：未找到新包（npm 全局目录）' 'Error'
+    exit 1
+}
+
+# 3) 运行新包 install.ps1 (重新部署 + 改写路径 + 快捷方式, 不启动托盘)
+$code = Run-HiddenCmd ('/c ""' + $PWSH + '" -NoProfile -ExecutionPolicy Bypass -File "' + $newInstall + '" -NoTrayStart 2>nul "', 120000)
+if ($code -ne 0) {
+    Log "自更新失败: install.ps1 退出码 $code"
+    Show-Balloon '自更新失败：部署出错，详见日志' 'Error'
+    exit 1
+}
+Log '新版本部署完成'
+
+# 4) 杀旧托盘 -> 起新托盘
+if ($OldPid -gt 0) {
+    Stop-Process -Id $OldPid -Force -ErrorAction SilentlyContinue
+    Log "旧托盘已停止 (PID $OldPid)"
+}
+Start-Sleep -Milliseconds 500
+$newTray = Join-Path $env:USERPROFILE '.dsh\launcher\dsh-tray.ps1'
+if (Test-Path $PWSH) {
+    Start-Process -FilePath $PWSH -ArgumentList @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $newTray) -WindowStyle Hidden | Out-Null
+} else {
+    Start-Process -FilePath 'powershell.exe' -ArgumentList @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-WindowStyle', 'Hidden', '-File', $newTray) -WindowStyle Hidden | Out-Null
+}
+Log '新托盘已启动'
+Show-Balloon '托盘已更新并自动重启 ✓'
+exit 0

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "dsh-windows-tray",
+  "version": "1.0.0",
+  "description": "DSH (DeepSeek Harness) Windows 系统托盘: 蓝/灰鲸鱼状态图标 + Web/TUI 一键启停控制。纯 PowerShell + WinForms, 零依赖。",
+  "license": "MIT",
+  "author": "jankin_lv",
+  "keywords": [
+    "dsh",
+    "deepseek",
+    "harness",
+    "tray",
+    "notifyicon",
+    "windows",
+    "powershell",
+    "system-tray"
+  ],
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "launcher/",
+    "build/",
+    "docs/",
+    "bin/",
+    "install.ps1",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "dsh-tray": "bin/dsh-tray.js"
+  },
+  "private": false
+}