dsh-windows-tray 1.0.0

package/launcher/bh-menu.bat

@@ -0,0 +1,4 @@
+@echo off
+chcp 65001 > nul
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0bh-menu.ps1"
+pause

package/launcher/bh-menu.ps1

@@ -0,0 +1,56 @@
+# dsh 黑洞模拟器启动器 —— 网页版交互黑洞（oseiskar/black-hole）
+# 用法: 双击 bh-menu.bat 或 powershell -File bh-menu.ps1 -Cmd start|stop|status
+param([string]$Cmd)
+$ErrorActionPreference = 'Stop'
+chcp 65001 > $null
+
+$PORT = 8137
+$URL  = 'http://127.0.0.1:8137'
+$DIR  = "$env:USERPROFILE\.dsh\gen-wallpaper\bh-shader"
+
+function Test-Port([int]$port) {
+    $c = New-Object System.Net.Sockets.TcpClient
+    try { if ($c.BeginConnect('127.0.0.1', $port, $null, $null).AsyncWaitHandle.WaitOne(500) -and $c.Connected) { return $true } } catch {}
+    finally { $c.Close() }
+    return $false
+}
+
+function Start-BH {
+    if (Test-Port $PORT) { Write-Output "[bh] 服务已在运行: $URL"; Start-Process $URL; return }
+    Start-Process node -ArgumentList 'serve.mjs' -WorkingDirectory $DIR -WindowStyle Hidden
+    Start-Sleep -Seconds 3
+    if (Test-Port $PORT) { Write-Output "[bh] 启动成功: $URL"; Start-Process $URL }
+    else { Write-Output "[bh] 启动失败, 请手工运行: cd $DIR; node serve.mjs" }
+}
+
+function Stop-BH {
+    $pids = @((Get-NetTCPConnection -LocalPort $PORT -State Listen -ErrorAction SilentlyContinue).OwningProcess | Select-Object -Unique)
+    if ($pids.Count -eq 0) { Write-Output '[bh] 服务未运行'; return }
+    foreach ($p in $pids) { Write-Output "[bh] 停止进程 $p"; & taskkill /PID $p /F 2>$null | Out-Null }
+    Write-Output '[bh] 已停止'
+}
+
+if ($Cmd) {
+    switch ($Cmd.ToLower()) {
+        'start' { Start-BH }
+        'stop'  { Stop-BH }
+        'status'{ if (Test-Port $PORT) { Write-Output "[bh] 运行中: $URL" } else { Write-Output '[bh] 未运行' } }
+        default { Write-Output '用法: bh-menu.ps1 -Cmd start|stop|status' }
+    }
+    exit
+}
+while ($true) {
+    Write-Output ''
+    Write-Output '======== 黑洞模拟器 ========'
+    if (Test-Port $PORT) { Write-Output '状态: 运行中' } else { Write-Output '状态: 未运行' }
+    Write-Output '[1] 启动并打开浏览器'
+    Write-Output '[2] 停止'
+    Write-Output '[0] 退出'
+    $choice = Read-Host '请选择'
+    switch ($choice) {
+        '1' { Start-BH }
+        '2' { Stop-BH }
+        '0' { exit }
+        default { Write-Output '无效选择' }
+    }
+}

package/launcher/dsh-actions.ps1

@@ -0,0 +1,50 @@
+# dsh-actions.ps1 —— 托盘菜单动作执行器 (由 dsh-tray.ps1 以独立隐藏进程拉起)
+# 用法: pwsh -NoProfile -File dsh-actions.ps1 -Action start|stop|restart|tui-start|tui-stop
+# 动作在独立进程执行, 托盘 UI 线程保持响应; 日志写入 ~/.dsh/logs/dsh-tray-actions.log
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidateSet('start', 'stop', 'restart', 'tui-start', 'tui-stop')]
+    [string]$Action
+)
+$ErrorActionPreference = 'Stop'
+
+. (Join-Path $PSScriptRoot 'dsh-lib.ps1')
+
+$logFile = Join-Path $LOG_DIR 'dsh-tray-actions.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
+}
+
+try {
+    switch ($Action) {
+        'start' {
+            Log '启动 DSH (来自系统托盘)'
+            Start-Dsh -OpenBrowser:$false
+            Log '启动动作完成'
+        }
+        'stop' {
+            Log '停止 DSH (来自系统托盘)'
+            Stop-Dsh
+            Log '停止动作完成'
+        }
+        'restart' {
+            Log '重启 DSH (来自系统托盘)'
+            Restart-Dsh
+            Log '重启动作完成'
+        }
+        'tui-start' {
+            Log '启动 TUI (来自系统托盘)'
+            Start-Tui
+            Log 'TUI 启动动作完成'
+        }
+        'tui-stop' {
+            Log '停止 TUI (来自系统托盘)'
+            Stop-Tui
+            Log 'TUI 停止动作完成'
+        }
+    }
+} catch {
+    Log ("动作 {0} 失败: {1}" -f $Action, $_.Exception.Message)
+    exit 1
+}

package/launcher/dsh-all-menu.bat

@@ -0,0 +1,4 @@
+@echo off
+chcp 65001 > nul
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0dsh-all-menu.ps1"
+pause

package/launcher/dsh-all-menu.ps1

@@ -0,0 +1,106 @@
+# dsh 一体化控制台 —— 同时管理 dsh web (3080) 和黑洞模拟器 (8137)
+# 用法: 双击 dsh-一体化菜单.lnk / dsh-all-menu.bat 进入交互菜单
+#       命令行: dsh-all-menu.ps1 -Cmd all-start|all-stop|dsh-start|dsh-stop|bh-start|bh-stop|status|open
+param([string]$Cmd)
+$ErrorActionPreference = 'Stop'
+chcp 65001 > $null
+
+$DshMenu = "$PSScriptRoot\dsh-menu.ps1"
+$BhMenu  = "$PSScriptRoot\bh-menu.ps1"
+$DshUrl  = 'http://127.0.0.1:3080'
+$BhUrl   = 'http://127.0.0.1:8137'
+
+function Test-Port([int]$port) {
+    $c = New-Object System.Net.Sockets.TcpClient
+    try { if ($c.BeginConnect('127.0.0.1', $port, $null, $null).AsyncWaitHandle.WaitOne(500) -and $c.Connected) { return $true } } catch {}
+    finally { $c.Close() }
+    return $false
+}
+
+function StatusLine {
+    $d = if (Test-Port 3080) { "运行中: $DshUrl" } else { '未运行' }
+    $b = if (Test-Port 8137) { "运行中: $BhUrl" } else { '未运行' }
+    Write-Host "  [dsh] $d" -ForegroundColor $(if (Test-Port 3080) { 'Green' } else { 'Red' })
+    Write-Host "  [bh ] $b" -ForegroundColor $(if (Test-Port 8137) { 'Green' } else { 'Red' })
+}
+
+function All-Start {
+    Write-Host '启动 dsh web ...' -ForegroundColor Cyan
+    & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd start | Out-Host
+    Write-Host '启动 黑洞模拟器 ...' -ForegroundColor Cyan
+    & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd start | Out-Host
+}
+function All-Stop {
+    Write-Host '停止 dsh web ...' -ForegroundColor Yellow
+    & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd stop | Out-Host
+    Write-Host '停止 黑洞模拟器 ...' -ForegroundColor Yellow
+    & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd stop | Out-Host
+}
+function Pause-Back { Read-Host '按回车键返回菜单' | Out-Null }
+
+function Show-Detail {
+    Write-Host '  ── dsh web ──' -ForegroundColor Cyan
+    if (Test-Port 3080) {
+        $p = (Get-NetTCPConnection -LocalPort 3080 -State Listen | Select-Object -First 1).OwningProcess
+        Write-Host "  状态: 运行中   PID: $p" -ForegroundColor Green
+        Write-Host "  地址: $DshUrl" -ForegroundColor White
+    } else { Write-Host '  状态: 未运行' -ForegroundColor Red }
+    Write-Host '  ── 黑洞模拟器 ──' -ForegroundColor Cyan
+    if (Test-Port 8137) {
+        $p = (Get-NetTCPConnection -LocalPort 8137 -State Listen | Select-Object -First 1).OwningProcess
+        Write-Host "  状态: 运行中   PID: $p" -ForegroundColor Green
+        Write-Host "  地址: $BhUrl" -ForegroundColor White
+    } else { Write-Host '  状态: 未运行' -ForegroundColor Red }
+}
+
+if ($Cmd) {
+    switch ($Cmd.ToLower()) {
+        'all-start' { All-Start }
+        'all-stop'  { All-Stop }
+        'dsh-start' { & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd start | Out-Host }
+        'dsh-stop'  { & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd stop  | Out-Host }
+        'bh-start'  { & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd start | Out-Host }
+        'bh-stop'   { & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd stop  | Out-Host }
+        'status'    { StatusLine }
+        'open'      { if (Test-Port 3080) { Start-Process $DshUrl } else { Write-Host '[dsh] 未运行' -ForegroundColor Red }
+                      if (Test-Port 8137) { Start-Process $BhUrl } else { Write-Host '[bh] 未运行' -ForegroundColor Red } }
+        default { Write-Output '用法: dsh-all-menu.ps1 -Cmd all-start|all-stop|dsh-start|dsh-stop|bh-start|bh-stop|status|open' }
+    }
+    exit
+}
+
+while ($true) {
+    Clear-Host
+    Write-Host ''
+    Write-Host '  ╔═══════════════════════════════════════╗' -ForegroundColor Cyan
+    Write-Host '  ║        dsh 一体化控制台 v1            ║' -ForegroundColor Cyan
+    Write-Host '  ╚═══════════════════════════════════════╝' -ForegroundColor Cyan
+    Write-Host ''
+    StatusLine
+    Write-Host ''
+    Write-Host '  [1] 全部启动 (dsh + 黑洞) 并打开浏览器' -ForegroundColor White
+    Write-Host '  [2] 全部停止' -ForegroundColor White
+    Write-Host '  [3] 只启动 dsh          [4] 只停止 dsh' -ForegroundColor White
+    Write-Host '  [5] 只启动黑洞          [6] 只停止黑洞' -ForegroundColor White
+    Write-Host '  [7] 服务详情 (PID/端口)' -ForegroundColor White
+    Write-Host '  [8] 打开 dsh 页面        [9] 打开黑洞页面' -ForegroundColor White
+    Write-Host '  [0] 退出' -ForegroundColor White
+    Write-Host ''
+    $choice = Read-Host '  请选择'
+    Write-Host ''
+    switch ($choice) {
+        '1' { All-Start; Pause-Back }
+        '2' { All-Stop; Pause-Back }
+        '3' { & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd start | Out-Host; Pause-Back }
+        '4' { & powershell -NoProfile -ExecutionPolicy Bypass -File $DshMenu -Cmd stop  | Out-Host; Pause-Back }
+        '5' { & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd start | Out-Host; Pause-Back }
+        '6' { & powershell -NoProfile -ExecutionPolicy Bypass -File $BhMenu  -Cmd stop  | Out-Host; Pause-Back }
+        '7' { Show-Detail; Pause-Back }
+        '8' { if (Test-Port 3080) { Start-Process $DshUrl } else { Write-Host '  [dsh] 未运行, 请先启动' -ForegroundColor Red }
+              Pause-Back }
+        '9' { if (Test-Port 8137) { Start-Process $BhUrl } else { Write-Host '  [bh] 未运行, 请先启动' -ForegroundColor Red }
+              Pause-Back }
+        '0' { Write-Host '  再见！' -ForegroundColor Cyan; exit }
+        default { Write-Host '  无效选择, 请重试' -ForegroundColor Red; Start-Sleep -Milliseconds 800 }
+    }
+}

package/launcher/dsh-control.bat

@@ -0,0 +1,10 @@
+@echo off
+chcp 65001 >nul
+rem DSH 控制台 - double click to open menu
+rem prefer pwsh (PowerShell 7), fallback to powershell 5.1
+where pwsh >nul 2>nul
+if %errorlevel%==0 (
+  pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0dsh-control.ps1"
+) else (
+  powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0dsh-control.ps1"
+)

package/launcher/dsh-control.ps1

@@ -0,0 +1,40 @@
+# DSH 控制台 —— 启动/重启 Web + 启动 TUI + 状态查看 + 系统托盘
+# 部署：2026-08-26；双击桌面「DSH 控制台」或 dsh-control.bat
+# 坑：本脚本由用户独立窗口运行（非 web 子进程），杀/重启 web 安全（PITFALLS §12.2）
+# 2026-08-28: 启动/停止/重启/托盘逻辑抽到 dsh-lib.ps1（与系统托盘共享同一份代码）
+$ErrorActionPreference = 'Stop'
+chcp 65001 > $null
+
+. (Join-Path $PSScriptRoot 'dsh-lib.ps1')
+
+while ($true) {
+    Clear-Host
+    Write-Host ''
+    Write-Host '  ┌──────────────────────────────┐'
+    Write-Host '  │         DSH 控制台           │'
+    Write-Host '  ├──────────────────────────────┤'
+    Write-Host '  │  1) 启动 / 打开 Web (3088)   │'
+    Write-Host '  │  2) 重启 Web                 │'
+    Write-Host '  │  3) 启动 TUI（新终端窗口）   │'
+    Write-Host '  │  4) 查看状态                 │'
+    Write-Host '  │  5) 启动系统托盘             │'
+    Write-Host '  │  0) 退出                     │'
+    Write-Host '  └──────────────────────────────┘'
+    $c = Read-Host '  请选择'
+    switch ($c) {
+        '1' { Start-Dsh }
+        '2' { Restart-Dsh }
+        '3' { Start-Tui }
+        '4' { Show-Status }
+        '5' {
+            if (Ensure-DshTray) {
+                Write-Host '[tray] 系统托盘已在运行（蓝鲸=运行中 / 灰鲸=未运行，右键可控制）' -ForegroundColor Green
+            } else {
+                Write-Host '[tray] 系统托盘已启动（蓝鲸=运行中 / 灰鲸=未运行，右键可控制）' -ForegroundColor Green
+            }
+        }
+        '0' { Write-Host '  再见！'; break }
+        default { Write-Host "  无效选择: $c" -ForegroundColor Red }
+    }
+    if ($c -ne '0') { Write-Host ''; Read-Host '  按回车返回菜单' }
+}

package/launcher/dsh-lib.ps1

@@ -0,0 +1,165 @@
+# dsh-lib.ps1 —— DSH 启动/停止/重启/托盘 公共库
+# 被 dsh-control.ps1 (控制台) 与 dsh-tray.ps1 (系统托盘) 点源引用 (dot-source)
+# 所有路径/端口/进程管理逻辑的单一事实来源: 修改此处, 两个入口同时生效
+$ErrorActionPreference = 'Stop'
+
+$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    = 3088
+$URL     = "http://127.0.0.1:$PORT"
+$LOG_DIR = "$env:USERPROFILE\.dsh\logs"
+$WT      = "$env:LOCALAPPDATA\Microsoft\WindowsApps\wt.exe"
+$PWSH    = 'D:\Program Files (x86)\PowerShell-7.6.4\pwsh.exe'
+$TRAY_VERSION = '1.0.0'   # 托盘版本 (与 npm 包版本同步, 用于日志/排查)
+$TRAY_PKG     = 'dsh-windows-tray'   # npm 包名 (托盘自更新)
+$TRAY_SCRIPT = Join-Path $PSScriptRoot 'dsh-tray.ps1'
+
+function Test-Port([int]$port) {
+    $client = New-Object System.Net.Sockets.TcpClient
+    try {
+        $async = $client.BeginConnect('127.0.0.1', $port, $null, $null)
+        if ($async.AsyncWaitHandle.WaitOne(500) -and $client.Connected) { return $true }
+        return $false
+    } catch { return $false }
+    finally { $client.Close() }
+}
+
+function Get-WebPid {
+    @((Get-NetTCPConnection -LocalPort $PORT -State Listen -ErrorAction SilentlyContinue).OwningProcess | Select-Object -Unique)
+}
+
+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
+        if ($trayStarted) { Write-Host '[tray] 系统托盘已自动启动（右键可控制 DSH）' -ForegroundColor DarkGray }
+        if ($OpenBrowser) { Start-Process $URL }
+        return
+    }
+    Write-Host "[dsh] 启动中 (端口 $PORT)..."
+    $out = Join-Path $LOG_DIR 'web-menu.out.log'
+    $err = Join-Path $LOG_DIR 'web-menu.err.log'
+    Start-Process -FilePath $NODE -ArgumentList "`"$BIN`"",'web','--host','127.0.0.1','--port',"$PORT",'--no-open' `
+        -WorkingDirectory $WORKDIR -WindowStyle Hidden `
+        -RedirectStandardOutput $out -RedirectStandardError $err | Out-Null
+    for ($i = 0; $i -lt 12; $i++) {
+        Start-Sleep -Seconds 1
+        if (Test-Port $PORT) { break }
+    }
+    if (Test-Port $PORT) {
+        Write-Host "[dsh] 启动成功: $URL" -ForegroundColor Green
+        if ($trayStarted) { Write-Host '[tray] 系统托盘已自动启动（右键可控制 DSH）' -ForegroundColor DarkGray }
+        Start-Sleep -Seconds 2
+        if ($OpenBrowser) { Start-Process $URL }
+    } else {
+        Write-Host "[dsh] 启动失败: 12 秒内端口 $PORT 未监听" -ForegroundColor Red
+        Write-Host "[dsh] 错误日志: $err（末尾 10 行）"
+        Get-Content $err -Tail 10 -ErrorAction SilentlyContinue
+    }
+}
+
+function Stop-Dsh {
+    $pids = @(Get-WebPid)
+    if ($pids.Count -eq 0) { Write-Host '[dsh] 未在运行'; return }
+    foreach ($p in $pids) {
+        Write-Host "[dsh] 停止进程 $p"
+        & taskkill /PID $p /T /F 2>$null | Out-Null
+    }
+    for ($i = 0; $i -lt 10; $i++) {
+        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 }
+}
+
+function Restart-Dsh {
+    Stop-Dsh
+    Start-Sleep -Seconds 1
+    Start-Dsh
+}
+
+function Start-Tui {
+    $existing = @(Get-TuiProcesses)
+    if ($existing.Count -gt 0) {
+        Write-Host "[tui] TUI 已在运行 (PID $($existing.ProcessId -join ',')), 不重复启动" -ForegroundColor Yellow
+        return
+    }
+    $cmdLine = "& '$DSH_CMD' --profile dsh-tui"
+    if (Test-Path $WT) {
+        $args = "new-tab --title `"DSH TUI`" pwsh -NoExit -Command `"$cmdLine`""
+        Start-Process $WT -ArgumentList $args
+        Write-Host '[tui] 已在 Windows Terminal 新标签页启动 DSH TUI' -ForegroundColor Green
+    } elseif (Test-Path $PWSH) {
+        Start-Process $PWSH -ArgumentList '-NoExit','-Command',$cmdLine
+        Write-Host '[tui] 已在新 PowerShell 窗口启动 DSH TUI' -ForegroundColor Green
+    } else {
+        Start-Process 'powershell' -ArgumentList '-NoExit','-Command',$cmdLine
+        Write-Host '[tui] 已在新 PowerShell 窗口启动 DSH TUI' -ForegroundColor Green
+    }
+}
+
+function Get-TuiProcesses {
+    Get-CimInstance Win32_Process -Filter "Name='node.exe'" -ErrorAction SilentlyContinue |
+        Where-Object { $_.CommandLine -match 'dsh-tui' }
+}
+
+function Stop-Tui {
+    $tui = @(Get-TuiProcesses)
+    if ($tui.Count -eq 0) { Write-Host '[tui] TUI: 未在运行'; return }
+    foreach ($p in $tui) {
+        Write-Host "[tui] 停止 TUI 进程 $($p.ProcessId)"
+        & taskkill /PID $p.ProcessId /T /F 2>$null | Out-Null
+    }
+    Start-Sleep -Seconds 1
+    if (@(Get-TuiProcesses).Count -gt 0) { Write-Host '[tui] TUI 进程未完全退出，请稍后重试' -ForegroundColor Red }
+    else { Write-Host '[tui] TUI 已停止' -ForegroundColor Yellow }
+}
+
+function Show-Status {
+    $pids = @(Get-WebPid)
+    if ($pids.Count -gt 0) {
+        Write-Host "[dsh] Web: 运行中  $URL  (PID $($pids -join ','))" -ForegroundColor Green
+    } else {
+        Write-Host '[dsh] Web: 未运行' -ForegroundColor Yellow
+    }
+    $tui = @(Get-TuiProcesses)
+    if ($tui.Count -gt 0) {
+        Write-Host "[tui] TUI: 运行中 (PID $($tui.ProcessId -join ','))" -ForegroundColor Green
+    } else {
+        Write-Host '[tui] TUI: 未运行（按 3 启动）' -ForegroundColor Yellow
+    }
+    $tray = @(Get-TrayProcesses)
+    if ($tray.Count -gt 0) {
+        Write-Host "[tray] 托盘: 运行中 (PID $($tray.ProcessId -join ','))" -ForegroundColor Green
+    } else {
+        Write-Host '[tray] 托盘: 未运行（按 5 启动）' -ForegroundColor Yellow
+    }
+}
+
+# ---- 系统托盘 ----
+
+function Get-TrayProcesses {
+    Get-CimInstance Win32_Process -ErrorAction SilentlyContinue | Where-Object {
+        ($_.Name -eq 'pwsh.exe' -or $_.Name -eq 'powershell.exe') -and
+        $_.CommandLine -and $_.CommandLine -match 'dsh-tray\.ps1' -and
+        $_.ProcessId -ne $PID
+    }
+}
+
+# 确保托盘在运行(幂等): 已在运行返回 $true; 刚拉起返回 $false
+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
+    }
+    return $false
+}

package/launcher/dsh-menu.bat

@@ -0,0 +1,11 @@
+@echo off
+chcp 65001 >nul
+rem dsh (DeepSeek Harness) launcher - double click to open menu
+rem prefer pwsh (PowerShell 7), fallback to powershell 5.1
+where pwsh >nul 2>nul
+if %errorlevel%==0 (
+  pwsh -NoProfile -ExecutionPolicy Bypass -File "%~dp0dsh-menu.ps1"
+) else (
+  powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0dsh-menu.ps1"
+)
+pause

package/launcher/dsh-menu.ps1

@@ -0,0 +1,93 @@
+# dsh (DeepSeek Harness) 启动器 —— 公司机部署 2026-08-14
+# 用法:
+#   交互菜单: 双击 dsh-menu.bat
+#   非交互:   dsh-menu.ps1 -Cmd start|stop|status
+# 坑: 不要在本脚本内对 Start-Process 用 -RedirectStandardOutput
+#     (父进程 stdout 被重定向时挂起, 见 LEARNED #53)
+param(
+    [string]$Cmd
+)
+$ErrorActionPreference = 'Stop'
+
+$DSH_CMD = 'D:\Program Files (x86)\dsh\dsh.cmd'
+$PORT    = 3080
+$URL     = 'http://127.0.0.1:3080'
+
+function Test-Port([int]$port) {
+    $client = New-Object System.Net.Sockets.TcpClient
+    try {
+        $async = $client.BeginConnect('127.0.0.1', $port, $null, $null)
+        if ($async.AsyncWaitHandle.WaitOne(500) -and $client.Connected) { return $true }
+        return $false
+    } catch { return $false }
+    finally { $client.Close() }
+}
+
+function Start-Dsh {
+    if (Test-Port $PORT) {
+        Write-Output "[dsh] 端口 $PORT 已监听, 服务已在运行, 不重复启动"
+        return
+    }
+    Start-Process -FilePath $DSH_CMD -ArgumentList 'web' -WindowStyle Hidden
+    Start-Sleep -Seconds 6
+    if (Test-Port $PORT) {
+        Write-Output "[dsh] 启动成功: $URL"
+    } else {
+        Start-Sleep -Seconds 5
+        if (Test-Port $PORT) {
+            Write-Output "[dsh] 启动成功: $URL"
+        } else {
+            Write-Output "[dsh] 启动失败: 端口 $PORT 未监听, 请手工运行 dsh web 查看报错"
+        }
+    }
+}
+
+function Stop-Dsh {
+    $pids = @((Get-NetTCPConnection -LocalPort $PORT -State Listen -ErrorAction SilentlyContinue).OwningProcess | Select-Object -Unique)
+    if ($pids.Count -eq 0) {
+        Write-Output '[dsh] 服务未在运行'
+        return
+    }
+    foreach ($p in $pids) {
+        Write-Output "[dsh] 停止进程 $p"
+        & taskkill /PID $p /T /F 2>$null | Out-Null
+    }
+    Start-Sleep -Seconds 2
+    if (Test-Port $PORT) { Write-Output '[dsh] 停止失败: 端口仍在监听' }
+    else { Write-Output '[dsh] 已停止' }
+}
+
+function Show-Status {
+    if (Test-Port $PORT) { Write-Output "[dsh] 运行中: $URL" }
+    else { Write-Output '[dsh] 未运行' }
+}
+
+# ---------- 非交互模式 ----------
+if ($Cmd) {
+    switch ($Cmd.ToLower()) {
+        'start'  { Start-Dsh }
+        'stop'   { Stop-Dsh }
+        'status' { Show-Status }
+        default  { Write-Output '用法: dsh-menu.ps1 -Cmd start|stop|status' }
+    }
+    exit
+}
+
+# ---------- 交互菜单 ----------
+while ($true) {
+    Write-Output ''
+    Write-Output '======== dsh 启动器 ========'
+    Show-Status
+    Write-Output '[1] 启动并打开浏览器'
+    Write-Output '[2] 停止'
+    Write-Output '[3] 状态'
+    Write-Output '[0] 退出'
+    $choice = Read-Host '请选择'
+    switch ($choice) {
+        '1' { Start-Dsh; Start-Process $URL; }
+        '2' { Stop-Dsh }
+        '3' { Show-Status }
+        '0' { exit }
+        default { Write-Output '无效选择' }
+    }
+}

package/launcher/dsh-tray.bat

@@ -0,0 +1,10 @@
+@echo off
+chcp 65001 >nul
+rem DSH 系统托盘 - double click to start (blue whale = running, gray = stopped)
+rem prefer pwsh (PowerShell 7), fallback to powershell 5.1
+where pwsh >nul 2>nul
+if %errorlevel%==0 (
+  start "" pwsh -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "%~dp0dsh-tray.ps1"
+) else (
+  start "" powershell -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "%~dp0dsh-tray.ps1"
+)