feat: add embedded app PC debugging skill

scripts/serial_web_console.ps1

@@ -0,0 +1,146 @@
+<#
+.SYNOPSIS
+启动支持网页命令输入的串口实时控制台。
+
+.DESCRIPTION
+使用单一进程独占串口，同时提供串口读取、原始日志、时间戳文本日志和本机网页命令接口。
+网页仅监听 127.0.0.1；普通命令支持 None、CR、LF、CRLF 四种结尾。
+
+.EXAMPLE
+.\serial_web_console.ps1 -Port COM56 -LogPath F:\tmp\serial.log
+
+.EXAMPLE
+.\serial_web_console.ps1 -Port COM56 -LogPath .\serial.log -WebPort 8766
+
+.PARAMETER ValidateOnly
+只编译并验证程序和页面资源，不打开串口，也不监听网页端口。
+#>
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidateNotNullOrEmpty()]
+    [string]$Port,
+
+    [Parameter(Mandatory = $true)]
+    [ValidateNotNullOrEmpty()]
+    [string]$LogPath,
+
+    [ValidateRange(1, 4000000)]
+    [int]$BaudRate = 115200,
+
+    [ValidateRange(5, 8)]
+    [int]$DataBits = 8,
+
+    [ValidateSet('None', 'Odd', 'Even', 'Mark', 'Space')]
+    [string]$Parity = 'None',
+
+    [ValidateSet('One', 'OnePointFive', 'Two')]
+    [string]$StopBits = 'One',
+
+    [ValidateSet('None', 'XOnXOff', 'RequestToSend', 'RequestToSendXOnXOff')]
+    [string]$Handshake = 'None',
+
+    [string]$EncodingName = 'utf-8',
+
+    [ValidateRange(1, 5000)]
+    [int]$PollMilliseconds = 100,
+
+    [ValidateRange(64, 1048576)]
+    [int]$BufferSize = 4096,
+
+    [string]$RawPath,
+
+    [ValidateRange(1024, 65535)]
+    [int]$WebPort = 8766,
+
+    [string]$HtmlPath,
+
+    [ValidateRange(0, 2147483647)]
+    [int]$DurationSeconds = 0,
+
+    [switch]$DtrEnable,
+
+    [switch]$RtsEnable,
+
+    [switch]$ValidateOnly
+)
+
+$ErrorActionPreference = 'Stop'
+$broker = $null
+
+try {
+    if ($PSVersionTable.PSEdition -ne 'Desktop') {
+        throw '该脚本需要由 Windows PowerShell 5.1 运行。请使用 powershell.exe，而不是 pwsh.exe。'
+    }
+
+    $sourcePath = Join-Path $PSScriptRoot 'SerialWebConsoleHost.cs'
+    if (-not (Test-Path -LiteralPath $sourcePath -PathType Leaf)) {
+        throw "找不到串口服务源文件：$sourcePath"
+    }
+
+    if ([string]::IsNullOrWhiteSpace($HtmlPath)) {
+        $HtmlPath = Join-Path (Split-Path $PSScriptRoot -Parent) 'assets\serial-console.html'
+    }
+    $resolvedHtmlPath = [System.IO.Path]::GetFullPath($HtmlPath)
+    if (-not (Test-Path -LiteralPath $resolvedHtmlPath -PathType Leaf)) {
+        throw "找不到串口控制台页面：$resolvedHtmlPath"
+    }
+
+    # Windows PowerShell 5.1 自带完整 .NET Framework，可直接编译 SerialPort 和 HttpListener。
+    Add-Type -Path $sourcePath -ErrorAction Stop
+
+    if ($ValidateOnly.IsPresent) {
+        Write-Output "验证通过：串口服务代码已编译，网页资源存在。"
+        Write-Output "源文件：$sourcePath"
+        Write-Output "页面：$resolvedHtmlPath"
+        return
+    }
+
+    $resolvedLogPath = [System.IO.Path]::GetFullPath($LogPath)
+    if ([string]::IsNullOrWhiteSpace($RawPath)) {
+        $resolvedRawPath = $resolvedLogPath + '.raw.bin'
+    }
+    else {
+        $resolvedRawPath = [System.IO.Path]::GetFullPath($RawPath)
+    }
+
+    $broker = [EmbeddedAppPcDebug.SerialWebConsoleHost]::new(
+        $Port,
+        $BaudRate,
+        $DataBits,
+        $Parity,
+        $StopBits,
+        $Handshake,
+        $EncodingName,
+        $PollMilliseconds,
+        $BufferSize,
+        $DtrEnable.IsPresent,
+        $RtsEnable.IsPresent,
+        $resolvedLogPath,
+        $resolvedRawPath,
+        $WebPort,
+        $resolvedHtmlPath
+    )
+
+    $broker.Start()
+    $startTime = Get-Date
+    Write-Output "串口网页控制台已启动：$($broker.Url)"
+    Write-Output "按 Ctrl+C 可停止串口采集和网页服务。"
+
+    while (-not $broker.IsStopping) {
+        if ($DurationSeconds -gt 0 -and ((Get-Date) - $startTime).TotalSeconds -ge $DurationSeconds) {
+            break
+        }
+        Start-Sleep -Milliseconds 200
+    }
+}
+catch {
+    $message = '[' + (Get-Date -Format 'yyyy-MM-dd HH:mm:ss.fff') + '] 串口网页控制台失败：' + [string]$_.Exception.Message
+    [Console]::Error.WriteLine($message)
+    exit 1
+}
+finally {
+    if ($null -ne $broker) {
+        $broker.Dispose()
+    }
+}