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
@@ -44,7 +44,8 @@ BeforeAll {
|
||||
param([Parameter(Mandatory = $true)][System.IO.FileSystemInfo]$Item, [Parameter(Mandatory = $true)]$Security)
|
||||
if ($PSVersionTable.PSEdition -eq 'Core') {
|
||||
[System.IO.FileSystemAclExtensions]::SetAccessControl($Item, $Security)
|
||||
} else {
|
||||
}
|
||||
else {
|
||||
$Item.SetAccessControl($Security)
|
||||
}
|
||||
}
|
||||
@@ -63,8 +64,8 @@ BeforeAll {
|
||||
$acl = Get-Acl -LiteralPath $Path
|
||||
$sid = [System.Security.Principal.SecurityIdentifier]
|
||||
$aces = @($acl.GetAccessRules($true, $true, $sid) |
|
||||
ForEach-Object { '{0}|{1}|{2}' -f $_.AccessControlType, $_.IdentityReference.Value, [int]$_.FileSystemRights } |
|
||||
Sort-Object)
|
||||
ForEach-Object { '{0}|{1}|{2}' -f $_.AccessControlType, $_.IdentityReference.Value, [int]$_.FileSystemRights } |
|
||||
Sort-Object)
|
||||
return ('O={0} G={1} P={2} [{3}]' -f $acl.GetOwner($sid).Value, $acl.GetGroup($sid).Value, $acl.AreAccessRulesProtected, ($aces -join ' '))
|
||||
}
|
||||
|
||||
@@ -109,7 +110,8 @@ BeforeAll {
|
||||
try {
|
||||
& takeown.exe /F $Path /R /D Y 2>&1 | Out-Null
|
||||
& icacls.exe $Path /reset /T /C /Q 2>&1 | Out-Null
|
||||
} finally {
|
||||
}
|
||||
finally {
|
||||
$ErrorActionPreference = $previousPreference
|
||||
}
|
||||
|
||||
@@ -145,7 +147,8 @@ BeforeAll {
|
||||
try {
|
||||
$exitCode = Invoke-ExternalCommand -FilePath 'cmd.exe' -ArgumentList @('/c', $cmdFile)
|
||||
$lines = @(Get-Content -LiteralPath $outFile -Encoding UTF8 -ErrorAction SilentlyContinue)
|
||||
} finally {
|
||||
}
|
||||
finally {
|
||||
Remove-Item -LiteralPath $outFile -Force -ErrorAction SilentlyContinue
|
||||
Remove-Item -LiteralPath $cmdFile -Force -ErrorAction SilentlyContinue
|
||||
}
|
||||
@@ -219,7 +222,7 @@ AfterAll {
|
||||
|
||||
# ============================================================================
|
||||
Describe '排除判定与 7z 的 -x! / -xr! 语义对齐' {
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
It '锚定模式只命中它自己那棵子树' {
|
||||
Test-BaknretPathExcluded -RelativePath 'Default\Cache' -Patterns @('Default\Cache') | Should -BeTrue
|
||||
Test-BaknretPathExcluded -RelativePath 'Default\Cache\sub\x.bin' -Patterns @('Default\Cache') | Should -BeFalse
|
||||
@@ -251,7 +254,7 @@ Describe '排除判定与 7z 的 -x! / -xr! 语义对齐' {
|
||||
|
||||
# ============================================================================
|
||||
Describe 'SID 映射（跨机恢复）' {
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
It '整 SID 精确替换' {
|
||||
$sddl = 'O:S-1-5-21-1-2-3-1001G:S-1-5-21-1-2-3-1001D:(A;;FA;;;S-1-5-21-1-2-3-1001)'
|
||||
$mapped = Convert-BaknretSidMap -Sddl $sddl -SidMap @{ 'S-1-5-21-1-2-3-1001' = 'S-1-5-21-9-8-7-1001' }
|
||||
@@ -272,7 +275,7 @@ Describe 'SID 映射（跨机恢复）' {
|
||||
|
||||
# ============================================================================
|
||||
Describe '安全描述符采集' {
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
BeforeAll {
|
||||
$script:CaptureRoot = Join-Path $script:Sandbox 'capture\Data'
|
||||
$script:CaptureItem = [pscustomobject]@{ ArchivePath = 'Data'; RealPath = $script:CaptureRoot }
|
||||
@@ -341,7 +344,7 @@ Describe '安全描述符采集' {
|
||||
|
||||
# ============================================================================
|
||||
Describe '安全描述符回放' {
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
BeforeAll {
|
||||
$script:RestoreRoot = Join-Path $script:Sandbox 'restore\Data'
|
||||
$script:TargetRoot = Join-Path $script:Sandbox 'restore\target'
|
||||
@@ -398,7 +401,7 @@ Describe '安全描述符回放' {
|
||||
|
||||
# 属组写成一个本机不存在的 SID：改主组需要特权，这一层必然失败
|
||||
$sddl = 'O:' + (Get-Acl -LiteralPath $path).GetOwner([System.Security.Principal.SecurityIdentifier]).Value +
|
||||
'G:' + $script:OrphanSid + 'D:(A;;FA;;;SY)'
|
||||
'G:' + $script:OrphanSid + 'D:(A;;FA;;;SY)'
|
||||
$sidecar = [pscustomobject]@{
|
||||
Records = @([pscustomobject]@{ p = 'Data'; k = 'd'; s = $sddl })
|
||||
}
|
||||
@@ -422,7 +425,7 @@ Describe '安全描述符回放' {
|
||||
|
||||
# ============================================================================
|
||||
Describe '与 Backup.ps1 / Restore.ps1 的集成' -Skip:(-not $script:HasSevenZip) {
|
||||
# ============================================================================
|
||||
# ============================================================================
|
||||
BeforeAll {
|
||||
$script:Harness = New-AclEntryHarness -Name 'integration' -Root $script:Sandbox
|
||||
$script:IntegrationFingerprints = New-AclSourceTree -Root $script:Harness.SourcePath
|
||||
|
||||
Reference in new issue
Block a user