tools: add offline real client window launcher
This commit is contained in:
zhaoyilun
268
scripts/open-offline-real-client-window.ps1
Normal file
268
scripts/open-offline-real-client-window.ps1
Normal file
@@ -0,0 +1,268 @@
|
|||||||
|
param(
|
||||||
|
[string]$ArchivePath = "runs/offline-evidence-intake/zyl-qqfile-20260709/archives/zyl.rar",
|
||||||
|
[string]$ExtractDir = "runs/offline-real-client-window/full",
|
||||||
|
[ValidateSet("Impp", "iSphere")]
|
||||||
|
[string]$ClientRoot = "Impp",
|
||||||
|
[string]$HelperExe = "runs/win-helper/ISphereWinHelper.exe",
|
||||||
|
[int]$WaitSeconds = 10,
|
||||||
|
[int]$X = 120,
|
||||||
|
[int]$Y = 120,
|
||||||
|
[int]$Width = 270,
|
||||||
|
[int]$Height = 570,
|
||||||
|
[switch]$SkipExtract,
|
||||||
|
[switch]$NoLaunch,
|
||||||
|
[switch]$KeepExisting,
|
||||||
|
[switch]$TopMost,
|
||||||
|
[switch]$NoScreenshot
|
||||||
|
)
|
||||||
|
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
$repo = Resolve-Path -LiteralPath (Join-Path $PSScriptRoot "..")
|
||||||
|
$InfoPromptTitle = -join ([char[]](0x4FE1, 0x606F, 0x63D0, 0x793A))
|
||||||
|
|
||||||
|
function Resolve-RepoPath([string]$PathValue) {
|
||||||
|
if ([System.IO.Path]::IsPathRooted($PathValue)) {
|
||||||
|
return $PathValue
|
||||||
|
}
|
||||||
|
return (Join-Path $repo $PathValue)
|
||||||
|
}
|
||||||
|
|
||||||
|
function Find-7Zip {
|
||||||
|
$candidates = @(
|
||||||
|
"C:\Program Files\7-Zip\7z.exe",
|
||||||
|
"C:\Program Files (x86)\7-Zip\7z.exe"
|
||||||
|
)
|
||||||
|
foreach ($candidate in $candidates) {
|
||||||
|
if (Test-Path -LiteralPath $candidate) {
|
||||||
|
return $candidate
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$cmd = Get-Command "7z" -ErrorAction SilentlyContinue
|
||||||
|
if ($cmd) {
|
||||||
|
return $cmd.Source
|
||||||
|
}
|
||||||
|
$cmd = Get-Command "7zr" -ErrorAction SilentlyContinue
|
||||||
|
if ($cmd) {
|
||||||
|
return $cmd.Source
|
||||||
|
}
|
||||||
|
throw "7-Zip not found. Install 7-Zip or pass -SkipExtract after extracting the archive."
|
||||||
|
}
|
||||||
|
|
||||||
|
function Invoke-HelperJson([string]$Op, [hashtable]$OpArgs, [string]$RequestId) {
|
||||||
|
$request = @{
|
||||||
|
protocol = "isphere.helper.v1"
|
||||||
|
request_id = $RequestId
|
||||||
|
op = $Op
|
||||||
|
timeout_ms = 5000
|
||||||
|
args = $OpArgs
|
||||||
|
}
|
||||||
|
$json = $request | ConvertTo-Json -Depth 16 -Compress
|
||||||
|
$output = $json | & $script:HelperPath --json
|
||||||
|
try {
|
||||||
|
return $output | ConvertFrom-Json
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
throw "helper output was not JSON: $output"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Stop-ExistingOfflineCopies([string]$RootPath) {
|
||||||
|
$rootFull = [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\') + "\"
|
||||||
|
$targets = @("IMPlatformClient.exe", "IMPP.ISphere.exe", "IMPlatformClient.Web.exe")
|
||||||
|
$processes = Get-CimInstance Win32_Process |
|
||||||
|
Where-Object { $targets -contains $_.Name -and $_.ExecutablePath -and ([System.IO.Path]::GetFullPath($_.ExecutablePath).StartsWith($rootFull, [System.StringComparison]::OrdinalIgnoreCase)) }
|
||||||
|
foreach ($proc in $processes) {
|
||||||
|
Stop-Process -Id ([int]$proc.ProcessId) -Force -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Add-NativeWindowApi {
|
||||||
|
Add-Type @"
|
||||||
|
using System;
|
||||||
|
using System.Runtime.InteropServices;
|
||||||
|
public static class ISphereOfflineWindowApi {
|
||||||
|
[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 ShowWindow(IntPtr hWnd, int nCmdShow);
|
||||||
|
[DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
|
||||||
|
[DllImport("user32.dll")] public static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags);
|
||||||
|
}
|
||||||
|
"@ -ErrorAction SilentlyContinue
|
||||||
|
}
|
||||||
|
|
||||||
|
function Move-ClientWindows([object[]]$Windows, [int]$MainX, [int]$MainY, [int]$MainWidth, [int]$MainHeight, [bool]$MakeTopMost) {
|
||||||
|
$topMostHandle = [IntPtr]::new(-1)
|
||||||
|
$mainWindow = $null
|
||||||
|
$promptWindow = $null
|
||||||
|
foreach ($window in $Windows) {
|
||||||
|
if ([string]$window.process_name -ne "IMPlatformClient") {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
$hwndValue = [Convert]::ToInt64(($window.hwnd -replace "^0x", ""), 16)
|
||||||
|
$hwnd = [IntPtr]::new($hwndValue)
|
||||||
|
[ISphereOfflineWindowApi]::ShowWindow($hwnd, 9) | Out-Null
|
||||||
|
if ([string]$window.title -eq $InfoPromptTitle) {
|
||||||
|
[ISphereOfflineWindowApi]::MoveWindow($hwnd, ($MainX + $MainWidth + 40), ($MainY + 40), 300, 190, $true) | Out-Null
|
||||||
|
[ISphereOfflineWindowApi]::SetForegroundWindow($hwnd) | Out-Null
|
||||||
|
$promptWindow = $window
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
if ($MakeTopMost) {
|
||||||
|
[ISphereOfflineWindowApi]::SetWindowPos($hwnd, $topMostHandle, $MainX, $MainY, $MainWidth, $MainHeight, 0x0040) | Out-Null
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
[ISphereOfflineWindowApi]::MoveWindow($hwnd, $MainX, $MainY, $MainWidth, $MainHeight, $true) | Out-Null
|
||||||
|
}
|
||||||
|
[ISphereOfflineWindowApi]::SetForegroundWindow($hwnd) | Out-Null
|
||||||
|
$mainWindow = $window
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return @{
|
||||||
|
main = $mainWindow
|
||||||
|
prompt = $promptWindow
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function Save-WindowScreenshot([string]$OutputPath, [int]$ScreenX, [int]$ScreenY, [int]$CaptureWidth, [int]$CaptureHeight) {
|
||||||
|
Add-Type -AssemblyName System.Drawing
|
||||||
|
$bitmap = New-Object System.Drawing.Bitmap $CaptureWidth, $CaptureHeight
|
||||||
|
$graphics = [System.Drawing.Graphics]::FromImage($bitmap)
|
||||||
|
try {
|
||||||
|
$graphics.CopyFromScreen(($ScreenX - 30), ($ScreenY - 30), 0, 0, $bitmap.Size)
|
||||||
|
$bitmap.Save($OutputPath, [System.Drawing.Imaging.ImageFormat]::Png)
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
$graphics.Dispose()
|
||||||
|
$bitmap.Dispose()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
$archiveFull = Resolve-RepoPath $ArchivePath
|
||||||
|
$extractFull = Resolve-RepoPath $ExtractDir
|
||||||
|
$script:HelperPath = Resolve-RepoPath $HelperExe
|
||||||
|
$runOut = Join-Path $repo "runs\offline-real-client-window"
|
||||||
|
New-Item -ItemType Directory -Force -Path $runOut | Out-Null
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $script:HelperPath)) {
|
||||||
|
throw "WinHelper not found: $script:HelperPath. Run scripts\build-win-helper.ps1 first."
|
||||||
|
}
|
||||||
|
|
||||||
|
$clientDir = Join-Path $extractFull ("zyl\" + $ClientRoot)
|
||||||
|
$clientExe = Join-Path $clientDir "IMPlatformClient.exe"
|
||||||
|
$clientConfig = Join-Path $clientDir "IMPlatformClient.exe.config"
|
||||||
|
$requiredDependency = Join-Path $clientDir "Utilities.Lib.Base.dll"
|
||||||
|
|
||||||
|
if (-not $SkipExtract -and (-not (Test-Path -LiteralPath $clientExe) -or -not (Test-Path -LiteralPath $clientConfig) -or -not (Test-Path -LiteralPath $requiredDependency))) {
|
||||||
|
if (-not (Test-Path -LiteralPath $archiveFull)) {
|
||||||
|
throw "archive not found: $archiveFull"
|
||||||
|
}
|
||||||
|
New-Item -ItemType Directory -Force -Path $extractFull | Out-Null
|
||||||
|
$sevenZip = Find-7Zip
|
||||||
|
& $sevenZip x $archiveFull "-o$extractFull" "zyl\Impp\*" "zyl\iSphere\*" -y | Out-Host
|
||||||
|
if ($LASTEXITCODE -ne 0) {
|
||||||
|
throw "7-Zip extraction failed with exit code $LASTEXITCODE"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (-not (Test-Path -LiteralPath $clientExe)) {
|
||||||
|
throw "client exe not found after extraction: $clientExe"
|
||||||
|
}
|
||||||
|
|
||||||
|
Add-NativeWindowApi
|
||||||
|
|
||||||
|
if (-not $KeepExisting) {
|
||||||
|
Stop-ExistingOfflineCopies -RootPath $extractFull
|
||||||
|
Start-Sleep -Milliseconds 500
|
||||||
|
}
|
||||||
|
|
||||||
|
$process = $null
|
||||||
|
if (-not $NoLaunch) {
|
||||||
|
$process = Start-Process -FilePath $clientExe -WorkingDirectory $clientDir -PassThru
|
||||||
|
}
|
||||||
|
|
||||||
|
$deadline = (Get-Date).AddSeconds([Math]::Max(1, $WaitSeconds))
|
||||||
|
$scan = $null
|
||||||
|
$windows = @()
|
||||||
|
do {
|
||||||
|
Start-Sleep -Milliseconds 500
|
||||||
|
$scan = Invoke-HelperJson -Op "scan_windows" -OpArgs @{ include_all_visible = $false } -RequestId "offline-real-client-scan"
|
||||||
|
if ($scan.ok -and $scan.data.windows) {
|
||||||
|
$windows = @($scan.data.windows | Where-Object {
|
||||||
|
$_.process_name -eq "IMPlatformClient" -and
|
||||||
|
((-not $process) -or $_.pid -eq $process.Id)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
} while ($windows.Count -eq 0 -and (Get-Date) -lt $deadline)
|
||||||
|
|
||||||
|
if ($windows.Count -eq 0) {
|
||||||
|
throw "no visible IMPlatformClient window found. Last scan: $($scan | ConvertTo-Json -Depth 12 -Compress)"
|
||||||
|
}
|
||||||
|
|
||||||
|
$moveResult = Move-ClientWindows -Windows $windows -MainX $X -MainY $Y -MainWidth $Width -MainHeight $Height -MakeTopMost ([bool]$TopMost)
|
||||||
|
Start-Sleep -Seconds 1
|
||||||
|
|
||||||
|
$scanAfterMove = Invoke-HelperJson -Op "scan_windows" -OpArgs @{ include_all_visible = $false } -RequestId "offline-real-client-scan-after-move"
|
||||||
|
$windowsAfterMove = @($scanAfterMove.data.windows | Where-Object {
|
||||||
|
$_.process_name -eq "IMPlatformClient" -and
|
||||||
|
((-not $process) -or $_.pid -eq $process.Id)
|
||||||
|
})
|
||||||
|
|
||||||
|
# The offline client can raise a late "信息提示" dialog after the login window is
|
||||||
|
# already visible. Move it to the right side so the login window remains usable
|
||||||
|
# for RPA probing, then refresh the final window list.
|
||||||
|
$latePromptWindows = @($windowsAfterMove | Where-Object { [string]$_.title -eq $InfoPromptTitle })
|
||||||
|
if ($latePromptWindows.Count -gt 0) {
|
||||||
|
foreach ($latePromptWindow in $latePromptWindows) {
|
||||||
|
$promptHwndValue = [Convert]::ToInt64(($latePromptWindow.hwnd -replace "^0x", ""), 16)
|
||||||
|
$promptHwnd = [IntPtr]::new($promptHwndValue)
|
||||||
|
[ISphereOfflineWindowApi]::ShowWindow($promptHwnd, 9) | Out-Null
|
||||||
|
[ISphereOfflineWindowApi]::MoveWindow($promptHwnd, ($X + $Width + 40), ($Y + 40), 300, 190, $true) | Out-Null
|
||||||
|
[ISphereOfflineWindowApi]::SetForegroundWindow($promptHwnd) | Out-Null
|
||||||
|
}
|
||||||
|
Start-Sleep -Milliseconds 500
|
||||||
|
$scanAfterMove = Invoke-HelperJson -Op "scan_windows" -OpArgs @{ include_all_visible = $false } -RequestId "offline-real-client-scan-after-prompt-move"
|
||||||
|
$windowsAfterMove = @($scanAfterMove.data.windows | Where-Object {
|
||||||
|
$_.process_name -eq "IMPlatformClient" -and
|
||||||
|
((-not $process) -or $_.pid -eq $process.Id)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
$mainWindowMatches = @($windowsAfterMove | Where-Object { [string]$_.title -ne $InfoPromptTitle })
|
||||||
|
$promptWindowMatches = @($windowsAfterMove | Where-Object { [string]$_.title -eq $InfoPromptTitle })
|
||||||
|
$mainWindow = if ($mainWindowMatches.Count -gt 0) { $mainWindowMatches[0] } else { $null }
|
||||||
|
$promptWindow = if ($promptWindowMatches.Count -gt 0) { $promptWindowMatches[0] } else { $null }
|
||||||
|
|
||||||
|
$dumpFile = $null
|
||||||
|
$dump = $null
|
||||||
|
if ($mainWindow) {
|
||||||
|
$dump = Invoke-HelperJson -Op "dump_uia" -OpArgs @{
|
||||||
|
hwnd = $mainWindow.hwnd
|
||||||
|
max_depth = 8
|
||||||
|
max_children = 200
|
||||||
|
include_text = $true
|
||||||
|
} -RequestId "offline-real-client-dump-uia"
|
||||||
|
$dumpFile = Join-Path $runOut ("uia-dump-open-offline-real-client-{0}.json" -f ((Get-Date).ToString("yyyyMMdd-HHmmss")))
|
||||||
|
$dump | ConvertTo-Json -Depth 40 | Set-Content -LiteralPath $dumpFile -Encoding UTF8
|
||||||
|
}
|
||||||
|
|
||||||
|
$screenshotFile = $null
|
||||||
|
if (-not $NoScreenshot) {
|
||||||
|
$screenshotFile = Join-Path $runOut ("open-offline-real-client-{0}.png" -f ((Get-Date).ToString("yyyyMMdd-HHmmss")))
|
||||||
|
$captureWidth = if ($promptWindow) { $Width + 420 } else { $Width + 80 }
|
||||||
|
Save-WindowScreenshot -OutputPath $screenshotFile -ScreenX $X -ScreenY $Y -CaptureWidth $captureWidth -CaptureHeight ($Height + 80)
|
||||||
|
}
|
||||||
|
|
||||||
|
[pscustomobject]@{
|
||||||
|
ok = $true
|
||||||
|
archive = $archiveFull
|
||||||
|
extracted_dir = $extractFull
|
||||||
|
client_root = $ClientRoot
|
||||||
|
client_exe = $clientExe
|
||||||
|
process_id = if ($process) { $process.Id } else { $null }
|
||||||
|
alive = if ($process) { $null -ne (Get-Process -Id $process.Id -ErrorAction SilentlyContinue) } else { $null }
|
||||||
|
main_window = $mainWindow
|
||||||
|
prompt_window = $promptWindow
|
||||||
|
uia_root = if ($dump -and $dump.ok) { $dump.data.root } else { $null }
|
||||||
|
uia_dump_file = $dumpFile
|
||||||
|
screenshot_file = $screenshotFile
|
||||||
|
windows = $windowsAfterMove
|
||||||
|
} | ConvertTo-Json -Depth 24
|
||||||
Reference in New Issue
Block a user