chore: require PowerShell 7 for repository tools

Author: JeffioZ

docs/development.md

@@ -6,6 +6,7 @@
 
 - Go 1.26 or later
 - Git
+- PowerShell 7 or later for repository scripts
 - `github.com/akavel/rsrc` only when regenerating Windows resources
 
 IdleTrigger targets Windows 10 / Windows Server 2016 and later. The repository produces both `windows/amd64` and `windows/386` binaries.
@@ -35,15 +36,24 @@ go build -trimpath "-ldflags=$ldflags" -o $output ./cmd/idletrigger
 
 ## Verify
 
-Run the standard local checks in Windows PowerShell 5.1 or later:
+Run the standard local checks in PowerShell 7 or later:
 
 ```powershell
 .\tools\check.ps1
 ```
 
-The check script covers normal, `devtools`, and `tools` build-tag variants.
-`golangci-lint` is run when installed; otherwise the script prints `SKIPPED`.
-Run the optional vulnerability scan while online:
+The default command is the quick development check: module verification,
+formatting, working-tree whitespace, the short test suite, normal vet, and
+dependency boundaries. Native Win32 integration and resource-cycle tests stay
+in the full suite. Before a release or broad change, run the full build-tag
+matrix and `golangci-lint` (when installed):
+
+```powershell
+.\tools\check.ps1 -Full
+```
+
+Run the optional vulnerability scan while online; it can be combined with
+`-Full`:
 
 ```powershell
 .\tools\check.ps1 -Vulncheck

docs/development.zh-CN.md

@@ -6,6 +6,7 @@
 
 - Go 1.26 或更高版本
 - Git
+- 仓库脚本要求 PowerShell 7 或更高版本
 - 仅重新生成 Windows 资源时需要 `github.com/akavel/rsrc`
 
 IdleTrigger 面向 Windows 10 / Windows Server 2016 及以上系统，仓库同时产出 `windows/amd64` 和 `windows/386`。
@@ -35,15 +36,22 @@ go build -trimpath "-ldflags=$ldflags" -o $output ./cmd/idletrigger
 
 ## 验证
 
-在 Windows PowerShell 5.1 或更高版本中执行本地标准检查：
+在 PowerShell 7 或更高版本中执行本地标准检查：
 
 ```powershell
 .\tools\check.ps1
 ```
 
-检查脚本会覆盖普通、`devtools` 和 `tools` 三种构建标签组合。已安装
-`golangci-lint` 时脚本会执行它；未安装时会明确打印 `SKIPPED`。
-联网时可执行可选漏洞扫描：
+默认命令执行适合日常开发的轻量检查：模块校验、格式、工作区空白错误、短测试集、
+普通 vet 和依赖边界。真实 Win32 集成及资源循环测试保留在完整模式中。发布前或较大
+范围改动后，使用完整模式覆盖 `devtools`、`tools` 构建标签，并在已安装时执行
+`golangci-lint`：
+
+```powershell
+.\tools\check.ps1 -Full
+```
+
+联网时可执行可选漏洞扫描；该参数可与 `-Full` 组合使用：
 
 ```powershell
 .\tools\check.ps1 -Vulncheck

docs/roadmap.md

@@ -2,7 +2,7 @@
 
 ## 发布检查清单
 
-- [ ] `.\tools\check.ps1` 核心检查通过，并确认 `SKIPPED` / `NOT RUN` 项符合本次发布预期
+- [ ] `.\tools\check.ps1 -Full -Vulncheck` 完整检查通过，并确认 `SKIPPED` 项符合本次发布预期
 - [ ] 386 / amd64 Windows GUI 构建通过
 - [ ] 两种架构 EXE 均包含应用图标和 manifest
 - [ ] CLI、控制面板、自动任务/进程选择器、IPC、热键和两类预警做一次人工冒烟测试

internal/ui/automationpanel/automationpanel_test.go

@@ -85,7 +85,15 @@ func TestRuleSummaryIncludesEffectiveDays(t *testing.T) {
 	}
 }
 
+func requireNativeIntegration(t *testing.T) {
+	t.Helper()
+	if testing.Short() {
+		t.Skip("skipping native Win32 integration test in short mode")
+	}
+}
+
 func TestProcessTooltipBufferRemainsBoundedAcrossRefreshes(t *testing.T) {
+	requireNativeIntegration(t)
 	err := Capture(State{}, func(key string) string { return key }, 1, false, true, func(hwnd windows.Handle) error {
 		p := activePanelForTest(t, hwnd)
 		p.draft.Processes = []automation.ProcessTarget{{Match: automation.MatchName, Executable: "player.exe"}}
@@ -143,6 +151,7 @@ func TestEditorKeepsDraftBaseWhenExternalStateArrives(t *testing.T) {
 }
 
 func TestAutomationWindowsRemainOperableAcrossDPIAndSmallWorkArea(t *testing.T) {
+	requireNativeIntegration(t)
 	work := nativeform.Rect{Right: 1366, Bottom: 768}
 	for _, scale := range []float64{1, 1.25, 1.5, 2} {
 		for _, editor := range []bool{false, true} {
@@ -195,6 +204,7 @@ func TestManagerLayoutFitsCICompactViewport(t *testing.T) {
 }
 
 func TestAutomationWindowsApplySuggestedRectAcrossDPIChanges(t *testing.T) {
+	requireNativeIntegration(t)
 	for _, editor := range []bool{false, true} {
 		t.Run(map[bool]string{false: "manager", true: "editor"}[editor], func(t *testing.T) {
 			err := Capture(State{}, func(key string) string { return key }, 1, false, editor, func(hwnd windows.Handle) error {
@@ -231,6 +241,7 @@ func TestAutomationWindowsApplySuggestedRectAcrossDPIChanges(t *testing.T) {
 }
 
 func TestAutomationWindowsReleaseResourcesAcrossRepresentativeCycles(t *testing.T) {
+	requireNativeIntegration(t)
 	const (
 		stabilizationCycles = 8
 		measuredCycles      = 8

internal/ui/processpicker/processpicker_test.go

@@ -195,7 +195,15 @@ func TestSelectionLimitRejectsOnlyTheAdditionalTarget(t *testing.T) {
 	}
 }
 
+func requireNativeIntegration(t *testing.T) {
+	t.Helper()
+	if testing.Short() {
+		t.Skip("skipping native Win32 integration test in short mode")
+	}
+}
+
 func TestProcessPickerRemainsOperableAcrossDPIAndSmallWorkArea(t *testing.T) {
+	requireNativeIntegration(t)
 	work := nativeform.Rect{Right: 1366, Bottom: 768}
 	groups := []processcatalog.Group{{Executable: "player.exe", Description: "Media Player", Count: 2}}
 	for _, scale := range []float64{1, 1.25, 1.5, 2} {
@@ -224,6 +232,7 @@ func TestProcessPickerRemainsOperableAcrossDPIAndSmallWorkArea(t *testing.T) {
 }
 
 func TestProcessPickerAppliesSuggestedRectAcrossDPIChanges(t *testing.T) {
+	requireNativeIntegration(t)
 	err := Capture(testPickerOptions(), nil, 1, false, func(hwnd windows.Handle) error {
 		p := activePickerForTest(t, hwnd)
 		p.captureScale = 0
@@ -253,6 +262,7 @@ func TestProcessPickerAppliesSuggestedRectAcrossDPIChanges(t *testing.T) {
 }
 
 func TestProcessPickerReleasesResourcesAcrossRepresentativeCycles(t *testing.T) {
+	requireNativeIntegration(t)
 	const (
 		stabilizationCycles = 8
 		measuredCycles      = 8
@@ -287,6 +297,7 @@ func TestProcessPickerReleasesResourcesAcrossRepresentativeCycles(t *testing.T)
 }
 
 func TestProcessPickerCreationFailuresReleasePartialResources(t *testing.T) {
+	requireNativeIntegration(t)
 	if err := Capture(testPickerOptions(), nil, 1, false, nil); err != nil {
 		t.Fatal(err)
 	}
@@ -400,6 +411,7 @@ func TestProcessPickerCreationFailuresReleasePartialResources(t *testing.T) {
 }
 
 func TestProcessPickerIgnoresCallbacksThatArriveAfterClose(t *testing.T) {
+	requireNativeIntegration(t)
 	runtime.LockOSThread()
 	defer runtime.UnlockOSThread()
 	originalSnapshot := snapshotNamesForPicker

tools/capture-screenshots.ps1

@@ -1,3 +1,5 @@
+#requires -Version 7.0
+
 [CmdletBinding()]
 param(
     [ValidateSet('Readme', 'Review')]
@@ -6,12 +8,15 @@ param(
 )
 
 $ErrorActionPreference = 'Stop'
+$PSNativeCommandUseErrorActionPreference = $false
+Set-StrictMode -Version Latest
 $repoRoot = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..'))
 if ([string]::IsNullOrWhiteSpace($OutputDirectory)) {
     $OutputDirectory = if ($CaptureSet -eq 'Readme') { Join-Path $repoRoot 'docs\images' } else { Join-Path $repoRoot 'dist\ui-review' }
 }
 $outputDirectory = [IO.Path]::GetFullPath($OutputDirectory)
 $temporaryDirectory = Join-Path (Join-Path $repoRoot 'dist') ('.screenshot-build-' + $PID)
+$captureDirectory = Join-Path $temporaryDirectory 'captured'
 $exePath = Join-Path $temporaryDirectory 'IdleTrigger-screenshot.exe'
 $files = if ($CaptureSet -eq 'Readme') {
     @('panel-en-light.png', 'panel-en-dark.png', 'panel-zh-light.png', 'panel-zh-dark.png')
@@ -24,6 +29,11 @@ $files = if ($CaptureSet -eq 'Readme') {
         }
     }
 }
+$previousEnvironment = @{
+    CGO_ENABLED = [Environment]::GetEnvironmentVariable('CGO_ENABLED', 'Process')
+    GOARCH = [Environment]::GetEnvironmentVariable('GOARCH', 'Process')
+    GOCACHE = [Environment]::GetEnvironmentVariable('GOCACHE', 'Process')
+}
 
 function Get-PngSize([string]$Path) {
     $bytes = [IO.File]::ReadAllBytes($Path)
@@ -46,14 +56,14 @@ try {
         go build -tags devtools -trimpath -ldflags '-s -w -H windowsgui -X github.com/JeffioZ/idletrigger/internal/version.Value=screenshot' -o $exePath ./cmd/idletrigger
         if ($LASTEXITCODE -ne 0) { throw "go build failed with exit code $LASTEXITCODE" }
         $setFlag = if ($CaptureSet -eq 'Readme') { '--readme-set' } else { '--review-set' }
-        $arguments = @('screenshot', $setFlag, '--output', ('"' + $outputDirectory + '"'))
+        $arguments = @('screenshot', $setFlag, '--output', ('"' + $captureDirectory + '"'))
         $process = Start-Process -FilePath $exePath -ArgumentList $arguments -WindowStyle Hidden -Wait -PassThru
         if ($process.ExitCode -ne 0) { throw "screenshot command failed with exit code $($process.ExitCode)" }
     } finally { Pop-Location }
 
     $sizes = @{}
     foreach ($name in $files) {
-        $path = Join-Path $outputDirectory $name
+        $path = Join-Path $captureDirectory $name
         if (-not (Test-Path -LiteralPath $path -PathType Leaf)) { throw "Missing screenshot: $path" }
         $size = Get-PngSize $path
         $sizes[$name] = $size
@@ -71,7 +81,16 @@ try {
             }
         }
     }
+
+    New-Item -ItemType Directory -Force -Path $outputDirectory | Out-Null
+    foreach ($name in $files) {
+        Copy-Item -LiteralPath (Join-Path $captureDirectory $name) -Destination (Join-Path $outputDirectory $name) -Force
+    }
 } finally {
+    foreach ($name in $previousEnvironment.Keys) {
+        [Environment]::SetEnvironmentVariable($name, $previousEnvironment[$name], 'Process')
+    }
+
     # Windows may briefly retain a handle to a just-exited GUI executable.
     # Clean synchronously so the script never leaves a detached cleanup
     # process behind.