style: 按微软规范落地静态分析，并全仓机械重排
三件事：
1) tools\Install-TestDependencies.ps1 现在也把 PSScriptAnalyzer 装进仓库内的 .tools\modules
（不动机器上的全局模块，与 Pester 同一策略）。
2) PSScriptAnalyzerSettings.psd1：这是必要的，不是装饰 —— 那 6 条格式规则
（括号、缩进、空格、对齐、大小写）默认全是 Disabled，所以不带 -Settings 的
`Invoke-ScriptAnalyzer -Severity Warning,Error` 会**静默漏掉全部排版问题**。本文件用 Rules
把它们打开（而不是用 IncludeRules 换一套），于是默认规则与格式规则同时生效。
三条有意的排除都写明了理由：PSAvoidUsingWriteHost（彩色控制台输出是这份工具的刻意设计）、
PSUseShouldProcessForStateChangingFunctions（WhatIf 的边界在入口脚本，给库里 27 个改状态的
函数都加上反而会"静默跳过"，备份看着成功却什么都没做）、PSAvoidUsingPlainTextForPassword
（7z 只接受命令行口令，这是 7z 的限制，README 里写明了取舍）。
3) tools\Invoke-Analyzer.ps1：独立门禁（不塞进 Pester 用例 —— 套件跑一次二十多秒，
混进去会让"测试红了"这句话失去分辨力），路径过滤与验收门槛的 Encode/Parse 两层一致。
全仓重排结果：706 条告警 -> 67 条。修掉的 639 条全部是格式（闭括号 168、空格 80、
对齐 68、缩进 60、行长 229）。重排后 9/9 验收全绿、100 个文件两版解析零错、
276 个断言原样通过 —— 机械重排没有改变任何可观察行为。
如实说明两件事：
* 行长上限设成 160，**不是**官方默认的 120。120 在本仓库意味着 270 处改动（主要是
中文注释与测试夹具里的一行式目录），160 意味着 41 处。160 仍是"宽但可读"，而理由是写在
配置文件里的：这不是悄悄放宽，想收紧到 120 时那份清单就在分析器输出里。
* 剩余 67 条里，41 条是上面那批行长，其余 26 条是分析器找出的真问题（未使用参数 6、
空 catch 6、MD5 指纹 1、覆盖内置命令 1、switch 默认值 1 等）。其中
Find-ChildDirectoryByName 的 MaxDepth 参数从未被使用 —— 也就是配置里的
CatalogMaxDepth = 5 是假的，前缀补全实际只查 1 层。这条要改行为、且影响真实名录的解析
结果，留给你拍板，不在本提交里动手。
This commit is contained in:
Shuery committed
1 parent
102a3e038d
commit
187d2759fd
60 files changed
+769
-377
No files matched your search
+24
-21
@@ -15,20 +15,20 @@
|
||||
|
||||
|
||||
$script:LabConfig = [ordered]@{
|
||||
VmName = 'BakNRet-Lab'
|
||||
LabRoot = 'D:\VMs\BakNRet-Lab'
|
||||
VhdxPath = 'D:\VMs\BakNRet-Lab\vhdx\BakNRet-Lab.vhdx'
|
||||
VhdxSizeGB = 80
|
||||
IsoPath = 'F:\Images\Windows\Win11_25H2_Chinese_Simplified_x64_v2.iso'
|
||||
ImageIndex = 4 # Windows 11 专业版
|
||||
SwitchName = 'Default Switch'
|
||||
VmName = 'BakNRet-Lab'
|
||||
LabRoot = 'D:\VMs\BakNRet-Lab'
|
||||
VhdxPath = 'D:\VMs\BakNRet-Lab\vhdx\BakNRet-Lab.vhdx'
|
||||
VhdxSizeGB = 80
|
||||
IsoPath = 'F:\Images\Windows\Win11_25H2_Chinese_Simplified_x64_v2.iso'
|
||||
ImageIndex = 4 # Windows 11 专业版
|
||||
SwitchName = 'Default Switch'
|
||||
MemoryStartupGB = 8
|
||||
CpuCount = 8
|
||||
GuestRepoPath = 'C:\BakNRet'
|
||||
GuestLabPath = 'C:\BakNRet-Lab'
|
||||
GuestUser = 'lab'
|
||||
CheckpointName = 'clean-baseline'
|
||||
RepoRoot = (Split-Path -Parent (Split-Path -Parent $PSScriptRoot))
|
||||
CpuCount = 8
|
||||
GuestRepoPath = 'C:\BakNRet'
|
||||
GuestLabPath = 'C:\BakNRet-Lab'
|
||||
GuestUser = 'lab'
|
||||
CheckpointName = 'clean-baseline'
|
||||
RepoRoot = (Split-Path -Parent (Split-Path -Parent $PSScriptRoot))
|
||||
}
|
||||
|
||||
function Get-LabConfig { return $script:LabConfig }
|
||||
@@ -44,11 +44,11 @@ function Get-LabPath {
|
||||
|
||||
function Write-LabLog {
|
||||
<# .SYNOPSIS 统一日志：同时进控制台与 $LabRoot\logs\lab.log。 #>
|
||||
param([Parameter(Mandatory)][string]$Message, [ValidateSet('INFO','WARN','ERROR','STEP')][string]$Level = 'INFO')
|
||||
param([Parameter(Mandatory)][string]$Message, [ValidateSet('INFO', 'WARN', 'ERROR', 'STEP')][string]$Level = 'INFO')
|
||||
$line = "[{0}] [{1,-5}] {2}" -f (Get-Date).ToString('HH:mm:ss'), $Level, $Message
|
||||
switch ($Level) {
|
||||
'STEP' { Write-Host $line -ForegroundColor Cyan }
|
||||
'WARN' { Write-Host $line -ForegroundColor Yellow }
|
||||
'STEP' { Write-Host $line -ForegroundColor Cyan }
|
||||
'WARN' { Write-Host $line -ForegroundColor Yellow }
|
||||
'ERROR' { Write-Host $line -ForegroundColor Red }
|
||||
default { Write-Host $line }
|
||||
}
|
||||
@@ -65,8 +65,8 @@ function Assert-LabElevated {
|
||||
param([Parameter(Mandatory)][string]$Why)
|
||||
if (Test-LabElevated) { return }
|
||||
$gsudo = (Get-Command gsudo -ErrorAction SilentlyContinue | Select-Object -First 1).Source
|
||||
$self = $MyInvocation.PSCommandPath
|
||||
$hint = if ($gsudo) { "`n $gsudo pwsh -NoProfile -File `"$self`" $($MyInvocation.Line)" } else { '' }
|
||||
$self = $MyInvocation.PSCommandPath
|
||||
$hint = if ($gsudo) { "`n $gsudo pwsh -NoProfile -File `"$self`" $($MyInvocation.Line)" } else { '' }
|
||||
throw "需要管理员权限：$Why$hint"
|
||||
}
|
||||
|
||||
@@ -131,7 +131,8 @@ function New-LabSession {
|
||||
$s = New-PSSession -VMName $script:LabConfig.VmName -Credential $cred -ErrorAction Stop
|
||||
Write-LabLog "PowerShell Direct 会话已建立（等待 $([math]::Round($sw.Elapsed.TotalSeconds)) 秒）"
|
||||
return $s
|
||||
} catch {
|
||||
}
|
||||
catch {
|
||||
$lastError = $_.Exception.Message
|
||||
Start-Sleep -Seconds 5
|
||||
}
|
||||
@@ -149,7 +150,8 @@ function Invoke-LabCommand {
|
||||
$s = New-LabSession -RetrySeconds $RetrySeconds
|
||||
try {
|
||||
return Invoke-Command -Session $s -ScriptBlock $ScriptBlock -ArgumentList $ArgumentList -ErrorAction Stop
|
||||
} finally {
|
||||
}
|
||||
finally {
|
||||
Remove-PSSession -Session $s -ErrorAction SilentlyContinue
|
||||
}
|
||||
}
|
||||
@@ -178,5 +180,6 @@ function Test-LabGuestReady {
|
||||
try {
|
||||
$r = Invoke-LabCommand -ScriptBlock { Test-Path 'C:\BakNRet-Lab\state\provision.ok' } -RetrySeconds 60
|
||||
return [bool]$r
|
||||
} catch { return $false }
|
||||
}
|
||||
catch { return $false }
|
||||
}
|
||||
Reference in new issue
Block a user